@monoes/monomindcli 1.10.10 → 1.10.12

package/.claude/commands/monomind/adr.md

@@ -0,0 +1,11 @@
+---
+description: Draft an Architecture Decision Record from accumulated decision markers in this session's prompts
+---
+
+Run the hook handler's adr-draft action to scan `.monomind/decisions.jsonl` for the last 7 days of decision markers (e.g. "let's go with X", "we chose Y", "decision: Z") and produce an ADR template in `docs/adrs/`.
+
+```bash
+node "$CLAUDE_PROJECT_DIR/.claude/helpers/hook-handler.cjs" adr-draft
+```
+
+After running, open the generated `docs/adrs/ADR-NNNN-YYYY-MM-DD-session-decisions.md`, fill in the Context and Consequences sections, and change Status to Accepted/Rejected.

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

@@ -62,6 +62,8 @@ function getMonographSuggestions(taskText, limit) {
     try {
       // BM25 ranks better than degree for keyword relevance; tie-break by deg.
       // File/Function/Class outrank Section so navigable nodes win.
+      // Filter out anonymous lambdas, arrow expressions, and other unnamed
+      // garbage that the AST extraction picks up but isn't navigable.
       rows = db.prepare(
         "SELECT n.id, n.name, n.label, n.file_path AS file, " +
         "bm25(nodes_fts) AS bm25_score, " +
@@ -71,6 +73,8 @@ function getMonographSuggestions(taskText, limit) {
         "FROM nodes_fts f JOIN nodes n ON f.rowid = n.rowid " +
         "WHERE nodes_fts MATCH ? AND n.file_path IS NOT NULL AND n.file_path != '' " +
         "AND n.label NOT IN ('Concept') " +
+        "AND n.name NOT LIKE '(%' AND n.name NOT LIKE '%=>%' AND n.name != 'function' " +
+        "AND length(n.name) >= 3 " +
         "ORDER BY label_rank DESC, bm25_score ASC, deg DESC LIMIT ?"
       ).all(ftsQuery, lim);
     } catch (e) {
@@ -157,6 +161,149 @@ function _recordGraphTelemetry(event) {
   } catch (e) { /* non-fatal */ }
 }
 
+// Re-inject graph god nodes after compaction so the LLM doesn't lose its spatial map.
+function _injectCompactGraphMap() {
+  try {
+    var db = _openMonographDb();
+    if (!db) return;
+    try {
+      var nodeC = db.prepare("SELECT COUNT(*) AS c FROM nodes").get().c;
+      var gods = db.prepare(
+        "SELECT n.name, n.label, n.file_path, " +
+        "(SELECT COUNT(*) FROM edges WHERE source_id=n.id OR target_id=n.id) AS deg " +
+        "FROM nodes n " +
+        "WHERE n.label NOT IN ('Concept') AND n.file_path IS NOT NULL AND n.file_path != '' " +
+        "AND n.name NOT LIKE '(%' AND n.name NOT LIKE '%=>%' AND length(n.name) >= 3 " +
+        "ORDER BY deg DESC LIMIT 8"
+      ).all();
+      if (gods.length > 0) {
+        console.log('[COMPACT_GRAPH] ' + nodeC + ' nodes available. Top spatial anchors:');
+        for (var ci = 0; ci < gods.length; ci++) {
+          var g = gods[ci];
+          console.log('  · ' + g.name + ' [' + g.label + '] — ' + g.file_path + ' (deg ' + g.deg + ')');
+        }
+        console.log('  Use mcp__monomind__monograph_suggest first when navigating.');
+      }
+    } finally { try { db.close(); } catch (_) {} }
+  } catch (e) {}
+}
+
+// ── Loop drift detection ───────────────────────────────────────────────────────
+// Record tool call signatures per session, warn when the same call recurs ≥3×.
+function _recordToolCall(signature) {
+  try {
+    var f = path.join(CWD, '.monomind', 'metrics', 'tool-calls.json');
+    fs.mkdirSync(path.dirname(f), { recursive: true });
+    var d = {};
+    try { d = JSON.parse(fs.readFileSync(f, 'utf-8')); } catch (_) {}
+    if (typeof d !== 'object' || d === null) d = {};
+    // Roll over every 4 hours (new session)
+    if (!d.startedAt || (Date.now() - d.startedAt) > 4 * 60 * 60 * 1000) {
+      d = { startedAt: Date.now(), calls: {} };
+    }
+    d.calls[signature] = (d.calls[signature] || 0) + 1;
+    fs.writeFileSync(f, JSON.stringify(d));
+    return d.calls[signature];
+  } catch (e) { return 0; }
+}
+
+// ── Cost budget ────────────────────────────────────────────────────────────────
+// Read today's cost from token-summary and compare against budget ceiling.
+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 b = JSON.parse(fs.readFileSync(budgetFile, 'utf-8'));
+        dailyLimit = b.dailyLimit || dailyLimit;
+        monthlyLimit = b.monthlyLimit || monthlyLimit;
+      }
+    } catch (_) {}
+    var dailyPct = Math.round((todayCost / dailyLimit) * 100);
+    var monthlyPct = Math.round((monthCost / monthlyLimit) * 100);
+    return {
+      todayCost: todayCost, monthCost: monthCost,
+      dailyLimit: dailyLimit, monthlyLimit: monthlyLimit,
+      dailyPct: dailyPct, monthlyPct: monthlyPct,
+      alert: dailyPct >= 80 || monthlyPct >= 80,
+      breached: dailyPct >= 100 || monthlyPct >= 100,
+    };
+  } catch (e) { return null; }
+}
+
+// ── Test feedback (detection only — do not auto-run) ──────────────────────────
+// When LLM edits a source file, find tests that import it via monograph and
+// surface the list so the LLM (or user) knows what to verify.
+function _findAffectedTests(filePath) {
+  if (!filePath) return [];
+  var db = _openMonographDb();
+  if (!db) return [];
+  try {
+    var rel = filePath;
+    if (filePath.indexOf(CWD) === 0) rel = filePath.slice(CWD.length + 1);
+    // Find tests that IMPORTS any symbol whose target file_path matches our file.
+    // The graph stores IMPORTS edges to symbol nodes, not file nodes — so we
+    // match on the target node's file_path field instead of target_id directly.
+    var rows = db.prepare(
+      "SELECT DISTINCT src.file_path FROM edges e " +
+      "JOIN nodes src ON e.source_id = src.id " +
+      "JOIN nodes tgt ON e.target_id = tgt.id " +
+      "WHERE e.relation IN ('IMPORTS','CALLS','DEPENDS_ON') " +
+      "AND (tgt.file_path = ? OR tgt.file_path = ?) " +
+      "AND src.file_path IS NOT NULL AND src.file_path != '' " +
+      "AND (src.file_path LIKE '%test%' OR src.file_path LIKE '%.spec.%' OR src.file_path LIKE '%__tests__%') " +
+      "AND src.file_path NOT LIKE '%.worktrees%' " +
+      "LIMIT 5"
+    ).all(filePath, rel);
+    return rows.map(function(r) { return r.file_path; });
+  } catch (e) { return []; }
+  finally { try { db.close(); } catch (_) {} }
+}
+
+// ── Hook latency tracking ─────────────────────────────────────────────────────
+function _recordHookLatency(handlerName, durationMs) {
+  try {
+    var f = path.join(CWD, '.monomind', 'metrics', 'hook-latency.json');
+    fs.mkdirSync(path.dirname(f), { recursive: true });
+    var d = {};
+    try { d = JSON.parse(fs.readFileSync(f, 'utf-8')); } catch (_) {}
+    if (typeof d !== 'object' || d === null) d = {};
+    var entry = d[handlerName] || { count: 0, total: 0, max: 0 };
+    entry.count++;
+    entry.total += durationMs;
+    entry.max = Math.max(entry.max, durationMs);
+    entry.mean = Math.round(entry.total / entry.count);
+    d[handlerName] = entry;
+    d.lastUpdated = Date.now();
+    fs.writeFileSync(f, JSON.stringify(d));
+  } catch (e) {}
+}
+
+// ── Auto-ADR decision detection ───────────────────────────────────────────────
+// Record sentence-level decision markers from user prompts to .monomind/decisions.jsonl
+function _recordDecisionMarkers(promptText) {
+  if (!promptText || typeof promptText !== 'string') return;
+  var markers = /\b(let's go with|we (?:chose|decided|picked|will go with)|decision[:\s]|choosing|going with|prefer to|let's use)\b[^\.\n]{0,200}/gi;
+  var matches = promptText.match(markers);
+  if (!matches || matches.length === 0) return;
+  try {
+    var f = path.join(CWD, '.monomind', 'decisions.jsonl');
+    var entry = JSON.stringify({
+      ts: Date.now(),
+      excerpts: matches.slice(0, 3),
+      prompt: promptText.slice(0, 400),
+    });
+    fs.appendFileSync(f, entry + '\n');
+  } catch (e) {}
+}
+
 // Auto-rebuild the monograph after N writes — graph staleness during heavy
 // editing is the main reason suggestions go cold. Triggered by post-edit.
 function _maybeRebuildMonograph() {
@@ -836,6 +983,21 @@ const handlers = {
 
       console.log(output.join('\n'));
 
+      // Record any decision markers in this prompt (auto-ADR pipeline).
+      try { _recordDecisionMarkers(prompt); } catch (e) {}
+
+      // Cost budget — emit amber/red banner when approaching limit.
+      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.');
+          } else {
+            console.log('[BUDGET_ALERT] Daily ' + budget.dailyPct + '% of $' + budget.dailyLimit + ' · Monthly ' + budget.monthlyPct + '% of $' + budget.monthlyLimit + '. Adjust .monomind/budget.json if needed.');
+          }
+        }
+      } catch (e) {}
+
       // Inject monograph hint for complex tasks.
       // Source of truth is .monomind/monograph.db (SQLite). Legacy stats.json
       // is no longer written by the build, so it is checked only as a fallback.
@@ -987,6 +1149,13 @@ const handlers = {
         pattern = findMatch[1] || findMatch[2] || findMatch[3] || '';
         _recordGraphTelemetry('bash_find_call');
       }
+      if (pattern && pattern.length >= 3) {
+        var sigB = 'Bash-grep:' + pattern.slice(0, 60);
+        var countB = _recordToolCall(sigB);
+        if (countB >= 3) {
+          console.log('[LOOP_DRIFT] You\'ve grepped "' + pattern.slice(0, 40) + '" ' + countB + 'x — switch to monograph_query.');
+        }
+      }
       if (pattern && pattern.length >= 3) {
         var clean = pattern.replace(/[\\^$.*+?()\[\]{}|]/g, ' ').trim();
         if (clean.length >= 3) {
@@ -1015,6 +1184,13 @@ const handlers = {
       if (typeof pattern !== 'string' || pattern.length < 3) return;
       var clean = pattern.replace(/[\\^$.*+?()\[\]{}|]/g, ' ').trim();
       if (clean.length < 3) return;
+
+      // Loop drift detection
+      var sig = (toolName || 'Search') + ':' + clean.slice(0, 60);
+      var count = _recordToolCall(sig);
+      if (count >= 3) {
+        console.log('[LOOP_DRIFT] You\'ve searched "' + clean.slice(0, 40) + '" ' + count + 'x this session — try monograph_query or monograph_impact for a structural answer.');
+      }
       var suggestions = getMonographSuggestions(clean, 5);
       if (suggestions.length === 0) return;
       console.log('[MONOGRAPH_HIT] Graph already knows ' + suggestions.length + ' file(s) matching "' + clean.slice(0, 40) + '":');
@@ -1064,6 +1240,22 @@ const handlers = {
     }
     // Increment write counter and rebuild monograph when threshold hit.
     _maybeRebuildMonograph();
+
+    // Test feedback (detection-only): when editing a source file, list tests
+    // that import it so the LLM/user knows what to verify next.
+    try {
+      var editedFile = hookInput.file_path || toolInput.file_path
+        || process.env.TOOL_INPUT_file_path || args[0] || '';
+      if (editedFile && !editedFile.match(/\.(test|spec)\./) && !editedFile.includes('__tests__')) {
+        var affectedTests = _findAffectedTests(editedFile);
+        if (affectedTests.length > 0) {
+          console.log('[AFFECTED_TESTS] ' + affectedTests.length + ' test(s) cover this file:');
+          for (var ti = 0; ti < Math.min(5, affectedTests.length); ti++) {
+            console.log('  · ' + affectedTests[ti]);
+          }
+        }
+      }
+    } catch (e) {}
     // ── Security-Sensitive File Auto-Alert ────────────────────────────────
     // When editing auth, security, crypto, or env-related files, flag it
     try {
@@ -1919,11 +2111,9 @@ const handlers = {
   },
 
   'compact-manual': async () => {
-    // Consolidate intelligence before compaction so patterns survive
     if (intelligence && intelligence.consolidate) {
       try { await runWithTimeout(function() { return intelligence.consolidate(); }, 'intelligence.consolidate()'); } catch (e) { /* non-fatal */ }
     }
-    // Save current routing context for post-compact restore
     try {
       var lastRoute = path.join(CWD, '.monomind', 'last-route.json');
       if (fs.existsSync(lastRoute)) {
@@ -1931,11 +2121,11 @@ const handlers = {
         console.log('[COMPACT_CONTEXT] Last route: ' + route.agent + ' (' + (route.confidence != null ? (route.confidence * 100).toFixed(0) : '?') + '%)');
       }
     } catch (e) { /* non-fatal */ }
+    _injectCompactGraphMap();
     console.log('[COMPACT] Manual compaction — intelligence consolidated, context preserved');
   },
 
   'compact-auto': async () => {
-    // Same consolidation for auto-compact
     if (intelligence && intelligence.consolidate) {
       try { await runWithTimeout(function() { return intelligence.consolidate(); }, 'intelligence.consolidate()'); } catch (e) { /* non-fatal */ }
     }
@@ -1946,6 +2136,7 @@ const handlers = {
         console.log('[COMPACT_CONTEXT] Last route: ' + route.agent + ' (' + (route.confidence != null ? (route.confidence * 100).toFixed(0) : '?') + '%)');
       }
     } catch (e) { /* non-fatal */ }
+    _injectCompactGraphMap();
     console.log('[COMPACT] Auto compaction — intelligence consolidated, context preserved');
     console.log('GOLDEN RULE: 1 message = all parallel operations');
   },
@@ -2038,6 +2229,62 @@ const handlers = {
     console.log('[OK] Agent registered');
   },
 
+  // Draft an ADR from accumulated decision markers in .monomind/decisions.jsonl.
+  // Usage: node hook-handler.cjs adr-draft   (or via /adr slash command)
+  'adr-draft': () => {
+    var jsonl = path.join(CWD, '.monomind', 'decisions.jsonl');
+    if (!fs.existsSync(jsonl)) {
+      console.log('[ADR] No decisions recorded yet. Type prompts containing markers like "let\'s go with X", "we chose Y", "decision: Z" to populate the log.');
+      return;
+    }
+    var lines = fs.readFileSync(jsonl, 'utf-8').trim().split('\n').filter(Boolean);
+    if (lines.length === 0) {
+      console.log('[ADR] decisions.jsonl is empty.');
+      return;
+    }
+    // Group decisions captured in the last 7 days
+    var cutoff = Date.now() - 7 * 24 * 60 * 60 * 1000;
+    var recent = lines.map(function(l) { try { return JSON.parse(l); } catch (_) { return null; } })
+                       .filter(function(d) { return d && d.ts >= cutoff; });
+    if (recent.length === 0) {
+      console.log('[ADR] No decisions in the last 7 days. Older entries: ' + lines.length + '.');
+      return;
+    }
+
+    var adrsDir = path.join(CWD, 'docs', 'adrs');
+    try { fs.mkdirSync(adrsDir, { recursive: true }); } catch (_) {}
+    // Pick next ADR number
+    var existing = [];
+    try { existing = fs.readdirSync(adrsDir).filter(function(f) { return /^ADR-\d{4}/.test(f); }); } catch (_) {}
+    var nextNum = existing.length + 1;
+    var num = String(nextNum).padStart(4, '0');
+    var stamp = new Date().toISOString().slice(0,10);
+    var slug = 'session-decisions';
+    var fname = 'ADR-' + num + '-' + stamp + '-' + slug + '.md';
+    var outPath = path.join(adrsDir, fname);
+
+    var body = '# ADR-' + num + ': Session decisions (' + stamp + ')\n\n' +
+               '**Status:** Proposed\n**Date:** ' + stamp + '\n\n' +
+               '## Context\n\n' +
+               'During recent sessions, the following decision markers were captured ' +
+               'from user prompts. Each excerpt is the surrounding sentence at the time.\n\n' +
+               '## Decisions\n\n';
+    for (var i = 0; i < recent.length; i++) {
+      var d = recent[i];
+      var date = new Date(d.ts).toISOString().slice(0,16).replace('T',' ');
+      body += '### ' + (i + 1) + '. ' + date + '\n\n';
+      for (var j = 0; j < d.excerpts.length; j++) {
+        body += '> ' + d.excerpts[j].trim() + '\n\n';
+      }
+      if (d.prompt) body += '_Prompt:_ ' + d.prompt.slice(0, 200) + (d.prompt.length > 200 ? '…' : '') + '\n\n';
+    }
+    body += '## Consequences\n\n_(fill in after review)_\n\n' +
+            '## Status\n\nProposed — awaiting human review and refinement.\n';
+    fs.writeFileSync(outPath, body);
+    console.log('[ADR_DRAFT] Wrote ' + recent.length + ' decision(s) to ' + outPath);
+    console.log('  Edit the file to fill in Context and Consequences, then change Status to Accepted/Rejected.');
+  },
+
   'status': () => {
     console.log('[OK] Status check');
   },
@@ -2052,15 +2299,18 @@ const handlers = {
 };
 
 if (command && handlers[command]) {
+    var _hookStart = Date.now();
     try {
       await Promise.resolve(handlers[command]());
     } catch (e) {
       console.log('[WARN] Hook ' + command + ' encountered an error: ' + e.message);
+    } finally {
+      try { _recordHookLatency(command, Date.now() - _hookStart); } catch (_) {}
     }
   } else if (command) {
     console.log('[OK] Hook: ' + command);
   } else {
-    console.log('Usage: hook-handler.cjs <route|pre-bash|post-edit|session-restore|session-end|pre-task|post-task|compact-manual|compact-auto|status|stats>');
+    console.log('Usage: hook-handler.cjs <route|pre-bash|pre-search|post-edit|post-read|post-graph-tool|session-restore|session-end|pre-task|post-task|compact-manual|compact-auto|status|stats>');
   }
 }
 

package/.claude/helpers/statusline.cjs

@@ -696,6 +696,30 @@ function getGraphifyStats() {
   return { nodes: 0, edges: 0, exists: false };
 }
 
+// Hook latency — sum of mean times for hooks that fire on every prompt.
+function getHookLatency() {
+  const p = path.join(CWD, '.monomind', 'metrics', 'hook-latency.json');
+  try {
+    if (!fs.existsSync(p)) return null;
+    const d = JSON.parse(fs.readFileSync(p, 'utf-8'));
+    // Hooks that run per-prompt: route, pre-search, post-read, post-edit
+    const perPrompt = ['route'];
+    let totalMs = 0;
+    let count = 0;
+    for (const h of perPrompt) {
+      if (d[h] && d[h].mean) { totalMs += d[h].mean; count++; }
+    }
+    if (count === 0) return null;
+    // Find slowest hook
+    let slowest = null;
+    for (const k of Object.keys(d)) {
+      if (k === 'lastUpdated' || !d[k] || typeof d[k] !== 'object') continue;
+      if (!slowest || d[k].mean > slowest.mean) slowest = { name: k, mean: d[k].mean };
+    }
+    return { perPromptMs: totalMs, slowest };
+  } catch { return null; }
+}
+
 // Graph usage telemetry — ratio of monograph_* vs Grep/Glob, plus $ saved
 function getGraphUsage() {
   const usagePath = path.join(CWD, '.monomind', 'metrics', 'graph-usage.json');
@@ -1270,7 +1294,16 @@ function generateDashboard() {
     usageStr = `   ${DIV}   ${col}📊 graph ${usage.pct}%${x.reset}${x.slate} · grep ${100 - usage.pct}%${x.reset}${saved}`;
   }
 
-  lines.push(`${x.purple}🤖  AGENT${x.reset}    ${agentStr}   ${DIV}   ${loopStr}${usageStr}`);
+  // Hook latency — surface when slow (>500ms per prompt)
+  const lat = getHookLatency();
+  let latStr = '';
+  if (lat && lat.perPromptMs > 500) {
+    latStr = `   ${DIV}   ${x.coral}⚡ hooks ${lat.perPromptMs}ms${x.reset}`;
+  } else if (lat && lat.perPromptMs > 0) {
+    latStr = `   ${DIV}   ${x.dim}⚡ ${lat.perPromptMs}ms${x.reset}`;
+  }
+
+  lines.push(`${x.purple}🤖  AGENT${x.reset}    ${agentStr}   ${DIV}   ${loopStr}${usageStr}${latStr}`);
   lines.push(SEP);
 
   // ── Row 2: Graph freshness + Pending HIL ─────────────────────

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

@@ -1 +1 @@
-{"version":3,"file":"statusline-generator.d.ts","sourceRoot":"","sources":["../../../src/init/statusline-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CA8oCrE;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CA8BnE"}
+{"version":3,"file":"statusline-generator.d.ts","sourceRoot":"","sources":["../../../src/init/statusline-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CA4qCrE;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CA8BnE"}

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

@@ -828,6 +828,27 @@ function getTriggerStats() {
   } catch { return { triggers: 0, agents: 0 }; }
 }
 
+// Hook latency — surface slow per-prompt hooks in the statusline.
+function getHookLatency() {
+  const p = path.join(CWD, '.monomind', 'metrics', 'hook-latency.json');
+  try {
+    if (!fs.existsSync(p)) return null;
+    const d = JSON.parse(fs.readFileSync(p, 'utf-8'));
+    const perPrompt = ['route'];
+    let totalMs = 0; let count = 0;
+    for (const h of perPrompt) {
+      if (d[h] && d[h].mean) { totalMs += d[h].mean; count++; }
+    }
+    if (count === 0) return null;
+    let slowest = null;
+    for (const k of Object.keys(d)) {
+      if (k === 'lastUpdated' || !d[k] || typeof d[k] !== 'object') continue;
+      if (!slowest || d[k].mean > slowest.mean) slowest = { name: k, mean: d[k].mean };
+    }
+    return { perPromptMs: totalMs, slowest: slowest };
+  } catch { return null; }
+}
+
 // Graph usage telemetry — ratio of monograph_* vs Grep/Glob/Bash-grep, + $ saved
 function getGraphUsage() {
   const usagePath = path.join(CWD, '.monomind', 'metrics', 'graph-usage.json');
@@ -1096,7 +1117,16 @@ function generateDashboard() {
     usageStr = \`   \${DIV}   \${col}📊 graph \${usage.pct}%\${x.reset}\${x.slate} · grep \${100 - usage.pct}%\${x.reset}\${saved}\`;
   }
 
-  lines.push(\`\${x.purple}🤖  AGENT\${x.reset}    \${agentStr}   \${DIV}   \${loopStr}\${usageStr}\`);
+  // Hook latency — surface when slow (>500ms per prompt)
+  const lat = getHookLatency();
+  let latStr = '';
+  if (lat && lat.perPromptMs > 500) {
+    latStr = \`   \${DIV}   \${x.coral}⚡ hooks \${lat.perPromptMs}ms\${x.reset}\`;
+  } else if (lat && lat.perPromptMs > 0) {
+    latStr = \`   \${DIV}   \${x.dim}⚡ \${lat.perPromptMs}ms\${x.reset}\`;
+  }
+
+  lines.push(\`\${x.purple}🤖  AGENT\${x.reset}    \${agentStr}   \${DIV}   \${loopStr}\${usageStr}\${latStr}\`);
   lines.push(SEP);
 
   // ── Row 2: Graph freshness + Pending HIL ─────────────────────

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

@@ -1 +1 @@
-{"version":3,"file":"statusline-generator.js","sourceRoot":"","sources":["../../../src/init/statusline-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;;;;;;;GASG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAoB;IAC3D,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;IAC5C,OAAO;;;;;;;;;;;;;;;;;;;;;;;eAuBM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAonCvB,CAAC;AACF,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAoB;IACzD,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QAChC,OAAO,sCAAsC,CAAC;IAChD,CAAC;IAED,OAAO;;;;;;;;;;;;;;;;;;;;;;;;CAwBR,CAAC;AACF,CAAC"}
+{"version":3,"file":"statusline-generator.js","sourceRoot":"","sources":["../../../src/init/statusline-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;;;;;;;GASG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAoB;IAC3D,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;IAC5C,OAAO;;;;;;;;;;;;;;;;;;;;;;;eAuBM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkpCvB,CAAC;AACF,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAoB;IACzD,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QAChC,OAAO,sCAAsC,CAAC;IAChD,CAAC;IAED,OAAO;;;;;;;;;;;;;;;;;;;;;;;;CAwBR,CAAC;AACF,CAAC"}

package/dist/src/ui/server.mjs

@@ -2128,6 +2128,70 @@ export async function startServer({ port = 4242, projectDir, openBrowser = true
       return;
     }
 
+    // ------------------------------------------------- Monograph
+    // GET /api/monograph — node/edge counts, top god nodes, type distribution.
+    // (Distinct from /api/graph which serves session/journal graph data.)
+    // Reads .monomind/monograph.db via sqlite3 CLI to avoid bundling better-sqlite3.
+    if (req.method === 'GET' && url === '/api/monograph') {
+      try {
+        const dbPath = path.join(projectDir || process.cwd(), '.monomind', 'monograph.db');
+        if (!fs.existsSync(dbPath)) {
+          res.writeHead(200, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ exists: false }));
+          return;
+        }
+        const { execSync } = await import('child_process');
+        // Pipe SQL via stdin to avoid shell quoting issues with single-quoted SQL strings.
+        const runSql = (sql, timeout = 5000) => {
+          try {
+            return execSync(`sqlite3 -json "${dbPath}"`,
+              { encoding: 'utf-8', timeout: timeout, input: sql + ';' });
+          } catch (e) { return '[]'; }
+        };
+        const counts = JSON.parse(runSql(
+          "SELECT (SELECT COUNT(*) FROM nodes) AS nodes, (SELECT COUNT(*) FROM edges) AS edges;"
+        ) || '[{}]')[0] || { nodes: 0, edges: 0 };
+        // Compute degree in one pass via GROUP BY (much faster than per-row subquery).
+        const gods = JSON.parse(runSql(
+          "WITH deg(node_id, d) AS (" +
+          "  SELECT source_id, COUNT(*) FROM edges GROUP BY source_id " +
+          "  UNION ALL " +
+          "  SELECT target_id, COUNT(*) FROM edges GROUP BY target_id" +
+          "), totals AS (" +
+          "  SELECT node_id, SUM(d) AS deg FROM deg GROUP BY node_id" +
+          ") " +
+          "SELECT n.name, n.label, n.file_path, t.deg " +
+          "FROM nodes n JOIN totals t ON t.node_id = n.id " +
+          "WHERE n.label NOT IN ('Concept') " +
+          "AND n.file_path IS NOT NULL AND n.file_path != '' " +
+          "AND n.name NOT LIKE '(%' AND length(n.name) >= 3 " +
+          "ORDER BY t.deg DESC LIMIT 20",
+          10000
+        ) || '[]');
+        const types = JSON.parse(runSql(
+          "SELECT label, COUNT(*) AS count FROM nodes GROUP BY label ORDER BY count DESC LIMIT 12"
+        ) || '[]');
+        const relations = JSON.parse(runSql(
+          "SELECT relation, COUNT(*) AS count FROM edges GROUP BY relation ORDER BY count DESC"
+        ) || '[]');
+
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({
+          exists: true,
+          nodes: counts.nodes,
+          edges: counts.edges,
+          godNodes: gods,
+          typeDistribution: types,
+          relationDistribution: relations,
+          updatedAt: fs.statSync(dbPath).mtime,
+        }));
+      } catch (err) {
+        res.writeHead(500, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: String(err) }));
+      }
+      return;
+    }
+
     // ------------------------------------------------- Org management
     // GET /api/orgs — list all saved org configs
     if (req.method === 'GET' && url === '/api/orgs') {