3.4 KiB
Delta 0.2.8-pre.007-fix.001 — déterminisme canaris heartbeat Tokio
1. Base et défaut corrigé
Base appliquée :
0.2.8-pre.7
Le checkpoint opérateur confirme que fmt, audit Rust et cargo check --workspace sont propres. Le gate reste toutefois bloqué par :
cargo clippy --workspace --all-targets
1 erreur clippy::implicit_return dans le helper test yield_runtime_steps
cargo test -p ksp-onchain-transport-lib
329/331 unit passent
2 échecs heartbeat test-only
Les autres canaris heartbeat, notamment policy Helius-only, absence sur standard, write failure/reconnect et réarmement après reconnexion, passent déjà. Aucun défaut runtime heartbeat n'est démontré.
2. Version technique
workspace.package.version = 0.2.8-pre.7.fix.1
commit attendu = v0.2.8-pre.007-fix.001
Git tag = aucun tag prerelease
Le header root Cargo.toml passe en version 228.
3. Correction implicit_return
Le helper privé test-only :
async fn yield_runtime_steps()
termine désormais par un return; explicite après sa boucle de yields. Aucun allow Clippy n'est introduit.
4. Armement déterministe du timer Tokio
Dans le canari 60 s, tokio::time::pause() était suivi immédiatement de advance(59 s). Rien ne garantissait alors que la tâche actor ait déjà été pollée et ait enregistré son sleep_until(heartbeat_deadline) sous l'horloge pausée.
Le fix insère un passage de stabilisation par yield_runtime_steps().await immédiatement après pause() et avant toute avance. Le canari vérifie ensuite toujours la vraie cadence runtime :
t=59 s aucun Ping
t=60 s un Ping
t=119 s aucun second Ping
t=120 s second Ping
Aucune cadence spéciale de test n'est créée.
5. Sémantique du canari close
Le canari close est renforcé en deux étapes :
t=30 s avant close -> observation channel obligatoirement Empty
après close -> aucun Ping `Ok(())` accepté
Après réception de la frame Close, le serveur fixture termine et détruit naturellement son sender. Le receiver peut donc rendre Disconnected, ce qui prouve toujours qu'aucun heartbeat n'a été émis après fermeture. Exiger uniquement Empty après close était une hypothèse incorrecte du test.
6. Runtime explicitement inchangé
Ce fix ne modifie pas :
crates/ksp-onchain-transport-lib/src/ws_session.rs
HELIUS_WS_HEARTBEAT_INTERVAL = 60 s
WebSocket Ping control frame
WsProtocolKind
WsSessionSettings
Config / schema / env
transactionSubscribe / transactionNotification lifecycle
reconnect / remap / backpressure
Il ne rajoute aucune dépendance ni feature.
7. Fichiers modifiés
Cargo.toml
crates/ksp-onchain-transport-lib/unit_tests/ws_session.rs
docs/plans/015-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET_PLAN.md
docs/validation/011-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET.md
deltas/0.2.8/pre.007-fix.001.md
8. Gate opérateur
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
Critère de fermeture : zéro warning, audit clean, 331 unit / 40 public API / 29 completeness / 4 doctests et workspace vert. pre.008 reste bloqué jusque-là.