v0.2.8-pre.005

docs/plans/015-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET_PLAN.md

@@ -1,9 +1,9 @@
 <!-- file: docs/plans/015-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET_PLAN.md -->
-<!-- version: 12 -->
+<!-- version: 13 -->
 
 # Plan `0.2.8` — Helius LaserStream WebSocket
 
-> **Statut : `0.2.8-pre.003` est validé ; `pre.004` est fonctionnellement implémenté mais son gate Config a nécessité deux corrections de canari. `pre.004-fix.001` a corrigé la redaction segmentaire et ajouté Devnet ; son checkpoint a ensuite révélé une seconde hypothèse de test erronée sur la provenance d'une chaîne composée. `pre.004-fix.002` corrige uniquement cette cardinalité/provenance et reste préparé.** Le runtime Config/Transport, les profils mainnet/devnet, le schema et le mapping Helius restent inchangés.
+> **Statut : `pre.004` et ses deux fixes sont validés par checkpoint opérateur complet. `0.2.8-pre.005` est préparé : contrat typed `transactionSubscribe`, filtres/options Helius, `tokenAccounts`, limites 50k et wire `transactionUnsubscribe`, sans exposer encore de handle transaction avant l'intégration actor de `pre.006`.**
 
 ## 1. Objet, base et état courant
 
@@ -27,12 +27,13 @@ pre.001-fix.002      forecast compact + namespace LaserStream WS/gRPC
 pre.002              socle protocolaire validé
 pre.002-fix.001      correction Clippy + normalisation structure documentaire validées
 pre.003              six familles standard Helius validées
-pre.004              Config V2 Helius implémenté ; checkpoint bloqué par un faux négatif de test
-pre.004-fix.001      correction safe_value + couverture Devnet Helius ; checkpoint bloqué par provenance
-pre.004-fix.002      correction du canari de provenance composée préparée
+pre.004              Config V2 Helius validé
+pre.004-fix.001      redaction segmentaire + couverture Devnet Helius validées
+pre.004-fix.002      provenance composée validée
+pre.005              contrat typed transactionSubscribe/unsubscribe préparé
 
-workspace.package.version courant = 0.2.8-pre.4.fix.2
-commit attendu                    = v0.2.8-pre.004-fix.002
+workspace.package.version courant = 0.2.8-pre.5
+commit attendu                    = v0.2.8-pre.005
 aucun tag prerelease
 ```
 
@@ -52,14 +53,12 @@ pre.002  DONE — socle protocolaire : WsProtocolKind::HeliusLaserStream + faça
          fix.001 DONE — correction Clippy `implicit_return` + audit/normalisation structure docs
 pre.003  DONE — surface Helius standard supportée : account/logs/program/root/signature/slot
          + absence typée de block/slotsUpdates/vote sur Helius + non-régression standard 9/9
-pre.004  CHECKPOINT — Config V2 helius_laserstream + schema/fixtures + mapping Config -> Transport
-         + stratégie de secret Helius et redaction URL ; runtime/check/clippy/Transport verts
-         fix.001 CHECKPOINT — redaction segmentaire corrigée + représentation Devnet Helius ajoutée
-         + gate Config bloqué uniquement par une attente de provenance `1` au lieu de `2`
-         fix.002 PREPARED — provenance composée attend `DocumentLiteral` + `EnvironmentProcess`
-         + aucun changement runtime/schema/fixture/profil
-pre.005  transactionSubscribe request typed + filters/options/tokenAccounts + transactionUnsubscribe
-         + bounds 50k + maxSupportedTransactionVersion conditionnel
+pre.004  DONE — Config V2 helius_laserstream + schema/fixtures + mapping Config -> Transport
+         + secret/redaction Helius mainnet/devnet validés
+         fix.001 DONE — redaction segmentaire corrigée + représentation Devnet Helius ajoutée
+         fix.002 DONE — provenance composée `DocumentLiteral` + `EnvironmentProcess` corrigée
+pre.005  PREPARED — transactionSubscribe request typed + filters/options/tokenAccounts + transactionUnsubscribe
+         + bounds 50k + maxSupportedTransactionVersion conditionnel ; live handle différé à pre.006
 pre.006  transactionNotification + actor integration + reconnect/resubscribe/unsubscribe races
          + late notifications + backpressure ciblée
 pre.007  heartbeat Helius WebSocket/idle + timers + interaction reconnect/control frames/shutdown
@@ -897,7 +896,7 @@ validation finale fermée
 prompt 0.2.9 prêt
 ```
 
-## 13. Checkpoints `pre.004`, `fix.001` et `fix.002`
+## 13. Checkpoints `pre.004`, fixes et préparation `pre.005`
 
 Le checkpoint `pre.003` est fermé par preuve opérateur :
 
@@ -962,16 +961,37 @@ provenance attendue = 1 segment
 
 Pour une URL composée `littéral + ${KSP_SECRET_HELIUS_API_KEY}`, le contrat Config enregistre correctement deux provenances ordonnées : `DocumentLiteral`, puis `EnvironmentProcess(KSP_SECRET_HELIUS_API_KEY)`. `pre.004-fix.002` corrige seulement cette attente pour mainnet et devnet ; aucune donnée Config ni logique runtime n'est modifiée.
 
-Le checkpoint à rejouer avant de déclarer `pre.004` + `fix.001` + `fix.002` `DONE` est :
+Le checkpoint opérateur reçu après `pre.004-fix.002` ferme cette tranche :
 
-```bash
-cargo fmt --all
-python3 scripts/audit_rust_workspace_rules.py
-cargo check --workspace
-cargo clippy --workspace --all-targets
-cargo test -p ksp-config-lib
-cargo test -p ksp-onchain-transport-lib
-cargo test --workspace
+```text
+cargo fmt --all                                OK
+python3 scripts/audit_rust_workspace_rules.py  clean
+cargo check --workspace                        OK
+cargo clippy --workspace --all-targets         OK
+cargo test -p ksp-config-lib                   OK 110/110 + ownership/public API
+cargo test -p ksp-onchain-transport-lib        OK 314 unit + 38 public + 26 completeness + 4 doctests
+cargo test --workspace                         OK
 ```
 
-Si ce checkpoint est vert, `pre.004` et ses deux fixes peuvent être fermés, puis `pre.005` peut ouvrir la requête typed `transactionSubscribe` / `transactionUnsubscribe`, ses filtres/options et validations déterministes.
+Les profils Helius mainnet/devnet, la redaction segmentaire, la provenance composée, le mapping Config -> Transport et l'absence de nouvelle dépendance sont donc acquis avant `pre.005`.
+
+`pre.005` prépare maintenant :
+
+```text
+HeliusTransactionSubscribeFilter       vote/failed/signature/accountInclude/accountExclude/accountRequired/tokenAccounts
+HeliusTokenAccountsFilter              none / balanceChanged / all
+HeliusTransactionSubscribeOptions      commitment/encoding/transactionDetails/showRewards/maxSupportedTransactionVersion
+HeliusTransactionSubscribeRequest      validation déterministe + params exacts
+accountInclude/Exclude/Required        <= 50_000 chacun
+transactionDetails accounts/full       maxSupportedTransactionVersion obligatoire
+transactionSubscribe ack               remote id numérique décodé en interne
+transactionUnsubscribe                 méthode/params/résultat bool exacts
+Debug filtre/request                    signature et valeurs d'adresses non rendues
+actor/socket                            chemin physique existant réutilisé dans fixture locale
+live transaction handle                volontairement absent jusqu'à pre.006
+transactionNotification                toujours hors scope pre.005
+heartbeat                              toujours hors scope pre.005
+new dependency                         aucune
+```
+
+La séparation `pre.005` / `pre.006` est normative : publier dès maintenant un `transaction_subscribe()` public sans registry de notification/reconnect produirait un handle transitoire qui perdrait les notifications. Le contrat public de requête est donc stable dès `pre.005`, tandis que l'abonnement live est ajouté atomiquement avec l'actor integration en `pre.006`.