Files
pgr/deltas/0.0.1/alpha.5.md
2026-09-23 08:13:06 +02:00

3.3 KiB

Delta 0.0.1-alpha.5 — validation governance

Baseline

Version attendue avant application :

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 :

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 :

VERSION
RULES.md
docs/rules/000-README.md
docs/validation/001-VALIDATION_MATRIX.md

ADD :

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

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 :

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.