mirror of
https://github.com/ruvnet/RuView
synced 2026-07-29 18:31:44 +00:00
Claude
9109269329
ADR-263 (@ruvnet/ruview 0.2.0), O1-O9: - claim-check fails closed on empty input (CLI exit 2, empty_text tool error) - MCP stdio server dispatches tools/call asynchronously (promise-based spawn); ping answers while a 3s fake verify runs — pinned by new e2e test - optionalDependencies dropped: cold npx installs exactly 1 package (MEASURED: was 4 pkgs/620kB/71 files via npm i in a clean prefix) - bounded rolling output tails replace spawnSync 1MiB maxBuffer - node_monitor port passed via sys.argv, never spliced into python -c source - serverInfo.version read from package.json; resources/prompts stubs - skills single-sourced: prepack sync script generates .claude/skills/ copies - which() = memoized dep-free PATH scan - tools underscore-canonical (ruview_claim_check, ...) + dotted aliases - guardrail precision: word-boundary map/f1/auc/iou, code-span + F1/O2 label scrubbing, quantitative-claims-only; packaging reproducer hints - 30/30 tests (was 17), incl. concurrency e2e + fail-open regression pins ADR-264 (@ruvnet/rvagent 0.2.0), O1-O9: - exports fixed: types-first, phantom dist/index.cjs require target removed - tarball map-free: 127,704B unpacked / 46 files / 0 maps (MEASURED, npm pack --dry-run; was 188kB incl. 44 maps referencing unshipped src) - Streamable HTTP actually wired behind RVAGENT_HTTP_PORT: one transport + one MCP server per session (mcp-session-id routing), 1MiB body cap (413), port-aware localhost origin gate; dual-transport description now true - tools renamed underscore-canonical with dotted router-only aliases - single Zod validation gate; advertised inputSchema generated from the same Zod source (zod-to-json-schema) - train_count: parent log fds closed (was leaking 2/job); job records persisted to <jobsDir>/<id>.json (job_status survives restarts); bounded log-tail reads - detectCogBinary probes its candidates instead of dead-coding them - version from package.json; @types/express dropped; @types/jest -> 29 - README rewritten to match reality (no phantom subcommands/policy layer) - 99/99 jest tests (incl. new session/body-cap suite + previously-broken manifest suite); stdio handshake + HTTP session flow smoke-tested live ADR-265 D1-D4: - .github/workflows/npm-packages.yml: 3-package x Node 20/22 gate — tests, version-literal grep (D3), pack-content/size gate, tarball-install smoke test (catches the ADR-264 F1 class), README claim-check (D4) - .github/workflows/ruview-npm-release.yml: publish from CI only with npm publish --provenance - @ruv/ruview-cli bin renamed ruview-cli (ruview bin belongs to @ruvnet/ruview); version single-sourced - ci.yml NODE_VERSION 18 -> 20 ADR statuses updated to Accepted/implemented; harness manifest re-pinned; ADR-263/264/265 + both package READMEs pass claim-check. Co-Authored-By: claude-flow <ruv@ruv.net> Claude-Session: https://claude.ai/code/session_01WrGfTGKv1oWZ6iwXZACULz
63 lines
2.7 KiB
Markdown
63 lines
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
|