v0.3.11-pre.006

deltas/0.3.11/pre.006.md

@@ -0,0 +1,180 @@
+<!-- file: deltas/0.3.11/pre.006.md -->
+<!-- version: 1 -->
+
+# Delta `0.3.11-pre.006` — admission bornée et canonicalisation Common RAW
+
+## Base requise
+
+```text
+0.3.11-pre.005
+workspace.package.version = 0.3.11-pre.5
+```
+
+Le gate opérateur du 8 septembre 2026 est vert sur `fmt`, audits Rust/Markdown, `cargo check --workspace`, Clippy strict, les 18 tests de la crate Worker, doc-tests et les arbres Cargo normal/features.
+
+## Objectif
+
+Matérialiser uniquement la responsabilité `pre.006` du plan `032` : admission `mpsc` centrale bornée, backpressure async, ingress privé, canonicalisation via `ksp-raw-transaction-lib`, observation key Worker déterministe et assembly du `RawTransactionAcquisition`. Aucune persistence Store et aucune source réseau.
+
+## Version
+
+```text
+identifiant de livraison : 0.3.11-pre.006
+workspace.package.version : 0.3.11-pre.6
+```
+
+## Admission privée bornée
+
+Le supervisor crée un seul channel central dimensionné par `RawTransactionIngestSettings::admission_queue_capacity()` :
+
+```text
+tokio::sync::mpsc::channel(...)
+```
+
+Le seam source reçoit le sender `mpsc` borné et le signal de stop. Le contrat prouvé est :
+
+```text
+send().await pour le backpressure
+select! biased : stop avant send dans le harness source
+aucun unbounded_channel
+receiver close au shutdown
+```
+
+Au shutdown, le receiver ferme les nouvelles admissions et consume les entrées déjà en queue avant le join final des tâches enfants.
+
+## Ingress et Common RAW
+
+L'ingress crate-private, absent de l'API publique, transporte :
+
+```text
+RawTransactionMaterial
+RawNetworkId attendu
+RawAcquisitionProvenance
+source key opaque [u8; 32]
+```
+
+Le pipeline est :
+
+```text
+network guard
+ksp_raw_transaction_lib::canonicalize_raw_transaction(...)
+material network guard
+observation key Worker
+ksp_raw_transaction_lib::assemble_raw_transaction_acquisition(...)
+```
+
+Aucune canonicalisation RAW v1 n'est réimplémentée dans le Worker.
+
+## Observation key V1
+
+Domaine exact :
+
+```text
+ksp.raw_transaction_ingest.observation.v1\0
+```
+
+Le SHA-256 encode avec longueur `u64` big-endian :
+
+```text
+network
+signature
+source key
+```
+
+Golden harness :
+
+```text
+network : mainnet
+signature : 64 x 0x07
+source key : 32 x 0x09
+SHA-256 : f8d161dca8a8a72a0da110fc87882ee7136848461c6aa32b09e30a6188b95dcc
+```
+
+Aucun timestamp local, run id ou ordre d'admission ne participe à la clé.
+
+## Tests ajoutés ou étendus
+
+```text
+capacity=1 : second send bloqué jusqu'à consommation d'un slot
+stop : sender bloqué rejeté sans admission post-stop
+payload common RAW canonique exact
+format id/version exacts
+observation-key golden exact
+assembly transaction/provenance/reference exact
+mismatch network ingress/material rejetés sans fuite de valeurs
+dependency boundary : mpsc/common RAW requis, persistence/Transport/snapshot toujours interdits
+```
+
+## Fichiers ajoutés
+
+```text
+crates/ksp-worker-raw-transaction-ingest-lib/src/admission.rs
+crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/admission.rs
+deltas/0.3.11/pre.006.md
+```
+
+## Fichiers modifiés
+
+```text
+Cargo.toml
+crates/ksp-worker-raw-transaction-ingest-lib/src/lib.rs
+crates/ksp-worker-raw-transaction-ingest-lib/src/runtime.rs
+crates/ksp-worker-raw-transaction-ingest-lib/tests/dependency_boundary.rs
+crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/runtime.rs
+docs/plans/032-V0_3_11_RAW_TRANSACTION_INGEST_WORKER_FOUNDATION_PLAN.md
+docs/validation/028-V0_3_11_RAW_TRANSACTION_INGEST_WORKER_FOUNDATION.md
+```
+
+## Fichiers supprimés
+
+Aucun.
+
+## Hors scope conservé
+
+```text
+RawTransactionWrite / persistence Store
+RawTransactionAcquisitionMode::Normal
+persistence concurrency
+Store outcome mapping / idempotence / conflict
+snapshots concrets
+source live / Transport
+Config
+retry / reconnect / gap repair
+```
+
+## Validations exécutées dans l'environnement d'assemblage
+
+```text
+General Rust rule audit: clean
+Rust export completeness audit: 0 candidate(s)
+KSP workspace Rust rule audit: clean
+Markdown table audit: clean (340 table(s), 781 file(s))
+
+scan production : aucun ?, unwrap, expect, panic, unbounded_channel
+scan scope : aucune persistence Store, aucun Transport, aucun snapshot concret
+pipeline : exactement 1 mpsc::channel, 1 canonicalize_raw_transaction, 1 assemble_raw_transaction_acquisition
+observation golden indépendant : f8d161dca8a8a72a0da110fc87882ee7136848461c6aa32b09e30a6188b95dcc
+```
+
+L'environnement d'assemblage ne fournit ni `cargo`, ni `rustc`, ni `rustfmt`. Aucun gate Cargo de `pre.006` n'est déclaré PASS localement.
+
+## Gate opérateur demandé
+
+```bash
+cargo fmt --all
+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
+cargo check --workspace
+cargo clippy --workspace --all-targets --all-features -- -D warnings
+cargo test -p ksp-worker-raw-transaction-ingest-lib
+cargo tree -p ksp-worker-raw-transaction-ingest-lib --edges normal
+cargo tree -p ksp-worker-raw-transaction-ingest-lib -e features
+```
+
+## Décision
+
+`pre.007` reste bloquée jusqu'à validation opérateur verte de l'admission bornée, du backpressure, du golden observation et de l'assembly Common RAW.
+
+## Questions ouvertes
+
+Aucune nouvelle question architecturale. La persistence réelle et les outcomes Store restent dans `pre.007`, les snapshots dans `pre.008`, et le hardening fault/drain dans `pre.009`.