@neruva/mcp 0.28.2 → 0.30.0

package/bin/install-hooks.js

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+// neruva-mcp-install -- wire the bundled Rust hook into ~/.claude/settings.json
+// in FULL-TAKEOVER mode (no Python, no daemon). Run via:
+//
+//     npx -p @neruva/mcp neruva-mcp-install
+//     npx -p @neruva/mcp neruva-mcp-install --uninstall
+//
+// Topology (mirrors the daemon+async-recorder split, all-Rust):
+//   PreToolUse[*]                      sync   -> context (never records)
+//   UserPromptSubmit                   sync   -> context + record prompt
+//   PostToolUse[records_ingest]        sync   -> extract/consistency (--context-only)
+//   PostToolUse[*]                     async  -> record tool_call    (--record-only)
+//   Stop / SessionEnd / Subagent* / Task*  async -> record (--record-only)
+//   SessionStart                       sync   -> boot recall + record
+//
+// The async record entries keep recording OFF the latency path; --context-only
+// on the records_ingest entry prevents double-recording. Idempotent: re-running
+// strips our prior entries first. Backs settings up before writing.
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync, chmodSync, copyFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { homedir, platform, arch } from 'node:os';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const SETTINGS = join(homedir(), '.claude', 'settings.json');
+
+function pickBinary() {
+  const p = platform();
+  const platSeg = p === 'win32' ? 'win' : p === 'darwin' ? 'mac' : 'linux';
+  const archSeg = arch() === 'arm64' ? 'arm64' : 'x64';
+  const ext = p === 'win32' ? '.exe' : '';
+  return join(__dirname, '..', 'binaries', `neruva-record-hook-${platSeg}-${archSeg}${ext}`);
+}
+
+// Default auto-pilot env. Forced: NERUVA_RUST_FULL_TAKEOVER. Others are set only
+// when absent so we never clobber a user's existing tuning.
+const ENV_FORCE = { NERUVA_RUST_FULL_TAKEOVER: '1' };
+const ENV_DEFAULTS = {
+  NERUVA_AUTO_RECORD: 'claude_code',
+  NERUVA_AUTO_RECALL: '20',
+  NERUVA_PER_TURN_RECALL: '5',
+  NERUVA_AUTO_EXTRACT: '1',
+  NERUVA_AUTO_ROUTE: '1',
+  NERUVA_AUTO_REFLECT: '1',
+  NERUVA_PRE_ACTION_RECALL: '1',
+  NERUVA_PRE_ACTION_THRESHOLD: '0.08',
+  NERUVA_POST_INGEST_CONSISTENCY: '1',
+};
+
+const isOurEntry = (entry) =>
+  (entry?.hooks || []).some((h) => typeof h?.command === 'string' && h.command.includes('neruva-record-hook'));
+
+function buildHooks(cmd) {
+  const sync = (extra) => ({ hooks: [{ type: 'command', command: extra ? `${cmd} ${extra}` : cmd }] });
+  const async_ = (extra, matcher) => {
+    const e = { hooks: [{ type: 'command', command: extra ? `${cmd} ${extra}` : cmd, async: true }] };
+    if (matcher) e.matcher = matcher;
+    return e;
+  };
+  const syncM = (matcher, extra) => ({ matcher, hooks: [{ type: 'command', command: extra ? `${cmd} ${extra}` : cmd }] });
+  return {
+    PreToolUse: [syncM('*')],
+    UserPromptSubmit: [sync()],
+    PostToolUse: [syncM('mcp__neruva__records_ingest', '--context-only'), async_('--record-only', '*')],
+    Stop: [async_('--record-only')],
+    SessionStart: [sync()],
+    SessionEnd: [async_('--record-only')],
+    SubagentStart: [async_('--record-only')],
+    SubagentStop: [async_('--record-only')],
+    TaskCreated: [async_('--record-only')],
+    TaskCompleted: [async_('--record-only')],
+  };
+}
+
+function readSettings() {
+  if (!existsSync(SETTINGS)) return {};
+  try { return JSON.parse(readFileSync(SETTINGS, 'utf8')); } catch { return {}; }
+}
+
+function stripOurs(hooks) {
+  const out = {};
+  for (const [evt, entries] of Object.entries(hooks || {})) {
+    const kept = (entries || []).filter((e) => !isOurEntry(e));
+    if (kept.length) out[evt] = kept;
+  }
+  return out;
+}
+
+function main() {
+  const uninstall = process.argv.includes('--uninstall');
+  const binary = pickBinary();
+
+  if (!uninstall && !existsSync(binary)) {
+    console.error(`[neruva] bundled binary missing: ${binary}\n` +
+      `Reinstall @neruva/mcp so the platform binary is present.`);
+    process.exit(1);
+  }
+  if (!uninstall && platform() !== 'win32') {
+    try { chmodSync(binary, 0o755); } catch {}
+  }
+
+  const settings = readSettings();
+  if (existsSync(SETTINGS)) {
+    try { copyFileSync(SETTINGS, `${SETTINGS}.bak`); } catch {}
+  } else {
+    mkdirSync(dirname(SETTINGS), { recursive: true });
+  }
+
+  // Always start from a clean slate of OUR entries (idempotent re-runs).
+  settings.hooks = stripOurs(settings.hooks);
+
+  if (uninstall) {
+    if (settings.env) delete settings.env.NERUVA_RUST_FULL_TAKEOVER;
+    writeFileSync(SETTINGS, JSON.stringify(settings, null, 2));
+    console.log('[neruva] full-takeover hooks removed from', SETTINGS);
+    return;
+  }
+
+  const cmd = `"${binary.replace(/\\/g, '/')}"`;
+  const ours = buildHooks(cmd);
+  for (const [evt, entries] of Object.entries(ours)) {
+    settings.hooks[evt] = [...(settings.hooks[evt] || []), ...entries];
+  }
+
+  settings.env = settings.env || {};
+  Object.assign(settings.env, ENV_FORCE);
+  for (const [k, v] of Object.entries(ENV_DEFAULTS)) {
+    if (settings.env[k] === undefined) settings.env[k] = v;
+  }
+
+  writeFileSync(SETTINGS, JSON.stringify(settings, null, 2));
+  console.log('[neruva] full-takeover auto-pilot wired into', SETTINGS);
+  console.log('[neruva] binary:', binary);
+  if (!settings.env.NERUVA_API_KEY) {
+    console.log('\n  NEXT: set your API key (free at https://neruva.io):');
+    console.log('    add  "NERUVA_API_KEY": "nv_..."  to the "env" block in', SETTINGS);
+  }
+  console.log('  Then restart Claude Code. Memory + reasoning auto-pilot is now active with zero Python.');
+}
+
+main();

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@neruva/mcp",
-  "version": "0.28.2",
-  "description": "MCP server for Neruva -- reliability infrastructure for production AI agents. One install, agent stops forgetting / drifting / repeating mistakes, every failure replayable bit-for-bit. v0.27 ships the qbound KG engine -- pick engine='qbound' on hd_kg_add_facts when document-stated facts must override LLM training-time priors. Now 6 KG engines (hadamard, opb, qbound, multishard, quorum, feature_bundle). v0.26 ships agent_recall_full -- 7-layer federated semantic recall across records, KG, learned rules, CBR episodes, SCM variables, belief tracking, and continual learners in parallel (one question, seven buckets, ~150ms p95). INSTALL: npx -y -p @neruva/mcp@latest neruva-mcp. v0.23 BUNDLES neruva-record-hook native binary (Rust, ~145-340KB) for all 6 platforms. Cache-hit p95 ~80ms via warm daemon + TTL cache. AUTO-PILOT: agent_route_intent_prompt + agent_reflect_prompt + auto-extract on records_ingest. Plus typed Records, federated agent_remember/recall/context, counterfactual rollouts, rule induction, code_kg_* navigation, .neruva V3 container. Pattern-C: substrate stays $0/call. Free tier, no card.",
+  "version": "0.30.0",
+  "description": "MCP server for Neruva -- reliability infrastructure for production AI agents. One install, agent stops forgetting / drifting / repeating mistakes, every failure replayable bit-for-bit. v0.27 ships the qbound KG engine -- pick engine='qbound' on hd_kg_add_facts when document-stated facts must override LLM training-time priors. Now 6 KG engines (hadamard, opb, qbound, multishard, quorum, feature_bundle). v0.26 ships agent_recall_full -- 7-layer federated semantic recall across records, KG, learned rules, CBR episodes, SCM variables, belief tracking, and continual learners in parallel (one question, seven buckets, ~150ms p95). INSTALL: npx -y -p @neruva/mcp@latest neruva-mcp. BUNDLES the neruva-record-hook native binary (Rust, in-binary HTTPS hot path, ~1.5-2MB) for all 6 platforms. v0.30 adds ONE-COMMAND full-takeover install (npx -p @neruva/mcp neruva-mcp-install) -- wires the complete memory+reasoning auto-pilot (per-turn recall, auto-route, auto-reflect, code-graph, consistency, secret redaction, recording) with ZERO Python or daemon. Cache-hit p95 ~80ms via warm daemon + TTL cache. AUTO-PILOT: agent_route_intent_prompt + agent_reflect_prompt + auto-extract on records_ingest. Plus typed Records, federated agent_remember/recall/context, counterfactual rollouts, rule induction, code_kg_* navigation, .neruva V3 container. Pattern-C: substrate stays $0/call. Free tier, no card.",
   "license": "MIT",
   "type": "module",
   "bin": {
     "neruva-mcp": "dist/server.js",
-    "neruva-record-hook": "bin/neruva-record-hook.js"
+    "neruva-record-hook": "bin/neruva-record-hook.js",
+    "neruva-mcp-install": "bin/install-hooks.js"
   },
   "files": [
     "dist",