From 15fa124184d1d701416ece7f91a5fb0c4560148f Mon Sep 17 00:00:00 2001 From: SinuS Von SifriduS Date: Wed, 23 Sep 2026 07:41:36 +0200 Subject: [PATCH] 0.0.1-alpha.1.fix.2 --- VERSION | 2 +- deltas/0.0.1/alpha.1.fix.2.md | 80 ++++++++++++++++++++++++ docs/validation/001-VALIDATION_MATRIX.md | 50 ++++++++++----- history/0.0.1/alpha.1.fix.2.md | 66 +++++++++++++++++++ 4 files changed, 181 insertions(+), 17 deletions(-) create mode 100644 deltas/0.0.1/alpha.1.fix.2.md create mode 100644 history/0.0.1/alpha.1.fix.2.md diff --git a/VERSION b/VERSION index b6fed41..8d016b4 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -0.0.1-alpha.1.fix.1 +0.0.1-alpha.1.fix.2 diff --git a/deltas/0.0.1/alpha.1.fix.2.md b/deltas/0.0.1/alpha.1.fix.2.md new file mode 100644 index 0000000..cb9dc05 --- /dev/null +++ b/deltas/0.0.1/alpha.1.fix.2.md @@ -0,0 +1,80 @@ + + + +# Delta 0.0.1-alpha.1.fix.2 — cohérence de la matrice de validation + +## Baseline + +Version attendue avant application : + +```text +0.0.1-alpha.1.fix.1 +``` + +Version après application : + +```text +0.0.1-alpha.1.fix.2 +``` + +## Objet + +Corriger uniquement la matrice de validation vivante restée incohérente après le fix Eclipse de `alpha.1.fix.1`. + +## Scope + +REPLACE : + +```text +VERSION +docs/validation/001-VALIDATION_MATRIX.md +``` + +ADD : + +```text +deltas/0.0.1/alpha.1.fix.2.md +``` + +DELETE : aucun. + +## Changements + +- `VERSION` passe à `0.0.1-alpha.1.fix.2` ; +- la matrice ne hardcode plus `0.0.1-alpha.1` comme valeur permanente de `PGR-VERSION-001` ; +- la politique Eclipse reflète désormais l'exception versionnée `.settings/org.eclipse.core.resources.prefs` ; +- la gate de bootstrap devient un modèle générique dont chaque delta concrétise la version attendue ; +- le workflow PASS/FAIL de la matrice reflète le cycle réellement retenu. + +Aucun changement de scope du plan `0.0.1` n'est requis. + +## Validation opérateur + +```bash +test "$(cat VERSION)" = "0.0.1-alpha.1.fix.2" + +grep -Fx '.settings/org.eclipse.core.resources.prefs' docs/validation/001-VALIDATION_MATRIX.md + +grep -F '0.0.1-alpha.1' docs/validation/001-VALIDATION_MATRIX.md && { + echo 'La matrice ne doit plus pinner la version historique alpha.1.' >&2 + exit 1 +} || true + +git add VERSION docs/validation/001-VALIDATION_MATRIX.md deltas/0.0.1/alpha.1.fix.2.md \ + history/0.0.1/alpha.1.md history/0.0.1/alpha.1.fix.1.md + +git ls-files --error-unmatch history/0.0.1/alpha.1.md +git ls-files --error-unmatch history/0.0.1/alpha.1.fix.1.md + +git diff --cached --check + +git status --short +``` + +Le `grep` recherchant `0.0.1-alpha.1` doit ne produire aucune occurrence dans la matrice. + +## Transition + +PASS : enregistrer `history/0.0.1/alpha.1.fix.2.md`, committer l'état corrigé de `alpha.1`, puis passer à `0.0.1-alpha.2`. + +FAIL : rester dans `alpha.1` avec `alpha.1.fix.3` ou REPLAN si le défaut révèle un problème plus large. diff --git a/docs/validation/001-VALIDATION_MATRIX.md b/docs/validation/001-VALIDATION_MATRIX.md index de9bb46..8dca75f 100644 --- a/docs/validation/001-VALIDATION_MATRIX.md +++ b/docs/validation/001-VALIDATION_MATRIX.md @@ -1,54 +1,72 @@ - + # Matrice de validation PGR ## Rôle -Cette matrice décrit les validations canoniques du dépôt PGR. Elle évoluera avec le projet et ne doit pas inventer des scripts uniquement pour remplir une case. +Cette matrice décrit les validations canoniques du dépôt PGR. Elle évolue avec le projet et ne doit pas inventer des scripts uniquement pour remplir une case. -`0.0.1-alpha.1` est une tranche documentaire de bootstrap sans toolchain applicative. Les premiers contrôles sont donc volontairement simples. +PGR est encore dans sa phase de bootstrap documentaire. Les contrôles initiaux restent donc volontairement simples et reposent sur Git, des commandes shell ciblées et une revue opérateur explicite. ## Commandes initiales | ID | Catégorie | Commande / contrôle | Trigger | Phase | |-------------------------|-----------|------------------------------------------------------------------------------------------|--------------------------------------------|----------------------| -| `PGR-GIT-001` | CHECK | `git diff --check` | toute modification suivie par Git | alpha/beta/RC/stable | -| `PGR-GIT-BOOTSTRAP-001` | CHECK | `git add .` puis `git diff --cached --check` | bootstrap ou fichiers entièrement nouveaux | alpha.1/bootstrap | -| `PGR-VERSION-001` | CHECK | `test "$(cat VERSION)" = "0.0.1-alpha.1"` | tranche `0.0.1-alpha.1` | alpha.1 | +| `PGR-GIT-001` | CHECK | `git diff --check` ou `git diff --cached --check` selon l'état de l'index | toute modification suivie par Git | alpha/beta/RC/stable | +| `PGR-GIT-BOOTSTRAP-001` | CHECK | `git add .` puis `git diff --cached --check` | bootstrap ou fichiers entièrement nouveaux | bootstrap | +| `PGR-VERSION-001` | CHECK | comparer `VERSION` à la version attendue par le delta courant | changement de tranche/version | alpha/beta/RC/stable | | `PGR-LAYOUT-001` | REVIEW | `find . -type f -not -path './.git/*' -print` puis comparaison au scope du delta | ajout/suppression/déplacement de fichiers | alpha/beta/RC/stable | | `PGR-DOC-001` | REVIEW | vérifier headers `file/version`, chemins, liens et responsabilités des documents touchés | modification documentaire | alpha/beta/RC/stable | | `PGR-STATUS-001` | CHECK | `git status --short` | avant fermeture d'une tranche | alpha/beta/RC/stable | -## Gate `0.0.1-alpha.1` +## Politique Eclipse actuelle -Après application du delta : +Les métadonnées Eclipse spécifiques à une machine restent ignorées, notamment `.project`, `.classpath` et les préférences non partagées. + +Le fichier suivant constitue une exception versionnée, car il porte l'encodage UTF-8 du projet et n'est pas nécessairement régénéré lors d'un import Git : + +```text +.settings/org.eclipse.core.resources.prefs +``` + +Le `.gitignore` doit donc contenir : + +```text +.settings/* +!.settings/org.eclipse.core.resources.prefs +``` + +## Gate documentaire de bootstrap + +Pour une tranche documentaire de bootstrap, le delta doit sélectionner uniquement les contrôles nécessaires à son scope. Une gate typique peut inclure : ```bash git status --short -test "$(cat VERSION)" = "0.0.1-alpha.1" +test "$(cat VERSION)" = "" find . -type f -not -path './.git/*' -print -git add . git diff --cached --check git status --short ``` -L'opérateur vérifie également que : +Le placeholder `` appartient à la documentation de la matrice ; chaque delta fournit la commande concrète avec sa propre version. + +L'opérateur vérifie également, selon le scope du delta, que : -- `.project`, `.classpath` et `.settings/` Eclipse restent locaux/ignorés ; - aucun répertoire vide n'a été ajouté uniquement pour anticiper le futur ; -- les fichiers listés par le delta sont les seuls fichiers PGR introduits par la tranche ; +- les fichiers ajoutés/remplacés/supprimés correspondent au delta ; - les headers `file/version` correspondent aux chemins réels ; -- `VERSION` contient exactement une ligne `0.0.1-alpha.1` ; +- `VERSION` contient exactement une ligne avec la version de la tranche courante ; - les liens Markdown de navigation principaux sont cohérents ; -- aucun secret, chemin machine absolu ou artefact local n'est introduit. +- aucun secret, chemin machine absolu ou artefact local non autorisé n'est introduit ; +- les exceptions Git intentionnellement versionnées restent effectivement traçables. ## Autorité de validation Une validation n'est `PASS` qu'après exécution réelle du gate opérateur. La génération du delta ou une prévalidation par l'IA ne constitue pas le résultat opérateur. -Après `PASS`, la tranche suivante doit enregistrer `history/0.0.1/alpha.1.md` séparément avant le commit de l'état validé et fournir le delta suivant conformément au workflow PGR retenu. +Après un `PASS`, l'historique de la tranche validée est fourni séparément du delta suivant. Un `FAIL` reste dans le scope de la tranche courante via `.fix.N`, sauf REPLAN ou abandon explicitement justifié. diff --git a/history/0.0.1/alpha.1.fix.2.md b/history/0.0.1/alpha.1.fix.2.md new file mode 100644 index 0000000..da9c502 --- /dev/null +++ b/history/0.0.1/alpha.1.fix.2.md @@ -0,0 +1,66 @@ + + + +# History 0.0.1-alpha.1.fix.2 — cohérence de la matrice de validation + +## Statut + +PASS + +La matrice de validation vivante a été remise en cohérence avec la politique Eclipse versionnée et le contrôle de `VERSION` est désormais générique. + +## Baseline + +Version validée par l'opérateur : + +```text +0.0.1-alpha.1.fix.2 +``` + +Le delta appliqué était `0.0.1-alpha.1.fix.2` sur la baseline `0.0.1-alpha.1.fix.1`. + +## Validation opérateur observée + +Les contrôles suivants ont été exécutés avec succès : + +```bash +test "$(cat VERSION)" = "0.0.1-alpha.1.fix.2" + +grep -Fx '.settings/org.eclipse.core.resources.prefs' \ + docs/validation/001-VALIDATION_MATRIX.md + +git diff --check + +git add -A + +test "$(cat VERSION)" = "0.0.1-alpha.1.fix.2" + +grep -Fx '.settings/org.eclipse.core.resources.prefs' \ + docs/validation/001-VALIDATION_MATRIX.md + +git diff --cached --check + +git status --short +``` + +`git diff --check` et `git diff --cached --check` n'ont produit aucun diagnostic. + +La sortie finale observée avant ajout du présent history était : + +```text +M VERSION +A deltas/0.0.1/alpha.1.fix.2.md +M docs/validation/001-VALIDATION_MATRIX.md +``` + +La matrice contient bien l'exception versionnée : + +```text +.settings/org.eclipse.core.resources.prefs +``` + +## Résultat + +Le bootstrap `alpha.1` est cohérent après ses deux fixes documentés. Aucun REPLAN n'est requis. + +La tranche suivante peut être `0.0.1-alpha.2`, consacrée aux règles communes de versioning et de lifecycle.