# Delta 0.1.1-alpha.3.fix.2 — correction de la gate des déclarations de types ## Baseline et version Baseline attendue : commit opérateur de `0.1.1-alpha.3.fix.1`, réalisé après application de `history/0.1.1/alpha.3.fix.1.md` avec statut `FAIL`. Le hash de ce commit n'est pas anticipé. Version avant application : ```text 0.1.1-alpha.3.fix.1 ``` Version après application : ```text 0.1.1-alpha.3.fix.2 ``` ## Objet Corriger uniquement la syntaxe défectueuse de la gate opérateur de `alpha.3.fix.1`. Les règles et guides livrés par `alpha.3.fix.1` restent inchangés. Le delta historique `deltas/0.1.1/alpha.3.fix.1.md` reste également inchangé. Le défaut observé était un littéral Python entouré de quotes simples alors que son texte contenait l'apostrophe de `l'expérience` : ```python 'qualité TypeScript et à l'expérience IDE' ``` Le fix utilise des littéraux syntaxiquement sûrs dans la nouvelle gate et généralise cette précaution aux assertions contenant des apostrophes, sans modifier leur sens. ## Scope REPLACE : ```text VERSION docs/plans/007-V0_1_1_WEB_FRONTEND_FOUNDATION_PLAN.md ``` ADD : ```text deltas/0.1.1/alpha.3.fix.2.md ``` DELETE : aucun. Aucune règle normative, aucun template, skeleton, script d'audit ou test n'est modifié par ce correctif. ## Validation opérateur Après application du history `FAIL`, commit/push de `alpha.3.fix.1`, puis application du présent delta : ```bash test "$(cat VERSION)" = '0.1.1-alpha.3.fix.2' git cat-file -e HEAD:history/0.1.1/alpha.3.fix.1.md test -f history/0.1.1/alpha.3.fix.1.md test -f deltas/0.1.1/alpha.3.fix.1.md test -f deltas/0.1.1/alpha.3.fix.2.md test ! -e history/0.1.1/alpha.3.fix.2.md grep -A2 '^## Statut$' history/0.1.1/alpha.3.fix.1.md | grep -Fx 'FAIL' grep -Fx '' docs/plans/007-V0_1_1_WEB_FRONTEND_FOUNDATION_PLAN.md grep -Fx '' docs/rules/530-TYPESCRIPT.md grep -Fx '' docs/rules/540-JAVASCRIPT_PACKAGE_ECOSYSTEM.md grep -Fx '' docs/templates/008-WEB_TYPESCRIPT_PACKAGE.md python3 -B - <<'PYGATE' from pathlib import Path import json import re history = Path('history/0.1.1/alpha.3.fix.1.md').read_text(encoding='utf-8') assert re.search(r'## Statut\s+FAIL\s', history) typescript = Path('docs/rules/530-TYPESCRIPT.md').read_text(encoding='utf-8') for phrase in ( 'Déclarations de types externes et intégration IDE', 'fournit déjà ses propres fichiers de déclaration TypeScript', '@types/', '`devDependencies`', '`@types/node`', '`@types/bootstrap`', 'Un projet qui ne consomme que le CSS/Sass de Bootstrap', '`compilerOptions.types`', 'bibliothèque publiée', ): assert phrase in typescript, phrase packages = Path('docs/rules/540-JAVASCRIPT_PACKAGE_ECOSYSTEM.md').read_text(encoding='utf-8') for phrase in ( 'Dépendances de développement et packages de déclarations', 'la dépendance runtime fournit déjà ses propres types', '@types/', '`@types/node` est pertinent', '`@types/bootstrap` est pertinent', 'Le template PGR générique conserve volontairement un `package.json` sans `devDependencies` préremplies', 'Pour une bibliothèque publiée', ): assert phrase in packages, phrase guide = Path('docs/templates/008-WEB_TYPESCRIPT_PACKAGE.md').read_text(encoding='utf-8') for phrase in ( '`devDependencies` et déclarations de types', 'fournit-il déjà ses propres types ?', 'ne pas ajouter un @types redondant', '"@types/node": ""', '"@types/bootstrap": ""', "qualité TypeScript et à l'expérience IDE", ): assert phrase in guide, phrase package = json.loads(Path('templates/web-typescript/package.json').read_text(encoding='utf-8')) assert package == { 'name': 'project-web', 'private': True, 'scripts': {'typecheck': 'tsc --noEmit'}, } tsconfig = json.loads(Path('templates/web-typescript/tsconfig.json').read_text(encoding='utf-8')) assert tsconfig == { 'compilerOptions': { 'strict': True, 'noEmit': True, 'noUnusedLocals': True, 'noUnusedParameters': True, 'noFallthroughCasesInSwitch': True, } } plan = Path('docs/plans/007-V0_1_1_WEB_FRONTEND_FOUNDATION_PLAN.md').read_text(encoding='utf-8') for phrase in ( 'Statut opérateur : **FAIL**.', "### alpha.3.fix.2 — correction de la gate des déclarations de types", 'types embarqués → @types si nécessaire', 'Aucun défaut normatif du correctif', 'assertions contenant des apostrophes', ): assert phrase in plan, phrase assert Path('docs/rules/550-VITE.md').read_text(encoding='utf-8').splitlines()[1] == '' assert Path('docs/rules/560-CSS_SASS.md').read_text(encoding='utf-8').splitlines()[1] == '' assert Path('docs/rules/710-TAURI.md').read_text(encoding='utf-8').splitlines()[1] == '' print('0.1.1 alpha.3.fix.2 type declarations gate: clean (alpha.3.fix.1 FAIL preserved, type declarations reconfirmed, Python literals safe)') PYGATE python3 -B -m unittest discover -s tests -v python3 -B scripts/audit_markdown_headers.py \ README.md RULES.md ROADMAP.md CHANGELOG.md docs deltas history prompts python3 -B scripts/audit_markdown_tables.py \ README.md RULES.md ROADMAP.md CHANGELOG.md docs deltas history prompts python3 -B scripts/audit_markdown_links.py \ README.md RULES.md ROADMAP.md CHANGELOG.md docs deltas history prompts git diff --check git add VERSION docs/plans/007-V0_1_1_WEB_FRONTEND_FOUNDATION_PLAN.md \ deltas/0.1.1/alpha.3.fix.2.md git diff --cached --check git status --short ``` Le scope indexé attendu avant ajout du history du fix est exactement : ```text M VERSION A deltas/0.1.1/alpha.3.fix.2.md M docs/plans/007-V0_1_1_WEB_FRONTEND_FOUNDATION_PLAN.md ``` ## Revue opérateur complémentaire Confirmer que : - le `FAIL` de `alpha.3.fix.1` est conservé historiquement ; - `deltas/0.1.1/alpha.3.fix.1.md` n'est pas réécrit ; - `docs/rules/530-TYPESCRIPT.md`, `docs/rules/540-JAVASCRIPT_PACKAGE_ECOSYSTEM.md` et `docs/templates/008-WEB_TYPESCRIPT_PACKAGE.md` ne sont pas modifiés par le fix ; - `templates/web-typescript/package.json` et `templates/web-typescript/tsconfig.json` ne sont pas modifiés par le fix ; - aucun contenu Vite, CSS/Sass, WASM ou Tauri n'est absorbé dans le correctif. ## Transition ### PASS Produire `history/0.1.1/alpha.3.fix.2.md`, l'appliquer puis committer/pousser le fix. Reprendre ensuite la trajectoire normale avec `0.1.1-alpha.4`, consacré à Vite, au dev server, aux caches et aux outputs de production. ### FAIL Consigner le diagnostic réel dans `history/0.1.1/alpha.3.fix.2.md` et rester dans `alpha.3.fix.M`. Le scope MUST rester limité à la correction de la gate tant qu'aucun défaut plus large ne justifie un REPLAN.