0.0.3-alpha.1.fix.1

deltas/0.0.3/alpha.1.fix.1.md

@@ -0,0 +1,184 @@
+<!-- file: deltas/0.0.3/alpha.1.fix.1.md -->
+<!-- version: 1 -->
+
+# Delta 0.0.3-alpha.1.fix.1 — cycle documentaire et horizon
+
+## Baseline requise
+
+Partir de `0.0.3-alpha.1` après application et commit/push de son history `PARTIAL`.
+
+La version devient :
+
+```text
+0.0.3-alpha.1.fix.1
+```
+
+## Objet
+
+Corriger le cadrage documentaire signalé par l'opérateur sans modifier la mission Git ni le code produit :
+
+- retirer l'entrée `0.0.3 (candidate)` écrite trop tôt dans `CHANGELOG.md` ;
+- codifier que le changelog de release est préparé vers la stabilisation à partir des changements réellement acquis ;
+- conserver `prompts/003-V0_0_3_START_PROMPT.md` comme rattrapage valide, mais codifier que le prompt de `N+1` est normalement produit pendant les dernières phases de `N` après revue d'horizon ;
+- transformer `ROADMAP.md` en vue de la release courante plus un horizon prévisionnel borné et explicitement révisable ;
+- établir l'horizon actuel `0.0.4` à `0.0.7` sans les considérer comme des missions engagées ;
+- mettre à jour le plan `0.0.3` afin que `beta.1` réévalue cet horizon et prépare le prochain prompt avant la stable si la mission suivante est suffisamment définie.
+
+Aucun fichier sous `crates/` ou `Web/` n'est modifié.
+
+## Horizon introduit
+
+L'horizon actuel est :
+
+```text
+0.0.4  PostgreSQL partagé et migrations
+0.0.5  contenu structuré et lecture publique
+0.0.6  identité / autorisation / administration locale
+0.0.7  propositions / revue / publication
+```
+
+Le statut `(h)` signifie horizon prévisionnel : numéro, ordre et scope peuvent être révisés lors des revues d'horizon ultérieures. Seule `0.0.3` est engagée aujourd'hui.
+
+## Scope des fichiers
+
+REPLACE :
+
+```text
+VERSION
+Cargo.toml
+CHANGELOG.md
+ROADMAP.md
+docs/rules/210-WORKFLOW.md
+docs/rules/300-DOCUMENTATION.md
+docs/templates/001-NEW_SESSION_PROMPT.md
+docs/templates/002-RELEASE_PLAN.md
+docs/plans/003-V0_0_3_GIT_WRITE_PLAN.md
+```
+
+ADD :
+
+```text
+deltas/0.0.3/alpha.1.fix.1.md
+```
+
+DELETE : aucun.
+
+`prompts/003-V0_0_3_START_PROMPT.md` reste inchangé : il constitue le rattrapage nécessaire à l'ouverture de `0.0.3`.
+
+Aucun history `alpha.1.fix.1` n'est inclus dans ce delta.
+
+## Gate opérateur
+
+Exécuter depuis la racine du dépôt après application du delta :
+
+```bash
+test "$(cat VERSION)" = '0.0.3-alpha.1.fix.1'
+grep -F 'version = "0.0.3-alpha.1.fix.1"' Cargo.toml
+
+git diff --check
+
+python3 -B scripts/audit_markdown_headers.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts deltas history
+python3 -B scripts/audit_markdown_links.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts deltas history
+python3 -B scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts deltas history
+
+cargo fmt --all
+cargo fmt --all -- --check
+
+python3 -B scripts/audit_rust_test_layout.py crates
+python3 -B scripts/audit_rust_blank_lines.py crates
+python3 -B scripts/audit_rust_item_spacing.py crates
+python3 -B scripts/audit_rust_module_order.py crates
+python3 -B scripts/audit_rust_trait_import_blocks.py crates
+python3 -B scripts/audit_rust_reexport_blocks.py crates
+python3 -B scripts/audit_rust_crate_root_facades.py crates
+python3 -B scripts/audit_rust_export_completeness.py --root . --summary-only
+
+cargo metadata --format-version 1 --no-deps > /tmp/sasedev-knowledge-0.0.3-alpha.1.fix.1-metadata.json
+cargo check --workspace
+cargo clippy --workspace --all-targets --all-features -- -D warnings
+cargo test -p knowledge-git-lib --test git_read_path
+cargo test --workspace --all-targets --all-features
+
+python3 - <<'PYGATE'
+from pathlib import Path
+
+changelog = Path('CHANGELOG.md').read_text(encoding='utf-8')
+assert '## 0.0.3' not in changelog
+assert '## 0.0.2' in changelog
+
+roadmap = Path('ROADMAP.md').read_text(encoding='utf-8')
+assert '- `( ) 0.0.3`' in roadmap
+for version in ('0.0.4', '0.0.5', '0.0.6', '0.0.7'):
+    assert f'- `(h) {version}`' in roadmap, version
+assert 'horizon prévisionnel' in roadmap
+
+workflow = Path('docs/rules/210-WORKFLOW.md').read_text(encoding='utf-8')
+assert 'pendant les dernières phases de `N`' in workflow
+assert 'rattrapage et non le cycle normal' in workflow
+
+documentation = Path('docs/rules/300-DOCUMENTATION.md').read_text(encoding='utf-8')
+assert "Il n'est normalement pas rédigé au démarrage" in documentation
+assert 'au moins les deux releases d\'horizon qui la suivent' in documentation
+
+prompt_template = Path('docs/templates/001-NEW_SESSION_PROMPT.md').read_text(encoding='utf-8')
+assert 'pendant les dernières phases de la release `N`' in prompt_template
+assert 'MUST NOT inventer ces valeurs' in prompt_template
+
+assert Path('prompts/003-V0_0_3_START_PROMPT.md').is_file()
+assert not Path('history/0.0.3/alpha.1.fix.1.md').exists()
+assert not Path('crates/knowledge-forge-gitea-lib').exists()
+assert not Path('crates/knowledge-store-postgres-lib').exists()
+assert not Path('migrations').exists()
+
+print('Knowledge 0.0.3-alpha.1.fix.1 documentation lifecycle audit: clean')
+PYGATE
+
+python3 - <<'PYTEXT'
+from pathlib import Path
+
+roots = [Path('README.md'), Path('RULES.md'), Path('ROADMAP.md'), Path('CHANGELOG.md'), Path('docs'), Path('prompts'), Path('deltas'), Path('history')]
+paths = []
+for root in roots:
+    if root.is_file():
+        paths.append(root)
+    elif root.is_dir():
+        paths.extend(path for path in root.rglob('*') if path.is_file())
+for path in paths:
+    data = path.read_bytes()
+    assert b'\r' not in data, path
+    assert data.endswith(b'\n'), path
+    assert not data.endswith(b'\n\n'), path
+    text = data.decode('utf-8')
+    for number, line in enumerate(text.splitlines(), start=1):
+        assert line == line.rstrip(' \t'), (path, number)
+print(f'Knowledge 0.0.3-alpha.1.fix.1 text hygiene: clean ({len(paths)} file(s))')
+PYTEXT
+
+test -z "$(git diff --name-only -- crates Web)"
+test ! -e history/0.0.3/alpha.1.fix.1.md
+
+test -f Cargo.lock
+git check-ignore -q Cargo.lock
+if git ls-files --error-unmatch Cargo.lock >/dev/null 2>&1; then
+    echo 'Cargo.lock must remain untracked for Knowledge' >&2
+    exit 1
+fi
+
+test -f Web/knowledge-template-lab/package-lock.json
+
+git add -A
+git diff --cached --check
+git status --short
+```
+
+La gate ne rejoue pas npm/Vite/HTTP : aucun fichier Web ni contrat runtime n'est modifié.
+
+## Transition
+
+### PASS
+
+Produire `history/0.0.3/alpha.1.fix.1.md`, l'appliquer, commit/push `0.0.3-alpha.1.fix.1`, puis préparer `0.0.3-alpha.2`.
+
+### FAIL / PARTIAL / BLOCKED
+
+Conserver le résultat réel dans son history avant toute correction. Une correction bornée utilise `alpha.1.fix.2`; un problème qui invalide la trajectoire appelle un REPLAN.