khadhroony-solana-project/deltas/0.3.3/pre.012.md

Delta 0.3.3-pre.012 — réconciliation documentaire finale RawTransaction

1. Base requise

Base directe attendue :

0.3.3-pre.011
workspace.package.version = 0.3.3-pre.11

Le gate technique final pre.011 du 30 août 2026 est entièrement vert.

2. Résultat du gate technique pre.011

audits Rust / export / KSP                         PASS / clean
audit Markdown                                     PASS / clean — 214 tables / 154 fichiers
cargo check --workspace                            PASS
cargo clippy --workspace --all-targets             PASS
tests ciblés Store API / façade / PostgreSQL       PASS
ksp-config-lib                                     PASS — 128 unit + ownership/public API
ksp-store-lib --no-default-features test/check     PASS
cargo test --workspace                             PASS
graphes Cargo normal/features/duplicates           exécutés
PostgreSQL RawTransaction live                     PASS — major 17, 1 test
builds Tauri                                       N/A — aucune resource/package desktop modifiée

Le replay PostgreSQL final confirme de nouveau bootstrap V000/V001, drift/repair, atomicité, concurrence, rollback, pagination/cursor, rétention/races, ForceRehydrate et réouverture durable.

3. Objectif

Appliquer la réconciliation documentaire finale de 0.3.3 sans rouvrir la surface technique :

README/USAGE ksp-store-lib
README/USAGE ksp-store-postgres-lib
index docs global
index plans
index validations
plan 024
validation 020
CHANGELOG 0.3.3
ROADMAP 0.3.3

Aucun changement n'est apporté à src/**, tests, Config runtime, architectures, règles, manifests de crate, dépendances ou migrations.

4. Version Cargo

0.3.3-pre.11
-> 0.3.3-pre.12

5. Surface stable candidate enregistrée

La documentation durable fixe désormais :

PostgresBackend + Store implémentent les six RawTransaction*
1 base = 1 RawNetworkId via ksp_store_identity
slot u64 exact = NUMERIC(20,0)
V001 logique = ressources tables/constraints/indexes
canonical + acquisition observation atomiques
idempotence réelle / divergence = store_api.raw_conflict
observations séparées et provenance complète
get Full/Archived/Purged + tombstone séparé
list keyset (slot, signature), cursor V1 109 bytes, sans OFFSET
aucun cap métier Store de batch/page
Full -> Archived -> Purged atomique
ForceRehydrate explicite
Compacted unsupported honnête
erreurs physiques redacted et codes stables
PostgreSQL >= 15, preuve finale major 17
RawAccountState physique reporté à 0.3.4

6. Rétention et roadmap

ROADMAP.md distingue désormais deux faits :

• la mécanique physique RawTransaction PostgreSQL Full -> Archived -> Purged est acquise en 0.3.3 ;
• la policy d'éligibilité, la maintenance worker/job et une éventuelle vraie représentation Compacted restent futures.

Store applique une transition demandée ; il ne décide toujours pas seul qu'un RAW peut être archivé ou purgé.

7. Migrations

Aucune ressource SQL n'est modifiée.

V000 d29068b8c13b9dc0cc9ef6aaadd0fa12d41e0fe4c56541a1118c4bfc846a1450
V001 31488cda2f08f3f46c4cdbdbb6c18c243662fada02eac4487040c8735d72cc51

Les corrections pre.009-fix.001..006 ont porté sur le test live, la comparaison du catalogue et la classification du drift, jamais sur les bytes des migrations.

8. Documents relus et volontairement inchangés

Les architectures Store restent cohérentes et ne sont pas modifiées artificiellement :

docs/architecture/003-COMPONENT_CONTRACTS.md
docs/architecture/004-COMPONENT_INVENTORY.md
docs/architecture/005-DEPENDENCY_GRAPH.md
docs/architecture/008-DATA_MATERIALIZATION_AND_STORE.md
docs/architecture/009-ACQUISITION_WORKERS_AND_JOBS.md

ksp-config-lib README/USAGE restent également inchangés : 0.3.3 n'a modifié ni std.store, ni les targets, ni la propriété des secrets.

9. Fichiers ajoutés

deltas/0.3.3/pre.012.md

10. Fichiers modifiés

Cargo.toml
CHANGELOG.md
ROADMAP.md
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/000-README.md
docs/plans/000-README.md
docs/plans/024-V0_3_3_STORE_POSTGRES_RAW_TRANSACTION_PLAN.md
docs/validation/000-README.md
docs/validation/020-V0_3_3_STORE_POSTGRES_RAW_TRANSACTION.md

11. Fichiers supprimés

Aucun.

12. 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

Le replay PostgreSQL et cargo test --workspace n'ont pas besoin d'être répétés dans cette tranche purement documentaire : ils constituent la preuve technique finale acquise de pre.011.

13. Suite

Après gate documentaire propre :

0.3.3-pre.013 — préparation de publication + prompt 0.3.4
0.3.3-rel.001 — publication stable