# Delta `0.3.3-pre.012-fix.001` — conformité des rôles documentaires ## 1. Base requise Base directe attendue : ```text 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 : ```text 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à. ```text 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 ```text 0.3.3-pre.12 -> 0.3.3-pre.12.fix.1 ``` ## 6. Invariants techniques Aucun changement n'est apporté à : ```text 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 ```text deltas/0.3.3/pre.012-fix.001.md ``` ## 8. Fichiers modifiés ```text 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 ```bash 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.