v0.3.15-pre.004

deltas/0.3.15/pre.004.md

@@ -0,0 +1,63 @@
+<!-- file: deltas/0.3.15/pre.004.md -->
+<!-- version: 1 -->
+
+# Delta v0.3.15-pre.004 — Worker WebSocket capability enforcement
+
+## Objet
+
+Fermer le gap Worker identifié en `pre.001` puis rendu exprimable par Transport `pre.002` et Config `pre.003` : une source WebSocket live ne doit plus être constructible si l'endpoint n'annonce pas explicitement la famille de subscription requise.
+
+## Changements
+
+- bump workspace `0.3.15-pre.3` -> `0.3.15-pre.4` ;
+- `RawTransactionIngestStandardLogsSource::new(...)` exige `WsSubscriptionKind::Logs` ;
+- `RawTransactionIngestStandardBlockSource::new(...)` exige `WsSubscriptionKind::Block` ;
+- `RawTransactionIngestHeliusTransactionSource::new(...)` exige `WsSubscriptionKind::HeliusTransaction` ;
+- l'enforcement s'appuie exclusivement sur `WsEndpointSettings::supports_subscription(...)` et n'infère rien depuis le provider ;
+- la validation protocole reste antérieure au contrôle capability ;
+- l'état legacy `subscription_capabilities = None` échoue donc fail-closed dans ces constructeurs Worker ;
+- Yellowstone et HTTP Block Polling restent inchangés, n'étant pas des sources WS ;
+- les fixtures historiques Worker déclarent maintenant explicitement les capabilities Transport qu'elles simulent ;
+- ajout de canaris unitaires, hardening et release-completeness, sans nouvelle surface publique ni dépendance.
+
+## Frontières préservées
+
+- aucune dépendance `ksp-config-lib` dans le Worker ;
+- aucune branche sur un provider/tier pour décider d'une capability ;
+- aucune I/O réseau pendant la construction des routes ;
+- aucune nouvelle API publique Worker ;
+- aucun changement Store, Config ou Desk ;
+- aucune implémentation du scaffold applicatif avant `pre.005`.
+
+## Validation d'assemblage
+
+À l'assemblage sans toolchain Rust/Cargo disponible :
+
+```text
+python3 scripts/audit_rust_workspace_rules.py
+python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas/0.3.15
+```
+
+Résultat :
+
+```text
+General Rust rule audit: clean
+Rust export completeness audit: 0 candidate(s)
+KSP workspace Rust rule audit: clean
+Markdown table audit: clean (318 table(s), 189 file(s))
+```
+
+Les gates Cargo restent à exécuter sur le poste opérateur. La baseline `pre.003` fournie par l'opérateur est entièrement PASS, y compris `cargo test --workspace --all-targets --all-features`.
+
+## Gate opérateur attendu
+
+```bash
+cargo fmt --all
+cargo fmt --all -- --check
+python3 scripts/audit_rust_workspace_rules.py
+python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas/0.3.15
+cargo check --workspace
+cargo clippy --workspace --all-targets --all-features -- -D warnings
+cargo test -p ksp-worker-raw-transaction-ingest-lib --all-targets --all-features
+cargo test --workspace --all-targets --all-features
+```