0.0.1-alpha.1.fix.2

This commit is contained in:
2026-09-23 07:41:36 +02:00
parent 1e1cacb95b
commit 15fa124184
4 changed files with 181 additions and 17 deletions

View File

@@ -1 +1 @@
0.0.1-alpha.1.fix.1 0.0.1-alpha.1.fix.2

View File

@@ -0,0 +1,80 @@
<!-- file: deltas/0.0.1/alpha.1.fix.2.md -->
<!-- version: 1 -->
# 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.

View File

@@ -1,54 +1,72 @@
<!-- file: docs/validation/001-VALIDATION_MATRIX.md --> <!-- file: docs/validation/001-VALIDATION_MATRIX.md -->
<!-- version: 1 --> <!-- version: 2 -->
# Matrice de validation PGR # Matrice de validation PGR
## Rôle ## 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 ## Commandes initiales
| ID | Catégorie | Commande / contrôle | Trigger | Phase | | 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-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 | alpha.1/bootstrap | | `PGR-GIT-BOOTSTRAP-001` | CHECK | `git add .` puis `git diff --cached --check` | bootstrap ou fichiers entièrement nouveaux | bootstrap |
| `PGR-VERSION-001` | CHECK | `test "$(cat VERSION)" = "0.0.1-alpha.1"` | tranche `0.0.1-alpha.1` | alpha.1 | | `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-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-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 | | `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 ```bash
git status --short git status --short
test "$(cat VERSION)" = "0.0.1-alpha.1" test "$(cat VERSION)" = "<version attendue>"
find . -type f -not -path './.git/*' -print find . -type f -not -path './.git/*' -print
git add .
git diff --cached --check git diff --cached --check
git status --short git status --short
``` ```
L'opérateur vérifie également que : Le placeholder `<version attendue>` 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 ; - 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 ; - 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 ; - 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 ## 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. 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é.

View File

@@ -0,0 +1,66 @@
<!-- file: history/0.0.1/alpha.1.fix.2.md -->
<!-- version: 1 -->
# 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.