5.8 KiB
Delta 0.2.13-pre.007 — réconciliation documentaire finale Interface
1. Base
0.2.13-pre.006
Le gate opérateur de pre.006, exécuté le 28 août 2026, est intégralement vert :
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
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
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 :
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 :
ksp-interface-lib
└── ksp-core-lib
└── solana-pubkey
La foundation ne dépend pas de :
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
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 :
0.2.14 Program API foundation
0.3.2+ wires génériques acquisition/CORE
7. Fichiers ajoutés/modifiés
Ajouté :
deltas/0.2.13/pre.007.md
Modifiés :
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 :
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 :
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 :
0.2.13-pre.008 — préparation minimale de publication
pre.008 reste limitée à :
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.