186 lines
5.6 KiB
Markdown
186 lines
5.6 KiB
Markdown
<!-- file: deltas/0.3.4/pre.012.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# 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
|
|
```
|