116 lines
5.0 KiB
Markdown
116 lines
5.0 KiB
Markdown
<!-- file: deltas/0.0.3/beta.1.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# Delta 0.0.3-beta.1 — réconciliation documentaire
|
|
|
|
## Baseline et version
|
|
|
|
Baseline : `0.0.3-alpha.6`, avec `history/0.0.3/alpha.6.md` appliqué et committé. Ce delta MUST NOT être appliqué avant ce commit.
|
|
|
|
Version avant application :
|
|
|
|
```text
|
|
0.0.3-alpha.6
|
|
```
|
|
|
|
Version après application :
|
|
|
|
```text
|
|
0.0.3-beta.1
|
|
```
|
|
|
|
## Objet et résultat de la revue
|
|
|
|
Réconcilier la navigation, les propriétaires et les contrôles après les six tranches alpha et le fix documentaire. Les sept deltas `alpha.1` à `alpha.6`, fix inclus, ont chacun un history `PASS` fourni par la gate opérateur ; leur chaîne de versions est continue depuis `0.0.2`. La règle `210` possède le workflow ; la règle `300` possède les headers Markdown ; le profil `510` possède les conventions Rust facultatives. Les documents `docs/templates/` expliquent comment adapter les cinq fichiers Rust/Cargo et le message de reprise, tandis que les scripts restent de petits contrôles de propriétés délimitées.
|
|
|
|
La revue relève quatre corrections de documents vivants : exposer le plan actif depuis `README.md`, ouvrir la navigation directe depuis `docs/000-README.md` et décrire son template de workflow, actualiser dans le plan l'audit des headers déjà livré, et rendre dans la matrice l'audit des liens applicable à une tranche alpha qui modifie la navigation. La réconciliation n'ajoute aucune famille normative, audit, règle de version universelle, dépendance de build ou prompt `0.0.4`. Les versions et seuils du modèle Cargo restent des exemples ou choix adaptables, et les snapshots antérieurs restent intacts.
|
|
|
|
## Scope
|
|
|
|
REPLACE :
|
|
|
|
```text
|
|
VERSION
|
|
README.md
|
|
docs/000-README.md
|
|
docs/plans/003-V0_0_3_TEMPLATES_AUDITS_PLAN.md
|
|
docs/validation/001-VALIDATION_MATRIX.md
|
|
```
|
|
|
|
ADD :
|
|
|
|
```text
|
|
deltas/0.0.3/beta.1.md
|
|
```
|
|
|
|
DELETE : aucun.
|
|
|
|
L'archive contient exactement ces fichiers complets. Le history de `alpha.6` est livré séparément, celui de `beta.1` n'existe pas encore ; `CHANGELOG.md`, les règles, templates techniques, scripts, tests et prompts ne sont pas modifiés.
|
|
|
|
## Validation opérateur
|
|
|
|
Après application de `history/0.0.3/alpha.6.md` et son commit, appliquer ce delta puis exécuter à la racine :
|
|
|
|
```bash
|
|
test "$(cat VERSION)" = '0.0.3-beta.1'
|
|
git cat-file -e HEAD:history/0.0.3/alpha.6.md
|
|
test -f history/0.0.3/alpha.6.md
|
|
test -f deltas/0.0.3/beta.1.md
|
|
test ! -e history/0.0.3/beta.1.md
|
|
test ! -e prompts/004-V0_0_4_START_PROMPT.md
|
|
|
|
grep -Fx '<!-- version: 5 -->' README.md
|
|
grep -Fx '<!-- version: 3 -->' docs/000-README.md
|
|
grep -Fx '<!-- version: 7 -->' docs/plans/003-V0_0_3_TEMPLATES_AUDITS_PLAN.md
|
|
grep -Fx '<!-- version: 9 -->' docs/validation/001-VALIDATION_MATRIX.md
|
|
|
|
python3 -B -m unittest discover -s tests -p 'test_*.py' -v
|
|
python3 -B scripts/audit_markdown_headers.py \
|
|
README.md RULES.md ROADMAP.md CHANGELOG.md docs deltas history prompts
|
|
python3 -B scripts/audit_markdown_tables.py \
|
|
README.md RULES.md ROADMAP.md CHANGELOG.md docs deltas history prompts
|
|
python3 -B scripts/audit_markdown_links.py \
|
|
README.md RULES.md ROADMAP.md CHANGELOG.md docs deltas history prompts
|
|
|
|
python3 -B - <<'PY'
|
|
from pathlib import Path
|
|
import re
|
|
import tomllib
|
|
|
|
tranches = ['alpha.1', 'alpha.1.fix.1', 'alpha.2', 'alpha.3',
|
|
'alpha.4', 'alpha.5', 'alpha.6']
|
|
version = '0.0.2'
|
|
for name in tranches:
|
|
delta = Path(f'deltas/0.0.3/{name}.md').read_text(encoding='utf-8')
|
|
history = Path(f'history/0.0.3/{name}.md').read_text(encoding='utf-8')
|
|
assert re.search(r'## Statut\s+PASS\s', history), name
|
|
assert f'Version avant application : `{version}`.' in delta or \
|
|
f'Version avant application :\n\n```text\n{version}\n```' in delta, name
|
|
version = f'0.0.3-{name}'
|
|
assert f'Version après application : `{version}`.' in delta or \
|
|
f'Version après application :\n\n```text\n{version}\n```' in delta, name
|
|
for path in sorted(Path('templates/rust-cargo').rglob('*.toml')):
|
|
tomllib.loads(path.read_text(encoding='utf-8'))
|
|
print(f'Reconciliation audit: clean ({len(tranches)} PASS histories, 5 TOML files)')
|
|
PY
|
|
|
|
git diff --check
|
|
git add VERSION README.md docs/000-README.md \
|
|
docs/plans/003-V0_0_3_TEMPLATES_AUDITS_PLAN.md \
|
|
docs/validation/001-VALIDATION_MATRIX.md deltas/0.0.3/beta.1.md
|
|
git diff --cached --check
|
|
git status --short
|
|
```
|
|
|
|
Scope attendu avant ajout du history : cinq `REPLACE` et un `ADD` exactement comme ci-dessus. Revue opérateur : confirmer que les liens pointent vers les documents propriétaires et que les valeurs du template Cargo restent des exemples adaptables ; les gates alpha déjà observées ne sont pas réinterprétées et la RC n'est pas déclarée acquise par cette prévalidation.
|
|
|
|
## Transition
|
|
|
|
### PASS
|
|
|
|
Produire séparément `history/0.0.3/beta.1.md` avec les résultats réellement observés, l'appliquer et committer `beta.1` avant de préparer `rc.1`.
|
|
|
|
### FAIL
|
|
|
|
Enregistrer le diagnostic dans le history de `beta.1`, puis corriger la réconciliation dans `beta.1.fix.1` ou faire un REPLAN explicite si le scope a changé.
|