# Delta `0.2.14-pre.001` — audit Program API, héritage kbot3 et sizing ## 1. Base requise Base directe attendue : ```text v0.2.13 workspace.package.version = 0.2.13 ``` Sources obligatoires réellement disponibles à l'ouverture : ```text archive opérateur khadhroony-solana-project-v0.2.13.zip archive historique khadhroony-bot3_v0.5.3-pre.005-fix010.zip ``` La metadata Git n'est pas incluse dans l'archive opérateur; le tag `v0.2.13` ne peut donc pas être interrogé localement. La version Cargo, `deltas/0.2.13/rel.001.md`, le prompt 019 et la surface Interface publiée concordent avec la base stable attendue. Commit attendu : ```text v0.2.14-pre.001 ``` ## 2. Objectif Ouvrir `0.2.14 — Program API foundation` uniquement par le gate prévu : ```text lecture règles + architecture audit Core + Interface stables audit historique kbot3 réel matrice d'héritage ownership API candidate threat/API model dependency graph stratégie de tests sizing et prévision souple recalibrée ``` Aucun scaffold `ksp-program-api`, decoder concret, registry runtime ou execution preparer n'est ajouté dans cette livraison. ## 3. Décisions principales Le scope est réduit à une foundation instruction-only : ```text ProgramInstructionRecognition ProgramInstructionDecodeOutcome ProgramInstructionDecoder avec associated output ``` Le candidat trait utilise : ```text &ProgramInstruction &[Pubkey] ksp_core_lib::Result Send + Sync ``` L'output concret appartient à l'implémentation externe ou au futur `ksp-program-lib`. Sont explicitement reportés : ```text payload canonique D3 registry runtime hétérogène identity/version/coverage génériques diagnostics/proofs Program dédiés ProgramAccountDecoder / Event / ReturnData ProgramExecutionPreparer ``` Le design n'ajoute aucune dépendance externe et ne requiert donc aucun audit web/Solana supplémentaire en `pre.001`. ## 4. Héritage kbot3 L'archive historique a été réellement extraite et les contrats prioritaires ont été relus. Conclusions : ```text REPRENDRE séparation recognition/decode, trait instruction, Send+Sync, préparation pure conceptuelle REDESSINER recognition, outcomes, execution capability/prepared plan REPORTER identity/version, coverage, diagnostics, proofs, replay context, decoded event, registry, preparer REJETER Program IDs/Pubkeys String, generic JSON payload, generic protocol monolith, executor, policy dans Program, ks-lib monolithique ``` Les decoders Solana Core, SPL Token et SPL Token-2022 confirment que l'ancien trait contextualisé dépendait réellement de signature/slot/path/transaction status/hash et JSON. Ces champs appartiennent aux futures couches CORE/DECODE et ne sont pas reconstruits dans Program API. ## 5. Sizing recalibré Prévision active : ```text pre.001 audit/design/sizing pre.002 scaffold + facade + dependency firewall pre.003 recognition + outcome pre.004 decoder trait + external implementation pre.005 adversarial/API hardening + completeness pre.006 gate technique final pre.007 réconciliation documentaire pre.008 préparation de publication minimale rel.001 publication stable ``` Registry, canonical payload et execution preparation ne sont plus des tranches de `0.2.14`. ## 6. Fichiers ajoutés ```text docs/plans/021-V0_2_14_PROGRAM_API_PLAN.md docs/validation/017-V0_2_14_PROGRAM_API.md deltas/0.2.14/pre.001.md ``` ## 7. Fichiers modifiés ```text Cargo.toml docs/plans/000-README.md docs/validation/000-README.md ``` ## 8. Fichiers supprimés ```text aucun ``` ## 9. Version Cargo La prerelease non-fix synchronise : ```text workspace.package.version = 0.2.14-pre.1 ``` Aucune crate Program n'existe encore; le changement Cargo sert uniquement à identifier la tranche `pre.001` conformément au workflow. ## 10. Validations exécutées pendant la préparation Le journal opérateur fourni à l'ouverture sur la base stable `v0.2.13` montre un baseline complet vert avant application de ce delta, notamment audits Rust/Markdown, `cargo check --workspace`, Clippy, tests ciblés des crates et `cargo test --workspace`. Cette preuve de base ne remplace pas le gate après application. Dans l'environnement de génération du présent overlay, les contrôles statiques suivants ont été réellement exécutés après modification : ```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.2.14 Markdown table audit: clean (170 tables, 116 files) ``` `cargo` n'est pas installé dans l'environnement de génération utilisé pour préparer l'archive. Les commandes Cargo de validation après application n'ont donc pas été rejouées ici et ne sont pas déclarées PASS. ## 11. Validations non requises dans cette tranche ```text cargo test -p ksp-program-api crate encore absente cargo tree -p ksp-program-api crate encore absente smokes réseau/live hors scope d'une API déclarative ``` ## 12. Questions ouvertes Aucune question ne bloque le passage à `pre.002`. Les sujets suivants restent ouverts volontairement pour des releases ultérieures, pas pour compléter `0.2.14` : ```text canonical DECODE/D3 payload runtime registry / conflict policy / erased composition processor identity/version durable coverage descriptors contextual proofs/diagnostics ProgramExecutionPreparer exact ``` ## 13. Application et validation opérateur Après application de l'overlay : ```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.2.14 cargo check --workspace cargo clippy --workspace --all-targets ``` Aucun développement fonctionnel Program ne doit être ajouté à ce delta.