v0.0.3-pre.004

This commit is contained in:
2026-08-14 09:51:30 +02:00
parent 544e0351b8
commit d33911f925
12 changed files with 776 additions and 67 deletions

View File

@@ -1,5 +1,5 @@
<!-- file: docs/plans/001-V0_0_3_PLAN.md -->
<!-- version: 7 -->
<!-- version: 8 -->
# Plan KSP 0.0.3
@@ -13,7 +13,7 @@ Transformer le brainstorming KSP en architecture, règles, inventaire et plan su
- `pre.002` — inventaire initial des composants ;
- `pre.003` — graphe de dépendances, correction de l'inventaire et stabilisation des frontières de composition.
La prochaine tranche prévue est `pre.004`, consacrée à Program/Wire/Execution.
La tranche `pre.004` est consacrée à Wire/Program. Execution/Policy est volontairement déplacé vers `pre.005` afin de garder des prereleases de planification bornées.
## Décisions structurantes actuelles
@@ -51,20 +51,32 @@ Livré :
- correction de `004-COMPONENT_INVENTORY.md` ;
- suppression des décisions négatives présentées à tort comme tâches du roadmap.
### `pre.004` — Programmes, wire et exécution
### `pre.004` — Wire et Program
Objectifs prévus :
Livré :
- détailler `ksp-interface-lib` ;
- détailler `ksp-program-api` et `ksp-program-lib` ;
- définir précisément decoder API et executor API ;
- définir le contrat d'opération préparée ;
- définir `ksp-execution-policy-api` ;
- détailler le cycle de `ksp-execution-lib` : préparation, policy, simulation, signature, envoi, confirmation ;
- cadrer conformité wire, historique/deprecated et policy supérieure ;
- vérifier que la tranche reste dans le budget de complexité, sinon la scinder.
- propriété et rôle de `ksp-interface-lib` ;
- propriété des codecs wire ;
- politique anti-doublons de générations et sélection/réimplémentation des interfaces externes ;
- API Program ouverte ;
- familles de decoders par capacité ;
- `ProgramExecutionPreparer` à la place d'un executor transactionnel ambigu ;
- statut lifecycle machine-readable pour les opérations anciennes/abandonnées ;
- registry extensible official + external ;
- organisation `domain -> program/protocol -> capability` ;
- workflow d'une implémentation externe avant intégration officielle.
### `pre.005` — Données, store et acquisitions
### `pre.005` — Execution et Policy
- détailler `ksp-execution-policy-api` ;
- détailler `ksp-execution-lib` ;
- consommer `PreparedProgramExecution` sans dépendre de `ksp-program-lib` ;
- définir les étapes policy, simulation, wallet/signature, transport/envoi, confirmation ;
- déterminer les policies de scenario Devnet vs produit général ;
- traiter erreurs/retry/confirmation et limites de responsabilité ;
- scinder à nouveau si la tranche devient trop dense.
### `pre.006` — Données, store et acquisitions
- détailler `ksp-materializer-api` / `ksp-materializer-lib` ;
- détailler `ksp-store-api` / `ksp-store-lib` ;
@@ -74,7 +86,7 @@ Objectifs prévus :
- cadrer les workers de processing ;
- revisiter niveaux durables, replay, provenance et idempotence.
### `pre.006` — Applications, workers, jobs, scenarios et pipelines spécialisés
### `pre.007` — Applications, workers, jobs, scenarios et pipelines spécialisés
- formaliser les apps spécialisées ;
- détailler `ksp-worker-control-lib` ;
@@ -83,14 +95,14 @@ Objectifs prévus :
- cadrer l'orchestrateur futur ;
- inventorier les pipelines spécialisés réellement nécessaires.
### `pre.007` — Plan des premières releases fonctionnelles
### `pre.008` — Plan des premières releases fonctionnelles
- transformer les séries `0.1.x+` en premières releases concrètes ;
- dimensionner chaque release concrète ;
- choisir la première release `0.1.N` ;
- transformer le brouillon de prompt en prompt quasi-final de cette release concrète.
### `pre.008` — Clôture fondatrice
### `pre.009` — Clôture fondatrice
- validations finales de cohérence ;
- documentation/nettoyage/archivage ;