v0.3.3-pre.013

CHANGELOG.md

@@ -1,5 +1,5 @@
 <!-- file: CHANGELOG.md -->
-<!-- version: 21 -->
+<!-- version: 22 -->
 
 # Changelog KSP
 
@@ -13,7 +13,7 @@ La rétention physique supportée est `Full -> Archived -> Purged`, sérialisée
 
 La preuve PostgreSQL réelle a conduit à durcir l'introspection de schéma PostgreSQL 17 : canonicalisation ciblée des CHECK numériques reconstruits par le catalogue, conservation des littéraux texte, restauration des helpers de classification de schéma et distinction d'un drift d'une migration déjà enregistrée lorsque `schema_autoupdate=false`. Les ressources SQL V000/V001 et leurs checksums sont restés inchangés pendant ces corrections (`V000 d29068b8c13b9dc0cc9ef6aaadd0fa12d41e0fe4c56541a1118c4bfc846a1450`, `V001 31488cda2f08f3f46c4cdbdbb6c18c243662fada02eac4487040c8735d72cc51`).
 
-Le gate technique final `pre.011` passe audits Rust/Markdown, `cargo check --workspace`, Clippy all-targets, les tests ciblés Store/API/PostgreSQL/Config, les tests et checks façade avec `--no-default-features`, `cargo test --workspace` et les graphes Cargo. Le live `postgres_raw_transaction_live` est ensuite rejoué avec succès sur **PostgreSQL 17**, couvrant bootstrap/drift-repair, atomicité, concurrence identique/divergente, rollback sur collision et annulation, pagination/cursor, rétention/races, ForceRehydrate et réouverture durable. Aucun build Tauri supplémentaire n'est requis : `0.3.3` ne change ni resources applicatives ni packaging desktop. `RawAccountState` PostgreSQL et la complétude RAW restent réservés à `0.3.4`.
+Le gate technique final `pre.011` passe audits Rust/Markdown, `cargo check --workspace`, Clippy all-targets, les tests ciblés Store/API/PostgreSQL/Config, les tests et checks façade avec `--no-default-features`, `cargo test --workspace` et les graphes Cargo. Le live `postgres_raw_transaction_live` est ensuite rejoué avec succès sur **PostgreSQL 17**, couvrant bootstrap/drift-repair, atomicité, concurrence identique/divergente, rollback sur collision et annulation, pagination/cursor, rétention/races, ForceRehydrate et réouverture durable. Aucun build Tauri supplémentaire n'est requis : `0.3.3` ne change ni resources applicatives ni packaging desktop. `RawAccountState` PostgreSQL et la complétude RAW restent réservés à `0.3.4`. `prompts/023-V0_3_4_START_PROMPT.md` ouvre cette slice suivante sur les quatre capabilities `RawAccount*`, une migration additive au-dessus de V000/V001, puis la conformance finale des dix capabilities RAW ; l'archive historique kbot3 y reste une source de comparaison ciblée account/observation, jamais une architecture à recopier.
 
 ## 0.3.2 — Store/PostgreSQL runtime foundation — 2026-08-30
 

Cargo.toml

@@ -1,12 +1,12 @@
 # file: Cargo.toml
-# version: 362
+# version: 363
 
 [workspace]
 resolver = "3"
 members = ["crates/ksp-app-config-desk", "crates/ksp-app-solprices-desk", "crates/ksp-app-wallet-desk", "crates/ksp-config-lib", "crates/ksp-core-lib", "crates/ksp-interface-lib", "crates/ksp-logging-lib", "crates/ksp-offchain-transport-lib", "crates/ksp-onchain-transport-lib", "crates/ksp-program-api", "crates/ksp-store-api", "crates/ksp-store-lib", "crates/ksp-store-postgres-lib", "crates/ksp-wallet-lib"]
 
 [workspace.package]
-version = "0.3.3-pre.12.fix.1"
+version = "0.3.3-pre.13"
 edition = "2024"
 license = "MIT"
 repository = "https://git.sasedev.com/Sasedev/khadhroony-solana-project"

ROADMAP.md

@@ -1,5 +1,5 @@
 <!-- file: ROADMAP.md -->
-<!-- version: 96 -->
+<!-- version: 97 -->
 
 # Roadmap KSP
 
@@ -96,7 +96,7 @@ RAW -> STRUCTURAL -> DECODED -> DOMAIN
 - [X] `0.3.1` — `ksp-store-api` stable : modèles N1 RAW backend-agnostic `RawTransaction` et `RawAccountState` avec observations, provenance, payload/hash/timestamps bornés, 10 capabilities object-safe, queries cursorisées sans plafond métier arbitraire, outcomes idempotence/conflit et lifecycle logique rétention/tombstone/force-rehydrate ; aucun backend physique, Config, runtime Store, notification dédiée ni surface STRUCTURAL/DECODED/DOMAIN.
 - [X] `0.3.2` — `ksp-store-lib` + `ksp-store-postgres-lib` stables comme fondation runtime/backend PostgreSQL : feature `postgres` par défaut, `Store` lié à un unique `RawNetworkId`, Config `std.store` avec targets/bases `devnet`/`mainnet`/`testnet`, pool Deadpool borné, `tokio-postgres`, TLS Rustls `Disabled`/`VerifyFull`, moteur de migrations privé `V000` + SHA-256/advisory lock, health/readiness portable et close borné. Gate complet + PostgreSQL réel major 17 verts ; aucune table/capability `RawTransaction`/`RawAccountState` métier n'est encore ajoutée.
 - [X] `0.3.3` — Vertical slice PostgreSQL `RawTransaction` complète sur `ksp-store-lib` + `ksp-store-postgres-lib` : six capabilities transaction/observation/rétention, V001 physique liée à un réseau, acquisition canonical+observation atomique, idempotence/conflit, get/list keyset cursorisé, archive/purge/tombstone/ForceRehydrate, hardening des erreurs et du schéma, concurrence et rollback validés sur PostgreSQL 17.
-- [ ] `0.3.4` — Étendre le même couple avec `RawAccountState` + observation, puis fermer la complétude/conformance RAW cross-family, les indexes/migrations physiques nécessaires et le hardening PostgreSQL final.
+- [ ] `0.3.4` — Étendre le même couple avec `RawAccountState` + `RawAccountObservation` : quatre capabilities account, migration additive au-dessus de V000/V001, acquisition state+observation atomique, idempotence/conflit, get/list cursorisé, puis complétude des dix capabilities RAW, indexes justifiés par les queries et hardening PostgreSQL cross-family final.
 - [ ] `0.3.5` — Étendre `ksp-interface-lib` uniquement avec les modèles passifs/events réellement partagés par les premiers consumers d’acquisition, sans dupliquer les modèles persistants de `ksp-store-api`.
 - [ ] `0.3.6` — Introduire `ksp-job-api` et un premier job de backfill historique concret consommant `ksp-store-lib`, avec policy/batch-size/progression possédés par le job et non par Store.
 - [ ] `0.3.7` — Introduire une application spécialisée de backfill/inspection RAW.

deltas/0.3.3/pre.013.md

@@ -0,0 +1,181 @@
+<!-- file: deltas/0.3.3/pre.013.md -->
+<!-- version: 1 -->
+
+# Delta `0.3.3-pre.013` — préparation de publication et prompt `0.3.4`
+
+## 1. Base requise
+
+Base directe attendue :
+
+```text
+0.3.3-pre.012-fix.001
+workspace.package.version = 0.3.3-pre.12.fix.1
+```
+
+Le gate opérateur du correctif documentaire, exécuté le **30 août 2026**, est entièrement vert : audits Rust/Markdown, `cargo check --workspace`, Clippy all-targets, tests ciblés Store/API/PostgreSQL/Config et `cargo check -p ksp-store-lib --no-default-features` passent.
+
+Le bump Cargo appliqué dans `pre.012-fix.001` était inutile pour un fix strictement documentaire au regard de `VER-ID-008`. L'historique livré n'est pas réécrit ; cette prerelease non-fix resynchronise normalement la version vers `0.3.3-pre.13` conformément à `VER-ID-009`.
+
+## 2. Objectif
+
+Dernière prerelease avant `rel.001`, strictement limitée à la préparation de publication minimale :
+
+```text
+workspace.package.version -> 0.3.3-pre.13
+finalisation publication de CHANGELOG.md
+précision de la prochaine slice dans ROADMAP.md
+création de prompts/023-V0_3_4_START_PROMPT.md
+delta pre.013
+```
+
+Aucun README, USAGE, plan, validation, architecture, règle, source Rust, test, Config, schema ou migration n'est rouvert.
+
+## 3. Prompt `0.3.4`
+
+Le nouveau prompt ouvre :
+
+```text
+0.3.4 — Store/PostgreSQL RawAccountState + complétude/conformance RAW
+```
+
+Il impose comme base :
+
+```text
+v0.3.3
+```
+
+et réserve le `pre.001` à :
+
+```text
+lectures obligatoires
+audit des quatre capabilities RawAccount*
+inventaire des dix capabilities RAW cross-family
+audit historique kbot3 ciblé account/observation
+distinction explicite ancien CoreAccountState / nouveau RawAccountState
+design V002 additif au-dessus de V000/V001
+mapping exact bytes/u64/optional metadata
+atomicité/idempotence/conflit
+ordre total + cursor anti-replay cross-family
+indexes strictement justifiés par RawAccountStateQuery
+threat model
+sizing + plan 025 + validation 021
+```
+
+L'archive historique explicitement requise est :
+
+```text
+khadhroony-bot3_v0.5.3-pre.005-fix010.zip
+```
+
+Elle reste une référence comparative et non une autorité architecturale.
+
+## 4. Frontières `0.3.4` figées dans le prompt
+
+Le prompt préserve :
+
+```text
+V000/V001 byte-identiques
+ksp_store_identity mono-network
+RawTransaction complet non régressé
+PostgresBackend/Store -> 10 capabilities RAW à la clôture
+RawAccountStateReference = network + pubkey + slot + state_hash
+même pubkey+slot avec state_hash différent autorisé
+même full reference + contenu divergent -> conflict
+RawAccountObservation optional write_version/signature/is_startup observation-only
+aucune rétention account inventée
+aucun batch-size/priorité/policy dans Store
+aucun index owner/provider/time sans query publique
+aucun STRUCTURAL/Interface/job/worker/app
+```
+
+La prévision souple réserve séparément gate technique/live, réconciliation documentaire puis publication minimale.
+
+## 5. `CHANGELOG.md`
+
+L'entrée `0.3.3` référence désormais explicitement le prompt `0.3.4`, ses quatre capabilities account, la migration additive et l'audit kbot3 ciblé.
+
+Aucune preuve technique nouvelle n'est inventée : le gate et le live PostgreSQL 17 restent ceux déjà acquis en `pre.011`/`pre.012`.
+
+## 6. `ROADMAP.md`
+
+L'entrée `0.3.4` précise maintenant la surface attendue :
+
+```text
+RawAccountState + RawAccountObservation
+4 capabilities account
+migration additive au-dessus de V000/V001
+state+observation atomique
+idempotence/conflit
+get/list cursorisé
+10 capabilities RAW cross-family
+indexes query-driven
+hardening PostgreSQL final
+```
+
+Les étapes `0.3.5` à `0.3.7` restent inchangées.
+
+## 7. Fichiers ajoutés
+
+```text
+prompts/023-V0_3_4_START_PROMPT.md
+deltas/0.3.3/pre.013.md
+```
+
+## 8. Fichiers modifiés
+
+```text
+Cargo.toml
+CHANGELOG.md
+ROADMAP.md
+```
+
+## 9. Fichiers supprimés
+
+```text
+aucun
+```
+
+## 10. Validations exécutées pendant la génération
+
+```text
+python3 scripts/audit_rust_workspace_rules.py
+-> General Rust rule audit: clean
+-> Rust export completeness audit: 0 candidate(s)
+-> KSP workspace Rust rule audit: clean
+
+python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas/0.3.3
+-> Markdown table audit: clean (214 table(s), 158 file(s))
+```
+
+## 11. Validations non exécutées pendant la génération
+
+La toolchain Cargo/Rust opérateur n'est pas disponible dans l'environnement de génération. Aucun `cargo check`, Clippy ou test Cargo n'est revendiqué ici.
+
+Aucun code/runtime/migration n'est modifié.
+
+## 12. Gate opérateur demandé
+
+```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.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
+```
+
+Aucun replay live PostgreSQL supplémentaire n'est requis : `pre.013` ne modifie ni code, ni tests, ni migrations.
+
+## 13. Suite
+
+Si `pre.013` est propre :
+
+```text
+0.3.3-rel.001
+```
+
+La livraison `rel.001` reste mécanique et minimale ; elle ne corrige aucun défaut documentaire ou fonctionnel.