# Delta `0.2.8-pre.005-fix.001` — canaris JSON, visibilité test/private et audit des chemins ## 1. Cause Le checkpoint opérateur de `pre.005` compile le workspace normal mais échoue dès la compilation des tests Transport. Quatre assertions comparent un `Vec` produit par les encodeurs de params à un `serde_json::Value` construit par `serde_json::json!([...])`, ce qui produit `E0277`. Le même checkpoint révèle cinq warnings `unused import` au crate-root : cinq helpers Helius avaient été rendus `pub(crate)` et réexportés uniquement pour être appelés par les tests. Cette visibilité est contraire aux règles KSP : une visibilité n'est pas élargie pour les tests. ## 2. Correction des canaris Les attentes de params utilisent maintenant des `Vec` explicites : ```text transactionSubscribe complet omission complète états []/none explicites transactionUnsubscribe [remote_id] ``` Le wire attendu ne change pas. ## 3. Correction de visibilité Les helpers suivants redeviennent strictement privés au module `ws_helius_transactions` : ```text helius_transaction_subscribe_params helius_transaction_subscribe_method helius_transaction_unsubscribe_method decode_helius_transaction_subscribe_result helius_transaction_unsubscribe_params decode_helius_transaction_unsubscribe_result ``` Les cinq réexports `pub(crate)` de `lib.rs` sont supprimés. Les tests séparés y accèdent via `super::...`. Aucun `#[allow(dead_code)]` n'est conservé pour masquer une visibilité prématurée. Les types réellement publics de `pre.005` restent réexportés au crate-root et les tests continuent à les consommer via `crate::Item`. En `pre.006`, si un helper devient réellement partagé entre modules de production, il pourra être promu en `pub(crate)`, réexporté au crate-root et consommé via `crate::Item` conformément aux règles. ## 4. Durcissement des règles et de l'audit `RULES_RUST.md` explicite désormais : ```text private parent dans unit_tests -> super::Item obligatoire pub/pub(crate) -> crate::Item obligatoire, jamais super:: ni nom nu visibilité -> jamais élargie uniquement pour tester ``` `audit_rust_export_completeness.py` ajoute des canaris mécaniques bidirectionnels pour les fichiers `unit_tests/` rattachés : ```text RUST-IMPORT-204 private parent appelé sans super:: RUST-IMPORT-205 visible parent appelé sans crate-root RUST-IMPORT-202 visible parent appelé via super:: (déjà présent) ``` ## 5. Version ```text workspace.package.version = 0.2.8-pre.5.fix.1 commit attendu = v0.2.8-pre.005-fix.001 tag prerelease = aucun ``` ## 6. Fichiers modifiés ```text Cargo.toml crates/ksp-onchain-transport-lib/src/lib.rs crates/ksp-onchain-transport-lib/src/ws_helius_transactions.rs crates/ksp-onchain-transport-lib/unit_tests/ws_helius_transactions.rs scripts/audit_rust_export_completeness.py docs/rules/RULES_RUST.md 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.005-fix.001.md ``` ## 7. Gate opérateur ```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 ``` Le fix reste `PREPARED` jusqu'à ce gate.