v0.2.8-pre.005-fix.002

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: 14 -->
+<!-- version: 15 -->
 
 # Plan `0.2.8` — Helius LaserStream WebSocket
 
-> **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`.**
+> **Statut : `pre.004` et ses deux fixes sont validés. `pre.005-fix.001` corrige les erreurs de type et la visibilité test/private, mais son checkpoint reste non fermable à cause de neuf warnings `dead_code` sur des helpers wire strictement privés qui n'ont pas encore de consommateur de production. `0.2.8-pre.005-fix.002` les borne à `#[cfg(test)]` jusqu'à leur consommation réelle par l'actor en `pre.006`, sans `allow(dead_code)` ni élargissement de visibilité.**
 
 ## 1. Objet, base et état courant
 
@@ -31,10 +31,11 @@ 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 ; fix requis après checkpoint
-pre.005-fix.001      correction types de canaris + visibilité/tests/règles préparée
+pre.005-fix.001      correction types de canaris + visibilité/tests/règles appliquée
+pre.005-fix.002      suppression warnings dead_code via cfg(test) des helpers wire préparée
 
-workspace.package.version courant = 0.2.8-pre.5.fix.1
-commit attendu                    = v0.2.8-pre.005-fix.001
+workspace.package.version courant = 0.2.8-pre.5.fix.2
+commit attendu                    = v0.2.8-pre.005-fix.002
 aucun tag prerelease
 ```
 
@@ -60,7 +61,8 @@ pre.004  DONE — Config V2 helius_laserstream + schema/fixtures + mapping Confi
          fix.002 DONE — provenance composée `DocumentLiteral` + `EnvironmentProcess` corrigée
 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
+         fix.001 APPLIED — assertions Vec<Value>/Value corrigées + helpers test-only privés + audit super/crate durci
+         fix.002 PREPARED — helpers wire non consommés en production bornés à #[cfg(test)] ; zéro allow/dead-code compensatoire
 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
@@ -1013,3 +1015,12 @@ 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.
+
+### Checkpoint `pre.005-fix.001` et correctif `pre.005-fix.002`
+
+Le checkpoint opérateur après `fix.001` confirme que les erreurs `Vec<Value>`/`Value` sont corrigées et que les tests Transport passent (`322` unit, `39` public API, `27` release completeness, `4` doctests). Il révèle toutefois neuf warnings `dead_code` pendant `cargo check`, `clippy` et la compilation des tests : deux sérialiseurs privés, cinq helpers de contrôle subscribe/unsubscribe et le helper d'insertion de listes.
+
+Ces éléments ne sont pas encore consommés par un chemin de production en `pre.005`; leur seul consommateur légitime est le sous-module `unit_tests` rattaché au module propriétaire. `fix.002` applique donc `RUST-API-008` : ils restent strictement privés et sont placés sous `#[cfg(test)]`. Le contrat public typed et ses validations restent compilés en production. Aucune visibilité n'est élargie, aucun `#[allow(dead_code)]` n'est ajouté et le wire préparé reste couvert par les mêmes canaris.
+
+Leur promotion éventuelle en code de production est différée à `pre.006`, exactement au moment où l'actor WebSocket les consommera réellement ; si cette promotion exige `pub(crate)`, elle suivra alors la façade crate-root et les appels `crate::Item`.
+