Files
pgr/deltas/0.0.3/alpha.5.md
2026-09-24 10:57:10 +02:00

3.4 KiB

Delta 0.0.3-alpha.5 — audit des headers Markdown

Baseline et version

Baseline : 0.0.3-alpha.4, avec history/0.0.3/alpha.4.md appliqué et committé. Ce delta MUST NOT être appliqué avant ce commit.

Version avant application :

0.0.3-alpha.4

Version après application :

0.0.3-alpha.5

Objet

Extraire le contrôle des headers Markdown répété en Python inline dans les gates précédentes. scripts/audit_markdown_headers.py vérifie une seule propriété documentaire : les deux premières lignes de chaque fichier choisi doivent déclarer son chemin relatif canonique et une révision interne positive. Le script accepte des chemins explicites depuis la racine du projet, lit sans modifier, produit des erreurs déterministes avec chemin et ligne et distingue violation de sélection invalide.

docs/rules/300-DOCUMENTATION.md possède la convention pour le corpus Markdown de PGR. La matrice inscrit l'audit mécanique séparément de la revue des rôles documentaires, de l'audit des tableaux et de celui des liens. Une révision positive ne démontre pas qu'elle a été incrémentée à bon escient : cela reste une décision de revue.

Scope

REPLACE :

VERSION
docs/rules/300-DOCUMENTATION.md
docs/validation/001-VALIDATION_MATRIX.md

ADD :

scripts/audit_markdown_headers.py
tests/test_markdown_headers.py
deltas/0.0.3/alpha.5.md

DELETE : aucun.

L'archive livre uniquement ces fichiers complets. Aucun history alpha.5, réécriture historique, nouveau profil de langage ou autre audit Markdown n'est inclus.

Validation opérateur

Après application sur le commit alpha.4, depuis la racine du dépôt :

test "$(cat VERSION)" = '0.0.3-alpha.5'
git cat-file -e HEAD:history/0.0.3/alpha.4.md
test -f history/0.0.3/alpha.4.md
test -f deltas/0.0.3/alpha.5.md
test ! -e history/0.0.3/alpha.5.md

grep -Fx '<!-- version: 2 -->' docs/rules/300-DOCUMENTATION.md
grep -Fx '<!-- version: 8 -->' docs/validation/001-VALIDATION_MATRIX.md

python3 -B -m unittest discover -s tests -p test_markdown_headers.py -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/rules/300-DOCUMENTATION.md \
    docs/validation/001-VALIDATION_MATRIX.md scripts/audit_markdown_headers.py \
    tests/test_markdown_headers.py deltas/0.0.3/alpha.5.md
git diff --cached --check
git status --short

Scope attendu avant ajout du history : trois REPLACE et trois ADD, sans toucher à un delta ou history antérieur. Vérifier que le nouveau script reste monotâche, traite les headers faux et les chemins absents, et ne remplace ni la revue des documents ni les deux autres audits Markdown.

Transition

PASS

Produire séparément history/0.0.3/alpha.5.md avec les preuves réellement observées, l'appliquer et committer avant la tranche alpha.6, consacrée à la décision conditionnelle sur le template de workflow.

FAIL

Enregistrer la défaillance et corriger ce scope dans alpha.5.fix.1, sauf REPLAN explicitement justifié.