ESP32-S3 deploy v2: gain-lock + NBVI + persistent baseline + auto-recalibrate + complex CSI + REST + drift channel (ADR-100..108, 110)

.gitignore

@@ -258,3 +258,12 @@ v2/crates/rvcsi-node/*.node
 v2/crates/rvcsi-node/binding.js
 v2/crates/rvcsi-node/binding.d.ts
 v2/crates/rvcsi-node/npm/
+
+# ADR-117/118/119/120: deployment-specific training artifacts.
+# - recordings/ are large (175 MB each) and room/operator-specific
+# - adaptive_model.json is regenerated by `POST /api/v1/adaptive/train`
+# - baseline.json is regenerated by `POST /api/v1/baseline/calibrate`
+v2/data/recordings/
+v2/data/adaptive_model.json
+v2/data/baseline.json
+.claude/launch.json

CHECKLIST.md

@@ -0,0 +1,199 @@
+# RuView · Implementation Checklist
+
+Single source of truth for what's shipped and what's open. Updated
+at the end of every session. Pair with
+[`docs/references/espectre-gap-analysis.md`](docs/references/espectre-gap-analysis.md)
+for the technical detail behind each line.
+
+Last sweep: **2026-05-18**, branch `feat/ota-rssi-mobile`, head `12e1cf9d`.
+Status: **50 Done / 0 Open in-scope**. Deferred listed at the bottom.
+
+ADR-100..114 carry-in from the prior agent; ADR-115..120 are this
+session. ADR-111 intentionally absent (folded into ADR-109).
+
+Adaptive classifier accuracy trajectory this session — full detail in
+ADR-118/119/120:
+
+| Stage | Acc |
+|---|---|
+| 2-node, 15-feat LogReg (baseline) | 40.4% |
+| 6-node, 15-feat LogReg | 44.4% |
+| 6-node, 22-feat LogReg (ADR-118) | 49.58% |
+| 6-node, 22-feat MLP (ADR-119) | 53.53% |
+| 6-node, 22-feat W-MLP (ADR-120) | **90.40%** (training-set) |
+
+W-MLP 90.40% is training-set accuracy; held-out test + cleaner
+per-class re-records are the recommended next step.
+
+---
+
+## ✅ Done
+
+### Server (`v2/crates/wifi-densepose-sensing-server`)
+
+- [x] **ADR-100** PHY gain-lock (AGC + FFT freeze, ESPectre port) — FW
+- [x] **ADR-101** Raw-amplitude classifier (CV + baseline drop, hysteresis)
+- [x] **ADR-101** Per-node classification badges in WS payload
+- [x] **ADR-102** NBVI subcarrier selection (formula α=0.5, top-12)
+- [x] **ADR-102** NBVI Step 1 quiet-window finder
+- [x] **ADR-103** Persistent baseline at `data/baseline.json` (FULL broadband)
+- [x] **ADR-103** Universal threshold via baseline-CV normalization
+- [x] **ADR-104** Per-subcarrier drift channel (off-axis presence)
+- [x] **ADR-104** NBVI Step 3 FP-rate validation (K ∈ {6,8,10,12,16,20})
+- [x] **ADR-104** Per-sub drift exposed in WS `node_features[].drift_score`
+      + raw.html sparkline per node (commit eec3ca6c)
+- [x] **ADR-104** Baseline staleness watch — warn when on-disk baseline
+      > 4 h old AND drift consistently fires during `absent` periods
+      (commit eec3ca6c)
+- [x] **ADR-105** Drop all synthetic data from runtime
+  ([signal_field, pose_keypoints, persons, fake confidence — all gated)
+- [x] **ADR-105** `n_aps_used: u8` uniform field on `enhanced_motion` +
+      `enhanced_breathing` (commit 598a4b2f)
+- [x] **ADR-106** Full complex CSI in WS (`amplitude` + `phases` + meta)
+- [x] **ADR-106** Built-in CSI keepalive (managed `ping` per sensor)
+- [x] **ADR-106** Server-side µs `timestamp_us`
+- [x] **ADR-107** `POST /api/v1/baseline/calibrate` + UI button
+- [x] **ADR-107** Auto-recalibrate on long-quiet periods (30 min default)
+- [x] **ADR-107** `GET /api/v1/baseline` (status + cooldown)
+- [x] **ADR-107** Progress bar in raw.html calibrate button
+      (commit 432753e1)
+- [x] **ADR-112** Multi-AP `signal_field` via `MultistaticFuser` —
+      coverage × activity heatmap, non-zero only with ≥2 nodes +
+      positions; preserves ADR-105 zero-grid otherwise (commit c8ac60f6)
+- [x] **ADR-105** Hide pose canvas in Docker SPA when
+      `model_loaded == false` + "no trained model" overlay
+      (commit 2dcb30a6)
+- [x] **ADR-104** Phase-domain drift channel — script + server both
+      compute per-subcarrier circular mean/var; `phase_drift_score`
+      surfaced on `PerNodeFeatureInfo` (commit 47dafab4)
+- [x] **ADR-113** Day/night baseline profiles with hot-reload
+      (`--baseline-profile {single,auto,day,night}`) (commit a1e09525)
+- [x] **ADR-114** 2000-packet replay regression suite (1000 idle +
+      1000 motion synthetic-but-parameter-matched, F1 ≥ 0.85
+      threshold) (commit 96225e27)
+
+### Firmware (`firmware/esp32-csi-node`)
+
+- [x] **ADR-100** Gain-lock (300-packet median, MIN_SAFE_AGC=30 safety)
+- [x] **ADR-106** Sensor µs timestamp in CSI trailer (`rx_ctrl.timestamp`)
+- [x] **ADR-108** NVS persistence of gain-lock — reboot ready in ~0.5 s
+- [x] **ADR-109** `POST /ota/recalibrate` — clear gain-lock NVS via REST,
+      no USB needed (commit f92807cd)
+- [x] **ADR-109** Track AP MAC in `gl_ap_mac` NVS — auto-invalidate
+      stale gain-lock on AP swap (commit f92807cd)
+- [x] **ADR-115** `POST /ota/set-target` — repoint CSI aggregator
+      (`csi_cfg/target_ip` + `target_port`) without USB; recovered
+      both nodes after Mac IP move TP-Link → .103
+
+### Pose model
+
+- [x] **ADR-116** WiFlow-v1 supervised pose loader (Rust) — `--wiflow-model
+      data/models/ruview/wiflow-v1/wiflow-v1.json` flips
+      `pose_estimation: true`; per-tick TCN forward yields 17 COCO
+      keypoints on `/api/v1/pose/current` and WS `pose_data`. Output
+      quality requires per-deployment fine-tune (LoRA adapters or
+      re-train, see Pack E).
+- [x] **ADR-117** Process hygiene + audit follow-ups — UDP loopback
+      filter prevents `cargo test` cross-talk from spawning ping
+      zombies (250→2 children); keepalive pre-reaps orphans at startup;
+      `/` redirects to SPA; wiflow zero-pad replaces silent
+      subcarrier-0 duplication; keypoint confidence stamped from
+      runtime classifier; sensing tab container restored; multi-node
+      test guards external :5005; docs/typo/range sweep.
+
+### Adaptive Classifier (data pipeline + model)
+
+- [x] **ADR-118** Feature decorrelation + multi-node extractor (22 feats
+      = 4 global + 6 nodes × 3 with z-score). Accuracy 44.4% → 49.58%
+      (`e86f6506`).
+- [x] **ADR-119** Frame-level MLP (22→32→6 ReLU+softmax), manual
+      backprop, ~3k weights. Accuracy 49.58% → 53.53% (`94330708`).
+- [x] **ADR-120** Windowed temporal W-MLP (440→64→6, 20×22 stack) —
+      captures walking / sit-stand / gesture cadence. Accuracy 53.53%
+      → 90.40% training; held-out TBD. Hybrid priority (rule-based owns
+      4 base, W-MLP owns waving/transition) + two-layer label smoothing
+      + `/api/v1/adaptive/debug` (`da4c123d`..`12e1cf9d`, 7 commits).
+
+### Tests / fixtures
+
+- [x] **ADR-114** `tests/fixtures/replay_idle.jsonl` +
+      `replay_motion.jsonl` (1000 frames each, JSONL schema:
+      `{node_id, amplitude[]}`) (commit 96225e27)
+- [x] **ADR-114** `scripts/generate-replay-fixtures.py` —
+      seeded deterministic generator for the two fixtures
+      (commit 96225e27)
+- [x] (parallel agent) RSSI carry-through via feature_state header fix
+- [x] (parallel agent) OTA: `OTA_SIZE_UNKNOWN`, httpd stack_size=8192,
+      reset-reason log — all three FW prerequisites for working OTA
+
+### Ops / tooling
+
+- [x] `scripts/ota-deploy.sh` — WiFi OTA flash + auto-discovery + verify
+- [x] `scripts/record-baseline.py` — headless baseline capture (CLI)
+- [x] `data/baseline.json` v2 schema
+- [x] `docs/references/ota-pipeline.md` — verbatim OTA recipe (port 8032)
+
+### Documentation
+
+- [x] **ADR-100..120** all written (ADR-111 intentionally absent), each ≤ 200 lines
+- [x] `docs/references/espectre-techniques.md` — Pace technique catalogue
+- [x] `docs/references/espectre-gap-analysis.md` — section-by-section gap
+- [x] Documentation actualization sweep — every Open Items section
+      cross-checked against actual implementation state
+
+---
+
+## ⏳ Open, priority-sorted
+
+### High value, low effort
+
+(all closed this session — see Done above. Tailscale-target item
+moved to Deferred below per session brief.)
+
+### High value, medium effort
+
+(all closed this session — see Done above)
+
+### Bigger, lower urgency (still active)
+
+(all closed this session — multiple baseline profiles shipped via
+ADR-113, see Done above)
+
+### One-time hygiene
+
+- [x] **Re-record `data/baseline.json`** — current file already carries
+      `per_subcarrier_mean` so amplitude drift (ADR-104) is active.
+      Verified the recorder writes the new
+      `per_subcarrier_phase_mean` / `per_subcarrier_phase_var` schema
+      end-to-end (this session). `data/baseline.json` is untracked,
+      so no repo commit needed; operator re-records via UI when they
+      step out for a true empty-room sample (currently the file
+      reflects an operator-present recording — fine for the amp
+      channel, needs re-record for the phase channel to populate
+      ≥ 16 usable subcarriers).
+
+### Deferred — out of session scope
+
+Each line carries an explicit reason; revisit if scope changes.
+
+* New integrations (excluded by session brief): HA/MQTT, ESPHome,
+  Web Serial game, DensePose train, AETHER pretrain, MERIDIAN.
+* FW changes excluded: boot-time NBVI freeze, per-channel NVS cache
+  for gain-lock, channel hopping (ADR-029), multi-antenna support
+  (`n_antennas > 1`).
+* **Tailscale-target in NVS** — Mac stable on TP-Link this session;
+  low ROI. ADR-100 follow-up if Mac network swap becomes routine.
+
+---
+
+## Reference
+
+| Doc | Purpose |
+|---|---|
+| [`docs/adr/`](docs/adr) | All ADRs 001-120 (111 absent); 100-120 are this session |
+| [`docs/references/espectre-techniques.md`](docs/references/espectre-techniques.md) | Pace technique catalogue + RuView adoption |
+| [`docs/references/espectre-gap-analysis.md`](docs/references/espectre-gap-analysis.md) | Section-by-section gap with priority table |
+| [`docs/references/ota-pipeline.md`](docs/references/ota-pipeline.md) | OTA recipe — port 8032, three FW prereqs |
+
+To mark an item done: tick the box, add `(ADR-XXX, commit-sha)` after
+the line, move it from the priority section to the top "Done" section.