From 797230bc3343a96da7ea2f5fb04eae8704f3fab2 Mon Sep 17 00:00:00 2001 From: SinuS Von SifriduS Date: Wed, 23 Sep 2026 07:59:28 +0200 Subject: [PATCH] 0.0.1-alpha.4.fix.1 --- VERSION | 2 +- deltas/0.0.1/alpha.4.fix.1.md | 84 ++++++++++++++++++++++++++++++++++ history/0.0.1/alpha.4.fix.1.md | 57 +++++++++++++++++++++++ 3 files changed, 142 insertions(+), 1 deletion(-) create mode 100644 deltas/0.0.1/alpha.4.fix.1.md create mode 100644 history/0.0.1/alpha.4.fix.1.md diff --git a/VERSION b/VERSION index 2c6630c..e63c77b 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -0.0.1-alpha.4 +0.0.1-alpha.4.fix.1 diff --git a/deltas/0.0.1/alpha.4.fix.1.md b/deltas/0.0.1/alpha.4.fix.1.md new file mode 100644 index 0000000..671d423 --- /dev/null +++ b/deltas/0.0.1/alpha.4.fix.1.md @@ -0,0 +1,84 @@ + + + +# Delta 0.0.1-alpha.4.fix.1 — safe documentation gate quoting + +## Baseline + +Version attendue avant application : + +```text +0.0.1-alpha.4 +``` + +Le history `history/0.0.1/alpha.4.md` MUST avoir été appliqué et committé avant ce delta. + +Version après application : + +```text +0.0.1-alpha.4.fix.1 +``` + +## Objet + +Corriger uniquement la preuve opérateur de `alpha.4`. Le contenu normatif de `docs/rules/300-DOCUMENTATION.md` est conservé tel quel ; le défaut provenait de commandes `grep` dont les backticks étaient interprétés par Bash. + +## Scope + +REPLACE : + +```text +VERSION +``` + +ADD : + +```text +deltas/0.0.1/alpha.4.fix.1.md +``` + +DELETE : aucun. + +## Changements + +- `VERSION` passe à `0.0.1-alpha.4.fix.1` ; +- aucune règle documentaire n'est modifiée ; +- les assertions de `alpha.4` sont rejouées avec les backticks échappés lorsqu'une chaîne entre guillemets doubles est nécessaire ; +- la gate confirme ainsi réellement les passages `USAGE.md` et `fr/` / `en/` / `de/` qui n'avaient pas été correctement prouvés dans `alpha.4`. + +## Validation opérateur + +```bash +test "$(cat VERSION)" = "0.0.1-alpha.4.fix.1" + +test -f docs/rules/300-DOCUMENTATION.md + +grep -Fx '' docs/rules/300-DOCUMENTATION.md +grep -F -- "\`USAGE.md\` est un guide d'utilisation durable" docs/rules/300-DOCUMENTATION.md +grep -F -- '`ROADMAP.md` décrit la trajectoire macro du projet' docs/rules/300-DOCUMENTATION.md +grep -F -- '`version` est une révision interne du fichier. Elle est indépendante de `VERSION`' docs/rules/300-DOCUMENTATION.md +grep -F -- 'Un snapshot historique MUST NOT être réécrit silencieusement' docs/rules/300-DOCUMENTATION.md +grep -F -- "PGR MUST NOT créer d'arborescence \`fr/\`, \`en/\`, \`de/\`" docs/rules/300-DOCUMENTATION.md +grep -F -- 'La documentation est une aide au développement et à la maintenance, pas une fin en soi.' docs/rules/300-DOCUMENTATION.md + +git diff --check + +git add VERSION deltas/0.0.1/alpha.4.fix.1.md + +git diff --cached --check + +git status --short +``` + +La sortie attendue avant ajout du history est : + +```text +M VERSION +A deltas/0.0.1/alpha.4.fix.1.md +``` + +## Transition + +PASS : enregistrer `history/0.0.1/alpha.4.fix.1.md`, committer `alpha.4.fix.1`, puis passer à `0.0.1-alpha.5`. + +FAIL : rester dans `alpha.4` avec `alpha.4.fix.2`, sauf REPLAN si le défaut remet en cause le scope ou le plan. diff --git a/history/0.0.1/alpha.4.fix.1.md b/history/0.0.1/alpha.4.fix.1.md new file mode 100644 index 0000000..a1a9e29 --- /dev/null +++ b/history/0.0.1/alpha.4.fix.1.md @@ -0,0 +1,57 @@ + + + +# History 0.0.1-alpha.4.fix.1 — safe documentation gate quoting + +## Statut + +PASS + +Le correctif a confirmé que le contenu normatif de `docs/rules/300-DOCUMENTATION.md` était correct et que le défaut de `alpha.4` provenait uniquement du quoting Bash de deux assertions contenant des backticks. + +## Baseline + +Version validée par l'opérateur : + +```text +0.0.1-alpha.4.fix.1 +``` + +Le delta `0.0.1-alpha.4.fix.1` a été appliqué après commit de `0.0.1-alpha.4` avec son history `FAIL`. + +## Validation opérateur observée + +Les assertions qui avaient échoué dans `alpha.4` ont été rejouées avec un quoting sûr : + +```bash +grep -F -- "\`USAGE.md\` est un guide d'utilisation durable" \ + docs/rules/300-DOCUMENTATION.md + +grep -F -- "PGR MUST NOT créer d'arborescence \`fr/\`, \`en/\`, \`de/\`" \ + docs/rules/300-DOCUMENTATION.md +``` + +Les deux recherches ont retourné les passages normatifs attendus sans exécuter les fragments entre backticks. + +L'état du fix a ensuite été indexé et contrôlé : + +```bash +git add -A +git diff --cached --check +git status --short +``` + +`git diff --cached --check` n'a produit aucun diagnostic. + +La sortie finale observée avant ajout du présent history était : + +```text +M VERSION +A deltas/0.0.1/alpha.4.fix.1.md +``` + +## Résultat + +`alpha.4.fix.1` est validée sans nouveau fix ni REPLAN. + +La tranche suivante est `0.0.1-alpha.5`, consacrée à la gouvernance de validation : matrice, sélection proportionnelle, catégories de preuves, tests utiles, mocks proportionnés et autorité du gate opérateur.