3.4 KiB
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<serde_json::Value> 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<Value> explicites :
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 :
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 :
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 :
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
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
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
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.