@monoes/monomindcli 1.10.26 → 1.10.28

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monoes/monomindcli",
-  "version": "1.10.26",
+  "version": "1.10.28",
   "type": "module",
   "description": "Monomind 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",
@@ -112,4 +112,4 @@
     "access": "public",
     "tag": "latest"
   }
-}
+}

package/scripts/understand-analyze.mjs

@@ -48,11 +48,12 @@ const dbPathArg   = argVal('db')   ? resolve(argVal('db'))   : join(projectDir,
 const outputArg   = argVal('output')? resolve(argVal('output')) : join(projectDir, '.understand', 'knowledge-graph.json');
 const batchSize      = parseInt(argVal('batch-size') || '5',  10);
 const maxFiles       = parseInt(argVal('max-files')  || '0',  10);
-const dryRun         = hasFlag('dry-run');
-const noLlm          = hasFlag('no-llm');
-const layersOnly     = hasFlag('layers-only');
-const incremental    = hasFlag('incremental');
-const onboard        = hasFlag('onboard');
+const dryRun               = hasFlag('dry-run');
+const noLlm                = hasFlag('no-llm');
+const layersOnly           = hasFlag('layers-only');
+const incremental          = hasFlag('incremental');
+const importAnalysesStdin  = hasFlag('import-analyses-stdin');
+const onboard              = hasFlag('onboard');
 const onboardOut     = argVal('onboard-out') ? resolve(argVal('onboard-out')) : join(projectDir, 'ONBOARDING.md');
 
 // ── Resolve @monoes/monograph for DB access ──────────────────────────────────
@@ -629,6 +630,79 @@ async function main() {
   try { db.prepare(`ALTER TABLE nodes ADD COLUMN properties TEXT`).run(); } catch {}
   try { db.prepare(`CREATE TABLE IF NOT EXISTS communities (id INTEGER PRIMARY KEY, label TEXT, size INTEGER NOT NULL DEFAULT 0, cohesion_score REAL NOT NULL DEFAULT 0.0)`).run(); } catch {}
 
+  // ── Import analyses from stdin (slash-command write-back path) ───────────
+  // When Claude Code's /monomind:understand has collected per-file summaries
+  // through the active session, it pipes them back via:
+  //   echo "$ANALYSES_JSON" | node understand-analyze.mjs --import-analyses-stdin
+  // The JSON shape: { "analyses": [{ "id": <nodeId>, "fileSummary": "...", "tags": [...], ... }] }
+  if (importAnalysesStdin) {
+    const stdinText = await new Promise((resolve) => {
+      let buf = '';
+      process.stdin.setEncoding('utf-8');
+      process.stdin.on('data', c => { buf += c; });
+      process.stdin.on('end', () => resolve(buf));
+      process.stdin.on('error', () => resolve(buf));
+      // Bail out after 30 s so the slash command never hangs
+      setTimeout(() => resolve(buf), 30000);
+      process.stdin.resume();
+    });
+    let parsed = null;
+    try { parsed = JSON.parse(stdinText); } catch {}
+    const analyses = (parsed && Array.isArray(parsed.analyses)) ? parsed.analyses : [];
+    if (analyses.length === 0) {
+      console.error('[understand] --import-analyses-stdin: no analyses found in stdin JSON');
+      mg.closeDb(db);
+      process.exit(1);
+    }
+    // Resolve each analysis item to a DB integer node id.
+    // graph.json nodes have id='file:<path>' (synthetic); the real PK is an integer.
+    // Accept: analysis.dbId (integer), analysis.filePath, or derive path from analysis.id.
+    const lookupByPath = db.prepare(`SELECT id, properties FROM nodes WHERE file_path=? OR file_path=? LIMIT 1`);
+    const lookupById   = db.prepare(`SELECT id, properties FROM nodes WHERE id=? LIMIT 1`);
+    const updateNode   = db.prepare(`UPDATE nodes SET properties = ? WHERE id = ?`);
+    let written = 0;
+    const tx = db.transaction(() => {
+      for (const analysis of analyses) {
+        if (!analysis) continue;
+        let nodeRow = null;
+        // 1. Prefer explicit integer dbId (added by newer graph.json emitter)
+        if (analysis.dbId != null) {
+          nodeRow = lookupById.get(analysis.dbId);
+        }
+        // 2. Fall back to filePath from graph.json node
+        if (!nodeRow && analysis.filePath) {
+          const rel = analysis.filePath.startsWith('/') ? relative(projectDir, analysis.filePath) : analysis.filePath;
+          nodeRow = lookupByPath.get(analysis.filePath, rel);
+        }
+        // 3. Derive path from synthetic id ('file:<path>')
+        if (!nodeRow && analysis.id && String(analysis.id).startsWith('file:')) {
+          const derivedPath = String(analysis.id).slice(5);
+          const rel = derivedPath.startsWith('/') ? relative(projectDir, derivedPath) : derivedPath;
+          nodeRow = lookupByPath.get(derivedPath, rel);
+        }
+        if (!nodeRow) continue;
+        const existing = (() => { try { return nodeRow.properties ? JSON.parse(nodeRow.properties) : {}; } catch { return {}; } })();
+        const merged = {
+          ...existing,
+          ...(analysis.fileSummary       ? { summary:             analysis.fileSummary }            : {}),
+          ...(analysis.tags              ? { tags:                 analysis.tags }                   : {}),
+          ...(analysis.complexity        ? { complexity:           analysis.complexity }              : {}),
+          ...(analysis.functionSummaries ? { functionSummaries:    analysis.functionSummaries }     : {}),
+          ...(analysis.classSummaries    ? { classSummaries:       analysis.classSummaries }        : {}),
+          ua_analyzed_at: new Date().toISOString(),
+        };
+        updateNode.run(JSON.stringify(merged), nodeRow.id);
+        written++;
+      }
+    });
+    tx();
+    // Rebuild FTS so summaries are immediately searchable
+    try { db.prepare(`INSERT INTO nodes_fts(nodes_fts) VALUES('rebuild')`).run(); } catch {}
+    mg.closeDb(db);
+    console.log(`[understand] Imported ${written} analyses from stdin. FTS rebuilt.`);
+    return;
+  }
+
   // ── Load all file nodes ──────────────────────────────────────────────────
   let fileNodes = db.prepare(`SELECT id, name, file_path, properties FROM nodes WHERE label = 'File' AND file_path IS NOT NULL`).all();
   console.log(`[understand] Found ${fileNodes.length} file nodes in DB`);
@@ -947,6 +1021,7 @@ function buildGraphJson(dir, fileNodes, analysisMap, layers) {
     const a = analysisMap[n.file_path] || {};
     return {
       id: 'file:' + (n.file_path || n.name),
+      dbId: n.id,          // integer PK — use this in --import-analyses-stdin payloads
       type: 'file',
       name: n.name,
       filePath: n.file_path,