ruview-harness-v0.9.1

## RuView npm toolkit 0.9.1: watch your sensors live inside Claude Code

```bash
npx @ruvnet/ruview@0.9.1 doctor      # what works on this machine, and how to fix what doesn't
```

### What's new

**See your sensors live in Claude Code.** The package now includes `ruview-live`, a Claude Code mod. Type `/ruview` and a pane opens next to the conversation. It refreshes by itself and has three views:

| Key | View | What you see |
|---|---|---|
| `1` | **Overview** | The Wi-Fi sensing nodes streaming to your computer (frames per second, packet loss, signal strength) and an optional 60 GHz radar kit (presence, distance, heart and breathing rates) |
| `2` | **CSI waterfall** | The Wi-Fi signal itself: the strength of every subcarrier over time, in colour, scrolling as frames arrive |
| `3` | **Radar** | A top-down range fan with an animated ping out to the measured distance, plus heart, breathing and distance charts |

Switch views with the keys while the pane has the keyboard, or with `/ruview overview`, `/ruview waterfall` and `/ruview radar` at any time.

**New: `ruview esp32 --spectrum`.** It adds the latest per-subcarrier amplitude frames for each node to a capture. This is what feeds the waterfall, and you can use it from scripts too.

**Also in this line (0.8–0.9):**
- a console widget for ChatGPT and other MCP apps;
- an authenticated HTTP option for the MCP server;
- reading ESPHome 60 GHz radar kits over Wi-Fi;
- a friendlier terminal display;
- the `ruview` umbrella command, covering the toolkit, Homecore and the compute kernel (in the repo; see Upgrading).

### Honest by design

- The waterfall says **MEASURED** (real frames received on your machine) or **SYNTHETIC** (simulator frames), taken from the packets themselves.
- Radar heart and breathing values are labelled *device-reported, not validated*. Values outside normal resting ranges are flagged.
- The radar kit reports distance, not direction, and the view says so.
- If a node goes quiet, its old picture is removed, not kept on screen as "live".
- The pane only reads. It never flashes, provisions or changes a device.

### Tested on real hardware (MEASURED)

- **ESP32-C6** running RuView firmware v0.7.0: streamed 7–18 CSI frames per second to the host. The waterfall showed the occupied Wi-Fi band and the unused edge subcarriers. Reproduce: `npx @ruvnet/ruview@0.9.1 esp32 --seconds 4 --spectrum --json`.
- **Seeed MR60BHA2** 60 GHz radar kit over ESPHome: presence, distance, and device-reported vitals.
- Tests: 193 unit tests, 91 security tests, and 4 Claude Code engine tests pass. The mod passes `claude plugin validate`.

### Try the live pane

```bash
npx @ruvnet/ruview@0.9.1 mod                  # prints where the mod is and how to load it
claude --plugin-dir "<path printed above>"
```

Mods are early access in Claude Code. If `/ruview` is missing, start Claude Code with `CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1`.

### Upgrading

- No runtime dependencies, as before. The unpacked size ceiling rises from 384 KiB to 448 KiB for the new views.
- The harness command is `ruview-harness`. The `ruview` umbrella package (one `ruview` command) is in the repo under `harness/ruview-umbrella`, but it isn't on npm yet: the unscoped `ruview` name is waiting on an npm name request.

**Details:** issue #2074 · pull requests #2062 and #2073 · design records ADR-377 (the mod) and ADR-378 (the waterfall and radar views).