@monoes/monomindcli 1.10.14 → 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/hook-handler.cjs

@@ -215,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; }
@@ -829,7 +869,59 @@ 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('');
@@ -1005,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) {}
@@ -2297,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.14",
+  "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",