# Delta `0.2.9-pre.006` — namespace privé HTTP explicite ## 1. Base requise ```text 0.2.9-pre.5.fix.1 ``` Le gate opérateur de `pre.005-fix.001` est intégralement vert : fmt, audit Rust, check, Clippy, Transport 364 unit + 45 public API + 38 release-completeness + 4 doctests, dependency canary Core 3/3 et workspace complet. ## 2. Objectif Réduire l'ambiguïté croissante dans `ksp-onchain-transport-lib` maintenant que HTTP, WebSocket et Yellowstone gRPC coexistent dans la même crate. Cinq modules privés sont exclusivement propriétaires de la pile HTTP et reçoivent un préfixe explicite : ```text client.rs -> http_client.rs executor.rs -> http_executor.rs pool.rs -> http_pool.rs resilience.rs -> http_resilience.rs settings.rs -> http_settings.rs ``` Les unit tests miroirs suivent exactement les mêmes renommages. ## 3. Frontière du renommage Le renommage n'est pas appliqué mécaniquement à tous les anciens modules. `rpc_accounts`, `rpc_blocks`, `rpc_transactions` et `rpc_common` portent déjà des DTOs/types Solana réutilisés par WebSocket et/ou gRPC. Le préfixe `http_` y serait donc architecturalement faux. Les autres `rpc_*` restent dans la même famille cohérente. `json_rpc` décrit une couche de protocole/enveloppe et conserve son nom. `constants` et `error` sont transverses à plusieurs transports et restent également inchangés. Aucun type ou nom public n'est renommé : les surfaces HTTP publiques utilisent déjà des noms `Http*` et restent réexportées depuis le crate root. ## 4. Forecast recalibré L'ancien `pre.006` fonctionnel est décalé afin de ne pas mélanger ce refactor de fichiers avec l'ajout Transactions/transaction_status. ```text pre.006 namespace privé HTTP explicite pre.007 Transactions + transaction_status pre.008 Blocks + block_meta + entry pre.009 bidi/backpressure/half-close/shutdown pre.010 reconnect/replay/gaps/duplicates pre.011 Config V3 + protocol/provider + profils PublicNode pre.012 PublicNode live + compliance + docs/prompt 0.2.10 rel.001 ``` Le contenu fonctionnel des tranches décalées ne change pas. ## 5. Fichiers ajoutés par renommage ```text crates/ksp-onchain-transport-lib/src/http_client.rs crates/ksp-onchain-transport-lib/src/http_executor.rs crates/ksp-onchain-transport-lib/src/http_pool.rs crates/ksp-onchain-transport-lib/src/http_resilience.rs crates/ksp-onchain-transport-lib/src/http_settings.rs crates/ksp-onchain-transport-lib/unit_tests/http_client.rs crates/ksp-onchain-transport-lib/unit_tests/http_executor.rs crates/ksp-onchain-transport-lib/unit_tests/http_pool.rs crates/ksp-onchain-transport-lib/unit_tests/http_resilience.rs crates/ksp-onchain-transport-lib/unit_tests/http_settings.rs ``` ## 6. Fichiers supprimés Un ZIP overlay ne peut pas supprimer ces chemins. L'opérateur doit donc les retirer explicitement après extraction : ```text crates/ksp-onchain-transport-lib/src/client.rs crates/ksp-onchain-transport-lib/src/executor.rs crates/ksp-onchain-transport-lib/src/pool.rs crates/ksp-onchain-transport-lib/src/resilience.rs crates/ksp-onchain-transport-lib/src/settings.rs crates/ksp-onchain-transport-lib/unit_tests/client.rs crates/ksp-onchain-transport-lib/unit_tests/executor.rs crates/ksp-onchain-transport-lib/unit_tests/pool.rs crates/ksp-onchain-transport-lib/unit_tests/resilience.rs crates/ksp-onchain-transport-lib/unit_tests/settings.rs ``` Commande opérateur : ```bash rm \ crates/ksp-onchain-transport-lib/src/{client,executor,pool,resilience,settings}.rs \ crates/ksp-onchain-transport-lib/unit_tests/{client,executor,pool,resilience,settings}.rs ``` ## 7. Fichiers modifiés ```text Cargo.toml crates/ksp-onchain-transport-lib/src/lib.rs crates/ksp-onchain-transport-lib/tests/release_completeness.rs docs/plans/016-V0_2_9_YELLOWSTONE_GRPC_PLAN.md docs/validation/012-V0_2_9_YELLOWSTONE_GRPC.md deltas/0.2.9/pre.006.md ``` `workspace.package.version` devient : ```text 0.2.9-pre.6 ``` ## 8. Canaries Le nouveau canari release-completeness vérifie : - les cinq déclarations privées `mod http_*` ; - l'absence des cinq anciennes déclarations ambiguës ; - la présence des types/fonctions HTTP structurants dans les nouveaux fichiers ; - le maintien volontaire des modules partagés/protocolaires `rpc_*`, `json_rpc`, `constants`, `error` ; - l'absence de changement de surface publique requise par ce refactor. ## 9. Documentation Markdown Les tableaux touchés dans `016` et `012` sont reformattés selon le comportement JetBrains RustRover : largeur de chaque colonne basée sur son contenu le plus large, puis exactement un espace de padding de part et d'autre du contenu avant les pipes. ## 10. Validations exécutées lors de la préparation ```text python3 scripts/audit_rust_workspace_rules.py General Rust rule audit: clean Rust export completeness audit: 0 candidate(s) KSP workspace Rust rule audit: clean ``` Contrôles statiques supplémentaires : ```text 5 nouveaux modules HTTP source présents 5 nouveaux unit tests miroirs présents 5 anciens modules source absents du worktree final 5 anciens unit tests absents du worktree final aucun renommage des modules rpc_* partagés aucun changement de dépendance Cargo aucune modification de public_api.rs ``` ## 11. Validations non exécutées dans l'environnement de préparation Cargo/Rust ne sont pas disponibles dans l'environnement de préparation. L'opérateur doit exécuter après extraction **et suppression des anciens chemins** : ```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 -p ksp-core-lib --test workspace_dependencies cargo test --workspace ``` Aucun `cargo tree` n'est requis : aucune dépendance ni feature ne change. ## 12. Verdict `pre.006` est une candidate structurelle sans changement fonctionnel ni API publique. Sa fermeture exige l'absence effective des dix anciens chemins et un gate Cargo intégralement vert.