v0.2.14-pre.001
This commit is contained in:
201
deltas/0.2.14/pre.001.md
Normal file
201
deltas/0.2.14/pre.001.md
Normal file
@@ -0,0 +1,201 @@
|
||||
<!-- 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.
|
||||
Reference in New Issue
Block a user