@monoes/cli 1.2.1 → 1.2.2

package/dist/src/mcp-tools/graphify-tools.js

@@ -824,6 +824,199 @@ export const graphifyVisualizeTool = {
         }
     },
 };
+// ── Watch PID helpers ─────────────────────────────────────────────────────────
+function getPidPath(cwd) {
+    return resolve(join(cwd, '.monobrain', 'graph', 'watch.pid'));
+}
+function readWatchPid(cwd) {
+    const pidPath = getPidPath(cwd);
+    if (!existsSync(pidPath))
+        return null;
+    try {
+        const pid = parseInt(readFileSync(pidPath, 'utf-8').trim(), 10);
+        return isNaN(pid) ? null : pid;
+    }
+    catch {
+        return null;
+    }
+}
+function isProcessRunning(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ── Watch tools ───────────────────────────────────────────────────────────────
+export const graphifyWatchTool = {
+    name: 'graphify_watch',
+    description: 'Start a background file watcher that automatically rebuilds the knowledge graph ' +
+        '(graph.json + graph.html) whenever source files change. Uses a 2-second debounce ' +
+        'so rapid saves do not trigger repeated rebuilds. The watcher runs as a detached ' +
+        'background process — call graphify_watch_stop to stop it.',
+    category: 'graphify',
+    tags: ['knowledge-graph', 'watch', 'auto-rebuild'],
+    inputSchema: {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'Project root to watch (defaults to current project root)',
+            },
+            debounce: {
+                type: 'number',
+                description: 'Debounce delay in milliseconds (default 2000)',
+                default: 2000,
+            },
+            extensions: {
+                type: 'string',
+                description: 'Comma-separated list of file extensions to watch (default: ts,js,tsx,jsx,py,go,rs,java,cs,rb,cpp,c)',
+                default: 'ts,js,tsx,jsx,py,go,rs,java,cs,rb,cpp,c',
+            },
+        },
+    },
+    handler: async (params) => {
+        const cwd = getProjectCwd();
+        const targetPath = params.path || cwd;
+        const debounceMs = params.debounce || 2000;
+        const extensions = ((params.extensions) || 'ts,js,tsx,jsx,py,go,rs,java,cs,rb,cpp,c')
+            .split(',')
+            .map((e) => e.trim())
+            .filter(Boolean);
+        // Check if already running
+        const existingPid = readWatchPid(targetPath);
+        if (existingPid !== null && isProcessRunning(existingPid)) {
+            return {
+                success: false,
+                message: `Watcher already running (PID ${existingPid})`,
+                hint: 'Call graphify_watch_stop first to restart.',
+            };
+        }
+        const pidPath = getPidPath(targetPath);
+        const outputDir = resolve(join(targetPath, '.monobrain', 'graph'));
+        const watcherScript = `
+import { watch } from 'chokidar';
+import { writeFileSync, mkdirSync } from 'fs';
+
+const TARGET = ${JSON.stringify(targetPath)};
+const OUTPUT_DIR = ${JSON.stringify(outputDir)};
+const PID_PATH = ${JSON.stringify(pidPath)};
+const DEBOUNCE_MS = ${debounceMs};
+const EXTS = new Set(${JSON.stringify(extensions)});
+const IGNORE = [/node_modules/, /\\.git/, /\\.monobrain/, /dist[\\/]/, /\\.next/, /\\.turbo/, /coverage/];
+
+mkdirSync(OUTPUT_DIR, { recursive: true });
+writeFileSync(PID_PATH, String(process.pid));
+console.log('[graphify-watch] PID', process.pid, '— watching', TARGET);
+
+let timer = null;
+
+async function rebuild() {
+  const start = Date.now();
+  console.log('[graphify-watch] Change detected — rebuilding graph…');
+  try {
+    const { buildGraph } = await import('@monoes/graph');
+    const { exportHTML } = await import('@monoes/graph');
+    const { graph: serialized } = await buildGraph(TARGET, { outputDir: OUTPUT_DIR });
+    exportHTML(serialized, OUTPUT_DIR);
+    console.log('[graphify-watch] Done in', Date.now() - start, 'ms');
+  } catch (err) {
+    console.error('[graphify-watch] Build error:', err.message ?? err);
+  }
+}
+
+const watcher = watch(TARGET, {
+  ignored: (p) => IGNORE.some((r) => r.test(p)),
+  persistent: true,
+  ignoreInitial: true,
+  awaitWriteFinish: { stabilityThreshold: 300, pollInterval: 100 },
+});
+
+watcher.on('all', (event, filePath) => {
+  const ext = filePath.split('.').pop() ?? '';
+  if (!EXTS.has(ext)) return;
+  if (timer) clearTimeout(timer);
+  timer = setTimeout(rebuild, DEBOUNCE_MS);
+});
+
+watcher.on('error', (err) => console.error('[graphify-watch] Watcher error:', err));
+process.on('SIGINT', () => process.exit(0));
+process.on('SIGTERM', () => process.exit(0));
+`;
+        try {
+            const { spawn } = await import('child_process');
+            const { writeFileSync, mkdirSync } = await import('fs');
+            mkdirSync(outputDir, { recursive: true });
+            const scriptPath = resolve(join(outputDir, '_watcher.mjs'));
+            writeFileSync(scriptPath, watcherScript);
+            const child = spawn(process.execPath, [scriptPath], {
+                detached: true,
+                stdio: 'ignore',
+                env: { ...process.env },
+            });
+            child.unref();
+            await new Promise((r) => setTimeout(r, 500));
+            const pid = readWatchPid(targetPath) ?? child.pid;
+            return {
+                success: true,
+                pid,
+                watching: targetPath,
+                debounceMs,
+                extensions,
+                message: `Graph watcher started (PID ${pid}). graph.json + graph.html will rebuild on file changes.`,
+                hint: 'Call graphify_watch_stop to stop.',
+            };
+        }
+        catch (err) {
+            return { error: true, message: String(err) };
+        }
+    },
+};
+export const graphifyWatchStopTool = {
+    name: 'graphify_watch_stop',
+    description: 'Stop the background file watcher started by graphify_watch.',
+    category: 'graphify',
+    tags: ['knowledge-graph', 'watch'],
+    inputSchema: {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'Project root (defaults to current project root)',
+            },
+        },
+    },
+    handler: async (params) => {
+        const cwd = getProjectCwd();
+        const targetPath = params.path || cwd;
+        const pid = readWatchPid(targetPath);
+        if (pid === null) {
+            return { success: false, message: 'No watcher PID found — watcher may not be running.' };
+        }
+        if (!isProcessRunning(pid)) {
+            try {
+                const { unlinkSync } = await import('fs');
+                unlinkSync(getPidPath(targetPath));
+            }
+            catch { /* ignore */ }
+            return { success: false, message: `Process ${pid} is not running (stale PID cleaned up).` };
+        }
+        try {
+            process.kill(pid, 'SIGTERM');
+            try {
+                const { unlinkSync } = await import('fs');
+                unlinkSync(getPidPath(targetPath));
+            }
+            catch { /* ignore */ }
+            return { success: true, message: `Watcher (PID ${pid}) stopped.` };
+        }
+        catch (err) {
+            return { error: true, message: `Failed to stop PID ${pid}: ${String(err)}` };
+        }
+    },
+};
 // ── Exports ───────────────────────────────────────────────────────────────────
 export const graphifyTools = [
     graphifyBuildTool,
@@ -835,6 +1028,8 @@ export const graphifyTools = [
     graphifyStatsTool,
     graphifySurprisesTool,
     graphifyVisualizeTool,
+    graphifyWatchTool,
+    graphifyWatchStopTool,
 ];
 export default graphifyTools;
 //# sourceMappingURL=graphify-tools.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monoes/cli",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "type": "module",
   "description": "Monobrain CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code",
   "main": "dist/src/index.js",