@viberaven/mcp 1.0.5 → 1.0.7

package/README.md

@@ -1,5 +1,9 @@
 # @viberaven/mcp
 
+[![npm version](https://img.shields.io/npm/v/@viberaven/mcp)](https://www.npmjs.com/package/@viberaven/mcp)
+[![npm downloads](https://img.shields.io/npm/dw/@viberaven/mcp)](https://www.npmjs.com/package/@viberaven/mcp)
+[![license](https://img.shields.io/npm/l/@viberaven/mcp)](https://www.npmjs.com/package/@viberaven/mcp)
+
 Thin MCP wrapper for VibeRaven.
 
 This package exposes VibeRaven CLI actions as MCP tools for Codex, Claude Code, Cursor, and other agent runtimes. It does not contain VibeRaven backend logic and does not bypass VibeRaven login or scan quotas.
@@ -32,9 +36,22 @@ npx -y viberaven mcp
 - `viberaven_heal_prompt` -> `npx -y viberaven --heal --prompt`
 - `viberaven_heal_apply` -> `npx -y viberaven --heal --apply`
 
-`viberaven_check_readiness` is the canonical entrypoint. It runs VibeRaven as the Agent Context + Production Gate and writes `.viberaven/agent-tasklist.md`, `.viberaven/gate-result.json`, and `.viberaven/context-map.json`.
-
-After one fix, call `viberaven_verify`. Before deploy or CI pass, call `viberaven_strict_gate` or run:
+`viberaven_check_readiness` is the canonical entrypoint. It runs VibeRaven as the Agent Context + Production Gate and writes `.viberaven/agent-tasklist.md`, `.viberaven/gate-result.json`, `.viberaven/context-map.json`, and Launch Autopilot artifacts.
+
+Launch Autopilot keeps the canonical agent command:
+
+```bash
+npx -y viberaven --agent-mode
+```
+
+MCP clients may pass `launchMode` to `viberaven_check_readiness`:
+
+- `manual`: show links and commands only
+- `ask`: default, ask before provider actions
+- `safe`: read-only provider checks and safe repo fixes
+- `full`: approved session mode; production deploy still needs final confirmation
+
+After one fix, call `viberaven_verify`. Before deploy or CI pass, call `viberaven_strict_gate` or run:
 
 ```bash
 npx -y viberaven --strict

package/bin/server.js

@@ -1,383 +1,398 @@
-#!/usr/bin/env node
-const { spawn } = require('node:child_process');
-let spawnChild = spawn;
-
-const SERVER_INFO = { name: 'viberaven-mcp', version: '1.0.4' };
-const CLI_PACKAGE = '@viberaven/cli';
-
+#!/usr/bin/env node
+const { spawn } = require('node:child_process');
+let spawnChild = spawn;
+
+const SERVER_INFO = { name: 'viberaven-mcp', version: '1.0.7' };
+const CLI_PACKAGE = '@viberaven/cli';
+
 const cwdSchema = {
   type: 'object',
   properties: {
-    cwd: { type: 'string', description: 'Project root. Defaults to the MCP server working directory.' }
-  },
-  additionalProperties: false
-};
-
-const healSchema = {
-  type: 'object',
-  properties: {
-    cwd: { type: 'string' },
-    target: { type: 'string' },
-    gap: { type: 'string' },
-    yes: { type: 'boolean' }
+    cwd: { type: 'string', description: 'Project root. Defaults to the MCP server working directory.' },
+    launchMode: {
+      type: 'string',
+      enum: ['manual', 'ask', 'safe', 'full'],
+      description: 'Launch Autopilot permission mode. Defaults to ask.'
+    }
   },
   additionalProperties: false
 };
-
-const TOOLS = [
+
+const healSchema = {
+  type: 'object',
+  properties: {
+    cwd: { type: 'string' },
+    target: { type: 'string' },
+    gap: { type: 'string' },
+    yes: { type: 'boolean' }
+  },
+  additionalProperties: false
+};
+
+const TOOLS = [
   {
     name: 'viberaven_check_readiness',
-    description: 'Run the VibeRaven agent-mode production-readiness check and write .viberaven artifacts.',
-    inputSchema: cwdSchema
-  },
-  {
-    name: 'viberaven_verify',
-    description: 'Rescan and refresh VibeRaven production-readiness artifacts after a fix.',
-    inputSchema: cwdSchema
-  },
-  {
-    name: 'viberaven_audit',
-    description: 'Run local Vercel/Supabase production checks for RLS, service-role boundaries, and Vercel pooler usage.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        cwd: { type: 'string', description: 'Project root. Defaults to current working directory.' },
-        json: { type: 'boolean', description: 'Return JSON output.' }
-      },
-      additionalProperties: false
-    }
-  },
-  {
-    name: 'viberaven_init_rules',
-    description: 'Install bounded VibeRaven rules into native AI instruction files.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        cwd: { type: 'string', description: 'Project root. Defaults to current working directory.' },
-        agents: { type: 'string', description: 'Comma-separated agent targets, or all.' },
-        dryRun: { type: 'boolean', description: 'Preview changes without writing files.' }
-      },
-      additionalProperties: false
-    }
-  },
-  {
-    name: 'viberaven_clean_plan',
-    description: 'Write a non-destructive context cleanup plan for generated artifacts and logs.',
-    inputSchema: cwdSchema
-  },
-  {
-    name: 'viberaven_strict_gate',
-    description: 'Run VibeRaven agent-mode strict gate and return the machine verdict.',
-    inputSchema: cwdSchema
-  },
-  {
-    name: 'viberaven_gate_result',
-    description: 'Run VibeRaven agent-mode JSON output and return gate-result.json content.',
-    inputSchema: cwdSchema
-  },
-  {
-    name: 'viberaven_context_map',
-    description: 'Refresh .viberaven/context-map.json from the last scan.',
+    description:
+      'Run VibeRaven agent-mode production-readiness and Launch Autopilot; writes .viberaven artifacts and one next launch action.',
     inputSchema: cwdSchema
   },
-  {
-    name: 'viberaven_heal_plan',
-    description: 'Write a non-destructive VibeRaven heal plan for a target file or gap.',
-    inputSchema: healSchema
-  },
-  {
-    name: 'viberaven_heal_prompt',
-    description: 'Write an agent-ready VibeRaven heal prompt for a target file or gap.',
-    inputSchema: healSchema
-  },
-  {
-    name: 'viberaven_heal_apply',
-    description: 'Apply a guarded VibeRaven repo-code heal recipe when supported.',
-    inputSchema: healSchema
-  },
-  {
-    name: 'viberaven_validate_npm_package',
-    description:
-      'Check whether an npm package name exists and looks safe before install. Always run viberaven --agent-mode after adding dependencies.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        packageName: { type: 'string', description: 'Single npm package name to validate.' },
-        packageNames: {
-          type: 'array',
-          items: { type: 'string' },
-          description: 'Multiple npm package names to validate in one call.'
-        }
-      },
-      additionalProperties: false
-    }
-  }
-];
-
-let buffer = Buffer.alloc(0);
-
-function main() {
-  if (process.argv.includes('--help') || process.argv.includes('-h')) {
-    console.log(`${SERVER_INFO.name} ${SERVER_INFO.version}`);
-    console.log(`MCP stdio server wrapping npx -y ${CLI_PACKAGE}.`);
-    process.exit(0);
-  }
-
-  process.stdin.on('data', (chunk) => {
-    buffer = Buffer.concat([buffer, chunk]);
-    drainMessages();
-  });
-}
-
-function drainMessages() {
-  while (true) {
-    const headerEnd = buffer.indexOf('\r\n\r\n');
-    if (headerEnd === -1) return;
-
-    const header = buffer.slice(0, headerEnd).toString('utf8');
-    const match = header.match(/content-length:\s*(\d+)/i);
-    if (!match) {
-      buffer = buffer.slice(headerEnd + 4);
-      continue;
-    }
-
-    const length = Number(match[1]);
-    const messageStart = headerEnd + 4;
-    const messageEnd = messageStart + length;
-    if (buffer.length < messageEnd) return;
-
-    const raw = buffer.slice(messageStart, messageEnd).toString('utf8');
-    buffer = buffer.slice(messageEnd);
-    void handleRawMessage(raw);
-  }
-}
-
-async function handleRawMessage(raw) {
-  let message;
-  try {
-    message = JSON.parse(raw);
-  } catch {
-    return;
-  }
-
-  if (!message || typeof message.method !== 'string') return;
-  if (message.id === undefined || message.id === null) return;
-
-  try {
-    const result = await handleRequest(message.method, message.params || {});
-    send({ jsonrpc: '2.0', id: message.id, result });
-  } catch (error) {
-    send({
-      jsonrpc: '2.0',
-      id: message.id,
-      error: {
-        code: -32000,
-        message: error instanceof Error ? error.message : String(error)
-      }
-    });
-  }
-}
-
-async function handleRequest(method, params) {
-  if (method === 'initialize') {
-    return {
-      protocolVersion: params.protocolVersion || '2024-11-05',
-      capabilities: { tools: {} },
-      serverInfo: SERVER_INFO
-    };
-  }
-
-  if (method === 'tools/list') {
-    return { tools: TOOLS };
-  }
-
-  if (method === 'tools/call') {
-    const name = params.name;
-    const args = params.arguments || {};
-    const text = await callTool(name, args);
-    const parsed = parseJsonObjectFromToolText(text);
-    return {
-      content: [{ type: 'text', text }],
-      ...(parsed ? { structuredContent: parsed } : {})
-    };
-  }
-
-  throw new Error(`Unsupported MCP method: ${method}`);
-}
-
-async function callTool(name, args) {
-  return runVibeRaven(['-y', CLI_PACKAGE, ...buildToolArgs(name, args || {})], args && args.cwd);
-}
-
+  {
+    name: 'viberaven_verify',
+    description: 'Rescan and refresh VibeRaven production-readiness artifacts after a fix.',
+    inputSchema: cwdSchema
+  },
+  {
+    name: 'viberaven_audit',
+    description: 'Run local Vercel/Supabase production checks for RLS, service-role boundaries, and Vercel pooler usage.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        cwd: { type: 'string', description: 'Project root. Defaults to current working directory.' },
+        json: { type: 'boolean', description: 'Return JSON output.' }
+      },
+      additionalProperties: false
+    }
+  },
+  {
+    name: 'viberaven_init_rules',
+    description: 'Install bounded VibeRaven rules into native AI instruction files.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        cwd: { type: 'string', description: 'Project root. Defaults to current working directory.' },
+        agents: { type: 'string', description: 'Comma-separated agent targets, or all.' },
+        dryRun: { type: 'boolean', description: 'Preview changes without writing files.' }
+      },
+      additionalProperties: false
+    }
+  },
+  {
+    name: 'viberaven_clean_plan',
+    description: 'Write a non-destructive context cleanup plan for generated artifacts and logs.',
+    inputSchema: cwdSchema
+  },
+  {
+    name: 'viberaven_strict_gate',
+    description: 'Run VibeRaven agent-mode strict gate and return the machine verdict.',
+    inputSchema: cwdSchema
+  },
+  {
+    name: 'viberaven_gate_result',
+    description: 'Run VibeRaven agent-mode JSON output and return gate-result.json content.',
+    inputSchema: cwdSchema
+  },
+  {
+    name: 'viberaven_context_map',
+    description: 'Refresh .viberaven/context-map.json from the last scan.',
+    inputSchema: cwdSchema
+  },
+  {
+    name: 'viberaven_heal_plan',
+    description: 'Write a non-destructive VibeRaven heal plan for a target file or gap.',
+    inputSchema: healSchema
+  },
+  {
+    name: 'viberaven_heal_prompt',
+    description: 'Write an agent-ready VibeRaven heal prompt for a target file or gap.',
+    inputSchema: healSchema
+  },
+  {
+    name: 'viberaven_heal_apply',
+    description: 'Apply a guarded VibeRaven repo-code heal recipe when supported.',
+    inputSchema: healSchema
+  },
+  {
+    name: 'viberaven_validate_npm_package',
+    description:
+      'Check whether an npm package name exists and looks safe before install. Always run viberaven --agent-mode after adding dependencies.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        packageName: { type: 'string', description: 'Single npm package name to validate.' },
+        packageNames: {
+          type: 'array',
+          items: { type: 'string' },
+          description: 'Multiple npm package names to validate in one call.'
+        }
+      },
+      additionalProperties: false
+    }
+  }
+];
+
+let buffer = Buffer.alloc(0);
+
+function main() {
+  if (process.argv.includes('--help') || process.argv.includes('-h')) {
+    console.log(`${SERVER_INFO.name} ${SERVER_INFO.version}`);
+    console.log(`MCP stdio server wrapping npx -y ${CLI_PACKAGE}.`);
+    process.exit(0);
+  }
+
+  process.stdin.on('data', (chunk) => {
+    buffer = Buffer.concat([buffer, chunk]);
+    drainMessages();
+  });
+}
+
+function drainMessages() {
+  while (true) {
+    const headerEnd = buffer.indexOf('\r\n\r\n');
+    if (headerEnd === -1) return;
+
+    const header = buffer.slice(0, headerEnd).toString('utf8');
+    const match = header.match(/content-length:\s*(\d+)/i);
+    if (!match) {
+      buffer = buffer.slice(headerEnd + 4);
+      continue;
+    }
+
+    const length = Number(match[1]);
+    const messageStart = headerEnd + 4;
+    const messageEnd = messageStart + length;
+    if (buffer.length < messageEnd) return;
+
+    const raw = buffer.slice(messageStart, messageEnd).toString('utf8');
+    buffer = buffer.slice(messageEnd);
+    void handleRawMessage(raw);
+  }
+}
+
+async function handleRawMessage(raw) {
+  let message;
+  try {
+    message = JSON.parse(raw);
+  } catch {
+    return;
+  }
+
+  if (!message || typeof message.method !== 'string') return;
+  if (message.id === undefined || message.id === null) return;
+
+  try {
+    const result = await handleRequest(message.method, message.params || {});
+    send({ jsonrpc: '2.0', id: message.id, result });
+  } catch (error) {
+    send({
+      jsonrpc: '2.0',
+      id: message.id,
+      error: {
+        code: -32000,
+        message: error instanceof Error ? error.message : String(error)
+      }
+    });
+  }
+}
+
+async function handleRequest(method, params) {
+  if (method === 'initialize') {
+    return {
+      protocolVersion: params.protocolVersion || '2024-11-05',
+      capabilities: { tools: {} },
+      serverInfo: SERVER_INFO
+    };
+  }
+
+  if (method === 'tools/list') {
+    return { tools: TOOLS };
+  }
+
+  if (method === 'tools/call') {
+    const name = params.name;
+    const args = params.arguments || {};
+    const text = await callTool(name, args);
+    const parsed = parseJsonObjectFromToolText(text);
+    return {
+      content: [{ type: 'text', text }],
+      ...(parsed ? { structuredContent: parsed } : {})
+    };
+  }
+
+  throw new Error(`Unsupported MCP method: ${method}`);
+}
+
+async function callTool(name, args) {
+  return runVibeRaven(['-y', CLI_PACKAGE, ...buildToolArgs(name, args || {})], args && args.cwd);
+}
+
 function buildToolArgs(name, args) {
   if (name === 'viberaven_check_readiness') {
-    return ['--agent-mode'];
-  }
-  if (name === 'viberaven_verify') {
-    return ['--verify'];
-  }
-  if (name === 'viberaven_audit') {
-    return ['audit', '--vercel-supabase', ...(args.json ? ['--json'] : [])];
-  }
-  if (name === 'viberaven_init_rules') {
-    const cliArgs = ['init'];
-    if (args.agents) cliArgs.push('--agents', safeStringArg(args.agents, 'agents'));
-    if (args.dryRun) cliArgs.push('--dry-run');
-    return cliArgs;
-  }
-  if (name === 'viberaven_clean_plan') {
-    return ['clean', '--plan'];
-  }
-  if (name === 'viberaven_strict_gate') {
-    return ['--agent-mode', '--strict', '--json'];
-  }
-  if (name === 'viberaven_gate_result') {
-    return ['--agent-mode', '--json'];
-  }
-  if (name === 'viberaven_context_map') {
-    return ['--condense'];
-  }
-  if (name === 'viberaven_heal_plan') {
-    return buildHealArgs(['--heal', '--plan'], args);
-  }
-  if (name === 'viberaven_heal_prompt') {
-    return buildHealArgs(['--heal', '--prompt'], args);
-  }
-  if (name === 'viberaven_heal_apply') {
-    const cliArgs = buildHealArgs(['--heal', '--apply'], args);
-    if (args.yes === true) cliArgs.push('--yes');
-    return cliArgs;
-  }
-  if (name === 'viberaven_validate_npm_package') {
-    const names = [];
-    if (args.packageName) {
-      names.push(safeStringArg(args.packageName, 'packageName'));
-    }
-    if (Array.isArray(args.packageNames)) {
-      for (const entry of args.packageNames) {
-        names.push(safeStringArg(entry, 'packageName'));
-      }
-    }
-    if (names.length === 0) {
-      throw new Error('packageName or packageNames is required');
-    }
-    return ['validate-npm-package', '--json', ...names];
-  }
-  throw new Error(`Unknown VibeRaven tool: ${name}`);
-}
-
-function buildHealArgs(prefix, args) {
-  const cliArgs = [...prefix];
-  if (args.target) cliArgs.push('--target', safeStringArg(args.target, 'target'));
-  if (args.gap) cliArgs.push('--gap', safeStringArg(args.gap, 'gap'));
-  return cliArgs;
-}
-
-function safeStringArg(value, label) {
-  if (typeof value !== 'string') {
-    throw new Error(`Invalid ${label}: expected string`);
-  }
-
-  if (!value.trim()) {
-    throw new Error(`Invalid ${label}: expected non-empty string`);
+    return ['--agent-mode', ...launchModeArgs(args)];
   }
-
-  if (/[&|<>^%!"\r\n]/.test(value)) {
-    throw new Error(`Unsafe characters in ${label}`);
-  }
-
-  return value;
+  if (name === 'viberaven_verify') {
+    return ['--verify'];
+  }
+  if (name === 'viberaven_audit') {
+    return ['audit', '--vercel-supabase', ...(args.json ? ['--json'] : [])];
+  }
+  if (name === 'viberaven_init_rules') {
+    const cliArgs = ['init'];
+    if (args.agents) cliArgs.push('--agents', safeStringArg(args.agents, 'agents'));
+    if (args.dryRun) cliArgs.push('--dry-run');
+    return cliArgs;
+  }
+  if (name === 'viberaven_clean_plan') {
+    return ['clean', '--plan'];
+  }
+  if (name === 'viberaven_strict_gate') {
+    return ['--agent-mode', '--strict', '--json'];
+  }
+  if (name === 'viberaven_gate_result') {
+    return ['--agent-mode', '--json'];
+  }
+  if (name === 'viberaven_context_map') {
+    return ['--condense'];
+  }
+  if (name === 'viberaven_heal_plan') {
+    return buildHealArgs(['--heal', '--plan'], args);
+  }
+  if (name === 'viberaven_heal_prompt') {
+    return buildHealArgs(['--heal', '--prompt'], args);
+  }
+  if (name === 'viberaven_heal_apply') {
+    const cliArgs = buildHealArgs(['--heal', '--apply'], args);
+    if (args.yes === true) cliArgs.push('--yes');
+    return cliArgs;
+  }
+  if (name === 'viberaven_validate_npm_package') {
+    const names = [];
+    if (args.packageName) {
+      names.push(safeStringArg(args.packageName, 'packageName'));
+    }
+    if (Array.isArray(args.packageNames)) {
+      for (const entry of args.packageNames) {
+        names.push(safeStringArg(entry, 'packageName'));
+      }
+    }
+    if (names.length === 0) {
+      throw new Error('packageName or packageNames is required');
+    }
+    return ['validate-npm-package', '--json', ...names];
+  }
+  throw new Error(`Unknown VibeRaven tool: ${name}`);
 }
 
-function resolveCwd(cwd) {
-  if (cwd === undefined || cwd === null) {
-    return process.cwd();
+function launchModeArgs(args) {
+  if (!args.launchMode) return [];
+  const allowed = new Set(['manual', 'ask', 'safe', 'full']);
+  if (!allowed.has(args.launchMode)) {
+    throw new Error('Invalid launchMode');
   }
-
-  if (typeof cwd !== 'string') {
-    throw new Error('Invalid cwd: expected string');
-  }
-
-  if (!cwd.trim()) {
-    throw new Error('Invalid cwd: expected non-empty string');
-  }
-
-  return cwd;
+  return ['--launch-mode', args.launchMode];
 }
-
-function buildNpxCommand(args) {
-  if (process.platform === 'win32') {
-    return {
-      command: 'cmd.exe',
-      args: ['/d', '/s', '/c', 'npx', ...args],
-      options: { shell: false }
-    };
-  }
-
-  return {
-    command: 'npx',
-    args,
-    options: { shell: false }
-  };
-}
-
-function runVibeRaven(args, cwd) {
-  return new Promise((resolve) => {
-    const built = buildNpxCommand(args);
-    const child = spawnChild(built.command, built.args, {
-      cwd: resolveCwd(cwd),
-      env: process.env,
-      shell: built.options.shell,
-      stdio: ['ignore', 'pipe', 'pipe']
-    });
-    let stdout = '';
-    let stderr = '';
-    child.stdout.on('data', (chunk) => {
-      stdout += chunk.toString();
-    });
-    child.stderr.on('data', (chunk) => {
-      stderr += chunk.toString();
-    });
-    child.on('error', (error) => {
-      resolve(`ERROR: ${error.message}`);
-    });
-    child.on('close', (code) => {
-      const combined = `${stdout}${stderr}`.trim();
-      resolve(`exit ${code ?? 1}${combined ? `\n${combined}` : ''}`);
-    });
-  });
-}
-
-function parseJsonObjectFromToolText(text) {
-  const jsonStart = text.indexOf('{');
-  if (jsonStart === -1) return undefined;
-  try {
-    return JSON.parse(text.slice(jsonStart));
-  } catch {
-    return undefined;
-  }
-}
-
-function send(message) {
-  const body = JSON.stringify(message);
-  process.stdout.write(`Content-Length: ${Buffer.byteLength(body, 'utf8')}\r\n\r\n${body}`);
-}
-
-if (require.main === module) {
-  main();
-}
-
-module.exports = {
-  TOOLS,
-  buildNpxCommand,
-  callTool,
-  handleRequest,
-  parseJsonObjectFromToolText,
-  safeStringArg,
-  __setSpawnForTest(spawnForTest) {
-    spawnChild = spawnForTest;
-  },
-  __resetSpawnForTest() {
-    spawnChild = spawn;
-  }
-};
+
+function buildHealArgs(prefix, args) {
+  const cliArgs = [...prefix];
+  if (args.target) cliArgs.push('--target', safeStringArg(args.target, 'target'));
+  if (args.gap) cliArgs.push('--gap', safeStringArg(args.gap, 'gap'));
+  return cliArgs;
+}
+
+function safeStringArg(value, label) {
+  if (typeof value !== 'string') {
+    throw new Error(`Invalid ${label}: expected string`);
+  }
+
+  if (!value.trim()) {
+    throw new Error(`Invalid ${label}: expected non-empty string`);
+  }
+
+  if (/[&|<>^%!"\r\n]/.test(value)) {
+    throw new Error(`Unsafe characters in ${label}`);
+  }
+
+  return value;
+}
+
+function resolveCwd(cwd) {
+  if (cwd === undefined || cwd === null) {
+    return process.cwd();
+  }
+
+  if (typeof cwd !== 'string') {
+    throw new Error('Invalid cwd: expected string');
+  }
+
+  if (!cwd.trim()) {
+    throw new Error('Invalid cwd: expected non-empty string');
+  }
+
+  return cwd;
+}
+
+function buildNpxCommand(args) {
+  if (process.platform === 'win32') {
+    return {
+      command: 'cmd.exe',
+      args: ['/d', '/s', '/c', 'npx', ...args],
+      options: { shell: false }
+    };
+  }
+
+  return {
+    command: 'npx',
+    args,
+    options: { shell: false }
+  };
+}
+
+function runVibeRaven(args, cwd) {
+  return new Promise((resolve) => {
+    const built = buildNpxCommand(args);
+    const child = spawnChild(built.command, built.args, {
+      cwd: resolveCwd(cwd),
+      env: process.env,
+      shell: built.options.shell,
+      stdio: ['ignore', 'pipe', 'pipe']
+    });
+    let stdout = '';
+    let stderr = '';
+    child.stdout.on('data', (chunk) => {
+      stdout += chunk.toString();
+    });
+    child.stderr.on('data', (chunk) => {
+      stderr += chunk.toString();
+    });
+    child.on('error', (error) => {
+      resolve(`ERROR: ${error.message}`);
+    });
+    child.on('close', (code) => {
+      const combined = `${stdout}${stderr}`.trim();
+      resolve(`exit ${code ?? 1}${combined ? `\n${combined}` : ''}`);
+    });
+  });
+}
+
+function parseJsonObjectFromToolText(text) {
+  const jsonStart = text.indexOf('{');
+  if (jsonStart === -1) return undefined;
+  try {
+    return JSON.parse(text.slice(jsonStart));
+  } catch {
+    return undefined;
+  }
+}
+
+function send(message) {
+  const body = JSON.stringify(message);
+  process.stdout.write(`Content-Length: ${Buffer.byteLength(body, 'utf8')}\r\n\r\n${body}`);
+}
+
+if (require.main === module) {
+  main();
+}
+
+module.exports = {
+  TOOLS,
+  buildNpxCommand,
+  callTool,
+  handleRequest,
+  parseJsonObjectFromToolText,
+  safeStringArg,
+  __setSpawnForTest(spawnForTest) {
+    spawnChild = spawnForTest;
+  },
+  __resetSpawnForTest() {
+    spawnChild = spawn;
+  }
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@viberaven/mcp",
-  "version": "1.0.5",
-  "description": "Thin MCP wrapper around the VibeRaven CLI for agent launch-readiness workflows.",
+  "version": "1.0.7",
+  "description": "MCP server for VibeRaven production-readiness: check_readiness, verify, heal, audit, and strict gate tools for Cursor, Claude Code, and Codex.",
   "license": "UNLICENSED",
   "author": "VibeRaven",
   "mcpName": "io.github.ohad6k/viberaven",