v0.2.7-pre.011-fix.001

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

@@ -0,0 +1,99 @@
+<!-- file: deltas/0.2.7/pre.011-fix.001.md -->
+<!-- version: 1 -->
+
+# Delta `0.2.7-pre.011-fix.001` — rustdoc `SolanaSlotUpdate` + idée metering différée
+
+## Base
+
+Base directe publiée :
+
+```text
+0.2.7-pre.011
+Cargo 0.2.7-pre.11
+```
+
+La validation opérateur de `pre.011` confirme :
+
+- `cargo fmt --all` : vert ;
+- audit Python KSP : vert ;
+- `cargo check --workspace` : vert avec 19 warnings `missing_docs` dans `ws_cluster.rs` ;
+- `cargo clippy --workspace --all-targets` : vert avec les mêmes 19 warnings ;
+- `cargo test -p ksp-onchain-transport-lib` : 309 tests unitaires, 35 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 warnings concernent exclusivement les champs publics des variantes de `SolanaSlotUpdate` introduites par le lot unstable `slotsUpdatesSubscribe`.
+
+## Signal technique
+
+```text
+livraison                 = 0.2.7-pre.011-fix.001
+workspace.package.version = 0.2.7-pre.11.fix.1
+commit                    = v0.2.7-pre.011-fix.001
+```
+
+Aucun tag Git n'est requis pour ce fix de prerelease.
+
+## Correction Rust
+
+Chaque champ public des variantes suivantes reçoit une rustdoc adjacente et spécifique :
+
+```text
+FirstShredReceived
+Completed
+CreatedBank
+Frozen
+Dead
+OptimisticConfirmation
+Root
+Unknown
+```
+
+Les 19 warnings `missing_docs` doivent ainsi disparaître sans `allow`, sans changement de visibilité et sans modification du wire ou du comportement runtime.
+
+Aucune API publique n'est retirée ou ajoutée. Les wrappers `block`, `slotsUpdates` et `vote`, leurs DTOs, reconnect/resubscribe, backpressure et les warnings unstable restent sémantiquement identiques à `pre.011`.
+
+## Idée différée : mesure du trafic / metering
+
+`docs/IDEAS.md` enregistre une piste explicitement différée ; elle ne devient pas une tranche supplémentaire de `0.2.7`.
+
+Direction à étudier ultérieurement :
+
+- `ksp-onchain-transport-lib` reste le meilleur point de vérité pour les faits réellement observés à la frontière réseau, notamment volumes de payload, requêtes/réponses, notifications WebSocket, retries et reconnects ;
+- ces mesures restent neutres et ne portent aucun modèle de prix, crédit ou facturation fournisseur ;
+- le futur Store conserve les raw et pourra servir aux statistiques historiques sur les types de réponses, tailles, fréquences et distributions, mais ne reconstruit pas autoritairement les octets réellement transportés ;
+- une future crate dédiée, nom provisoire `ksp-metering-lib` ou `ksp-metering-observer-lib`, pourra observer et agréger ces données sans devenir un filtre obligatoire dans le data path ;
+- le nom, l'API, la granularité des événements et la relation exacte avec Store restent à déterminer avec les besoins réels.
+
+Aucune métrique nouvelle n'est introduite dans le runtime par ce fix.
+
+## Fichiers
+
+```text
+Cargo.toml
+crates/ksp-onchain-transport-lib/src/ws_cluster.rs
+docs/IDEAS.md
+deltas/0.2.7/pre.011-fix.001.md
+```
+
+`ROADMAP.md`, `CHANGELOG.md`, le plan `0.2.7` 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             = 309
+public API tests       = 35
+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.