0.0.2-beta.1

deltas/0.0.2/beta.1.md

@@ -0,0 +1,168 @@
+<!-- file: deltas/0.0.2/beta.1.md -->
+<!-- version: 1 -->
+
+# Delta 0.0.2-beta.1 — réconciliation Git/synchronisation et revue d'horizon
+
+## Base requise
+
+État `0.0.2-alpha.5` committé et poussé après application de son history `PASS`.
+
+La version devient :
+
+```text
+0.0.2-beta.1
+```
+
+## Nature de la tranche
+
+`beta.1` est une tranche de stabilisation et de réconciliation. Elle n'ajoute aucune grande fonctionnalité, aucune crate, aucune dépendance, aucune route et aucun comportement Git.
+
+Elle réconcilie :
+
+- les neuf packages réellement matérialisés ;
+- les contrats Git/synchronisation réellement obtenus ;
+- les `DEFER` et hors-scope ;
+- les références historiques ambiguës aux alphas `0.0.1` ;
+- le changelog candidat ;
+- la revue d'horizon.
+
+L'étude durable est :
+
+```text
+docs/studies/005-V0_0_2_GIT_SYNC_RECONCILIATION.md
+```
+
+## Revue d'horizon
+
+Aucune release postérieure à `0.0.2` n'est engagée ni numérotée. Les domaines futurs restent non numérotés jusqu'à décision d'une mission explicite. Aucun prompt `0.0.3` n'est créé.
+
+## Gate opérateur
+
+```bash
+test "$(cat VERSION)" = '0.0.2-beta.1'
+grep -F 'version = "0.0.2-beta.1"' Cargo.toml
+grep -A2 '^## Statut$' history/0.0.2/alpha.5.md | grep -Fx 'PASS'
+
+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.2-beta.1-metadata.json
+cargo check --workspace
+cargo clippy --workspace --all-targets --all-features -- -D warnings
+cargo test --workspace --all-targets --all-features
+
+(
+  cd Web/knowledge-template-lab
+  npm ci
+  npm run typecheck
+  npm run build
+)
+
+python3 - <<'PYGATE'
+import json
+from pathlib import Path
+
+metadata = json.loads(Path('/tmp/sasedev-knowledge-0.0.2-beta.1-metadata.json').read_text(encoding='utf-8'))
+expected = {
+    'knowledge-app-lib',
+    'knowledge-domain-lib',
+    'knowledge-git-api',
+    'knowledge-git-lib',
+    'knowledge-sync-api',
+    'knowledge-web-lib',
+    'knowledge-pgr-server',
+    'knowledge-howtos-server',
+    'knowledge-snippets-server',
+}
+assert {package['name'] for package in metadata['packages']} == expected
+assert len(metadata['workspace_members']) == 9
+
+study = Path('docs/studies/005-V0_0_2_GIT_SYNC_RECONCILIATION.md').read_text(encoding='utf-8')
+for phrase in (
+    'knowledge-git-lib          backend process Git contrôlé',
+    'knowledge-app-lib          cas d\'usage partagé Changed / Unchanged',
+    'DEFER confirmés',
+    'Aucun prompt `0.0.3` n\'est créé',
+):
+    assert phrase in study, phrase
+
+roadmap = Path('ROADMAP.md').read_text(encoding='utf-8')
+assert 'aucune release postérieure à `0.0.2` n\'est engagée ni numérotée' in roadmap
+assert '0.0.3' not in roadmap
+
+changelog = Path('CHANGELOG.md').read_text(encoding='utf-8')
+assert '## 0.0.2 (candidate)' in changelog
+for forbidden in ('alpha.1.fix', 'alpha.2.fix', 'alpha.3.fix', 'alpha.4.fix'):
+    assert forbidden not in changelog, forbidden
+
+architecture = Path('docs/architecture/002-KNOWLEDGE_ARCHITECTURE.md').read_text(encoding='utf-8')
+assert '`0.0.1-alpha.4` possède le frontend indépendant' in architecture
+assert '`0.0.1-alpha.5` matérialise `knowledge-web-lib`' in architecture
+assert '## Réconciliation `0.0.2-beta.1`' in architecture
+
+manifest_path = Path('../builds/sasedev-knowledge/web/template-lab/.vite/manifest.json')
+assert manifest_path.is_file(), manifest_path
+manifest = json.loads(manifest_path.read_text(encoding='utf-8'))
+assert 'src/main.ts' in manifest, manifest.keys()
+
+assert not Path('prompts/003-V0_0_3_START_PROMPT.md').exists()
+assert not Path('history/0.0.2/beta.1.md').exists()
+print('Knowledge 0.0.2-beta.1 reconciliation/horizon 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
+    text = data.decode('utf-8')
+    for number, line in enumerate(text.splitlines(), start=1):
+        assert line == line.rstrip(' \t'), (path, number)
+print(f'Knowledge beta.1 text hygiene: clean ({len(paths)} file(s))')
+PYTEXT
+
+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 -z "$(git diff --name-only -- crates Web)"
+test ! -e crates/knowledge-forge-gitea-lib
+test ! -e crates/knowledge-store-postgres-lib
+
+git add -A
+git diff --cached --check
+git status --short
+```
+
+Les warnings de dépendances frontend déjà connus ne constituent pas à eux seuls un `FAIL` si les commandes npm/Vite terminent avec succès.
+
+## Transition
+
+Un `PASS` autorise uniquement `0.0.2-rc.1`. Un échec requis produit un history factuel et un `beta.1.fix.N` ou un REPLAN selon la nature du défaut.