@monoes/monomindcli 2.6.1 → 2.7.1

package/bin/cli.js

@@ -72,7 +72,22 @@ if (isMCPMode) {
   // (or a slow trickle without newlines) cannot OOM-kill the process.
   const MAX_BUFFER_BYTES = 10 * 1024 * 1024;
   let buffer = '';
+  // Tracks handleMessage() calls still in flight when stdin closes — without
+  // this, 'end' calling process.exit(0) unconditionally could kill the process
+  // mid-handler and silently drop the response a client is still waiting on
+  // (issue #39).
+  let inFlight = 0;
+  let stdinEnded = false;
   process.stdin.setEncoding('utf8');
+  // process.stdout.write() to a pipe is NOT guaranteed synchronous — for a
+  // large payload (e.g. a full tools/list response) the OS write can still be
+  // in flight when the call returns. console.log() doesn't expose that, so
+  // calling process.exit() right after it can truncate/drop the very response
+  // being protected. Wait for the actual flush callback before allowing exit.
+  function writeLine(str) {
+    return new Promise((resolve) => process.stdout.write(str + '\n', resolve));
+  }
+
   process.stdin.on('data', async (chunk) => {
     buffer += chunk;
     if (buffer.length > MAX_BUFFER_BYTES) {
@@ -81,38 +96,51 @@ if (isMCPMode) {
     }
     let lines = buffer.split('\n');
     buffer = lines.pop() || '';
+    const toProcess = lines.filter((line) => line.trim());
+    // Reserve the WHOLE batch synchronously, before any `await` yields control —
+    // otherwise 'end' can fire in the gap between two lines of the same chunk
+    // (inFlight transiently reads 0 after line 1 finishes but before line 2's
+    // own increment runs), exiting mid-batch and dropping the rest silently.
+    inFlight += toProcess.length;
 
-    for (const line of lines) {
-      if (line.trim()) {
-        let parsed;
-        try {
-          parsed = JSON.parse(line);
-        } catch {
-          console.log(JSON.stringify({
-            jsonrpc: '2.0',
-            id: null,
-            error: { code: -32700, message: 'Parse error' },
-          }));
-          continue;
-        }
-        try {
-          const response = await handleMessage(parsed);
-          if (response) {
-            console.log(JSON.stringify(response));
-          }
-        } catch (error) {
-          console.log(JSON.stringify({
-            jsonrpc: '2.0',
-            id: parsed.id ?? null,
-            error: { code: -32603, message: error instanceof Error ? error.message : 'Internal error' },
-          }));
+    for (const line of toProcess) {
+      let parsed;
+      try {
+        parsed = JSON.parse(line);
+      } catch {
+        await writeLine(JSON.stringify({
+          jsonrpc: '2.0',
+          id: null,
+          error: { code: -32700, message: 'Parse error' },
+        }));
+        inFlight--;
+        if (stdinEnded && inFlight === 0) process.exit(0);
+        continue;
+      }
+      try {
+        const response = await handleMessage(parsed);
+        if (response) {
+          await writeLine(JSON.stringify(response));
         }
+      } catch (error) {
+        await writeLine(JSON.stringify({
+          jsonrpc: '2.0',
+          id: parsed.id ?? null,
+          error: { code: -32603, message: error instanceof Error ? error.message : 'Internal error' },
+        }));
+      } finally {
+        inFlight--;
+        if (stdinEnded && inFlight === 0) process.exit(0);
       }
     }
   });
 
   process.stdin.on('end', () => {
-    process.exit(0);
+    stdinEnded = true;
+    if (inFlight === 0) { process.exit(0); return; }
+    // Bounded safety net: don't hang forever if a handler is genuinely stuck.
+    const EXIT_GRACE_MS = 30000;
+    setTimeout(() => process.exit(0), EXIT_GRACE_MS).unref();
   });
 
   async function handleMessage(message) {

package/dist/src/init/mcp-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-generator.d.ts","sourceRoot":"","sources":["../../../src/init/mcp-generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,YAAY,CAAC;AAqCzD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CA+B9D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAG5D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,EAAE,CAelE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAW5E"}
+{"version":3,"file":"mcp-generator.d.ts","sourceRoot":"","sources":["../../../src/init/mcp-generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,YAAY,CAAC;AAqCzD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAqC9D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAG5D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,EAAE,CAelE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAW5E"}

package/dist/src/init/mcp-generator.js

@@ -49,7 +49,15 @@ export function generateMCPConfig(options) {
             MONOMIND_TOPOLOGY: options.runtime.topology,
             MONOMIND_MAX_AGENTS: String(options.runtime.maxAgents),
             MONOMIND_MEMORY_BACKEND: options.runtime.memoryBackend,
-        }, { autoStart: config.autoStart });
+        }
+        // No `autoStart` here: Claude Code's .mcp.json schema for stdio servers
+        // is only command/args/env — `autoStart` isn't a field it reads, and
+        // nothing in monomind reads it back from this file either (it's a
+        // separate, monomind-internal setting stored in .monomind/config.yaml).
+        // Writing it here was pure dead-end noise in a file whose schema we
+        // don't own — worth removing even though Claude Code likely just
+        // ignores unknown fields, since "likely ignores" isn't "verified inert".
+        );
     }
     // Monograph knowledge graph — built into monomind MCP server since v1.8.0.
     // Available as mcp__monomind__monograph_build, monograph_query, monograph_suggest, monograph_health.

package/dist/src/init/mcp-generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-generator.js","sourceRoot":"","sources":["../../../src/init/mcp-generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,SAAS,SAAS;IAChB,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,SAAS,oBAAoB,CAC3B,OAAiB,EACjB,GAA2B,EAC3B,eAAe,GAA4B,EAAE;IAE7C,IAAI,SAAS,EAAE,EAAE,CAAC;QAChB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;YACrC,GAAG;YACH,GAAG,eAAe;SACnB,CAAC;IACJ,CAAC;IAED,oDAAoD;IACpD,OAAO;QACL,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,IAAI,EAAE,GAAG,OAAO,CAAC;QACxB,GAAG;QACH,GAAG,eAAe;KACnB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAoB;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAC3B,MAAM,UAAU,GAA2B,EAAE,CAAC;IAE9C,MAAM,MAAM,GAAG;QACb,0BAA0B,EAAE,OAAO;KACpC,CAAC;IAEF,6BAA6B;IAC7B,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,UAAU,CAAC,UAAU,CAAC,GAAG,oBAAoB,CAC3C,CAAC,iBAAiB,EAAE,KAAK,EAAE,OAAO,CAAC,EACnC;YACE,GAAG,MAAM;YACT,aAAa,EAAE,IAAI;YACnB,sBAAsB,EAAE,MAAM;YAC9B,iBAAiB,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ;YAC3C,mBAAmB,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;YACtD,uBAAuB,EAAE,OAAO,CAAC,OAAO,CAAC,aAAa;SACvD,EACD,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAChC,CAAC;IACJ,CAAC;IAID,2EAA2E;IAC3E,qGAAqG;IACrG,qFAAqF;IAErF,OAAO,EAAE,UAAU,EAAE,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAAoB;IAClD,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAoB;IACtD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAE3B,IAAI,SAAS,EAAE,EAAE,CAAC;QAChB,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,QAAQ,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;SAAM,CAAC;QACN,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,QAAQ,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,IAAI,SAAS,EAAE,EAAE,CAAC;QAChB,OAAO;YACL,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,8DAA8D;SACrE,CAAC;IACJ,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO;QAC3D,IAAI,EAAE,sCAAsC;KAC7C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"mcp-generator.js","sourceRoot":"","sources":["../../../src/init/mcp-generator.ts"],"names":[],"mappings":"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"}

package/dist/src/mcp-tools/monograph-tools.d.ts

@@ -5,6 +5,18 @@
  * All monograph_* tools are backed by @monoes/monograph package.
  */
 import type { MCPTool } from './types.js';
+/**
+ * BM25 ranks purely on literal keyword overlap, so a doc/concept node whose
+ * prose happens to mention task-related words (e.g. a report mentioning
+ * "retry" constants) can outrank the actual code symbol the task is really
+ * about, which is conceptually related but lexically different (issue #38).
+ * Prefer code-symbol hits (Function/Class/Method/...) over doc-type hits
+ * (Document/Concept/Section/...) when there are any, falling back to the
+ * full hit list so a genuinely doc-only task still gets results.
+ */
+export declare function preferSymbolHits<T extends {
+    label: string;
+}>(hits: T[], symbolLabels: ReadonlySet<string>): T[];
 /**
  * Full tool list regardless of gating — used by the graphify compat shims,
  * which must resolve targets (e.g. monograph_community) even when the

package/dist/src/mcp-tools/monograph-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"monograph-tools.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/monograph-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AA03E1C;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAAO,EAAuD,CAAC;AAE/F,eAAO,MAAM,cAAc,EAAE,OAAO,EAAsD,CAAC"}
+{"version":3,"file":"monograph-tools.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/monograph-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAue1C;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAG/G;AAu5DD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAAO,EAAuD,CAAC;AAE/F,eAAO,MAAM,cAAc,EAAE,OAAO,EAAsD,CAAC"}

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

@@ -493,6 +493,19 @@ const monographSurprisesTool = {
     },
 };
 // ── monograph_suggest ─────────────────────────────────────────────────────────
+/**
+ * BM25 ranks purely on literal keyword overlap, so a doc/concept node whose
+ * prose happens to mention task-related words (e.g. a report mentioning
+ * "retry" constants) can outrank the actual code symbol the task is really
+ * about, which is conceptually related but lexically different (issue #38).
+ * Prefer code-symbol hits (Function/Class/Method/...) over doc-type hits
+ * (Document/Concept/Section/...) when there are any, falling back to the
+ * full hit list so a genuinely doc-only task still gets results.
+ */
+export function preferSymbolHits(hits, symbolLabels) {
+    const symbolHits = hits.filter(h => symbolLabels.has(h.label));
+    return symbolHits.length > 0 ? symbolHits : hits;
+}
 const monographSuggestTool = {
     name: 'monograph_suggest',
     description: 'Get graph-topology-derived questions to explore the codebase. Pass task= to score by task relevance via BM25/FTS5.',
@@ -554,7 +567,9 @@ const monographSuggestTool = {
             let hitIds = [];
             if (task) {
                 const hits = await hybridQuery(db, task, { limit: 20 });
-                hitIds = [...new Set(hits.map(h => h.id))];
+                const { SYMBOL_NODE_LABELS } = await import('@monoes/monograph');
+                const relevantHits = preferSymbolHits(hits, SYMBOL_NODE_LABELS);
+                hitIds = [...new Set(relevantHits.map(h => h.id))];
                 if (hitIds.length === 0) {
                     return text('No suggestions for this task. Run monograph_build first or try a different query.' + stalenessAnnotation);
                 }