Files
khadhroony-solana-project/deltas/0.3.3/rel.001.md
2026-08-30 18:26:36 +02:00

5.6 KiB

Delta 0.3.3-rel.001 — publication stable Store/PostgreSQL RawTransaction

1. Base requise

Base directe attendue :

0.3.3-pre.013
workspace.package.version = 0.3.3-pre.13

Commit attendu pour cette livraison :

v0.3.3-rel.001

Tag stable attendu après validation :

v0.3.3

2. Responsabilité de rel.001

Cette livraison effectue uniquement la mécanique de publication stable définie par VER-LIFECYCLE-012.

Elle :

  • passe workspace.package.version de 0.3.3-pre.13 à 0.3.3 ;
  • ajoute le présent delta rel.001 ;
  • ne corrige ni code, ni test, ni manifest de crate, ni Config, ni migration, ni README/USAGE, ni plan/validation, ni architecture/règle, ni prompt, ni CHANGELOG.md, ni ROADMAP.md.

Tout défaut appartenant à un couloir antérieur doit renvoyer vers une prerelease appropriée ; rel.001 n'est jamais une tranche de rattrapage.

3. Preuves acquises avant publication

Le gate technique final 0.3.3-pre.011, exécuté le 30 août 2026, a validé le workspace complet, les graphes Cargo et le replay PostgreSQL réel.

Il a notamment validé :

cargo fmt --all                                      PASS
python3 scripts/audit_rust_workspace_rules.py        PASS
python3 scripts/audit_markdown_tables.py             PASS
cargo check --workspace                              PASS
cargo clippy --workspace --all-targets               PASS
cargo test --workspace                               PASS
cargo test -p ksp-store-lib --no-default-features    PASS
cargo check -p ksp-store-lib --no-default-features   PASS
cargo tree -p ksp-store-lib --edges normal           inspecté
cargo tree -p ksp-store-lib -e features              inspecté
cargo tree -p ksp-store-postgres-lib --edges normal  inspecté
cargo tree --duplicates                              inspecté

Le même gate a rejoué la vertical slice RawTransaction sur PostgreSQL major 17 :

postgres_raw_transaction_live                        PASS
bootstrap V000 + V001                                PASS
binding réseau                                       PASS
schema_autoupdate repair                             PASS
canonical + observation atomiques                    PASS
idempotence / conflit                                PASS
concurrence identique / divergente                   PASS
pagination ASC / DESC et cursor replay               PASS
Full -> Archived -> Purged                           PASS
ForceRehydrate                                       PASS
races de rétention                                   PASS
rollback sur cancellation                            PASS
réouverture finale                                   PASS
cleanup                                              PASS

La réconciliation documentaire 0.3.3-pre.012-fix.001 puis la préparation de publication 0.3.3-pre.013 ont ensuite été validées par le gate ciblé sans modifier le comportement runtime ni les migrations.

Le checkpoint opérateur final de 0.3.3-pre.013, exécuté le 30 août 2026, est vert :

General Rust rule audit                              clean
Rust export completeness audit                       0 candidate(s)
KSP workspace Rust rule audit                        clean
Markdown table audit                                 clean — 214 tables / 158 files
cargo check --workspace                              PASS
cargo clippy --workspace --all-targets               PASS
cargo test -p ksp-store-api                          PASS
cargo test -p ksp-store-lib                          PASS
cargo test -p ksp-store-postgres-lib                 PASS
cargo test -p ksp-config-lib                         PASS
cargo check -p ksp-store-lib --no-default-features   PASS

4. Surface stable publiée

0.3.3 publie la vertical slice PostgreSQL complète de RawTransaction :

  • six capabilities RawTransaction* implémentées par PostgresBackend et dispatchées par Store ;
  • canonical transaction et acquisition observation atomiques ;
  • idempotence exacte et conflits divergents explicites ;
  • pagination keyset déterministe avec cursor opaque lié au réseau, à la direction et à la plage ;
  • rétention physique Full, Archived, Purged, tombstone et ForceRehydrate ;
  • Compacted explicitement unsupported tant qu'aucune représentation physique réelle n'existe ;
  • schéma PostgreSQL V001 mono-réseau, compatible u64 exact via NUMERIC(20,0) ;
  • vérification/introspection de schéma, réparations additives contrôlées et historique de migration immuable ;
  • erreurs backend/façade bornées et sans fuite d'URI, SQL, payload ou texte serveur.

Restent hors scope de cette release :

  • implémentation physique RawAccountState ;
  • STRUCTURAL/N2 et décodage Program ;
  • Interface events partagés ;
  • jobs/workers/backfills ;
  • politiques worker de batching, priorité, scheduling et rétention ;
  • application d'inspection Store.

5. Invariants de migration

Les migrations publiées restent celles validées avant rel.001 :

V000 d29068b8c13b9dc0cc9ef6aaadd0fa12d41e0fe4c56541a1118c4bfc846a1450
V001 31488cda2f08f3f46c4cdbdbb6c18c243662fada02eac4487040c8735d72cc51

rel.001 ne modifie aucun SQL ni checksum de migration.

6. Version stable et suite

La version Cargo publiée devient :

workspace.package.version = 0.3.3

Après validation de cette lane mécanique :

commit : v0.3.3-rel.001
tag    : v0.3.3

La session suivante repart de la base stable v0.3.3 et exécute :

prompts/023-V0_3_4_START_PROMPT.md

pour ouvrir 0.3.4 — Store/PostgreSQL RawAccountState + complétude/conformance RAW.