@monoes/monomindcli 1.10.29 → 1.10.30

package/.claude/helpers/auto-memory-hook.mjs

@@ -11,7 +11,7 @@
  *   node auto-memory-hook.mjs status   # Show bridge status
  */
 
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { existsSync, mkdirSync, openSync, closeSync, unlinkSync, readFileSync, writeFileSync, renameSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 
@@ -34,6 +34,37 @@ const dim = (msg) => console.log(`  ${DIM}${msg}${RESET}`);
 // Ensure data dir
 if (!existsSync(DATA_DIR)) mkdirSync(DATA_DIR, { recursive: true });
 
+// ============================================================================
+// File-lock helper for concurrent hook coordination
+// Uses O_EXCL exclusive-create as a spin lock.
+// A 10ms synchronous wait (via Atomics.wait) is used between retries to avoid
+// pegging the CPU. Acceptable for low-contention hook processes.
+// ============================================================================
+
+function withFileLock(lockPath, fn, timeoutMs = 5000) {
+  const start = Date.now();
+  const sharedBuf = new Int32Array(new SharedArrayBuffer(4));
+  while (true) {
+    try {
+      // O_EXCL: exclusive create — fails atomically if file already exists
+      const fd = openSync(lockPath, 'wx');
+      closeSync(fd);
+      break; // acquired lock
+    } catch {
+      if (Date.now() - start > timeoutMs) {
+        // Timeout: proceed without lock rather than deadlocking hook processes
+        try { fn(); } catch { /* best effort */ }
+        return;
+      }
+      // Synchronous 10ms sleep via Atomics.wait (avoids busy-spin CPU peg)
+      Atomics.wait(sharedBuf, 0, 0, 10);
+    }
+  }
+  try { fn(); } finally {
+    try { unlinkSync(lockPath); } catch { /* ignore */ }
+  }
+}
+
 // ============================================================================
 // Simple JSON File Backend (implements IMemoryBackend interface)
 // ============================================================================
@@ -120,9 +151,13 @@ class JsonFileBackend {
   }
 
   _persist() {
-    try {
-      writeFileSync(this.filePath, JSON.stringify([...this.entries.values()], null, 2), 'utf-8');
-    } catch { /* best effort */ }
+    const lockPath = this.filePath + '.lock';
+    withFileLock(lockPath, () => {
+      const data = JSON.stringify([...this.entries.values()], null, 2);
+      const tmpPath = this.filePath + '.tmp';
+      writeFileSync(tmpPath, data, 'utf-8');
+      renameSync(tmpPath, this.filePath);
+    });
   }
 }
 

package/.claude/helpers/handlers/edit-handler.cjs

@@ -0,0 +1,145 @@
+'use strict';
+// Extracted from hook-handler.cjs — receives hCtx from dispatcher.
+// Handles the 'post-edit' hook event.
+// See route-handler.cjs for full hCtx field documentation.
+
+const path = require('path');
+const fs = require('fs');
+
+module.exports = {
+  handle: async function(hCtx) {
+    var hookInput = hCtx.hookInput;
+    var toolInput = hCtx.toolInput;
+    var args = hCtx.args;
+    var session = hCtx.session;
+    var intelligence = hCtx.intelligence;
+    var CWD = hCtx.CWD;
+
+    if (session && session.metric) {
+      try { session.metric('edits'); } catch (e) { /* no active session */ }
+    }
+    if (intelligence && intelligence.recordEdit) {
+      try {
+        var file = hookInput.file_path || toolInput.file_path
+          || process.env.TOOL_INPUT_file_path || args[0] || '';
+        intelligence.recordEdit(file);
+      } catch (e) { /* non-fatal */ }
+    }
+    // Track recently-edited files for compact injection and pre-resolve boosting.
+    try {
+      var editedForRecent = hookInput.file_path || toolInput.file_path
+        || process.env.TOOL_INPUT_file_path || args[0] || '';
+      if (editedForRecent) hCtx._recordRecentEdit(editedForRecent);
+    } catch (e) { /* non-fatal */ }
+    // Increment write counter and rebuild monograph when threshold hit.
+    hCtx._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 = hCtx._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 {
+      var editFile = (hookInput.file_path || toolInput.file_path
+        || process.env.TOOL_INPUT_file_path || args[0] || '').toLowerCase();
+      var securityPatterns = /\b(auth|security|crypto|secret|credential|token|password|\.env|permission|acl|rbac|jwt|oauth|session|cookie)\b/;
+      if (securityPatterns.test(editFile) || editFile.includes('/security/') || editFile.includes('/auth/')) {
+        console.log('[SECURITY_EDIT] Security-sensitive file modified: ' + path.basename(editFile));
+        console.log('[SECURITY_EDIT] INSTRUCTION: Consider running a security review. Invoke Skill("code-review:code-review") with security focus, or run: npx monomind security scan --path "' + editFile + '"');
+      }
+    } catch (e) { /* non-fatal */ }
+
+    // ── Smart Test/Build Suggestions (PE-001) ───────────────────────────
+    try {
+      var editFile2 = (hookInput.file_path || toolInput.file_path
+        || process.env.TOOL_INPUT_file_path || args[0] || '');
+      var editBase = path.basename(editFile2).toLowerCase();
+      if (/\.(test|spec)\.(ts|js|tsx|jsx)$/.test(editBase)) {
+        console.log('[AUTO_SUGGEST] Test file modified — run: npm test -- --testPathPattern="' + path.basename(editFile2) + '"');
+      } else if (editBase === 'package.json') {
+        console.log('[AUTO_SUGGEST] package.json changed — consider running: npm install');
+      } else if (editBase === 'tsconfig.json' || editBase === 'tsconfig.base.json') {
+        console.log('[AUTO_SUGGEST] TypeScript config changed — consider running: npm run build');
+      }
+    } catch (e) { /* non-fatal */ }
+
+    // ── Monograph Incremental Rebuild ─────────────────────────────────────
+    // After every code file edit, trigger a background monograph rebuild so
+    // the knowledge graph stays current. Debounced via a lock file (5s cooldown).
+    try {
+      var editedFile2 = (hookInput.file_path || toolInput.file_path
+        || process.env.TOOL_INPUT_file_path || args[0] || '');
+      var codeExts = /\.(ts|tsx|js|jsx|mjs|cjs|py|go|rs|java|kt|cs|cpp|c|rb|swift|php)$/i;
+      if (editedFile2 && codeExts.test(editedFile2)) {
+        var lockFile = path.join(CWD, '.monomind', 'graph', '.rebuild-lock');
+        var now = Date.now();
+        var lastBuild = 0;
+        try { lastBuild = parseInt(fs.readFileSync(lockFile, 'utf-8').trim(), 10) || 0; } catch (e) {}
+        var COOLDOWN_MS = 5000; // 5-second debounce
+        if (now - lastBuild > COOLDOWN_MS) {
+          fs.writeFileSync(lockFile, String(now), 'utf-8');
+          var { spawn: spawnRebuild } = require('child_process');
+          var rebuildScript = "import { buildAsync } from '@monoes/monograph'; await buildAsync(" + JSON.stringify(CWD) + ");";
+          var graphDir = path.join(CWD, '.monomind', 'graph');
+          var logPath = path.join(graphDir, 'build.log');
+          var logFd;
+          try { logFd = fs.openSync(logPath, 'a'); } catch(e) { logFd = 'ignore'; }
+          var child = spawnRebuild(process.execPath, ['--input-type=module', '--eval', rebuildScript], {
+            detached: true, stdio: ['ignore', logFd, logFd], cwd: CWD,
+          });
+          child.unref();
+          console.log('[MONOGRAPH] Incremental rebuild triggered for ' + path.basename(editedFile2));
+
+          // Option C: fire ua-enrich.mjs in background after monograph rebuild
+          var uaEnrichScript = path.join(CWD, 'scripts', 'ua-enrich.mjs');
+          if (fs.existsSync(uaEnrichScript)) {
+            var uaChild = spawnRebuild(process.execPath, [uaEnrichScript, '--dir', CWD, '--file', editedFile2, '--db', path.join(CWD, '.monomind', 'monograph.db')], {
+              detached: true, stdio: 'ignore', cwd: CWD,
+            });
+            uaChild.unref();
+          }
+        }
+        // Show importers of the edited file so Claude sees blast radius
+        try {
+          var mgDbPath4 = path.join(CWD, '.monomind', 'monograph.db');
+          if (fs.existsSync(mgDbPath4)) {
+            var mgMod4 = null;
+            var _requireMonograph4 = hCtx._requireMonograph;
+            mgMod4 = _requireMonograph4 ? _requireMonograph4() : null;
+            if (mgMod4 && mgMod4.openDb) {
+              var db4 = mgMod4.openDb(mgDbPath4);
+              try {
+                var editedBase4 = path.basename(editedFile2).replace(/\.[^.]+$/, '');
+                var editNode4 = db4.prepare("SELECT id, name, label FROM nodes WHERE file_path LIKE ? OR name = ? LIMIT 1")
+                  .get('%' + path.sep + path.basename(editedFile2), editedBase4);
+                if (editNode4) {
+                  var editImporters4 = db4.prepare(
+                    'SELECT n2.name FROM edges e JOIN nodes n2 ON n2.id = e.source_id WHERE e.target_id = ? LIMIT 8'
+                  ).all(editNode4.id);
+                  if (editImporters4.length > 0) {
+                    console.log('[MONOGRAPH_IMPACT] ' + editNode4.name + ' (' + editNode4.label + ') is depended on by: ' +
+                      editImporters4.map(function(i) { return i.name; }).join(', '));
+                  }
+                }
+              } finally { if (mgMod4.closeDb) mgMod4.closeDb(db4); }
+            }
+          }
+        } catch(e) { /* non-fatal */ }
+      }
+    } catch (e) { /* non-fatal */ }
+
+    console.log('[OK] Edit recorded');
+  }
+};

package/.claude/helpers/handlers/route-handler.cjs

@@ -0,0 +1,393 @@
+'use strict';
+// Extracted from hook-handler.cjs — receives hCtx from dispatcher.
+// Behavioral equivalence verified: 133 routing tests pass post-extraction.
+// hCtx (hook context) contains all shared state and utility functions:
+//   hCtx.hookInput, hCtx.toolInput, hCtx.toolName, hCtx.prompt, hCtx.args, hCtx.CWD
+//   hCtx.session, hCtx.router, hCtx.intelligence
+//   hCtx.isSimpleCommand — function defined in main(), passed via hCtx
+//   hCtx.getLearningService — async factory for LearningService singleton
+//   Utility fns: _recordRecentEdit, _findAffectedTests, _recordHookLatency,
+//     _getBudgetStatus, _injectCompactGraphMap, _maybeRebuildMonograph,
+//     _buildKnowledgeSearchFn, getMonographSuggestions, getMonographNeighbors,
+//     runWithTimeout, safeRequire, scanMicroAgentTriggers, _recordGraphTelemetry,
+//     _recordDecisionMarkers, _recordToolCall, _openMonographDb, fs, path
+//
+// NOTE: The 'route' handler has a local variable named 'ctx' (from intelligence.getContext).
+// The dispatcher passes the hook context as 'hCtx' to avoid collision.
+
+const path = require('path');
+const fs = require('fs');
+
+module.exports = {
+  handle: async function(hCtx) {
+    var prompt = hCtx.prompt;
+    var hookInput = hCtx.hookInput;
+    var router = hCtx.router;
+    var intelligence = hCtx.intelligence;
+    var CWD = hCtx.CWD;
+
+    // For slash commands and single-action invocations: skip routing panel output
+    // but still write last-route.json so the statusline reflects the current action.
+    if (hCtx.isSimpleCommand(prompt)) {
+      try {
+        var cmdLabel = (typeof prompt === 'string' && prompt.trim().startsWith('/'))
+          ? prompt.trim().split(/\s+/)[0]          // e.g. "/ts"
+          : (hookInput.commandName || hookInput.command_name || 'command');
+        var routeDir = path.join(CWD, '.monomind');
+        fs.mkdirSync(routeDir, { recursive: true });
+        fs.writeFileSync(
+          path.join(routeDir, 'last-route.json'),
+          JSON.stringify({
+            agent: cmdLabel,
+            confidence: 1.0,
+            reason: 'predefined command — no routing needed',
+            semanticRouting: false,
+            updatedAt: new Date().toISOString(),
+          }),
+          'utf-8'
+        );
+      } catch (e) { /* non-fatal */ }
+      return;
+    }
+
+    if (intelligence && intelligence.getContext) {
+      try {
+        const ctx = intelligence.getContext(prompt);
+        if (ctx) console.log(ctx);
+      } catch (e) { /* non-fatal */ }
+    }
+    if (router && (router.routeTaskSemantic || router.routeTask)) {
+      const routeFn = router.routeTaskSemantic || router.routeTask;
+      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 = hCtx.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';
+            // Scale confidence by graph degree: well-connected nodes are stronger anchors.
+            var topDeg = topGraph.deg || 0;
+            var graphConf = topDeg > 30 ? 0.80 : (topDeg > 10 ? 0.75 : 0.70);
+            result = Object.assign({}, result, {
+              agent: agent,
+              agentSlug: agent,
+              confidence: graphConf,
+              reason: 'Graph fallback: top file ' + (topGraph.name || '').substring(0, 30) + ' [' + topGraph.label + '] deg=' + topDeg,
+              specificAgents: [],
+              extrasMatches: [],
+            });
+          }
+        }
+      } catch (e) {}
+
+      var output = [];
+      output.push('[INFO] Routing task: ' + (prompt.substring(0, 80) || '(no prompt)'));
+      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 {
+        var routeDir = path.join(CWD, '.monomind');
+        fs.mkdirSync(routeDir, { recursive: true });
+        // Always use the resolved agent name — never persist "extras"
+        var resolvedAgent = result.agent;
+        if (!resolvedAgent || resolvedAgent === 'extras') {
+          var topExtra = result.extrasMatches && result.extrasMatches[0];
+          resolvedAgent = topExtra ? topExtra.name : 'Specialist Agent';
+        }
+        var routePayload = {
+          agent: resolvedAgent,
+          agentSlug: result.agentSlug || null,
+          confidence: result.confidence,
+          reason: result.reason,
+          semanticRouting: result.semanticRouting || false,
+          llmRouting: result.llmRouting || false,
+          updatedAt: new Date().toISOString(),
+        };
+        if (result.extrasMatches && result.extrasMatches.length > 0) {
+          routePayload.extrasMatches = result.extrasMatches.map(function(e) {
+            return { name: e.name, slug: e.slug, category: e.category };
+          });
+        }
+        fs.writeFileSync(
+          path.join(routeDir, 'last-route.json'),
+          JSON.stringify(routePayload),
+          'utf-8'
+        );
+      } catch (e) { /* non-fatal */ }
+
+      // ── Dev skill suggestions ──────────────────────────────────────
+      var matches = result.skillMatches || [];
+      if (matches.length > 0) {
+        // Check for high-confidence auto-invoke: if top skill scored >= 3 keyword
+        // hits and is the dominant match, auto-invoke instead of just suggesting
+        var topMatch = matches[0];
+        var autoInvoke = false;
+        if (topMatch && topMatch.score >= 3 && matches.length <= 2) {
+          autoInvoke = true;
+        } else if (topMatch && topMatch.score >= 2 && matches.length === 1 && (result.confidence ?? 0) < 0.7) {
+          // Single strong skill match with weak agent routing = skill should take over
+          autoInvoke = true;
+        }
+
+        if (autoInvoke) {
+          output.push('');
+          output.push('+======== SKILL AUTO-ACTIVATED (high confidence match) ========+');
+          output.push('| ' + topMatch.invoke.substring(0, 61).padEnd(61) + '|');
+          output.push('| INSTRUCTION: Invoke ' + topMatch.invoke.substring(0, 41).padEnd(41) + '|');
+          output.push('| BEFORE responding. This skill matched with very high         |');
+          output.push('| confidence — do not skip it.                                 |');
+          output.push('+==============================================================+');
+        } else {
+          output.push('');
+          if ((result.confidence ?? 0) < 0.8) {
+            output.push('+----------- Skill Suggestions (pick one if relevant) ---------+');
+            output.push('| No strong primary match — here are the best skill candidates |');
+          } else {
+            output.push('+----------- Matching Skills (invoke via Skill tool) ----------+');
+          }
+          matches.forEach(function(m, i) {
+            var label = (i + 1) + '. ' + m.skill;
+            var desc = (m.description || '').substring(0, 30);
+            var line = '| ' + label.substring(0, 30).padEnd(30) + desc.padEnd(30) + ' |';
+            output.push(line);
+            output.push('|   invoke: ' + m.invoke.substring(0, 51).padEnd(51) + '|');
+          });
+          output.push('+--------------------------------------------------------------+');
+          if ((result.confidence ?? 0) < 0.8) {
+            output.push('| To use a skill: call Skill("skill-name") before responding.  |');
+            output.push('+--------------------------------------------------------------+');
+          }
+        }
+      }
+
+      // ── Specific agent panel ──────────────────────────────────────────────────
+      // Skip entirely on suppressed (low-confidence + short) prompts.
+      var specificAgents = result.specificAgents || [];
+      if (specificAgents.length > 0 && !suppressPanel) {
+        output.push('');
+        var saHdr = '------- Specific Agents (' + specificAgents.length + ' available) ';
+        output.push('+' + saHdr + '-'.repeat(Math.max(1, 62 - saHdr.length)) + '+');
+        specificAgents.forEach(function(a, i) {
+          var label = (i + 1) + '. ' + a.label;
+          var note = (a.note || '').substring(0, 26);
+          output.push('| ' + label.substring(0, 33).padEnd(33) + note.padEnd(27) + ' |');
+          if (a.slug) {
+            output.push('|   slug: ' + a.slug.substring(0, 52).padEnd(52) + ' |');
+          }
+        });
+        output.push('+--------------------------------------------------------------+');
+        output.push('| Use: Task({ subagent_type: "<slug>" })  or  /specialagent    |');
+        output.push('+--------------------------------------------------------------+');
+      }
+
+      // ── 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 && !suppressPanel) {
+        output.push('');
+        var spHdr = '------- Specialist Agents (' + extras.length + ' matched) ';
+        output.push('+' + spHdr + '-'.repeat(Math.max(1, 62 - spHdr.length)) + '+');
+        extras.slice(0, 5).forEach(function(e, i) {
+          var label = (i + 1) + '. ' + e.name;
+          var cat = '[' + e.category + ']';
+          output.push('| ' + label.substring(0, 44).padEnd(44) + cat.substring(0, 16).padEnd(16) + ' |');
+          output.push('|   slug: ' + e.slug.substring(0, 52).padEnd(52) + ' |');
+        });
+        output.push('+--------------------------------------------------------------+');
+        output.push('| Use: Task({ subagent_type: "<slug>" })  or  /specialagent    |');
+        output.push('+--------------------------------------------------------------+');
+      }
+
+      // ── MicroAgent Trigger Scan (Task 32) ──────────────────────────────
+      try {
+        var triggerResult = hCtx.scanMicroAgentTriggers(typeof prompt === 'string' ? prompt : '');
+        if (triggerResult.matches.length > 0) {
+          output.push('');
+          if (triggerResult.takeoverAgent) {
+            var tAgent = triggerResult.takeoverAgent;
+            var tKw = triggerResult.matches[0].matchedText;
+            output.push('+============= MicroAgent TAKEOVER Detected ===================+');
+            output.push('| Specialist: ' + tAgent.substring(0, 49).padEnd(49) + '|');
+            output.push('| Keyword:    ' + ('"' + tKw + '"').substring(0, 49).padEnd(49) + '|');
+            output.push('| Recommended: use this specialist instead of primary agent.   |');
+            output.push('+==============================================================+');
+          } else {
+            output.push('+------- MicroAgent Specialists Triggered ---------------------+');
+            triggerResult.matches.forEach(function(m) {
+              var slug = m.agentSlug.substring(0, 37).padEnd(37);
+              var kw = ('(match: "' + m.matchedText + '")').substring(0, 21).padEnd(21);
+              output.push('| + ' + slug + kw + ' |');
+            });
+            output.push('+--------------------------------------------------------------+');
+          }
+          // Persist trigger matches alongside route result
+          try {
+            var routeFile = path.join(CWD, '.monomind', 'last-route.json');
+            var existing = JSON.parse(fs.readFileSync(routeFile, 'utf-8'));
+            existing.microAgents = { injectAgents: triggerResult.injectAgents || [], takeoverAgent: triggerResult.takeoverAgent || null };
+            fs.writeFileSync(routeFile, JSON.stringify(existing), 'utf-8');
+          } catch (e) {}
+        }
+      } catch (e) { /* non-fatal */ }
+
+      console.log(output.join('\n'));
+
+      // Record any decision markers in this prompt (auto-ADR pipeline).
+      try { hCtx._recordDecisionMarkers(prompt); } catch (e) {}
+
+      // Cost budget — emit amber/red banner when approaching limit.
+      try {
+        var budget = hCtx._getBudgetStatus();
+        if (budget && budget.alert) {
+          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 + tunedNote + '.');
+          }
+        }
+      } 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.
+      try {
+        var monographDb = path.join(CWD, '.monomind', 'monograph.db');
+        var legacyStats = path.join(CWD, '.monomind', 'graph', 'stats.json');
+        var nodeCount = 0;
+        if (fs.existsSync(monographDb)) {
+          try {
+            var hintDb = hCtx._openMonographDb();
+            if (hintDb) {
+              nodeCount = hintDb.prepare('SELECT COUNT(*) AS c FROM nodes').get().c;
+            }
+          } catch (e) { /* ignore — fall back to legacy */ }
+        }
+        if (nodeCount === 0 && fs.existsSync(legacyStats)) {
+          try {
+            var gStats = JSON.parse(fs.readFileSync(legacyStats, 'utf-8'));
+            nodeCount = gStats.nodes || 0;
+          } catch (e) { /* ignore */ }
+        }
+        if (nodeCount > 100) {
+          // Pre-resolve top-5 relevant files for the user's prompt — the LLM
+          // sees the answer inline instead of being told to call a tool.
+          var suggestions = hCtx.getMonographSuggestions(prompt, 5);
+
+          // Boost recently-edited files to the top of pre-resolve suggestions.
+          // Even when the FTS index hasn't caught up to the latest edits, the
+          // LLM should see the files it just modified as the primary context.
+          try {
+            var recentEditsForRoute = hCtx._getRecentEdits();
+            if (recentEditsForRoute.length > 0) {
+              // Extract prompt keywords for relevance gating
+              var promptWords = (prompt || '').toLowerCase().match(/[a-z][a-z0-9_-]{2,}/g) || [];
+              var promptWordSet = {};
+              for (var pw = 0; pw < promptWords.length; pw++) promptWordSet[promptWords[pw]] = 1;
+
+              var existingFiles = {};
+              for (var se = 0; se < suggestions.length; se++) existingFiles[suggestions[se].file || ''] = 1;
+
+              var editBoosts = [];
+              for (var re = 0; re < recentEditsForRoute.length && editBoosts.length < 2; re++) {
+                var reFile = recentEditsForRoute[re].file;
+                // Skip if already in suggestions
+                if (existingFiles[reFile]) continue;
+                var reName = path.basename(reFile, path.extname(reFile)).toLowerCase();
+                // Only boost if filename shares a keyword with the prompt OR the edit is very recent (<3 min)
+                var veryRecent = (Date.now() - recentEditsForRoute[re].editedAt) < 3 * 60 * 1000;
+                var editMatches = promptWordSet[reName] || veryRecent;
+                if (editMatches) {
+                  editBoosts.push({ name: path.basename(reFile), label: 'File', file: reFile, deg: 0, _editBoost: true });
+                }
+              }
+              if (editBoosts.length > 0) {
+                suggestions = editBoosts.concat(suggestions).slice(0, 5);
+              }
+            }
+          } catch (e) { /* non-fatal */ }
+
+          if (suggestions.length > 0) {
+            console.log('\n[MONOGRAPH] ' + nodeCount + ' nodes indexed. Top files for this task (pre-resolved from graph):');
+            for (var si = 0; si < suggestions.length; si++) {
+              var s = suggestions[si];
+              var editTag = s._editBoost ? ' ✎' : '';
+              console.log('  · ' + s.name + ' [' + s.label + '] — ' + (s.file || '') + (s.deg ? ' (deg ' + s.deg + ')' : '') + editTag);
+            }
+            console.log('  Use mcp__monomind__monograph_query / monograph_impact for deeper drill-down.');
+            hCtx._recordGraphTelemetry('preresolve_hit');
+          } else {
+            console.log('\n[MONOGRAPH] ' + nodeCount + ' nodes indexed. Call mcp__monomind__monograph_suggest first to find relevant files without grepping.');
+            hCtx._recordGraphTelemetry('preresolve_miss');
+          }
+        }
+      } catch(e) {}
+
+      // Swarm mode selection is available on-demand via /mastermind slash command.
+    } else {
+      console.log('[INFO] Router not available, using default routing');
+    }
+
+    // Task 22: TeamRoutingModes — only log when an explicit swarm config is present
+    try {
+      var swarmCfgPath = path.join(CWD, '.monomind', 'swarm-config.json');
+      if (fs.existsSync(swarmCfgPath)) {
+        var topology22 = JSON.parse(fs.readFileSync(swarmCfgPath, 'utf-8')).topology || 'mesh';
+        var mode22 = topology22 === 'hierarchical' ? 'route' : 'coordinate';
+        console.log('[ROUTING_MODE] topology=' + topology22 + ' → mode=' + mode22);
+      }
+    } catch (e) { /* non-fatal */ }
+  }
+};