Files
khadhroony-solana-project/deltas/0.3.3/pre.013.md
2026-08-30 18:03:06 +02:00

182 lines
5.2 KiB
Markdown

<!-- 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.