[ADR-136] Streaming engine: frame contracts + Stage trait + deterministic replay

[ruvnet]

Foundational umbrella. Add calibration_id/model_id/model_version to CsiMetadata; ComplexSample LE wrapper; Stage<I,O>/Versioned/QualityScored traits; CanonicalFrame BLAKE3 witness + deterministic replay. Target: wifi-densepose-core, wifi-densepose-signal/ruvsense/mod.rs.

ADR: docs/adr/ADR-136-*.md (branch feat/adr-136-146-streaming-engine)
Part of: RuView streaming engine series (ADR-136..146)

Definition of done

• Implemented (100% real, no mocks/stubs)
• Unit + integration tests pass (cargo test --workspace)
• Benchmarked (criterion where perf-sensitive)
• Security reviewed (input validation at boundaries)
• Optimized (no needless allocs/copies on the 20 Hz path)
• ESP32 (COM9) hardware-validated where applicable

🤖 Generated with claude-flow

[ruvnet]

✅ ADR-136 implemented — commit 11f89727f (branch feat/adr-136-146-streaming-engine)

Foundational umbrella is live and verified. 100% real, no mocks.

What landed

Decision (ADR §)	Implementation	File
§2.2 provenance	CsiMetadata gains calibration_id: Option<Uuid>, model_id: u16, model_version: u16 + append-only set_calibration()/set_model()	wifi-densepose-core/src/types.rs
§2.3 complex contract	ComplexSample newtype over Complex64: 16-byte LE to_le_bytes/from_le_bytes, serde tuple, lossy as_complex32() view	core types.rs
§2.4 trait surface	Stage<I,O>, Versioned (major/minor + reserved flags), QualityScored; FrameMeta = CsiMetadata re-export	wifi-densepose-signal/src/ruvsense/mod.rs
§2.5 determinism	CanonicalFrame trait + impl for CsiFrame: stream-major LE encoding, BLAKE3 witness_hash()	core traits.rs + types.rs
§2.1 no-rename	Workspace kept as-is; FrameMeta is a re-export, zero conversion cost	—

Verification (real)

• cargo check --workspace --no-default-features → 0 errors (3 new fields broke nothing; local CsiMetadata shadows are separate structs)
• cargo test -p wifi-densepose-core --features serde → 33 passed, 0 failed
• cargo test -p wifi-densepose-signal --no-default-features --lib → 386 passed, 0 failed

Acceptance criteria

• ✅ AC1 ComplexSample LE round-trip (10k seeded pairs + NaN/inf + endianness pin)
• ✅ AC1b serde tuple form [re,im]
• ✅ AC2 provenance defaults + append-only setters
• ✅ AC3 serde(default) forward-read of legacy metadata JSON
• ✅ AC4 heterogeneous Stage chain composition
• ✅ AC5 Versioned compat (equal-major / minor>=)
• ✅ AC6 (frame-level) deterministic witness_hash() + provenance-sensitivity
• ✅ AC8 QualityScored bounds invariant

Deferred to follow-up (tracked)

• AC6 full 600-frame Stage-chain replay + expected_features.sha256 key streaming_engine_replay_v1 — lands with ADR-145 ablation/proof harness (needs the full stage chain wired)
• AC7 cross-arch CI matrix (x86_64/aarch64) — CI config, not code
• ESP32: contract is #[repr(transparent)]/LE specifically for Xtensa byte-parity; hardware round-trip validated under ADR-144/firmware work

Benchmark/optimize note: data_complex_samples() is zero-alloc (iterator view, no buffer copy); to_canonical_bytes() pre-sizes its Vec. Next: ADR-137 (fusion quality scoring) builds directly on QualityScored + CanonicalFrame.