khadhroony-solana-project/deltas/0.2.14/pre.008.md

Delta 0.2.14-pre.008 — préparation de publication et prompt 0.3.1

1. Base requise

0.2.14-pre.007
workspace.package.version = 0.2.14-pre.7

Le gate opérateur de pre.007 fourni le 28 août 2026 est intégralement vert :

cargo fmt --all                                      PASS
audit Rust général / exports / workspace             PASS
audit Markdown                                       PASS — 175 tables / 125 fichiers
cargo check --workspace                              PASS
cargo clippy --workspace --all-targets               PASS
cargo test -p ksp-program-api                        PASS — 18 tests Rust
cargo test -p ksp-logging-lib --test ownership       PASS — 2 tests
cargo test --workspace                               PASS

Les tests live/bench explicitement ignored restent volontairement hors de ce gate documentaire.

pre.007 a fermé la réconciliation durable de ksp-program-api, des indexes, du plan et de la validation sans rouvrir CHANGELOG.md, ROADMAP.md ni le prompt suivant.

2. Objectif

Dernière prerelease avant rel.001, strictement limitée à la préparation de publication :

• ajouter l'entrée préparatoire stable 0.2.14 dans CHANGELOG.md ;
• fermer 0.2.14 dans ROADMAP.md ;
• produire prompts/020-V0_3_1_START_PROMPT.md ;
• bump mécanique de la version workspace vers 0.2.14-pre.8 ;
• ne rouvrir aucun code, test, README/USAGE, plan, validation, architecture ou règle normative.

3. Version Cargo

Publication non-fix de prerelease :

0.2.14-pre.7
-> 0.2.14-pre.8

Aucune crate membre ne redéfinit localement la version.

4. Changelog / Roadmap

CHANGELOG.md résume la surface stable candidate 0.2.14 :

ksp-program-api instruction-only
ProgramInstructionRecognition
ProgramInstructionDecodeOutcome<Decoded>
ProgramInstructionDecoder: Send + Sync
10 exports crate-root / 3 modules de production
implémentation externe avec Program Pubkey opaque
Core + Interface uniquement
aucun registry/runtime/serde/codec/Store/Materializer/Execution
18 tests Program API au gate final

ROADMAP.md passe 0.2.14 à [X] et conserve 0.3.1 comme prochaine release ouverte :

ksp-store-api + ksp-store-lib
PostgreSQL de référence
RAW seulement

5. Prompt 0.3.1

Le nouveau prompt a été confronté à :

docs/rules/PROMPT_STRUCTURE.md
docs/rules/VERSION_WORKFLOW.md
docs/rules/FILE_CONTRACTS.md
docs/rules/RULES_KSP.md
docs/rules/RULES_DEPENDENCIES.md

docs/architecture/002-LAYERS_AND_DEPENDENCIES.md
docs/architecture/003-COMPONENT_CONTRACTS.md
docs/architecture/004-COMPONENT_INVENTORY.md
docs/architecture/005-DEPENDENCY_GRAPH.md
docs/architecture/008-DATA_MATERIALIZATION_AND_STORE.md
docs/architecture/009-ACQUISITION_WORKERS_AND_JOBS.md

prompts/018-V0_2_13_START_PROMPT.md
prompts/019-V0_2_14_START_PROMPT.md

L'archive historique suivante a également été reconnue pour déterminer si elle devait être requise dans la prochaine session :

khadhroony-bot3_v0.5.3-pre.005-fix010.zip

Elle contient notamment :

ks-store/**
ks-store/migrations/postgres/**
config/store.config.json
config/schemas/store.config.schema.json
ks-config/src/store.rs
docs/architecture/STORAGE_ARCHITECTURE.md
docs/guides/POSTGRES_STORAGE.md
docs/plans/V0_5_3_KS_STORE_NORMALIZATION_PLAN.md

Conclusion : l'archive est obligatoire pour 0.3.1-pre.001, mais seulement comme source historique à classer sous :

REPRENDRE / REDESSINER / REPORTER / REJETER

L'ancien ks-store couvre RAW + CORE + DECODE/materialization et ne doit donc pas être recopié dans 0.3.1.

Le prompt protège explicitement les frontières :

0.3.1  Store API + PostgreSQL RAW-only
0.3.2  wires génériques Interface acquisition/CORE
0.3.3  Job API + backfill RAW
0.3.4  application backfill/inspection RAW
plus tard CORE -> DECODE -> SPECIALIZED

Il impose en pre.001 :

audit base stable
audit kbot3 Store
audit PostgreSQL + dépendance Rust candidate avec sources actuelles
inventaire RAW minimal
ownership API/impl/composition
dependency graph
API backend-agnostic candidate
schema PostgreSQL RAW candidate
migration strategy
threat model
PostgreSQL integration strategy
sizing + prévision souple recalibrée

6. Prévision souple intégrée au prompt

La prévision initiale réserve distinctement :

pre.001  audit/sizing
pre.002  scaffold API + lib
pre.003  contrats RAW
pre.004  Store API + backend externe canari
pre.005  PostgreSQL runtime foundation
pre.006  schema/migrations RAW
pre.007  writes/idempotence/atomicité
pre.008  reads/pagination/notification si retenue
pre.009  hardening/completeness
pre.010  gate PostgreSQL réel
pre.011  réconciliation documentaire
pre.012  préparation de publication
rel.001  publication stable

Cette prévision reste souple et doit être recalibrée par 0.3.1-pre.001 selon le scope RAW réel.

7. Fichiers ajoutés

prompts/020-V0_3_1_START_PROMPT.md
deltas/0.2.14/pre.008.md

8. Fichiers modifiés

Cargo.toml
CHANGELOG.md
ROADMAP.md

9. Fichiers supprimés

Aucun.

10. Surfaces explicitement non rouvertes

README.md
RULES.md
.env.example
config/**
crates/**
docs/**
prompts/001..019

En particulier :

crates/ksp-program-api/**
docs/plans/021-V0_2_14_PROGRAM_API_PLAN.md
docs/validation/017-V0_2_14_PROGRAM_API.md
docs/architecture/**

11. Validations de préparation

À exécuter sur l'arbre reconstruit :

audit Rust workspace
audit Markdown
contrôle exact du payload overlay
contrôle des versions/file headers
contrôle qu'aucun fichier hors lane n'est modifié

Aucun résultat Cargo nouveau n'est revendiqué par la génération de ce delta.

12. Gate opérateur

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.2.14
cargo check --workspace
cargo clippy --workspace --all-targets
cargo test -p ksp-program-api
cargo test -p ksp-logging-lib --test ownership
cargo test --workspace

Aucun smoke réseau/live ni nouveau graphe Cargo n'est requis : cette lane ne modifie ni code, ni dépendance, ni runtime.

13. Étape suivante

Si le gate reste vert :

0.2.14-rel.001

La publication stable devra être strictement mécanique :

workspace.package.version = 0.2.14
delta deltas/0.2.14/rel.001.md
commit de publication
tag stable v0.2.14 après validation opérateur

rel.001 ne doit modifier ni CHANGELOG.md, ni ROADMAP.md, ni le prompt 0.3.1, sauf anomalie découverte qui renverrait d'abord vers une prerelease dédiée conformément au workflow.