193 lines
5.8 KiB
Markdown
193 lines
5.8 KiB
Markdown
<!-- file: deltas/0.2.13/pre.007.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# Delta `0.2.13-pre.007` — réconciliation documentaire finale Interface
|
|
|
|
## 1. Base
|
|
|
|
```text
|
|
0.2.13-pre.006
|
|
```
|
|
|
|
Le gate opérateur de `pre.006`, exécuté le **28 août 2026**, est intégralement vert :
|
|
|
|
```text
|
|
cargo fmt --all PASS
|
|
audits Rust / export completeness / workspace PASS
|
|
audit Markdown PASS — 162 tables / 119 fichiers
|
|
cargo check --workspace PASS
|
|
cargo clippy --workspace --all-targets PASS
|
|
cargo test -p ksp-interface-lib PASS
|
|
cargo test -p ksp-logging-lib --test ownership PASS
|
|
cargo test --workspace PASS
|
|
cargo tree -p ksp-interface-lib --edges normal Core-only confirmé
|
|
cargo tree --duplicates inspecté
|
|
```
|
|
|
|
La lane technique est donc fermée avant cette tranche.
|
|
|
|
## 2. Objectif
|
|
|
|
`pre.007` est exclusivement le couloir de réconciliation documentaire finale de `0.2.13`. Aucun fichier Rust, test, manifest de crate, dépendance, codec ou comportement n'est modifié.
|
|
|
|
La tranche transforme les README/USAGE initiaux d'Interface en références durables et aligne plan, validation, séquence fonctionnelle et index documentaires sur la surface réellement validée.
|
|
|
|
## 3. Version technique
|
|
|
|
```text
|
|
0.2.13-pre.6
|
|
->
|
|
0.2.13-pre.7
|
|
```
|
|
|
|
Le bump est mécanique pour une prerelease non-fix. Aucun autre manifest/version applicative n'est synchronisé artificiellement.
|
|
|
|
## 4. Surface finale candidate documentée
|
|
|
|
```text
|
|
Pubkey réexport Core
|
|
ProgramAccountMeta passif, champs privés
|
|
ProgramInstruction passif, champs privés
|
|
MAX_PROGRAM_INSTRUCTION_ACCOUNTS 255
|
|
MAX_PROGRAM_INSTRUCTION_DATA_LEN 10_240
|
|
ERROR_CODE_PROGRAM_INSTRUCTION_LIMIT_EXCEEDED interface.program_instruction_limit_exceeded
|
|
```
|
|
|
|
Les propriétés réconciliées sont :
|
|
|
|
```text
|
|
accounts ordonnés préservés
|
|
doublons accounts préservés
|
|
accounts/data vides acceptés
|
|
Program Pubkey hors registry accepté
|
|
Vec accounts/data consommés sans reformatage interne
|
|
Debug ProgramInstruction program_id/account_count/data_len uniquement
|
|
erreur de borne field/actual_len/maximum_len uniquement
|
|
```
|
|
|
|
Les limites `255` et `10_240` restent explicitement des bornes d'admission Interface et non une garantie complète de fit transaction Solana top-level.
|
|
|
|
## 5. Dependency firewall final
|
|
|
|
Le graphe normal confirmé par l'opérateur reste :
|
|
|
|
```text
|
|
ksp-interface-lib
|
|
└── ksp-core-lib
|
|
└── solana-pubkey
|
|
```
|
|
|
|
La foundation ne dépend pas de :
|
|
|
|
```text
|
|
serde / serde_json
|
|
borsh / wincode / bincode
|
|
solana-instruction
|
|
Transport / Config / Store / Wallet / Program
|
|
reqwest / tonic / tokio / Tauri
|
|
ksp-logging-lib / tracing runtime
|
|
```
|
|
|
|
L'absence de runtime logging est volontaire : la surface actuelle est purement passive.
|
|
|
|
## 6. Références durables réconciliées
|
|
|
|
```text
|
|
crates/ksp-interface-lib/README.md
|
|
crates/ksp-interface-lib/USAGE.md
|
|
docs/000-README.md
|
|
docs/plans/000-README.md
|
|
docs/plans/002-FUNCTIONAL_RELEASE_SEQUENCE.md
|
|
docs/plans/020-V0_2_13_INTERFACE_PLAN.md
|
|
docs/validation/000-README.md
|
|
docs/validation/016-V0_2_13_INTERFACE.md
|
|
```
|
|
|
|
Le README Interface fixe l'ownership, la surface publique, les bornes, le modèle d'erreur, le Debug borné, le graphe et les frontières de responsabilité.
|
|
|
|
`USAGE.md` documente l'usage crate-root de `ProgramAccountMeta` et `ProgramInstruction`, les accessors, les limites et l'observation des erreurs sans accès aux modules privés.
|
|
|
|
La séquence fonctionnelle enregistre le contenu effectivement livré par `0.2.13`, tout en maintenant :
|
|
|
|
```text
|
|
0.2.14 Program API foundation
|
|
0.3.2+ wires génériques acquisition/CORE
|
|
```
|
|
|
|
## 7. Fichiers ajoutés/modifiés
|
|
|
|
Ajouté :
|
|
|
|
```text
|
|
deltas/0.2.13/pre.007.md
|
|
```
|
|
|
|
Modifiés :
|
|
|
|
```text
|
|
Cargo.toml
|
|
crates/ksp-interface-lib/README.md
|
|
crates/ksp-interface-lib/USAGE.md
|
|
docs/000-README.md
|
|
docs/plans/000-README.md
|
|
docs/plans/002-FUNCTIONAL_RELEASE_SEQUENCE.md
|
|
docs/plans/020-V0_2_13_INTERFACE_PLAN.md
|
|
docs/validation/000-README.md
|
|
docs/validation/016-V0_2_13_INTERFACE.md
|
|
```
|
|
|
|
Aucun fichier supprimé.
|
|
|
|
## 8. Surfaces volontairement inchangées
|
|
|
|
Cette tranche ne touche pas :
|
|
|
|
```text
|
|
crates/ksp-interface-lib/src/**
|
|
crates/ksp-interface-lib/tests/**
|
|
crates/ksp-interface-lib/unit_tests/**
|
|
crates/ksp-interface-lib/Cargo.toml
|
|
docs/architecture/**
|
|
CHANGELOG.md
|
|
ROADMAP.md
|
|
prompts/**
|
|
```
|
|
|
|
Les architectures existantes sont déjà compatibles avec la foundation réellement livrée et ne nécessitent aucune réécriture de clôture.
|
|
|
|
## 9. Gate opérateur
|
|
|
|
La tranche étant documentaire hors bump workspace, le gate demandé reste déterministe :
|
|
|
|
```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.13
|
|
cargo check --workspace
|
|
cargo clippy --workspace --all-targets
|
|
cargo test -p ksp-interface-lib
|
|
cargo test --workspace
|
|
```
|
|
|
|
Aucun smoke réseau/live ni nouveau `cargo tree` n'est requis si l'overlay est appliqué exactement : ces preuves appartiennent à la lane technique fermée par `pre.006`.
|
|
|
|
## 10. Suite
|
|
|
|
Si le gate est vert :
|
|
|
|
```text
|
|
0.2.13-pre.008 — préparation minimale de publication
|
|
```
|
|
|
|
`pre.008` reste limitée à :
|
|
|
|
```text
|
|
Cargo.toml
|
|
CHANGELOG.md
|
|
ROADMAP.md
|
|
prompts/019-V0_2_14_START_PROMPT.md
|
|
deltas/0.2.13/pre.008.md
|
|
```
|
|
|
|
Aucun code, test, README/USAGE, plan, validation ou architecture ne doit être rouvert dans cette lane de publication minimale sauf défaut réel découvert au gate.
|