v0.2.8-pre.007-fix.004
This commit is contained in:
@@ -1,9 +1,9 @@
|
||||
<!-- file: docs/plans/015-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET_PLAN.md -->
|
||||
<!-- version: 20 -->
|
||||
<!-- version: 21 -->
|
||||
|
||||
# Plan `0.2.8` — Helius LaserStream WebSocket
|
||||
|
||||
> **Statut : `0.2.8-pre.007-fix.002` passe fmt/audit/check/Clippy mais laisse le même unique canari périodique à 330/331. Le diagnostic est affiné : `yield_now()` ne garantit pas la progression du driver I/O OS sous horloge Tokio pausée. `0.2.8-pre.007-fix.003` conserve le runtime heartbeat byte-identical et borne la propagation TCP en temps réel après franchissement du deadline virtuel.**
|
||||
> **Statut : `0.2.8-pre.007-fix.003` ferme enfin le heartbeat Transport à 331/331, avec fmt/audit/check/Clippy verts. Le workspace révèle toutefois un canari de dépendances devenu obsolète : `ksp-core-lib/tests/workspace_dependencies.rs` attend encore l’ancienne déclaration Tokio dev `net, rt` alors que `pre.007` a ajouté `io-util, test-util` pour les tests d’horloge. `0.2.8-pre.007-fix.004` aligne ce canari workspace sans toucher au runtime heartbeat.**
|
||||
|
||||
## 1. Objet, base et état courant
|
||||
|
||||
@@ -37,10 +37,11 @@ pre.006 transactionNotification + lifecycle actor validé
|
||||
pre.007 heartbeat Helius WebSocket / idle — checkpoint gate à corriger
|
||||
pre.007-fix.001 lint + close canary corrigés ; un canari périodique reste non déterministe
|
||||
pre.007-fix.002 observation yield-only insuffisante — checkpoint 330/331
|
||||
pre.007-fix.003 progression I/O réelle bornée après deadline virtuel — préparé
|
||||
pre.007-fix.003 heartbeat Transport fermé ; workspace bloqué par canari Tokio dev obsolète
|
||||
pre.007-fix.004 alignement canari dependency-firewall Tokio dev — préparé
|
||||
|
||||
workspace.package.version courant = 0.2.8-pre.7.fix.3
|
||||
commit attendu = v0.2.8-pre.007-fix.003
|
||||
workspace.package.version courant = 0.2.8-pre.7.fix.4
|
||||
commit attendu = v0.2.8-pre.007-fix.004
|
||||
aucun tag prerelease
|
||||
```
|
||||
|
||||
@@ -70,9 +71,11 @@ pre.005 DONE — transactionSubscribe request typed + filters/options/tokenAcco
|
||||
fix.002 DONE — helpers wire non consommés en production bornés à #[cfg(test)] ; zéro warning dead_code
|
||||
pre.006 DONE — transactionNotification + handle live + actor registry/reconnect/resubscribe/unsubscribe races
|
||||
+ late notifications + backpressure ciblée, sans second actor/socket
|
||||
pre.007 CHECKPOINT — heartbeat Helius WebSocket/idle + timers + interaction reconnect/control frames/shutdown
|
||||
fix.001 CHECKPOINT — lint et close canary corrigés ; 330/331 unit, seul le canari périodique reste en course scheduler
|
||||
fix.002 PREPARED — observation positive du Ping bornée en scheduler steps, sans nouvelle avance du temps virtuel
|
||||
pre.007 FIX REQUIRED — heartbeat Helius WebSocket/idle + timers + interaction reconnect/control frames/shutdown
|
||||
fix.001 CHECKPOINT — lint et close canary corrigés ; 330/331 unit
|
||||
fix.002 CHECKPOINT — observation yield-only insuffisante ; 330/331 unit
|
||||
fix.003 CHECKPOINT — heartbeat Transport fermé à 331/331 ; workspace échoue sur canari Tokio dev obsolète
|
||||
fix.004 PREPARED — alignement exact du dependency-firewall sur `io-util, net, rt, test-util`
|
||||
pre.008 provider adversarial lifecycle + capability guards + payload/backpressure + security/redaction
|
||||
pre.009 compliance Helius WebSocket + non-régressions Solana standard 18/18 + HTTP 52/14
|
||||
+ Config/API/dependency-firewall canaries
|
||||
@@ -1276,3 +1279,38 @@ Cette fenêtre réelle ne peut pas masquer un heartbeat manquant : elle ne dure
|
||||
|
||||
Le runtime, Config, `WsSessionSettings`, le lifecycle transaction et la cadence 60 s restent inchangés. `pre.008` reste bloqué jusqu'au replay entièrement vert de `pre.007-fix.003`.
|
||||
|
||||
## 19. Replay `pre.007-fix.003` et préparation `pre.007-fix.004`
|
||||
|
||||
Checkpoint opérateur `0.2.8-pre.7.fix.3` reçu le 2026-08-23 :
|
||||
|
||||
```text
|
||||
[x] cargo fmt --all
|
||||
[x] python3 scripts/audit_rust_workspace_rules.py = clean / 0 candidate
|
||||
[x] cargo check --workspace = vert, sans warning
|
||||
[x] cargo clippy --workspace --all-targets = vert, sans warning
|
||||
[x] cargo test -p ksp-onchain-transport-lib = 331/331 unit + 40 API + 29 completeness + 4 doctests
|
||||
[!] cargo test --workspace = échec unique dans ksp-core-lib/tests/workspace_dependencies.rs
|
||||
```
|
||||
|
||||
Le heartbeat `pre.007` est donc fonctionnellement fermé côté Transport. L'échec workspace est indépendant du runtime :
|
||||
|
||||
```text
|
||||
transport_manifest_preserves_ksp_dependency_firewall
|
||||
attendu historique : tokio dev features = ["net", "rt"]
|
||||
manifest courant : tokio dev features = ["io-util", "net", "rt", "test-util"]
|
||||
```
|
||||
|
||||
`pre.007` a légitimement ajouté `test-util` pour `tokio::time::pause/advance` et `io-util` pour les fixtures WebSocket de test. Le canari workspace, resté textuellement figé sur l'ancien ensemble, n'a pas été mis à jour dans le delta d'origine.
|
||||
|
||||
`fix.004` corrige uniquement cette incohérence de validation :
|
||||
|
||||
```text
|
||||
- aucune modification de crates/ksp-onchain-transport-lib/Cargo.toml ;
|
||||
- aucune modification de src/ws_session.rs ni des canaris heartbeat ;
|
||||
- mise à jour du canari dependency-firewall vers l'ensemble dev exact courant
|
||||
["io-util", "net", "rt", "test-util"] ;
|
||||
- aucune nouvelle dépendance ni feature.
|
||||
```
|
||||
|
||||
`pre.008` reste bloqué jusqu'au replay workspace vert de `pre.007-fix.004`.
|
||||
|
||||
|
||||
@@ -1,9 +1,9 @@
|
||||
<!-- file: docs/validation/011-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET.md -->
|
||||
<!-- version: 19 -->
|
||||
<!-- version: 20 -->
|
||||
|
||||
# Validation `0.2.8` — Helius LaserStream WebSocket
|
||||
|
||||
> **Statut : `pre.007-fix.002` passe fmt/audit/check/Clippy mais reste à 330/331 sur le même canari périodique. `pre.007-fix.003` corrige le harness TCP/horloge pausée par une progression I/O réelle bornée après deadline virtuel, sans changement runtime heartbeat.**
|
||||
> **Statut : `pre.007-fix.003` est vert côté Transport à 331/331 + 40 API + 29 completeness + 4 doctests, mais `cargo test --workspace` échoue sur le canari `transport_manifest_preserves_ksp_dependency_firewall`, resté figé sur les anciennes features Tokio dev. `pre.007-fix.004` met ce canari en cohérence avec le manifest déjà livré, sans changement runtime.**
|
||||
|
||||
## 1. Références
|
||||
|
||||
@@ -28,6 +28,7 @@ pre.007 heartbeat Helius deltas/0.2.8/pre.007.md
|
||||
pre.007 test determinism fix deltas/0.2.8/pre.007-fix.001.md
|
||||
pre.007 scheduler observation fix deltas/0.2.8/pre.007-fix.002.md
|
||||
pre.007 paused-I/O observation fix deltas/0.2.8/pre.007-fix.003.md
|
||||
pre.007 dependency-firewall fix deltas/0.2.8/pre.007-fix.004.md
|
||||
validation standard WS docs/validation/010-V0_2_7_ONCHAIN_WEBSOCKET.md
|
||||
HTTP compliance docs/validation/007-V0_2_4_HTTP_FINAL_COMPLIANCE.md
|
||||
KSP-TRANSPORT-007 docs/validation/005-V0_2_3_KSP_TRANSPORT_007_RETRO_AUDIT.md
|
||||
@@ -788,3 +789,52 @@ Critères `pre.007-fix.003` :
|
||||
|
||||
Verdict courant : **`pre.007` FIX REQUIRED ; `fix.001` CHECKPOINT ; `fix.002` CHECKPOINT ; `fix.003` PREPARED ; `pre.008` bloqué.**
|
||||
|
||||
## 21. Replay `pre.007-fix.003` et gate `pre.007-fix.004`
|
||||
|
||||
Résultat opérateur `0.2.8-pre.7.fix.3` :
|
||||
|
||||
```text
|
||||
[x] cargo fmt --all
|
||||
[x] audit Rust workspace = clean / 0 candidate
|
||||
[x] cargo check --workspace = vert, sans warning
|
||||
[x] cargo clippy --workspace --all-targets = vert, sans warning
|
||||
[x] Transport unit = 331/331
|
||||
[x] Transport public API = 40/40
|
||||
[x] release completeness = 29/29
|
||||
[x] Transport doctests = 4/4
|
||||
[!] cargo test --workspace = 1 échec dependency-firewall dans ksp-core-lib
|
||||
```
|
||||
|
||||
Échec exact :
|
||||
|
||||
```text
|
||||
transport_manifest_preserves_ksp_dependency_firewall
|
||||
assertion attend encore :
|
||||
tokio = { workspace = true, features = ["net", "rt"] }
|
||||
|
||||
manifest Transport depuis pre.007 :
|
||||
tokio = { workspace = true, features = ["io-util", "net", "rt", "test-util"] }
|
||||
```
|
||||
|
||||
Le manifest courant est intentionnel : `test-util` permet les canaris d'horloge Tokio et `io-util` sert les fixtures I/O de test. Il n'y a ni nouvelle dépendance de production ni rupture du firewall KSP. Le défaut est donc le canari textuel non synchronisé lors de `pre.007`.
|
||||
|
||||
Critères `pre.007-fix.004` :
|
||||
|
||||
```text
|
||||
[ ] version workspace = 0.2.8-pre.7.fix.4
|
||||
[ ] crates/ksp-onchain-transport-lib/Cargo.toml inchangé
|
||||
[ ] src/ws_session.rs inchangé
|
||||
[ ] unit_tests/ws_session.rs inchangé
|
||||
[ ] canari dependency-firewall attend exactement io-util/net/rt/test-util
|
||||
[ ] liste des noms de dev-dependencies reste exactement [tokio]
|
||||
[ ] aucune nouvelle dépendance ou feature
|
||||
[ ] cargo fmt --all
|
||||
[ ] audit Rust = clean
|
||||
[ ] cargo check = sans warning
|
||||
[ ] cargo clippy = sans warning
|
||||
[ ] Transport = 331 unit + 40 public API + 29 completeness + 4 doctests
|
||||
[ ] cargo test --workspace = vert
|
||||
```
|
||||
|
||||
Verdict courant : **`pre.007` FIX REQUIRED ; `fix.001` CHECKPOINT ; `fix.002` CHECKPOINT ; `fix.003` CHECKPOINT Transport vert ; `fix.004` PREPARED ; `pre.008` bloqué.**
|
||||
|
||||
|
||||
Reference in New Issue
Block a user