v0.3.3-pre.013

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.