ruv
eab364bc51
docs: update user guide with MERIDIAN cross-environment adaptation
...
- Training pipeline: 8 phases → 10 phases (hardware norm + MERIDIAN)
- New section: Cross-Environment Adaptation explaining 10-second calibration
- Updated FAQ: accuracy answer mentions MERIDIAN
- Updated test count: 542+ → 700+
- Updated ADR count: 24 → 27
Co-Authored-By: claude-flow <ruv@ruv.net >
2026-03-01 12:16:25 -05:00
ruv
3febf72674
chore: bump all crates to v0.2.0 for MERIDIAN release
...
Workspace version 0.1.0 → 0.2.0. All internal cross-crate
dependencies updated to match.
Co-Authored-By: claude-flow <ruv@ruv.net >
2026-03-01 12:14:39 -05:00
ruv
8da6767273
fix: harden MERIDIAN modules from code review + security audit
...
- domain.rs: atomic instance counter for unique Linear weight seeds (C3)
- rapid_adapt.rs: adapt() returns Result instead of panicking (C5),
bounded calibration buffer with max_buffer_frames cap (F1-HIGH),
validate lora_rank >= 1 (F10)
- geometry.rs: 24-bit PRNG precision matching f32 mantissa (C2)
- virtual_aug.rs: guard against room_scale=0 division-by-zero (F6)
- signal/lib.rs: re-export AmplitudeStats from hardware_norm (W1)
- train/lib.rs: crate-root re-exports for all MERIDIAN types (W2)
All 201 tests pass (96 unit + 24 integration + 18 subcarrier +
10 metrics + 7 doctests + 105 signal + 10 validation + 1 signal doctest).
Co-Authored-By: claude-flow <ruv@ruv.net >
2026-03-01 12:11:56 -05:00
ruv
2d6dc66f7c
docs: update README, CHANGELOG, and associated ADRs for MERIDIAN
...
- CHANGELOG: add MERIDIAN (ADR-027) to Unreleased section
- README: add "Works Everywhere" to Intelligence features, update How It Works
- ADR-002: status → Superseded by ADR-016/017
- ADR-004: status → Partially realized by ADR-024, extended by ADR-027
- ADR-005: status → Partially realized by ADR-023, extended by ADR-027
- ADR-006: status → Partially realized by ADR-023, extended by ADR-027
Co-Authored-By: claude-flow <ruv@ruv.net >
2026-03-01 12:06:09 -05:00
ruv
0a30f7904d
feat: ADR-027 MERIDIAN — all 6 phases implemented (1,858 lines, 72 tests)
...
Phase 1: HardwareNormalizer (hardware_norm.rs, 399 lines, 14 tests)
- Catmull-Rom cubic interpolation: any subcarrier count → canonical 56
- Z-score normalization, phase unwrap + linear detrend
- Hardware detection: ESP32-S3, Intel 5300, Atheros, Generic
Phase 2: DomainFactorizer + GRL (domain.rs, 392 lines, 20 tests)
- PoseEncoder: Linear→LayerNorm→GELU→Linear (environment-invariant)
- EnvEncoder: GlobalMeanPool→Linear (environment-specific, discarded)
- GradientReversalLayer: identity forward, -lambda*grad backward
- AdversarialSchedule: sigmoidal lambda annealing 0→1
Phase 3: GeometryEncoder + FiLM (geometry.rs, 364 lines, 14 tests)
- FourierPositionalEncoding: 3D coords → 64-dim
- DeepSets: permutation-invariant AP position aggregation
- FilmLayer: Feature-wise Linear Modulation for zero-shot deployment
Phase 4: VirtualDomainAugmentor (virtual_aug.rs, 297 lines, 10 tests)
- Room scale, reflection coeff, virtual scatterers, noise injection
- Deterministic Xorshift64 RNG, 4x effective training diversity
Phase 5: RapidAdaptation (rapid_adapt.rs, 255 lines, 7 tests)
- 10-second unsupervised calibration via contrastive TTT + entropy min
- LoRA weight generation without pose labels
Phase 6: CrossDomainEvaluator (eval.rs, 151 lines, 7 tests)
- 6 metrics: in-domain/cross-domain/few-shot/cross-hw MPJPE,
domain gap ratio, adaptation speedup
All 72 MERIDIAN tests pass. Full workspace compiles clean.
Co-Authored-By: claude-flow <ruv@ruv.net >
2026-03-01 12:03:40 -05:00
ruv
b078190632
docs: add gap closure mapping for all proposed ADRs (002-011) to ADR-027
...
Maps every proposed-but-unimplemented ADR to MERIDIAN:
- Directly addressed: ADR-004 (HNSW fingerprinting), ADR-005 (SONA),
ADR-006 (GNN patterns)
- Superseded: ADR-002 (by ADR-016/017)
- Enabled: ADR-003 (cognitive containers), ADR-008 (consensus),
ADR-009 (WASM runtime)
- Independent: ADR-007 (PQC), ADR-010 (witness chains),
ADR-011 (proof-of-reality)
Co-Authored-By: claude-flow <ruv@ruv.net >
2026-03-01 11:51:32 -05:00
ruv
fdd2b2a486
feat: ADR-027 Project MERIDIAN — Cross-Environment Domain Generalization
...
Deep SOTA research into WiFi sensing domain gap problem (2024-2026).
Proposes 7-phase implementation: hardware normalization, domain-adversarial
training with gradient reversal, geometry-conditioned FiLM inference,
virtual environment augmentation, few-shot rapid adaptation, and
cross-domain evaluation protocol.
Cites 10 papers: PerceptAlign, AdaPose, Person-in-WiFi 3D (CVPR 2024),
DGSense, CAPC, X-Fi (ICLR 2025), AM-FM, LatentCSI, Ganin GRL, FiLM.
Addresses the single biggest deployment blocker: models trained in one
room lose 40-70% accuracy in another room. MERIDIAN adds ~12K params
(67K total, still fits ESP32) for cross-layout + cross-hardware
generalization with zero-shot and few-shot adaptation paths.
Co-Authored-By: claude-flow <ruv@ruv.net >
2026-03-01 11:49:16 -05:00
