@monoes/monomindcli 1.10.13 → 1.10.15

package/.claude/commands/monomind/budget.md

@@ -0,0 +1,7 @@
+---
+description: Show current budget status — today, month, limits, autotuned flag
+---
+
+```bash
+node "$CLAUDE_PROJECT_DIR/.claude/helpers/hook-handler.cjs" budget-status
+```

package/.claude/commands/monomind/graph-status.md

@@ -0,0 +1,7 @@
+---
+description: Single-line graph stats — nodes, edges, freshness, usage %
+---
+
+```bash
+node "$CLAUDE_PROJECT_DIR/.claude/helpers/hook-handler.cjs" graph-status
+```

package/.claude/commands/monomind/loops.md

@@ -0,0 +1,7 @@
+---
+description: List active loops — command, type, run count, HIL status
+---
+
+```bash
+node "$CLAUDE_PROJECT_DIR/.claude/helpers/hook-handler.cjs" loops-status
+```

package/.claude/helpers/graphify-freshen.cjs

@@ -81,11 +81,28 @@ try {
 // Write lock file; the build process removes it on completion
 try { fs.writeFileSync(lockPath, String(process.pid)); } catch { /* non-fatal */ }
 
-// Spawn a detached node process to run buildAsync from @monoes/monograph (ESM)
+// Spawn a detached node process to run buildAsync from @monoes/monograph (ESM).
+// After the build, VACUUM the DB if it has >50% bloat (reclaim space from
+// delete/insert churn; opens are ~5x faster on a tight DB).
+const dbPathStr = JSON.stringify(path.join(projectDir, '.monomind', 'monograph.db'));
 const script = `
 import { buildAsync } from ${JSON.stringify(pathToFileURL(entryPoint).href)};
-import { unlinkSync } from 'fs';
-try { await buildAsync(${JSON.stringify(projectDir)}); } finally {
+import { unlinkSync, statSync } from 'fs';
+import { execSync } from 'child_process';
+try {
+  await buildAsync(${JSON.stringify(projectDir)});
+  // Vacuum if bloat ratio is high — keeps openDb fast over time.
+  try {
+    const dbPath = ${dbPathStr};
+    const fileMB = statSync(dbPath).size / 1024 / 1024;
+    const liveMB = parseInt(
+      execSync('sqlite3 "' + dbPath + '" "SELECT SUM(pgsize)/1024/1024 FROM dbstat;"',
+        { encoding: 'utf-8' }).trim(), 10);
+    if (fileMB > 100 && liveMB / fileMB < 0.5) {
+      execSync('sqlite3 "' + dbPath + '" "VACUUM;"', { timeout: 120000 });
+    }
+  } catch (_) {}
+} finally {
   try { unlinkSync(${JSON.stringify(lockPath)}); } catch {}
 }`;
 const child = spawn(process.execPath, ['--input-type=module', '--eval', script], {

package/.claude/helpers/hook-handler.cjs

@@ -29,14 +29,20 @@ function _requireMonograph() {
 // Used by route (pre-resolve), pre-search (Grep/Glob redirect), and post-read
 // (neighbor footer). All calls are best-effort; failures are silent.
 
+// Memoized at module scope — opening a multi-GB monograph.db can take 7-10s,
+// and we call this 3+ times per route hook. Cache for the lifetime of this
+// hook process. Callers should NOT close the returned handle.
+var _cachedMonographDb = undefined;
 function _openMonographDb() {
+  if (_cachedMonographDb !== undefined) return _cachedMonographDb;
   try {
     var dbPath = path.join(CWD, '.monomind', 'monograph.db');
-    if (!fs.existsSync(dbPath)) return null;
+    if (!fs.existsSync(dbPath)) { _cachedMonographDb = null; return null; }
     var mod = _requireMonograph();
-    if (!mod || !mod.openDb) return null;
-    return mod.openDb(dbPath);
-  } catch (e) { return null; }
+    if (!mod || !mod.openDb) { _cachedMonographDb = null; return null; }
+    _cachedMonographDb = mod.openDb(dbPath);
+    return _cachedMonographDb;
+  } catch (e) { _cachedMonographDb = null; return null; }
 }
 
 function getMonographSuggestions(taskText, limit) {
@@ -91,7 +97,7 @@ function getMonographSuggestions(taskText, limit) {
     }
     return rows || [];
   } catch (e) { return []; }
-  finally { try { db.close(); } catch (_) {} }
+  finally { /* db is shared/cached; do not close */ }
 }
 
 function getMonographNeighbors(filePath) {
@@ -119,7 +125,7 @@ function getMonographNeighbors(filePath) {
 
     return { imports: imports, importedBy: importedBy };
   } catch (e) { return null; }
-  finally { try { db.close(); } catch (_) {} }
+  finally { /* db is shared/cached; do not close */ }
 }
 
 // Rough per-event token + USD cost estimates. Tuned to Sonnet input pricing
@@ -184,7 +190,7 @@ function _injectCompactGraphMap() {
         }
         console.log('  Use mcp__monomind__monograph_suggest first when navigating.');
       }
-    } finally { try { db.close(); } catch (_) {} }
+    } finally { /* db is shared/cached; do not close */ }
   } catch (e) {}
 }
 
@@ -209,30 +215,70 @@ function _recordToolCall(signature) {
 
 // ── Cost budget ────────────────────────────────────────────────────────────────
 // Read today's cost from token-summary and compare against budget ceiling.
+// If no budget.json exists, auto-tune from 30-day rolling mean (1.5x) so we
+// don't shout BUDGET_BREACHED at users whose normal spend is above the default.
 function _getBudgetStatus() {
   try {
     var budgetFile = path.join(CWD, '.monomind', 'budget.json');
     var summaryFile = path.join(CWD, '.monomind', 'metrics', 'token-summary.json');
     if (!fs.existsSync(summaryFile)) return null;
     var summary = JSON.parse(fs.readFileSync(summaryFile, 'utf-8'));
-    // Support both shapes: { todayCost, monthCost } and { today: { cost }, month: { cost } }
     var todayCost = summary.todayCost || (summary.today && summary.today.cost) || 0;
     var monthCost = summary.monthCost || (summary.month && summary.month.cost) || 0;
-    var dailyLimit = 50, monthlyLimit = 1500; // defaults
-    try {
-      if (fs.existsSync(budgetFile)) {
+
+    var dailyLimit, monthlyLimit, autoTuned = false;
+    if (fs.existsSync(budgetFile)) {
+      try {
         var b = JSON.parse(fs.readFileSync(budgetFile, 'utf-8'));
-        dailyLimit = b.dailyLimit || dailyLimit;
-        monthlyLimit = b.monthlyLimit || monthlyLimit;
+        dailyLimit = b.dailyLimit;
+        monthlyLimit = b.monthlyLimit;
+      } catch (_) {}
+    }
+
+    // Auto-tune: monthCost / daysSoFar = avg daily; 1.5x that = limit.
+    // Only auto-tune when we actually have 7+ days of data and no manual budget.
+    if (!dailyLimit || !monthlyLimit) {
+      var now = new Date();
+      var daysIntoMonth = now.getUTCDate();
+      var dailyAvg = daysIntoMonth >= 1 ? monthCost / daysIntoMonth : 0;
+      if (dailyAvg > 5 && daysIntoMonth >= 7) {
+        dailyLimit  = Math.max(dailyLimit  || 0, Math.ceil(dailyAvg * 1.5));
+        monthlyLimit = Math.max(monthlyLimit || 0, Math.ceil(dailyAvg * 1.5 * 30));
+        autoTuned = true;
+        // Persist so future runs are stable and the user can edit.
+        try {
+          fs.mkdirSync(path.dirname(budgetFile), { recursive: true });
+          fs.writeFileSync(budgetFile, JSON.stringify({
+            dailyLimit: dailyLimit,
+            monthlyLimit: monthlyLimit,
+            autoTuned: true,
+            tunedAt: now.toISOString(),
+            basis: 'rolling avg $' + dailyAvg.toFixed(2) + '/day × 1.5',
+            note: 'Edit these values to set a hard ceiling. Delete the file to re-tune.',
+          }, null, 2));
+        } catch (_) {}
+      } else {
+        // Fall back to sensible defaults when there's not enough history.
+        dailyLimit = dailyLimit || 50;
+        monthlyLimit = monthlyLimit || 1500;
       }
-    } catch (_) {}
+    }
+
     var dailyPct = Math.round((todayCost / dailyLimit) * 100);
     var monthlyPct = Math.round((monthCost / monthlyLimit) * 100);
+
+    // Spike detection: today is >2x the rolling daily avg (suspicious activity)
+    var rollingDaily = (new Date()).getUTCDate() >= 1 ? monthCost / (new Date()).getUTCDate() : 0;
+    var spike = rollingDaily > 0 && todayCost > rollingDaily * 2.0 && todayCost > 5;
+
     return {
       todayCost: todayCost, monthCost: monthCost,
       dailyLimit: dailyLimit, monthlyLimit: monthlyLimit,
       dailyPct: dailyPct, monthlyPct: monthlyPct,
-      alert: dailyPct >= 80 || monthlyPct >= 80,
+      autoTuned: autoTuned,
+      spike: spike,
+      // Alert only when either the limit is breached OR there's a real spike
+      alert: dailyPct >= 80 || monthlyPct >= 80 || spike,
       breached: dailyPct >= 100 || monthlyPct >= 100,
     };
   } catch (e) { return null; }
@@ -264,7 +310,7 @@ function _findAffectedTests(filePath) {
     ).all(filePath, rel);
     return rows.map(function(r) { return r.file_path; });
   } catch (e) { return []; }
-  finally { try { db.close(); } catch (_) {} }
+  finally { /* db is shared/cached; do not close */ }
 }
 
 // ── Hook latency tracking ─────────────────────────────────────────────────────
@@ -629,9 +675,8 @@ function _autoIndexKnowledge(knowledgeDir) {
 
     if (fs.existsSync(mgDbPath2)) {
       try {
-        var mgMod2 = _requireMonograph();
-        if (mgMod2 && mgMod2.openDb) {
-          var sumDb = mgMod2.openDb(mgDbPath2);
+        var sumDb = _openMonographDb();
+        if (sumDb) {
           try {
             var nodeC = sumDb.prepare('SELECT COUNT(*) AS c FROM nodes').get().c;
             var edgeC = sumDb.prepare('SELECT COUNT(*) AS c FROM edges').get().c;
@@ -661,9 +706,7 @@ function _autoIndexKnowledge(knowledgeDir) {
               '  mcp__monomind__monograph_impact({ name: "<file>" }) — upstream + downstream blast radius',
             ].join('\n');
             summaryMeta = { label: 'monograph-graph-summary', source: 'monograph.db', nodes: nodeC, edges: edgeC };
-          } finally {
-            try { sumDb.close(); } catch (_) {}
-          }
+          } catch (e) { /* keep summaryText if partial */ }
         }
       } catch (e) { /* fall through to legacy */ }
     }
@@ -826,15 +869,78 @@ const handlers = {
     }
     if (router && (router.routeTaskSemantic || router.routeTask)) {
       const routeFn = router.routeTaskSemantic || router.routeTask;
-      const result = await Promise.resolve(routeFn(prompt));
+      var result = await Promise.resolve(routeFn(prompt));
+
+      // Graph-fallback override: when the router picked a low-confidence
+      // non-dev specialist (marketing slugs etc) but monograph has a strong
+      // graph match for the prompt, derive the agent from the top file's
+      // label instead. Stops "improve the system" → China E-Commerce.
+      try {
+        // Don't override when the prompt has obvious non-dev keywords —
+        // marketing/sales/finance asks SHOULD route to those specialists.
+        var nonDevPrompt = /\b(marketing|advertis|seo|tiktok|instagram|linkedin|sales|customer|brand|blog post|content strategy|copy(?:writ|writing)|pitch|investor|hr|recruit|legal|compliance|tax|invoice|accounting|onboarding|design syst|figma|user research|persona)\b/i.test(prompt);
+
+        var devAgents = /^(coder|tester|reviewer|planner|researcher|system-architect|backend-dev|backend-architect|mobile-dev|ml-developer|cicd-engineer|api-docs|code-analyzer|production-validator|Technical Writer)$/i;
+        var pickedDev = devAgents.test(String(result.agent || '').trim()) ||
+                        devAgents.test(String(result.agentSlug || '').trim());
+
+        var resConf = (result.confidence != null ? result.confidence : 0);
+        var resReason = String(result.reason || '');
+        var fromKeywordStage = resReason.indexOf('Keyword 2-stage') !== -1;
+        var promptIsDevish = /\b(improve|refactor|fix|bug|optimi[sz]e|implement|build|debug|deploy|test|feature|system|performance|architecture|memory|hook|graph|statusline|monograph|api|cli|skill|hooks|agent|workflow|init|module|package|registry|server|client|route|handler)\b/i.test(prompt);
+
+        var shouldOverride = !nonDevPrompt && (
+          (!pickedDev && resConf < 0.85) ||
+          (fromKeywordStage && promptIsDevish)
+        );
+        if (shouldOverride) {
+          var topGraph = getMonographSuggestions(prompt, 1)[0];
+          if (topGraph) {
+            var agent = 'coder';
+            var file = (topGraph.file || '').toLowerCase();
+            // Test files
+            if (/\.(test|spec)\./.test(file) || file.includes('__tests__')) agent = 'tester';
+            // Architecture/system docs → architect
+            else if (/(architect|adr-|design-doc|rfc-)/.test(file))         agent = 'system-architect';
+            // Pure docs → tech writer
+            else if (file.endsWith('readme.md') || file.startsWith('docs/') || /\/docs\//.test(file)) agent = 'Technical Writer';
+            // Other .md (skills, agents, configs) → coder (they're code-adjacent)
+            else if (file.endsWith('.md'))                                  agent = 'coder';
+            // Class/Interface → architect
+            else if (topGraph.label === 'Class' || topGraph.label === 'Interface') agent = 'system-architect';
+            // Functions, files, methods → coder
+            else                                                             agent = 'coder';
+            result = Object.assign({}, result, {
+              agent: agent,
+              agentSlug: agent,
+              confidence: 0.70,
+              reason: 'Graph fallback: top file ' + (topGraph.name || '').substring(0, 30) + ' [' + topGraph.label + ']',
+              specificAgents: [],
+              extrasMatches: [],
+            });
+          }
+        }
+      } catch (e) {}
+
       var output = [];
       output.push('[INFO] Routing task: ' + (prompt.substring(0, 80) || '(no prompt)'));
       output.push('');
-      output.push('+------------- monomind | Primary Recommendation --------------+');
-      output.push('| Agent: ' + (result.agent || 'unknown').substring(0, 54).padEnd(54) + '|');
-      output.push('| Confidence: ' + ((result.confidence != null ? (result.confidence * 100).toFixed(1) : '?') + '%').padEnd(49) + '|');
-      output.push('| Reason: ' + (result.reason || '').substring(0, 53).padEnd(53) + '|');
-      output.push('+--------------------------------------------------------------+');
+      // Suppress the agent recommendation panel for low-confidence routes on
+      // short prompts — the recommendation is almost always wrong (e.g.
+      // "what else can we do" → marketing → China E-Commerce). Saves ~150
+      // tokens per prompt. Skill matches and specific agents still render
+      // below when confidence is decent.
+      var conf = result.confidence != null ? result.confidence : 0;
+      var promptShort = (prompt || '').trim().length < 60;
+      var lowConf = conf < 0.70;
+      var suppressPanel = lowConf && promptShort;
+      if (!suppressPanel) {
+        output.push('+------------- monomind | Primary Recommendation --------------+');
+        output.push('| Agent: ' + (result.agent || 'unknown').substring(0, 54).padEnd(54) + '|');
+        output.push('| Confidence: ' + ((result.confidence != null ? (result.confidence * 100).toFixed(1) : '?') + '%').padEnd(49) + '|');
+        output.push('| Reason: ' + (result.reason || '').substring(0, 53).padEnd(53) + '|');
+        output.push('+--------------------------------------------------------------+');
+      }
 
       // ── Persist routing result for statusline display ─────────────
       try {
@@ -913,8 +1019,9 @@ const handlers = {
       }
 
       // ── Specific agent panel ──────────────────────────────────────────────────
+      // Skip entirely on suppressed (low-confidence + short) prompts.
       var specificAgents = result.specificAgents || [];
-      if (specificAgents.length > 0) {
+      if (specificAgents.length > 0 && !suppressPanel) {
         output.push('');
         var saHdr = '------- Specific Agents (' + specificAgents.length + ' available) ';
         output.push('+' + saHdr + '-'.repeat(Math.max(1, 62 - saHdr.length)) + '+');
@@ -934,7 +1041,7 @@ const handlers = {
       // ── Specialist agents (non-dev domain) — only shown when specificAgents panel wasn't shown ──
       var extras = result.extrasMatches || [];
       var specificAgentsShown = (result.specificAgents || []).length > 0;
-      if (extras.length > 0 && !specificAgentsShown) {
+      if (extras.length > 0 && !specificAgentsShown && !suppressPanel) {
         output.push('');
         var spHdr = '------- Specialist Agents (' + extras.length + ' matched) ';
         output.push('+' + spHdr + '-'.repeat(Math.max(1, 62 - spHdr.length)) + '+');
@@ -990,10 +1097,13 @@ const handlers = {
       try {
         var budget = _getBudgetStatus();
         if (budget && budget.alert) {
-          if (budget.breached) {
-            console.log('[BUDGET_BREACHED] Daily $' + budget.todayCost.toFixed(2) + '/$' + budget.dailyLimit + ' (' + budget.dailyPct + '%) · Monthly $' + budget.monthCost.toFixed(2) + '/$' + budget.monthlyLimit + ' (' + budget.monthlyPct + '%). Switch to Haiku with /model haiku or raise limits in .monomind/budget.json.');
+          var tunedNote = budget.autoTuned ? ' (auto-tuned)' : '';
+          if (budget.spike && !budget.breached) {
+            console.log('[BUDGET_SPIKE] Today $' + budget.todayCost.toFixed(2) + ' is >2x your rolling daily avg. Unusual spend — review .monomind/metrics/token-summary.json.');
+          } else if (budget.breached) {
+            console.log('[BUDGET_BREACHED] Daily $' + budget.todayCost.toFixed(2) + '/$' + budget.dailyLimit + ' (' + budget.dailyPct + '%) · Monthly $' + budget.monthCost.toFixed(2) + '/$' + budget.monthlyLimit + ' (' + budget.monthlyPct + '%)' + tunedNote + '. Switch to Haiku with /model haiku or edit .monomind/budget.json.');
           } else {
-            console.log('[BUDGET_ALERT] Daily ' + budget.dailyPct + '% of $' + budget.dailyLimit + ' · Monthly ' + budget.monthlyPct + '% of $' + budget.monthlyLimit + '. Adjust .monomind/budget.json if needed.');
+            console.log('[BUDGET_ALERT] Daily ' + budget.dailyPct + '% of $' + budget.dailyLimit + ' · Monthly ' + budget.monthlyPct + '% of $' + budget.monthlyLimit + tunedNote + '.');
           }
         }
       } catch (e) {}
@@ -1007,14 +1117,9 @@ const handlers = {
         var nodeCount = 0;
         if (fs.existsSync(monographDb)) {
           try {
-            var mgMod = _requireMonograph();
-            if (mgMod && mgMod.openDb) {
-              var hintDb = mgMod.openDb(monographDb);
-              try {
-                nodeCount = hintDb.prepare('SELECT COUNT(*) AS c FROM nodes').get().c;
-              } finally {
-                try { hintDb.close(); } catch (_) {}
-              }
+            var hintDb = _openMonographDb();
+            if (hintDb) {
+              nodeCount = hintDb.prepare('SELECT COUNT(*) AS c FROM nodes').get().c;
             }
           } catch (e) { /* ignore — fall back to legacy */ }
         }
@@ -1451,10 +1556,8 @@ const handlers = {
     try {
       var mgDbPath = path.join(CWD, '.monomind', 'monograph.db');
       if (fs.existsSync(mgDbPath)) {
-        var mgMod = null;
-        mgMod = _requireMonograph();
-        if (mgMod && mgMod.openDb) {
-          var mgDb = mgMod.openDb(mgDbPath);
+        var mgDb = _openMonographDb();
+        if (mgDb) {
           try {
             var mgNodeCount = mgDb.prepare('SELECT COUNT(*) AS c FROM nodes').get().c;
             var mgEdgeCount = mgDb.prepare('SELECT COUNT(*) AS c FROM edges').get().c;
@@ -1493,7 +1596,7 @@ const handlers = {
                 fs.writeFileSync(mgChunksFile, mgExisting.join('\n') + '\n');
               } catch(e) {}
             }
-          } finally { if (mgMod.closeDb) mgMod.closeDb(mgDb); }
+          } catch(e) { /* non-fatal */ }
         }
       }
     } catch(e) { /* non-fatal */ }
@@ -2226,7 +2329,7 @@ const handlers = {
             } catch (_) {}
             console.log('  Use mcp__monomind__monograph_suggest / monograph_query in this subagent before grepping.');
           }
-        } finally { try { subDb.close(); } catch (_) {} }
+        } catch (e) { /* non-fatal */ }
       }
     } catch (e) { /* non-fatal */ }
 
@@ -2289,6 +2392,75 @@ const handlers = {
     console.log('  Edit the file to fill in Context and Consequences, then change Status to Accepted/Rejected.');
   },
 
+  'graph-status': () => {
+    var db = _openMonographDb();
+    if (!db) { console.log('No monograph.db found. Run /monomind:understand to build.'); return; }
+    try {
+      var n = db.prepare("SELECT COUNT(*) AS c FROM nodes").get().c;
+      var e = db.prepare("SELECT COUNT(*) AS c FROM edges").get().c;
+      var usage = (function() {
+        try { return JSON.parse(fs.readFileSync(path.join(CWD, '.monomind', 'metrics', 'graph-usage.json'), 'utf-8')); }
+        catch (_) { return {}; }
+      })();
+      var wins = (usage.monograph_call || 0) + (usage.preresolve_hit || 0)
+               + (usage.graph_assist_search || 0) + (usage.graph_assist_neighbors || 0);
+      var search = (usage.grep_call || 0) + (usage.glob_call || 0)
+                 + (usage.bash_grep_call || 0) + (usage.bash_find_call || 0);
+      var pct = (wins + search) > 0 ? Math.round((wins / (wins + search)) * 100) : 0;
+      var saved = usage.dollars_saved || 0;
+      console.log('Monograph: ' + n.toLocaleString() + ' nodes · ' + e.toLocaleString() + ' edges');
+      console.log('Usage: ' + pct + '% graph · ' + (100 - pct) + '% grep · ' +
+                  'wins=' + wins + ' search=' + search +
+                  (saved > 0 ? ' · saved $' + saved.toFixed(2) : ''));
+    } catch (err) { console.log('Error: ' + err.message); }
+  },
+
+  'budget-status': () => {
+    var b = _getBudgetStatus();
+    if (!b) { console.log('No budget data yet — token tracking not initialized.'); return; }
+    console.log('Today:   $' + b.todayCost.toFixed(2) + ' / $' + b.dailyLimit  + ' (' + b.dailyPct  + '%)' + (b.autoTuned ? ' [auto-tuned]' : ''));
+    console.log('Month:   $' + b.monthCost.toFixed(2) + ' / $' + b.monthlyLimit + ' (' + b.monthlyPct + '%)');
+    console.log('Status:  ' + (b.breached ? 'BREACHED' : b.spike ? 'SPIKE' : b.alert ? 'ALERT' : 'OK'));
+    console.log('Edit .monomind/budget.json to adjust. Delete to re-tune.');
+  },
+
+  'loops-status': () => {
+    var loopsDir = path.join(CWD, '.monomind', 'loops');
+    if (!fs.existsSync(loopsDir)) { console.log('No loops directory.'); return; }
+    var files = fs.readdirSync(loopsDir).filter(function(f) {
+      return f.endsWith('.json') && !f.includes('-hil') && !f.endsWith('.stop');
+    });
+    var STALE_MS = 6 * 60 * 60 * 1000;
+    var now = Date.now();
+    var active = [], stale = [];
+    files.forEach(function(f) {
+      try {
+        var d = JSON.parse(fs.readFileSync(path.join(loopsDir, f), 'utf-8'));
+        var last = d.lastRunAt || d.startedAt || 0;
+        var ageMs = last ? (now - last) : Infinity;
+        if (ageMs > STALE_MS) stale.push({ d: d, ageH: Math.round(ageMs / 3600000) });
+        else active.push(d);
+      } catch (_) {}
+    });
+    if (active.length === 0 && stale.length === 0) {
+      console.log('No loops.'); return;
+    }
+    if (active.length > 0) {
+      console.log('Active (' + active.length + '):');
+      active.forEach(function(d) {
+        console.log('  · ' + (d.command || '?') + ' [' + (d.type || '?') + '] run ' + (d.currentRep || 0) +
+                    (d.maxReps ? '/' + d.maxReps : '') + ' · ' + (d.status || '?'));
+      });
+    }
+    if (stale.length > 0) {
+      console.log('Stale (' + stale.length + ' >6h):');
+      stale.forEach(function(s) {
+        console.log('  · ' + (s.d.command || '?') + ' run ' + (s.d.currentRep || 0) +
+                    ' · ' + s.ageH + 'h ago · ' + (s.d.status || '?'));
+      });
+    }
+  },
+
   'status': () => {
     console.log('[OK] Status check');
   },

package/dist/src/ui/dashboard.html

@@ -2584,6 +2584,7 @@
       <button class="mm-tab" onclick="switchMmTab('loops')">LOOPS</button>
       <button class="mm-tab" onclick="switchMmTab('create')">CREATE ORG</button>
       <button class="mm-tab" onclick="switchMmTab('metrics')">METRICS</button>
+      <button class="mm-tab" onclick="switchMmTab('graph')">GRAPH</button>
     </div>
     <div id="mm-body">
       <div class="mm-pane active" id="mm-pane-orgs">
@@ -2633,6 +2634,18 @@
         <div class="mm-section-title" style="margin-top:16px">Recent Events</div>
         <div id="mm-metrics-events" style="font-size:9px;color:rgba(150,100,200,0.6);font-family:'Azeret Mono',monospace"></div>
       </div>
+      <div class="mm-pane" id="mm-pane-graph">
+        <div class="mm-section-title">Monograph Knowledge Graph</div>
+        <div id="mm-graph-summary" style="display:flex;gap:24px;margin-bottom:16px;font-size:11px">
+          <span style="color:rgba(150,100,200,0.4)">Loading graph stats…</span>
+        </div>
+        <div class="mm-section-title" style="margin-top:8px">Top God Nodes (highest centrality)</div>
+        <div id="mm-graph-gods" style="font-size:9px;color:rgba(180,140,220,0.85);font-family:'Azeret Mono',monospace;line-height:1.6"></div>
+        <div class="mm-section-title" style="margin-top:16px">Node Types</div>
+        <div id="mm-graph-types" style="font-size:9px;color:rgba(180,140,220,0.85);font-family:'Azeret Mono',monospace"></div>
+        <div class="mm-section-title" style="margin-top:16px">Edge Relations</div>
+        <div id="mm-graph-relations" style="font-size:9px;color:rgba(180,140,220,0.85);font-family:'Azeret Mono',monospace"></div>
+      </div>
     </div>
   </div>
 </div>
@@ -10264,6 +10277,50 @@ window.switchMmTab = function(tab) {
   if (tab === 'loops')   loadMmLoops();
   if (tab === 'metrics') loadMmMetrics();
   if (tab === 'skills')  renderMmSkills('');
+  if (tab === 'graph')   loadMmGraph();
+};
+
+window.loadMmGraph = async function() {
+  const summary = document.getElementById('mm-graph-summary');
+  const gods = document.getElementById('mm-graph-gods');
+  const types = document.getElementById('mm-graph-types');
+  const relations = document.getElementById('mm-graph-relations');
+  if (!summary) return;
+  try {
+    const r = await fetch('/api/monograph');
+    const d = await r.json();
+    if (!d.exists) {
+      summary.innerHTML = '<span style="color:rgba(220,120,120,0.7)">No monograph.db found. Run /monomind:understand or wait for SessionStart to build the graph.</span>';
+      gods.textContent = ''; types.textContent = ''; relations.textContent = '';
+      return;
+    }
+    summary.innerHTML = `
+      <div><div style="color:rgba(150,100,200,0.5);font-size:8px;letter-spacing:0.1em">NODES</div>
+        <div style="font-size:18px;color:rgba(120,200,160,1);font-weight:bold">${d.nodes.toLocaleString()}</div></div>
+      <div><div style="color:rgba(150,100,200,0.5);font-size:8px;letter-spacing:0.1em">EDGES</div>
+        <div style="font-size:18px;color:rgba(120,200,160,1);font-weight:bold">${d.edges.toLocaleString()}</div></div>
+      <div><div style="color:rgba(150,100,200,0.5);font-size:8px;letter-spacing:0.1em">UPDATED</div>
+        <div style="font-size:11px;color:rgba(210,140,255,0.8)">${new Date(d.updatedAt).toLocaleString()}</div></div>
+    `;
+    gods.innerHTML = (d.godNodes || []).map(n =>
+      `<div>· <span style="color:rgba(255,200,100,0.9)">${(n.deg||0).toString().padStart(4,' ')}</span> &nbsp;
+         <span style="color:rgba(210,140,255,1)">${n.name||''}</span>
+         <span style="color:rgba(150,100,200,0.5)">[${n.label||''}]</span>
+         &nbsp; <span style="color:rgba(120,200,160,0.7)">${n.file_path||''}</span></div>`
+    ).join('') || '<span style="color:rgba(150,100,200,0.4)">none</span>';
+    types.innerHTML = (d.typeDistribution || []).map(t =>
+      `<span style="display:inline-block;padding:2px 8px;margin:2px;background:rgba(200,120,255,0.08);border:1px solid rgba(200,120,255,0.2);border-radius:3px">
+        ${t.label}: <strong style="color:rgba(120,200,160,1)">${t.count.toLocaleString()}</strong>
+       </span>`
+    ).join('');
+    relations.innerHTML = (d.relationDistribution || []).map(r =>
+      `<span style="display:inline-block;padding:2px 8px;margin:2px;background:rgba(200,120,255,0.08);border:1px solid rgba(200,120,255,0.2);border-radius:3px">
+        ${r.relation}: <strong style="color:rgba(255,200,100,1)">${r.count.toLocaleString()}</strong>
+       </span>`
+    ).join('');
+  } catch (err) {
+    summary.innerHTML = `<span style="color:rgba(220,120,120,0.7)">Failed to load graph: ${err.message}</span>`;
+  }
 };
 
 window.filterMmSkills = function(q) { renderMmSkills(q); };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monoes/monomindcli",
-  "version": "1.10.13",
+  "version": "1.10.15",
   "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",