feat: init wizard v2

[aorumbayev]

Implements https://github.com/orgs/algorandfoundation/projects/1?pane=issue&itemId=53079977

Proposed Changes

This is a draft moving the PoC for init wizard v2 discussed in #411.
The adr is split into 2 parts and this PR will be covering the improvements in wizard v2 + changes in related template repos.

Currently the draft contains poc code shown during the init wizard v2 discussions for the ADR. The PR is to be refined and turned into a full implementation by the time it leaves the draft state.

To interact with the PoC simply checkout the branch and access algokit inside poetry environment. Please note that tealscript template variation is not yet fully covered as poc was demoing a happy path from start to fullstack with puya + react components (this is to be patched soon).

Template PRs

• FullStack -> feat: init wizard v2 improvements algokit-fullstack-template#19
• React -> feat: init wizard v2 improvements algokit-react-frontend-template#25
• Beaker -> feat: init wizard v2 improvements algokit-beaker-default-template#59
• Puya -> feat: init wizard v2 improvements algokit-python-template#5
• new base template is available at -> feat: basic ci setup algokit-base-template#1

Above has to be merged first -> branch refs has to be then removed on this PR, afterwards ready to release new cli version

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
src/algokit
__init__.py	15	7	53%	6–13, 17–24, 32–34
__main__.py	4	4	0%	1–7
src/algokit/cli
completions.py	108	2	98%	83, 98
deploy.py	72	7	90%	44, 46, 92–94, 158, 182
dispenser.py	121	1	99%	77
doctor.py	48	3	94%	142–144
explore.py	50	12	76%	34–39, 41–46
generate.py	67	3	96%	74–75, 140
goal.py	44	1	98%	71
init.py	275	25	91%	388–389, 444, 447–449, 460, 464, 520, 546, 575, 608, 617–619, 622–627, 640, 657, 669–670, 687–690
localnet.py	119	15	87%	74–78, 111, 123, 138–148, 161, 206, 227–228
task.py	34	3	91%	25–28
src/algokit/cli/common
utils.py	26	2	92%	120, 123
src/algokit/cli/tasks
analyze.py	81	1	99%	81
assets.py	82	13	84%	65–66, 72, 74–75, 105, 119, 125–126, 132, 134, 136–137
ipfs.py	51	8	84%	52, 80, 92, 94–95, 105–107
mint.py	66	4	94%	48, 70, 91, 250
send_transaction.py	65	10	85%	52–53, 57, 89, 158, 170–174
sign_transaction.py	59	8	86%	21, 28–30, 71–72, 109, 123
transfer.py	39	3	92%	26, 90, 117
utils.py	99	45	55%	26–34, 40–43, 75–76, 100–101, 125–133, 152–162, 209, 258–259, 279–290, 297–299
vanity_address.py	56	10	82%	41, 45–48, 112, 114, 121–123
wallet.py	79	4	95%	21, 66, 136, 162
src/algokit/core
bootstrap.py	119	11	91%	42, 106–107, 129, 156, 185–190
conf.py	66	15	77%	12, 24, 28, 36, 38, 72–74, 92–100
deploy.py	69	11	84%	61–64, 73–75, 79, 84, 91–93
dispenser.py	202	26	87%	91, 123–124, 141–149, 191–192, 198–200, 218–219, 259–260, 318, 332–334, 345–346, 356, 369, 384
doctor.py	65	7	89%	67–69, 92–94, 134
generate.py	48	3	94%	44, 81, 99
goal.py	60	3	95%	30–31, 41
init.py	39	6	85%	59, 63–68, 76
log_handlers.py	68	7	90%	50–51, 63, 112–116, 125
proc.py	45	1	98%	98
sandbox.py	218	18	92%	62, 73–75, 96, 142–149, 160, 456, 472, 497, 505
typed_client_generation.py	80	5	94%	55–57, 70, 75
utils.py	104	31	70%	44–45, 49–68, 129, 132, 138–152
version_prompt.py	72	8	89%	26–27, 39, 58–61, 79, 108
src/algokit/core/tasks
analyze.py	93	3	97%	105–112, 187
ipfs.py	63	7	89%	58–64, 140, 144, 146, 152
nfd.py	49	13	73%	25, 31, 34–41, 70–72, 99–101
vanity_address.py	90	34	62%	49–50, 54, 59–75, 92–108, 128–131
wallet.py	71	5	93%	37, 129, 155–157
src/algokit/core/tasks/mint
mint.py	78	10	87%	123–133, 187
models.py	90	11	88%	50, 52, 57, 71–74, 85–88
TOTAL	3609	426	88%

Tests	Skipped	Failures	Errors	Time
407	0 💤	0 ❌	0 🔥	22.322s ⏱️

[aorumbayev]

@robdmoore @neilcampbell please note this is a temporary change done for the sake of adr given that dependant templates also rely on changes on specific branch

[aorumbayev]

@robdmoore @neilcampbell still keeping the pr in draft for ~1 more day until related prs on templates are opened too, added extra tests here and minor tweaks but should mostly be ready for review already

[aorumbayev]

@neilcampbell @robdmoore added extra logic as per latest discussions, adds optional behaviour that transforms any standalone template into a workspace structure by default OR if its already init'd from root of a workspace project it will auto inject the standalone template under expected folder. Let me know what you think, ignore the tests for now - will patch on monday

[aorumbayev]

@robdmoore @neilcampbell added extra documentation and usage of https://github.com/algorandfoundation/algokit-base-template to enforce workspace structure by default. This base is reused within all official templates (including fullstack) and decouple files that we want to see in the base structure from individual templates.

The best way to get a hang of the latest state is to checkout the branch and interact with the new wizard within poetry shell.

Would appreciate initial round of reviews as there are still certain open questions:

1. Do we want to include an optional arg to control max bootstrap lookup depth? Currently i've tweaked it to be 2 by default and user can control an optional arg via init, the default lookup for bootsrap all command is reusing same method so its also 2 by default. Not sure if want to also want to expand remaining commands or scope it out for minor improvement. We decided to not expose this until needed, user can always cd into target folder if bootstrap is needed at custom location.
2. Took some time to patch existing init tests, and they all were mostly tailored for the old wizard so im adding the --no-workspace everywhere in the old tests, there is a few new tests specifically for the init wizard v2 flow, will add a few extra edge cases but if youll spot anything critical in the pr that you think is not covered with tests let me know.
3. PRs are still pending on beaker, react, puya and fullstack (you should be able to interact with the wip changes when checking out and running algokit locally from this branch those). Want to ensure everything is solid on cli side first before i jump to finalizing the template changes (luckily should be fairly small and won't have anything backwards incompatible). Also let me know what you think of the usage of https://github.com/algorandfoundation/algokit-base-template, i think it simplifies the injection of common workspace structure by a good margin. -> PRs are ready, description is updated
4. @joe-p will reach out in case any extra help might be needed on tealscript, currently there is no notion of presets on that repo and it might make sense to also move it to foundation org. Let's discuss more with @Loedn as well once we got all main PRs on puya, fullstack, beaker, react ready to be merged 👍

cc @PhearZero @joe-p @CiottiGiorgio @iskysun96 - feel free to try it out as well if you want to provide preliminary feedback, please note the branch might still have further commits AFTER we coordinate opening prs on templates. Template prs will be merged first then we will make the prerelease on the cli and will coordinate with @Loedn to have an interactive feedback session to patch any last minute tweaks before end of month. Otherwise if all good i'll jump to part 2 (which will add orchestration on top of whats enforced with the new features in this pr)

[robdmoore]

pipx install git+https://github.com/algorandfoundation/algokit-cli@feat/init_wizard_v2

[robdmoore]

Got an error on Windows, also it didn't ask me for smart contract language

[aorumbayev]

@neilcampbell all templates should be up to date with latest - so running algokit cli from this branch should not have any e2e problems (only tested on windows so far though, but binaries portability tests add a bit more confidence).

A PR for fullstack is available here algorandfoundation/algokit-fullstack-template#19, once base template is public i'll open prs on remaining repos (no reason to open now since all will fail due to base being private repo)

will resolve your comments a bit later (some of those are already addressed, just didn't have time to resolve individually yet)

[aorumbayev]

@robdmoore thanks for reporting on the bugs so far - they are fixed now, let me know if there are any further comments. Also refer to updated pr description that includes refs to prs on respective react, fullstack, beaker and puya templates

[aorumbayev]

@joe-p @PhearZero just fyi, as agreed i updated child templates to come shipped with type contract by default in the .toml. So now we got workspace, backend, frontend, contract types (no templates containing backend yet but we can assume its a supported category). As for suggestion to make opening in code workspaces optional (for full stack), i forgot to mention that cli already supports a flag --no-ide which you can pass to instruct it to ignore auto opening the IDE @joe-p , remaining bits are going to be revisited during orchestration work from next week and we may have another feedback session some time next week to go over the orchestration as well.

As for this pr and all prs on templates, we will coordinate a release on monday with @neilcampbell and @Loedn