ruvnet--ruview
wehub-resource-sync
9740bc64c9
Bench Regression Guard / bench compile-verify (--no-run) (push) Failing after 0s
Continuous Deployment / Pre-deployment Checks (push) Has been skipped
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 CI / Build firmware (esp32c6 / c6-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
Firmware QEMU Tests (ADR-061) / QEMU Test (boundary-max) (push) Has been skipped
Firmware CI / Build firmware (esp32s3 / 8mb) (push) Failing after 15s
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) / 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
Firmware QEMU Tests (ADR-061) / NVS Matrix Generation (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
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
ruview-swarm CI guard / tests (ruflo) (push) Failing after 1s
ruview-swarm CI guard / tests (train) (push) Failing after 2s
BFLD MQTT Integration / cargo test --features mqtt (live mosquitto) (push) Failing after 29s
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
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
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
Security Scanning / Security Policy Compliance (push) Failing after 0s
wifi-densepose sensing-server → Docker Hub + ghcr.io / build · push · smoke-test (push) Failing after 1s
three.js demos → GitHub Pages / build-and-deploy (push) Failing after 1s
Verify Pipeline Determinism / Verify Pipeline Determinism (3.11) (push) Failing after 1s
Continuous Deployment / Deploy to Production (push) Has been cancelled
Continuous Deployment / Rollback Deployment (push) Has been cancelled
Continuous Deployment / Post-deployment Monitoring (push) Has been cancelled
Continuous Deployment / Notify Deployment Status (push) Has been cancelled
Continuous Deployment / Deploy to Staging (push) Has been cancelled
Security Scanning / Security Report (push) Has been cancelled
63 行
2.7 KiB
Markdown
63 行
2.7 KiB
Markdown
# `npx @ruvnet/ruview` — RuView WiFi-sensing operator harness
|
|
|
|
An AI agent harness that knows how to operate **RuView** (WiFi-DensePose): onboard a
|
|
newcomer, provision an ESP32 CSI node, calibrate a room, train pose models, and —
|
|
crucially — **refuse to overstate accuracy**. Minted from the RuView monorepo via
|
|
[`metaharness`](https://www.npmjs.com/package/metaharness) and hardened per **ADR-182**.
|
|
|
|
WiFi sensing infers *coarse* pose/presence/breathing from Channel State Information.
|
|
It is **not a camera**. Every accuracy number this harness emits must be MEASURED
|
|
against a baseline — that rule is enforced in code (`ruview_claim_check`).
|
|
|
|
## Quick start
|
|
|
|
```bash
|
|
npx @ruvnet/ruview # onboard — pick a setup path
|
|
npx @ruvnet/ruview claim-check --file REPORT.md # the honesty guardrail (non-zero exit on untagged claims)
|
|
npx @ruvnet/ruview verify # run the deterministic proof (VERDICT: PASS)
|
|
npx @ruvnet/ruview doctor # self-check (tools + optional kernel/host)
|
|
npx @ruvnet/ruview --help
|
|
```
|
|
|
|
The operator tools are pure Node and run with **zero install weight** — the
|
|
package has no dependencies at all (ADR-263 O3). `doctor` / `install` can
|
|
additionally use `@metaharness/kernel` + a host adapter if you install them
|
|
(`npm i @metaharness/kernel @metaharness/host-claude-code`); everything else
|
|
runs without them.
|
|
|
|
## Tools (`ruview_*`)
|
|
|
|
Exposed both as CLI verbs and as an MCP server (`npx @ruvnet/ruview mcp start`):
|
|
|
|
| Tool | What it does |
|
|
|------|--------------|
|
|
| `ruview_onboard` | Pick docker-demo / repo-build / live-esp32; print the next command |
|
|
| `ruview_claim_check` | Lint text for untagged / overstated accuracy claims (guardrail) |
|
|
| `ruview_verify` | Run `verify.py` deterministic proof → VERDICT |
|
|
| `ruview_node_monitor` | Assert CSI is flowing on an ESP32 (read-only) |
|
|
| `ruview_calibrate` | ADR-151 room pipeline (baseline→enroll→train-room→room-watch) |
|
|
| `ruview_node_flash` | Build+flash firmware (Windows/ESP-IDF; mutating, guarded) |
|
|
|
|
Every tool is **fail-closed**: missing repo / python / binary / port → an honest
|
|
negative, never a fabricated success.
|
|
|
|
## Skills
|
|
|
|
Host-neutral playbooks in `skills/` (`onboard`, `provision-node`, `calibrate-room`,
|
|
`train-pose`, `verify`). `npx @ruvnet/ruview skill <name>` prints one.
|
|
|
|
## Use as a Claude Code MCP server
|
|
|
|
The bundled `.claude/settings.json` registers the `ruview` MCP server
|
|
(`npx -y @ruvnet/ruview mcp start`). Drop this package's `.claude/` into a repo, or run
|
|
`npx @ruvnet/ruview install --host claude-code`.
|
|
|
|
## Hosts
|
|
|
|
claude-code (bundled), and via metaharness host adapters: codex, opencode, copilot,
|
|
pi-dev, hermes, rvm, github-actions.
|
|
|
|
## License
|
|
|
|
MIT © ruvnet
|