v0.2.1-pre.001-fix.001

deltas/0.2.1/pre.001-fix.001.md

@@ -0,0 +1,171 @@
+<!-- file: deltas/0.2.1/pre.001-fix.001.md -->
+<!-- version: 1 -->
+
+# Delta `0.2.1-pre.001-fix.001` — recalibrage du split HTTP et fusion possible de sessions
+
+## Base requise
+
+Livraison précédente :
+
+```text
+0.2.1-pre.001
+workspace.package.version = "0.2.1-pre.1"
+```
+
+Ce correctif est exclusivement documentaire. Il corrige le dimensionnement issu de `pre.001` avant toute implémentation fonctionnelle lourde de `ksp-onchain-transport-lib`.
+
+Le delta historique :
+
+```text
+deltas/0.2.1/pre.001.md
+```
+
+reste inchangé et continue de tracer le premier split décidé par `pre.001`.
+
+## Objectif
+
+Réduire le nombre de releases HTTP complémentaires sans diminuer la couverture exhaustive de la surface normative et préciser qu'une même session de chat peut clôturer plusieurs releases successives lorsque leur sizing réel le permet.
+
+Le correctif ne fusionne jamais les releases elles-mêmes : chaque release conserve son numéro, ses prereleases, son signal de version, ses deltas, ses validations et sa clôture stable propres.
+
+## Split HTTP corrigé
+
+Le premier split de `pre.001` était :
+
+```text
+0.2.1  foundation + 4 canaris
+0.2.2  Accounts + Tokens
+0.2.3  Transactions
+0.2.4  Blocks
+0.2.5  Cluster
+0.2.6  Economics + compliance finale
+```
+
+Il est remplacé pour l'exécution par :
+
+```text
+0.2.1  HTTP foundation + 4 canaris
+0.2.2  Accounts + Tokens + Cluster           22 méthodes
+0.2.3  Transactions                          11 méthodes
+0.2.4  Blocks + Economics + compliance       15 méthodes
+```
+
+La matrice reste exhaustive :
+
+```text
+4 + 22 + 11 + 15 = 52 méthodes HTTP courantes
+```
+
+Les 14 méthodes historiques de la section Deprecated restent présentes dans la matrice documentaire avec leur statut runtime déjà décidé par `pre.001`.
+
+Aucune méthode n'est supprimée ou masquée pour faire tenir le planning.
+
+## Règle de session précisée
+
+La règle KSP « une release concrète doit pouvoir être ouverte et clôturée dans une seule session » définit une borne maximale, pas une obligation de changer de chat après chaque release.
+
+Après clôture complète d'une release, la même session peut ouvrir puis clôturer la suivante si :
+
+- le gate de sizing de la release suivante reste raisonnablement positif ;
+- la release précédente est réellement clôturée avant l'ouverture de la suivante ;
+- versions, deltas, validations et critères de clôture restent séparés ;
+- aucune dette de validation n'est reportée implicitement sur la release suivante.
+
+Ainsi, `0.2.2`, `0.2.3` et `0.2.4` représentent **trois sessions nominales au maximum**, mais peuvent tenir dans deux sessions, voire être enchaînées plus rapidement si le travail réel le permet.
+
+## Séquence `0.2.x` recalibrée
+
+```text
+0.2.1  HTTP transport foundation + 4 canaris
+0.2.2  HTTP Accounts + Tokens + Cluster
+0.2.3  HTTP Transactions
+0.2.4  HTTP Blocks + Economics + compliance complète
+0.2.5  wallet foundation (.kspwallet)
+0.2.6  Wallet Desk
+0.2.7  standard Solana WebSocket
+0.2.8  Helius LaserStream WebSocket
+0.2.9  Yellowstone gRPC standard foundation
+0.2.10 off-chain price transport
+0.2.11 price visualization desk
+0.2.12 interface/wire foundation
+0.2.13 program-api foundation
+```
+
+Le plan historique `docs/plans/007-V0_2_0_SERIES_PLANNING.md` reste inchangé : il documente la planification telle qu'elle existait à la clôture de `0.2.0`. Le présent fix et les documents actifs portent la séquence courante.
+
+## Synchronisation documentaire
+
+Le correctif met à jour :
+
+- le roadmap et la séquence fonctionnelle ;
+- le plan actif `008` et sa matrice méthode -> release ;
+- les index documentaires ;
+- le prompt historique `006`, en conservant son rôle de trace d'ouverture ;
+- l'inventaire courant des composants ;
+- les références temporelles de `docs/IDEAS.md` devenues obsolètes après renumérotation.
+
+L'historique est explicite : `pre.001` garde son premier split `0.2.1`–`0.2.6`; ce `fix.001` porte le recalibrage `0.2.1`–`0.2.4`.
+
+## Fichiers modifiés
+
+```text
+ROADMAP.md
+docs/000-README.md
+docs/IDEAS.md
+docs/architecture/004-COMPONENT_INVENTORY.md
+docs/plans/000-README.md
+docs/plans/002-FUNCTIONAL_RELEASE_SEQUENCE.md
+docs/plans/008-V0_2_1_ONCHAIN_HTTP_PLAN.md
+prompts/006-V0_2_1_START_PROMPT.md
+```
+
+## Fichier ajouté
+
+```text
+deltas/0.2.1/pre.001-fix.001.md
+```
+
+## Fichiers volontairement inchangés
+
+```text
+Cargo.toml
+deltas/0.2.1/pre.001.md
+docs/plans/007-V0_2_0_SERIES_PLANNING.md
+```
+
+`pre.001.md` reste la trace immuable de la livraison initiale. Le plan `007` reste l'historique stable de `0.2.0`.
+
+## Version Cargo
+
+Aucune modification de `Cargo.toml`.
+
+Le correctif est documentaire uniquement ; `workspace.package.version` reste :
+
+```text
+0.2.1-pre.1
+```
+
+L'identifiant de livraison est :
+
+```text
+0.2.1-pre.001-fix.001
+```
+
+## Dépendances
+
+Aucune dépendance ajoutée ou modifiée.
+
+## Validations du correctif
+
+À la livraison du fix :
+
+- le delta historique `pre.001.md` doit conserver exactement son contenu ;
+- le plan `008` doit contenir 52 méthodes courantes réparties exactement en `4 / 22 / 11 / 15` sur `0.2.1 / 0.2.2 / 0.2.3 / 0.2.4` ;
+- aucune méthode courante ne doit rester affectée à `0.2.5` ou `0.2.6` ;
+- les 14 entrées Deprecated historiques doivent rester dans la matrice ;
+- Wallet doit être `0.2.5`, Wallet Desk `0.2.6`, WebSocket `0.2.7`, LaserStream `0.2.8`, Yellowstone `0.2.9` dans les documents actifs ;
+- l'enchaînement de plusieurs releases dans une même session doit être autorisé uniquement après clôture complète et nouveau sizing positif ;
+- `Cargo.toml` doit rester à `0.2.1-pre.1` ;
+- l'archive du fix doit être limitée aux huit fichiers modifiés et au nouveau delta.
+
+Aucune commande Cargo n'est requise spécifiquement pour ce correctif documentaire. Les validations Rust prévues pour `0.2.1-pre.002` et les frontières globales de release restent inchangées.