feat(harness): npx @ruvnet/ruview operator harness + ADR-182 (#1123)

A host-portable RuView agent harness minted via MetaHarness and hardened per ADR-182. Published as @ruvnet/ruview@0.1.0 (bare `ruview` blocked by npm's typosquat filter → scoped fallback). What it does: - 6 fail-closed `ruview.*` tools (onboard, claim_check, verify, node_monitor, calibrate, node_flash) exposed as CLI verbs + a dependency-free MCP stdio server. - The "prove everything" rule made executable: `ruview.claim_check` flags untagged accuracy claims and the retracted "100%" framing. - 5 host-neutral skills (onboard/provision-node/calibrate-room/ train-pose/verify) + bundled .claude/ config + provenance manifest. Validated: 17/17 unit tests, live MCP handshake, `ruview.verify` ran the real verify.py to VERDICT: PASS, clean `npx @ruvnet/ruview` from registry. Packs to 16.7 kB / 21 files; kernel+host are optionalDependencies so the operator tools install lightweight. README: documented as the portable, multi-host companion to the in-repo plugins/ruview/ Claude Code plugin (not a replacement).
2026-08-11 20:41:44 +00:00 · 2026-06-17 17:46:31 -04:00
parent 65e29ef47a
commit 4001e9e178
25 changed files with 1579 additions and 0 deletions
@@ -0,0 +1,68 @@
+// SPDX-License-Identifier: MIT
+// RuView harness — minimal MCP stdio server (JSON-RPC 2.0 over stdin/stdout).
+//
+// Dependency-free on purpose: a published `npx ruview` must `mcp start` without
+// pulling the full MCP SDK. Implements the subset hosts use: `initialize`,
+// `tools/list`, `tools/call`, and the `notifications/initialized` ack. Logs go to
+// stderr ONLY — stdout is the JSON-RPC channel and must stay clean.
+
+import { createInterface } from 'node:readline';
+import { listTools, runTool } from './tools.js';
+
+const PROTOCOL_VERSION = '2024-11-05';
+const SERVER_INFO = { name: 'ruview', version: '0.1.0' };
+
+function send(msg) {
+  process.stdout.write(JSON.stringify(msg) + '\n');
+}
+function result(id, res) { send({ jsonrpc: '2.0', id, result: res }); }
+function error(id, code, message) { send({ jsonrpc: '2.0', id, error: { code, message } }); }
+function log(...a) { process.stderr.write('[ruview-mcp] ' + a.join(' ') + '\n'); }
+
+function handle(msg) {
+  const { id, method, params } = msg;
+  switch (method) {
+    case 'initialize':
+      return result(id, {
+        protocolVersion: PROTOCOL_VERSION,
+        capabilities: { tools: { listChanged: false } },
+        serverInfo: SERVER_INFO,
+        instructions: 'RuView WiFi-sensing operator tools. All results are fail-closed; accuracy claims must pass ruview.claim_check.',
+      });
+    case 'notifications/initialized':
+    case 'initialized':
+      return; // notification — no response
+    case 'ping':
+      return result(id, {});
+    case 'tools/list':
+      return result(id, { tools: listTools() });
+    case 'tools/call': {
+      const name = params?.name;
+      const args = params?.arguments || {};
+      const out = runTool(name, args);
+      // MCP content envelope: text block with the JSON, isError reflects ok=false.
+      return result(id, {
+        content: [{ type: 'text', text: JSON.stringify(out, null, 2) }],
+        isError: out && out.ok === false,
+      });
+    }
+    default:
+      if (id !== undefined) error(id, -32601, `Method not found: ${method}`);
+  }
+}
+
+export function startMcpServer() {
+  log(`starting (protocol ${PROTOCOL_VERSION}, ${listTools().length} tools)`);
+  const rl = createInterface({ input: process.stdin, crlfDelay: Infinity });
+  rl.on('line', (line) => {
+    const s = line.trim();
+    if (!s) return;
+    let msg;
+    try { msg = JSON.parse(s); } catch { return log('bad JSON line dropped'); }
+    try { handle(msg); } catch (err) {
+      if (msg && msg.id !== undefined) error(msg.id, -32603, String(err && err.message || err));
+      log('handler error:', String(err));
+    }
+  });
+  rl.on('close', () => { log('stdin closed — exiting'); process.exit(0); });
+}