v0.2.14-pre.007

2026-08-28 16:16:15 +02:00
parent 4eba9be48c
commit 2cf00e9426
10 changed files with 421 additions and 76 deletions
--- a/docs/000-README.md
+++ b/docs/000-README.md
--- a/docs/plans/000-README.md
+++ b/docs/plans/000-README.md
@@ -1,5 +1,5 @@
 <!-- file: docs/plans/000-README.md -->
-<!-- version: 66 -->
+<!-- version: 67 -->

 # Plans KSP

@@ -29,7 +29,7 @@ Un plan décrit le périmètre, les décisions déjà acquises, les questions ou
 - [`018-V0_2_11_OFFCHAIN_PRICE_TRANSPORT_PLAN.md`](018-V0_2_11_OFFCHAIN_PRICE_TRANSPORT_PLAN.md) — plan historique clôturé de `0.2.11 — Off-chain price transport`; SOL/USD V1, huit providers REST sans SDK, registry/availability/rate limits Off-chain et Config `std.offchain_transport`.
 - [`019-V0_2_12_SOL_PRICES_DESK_PLAN.md`](019-V0_2_12_SOL_PRICES_DESK_PLAN.md) — plan historique clôturé de `0.2.12 — SOL Prices Desk + intégration prix Wallet Desk`; il conserve le gabarit 1434/1435, le composite Config, les DTO/commands provider-neutral, l’intégration Wallet minimale et les gates live/build finaux.
 - [`020-V0_2_13_INTERFACE_PLAN.md`](020-V0_2_13_INTERFACE_PLAN.md) — plan candidat réconcilié de `0.2.13 — Interface / wire foundation`; il fixe la surface finale `ProgramAccountMeta` + `ProgramInstruction`, les bornes `255` / `10_240`, le firewall Interface -> Core, les canaris de complétude/consumer externe et la frontière avec Program API/RAW/CORE.
- [`021-V0_2_14_PROGRAM_API_PLAN.md`](021-V0_2_14_PROGRAM_API_PLAN.md) — plan actif de `0.2.14 — Program API foundation`, ouvert par `pre.001`; il fixe une foundation instruction-only ouverte, un output typé par associated type, le report du payload canonique D3, du registry runtime et de `ProgramExecutionPreparer`, ainsi que le canari d’implémentation externe.
+- [`021-V0_2_14_PROGRAM_API_PLAN.md`](021-V0_2_14_PROGRAM_API_PLAN.md) — plan candidat réconcilié de `0.2.14 — Program API foundation`; il fixe la façade instruction-only ouverte, les enums Recognition/Outcome, `ProgramInstructionDecoder`, l'output associé possédé par l'implémentation, le canari externe avec Program Pubkey non enregistré, le firewall Core/Interface et le report du payload canonique D3, du registry runtime et de `ProgramExecutionPreparer`.

 Le `pre.001` de chaque release fonctionnelle peut introduire son propre plan détaillé lorsque la release s'ouvre.

--- a/docs/plans/002-FUNCTIONAL_RELEASE_SEQUENCE.md
+++ b/docs/plans/002-FUNCTIONAL_RELEASE_SEQUENCE.md
@@ -1,5 +1,5 @@
 <!-- file: docs/plans/002-FUNCTIONAL_RELEASE_SEQUENCE.md -->
-<!-- version: 94 -->
+<!-- version: 95 -->

 # Séquence des releases fonctionnelles KSP

@@ -528,9 +528,29 @@ Aucune `ksp-interface-api` séparée n'est retenue pour l'instant. Les codecs/la

 ### `0.2.14` — Program API foundation

-Introduire `ksp-program-api`, sans suffixe `-lib`, comme contrat d'extension Program.
+`ksp-program-api`, sans suffixe `-lib`, matérialise la première façade publique ouverte du domaine Program. La candidate reste volontairement instruction-only et dépend uniquement de Core + Interface.

-`ksp-program-lib` et les vertical slices réels arrivent plus tard.
+La surface commune est :
+
+```text
+ProgramInstructionRecognition
+  NoMatch / ProgramMatch / ExactMatch
+
+ProgramInstructionDecodeOutcome<Decoded>
+  Decoded(Decoded) / Unsupported
+
+ProgramInstructionDecoder: Send + Sync
+  type Decoded
+  program_ids(&self) -> &[Pubkey]
+  recognize(&self, &ProgramInstruction) -> ProgramInstructionRecognition
+  decode(&self, &ProgramInstruction) -> Result<ProgramInstructionDecodeOutcome<Self::Decoded>>
+```
+
+L'output concret reste possédé par l'implémentation et ne reçoit aucun bound implicite `Debug/Clone/Send/Sync`. Une crate externe peut implémenter le trait pour un Program Pubkey absent du registry Core ; aucun enum central de Programs, `Any`, JSON, registry runtime ou descriptor global n'est requis.
+
+Le hardening final verrouille l'inventaire crate-root exact, le passage d'une `ProgramInstruction` Interface maximale par référence, l'absence d'echo automatique de payload hostile, l'absence de default methods et le firewall `Program API -> Core + Interface`. `pre.006` ferme le gate technique avec audits/check/Clippy/tests workspace et graphe Cargo verts. [`../../crates/ksp-program-api/README.md`](../../crates/ksp-program-api/README.md) et [`../../crates/ksp-program-api/USAGE.md`](../../crates/ksp-program-api/USAGE.md) deviennent les références durables de la candidate.
+
+Restent explicitement reportés : `ksp-program-lib`, payload canonique D3, registry runtime, identity/version/coverage génériques, autres familles de decoder et `ProgramExecutionPreparer`. Ils seront introduits uniquement par les vertical slices qui démontreront leurs contrats réels.

 ## Architecture durable : RAW -> CORE -> DECODE -> SPECIALIZED

--- a/docs/plans/021-V0_2_14_PROGRAM_API_PLAN.md
+++ b/docs/plans/021-V0_2_14_PROGRAM_API_PLAN.md
@@ -1,5 +1,5 @@
 <!-- file: docs/plans/021-V0_2_14_PROGRAM_API_PLAN.md -->
-<!-- version: 6 -->
+<!-- version: 7 -->

 # Plan `0.2.14` — Program API foundation

@@ -698,6 +698,55 @@ Le faux positif du canari logging est donc fermé sans changement de production

 La tranche `pre.006` ne matérialise aucun nouveau code ou test : elle synchronise seulement la version workspace, le plan, la validation et son delta afin de rejouer le gate technique final sur la surface candidate déjà durcie.

+## 13.6 Gate technique final `pre.006` et réconciliation `pre.007`
+
+Le gate opérateur de `pre.006`, fourni le 28 août 2026, ferme intégralement la lane technique sans modification de production ni de tests :
+
+```text
+cargo fmt --all                                      PASS
+audits Rust / export completeness / workspace        PASS
+audit Markdown                                       PASS — 174 tables / 124 fichiers
+cargo check --workspace                              PASS
+cargo clippy --workspace --all-targets               PASS
+cargo test -p ksp-program-api                        PASS — 18 tests Rust
+cargo test -p ksp-logging-lib --test ownership       PASS — 2/2
+cargo test --workspace                               PASS
+cargo tree -p ksp-program-api --edges normal         PASS — Core + Interface uniquement
+cargo tree --duplicates                              inspecté
+```
+
+La surface technique candidate est donc figée :
+
+```text
+crate-root exports                     10 exacts
+production modules                     3 exacts
+public enums                           Recognition + DecodeOutcome uniquement
+public trait                           ProgramInstructionDecoder uniquement
+normal dependencies                    Core + Interface uniquement
+Program Pubkey hors registry           accepté par canari externe
+max Interface instruction              admise à la frontière decoder par référence
+registry / descriptors / preparer      absents
+serde / JSON / Any / codecs            absents
+logging / runtime / IO                 absents
+```
+
+`pre.007` ne rouvre aucun fichier Rust, test, manifest de crate, dépendance ou comportement. La version workspace avance mécaniquement à `0.2.14-pre.7` et les références durables suivantes sont réconciliées :
+
+```text
+crates/ksp-program-api/README.md
+crates/ksp-program-api/USAGE.md
+docs/000-README.md
+docs/plans/000-README.md
+docs/plans/002-FUNCTIONAL_RELEASE_SEQUENCE.md
+docs/plans/021-V0_2_14_PROGRAM_API_PLAN.md
+docs/validation/000-README.md
+docs/validation/017-V0_2_14_PROGRAM_API.md
+```
+
+La documentation finale fixe l'ownership, l'inventaire crate-root, les semantics Recognition/Outcome, le trait externe, les preuves open-world/adversariales et le dependency firewall. Les index passent au statut candidat réconcilié sans annoncer prématurément la release stable.
+
+Cette tranche ne touche explicitement pas `CHANGELOG.md`, `ROADMAP.md`, le prompt suivant, l'architecture ni les surfaces techniques. Ces responsabilités appartiennent à `pre.008`, sauf découverte d'un défaut documentaire réel imposant une nouvelle tranche de réconciliation.
+
 ## 14. Hors périmètre confirmé

 ```text
@@ -720,7 +769,7 @@ IDL runtime / Anchor generic decoder

 ## 15. Critères de clôture

-La release pourra être publiée lorsque :
+La candidate satisfait les critères techniques et documentaires suivants avant préparation de publication :

 ```text
 ksp-program-api existe
--- a/docs/validation/000-README.md
+++ b/docs/validation/000-README.md
@@ -1,5 +1,5 @@
 <!-- file: docs/validation/000-README.md -->
-<!-- version: 30 -->
+<!-- version: 31 -->

 # Validations KSP

@@ -25,4 +25,4 @@ Documents :
 - [`014-V0_2_11_OFFCHAIN_PRICE_TRANSPORT.md`](014-V0_2_11_OFFCHAIN_PRICE_TRANSPORT.md) — matrice historique clôturée de `0.2.11` : SOL/USD multi-provider, numeric safety, rate limiting/availability, Config capability-aware et smoke keyless final `7/7`.
 - [`015-V0_2_12_SOL_PRICES_DESK.md`](015-V0_2_12_SOL_PRICES_DESK.md) — matrice historique clôturée de `0.2.12` : screen/features, DTO/commands, Config/composite, frontières provider-neutral, sécurité, Wallet integration, packaging Tauri et gates live/build.
 - [`016-V0_2_13_INTERFACE.md`](016-V0_2_13_INTERFACE.md) — matrice candidate finale de `0.2.13` : ownership Interface/Core/Transport/Program, surface passive, bornes/adversarial, façade publique exacte, consumer externe, release completeness, dependency firewall et gate technique `pre.006` intégralement vert.
- [`017-V0_2_14_PROGRAM_API.md`](017-V0_2_14_PROGRAM_API.md) — matrice active de `0.2.14 — Program API foundation`; elle suit le gate d’audit `pre.001`, l’open-world external implementation canary, le firewall Core/Interface et les gates techniques/documentaires futurs.
+- [`017-V0_2_14_PROGRAM_API.md`](017-V0_2_14_PROGRAM_API.md) — matrice candidate finale de `0.2.14 — Program API foundation` : façade instruction-only ouverte, Recognition/Outcome, trait externe, Program Pubkey non enregistré, hardening adversarial, release completeness, firewall Core/Interface et gate technique `pre.006` intégralement vert.
--- a/docs/validation/017-V0_2_14_PROGRAM_API.md
+++ b/docs/validation/017-V0_2_14_PROGRAM_API.md
@@ -1,13 +1,13 @@
 <!-- file: docs/validation/017-V0_2_14_PROGRAM_API.md -->
-<!-- version: 6 -->
+<!-- version: 7 -->

 # Validation `0.2.14` — Program API foundation

 ## 1. Objet

-Cette matrice est ouverte par `0.2.14-pre.001`. Elle distingue les preuves déjà acquises par le gate d'audit des validations futures qui ne doivent pas être déclarées PASS avant exécution.
+Cette matrice, ouverte par `0.2.14-pre.001`, est réconciliée par `pre.007` après fermeture intégralement verte du gate technique `pre.006`. Elle conserve l'historique des preuves par tranche et la surface candidate finale.

-Le scope validé par `pre.001` est une foundation instruction-only avec output associé à l'implémentation. Registry runtime, payload canonique D3 et `ProgramExecutionPreparer` sont explicitement reportés.
+Le scope final reste une foundation instruction-only avec output associé à l'implémentation. Registry runtime, payload canonique D3 et `ProgramExecutionPreparer` sont explicitement reportés.

 ## 2. Gate `pre.001`

@@ -118,7 +118,7 @@ tracing

 ### Gate technique final

-À exécuter dans la prerelease dédiée :
+Le gate technique dédié `pre.006` est fermé intégralement vert. Les commandes de référence étaient :

 ```bash
 cargo fmt --all
@@ -127,6 +127,7 @@ python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG
 cargo check --workspace
 cargo clippy --workspace --all-targets
 cargo test -p ksp-program-api
+cargo test -p ksp-logging-lib --test ownership
 cargo test --workspace
 cargo tree -p ksp-program-api --edges normal
 cargo tree --duplicates
@@ -134,7 +135,7 @@ cargo tree --duplicates

 ### Réconciliation documentaire

-Doit fermer :
+`pre.007` ferme :

 ```text
 ksp-program-api README/USAGE
@@ -304,3 +305,42 @@ Le faux positif `tracing` du canari `release_completeness.rs` est fermé sans aj
 | CHANGELOG / ROADMAP / prompt suivant | non modifiés                              |

 Aucun smoke réseau/live n'est requis : `ksp-program-api` reste une API déclarative instruction-only sans I/O.
+
+## 16. Gate technique final `pre.006`
+
+Le gate opérateur fourni le 28 août 2026 confirme la candidate technique complète :
+
+```text
+cargo fmt --all                                      PASS
+audits Rust / export completeness / workspace        PASS
+audit Markdown                                       PASS — 174 tables / 124 fichiers
+cargo check --workspace                              PASS
+cargo clippy --workspace --all-targets               PASS
+cargo test -p ksp-program-api                        PASS — 18 tests Rust
+cargo test -p ksp-logging-lib --test ownership       PASS — 2/2
+cargo test --workspace                               PASS
+cargo tree -p ksp-program-api --edges normal         PASS — Core + Interface uniquement
+cargo tree --duplicates                              inspecté
+```
+
+Les duplicates observés sont ceux du workspace global et ne proviennent d'aucune dépendance ajoutée par Program API. Aucun smoke live n'est applicable à cette foundation déclarative sans I/O.
+
+La validation technique de la release candidate est fermée.
+
+## 17. Réconciliation documentaire `pre.007`
+
+La documentation finale candidate est alignée sur les preuves techniques :
+
+| Référence durable                               | Statut `pre.007` | Contrat réconcilié                                                        |
+|-------------------------------------------------|------------------|---------------------------------------------------------------------------|
+| `crates/ksp-program-api/README.md`              | PASS structurel  | ownership, surface exacte, semantics, hardening, firewall et frontières   |
+| `crates/ksp-program-api/USAGE.md`               | PASS structurel  | usage crate-root, implémentation externe, sélection, outcome et Debug sûr |
+| `docs/plans/002-FUNCTIONAL_RELEASE_SEQUENCE.md` | PASS structurel  | contenu réel `0.2.14` + reports runtime/D3/preparer                       |
+| `docs/plans/021-V0_2_14_PROGRAM_API_PLAN.md`    | PASS structurel  | gate `pre.006` fermé + lane documentaire finale                           |
+| `docs/validation/017-V0_2_14_PROGRAM_API.md`    | PASS structurel  | statuts finaux et preuves opérateur                                       |
+| index `docs/000`, plans et validation           | PASS structurel  | candidate réconciliée sans publication stable prématurée                  |
+
+La tranche ne modifie aucun code/test/manifest de crate/dépendance et ne touche ni `CHANGELOG.md`, ni `ROADMAP.md`, ni le prompt `0.3.1`. Ces surfaces restent réservées à la préparation minimale de publication `pre.008`.
+
+Le gate opérateur de `pre.007` doit rester déterministe : audits, check, Clippy, tests ciblés Program/Logging et workspace suffisent ; aucun smoke live ni nouveau `cargo tree` n'est requis si l'overlay documentaire est appliqué exactement.
+