0.0.1-alpha.5

deltas/0.0.1/alpha.5.md

@@ -0,0 +1,104 @@
+<!-- file: deltas/0.0.1/alpha.5.md -->
+<!-- version: 1 -->
+
+# Delta 0.0.1-alpha.5 — validation governance
+
+## Baseline
+
+Version attendue avant application :
+
+```text
+0.0.1-alpha.4.fix.1
+```
+
+Le history `history/0.0.1/alpha.4.fix.1.md` MUST avoir été appliqué et committé avant ce delta.
+
+Version après application :
+
+```text
+0.0.1-alpha.5
+```
+
+## Objet
+
+Formaliser la gouvernance de validation de PGR et faire évoluer sa matrice vivante pour appliquer immédiatement ces règles au dépôt lui-même.
+
+## Scope
+
+REPLACE :
+
+```text
+VERSION
+RULES.md
+docs/rules/000-README.md
+docs/validation/001-VALIDATION_MATRIX.md
+```
+
+ADD :
+
+```text
+docs/rules/400-VALIDATION.md
+deltas/0.0.1/alpha.5.md
+```
+
+DELETE : aucun.
+
+## Changements
+
+- `VERSION` passe à `0.0.1-alpha.5` ;
+- la famille `400-VALIDATION` devient active ;
+- la sélection de validation est définie à partir du scope, des risques et des preuves potentiellement invalidées ;
+- les catégories `FORMAT`, `AUDIT`, `CHECK`, `LINT`, `TEST-TARGETED`, `TEST-GLOBAL`, `DIAGNOSTIC`, `BUILD`, `PACKAGE`, `SMOKE`, `MAINTENANCE` et `PUBLISH` sont formalisées ;
+- la distinction comportement TEST / politique de dépôt AUDIT / investigation DIAGNOSTIC est explicitée ;
+- les tests doivent être utiles et non redondants, sans quota global de code coverage ;
+- les mocks/fakes/fixtures sont utilisés uniquement lorsqu'ils apportent une isolation ou un déterminisme réel et peuvent être mutualisés seulement en cas de besoin partagé ;
+- les validations live et externes restent distinctes des unités déterministes ;
+- l'autorité du gate opérateur et les statuts `PASS`, `FAIL`, `PARTIAL`, `BLOCKED` sont définis ;
+- la matrice PGR adopte les colonnes catégorie, prérequis, trigger, phase, coût et acteur.
+
+## Validation opérateur
+
+```bash
+test "$(cat VERSION)" = "0.0.1-alpha.5"
+
+test -f docs/rules/400-VALIDATION.md
+
+grep -Fx '<!-- file: docs/rules/400-VALIDATION.md -->' docs/rules/400-VALIDATION.md
+grep -F 'scope modifié' docs/rules/400-VALIDATION.md
+grep -F 'TEST-TARGETED' docs/rules/400-VALIDATION.md
+grep -F 'PGR MUST NOT imposer un pourcentage global minimal de code coverage' docs/rules/400-VALIDATION.md
+grep -F 'Un mock réseau MAY prouver la logique' docs/rules/400-VALIDATION.md
+grep -F 'Une tranche n'"'"'est `PASS` que lorsque la gate applicable' docs/rules/400-VALIDATION.md
+grep -F 'PARTIAL' docs/rules/400-VALIDATION.md
+grep -F 'BLOCKED' docs/rules/400-VALIDATION.md
+
+grep -F 'Commande / contrôle' docs/validation/001-VALIDATION_MATRIX.md
+grep -F '`PGR-GIT-001`' docs/validation/001-VALIDATION_MATRIX.md
+grep -F '`PGR-DOC-001`' docs/validation/001-VALIDATION_MATRIX.md
+
+git diff --check
+
+git add VERSION RULES.md docs/rules/000-README.md docs/rules/400-VALIDATION.md \
+    docs/validation/001-VALIDATION_MATRIX.md deltas/0.0.1/alpha.5.md
+
+git diff --cached --check
+
+git status --short
+```
+
+La sortie attendue avant ajout du history est :
+
+```text
+M  RULES.md
+M  VERSION
+A  deltas/0.0.1/alpha.5.md
+M  docs/rules/000-README.md
+A  docs/rules/400-VALIDATION.md
+M  docs/validation/001-VALIDATION_MATRIX.md
+```
+
+## Transition
+
+PASS : enregistrer `history/0.0.1/alpha.5.md`, committer `alpha.5`, puis passer à `0.0.1-beta.1`.
+
+FAIL : rester dans `alpha.5` avec `alpha.5.fix.1`, sauf REPLAN si le défaut remet en cause le scope ou le plan de `0.0.1`.