3.3 KiB
Delta 0.3.3-pre.012-fix.001 — conformité des rôles documentaires
1. Base requise
Base directe attendue :
0.3.3-pre.012
workspace.package.version = 0.3.3-pre.12
Le gate opérateur de pre.012 du 30 août 2026 est entièrement propre.
2. Motif du correctif
La réconciliation pre.012 avait laissé dans les guides USAGE.md des éléments qui appartiennent à d'autres familles documentaires :
chronologie 0.3.3-pre.*
preuve de gate/live
statut de validation
renvois à une release future
Ce contenu viole le rôle déjà défini par KSP-REL-013 et docs/rules/FILE_CONTRACTS.md : un USAGE.md doit être durable, sans notes de version et centré sur l'utilisation concrète de la surface publique.
Le README PostgreSQL contenait également une chronologie de prerelease et un récit de preuve live qui appartiennent à docs/validation et aux deltas.
3. Correction
Les deux USAGE.md Store sont réécrits comme guides pratiques :
- dépendance et préconditions ;
- construction/résolution des settings ;
- ouverture, health et fermeture ;
- lecture
RawTransaction; - pagination keyset ;
- acquisition canonique atomique ;
- lecture/écriture d'observations ;
- lecture et transition de rétention ;
- classification sûre des erreurs ;
- limites de responsabilité.
Les exemples utilisent la surface publique actuelle et évitent toute chronologie de release.
Les deux README restent descriptifs : responsabilité, frontières, architecture runtime, surface courante et hors périmètre. Les preuves et résultats de gate restent dans la validation et les deltas.
4. Règles
Aucune nouvelle règle n'est ajoutée : les contrats canoniques existaient déjà.
KSP-REL-013
DOC-CRATE-002
DOC-CRATE-004
docs/rules/FILE_CONTRACTS.md — Documentation durable des crates et applications
Le correctif remet les documents en conformité avec ces règles au lieu de dupliquer la norme.
5. Version Cargo
0.3.3-pre.12
-> 0.3.3-pre.12.fix.1
6. Invariants techniques
Aucun changement n'est apporté à :
src/**
tests/**
config/**
docs/architecture/**
docs/rules/**
migrations/**
Cargo.toml de crate
dépendances/features
Les migrations V000/V001 et leurs checksums restent inchangés.
7. Fichiers ajoutés
deltas/0.3.3/pre.012-fix.001.md
8. Fichiers modifiés
Cargo.toml
crates/ksp-store-lib/README.md
crates/ksp-store-lib/USAGE.md
crates/ksp-store-postgres-lib/README.md
crates/ksp-store-postgres-lib/USAGE.md
docs/plans/024-V0_3_3_STORE_POSTGRES_RAW_TRANSACTION_PLAN.md
docs/validation/020-V0_3_3_STORE_POSTGRES_RAW_TRANSACTION.md
9. Fichiers supprimés
Aucun.
10. Gate attendu
cargo fmt --all
python3 scripts/audit_rust_workspace_rules.py
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas/0.3.3
cargo check --workspace
cargo clippy --workspace --all-targets
cargo test -p ksp-store-api
cargo test -p ksp-store-lib
cargo test -p ksp-store-postgres-lib
cargo test -p ksp-config-lib
cargo check -p ksp-store-lib --no-default-features
Aucun replay PostgreSQL n'est nécessaire : le correctif ne modifie ni code, ni test, ni SQL, ni migration.