@monoes/monomindcli 2.9.23 → 2.9.25

package/dist/src/commands/mcp.js

@@ -5,10 +5,10 @@
  * @module @monomind/cli/commands/mcp
  * @version 3.0.0
  */
+import { callMCPTool, hasTool, listMCPTools } from '../mcp-client.js';
+import { getMCPServerStatus, getServerManager } from '../mcp-server.js';
 import { output } from '../output.js';
 import { confirm } from '../prompt.js';
-import { getServerManager, getMCPServerStatus, } from '../mcp-server.js';
-import { listMCPTools, callMCPTool, hasTool } from '../mcp-client.js';
 // MCP tools categories — `value` must match the literal `category` field set
 // on registered MCPTool entries (see mcp-tools/*.ts), not the lazy-load
 // category key in mcp-client.ts's CATEGORY_LOADERS. Values that don't match
@@ -19,7 +19,7 @@ const TOOL_CATEGORIES = [
     { value: 'performance', label: 'Monitoring', hint: 'Status and metrics monitoring' },
     { value: 'knowledge', label: 'Memory', hint: 'Memory and neural features' },
     { value: 'github', label: 'GitHub', hint: 'GitHub integration tools' },
-    { value: 'system', label: 'System', hint: 'System and benchmark tools' }
+    { value: 'system', label: 'System', hint: 'System and benchmark tools' },
 ];
 /**
  * Format uptime for display
@@ -47,14 +47,14 @@ const startCommand = {
             short: 'p',
             description: 'Server port',
             type: 'number',
-            default: 3000
+            default: 3000,
         },
         {
             name: 'host',
             short: 'h',
             description: 'Server host',
             type: 'string',
-            default: 'localhost'
+            default: 'localhost',
         },
         {
             name: 'transport',
@@ -62,34 +62,34 @@ const startCommand = {
             description: 'Transport type (stdio, http, websocket)',
             type: 'string',
             default: 'stdio',
-            choices: ['stdio', 'http', 'websocket']
+            choices: ['stdio', 'http', 'websocket'],
         },
         {
             name: 'tools',
             description: 'Tools to enable (comma-separated or "all")',
             type: 'string',
-            default: 'all'
+            default: 'all',
         },
         {
             name: 'daemon',
             short: 'd',
             description: 'Run as background daemon',
             type: 'boolean',
-            default: false
+            default: false,
         },
         {
             name: 'force',
             short: 'f',
             description: 'Force restart (kill existing server first)',
             type: 'boolean',
-            default: false
-        }
+            default: false,
+        },
     ],
     examples: [
         { command: 'monomind mcp start', description: 'Start with defaults (stdio)' },
         { command: 'monomind mcp start -p 8080 -t http', description: 'Start HTTP server' },
         { command: 'monomind mcp start -d', description: 'Start as daemon' },
-        { command: 'monomind mcp start -f', description: 'Force restart (kill existing)' }
+        { command: 'monomind mcp start -f', description: 'Force restart (kill existing)' },
     ],
     action: async (ctx) => {
         const rawPort = ctx.flags.port ?? 3000;
@@ -175,7 +175,7 @@ const startCommand = {
                 // rather than a hardcoded figure — this varies with MONOMIND_MCP_FULL
                 // and any disabled-tools config.
                 const registeredTools = await listMCPTools();
-                const enabledCount = registeredTools.filter(t => t.enabled).length;
+                const enabledCount = registeredTools.filter((t) => t.enabled).length;
                 toolsValue = `${enabledCount} enabled`;
             }
             else {
@@ -185,7 +185,7 @@ const startCommand = {
             output.printTable({
                 columns: [
                     { key: 'property', header: 'Property', width: 15 },
-                    { key: 'value', header: 'Value', width: 30 }
+                    { key: 'value', header: 'Value', width: 30 },
                 ],
                 data: [
                     { property: 'Server PID', value: status.pid || process.pid },
@@ -193,8 +193,8 @@ const startCommand = {
                     { property: 'Host', value: host },
                     { property: 'Port', value: port },
                     { property: 'Tools', value: toolsValue },
-                    { property: 'Status', value: output.success('Running') }
-                ]
+                    { property: 'Status', value: output.success('Running') },
+                ],
             });
             output.writeln();
             output.printSuccess('MCP Server started');
@@ -214,7 +214,7 @@ const startCommand = {
             output.printError(`Failed to start MCP server: ${error.message}`);
             return { success: false, exitCode: 1 };
         }
-    }
+    },
 };
 // Stop MCP server
 const stopCommand = {
@@ -226,8 +226,8 @@ const stopCommand = {
             short: 'f',
             description: 'Force stop without graceful shutdown',
             type: 'boolean',
-            default: false
-        }
+            default: false,
+        },
     ],
     action: async (ctx) => {
         const force = ctx.flags.force;
@@ -240,7 +240,7 @@ const stopCommand = {
         if (!force && ctx.interactive) {
             const confirmed = await confirm({
                 message: `Stop MCP server (PID: ${status.pid})?`,
-                default: false
+                default: false,
             });
             if (!confirmed) {
                 output.printInfo('Operation cancelled');
@@ -263,7 +263,7 @@ const stopCommand = {
             output.printError(`Failed to stop MCP server: ${error.message}`);
             return { success: false, exitCode: 1 };
         }
-    }
+    },
 };
 // MCP status
 const statusCommand = {
@@ -299,11 +299,9 @@ const statusCommand = {
                 output.printTable({
                     columns: [
                         { key: 'metric', header: 'Metric', width: 20 },
-                        { key: 'value', header: 'Value', width: 20, align: 'right' }
+                        { key: 'value', header: 'Value', width: 20, align: 'right' },
                     ],
-                    data: [
-                        { metric: 'Status', value: output.error('Stopped') }
-                    ]
+                    data: [{ metric: 'Status', value: output.error('Stopped') }],
                 });
                 output.writeln();
                 output.writeln(output.dim('Run "monomind mcp start" to start the server'));
@@ -330,13 +328,13 @@ const statusCommand = {
                     metric: 'Health',
                     value: status.health.healthy
                         ? output.success('Healthy')
-                        : output.error(status.health.error || 'Unhealthy')
+                        : output.error(status.health.error || 'Unhealthy'),
                 });
                 if (status.health.metrics) {
                     for (const [key, value] of Object.entries(status.health.metrics)) {
                         displayData.push({
                             metric: `  ${key}`,
-                            value: String(value)
+                            value: String(value),
                         });
                     }
                 }
@@ -344,9 +342,9 @@ const statusCommand = {
             output.printTable({
                 columns: [
                     { key: 'metric', header: 'Metric', width: 20 },
-                    { key: 'value', header: 'Value', width: 25, align: 'right' }
+                    { key: 'value', header: 'Value', width: 25, align: 'right' },
                 ],
-                data: displayData
+                data: displayData,
             });
             return { success: true, data: status };
         }
@@ -354,7 +352,7 @@ const statusCommand = {
             output.printError(`Failed to get status: ${error.message}`);
             return { success: false, exitCode: 1 };
         }
-    }
+    },
 };
 // List tools
 const toolsCommand = {
@@ -366,25 +364,25 @@ const toolsCommand = {
             short: 'c',
             description: 'Filter by category',
             type: 'string',
-            choices: TOOL_CATEGORIES.map(c => c.value)
+            choices: TOOL_CATEGORIES.map((c) => c.value),
         },
         {
             name: 'enabled',
             description: 'Show only enabled tools',
             type: 'boolean',
-            default: false
-        }
+            default: false,
+        },
     ],
     action: async (ctx) => {
         const category = ctx.flags.category;
         // Use local tool registry — no static fallback. If the registry can't be
         // loaded, let the error propagate rather than showing a fabricated list.
         const registeredTools = await listMCPTools(category);
-        const tools = registeredTools.map(tool => ({
+        const tools = registeredTools.map((tool) => ({
             name: tool.name,
             category: tool.category || 'uncategorized',
             description: tool.description,
-            enabled: tool.enabled
+            enabled: tool.enabled,
         }));
         if (ctx.flags.format === 'json') {
             output.printJson(tools);
@@ -410,16 +408,21 @@ const toolsCommand = {
                 columns: [
                     { key: 'name', header: 'Tool', width: 25 },
                     { key: 'description', header: 'Description', width: 35 },
-                    { key: 'enabled', header: 'Status', width: 10, format: (v) => v ? output.success('Enabled') : output.dim('Disabled') }
+                    {
+                        key: 'enabled',
+                        header: 'Status',
+                        width: 10,
+                        format: (v) => v ? output.success('Enabled') : output.dim('Disabled'),
+                    },
                 ],
                 data: catTools,
-                border: false
+                border: false,
             });
             output.writeln();
         }
         output.printInfo(`Total: ${tools.length} tools`);
         return { success: true, data: tools };
-    }
+    },
 };
 // Enable/disable tools
 const toggleCommand = {
@@ -430,14 +433,14 @@ const toggleCommand = {
             name: 'enable',
             short: 'e',
             description: 'Enable tools',
-            type: 'string'
+            type: 'string',
         },
         {
             name: 'disable',
             short: 'd',
             description: 'Disable tools',
-            type: 'string'
-        }
+            type: 'string',
+        },
     ],
     action: async (ctx) => {
         const fs = await import('node:fs');
@@ -458,7 +461,7 @@ const toggleCommand = {
             return { success: false, exitCode: 1 };
         }
         if (disableArg) {
-            const tools = disableArg.split(',').map(t => t.trim());
+            const tools = disableArg.split(',').map((t) => t.trim());
             for (const t of tools) {
                 if (!disabled.includes(t))
                     disabled.push(t);
@@ -466,17 +469,17 @@ const toggleCommand = {
             output.printSuccess(`Disabled: ${tools.join(', ')}`);
         }
         if (enableArg) {
-            const tools = enableArg.split(',').map(t => t.trim());
-            disabled = disabled.filter(t => !tools.includes(t));
+            const tools = enableArg.split(',').map((t) => t.trim());
+            disabled = disabled.filter((t) => !tools.includes(t));
             output.printSuccess(`Enabled: ${tools.join(', ')}`);
         }
         fs.mkdirSync(path.dirname(stateFile), { recursive: true });
-        fs.writeFileSync(stateFile, JSON.stringify(disabled, null, 2) + '\n');
+        fs.writeFileSync(stateFile, `${JSON.stringify(disabled, null, 2)}\n`);
         output.writeln(output.dim(`State saved to ${stateFile}. ${disabled.length} tool(s) disabled.`));
         output.writeln(output.dim('Disabled tools are rejected immediately by direct CLI invocation.'));
         output.writeln(output.dim('An external MCP server (mcp start) must be restarted to stop exposing disabled tools to MCP clients.'));
         return { success: true };
-    }
+    },
 };
 // Execute tool
 const execCommand = {
@@ -488,17 +491,20 @@ const execCommand = {
             short: 't',
             description: 'Tool name',
             type: 'string',
-            required: true
+            required: true,
         },
         {
             name: 'params',
             short: 'p',
             description: 'Tool parameters (JSON)',
-            type: 'string'
-        }
+            type: 'string',
+        },
     ],
     examples: [
-        { command: 'monomind mcp exec -t monoswarm_init -p \'{"topology":"mesh"}\'', description: 'Execute tool' }
+        {
+            command: 'monomind mcp exec -t monoswarm_init -p \'{"topology":"mesh"}\'',
+            description: 'Execute tool',
+        },
     ],
     action: async (ctx) => {
         const tool = ctx.flags.tool || ctx.args[0];
@@ -512,7 +518,7 @@ const execCommand = {
             try {
                 params = JSON.parse(paramsStr);
             }
-            catch (e) {
+            catch (_e) {
                 output.printError('Invalid JSON parameters');
                 return { success: false, exitCode: 1 };
             }
@@ -523,7 +529,7 @@ const execCommand = {
         }
         try {
             // Execute through local MCP tool registry
-            if (!await hasTool(tool)) {
+            if (!(await hasTool(tool))) {
                 output.printError(`Tool not found: ${tool}`);
                 return { success: false, exitCode: 1 };
             }
@@ -549,7 +555,7 @@ const execCommand = {
             output.printError(`Tool execution failed: ${error.message}`);
             return { success: false, exitCode: 1 };
         }
-    }
+    },
 };
 // Health check command
 const healthCommand = {
@@ -590,7 +596,7 @@ const healthCommand = {
             output.printError(`Health check failed: ${error.message}`);
             return { success: false, exitCode: 1 };
         }
-    }
+    },
 };
 // Logs command
 export const logsCommand = {
@@ -602,42 +608,42 @@ export const logsCommand = {
             short: 'n',
             description: 'Number of lines',
             type: 'number',
-            default: 20
+            default: 20,
         },
         {
             name: 'follow',
             short: 'f',
             description: 'Follow log output',
             type: 'boolean',
-            default: false
+            default: false,
         },
         {
             name: 'level',
             description: 'Filter by log level',
             type: 'string',
-            choices: ['debug', 'info', 'warn', 'error']
-        }
+            choices: ['debug', 'info', 'warn', 'error'],
+        },
     ],
     action: async (ctx) => {
         const lines = ctx.flags.lines || 50;
         const follow = ctx.flags.follow;
         const levelFilter = ctx.flags.level?.toLowerCase();
         // Try to find and read the actual log file
-        const { existsSync, readFileSync, statSync, watch, createReadStream } = await import('fs');
-        const { join } = await import('path');
+        const { existsSync, readFileSync, statSync, watch, createReadStream } = await import('node:fs');
+        const { join } = await import('node:path');
         const MAX_MCP_LOG_BYTES = 10 * 1024 * 1024; // 10 MB
         const logPaths = [
             join(ctx.cwd, '.monomind', 'logs', 'mcp-server.log'),
             join(ctx.cwd, '.monomind', 'logs', 'daemon.log'),
             join(ctx.cwd, '.monomind', 'mcp.log'),
         ];
-        const logFile = logPaths.find(p => existsSync(p) && statSync(p).size <= MAX_MCP_LOG_BYTES);
+        const logFile = logPaths.find((p) => existsSync(p) && statSync(p).size <= MAX_MCP_LOG_BYTES);
         output.writeln();
         output.writeln(output.bold('MCP Server Logs'));
         output.writeln(output.dim('─'.repeat(50)));
         if (!logFile) {
             output.writeln(output.dim('No log files found. Start the MCP server to generate logs.'));
-            output.writeln(output.dim(`Checked: ${logPaths.map(p => p.replace(ctx.cwd, '.')).join(', ')}`));
+            output.writeln(output.dim(`Checked: ${logPaths.map((p) => p.replace(ctx.cwd, '.')).join(', ')}`));
             if (follow) {
                 output.printError('--follow requires an existing log file to watch — none was found.');
                 return { success: false };
@@ -653,13 +659,15 @@ export const logsCommand = {
         const logLines = content.trim().split('\n').filter(Boolean).filter(matchesLevel);
         const tail = logLines.slice(-lines);
         if (tail.length === 0) {
-            output.writeln(output.dim(levelFilter ? `Log file has no lines matching level "${levelFilter}".` : 'Log file is empty.'));
+            output.writeln(output.dim(levelFilter
+                ? `Log file has no lines matching level "${levelFilter}".`
+                : 'Log file is empty.'));
         }
         else {
             output.writeln(output.dim(`Showing last ${tail.length} lines from ${logFile.replace(ctx.cwd, '.')}` +
                 (levelFilter ? ` (level=${levelFilter})` : '')));
             output.writeln();
-            tail.forEach(line => output.writeln(line));
+            tail.forEach((line) => output.writeln(line));
         }
         if (!follow) {
             return { success: true };
@@ -693,9 +701,15 @@ export const logsCommand = {
                     reading = false;
                     return;
                 }
-                const stream = createReadStream(logFile, { start: position, end: size - 1, encoding: 'utf8' });
+                const stream = createReadStream(logFile, {
+                    start: position,
+                    end: size - 1,
+                    encoding: 'utf8',
+                });
                 let chunkData = '';
-                stream.on('data', (chunk) => { chunkData += chunk; });
+                stream.on('data', (chunk) => {
+                    chunkData += chunk;
+                });
                 stream.on('end', () => {
                     position = size;
                     const combined = pendingPartialLine + chunkData;
@@ -707,7 +721,9 @@ export const logsCommand = {
                     }
                     reading = false;
                 });
-                stream.on('error', () => { reading = false; });
+                stream.on('error', () => {
+                    reading = false;
+                });
             };
             const watcher = watch(logFile, { persistent: true }, (eventType) => {
                 if (eventType === 'change')
@@ -719,7 +735,7 @@ export const logsCommand = {
             };
             process.once('SIGINT', stop);
         });
-    }
+    },
 };
 // Restart command
 const restartCommand = {
@@ -731,11 +747,11 @@ const restartCommand = {
             short: 'f',
             description: 'Force restart without graceful shutdown',
             type: 'boolean',
-            default: false
-        }
+            default: false,
+        },
     ],
     action: async (ctx) => {
-        const force = ctx.flags.force;
+        const _force = ctx.flags.force;
         output.printInfo('Restarting MCP Server...');
         try {
             const manager = getServerManager();
@@ -748,7 +764,7 @@ const restartCommand = {
             output.printError(`Failed to restart: ${error.message}`);
             return { success: false, exitCode: 1 };
         }
-    }
+    },
 };
 // Verify subcommand — bridges the new-user "did the install actually work?" gap (P0-16).
 // Runs after `claude mcp add monomind -- npx -y monomind@latest mcp start` to give the
@@ -771,7 +787,11 @@ const verifyCommand = {
         try {
             const tools = await listMCPTools();
             toolCount = tools.length;
-            checks.push({ label: 'Tool registry', ok: toolCount > 0, detail: `${toolCount} tools registered` });
+            checks.push({
+                label: 'Tool registry',
+                ok: toolCount > 0,
+                detail: `${toolCount} tools registered`,
+            });
         }
         catch (e) {
             checks.push({ label: 'Tool registry', ok: false, detail: `error: ${e.message}` });
@@ -780,17 +800,29 @@ const verifyCommand = {
         const sampleTool = 'system_info';
         try {
             const has = await hasTool(sampleTool);
-            checks.push({ label: `Sample tool (${sampleTool})`, ok: has, detail: has ? 'resolves' : 'missing' });
+            checks.push({
+                label: `Sample tool (${sampleTool})`,
+                ok: has,
+                detail: has ? 'resolves' : 'missing',
+            });
         }
         catch (e) {
-            checks.push({ label: `Sample tool (${sampleTool})`, ok: false, detail: `error: ${e.message}` });
+            checks.push({
+                label: `Sample tool (${sampleTool})`,
+                ok: false,
+                detail: `error: ${e.message}`,
+            });
         }
         // 3. claude mcp list includes monomind (best-effort; skip if claude CLI missing)
         try {
             const { spawnSync } = await import('node:child_process');
             const result = spawnSync('claude', ['mcp', 'list'], { encoding: 'utf8', timeout: 5000 });
             if (result.error || result.status !== 0) {
-                checks.push({ label: 'claude mcp registration', ok: false, detail: 'claude CLI unavailable or returned non-zero — run `claude mcp add monomind -- npx -y monomind@latest mcp start` to register' });
+                checks.push({
+                    label: 'claude mcp registration',
+                    ok: false,
+                    detail: 'claude CLI unavailable or returned non-zero — run `claude mcp add monomind -- npx -y monomind@latest mcp start` to register',
+                });
             }
             else {
                 const listed = (result.stdout || '').toLowerCase();
@@ -798,12 +830,18 @@ const verifyCommand = {
                 checks.push({
                     label: 'claude mcp registration',
                     ok: registered,
-                    detail: registered ? 'monomind appears in `claude mcp list`' : 'monomind NOT in `claude mcp list` — run `claude mcp add monomind -- npx -y monomind@latest mcp start`',
+                    detail: registered
+                        ? 'monomind appears in `claude mcp list`'
+                        : 'monomind NOT in `claude mcp list` — run `claude mcp add monomind -- npx -y monomind@latest mcp start`',
                 });
             }
         }
         catch {
-            checks.push({ label: 'claude mcp registration', ok: false, detail: 'claude CLI not found — install Claude Code or register manually' });
+            checks.push({
+                label: 'claude mcp registration',
+                ok: false,
+                detail: 'claude CLI not found — install Claude Code or register manually',
+            });
         }
         // Render
         let allOk = true;
@@ -821,7 +859,7 @@ const verifyCommand = {
             output.printError('One or more checks failed. Fix the issues above and re-run `monomind mcp verify`.');
         }
         return { success: allOk, exitCode: allOk ? 0 : 1 };
-    }
+    },
 };
 // Main MCP command
 export const mcpCommand = {
@@ -842,13 +880,19 @@ export const mcpCommand = {
     options: [],
     examples: [
         { command: 'monomind mcp start', description: 'Start MCP server' },
-        { command: 'monomind mcp start -t http -p 8080', description: 'Start HTTP server on port 8080' },
+        {
+            command: 'monomind mcp start -t http -p 8080',
+            description: 'Start HTTP server on port 8080',
+        },
         { command: 'monomind mcp status', description: 'Show server status' },
         { command: 'monomind mcp tools', description: 'List tools' },
-        { command: 'monomind mcp verify', description: 'Verify the MCP server is reachable and tools respond' },
-        { command: 'monomind mcp stop', description: 'Stop the server' }
+        {
+            command: 'monomind mcp verify',
+            description: 'Verify the MCP server is reachable and tools respond',
+        },
+        { command: 'monomind mcp stop', description: 'Stop the server' },
     ],
-    action: async (ctx) => {
+    action: async (_ctx) => {
         output.writeln();
         output.writeln(output.bold('MCP Server Management'));
         output.writeln();
@@ -865,10 +909,10 @@ export const mcpCommand = {
             `${output.highlight('toggle')}   - Enable/disable tools`,
             `${output.highlight('exec')}     - Execute a tool`,
             `${output.highlight('logs')}     - Show server logs`,
-            `${output.highlight('verify')}   - Verify the MCP server is reachable and tools respond`
+            `${output.highlight('verify')}   - Verify the MCP server is reachable and tools respond`,
         ]);
         return { success: true };
-    }
+    },
 };
 export default mcpCommand;
 //# sourceMappingURL=mcp.js.map