Sasedev/sasedev-knowledge
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
master
sasedev-knowledge/deltas/0.0.3/alpha.1.md
SinuS Von SifriduS a74a19838f 0.0.3-alpha.1
2026-09-29 09:58:22 +02:00

9.5 KiB
Raw Permalink Blame History

Delta 0.0.3-alpha.1 — cadrage de l'écriture Git contrôlée

Baseline requise

Partir de la stable autoritaire :

tag Knowledge          v0.0.2
commit Knowledge       183d354a67bec6d2d512c4898f5189759a6120b0
archive SHA-256        0e518c7eaad115811cccc8fb2b38a1e68150ec985c2ca72ec08a9ca5bbb202ce
publish report         sasedev-knowledge-0.0.2-publish.001-report.md = PASS

La stable 0.0.2 ne contenait volontairement aucun prompt 0.0.3, car sa revue d'horizon n'avait engagé aucune prochaine mission. La présente session a ouvert explicitement une nouvelle mission depuis cette baseline ; le prompt versionné correspondant est donc matérialisé par cette tranche :

prompts/003-V0_0_3_START_PROMPT.md

PGR v0.1.3 reste une provenance historique. Aucune version PGR ultérieure n'est consultée ou adoptée.

La version devient :

0.0.3-alpha.1

Objet

Fermer le cadrage de la prochaine release avant toute modification fonctionnelle :

  • vérifier la stable v0.0.2, ses règles/owners, architecture, deltas/histories et DEFER ;
  • sélectionner l'écriture Git générique contrôlée comme mission 0.0.3 ;
  • conserver le processus git contrôlé déjà validé en 0.0.2 ;
  • choisir un worktree d'écriture isolé pour créer une révision candidate ;
  • décider que le contrat d'écriture restera distinct du contrat GitRepository de lecture ;
  • borner la mise à jour distante aux branches refs/heads/... avec attente explicite sur leur état précédent ;
  • garder une divergence comme conflit récupérable sans rebase/merge automatique ;
  • établir l'étude, le plan, le prompt local et la gate de release.

Aucun code produit, aucune crate, aucune dépendance Cargo/npm et aucun fichier Web ne sont ajoutés ou modifiés dans cette tranche.

Décision d'horizon

La prochaine release engagée est :

0.0.3 — écriture Git contrôlée et push gardé

Les domaines PostgreSQL, proposition/revue, rendu/publication produit, recherche, Gitea, auth/admin et opérations restent non numérotés.

0.0.3 ne ferme pas le workflow de proposition complet. Elle fournit la primitive Git générique dont ce workflow aura besoin : base explicite, mutations confinées, commit candidat et mise à jour distante gardée.

Contrats retenus

L'étude :

docs/studies/006-V0_0_3_GIT_WRITE_STUDY.md

retient :

  • un worktree d'écriture isolé sous la racine d'état contrôlée ;
  • des mutations de fichiers par chemins relatifs validés ;
  • une identité auteur/committer explicite ;
  • hooks et prompts neutralisés ;
  • une nouvelle révision candidate avant tout push ;
  • un push de branche avec comparaison de l'état distant attendu ;
  • conflit explicite si la branche a divergé ;
  • aucun push --force non gardé ;
  • aucun rebase/merge automatique ;
  • aucune forge obligatoire.

Le plan actif est :

docs/plans/003-V0_0_3_GIT_WRITE_PLAN.md

avec trajectoire prévisionnelle alpha.1 à alpha.4, puis beta.1, rc.1 et rel.1.

Scope des fichiers

REPLACE :

VERSION
Cargo.toml
README.md
RULES.md
ROADMAP.md
CHANGELOG.md
docs/000-README.md
docs/architecture/001-PROJECT_PROFILE.md
docs/architecture/002-KNOWLEDGE_ARCHITECTURE.md
docs/validation/001-VALIDATION_MATRIX.md

ADD :

docs/studies/006-V0_0_3_GIT_WRITE_STUDY.md
docs/plans/003-V0_0_3_GIT_WRITE_PLAN.md
prompts/003-V0_0_3_START_PROMPT.md
deltas/0.0.3/alpha.1.md

DELETE : aucun.

Aucun fichier sous crates/ ou Web/ n'est modifié.

Aucun history 0.0.3-alpha.1 n'est inclus : il doit refléter la gate opérateur réelle.

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'
grep -F 'version = "0.0.3-alpha.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-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'
import json
from pathlib import Path

assert Path('docs/studies/006-V0_0_3_GIT_WRITE_STUDY.md').is_file()
assert Path('docs/plans/003-V0_0_3_GIT_WRITE_PLAN.md').is_file()
assert Path('prompts/003-V0_0_3_START_PROMPT.md').is_file()
assert Path('deltas/0.0.3/alpha.1.md').is_file()
assert not Path('history/0.0.3/alpha.1.md').exists()

roadmap = Path('ROADMAP.md').read_text(encoding='utf-8')
assert '- `( ) 0.0.3`' in roadmap
assert '0.0.4' not in roadmap

rules = Path('RULES.md').read_text(encoding='utf-8')
for phrase in (
    'Écriture Git contrôlée',
    'MUST viser une branche `refs/heads/...`',
    'MUST NOT effectuer un `push --force` non gardé',
):
    assert phrase in rules, phrase

study = Path('docs/studies/006-V0_0_3_GIT_WRITE_STUDY.md').read_text(encoding='utf-8')
for phrase in (
    'worktree d\'écriture isolé',
    'comparaison-et-échange',
    'aucun rebase ou merge automatique',
    'PGR `v0.1.3` reste une provenance historique',
):
    assert phrase in study, phrase

plan = Path('docs/plans/003-V0_0_3_GIT_WRITE_PLAN.md').read_text(encoding='utf-8')
headings = (
    '## Statut et sources',
    '## Mission',
    '## État acquis et questions ouvertes',
    '## Scope',
    '## Hors scope',
    '## Stratégie de validation',
    '## Trajectoire prévisionnelle',
    '## Déclencheurs de REPLAN',
    '## Clôture et transition',
    '## Revue d\'horizon',
)
positions = [plan.index(value) for value in headings]
assert positions == sorted(positions)
for tranche in ('alpha.1', 'alpha.2', 'alpha.3', 'alpha.4', 'beta.1', 'rc.1', 'rel.1'):
    assert f'### {tranche} —' in plan, tranche

prompt = Path('prompts/003-V0_0_3_START_PROMPT.md').read_text(encoding='utf-8')
assert 'Ne pas rechercher, charger ni adopter automatiquement une nouvelle version de PGR.' in prompt
assert '0e518c7eaad115811cccc8fb2b38a1e68150ec985c2ca72ec08a9ca5bbb202ce' in prompt

metadata = json.loads(Path('/tmp/sasedev-knowledge-0.0.3-alpha.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

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 framing 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 text hygiene: clean ({len(paths)} file(s))')
PYTEXT

test -z "$(git diff --name-only -- crates Web)"
test ! -e history/0.0.3/alpha.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 dans alpha.1 : aucun contrat Web ni fichier Web/ n'est modifié, et la stable 0.0.2 a déjà acquis une gate Web/runtime complète. Cette omission est conforme à la validation proportionnée locale.

Transition

PASS

Produire séparément :

history/0.0.3/alpha.1.md

avec les résultats réellement observés. Après application du history, commit/push 0.0.3-alpha.1, puis seulement préparer 0.0.3-alpha.2.

FAIL / PARTIAL / BLOCKED

Produire le history réel avec son statut, l'appliquer et le committer avant toute correction.

Une correction bornée à ce cadrage utilise :

0.0.3-alpha.1.fix.1

Si le diagnostic invalide la mission, l'ownership ou la stratégie d'écriture, exécuter un REPLAN plutôt que d'absorber une nouvelle responsabilité dans un fix.

Reference in New Issue View Git Blame Copy Permalink