<!-- 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`.