fix(dev): reliable WSL/Linux dev startup without proprietary assets (#56) #59

Merged

Reliodas merged 7 commits from docs/56-windows-workstation into develop

2026-06-25 06:36:55 +00:00

Reliodas commented

2026-06-25 06:28:52 +00:00

Owner

Closes #56

Rend le démarrage local fiable sous WSL/Linux et tolérant aux assets absents.

Changements

dev.sh : la copie des assets original/ est gardée et n'avorte plus sur un checkout propre (l'app tourne sans polices/logo/fond). Vérification de la version Node contre .nvmrc (24.13.1) avec avertissement en cas d'écart.
docs/Windows.md : guide WSL2 — voie supportée sous Windows (pas de workflow natif PowerShell) — lié depuis README.md et CONTRIBUTING.md. Linux natif reste un environnement de dev de première classe.
AGENTS.md / CLAUDE.md : exemples tea-cli corrigés (index après les flags ; tea-cli issues <n> --repo … échoue car le parseur stoppe les flags au premier positionnel).

Décision / écart de critère

Suite à la décision de passer de Windows natif à WSL, le critère « une commande ou un script Windows/PowerShell permet de lancer serveur et client sans WSL » n'est volontairement pas implémenté : WSL est désormais la voie supportée sous Windows.

Vérification (checkout propre, sans `original/` ni `client/public/`)

typecheck, build, check:assets : OK (build asset-free, polices résolues au runtime)
node:test 192 pass (1 skipped), Jest 13/13, Vitest 83/83
validate:questions OK (142), smoke OK, e2e Playwright 3/3
coverage serveur 93.33% stmts (seuils 79/75/80/79 respectés), client exit 0
./dev.sh démarre sans les assets (message explicite, puis install + serveurs)

Closes #56 Rend le démarrage local fiable sous WSL/Linux et tolérant aux assets absents. ## Changements - `dev.sh` : la copie des assets `original/` est gardée et n'avorte plus sur un checkout propre (l'app tourne sans polices/logo/fond). Vérification de la version Node contre `.nvmrc` (24.13.1) avec avertissement en cas d'écart. - `docs/Windows.md` : guide WSL2 — voie supportée sous Windows (pas de workflow natif PowerShell) — lié depuis `README.md` et `CONTRIBUTING.md`. Linux natif reste un environnement de dev de première classe. - `AGENTS.md` / `CLAUDE.md` : exemples `tea-cli` corrigés (index après les flags ; `tea-cli issues <n> --repo …` échoue car le parseur stoppe les flags au premier positionnel). ## Décision / écart de critère Suite à la décision de passer de Windows natif à WSL, le critère « une commande ou un script Windows/PowerShell permet de lancer serveur et client sans WSL » n'est volontairement pas implémenté : WSL est désormais la voie supportée sous Windows. ## Vérification (checkout propre, sans `original/` ni `client/public/`) - `typecheck`, `build`, `check:assets` : OK (build asset-free, polices résolues au runtime) - `node:test` 192 pass (1 skipped), Jest 13/13, Vitest 83/83 - `validate:questions` OK (142), `smoke` OK, e2e Playwright 3/3 - coverage serveur 93.33% stmts (seuils 79/75/80/79 respectés), client exit 0 - `./dev.sh` démarre sans les assets (message explicite, puis install + serveurs)

Reliodas added 7 commits

2026-06-25 06:28:52 +00:00

docs(windows): document local workstation setup

ci/woodpecker/push/woodpecker Pipeline was successful

Details

00b816fb4d

Refs #56

docs(workflow): clarify ticket and PR lifecycle (#56 )

ci/woodpecker/push/woodpecker Pipeline was successful

Details

e62eea47ff

docs(windows): document tea-cli usage and sandbox network escalation (#56 )

ci/woodpecker/push/woodpecker Pipeline was successful

Details

7df1fcc0c8

docs(windows): replace native setup with WSL guidance (#56 )

ci/woodpecker/push/woodpecker Pipeline was successful

Details

ec22cb87e6

fix(dev): tolerate missing assets and verify Node version (#56 ) 0ae34397c8

Guard the original/ asset copy so a clean checkout without the proprietary
fonts and images starts instead of aborting under set -e. Compare the running
Node.js against the version pinned in .nvmrc and warn on mismatch.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(windows): add WSL workstation guide (#56 ) 9f5b77aebb

Document WSL2 as the supported Windows workflow (no native PowerShell path) and
link it from README and CONTRIBUTING. Linux stays a first-class environment.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(forgejo): fix tea-cli single-issue argument order

ci/woodpecker/push/woodpecker Pipeline was successful

Details

ci/woodpecker/pr/woodpecker Pipeline was successful

Details

ci/woodpecker/pull_request_closed/woodpecker Pipeline was successful

Details

3dedbfcf1f

tea-cli stops parsing flags at the first positional argument, so the documented
`tea-cli issue <n> --repo …` form drops --repo and fails with "Remote repository
required". Put the issue index after the flags and clarify this is an argument
ordering quirk, not a sandbox/network failure.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>