185 lines
6.5 KiB
Markdown
185 lines
6.5 KiB
Markdown
<!-- 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.
|