0.0.5-alpha.3.fix.1

deltas/0.0.5/alpha.3.fix.1.md

@@ -0,0 +1,164 @@
+<!-- file: deltas/0.0.5/alpha.3.fix.1.md -->
+<!-- version: 1 -->
+
+# Delta 0.0.5-alpha.3.fix.1 — couverture des tables dans les exemples Markdown fenced
+
+## Baseline et version
+
+Baseline attendue : commit opérateur de `0.0.5-alpha.3`, réalisé après application de `history/0.0.5/alpha.3.md` avec statut `FAIL`.
+
+Le hash de ce commit n'est pas anticipé.
+
+Version avant application :
+
+```text
+0.0.5-alpha.3
+```
+
+Version après application :
+
+```text
+0.0.5-alpha.3.fix.1
+```
+
+## Objet
+
+Corriger le faux négatif découvert pendant la gate opérateur de `alpha.3` : `audit_markdown_tables.py` ignorait toutes les tables placées dans des blocs fenced, y compris les exemples explicitement `markdown` du template `004-FILE_FAMILY_CONTRACTS.md`.
+
+Le fix étend uniquement le contrat de l'audit de tables. Il ne transforme pas l'audit en analyseur général des blocs de code et n'introduit aucun contenu de la tranche Rust `alpha.4`.
+
+## Scope
+
+REPLACE :
+
+```text
+VERSION
+scripts/audit_markdown_tables.py
+docs/templates/004-FILE_FAMILY_CONTRACTS.md
+docs/validation/001-VALIDATION_MATRIX.md
+```
+
+ADD :
+
+```text
+tests/test_markdown_tables.py
+deltas/0.0.5/alpha.3.fix.1.md
+```
+
+DELETE : aucun.
+
+Le history `history/0.0.5/alpha.3.md` appartient au commit baseline du FAIL et n'est pas inclus dans l'archive du fix.
+
+## Correction
+
+`scripts/audit_markdown_tables.py` passe en révision interne `2`.
+
+L'audit continue de contrôler les tables Markdown ordinaires. Dans un bloc fenced :
+
+- une fence explicitement `markdown` est auditée ;
+- une fence explicitement `md` est auditée ;
+- une fence d'un autre langage ou sans langage reste ignorée.
+
+Cette frontière évite les faux positifs sur les sorties terminal, extraits de code ou tableaux ASCII qui utilisent éventuellement des pipes sans être du Markdown à gouverner.
+
+`tests/test_markdown_tables.py` verrouille quatre cas :
+
+1. table ordinaire et table fenced Markdown valides toutes deux comptées ;
+2. table mal alignée dans une fence `markdown` rejetée ;
+3. alias `md` audité ;
+4. fence non Markdown conservée hors scope.
+
+`docs/templates/004-FILE_FAMILY_CONTRACTS.md` passe en révision `2` et réaligne les deux tables fenced révélées par le nouvel audit.
+
+`docs/validation/001-VALIDATION_MATRIX.md` passe en révision `10` et explicite la frontière de `PGR-MD-TABLE-001`.
+
+## Validation opérateur
+
+Après application du history `FAIL`, commit de `alpha.3`, puis application du présent delta :
+
+```bash
+test "$(cat VERSION)" = '0.0.5-alpha.3.fix.1'
+test -f history/0.0.5/alpha.3.md
+test -f deltas/0.0.5/alpha.3.md
+test -f deltas/0.0.5/alpha.3.fix.1.md
+test -f tests/test_markdown_tables.py
+test ! -e history/0.0.5/alpha.3.fix.1.md
+
+grep -A2 '^## Statut$' history/0.0.5/alpha.3.md | grep -Fx 'FAIL'
+grep -Fx '# version: 2' scripts/audit_markdown_tables.py
+grep -Fx '<!-- version: 2 -->' docs/templates/004-FILE_FAMILY_CONTRACTS.md
+grep -Fx '<!-- version: 10 -->' docs/validation/001-VALIDATION_MATRIX.md
+grep -Fx '# version: 1' tests/test_markdown_tables.py
+
+python3 -B -m unittest discover -s tests -p 'test_markdown_tables.py' -v
+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
+
+python3 -B scripts/audit_markdown_tables.py docs/templates/004-FILE_FAMILY_CONTRACTS.md
+
+python3 -B - <<'PY'
+from pathlib import Path
+import re
+
+history = Path('history/0.0.5/alpha.3.md').read_text(encoding='utf-8')
+assert re.search(r'## Statut\s+FAIL\s', history)
+
+script = Path('scripts/audit_markdown_tables.py').read_text(encoding='utf-8')
+assert '_MARKDOWN_FENCE_LANGUAGES = frozenset({"markdown", "md"})' in script
+assert 'audit_fenced_markdown' in script
+
+template = Path('docs/templates/004-FILE_FAMILY_CONTRACTS.md').read_text(encoding='utf-8')
+assert template.count('```markdown') == 2
+
+matrix = Path('docs/validation/001-VALIDATION_MATRIX.md').read_text(encoding='utf-8')
+assert 'fences explicitement `markdown` ou `md`' in matrix
+assert 'sorties terminal' in matrix
+
+print('0.0.5 alpha.3.fix.1 fenced Markdown table audit: clean (regression covered, two template examples governed)')
+PY
+
+git diff --check
+
+git add VERSION scripts/audit_markdown_tables.py tests/test_markdown_tables.py \
+    docs/templates/004-FILE_FAMILY_CONTRACTS.md \
+    docs/validation/001-VALIDATION_MATRIX.md \
+    deltas/0.0.5/alpha.3.fix.1.md
+
+git diff --cached --check
+git status --short
+```
+
+La sortie Git attendue avant ajout du history du fix est exactement :
+
+```text
+M  VERSION
+A  deltas/0.0.5/alpha.3.fix.1.md
+M  docs/templates/004-FILE_FAMILY_CONTRACTS.md
+M  docs/validation/001-VALIDATION_MATRIX.md
+M  scripts/audit_markdown_tables.py
+A  tests/test_markdown_tables.py
+```
+
+Le contrôle ciblé du template doit désormais compter ses deux exemples :
+
+```text
+Markdown table audit: clean (2 table(s), 1 file(s))
+```
+
+La suite Python doit compter `19` tests si aucun autre test n'est ajouté localement avant exécution.
+
+## Transition
+
+### PASS
+
+Créer et appliquer séparément `history/0.0.5/alpha.3.fix.1.md`, committer et pousser le fix, puis reprendre le plan `0.0.5` à `alpha.4`.
+
+### FAIL
+
+Rester dans `0.0.5-alpha.3.fix.M`. Le scope MUST rester limité au contrat de `PGR-MD-TABLE-001` et aux tables révélées par ce contrôle tant qu'aucun défaut plus large ne justifie un REPLAN.