v0.2.7-pre.010-fix.001

deltas/0.2.7/pre.010-fix.001.md

@@ -0,0 +1,98 @@
+<!-- file: deltas/0.2.7/pre.010-fix.001.md -->
+<!-- version: 1 -->
+
+# Delta `0.2.7-pre.010-fix.001` — suppression du helper WebSocket interne devenu mort
+
+## Base
+
+Base directe publiée :
+
+```text
+0.2.7-pre.010
+Cargo 0.2.7-pre.10
+```
+
+La validation opérateur de `pre.010` confirme :
+
+- `cargo fmt --all` : vert ;
+- audit Python KSP : vert ;
+- `cargo check --workspace` : vert avec deux warnings Transport ;
+- `cargo clippy --workspace --all-targets` : vert avec les mêmes deux warnings ;
+- `cargo test -p ksp-onchain-transport-lib` : 300 tests unitaires, 34 tests d'API publique et 22 tests de release completeness verts ;
+- `cargo test --workspace` : vert, avec les mêmes warnings répétés lors de la compilation de Transport.
+
+Les deux warnings concernent exclusivement `typed_notification_channel`, helper crate-private désormais remplacé par `typed_notification_channel_with_completion` depuis l'introduction de la terminaison one-shot de `signatureSubscribe`.
+
+## Signal technique
+
+```text
+livraison                 = 0.2.7-pre.010-fix.001
+workspace.package.version = 0.2.7-pre.10.fix.1
+commit                    = v0.2.7-pre.010-fix.001
+```
+
+Aucun tag Git n'est requis pour ce fix de prerelease.
+
+## Diagnostic
+
+`pre.010` a généralisé le constructeur de canal typed afin que le dispatcher puisse distinguer une notification normale d'une notification terminale :
+
+```text
+typed_notification_channel_with_completion(...)
+```
+
+Le helper historique :
+
+```text
+typed_notification_channel(...)
+```
+
+n'a alors plus aucun callsite. Son re-export crate-private dans `lib.rs` est lui aussi devenu inutilisé. Rust signale donc :
+
+```text
+unused import: self::ws_subscription::typed_notification_channel
+function typed_notification_channel is never used
+```
+
+## Correction
+
+Le fix supprime uniquement :
+
+- le re-export crate-private `typed_notification_channel` depuis `lib.rs` ;
+- la fonction wrapper crate-private `typed_notification_channel` depuis `ws_subscription.rs`.
+
+`typed_notification_channel_with_completion` reste l'unique constructeur interne. Pour les subscriptions continues, `WsSession::subscribe_typed` lui fournit déjà une classification terminale constamment fausse ; pour `signatureSubscribe`, le wrapper fournit sa classification one-shot dédiée.
+
+Aucune API publique, aucun DTO, aucun wire format, aucun comportement de reconnect/resubscribe/backpressure et aucune sémantique HTTP ou WebSocket ne changent.
+
+## Fichiers
+
+```text
+Cargo.toml
+crates/ksp-onchain-transport-lib/src/lib.rs
+crates/ksp-onchain-transport-lib/src/ws_subscription.rs
+deltas/0.2.7/pre.010-fix.001.md
+```
+
+`ROADMAP.md`, `CHANGELOG.md`, le plan et le document de validation restent inchangés.
+
+## Validation attendue
+
+```bash
+cargo fmt --all
+python3 scripts/audit_rust_workspace_rules.py
+cargo check --workspace
+cargo clippy --workspace --all-targets
+cargo test -p ksp-onchain-transport-lib
+cargo test --workspace
+```
+
+Comptages Transport attendus :
+
+```text
+unit tests             = 300
+public API tests       = 34
+release completeness   = 22
+```
+
+Les validations Cargo doivent être exécutées par l'opérateur ; elles ne sont pas revendiquées depuis l'environnement de préparation du delta.