96 lines
3.4 KiB
Markdown
96 lines
3.4 KiB
Markdown
<!-- file: deltas/0.2.8/pre.005-fix.001.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# 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 :
|
|
|
|
```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.
|