202 lines
5.9 KiB
Markdown
202 lines
5.9 KiB
Markdown
<!-- file: deltas/0.2.14/pre.001.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# 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<Decoded>
|
|
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.
|