fix: update versioning constraint to support 3.14

[aorumbayev]

Proposed changes

• Add Python 3.14 support across workflows, docs, and pyproject.toml
• Centralize TOML parsing logic in new src/algokit/core/_toml.py module
• Move sphinxnotes-markdown-builder to optional [tool.poetry.group.docs] (not yet compatible with 3.14)
• Update copier to caret versioning; pin pywin32 for Windows/Python 3.14
• Streamline docs dependency installation in CI workflows
• Normalize test output for Python 3.14+ msgpack error message changes

Further notes

Why Copier Was Pinned in the first place?

Initial Issue (PR #634, ~May 2025)

When copier was updated from ^9.6.0 to 9.7.1, version 9.7.0 introduced breaking API changes:

1. Question model now requires context parameter — See src/algokit/core/init.py:48-50:

   # https://github.com/copier-org/copier/releases/tag/v9.7.0 introduces changes to Question model,
   # which now requires passing context param.
   context={**worker._render_context(), **answers.combined},

2. Internal module reorganization — Imports changed from public to private APIs:

   • copier.main → copier._main
   • copier.types → copier._types
   • copier.user_data → copier._user_data

---

The Problematic Versions (9.7.1 → 9.10.1, Aug–Sep 2025)

After PR #634 pinned to 9.7.1, Dependabot repeatedly tried to bump copier but these PRs were closed without merging:

PR	Attempted Bump	Status
#678	9.7.1 → 9.9.1	CLOSED
#676	Similar attempt	CLOSED
#674	Similar attempt	CLOSED
#673	Similar attempt	CLOSED

The issues that caused these failures:

• v9.8.0: Added stricter "validate default answers" which likely broke snapshot tests
• v9.9.0: Changed "secret question validator" behavior during answer replay

These changes affected how copier processed template answers, causing snapshot test output to differ.

---

The Security Fix (Commit 827b592, Sep 3, 2025)

The team decided to skip the problematic 9.8.x and 9.9.x versions entirely and jump to 9.10.1 with an explicit pin:

copier = "9.10.1"  # Pinned as we have seen breaking changes in minor releases. Updates should be tested before bumping.

---

Why PR #706 Could Bump to Latest

The successful bump (Jan 29, 2026):

PR #706 bumped from 9.10.1 → ^9.11.3 with zero code changes and all tests passed (Python 3.10–3.14). Here's why:

1. Backward Compatibility Maintained: The workaround code from PR chore: updated relevant to packages in order to update h11 #634 (passing context to Question) still works perfectly with copier 9.11.3

2. Issues Fixed in Later Versions: The validation and answer handling issues that plagued 9.8.x and 9.9.x were resolved or stabilized by 9.10.x/9.11.x

3. Relevant fixes in 9.11.x:

   • v9.11.0: "fix using default answers from settings for required questions" (#2374)
   • v9.11.3: "include non-question answers when generating fresh copy"

   These fixes likely resolved the issues that were causing snapshot test failures in the intermediate versions.

4. No New Breaking Changes: Copier 9.11.x didn't introduce new breaking API changes — it maintained compatibility with the _main, _types, _user_data import structure and Question context parameter pattern established in 9.7.0.

[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–6
src/algokit/cli
__init__.py	47	3	94%	31–34
codespace.py	50	9	82%	28, 114, 137, 150–155
completions.py	108	9	92%	63–64, 83, 93–99
dispenser.py	121	1	99%	77
doctor.py	90	6	93%	159, 171–173, 202–203
explore.py	69	17	75%	35–40, 42–47, 85–92, 115–116, 121
generate.py	78	8	90%	76–77, 169, 178–179, 182–183, 186
goal.py	54	6	89%	67, 85, 96, 107–109
localnet.py	169	32	81%	75, 96–123, 175–179, 223, 245, 260–270, 284, 337, 358–359
task.py	34	3	91%	25–28
src/algokit/cli/common
utils.py	37	2	95%	137, 139
src/algokit/cli/compilers
typescript.py	28	1	96%	59
src/algokit/cli/init
command.py	267	24	91%	315–316, 321–322, 325, 346, 349–351, 362, 366, 424, 450, 479, 512, 521–523, 526–531, 544, 563, 575–576
helpers.py	37	1	97%	47
src/algokit/cli/project
__init__.py	23	1	96%	31
bootstrap.py	40	1	98%	35
deploy.py	117	20	83%	47, 49, 102, 125, 147–149, 270, 277, 291–299, 302–311
link.py	81	12	85%	60, 65–66, 110–115, 143–144, 213–214, 218
list.py	33	5	85%	21–23, 51–56
run.py	46	2	96%	38, 174
src/algokit/cli/tasks
analyze.py	81	1	99%	81
assets.py	84	13	85%	70–71, 77, 79–80, 110, 125, 135–136, 144, 146, 148–149
ipfs.py	51	8	84%	52, 80, 92, 94–95, 105–107
mint.py	106	15	86%	51, 73, 100–103, 108, 113, 131–132, 158, 335–339
send_transaction.py	66	11	83%	18, 54–55, 59, 91, 160, 172–176
sign_transaction.py	59	8	86%	21, 28–30, 71–72, 109, 123
transfer.py	35	1	97%	80
utils.py	114	46	60%	24–32, 38–41, 73–74, 98–99, 123–131, 150–160, 207, 256–257, 277–288, 295–297, 319
vanity_address.py	56	10	82%	41, 45–48, 112, 114, 121–123
wallet.py	79	4	95%	21, 66, 136, 162
src/algokit/cli/tui/init
example_selector.py	17	3	82%	29–30, 34
src/algokit/cli/tui/init/screens
example_selector_screen.py	31	14	55%	12, 32–35, 38–51, 56–59
src/algokit/core
codespace.py	175	68	61%	34–37, 41–44, 48–71, 111–112, 125–133, 191, 200–202, 210, 216–217, 229–236, 251–298, 311–313, 338–344, 348, 395
conf.py	54	8	85%	20, 24, 32, 34, 69–71, 76
dispenser.py	202	26	87%	92, 124–125, 142–150, 192–193, 199–201, 219–220, 260–261, 319, 333–335, 346–347, 357, 370, 385
doctor.py	65	7	89%	67–69, 92–94, 134
generate.py	50	3	94%	44, 85, 103
goal.py	65	4	94%	21, 36–37, 47
init.py	121	51	58%	62, 66–71, 79, 88, 95, 121–122, 141–142, 147–171, 176–201, 214–225
log_handlers.py	68	7	90%	50–51, 63, 112–116, 125
proc.py	45	1	98%	100
sandbox.py	326	30	91%	34, 86–89, 94, 98–100, 176, 228–235, 246, 303, 361–362, 389–390, 632, 648, 663–665, 681
typed_client_generation.py	244	50	80%	84–86, 136, 169–174, 178–207, 231, 234–237, 255, 258–261, 321–332, 346, 352, 355–358
utils.py	172	53	69%	25–27, 46, 65–66, 72–84, 140–146, 170, 173, 179–192, 221–223, 252–255, 275, 294–304
src/algokit/core/_vendor/auth0/authentication
token_verifier.py	157	111	29%	16, 45, 58, 73–85, 98–107, 119–124, 136–137, 140, 170, 178–180, 190–199, 206–213, 227–236, 258, 280–287, 314–323, 333–444
src/algokit/core/compilers
python.py	28	5	82%	19–20, 25, 49–50
typescript.py	46	10	78%	26, 32, 35–38, 78–79, 88–89
src/algokit/core/config_commands
container_engine.py	41	21	49%	24, 29–31, 47–76
js_package_manager.py	36	11	69%	30–33, 38, 49–59
py_package_manager.py	36	11	69%	30–33, 38, 49–59
version_prompt.py	92	14	85%	37–38, 68, 87–90, 108, 118–125, 148
src/algokit/core/project
__init__.py	53	3	94%	50, 86, 145
bootstrap.py	314	54	83%	63, 70–72, 80–82, 87–88, 132, 141, 169–181, 223, 236–237, 289, 346, 425–426, 448, 475, 527–528, 534–540, 567–593, 610, 622–628, 640–642
deploy.py	69	9	87%	108–111, 120–122, 126, 131
run.py	132	13	90%	83, 88, 97–98, 133–134, 138–139, 143, 147, 277–278, 293
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	74	9	88%	123–133
models.py	92	17	82%	50, 52, 57, 71–74, 81–90
TOTAL	5661	966	83%

Tests	Skipped	Failures	Errors	Time
593	0 💤	0 ❌	0 🔥	45.095s ⏱️