berkus
/
wifi-densepose
mirror of https://github.com/ruvnet/wifi-densepose.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
wifi-densepose/CHECKLIST.md

8.8 KiB
Raw Blame History

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 for the technical detail behind each line.

Last sweep: 2026-05-17, branch feat/ota-rssi-mobile, head 0ec1e4b0. Status: 47 Done / 0 Open in-scope. Deferred items (out of session scope, each with explicit reason) listed at the bottom.

This count includes the ADR-100..114 carry-in from the prior agent + this session's ADR-115 (FW set-target REST), ADR-116 (WiFlow-v1 Rust loader), ADR-116 cosmetic (UI dropdown), and ADR-117 (process hygiene + audit follow-ups). ADR-111 is intentionally absent (folded into ADR-109 during the AP-MAC tracking work).

✅ Done

Server (v2/crates/wifi-densepose-sensing-server)

  • ADR-100 PHY gain-lock (AGC + FFT freeze, ESPectre port) — FW
  • ADR-101 Raw-amplitude classifier (CV + baseline drop, hysteresis)
  • ADR-101 Per-node classification badges in WS payload
  • ADR-102 NBVI subcarrier selection (formula α=0.5, top-12)
  • ADR-102 NBVI Step 1 quiet-window finder
  • ADR-103 Persistent baseline at data/baseline.json (FULL broadband)
  • ADR-103 Universal threshold via baseline-CV normalization
  • ADR-104 Per-subcarrier drift channel (off-axis presence)
  • ADR-104 NBVI Step 3 FP-rate validation (K ∈ {6,8,10,12,16,20})
  • ADR-104 Per-sub drift exposed in WS node_features[].drift_score + raw.html sparkline per node (commit eec3ca6c)
  • ADR-104 Baseline staleness watch — warn when on-disk baseline > 4 h old AND drift consistently fires during absent periods (commit eec3ca6c)
  • ADR-105 Drop all synthetic data from runtime ([signal_field, pose_keypoints, persons, fake confidence — all gated)
  • ADR-105 n_aps_used: u8 uniform field on enhanced_motion + enhanced_breathing (commit 598a4b2f)
  • ADR-106 Full complex CSI in WS (amplitude + phases + meta)
  • ADR-106 Built-in CSI keepalive (managed ping per sensor)
  • ADR-106 Server-side µs timestamp_us
  • ADR-107 POST /api/v1/baseline/calibrate + UI button
  • ADR-107 Auto-recalibrate on long-quiet periods (30 min default)
  • ADR-107 GET /api/v1/baseline (status + cooldown)
  • ADR-107 Progress bar in raw.html calibrate button (commit 432753e1)
  • 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)
  • ADR-105 Hide pose canvas in Docker SPA when model_loaded == false + "no trained model" overlay (commit 2dcb30a6)
  • ADR-104 Phase-domain drift channel — script + server both compute per-subcarrier circular mean/var; phase_drift_score surfaced on PerNodeFeatureInfo (commit 47dafab4)
  • ADR-113 Day/night baseline profiles with hot-reload (--baseline-profile {single,auto,day,night}) (commit a1e09525)
  • 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)

  • ADR-100 Gain-lock (300-packet median, MIN_SAFE_AGC=30 safety)
  • ADR-106 Sensor µs timestamp in CSI trailer (rx_ctrl.timestamp)
  • ADR-108 NVS persistence of gain-lock — reboot ready in ~0.5 s
  • ADR-109 POST /ota/recalibrate — clear gain-lock NVS via REST, no USB needed (commit f92807cd)
  • ADR-109 Track AP MAC in gl_ap_mac NVS — auto-invalidate stale gain-lock on AP swap (commit f92807cd)
  • 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

  • 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).
  • 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.

Tests / fixtures

  • ADR-114 tests/fixtures/replay_idle.jsonl + replay_motion.jsonl (1000 frames each, JSONL schema: {node_id, amplitude[]}) (commit 96225e27)
  • ADR-114 scripts/generate-replay-fixtures.py — seeded deterministic generator for the two fixtures (commit 96225e27)
  • (parallel agent) RSSI carry-through via feature_state header fix
  • (parallel agent) OTA: OTA_SIZE_UNKNOWN, httpd stack_size=8192, reset-reason log — all three FW prerequisites for working OTA

Ops / tooling

  • scripts/ota-deploy.sh — WiFi OTA flash + auto-discovery + verify
  • scripts/record-baseline.py — headless baseline capture (CLI)
  • data/baseline.json v2 schema
  • docs/references/ota-pipeline.md — verbatim OTA recipe (port 8032)

Documentation

  • ADR-100..117 all written (ADR-111 intentionally absent), each ≤ 200 lines
  • docs/references/espectre-techniques.md — Pace technique catalogue
  • docs/references/espectre-gap-analysis.md — section-by-section gap
  • 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

  • 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

Marked here so future sessions don't re-litigate; each line carries an explicit reason. Bring them back only if scope changes.

  • HA via MQTT — new integration. Excluded by current session brief (no new integrations on current hardware).
  • ESPHome native component — same reason as HA/MQTT.
  • Web Serial calibration game — explicitly excluded.
  • Boot-time NBVI freeze in FW — explicitly excluded.
  • Per-channel NVS cache for gain-lock — explicitly excluded; only matters if channel hopping is reactivated, which is also excluded.
  • DensePose model train + load — explicitly excluded.
  • AETHER contrastive pretrain on live data — explicitly excluded.
  • MERIDIAN domain generalization — explicitly excluded.
  • Channel hopping (ADR-029) — explicitly excluded.
  • Multi-antenna support (n_antennas > 1) — explicitly excluded.
  • README.md trim (542 lines) — explicitly excluded.
  • CLAUDE.md trim (407 lines) — explicitly excluded.
  • Tailscale-target in NVS — Mac stable on TP-Link this session, low ROI. Not blocking. (ADR-100 follow-up; bring back if Mac network swap becomes routine.)

Reference

Doc Purpose
docs/adr/ All ADRs 001-117 (111 absent); 100-117 are this session
docs/references/espectre-techniques.md Pace technique catalogue + RuView adoption
docs/references/espectre-gap-analysis.md Section-by-section gap with priority table
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.