Files
sasedev-knowledge/deltas/0.0.2/beta.1.md
2026-09-29 06:10:29 +02:00

5.8 KiB

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 :

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 :

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

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.