# Delta `0.3.4-pre.012` — réconciliation documentaire finale Store/PostgreSQL RAW ## 1. Base requise Base directe attendue : ```text 0.3.4-pre.011 ``` Le couloir technique est fermé. Le replay de `pre.011` confirme les tests façade sans backend, le workspace complet, les graphes Cargo et le live `RawAccountState` sur PostgreSQL 17. ## 2. Objectif Réconcilier exclusivement les documents durables avec la surface Store/PostgreSQL effectivement validée. Cette tranche ne rouvre aucun comportement Rust, test fonctionnel, Config, schema, migration, dépendance ou feature et ne prépare pas encore la publication. ## 3. Version Conformément à `VER-ID-009`, cette prerelease non-fix synchronise : ```text workspace.package.version = 0.3.4-pre.12 ``` Aucune autre propriété Cargo n'est modifiée. ## 4. Résultat technique hérité ```text Store/Postgres RAW capabilities 10/10 RawTransaction capabilities 6 RawAccount capabilities 4 ksp-store-lib --no-default-features PASS cargo test --workspace PASS Cargo graphs façade/backend/features/duplicates exécutés postgres_raw_account_live PASS — PostgreSQL 17 V002 resources 32 V002 checksum ff21605ed45f7ab4c0f92bbb692700b4118a9488b04d50a31d259ac59bdb550e ``` Les doublons Cargo du workspace sont transverses et ne révèlent aucune duplication propre au Store nécessitant une correction. ## 5. Réconciliation `ksp-store-lib` Le README et le USAGE décrivent désormais durablement : ```text exactement 10 capabilities RAW 6 RawTransaction* + 4 RawAccount* lecture RawAccountState par référence pagination keyset (slot,pubkey,state_hash), filtre pubkey optionnel acquisition account atomique et idempotence exacte lecture/ajout d'observation account cursors opaques family-local aucune rétention/archive/purge/delete/compaction account aucune policy batch/priorité/scheduling dans Store ``` Les anciennes affirmations indiquant que les capabilities `RawAccount*` n'étaient pas dispatchées sont supprimées. ## 6. Réconciliation `ksp-store-postgres-lib` Le README et le USAGE décrivent désormais : ```text V001 = schéma RawTransaction V002 = schéma RawAccountState lectures state/observation account acquisition state+observation atomique observation supplémentaire reference-guarded pagination keyset account et cursor KSPA aucun ON CONFLICT DO UPDATE aucune FK account transaction_signature -> RawTransaction aucune rétention destructive account ``` La crate reste un backend physique derrière `ksp-store-lib`, jamais une seconde façade applicative. ## 7. Documents de release Le plan `025` enregistre le PASS technique de `pre.011`, synchronise la version de travail sur `pre.012` et marque la réconciliation documentaire comme matérialisée. La validation `021` ferme le verdict `pre.011` et ouvre le verdict documentaire `pre.012`. `README.md` racine et les architectures Store ont été relus ; aucune affirmation devenue fausse n'y justifie une modification artificielle. `ksp-store-api` n'acquiert pas un README/USAGE uniquement pour cette tranche. ## 8. Hors scope préservé ```text CHANGELOG.md ROADMAP.md prompt 0.3.5 src/** tests/** config/** migrations/** account retention/archive/purge/delete/compaction workers/jobs/backfills batch/priorité/backlog policy nouveau backend Store Desk ``` La préparation minimale `CHANGELOG`/`ROADMAP`/prompt reste réservée à `pre.013`. ## 9. Fichiers ajoutés ```text deltas/0.3.4/pre.012.md ``` ## 10. 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/025-V0_3_4_STORE_POSTGRES_RAW_ACCOUNT_PLAN.md docs/validation/021-V0_3_4_STORE_POSTGRES_RAW_ACCOUNT.md ``` ## 11. Fichiers supprimés Aucun. ## 12. Migrations Aucune migration n'est modifiée. ```text V000 d29068b8c13b9dc0cc9ef6aaadd0fa12d41e0fe4c56541a1118c4bfc846a1450 V001 31488cda2f08f3f46c4cdbdbb6c18c243662fada02eac4487040c8735d72cc51 V002 ff21605ed45f7ab4c0f92bbb692700b4118a9488b04d50a31d259ac59bdb550e ``` ## 13. Validations de génération Les validations statiques applicables ont été rejouées après matérialisation de l'overlay : ```text General Rust rule audit: clean Rust export completeness audit: 0 candidate(s) KSP workspace Rust rule audit: clean Markdown table audit: clean (240 table(s), 151 file(s)) protected src/tests/config/migrations byte-identical à pre.011: PASS ``` Les exécutables Cargo/Rust ne sont pas disponibles dans l'environnement de génération ; aucun résultat Cargo post-overlay n'est revendiqué ici. ## 14. Gate opérateur après application ```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.4 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 nouveau live PostgreSQL, `cargo test --workspace` ou graphe Cargo n'est requis par cette tranche documentaire ; ces preuves sont déjà fermées par `pre.011`. ## 15. Questions ouvertes Aucune pour le périmètre `0.3.4`. ## 16. Suite Après gate documentaire vert : ```text 0.3.4-pre.013 — préparation publication minimale + prompt 0.3.5 0.3.4-rel.001 — stabilisation/tag v0.3.4 ```