99 lines
3.1 KiB
Markdown
99 lines
3.1 KiB
Markdown
<!-- 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.
|