wehub-resource-sync
9740bc64c9
Continuous Deployment / Deploy to Production (push) Blocked by required conditions
Continuous Deployment / Rollback Deployment (push) Blocked by required conditions
Continuous Deployment / Post-deployment Monitoring (push) Blocked by required conditions
Continuous Deployment / Notify Deployment Status (push) Blocked by required conditions
Firmware QEMU Tests (ADR-061) / QEMU Test (edge-tier1) (push) Has been skipped
Firmware QEMU Tests (ADR-061) / QEMU Test (full-adr060) (push) Has been skipped
Firmware QEMU Tests (ADR-061) / QEMU Test (tdm-3node) (push) Has been skipped
Firmware QEMU Tests (ADR-061) / Swarm Test (ADR-062) (push) Has been skipped
npm packages / tools/ruview-mcp (node 22) (push) Failing after 1s
nvsim-server → ghcr.io / build-and-publish (push) Failing after 1s
ruview-swarm CI guard / tests (full+train) (push) Failing after 2s
Bench Regression Guard / bench compile-verify (--no-run) (push) Failing after 0s
Bench Regression Guard / bench fast-run (informational, non-gating) (push) Has been skipped
Firmware CI / Verify version.txt matches release tag (push) Has been skipped
Dashboard a11y + cross-browser / a11y (push) Failing after 0s
nvsim Dashboard → GitHub Pages / build-and-deploy (push) Failing after 2s
Firmware CI / Build firmware (esp32s3 / 4mb) (push) Failing after 15s
Firmware QEMU Tests (ADR-061) / Build Espressif QEMU (push) Failing after 1s
Firmware QEMU Tests (ADR-061) / Fuzz Testing (ADR-061 Layer 6) (push) Failing after 1s
Continuous Deployment / Pre-deployment Checks (push) Has been skipped
Continuous Deployment / Deploy to Staging (push) Waiting to run
Firmware CI / Build firmware (esp32c6 / c6-4mb) (push) Failing after 15s
Firmware CI / Build firmware (esp32s3 / 8mb) (push) Failing after 15s
Firmware QEMU Tests (ADR-061) / QEMU Test (boundary-max) (push) Has been skipped
Firmware QEMU Tests (ADR-061) / QEMU Test (boundary-min) (push) Has been skipped
Firmware QEMU Tests (ADR-061) / QEMU Test (default) (push) Has been skipped
Firmware QEMU Tests (ADR-061) / QEMU Test (edge-tier0) (push) Has been skipped
Firmware QEMU Tests (ADR-061) / NVS Matrix Generation (push) Failing after 1s
Security Scanning / Security Policy Compliance (push) Failing after 0s
Security Scanning / Security Report (push) Waiting to run
Security Scanning / Dependency Vulnerability Scan (push) Failing after 0s
Security Scanning / Static Application Security Testing (push) Failing after 1s
Security Scanning / Infrastructure Security Scan (push) Failing after 1s
Security Scanning / Secret Scanning (push) Failing after 1s
npm packages / harness/ruview (node 22) (push) Failing after 17s
Security Scanning / License Compliance Scan (push) Failing after 1s
Security Scanning / Container Security Scan (push) Failing after 4s
three.js demos → GitHub Pages / build-and-deploy (push) Failing after 1s
Verify Pipeline Determinism / Verify Pipeline Determinism (3.11) (push) Failing after 1s
Fix-Marker Regression Guard / Verify fix markers (push) Failing after 1s
ADR-115 MQTT integration tests / mqtt-integration (push) Failing after 1s
npm packages / harness/ruview (node 20) (push) Failing after 1s
npm packages / tools/ruview-mcp (node 20) (push) Failing after 1s
npm packages / tools/ruview-cli (node 20) (push) Failing after 1s
npm packages / tools/ruview-cli (node 22) (push) Failing after 1s
BFLD MQTT Integration / cargo test --features mqtt (live mosquitto) (push) Failing after 29s
ruview-swarm CI guard / build train_marl bin (push) Failing after 2s
ruview-swarm CI guard / clippy (-D warnings, --no-deps) (push) Failing after 3s
ruview-swarm CI guard / tests (ruflo) (push) Failing after 1s
ruview-swarm CI guard / tests (train) (push) Failing after 2s
ruview-swarm CI guard / tests (default) (push) Failing after 2s
Point Cloud Viewer → GitHub Pages / build-and-deploy (push) Failing after 8s
ruview-swarm CI guard / ITAR / publish guard (push) Failing after 0s
wifi-densepose sensing-server → Docker Hub + ghcr.io / build · push · smoke-test (push) Failing after 1s
3.1 KiB
3.1 KiB
AGENTS.md — RuView (WiFi-DensePose)
Project rules for Codex (and any agent) working in the ruvnet/RuView / wifi-densepose repo. Mirrors the Claude Code ruview plugin.
What this repo is
WiFi-based human sensing from Channel State Information (CSI). Dual codebase: Rust port in v2/ (15 crates), Python v1 in archive/v1/. ESP32-S3 / ESP32-C6 firmware in firmware/esp32-csi-node/. 96 ADRs in docs/adr/.
Hard rules
- Do exactly what's asked — nothing more, nothing less.
- Never create files (especially
*.md/README) unless required for the task. Prefer editing an existing file. - Never save working files/tests/notes to the repo root — use
v2/crates/,tests/,docs/,scripts/,examples/. - Read a file before editing it.
- Never commit secrets, credentials, or
.env. - Validate user input at system boundaries; sanitize file paths.
- ESP32-C3 and the original ESP32 are not supported (single-core). Use ESP32-S3 (8MB/4MB) or ESP32-C6.
Build & test
# Rust workspace (1,400+ tests, ~2 min)
cd v2 && cargo test --workspace --no-default-features
# Single crate, no GPU
cargo check -p wifi-densepose-train --no-default-features
# Deterministic Python pipeline proof (SHA-256 Trust Kill Switch)
python archive/v1/data/proof/verify.py # must print VERDICT: PASS
# Python v1 tests
cd archive/v1 && python -m pytest tests/ -x -q
ESP32 firmware (Windows)
ESP-IDF v5.4 does not work under Git Bash/MSYS2 and cmd.exe /C hangs when called from bash. Build/flash via the Espressif Python venv as a subprocess with MSYSTEM* env vars stripped — the exact command is in CLAUDE.local.md. Default ESP32 serial port: COM8 (confirm with mode / Device Manager — older docs say COM7 or COM9). Provision WiFi: python firmware/esp32-csi-node/provision.py --port COM8 --ssid ... --password ... --target-ip ... [--channel N] [--filter-mac MAC]. Serial monitor via pyserial, not idf.py monitor. Always test with real WiFi CSI, never mock mode.
Witness verification (ADR-028)
After significant changes: run the Rust tests + Python proof, then bash scripts/generate-witness-bundle.sh, then cd dist/witness-bundle-ADR028-*/ && bash VERIFY.sh (7/7 PASS). Pre-merge checklist lives in CLAUDE.md.
Prompt files in codex/prompts/
| Prompt | Purpose |
|---|---|
ruview-start |
Onboarding — Docker demo / repo build / live ESP32 |
ruview-flash |
Build + flash ESP32 firmware (8MB / 4MB) |
ruview-provision |
Provision WiFi creds + sink IP + channel/MAC overrides |
ruview-app |
Run a sensing application (presence / vitals / pose / sleep / MAT / point cloud) |
ruview-train |
Train / evaluate / publish a model (incl. GPU on GCloud) |
ruview-verify |
Run the trust pipeline + pre-merge checklist |
ruview-rvagent |
Explore rvAgent + RVF agentic flows wiring into RuView |
Install: copy codex/prompts/*.md into ~/.codex/prompts/, or run Codex with this directory on its prompt path.
Reference
README.md, docs/user-guide.md, docs/wifi-mat-user-guide.md, docs/build-guide.md, docs/TROUBLESHOOTING.md, docs/adr/, docs/tutorials/, examples/, CLAUDE.md, CLAUDE.local.md.