5.6 KiB
Delta 0.3.4-pre.012 — réconciliation documentaire finale Store/PostgreSQL RAW
1. Base requise
Base directe attendue :
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 :
workspace.package.version = 0.3.4-pre.12
Aucune autre propriété Cargo n'est modifiée.
4. Résultat technique hérité
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 :
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 :
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é
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
deltas/0.3.4/pre.012.md
10. 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/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.
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 :
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
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 :
0.3.4-pre.013 — préparation publication minimale + prompt 0.3.5
0.3.4-rel.001 — stabilisation/tag v0.3.4