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 :

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 :

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 :

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 :

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 :

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.

6.5 KiB Raw Blame History