v0.2.8-pre.005-fix.001

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: 13 -->
+<!-- version: 14 -->
 
 # Plan `0.2.8` — Helius LaserStream WebSocket
 
-> **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`.**
+> **Statut : `pre.004` et ses deux fixes sont validés. Le premier checkpoint de `0.2.8-pre.005` a révélé quatre erreurs de type dans les canaris JSON et une visibilité `pub(crate)` injustifiée pour des helpers utilisés uniquement par le module/tests. `0.2.8-pre.005-fix.001` est préparé pour corriger ces deux points et durcir l'audit des accès `super::PrivateItem` / `crate::VisibleItem`.**
 
 ## 1. Objet, base et état courant
 
@@ -30,10 +30,11 @@ pre.003              six familles standard Helius validées
 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é
+pre.005              contrat typed transactionSubscribe/unsubscribe ; fix requis après checkpoint
+pre.005-fix.001      correction types de canaris + visibilité/tests/règles préparée
 
-workspace.package.version courant = 0.2.8-pre.5
-commit attendu                    = v0.2.8-pre.005
+workspace.package.version courant = 0.2.8-pre.5.fix.1
+commit attendu                    = v0.2.8-pre.005-fix.001
 aucun tag prerelease
 ```
 
@@ -57,8 +58,9 @@ pre.004  DONE — Config V2 helius_laserstream + schema/fixtures + mapping Confi
          + 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
+pre.005  FIX REQUIRED — transactionSubscribe request typed + filters/options/tokenAccounts + transactionUnsubscribe
          + bounds 50k + maxSupportedTransactionVersion conditionnel ; live handle différé à pre.006
+         fix.001 PREPARED — assertions Vec<Value>/Value corrigées + helpers test-only privés + audit super/crate durci
 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
@@ -995,3 +997,19 @@ 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`.
+
+### Checkpoint `pre.005` et correctif `pre.005-fix.001`
+
+Le premier checkpoint opérateur de `pre.005` a donné :
+
+```text
+cargo fmt --all                                OK
+python3 scripts/audit_rust_workspace_rules.py  clean mais incomplet pour la règle test/private
+cargo check --workspace                        OK avec 5 warnings unused pub(crate) reexports
+cargo clippy --workspace --all-targets         FAIL — 4 comparaisons Vec<Value> / Value
+cargo test -p ksp-onchain-transport-lib        FAIL — mêmes 4 erreurs de type
+```
+
+Le correctif ne change ni le contrat Helius public ni le wire. Il applique la règle de visibilité KSP : un helper utilisé seulement par son module et son sous-module de tests reste strictement privé ; le test l'appelle via `super::Item`. Les éléments `pub` et `pub(crate)` restent réexportés et consommés via `crate::Item`. Les helpers transaction wire de `pre.005` ne deviendront `pub(crate)` qu'en `pre.006` si l'actor les consomme réellement.
+
+Le script `audit_rust_export_completeness.py` est étendu pour détecter dans les `unit_tests/` séparés les accès non qualifiés aux items privés du parent et les accès non canoniques aux items visibles.