monomind 2.7.11 → 2.7.13

package/packages/@monomind/cli/.claude/helpers/graphify-freshen.cjs

@@ -1,148 +0,0 @@
-'use strict';
-// Runs at SessionStart — rebuilds the knowledge graph using @monoes/monograph in the background.
-// Fire-and-forget: spawns detached child, logs start, exits immediately without blocking session.
-const path = require('path');
-const fs = require('fs');
-const { spawn } = require('child_process');
-const { pathToFileURL } = require('url');
-const { claimLock } = require('./utils/fs-helpers.cjs');
-
-const projectDir = process.env.CLAUDE_PROJECT_DIR || process.cwd();
-const graphDir = path.join(projectDir, '.monomind', 'graph');
-fs.mkdirSync(graphDir, { recursive: true });
-
-const logPath = path.join(graphDir, 'build.log');
-let logFd;
-try { logFd = fs.openSync(logPath, 'a'); } catch { logFd = 'ignore'; }
-
-// Resolve the monograph entry point — searches several common layouts
-function resolveMonographEntry(dir) {
-  // pnpm virtual store — the reliable pre-built copy not affected by workspace symlinks
-  const pnpmStore = (() => {
-    try {
-      const storeBase = path.join(dir, 'node_modules', '.pnpm');
-      if (!fs.existsSync(storeBase)) return null;
-      const entries = fs.readdirSync(storeBase).filter(e => e.startsWith('@monoes+monograph@'));
-      for (const e of entries.sort().reverse()) { // newest version first
-        const p = path.join(storeBase, e, 'node_modules', '@monoes', 'monograph', 'dist', 'src', 'index.js');
-        if (fs.existsSync(p)) return p;
-      }
-    } catch {}
-    return null;
-  })();
-
-  // Global npm installation (covers `npm install -g @monomind/cli` and homebrew installs)
-  const globalNpmMonograph = (() => {
-    try {
-      const { execSync } = require('child_process');
-      const globalRoot = execSync('npm root -g', { encoding: 'utf-8', timeout: 5000 }).trim();
-      const p = path.join(globalRoot, '@monoes', 'monograph', 'dist', 'src', 'index.js');
-      return p;
-    } catch { return null; }
-  })();
-
-  const candidates = [
-    // Monorepo workspace build FIRST — it carries unpublished fixes; the pnpm store
-    // holds registry tarballs that can lag behind the workspace source.
-    path.join(dir, 'packages', '@monomind', 'monograph', 'dist', 'src', 'index.js'),
-    // Installed as a flat dependency (follows workspace symlinks when linked)
-    path.join(dir, 'node_modules', '@monoes', 'monograph', 'dist', 'src', 'index.js'),
-    path.join(dir, 'node_modules', '@monomind', 'monograph', 'dist', 'src', 'index.js'),
-    // Monorepo: monomind root is the monograph package
-    path.join(dir, 'dist', 'src', 'index.js'),
-    // pnpm store registry copy
-    pnpmStore,
-    // Global npm / homebrew install of @monomind/cli (most common for npx/global users)
-    globalNpmMonograph,
-  ].filter(Boolean);
-  for (const c of candidates) {
-    if (fs.existsSync(c)) return c;
-  }
-  return null;
-}
-
-const entryPoint = resolveMonographEntry(projectDir);
-if (!entryPoint) {
-  console.error('[graph] @monoes/monograph not found — skipping build');
-  process.exit(0);
-}
-
-// Skip if index is already fresh — don't waste CPU on every session start
-const dbPath = path.join(projectDir, '.monomind', 'monograph.db');
-if (fs.existsSync(dbPath)) {
-  try {
-    const Database = require(require.resolve('better-sqlite3', { paths: [path.dirname(entryPoint)] }));
-    const db = new Database(dbPath, { readonly: true, timeout: 5000 });
-    try {
-      const row = db.prepare("SELECT value FROM index_meta WHERE key='last_commit_hash'").get();
-      if (row && row.value && /^[0-9a-f]{7,40}$/i.test(row.value)) {
-        const { execFileSync } = require('child_process');
-        const out = execFileSync('git', ['rev-list', '--count', row.value + '..HEAD'], {
-          cwd: projectDir, encoding: 'utf-8', timeout: 2000, stdio: ['pipe', 'pipe', 'pipe']
-        }).trim();
-        const behind = parseInt(out, 10);
-        if (behind === 0) {
-          console.log('[graph] index is fresh — skipping rebuild');
-          db.close();
-          process.exit(0);
-        }
-      }
-    } finally { try { db.close(); } catch {} }
-  } catch { /* can't check — proceed with build */ }
-}
-
-// Skip if another build is already in progress (avoids SQLite BUSY on concurrent init + session-start)
-// P2-24: claim atomically (wx-create) instead of statSync-then-writeFileSync
-// — two concurrent freshen triggers can both cross the same write-count
-// threshold from parallel hook events, and a plain read-check-write lets
-// both pass the check and both spawn a detached rebuild child. claimLock
-// uses the same TOCTOU-safe stale-lock-break (atomic rename-to-claim) as
-// control-start.cjs's spawn lock (see P2-25) — a lock older than 5 minutes
-// is treated as abandoned and safely reclaimed.
-const lockPath = path.join(graphDir, 'build.lock');
-if (!claimLock(lockPath, 5 * 60 * 1000)) {
-  console.log('[graph] build already in progress — skipping');
-  process.exit(0);
-}
-
-// 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, statSync } from 'fs';
-import { execFileSync } 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;
-    // execFileSync with array argv — no shell involved, so a project
-    // directory name containing '"' or '$(...)' cannot break out and
-    // execute arbitrary commands (P3-8).
-    const liveMB = parseInt(
-      execFileSync('sqlite3', [dbPath, 'SELECT SUM(pgsize)/1024/1024 FROM dbstat;'],
-        { encoding: 'utf-8', timeout: 30000 }).trim(), 10);
-    if (fileMB > 100 && liveMB / fileMB < 0.5) {
-      execFileSync('sqlite3', [dbPath, 'VACUUM;'], { timeout: 120000 });
-    }
-  } catch (_) {}
-} finally {
-  try { unlinkSync(${JSON.stringify(lockPath)}); } catch {}
-  try { unlinkSync(${JSON.stringify(path.join(graphDir, 'build.pid'))}); } catch {}
-}`;
-const child = spawn(process.execPath, ['--input-type=module', '--eval', script], {
-  detached: true,
-  stdio: ['ignore', logFd, logFd],
-  cwd: projectDir,
-});
-child.unref();
-
-// Track PID so control-stop.cjs can kill it on session exit
-try {
-  fs.writeFileSync(path.join(graphDir, 'build.pid'), String(child.pid), 'utf-8');
-} catch { /* best-effort */ }
-
-console.log('[graph] background build started for ' + projectDir);

package/packages/@monomind/cli/.claude/helpers/handlers/adr-draft-handler.cjs

@@ -1,78 +0,0 @@
-'use strict';
-// Extracted from hook-handler.cjs — handles 'adr-draft' command.
-// Drafts an ADR from accumulated decision markers in .monomind/decisions.jsonl.
-// Receives hCtx from dispatcher. See route-handler.cjs for hCtx field docs.
-
-const path = require('path');
-const fs = require('fs');
-
-module.exports = {
-  handle: function(hCtx) {
-    var CWD = hCtx.CWD;
-
-    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 MAX_JSONL = 512 * 1024; // 512 KiB
-    try { if (fs.statSync(jsonl).size > MAX_JSONL) { console.error('[ADR] decisions.jsonl exceeds 512 KiB — skipping to prevent OOM'); return; } } catch (_) { 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 MAX_RECORDS = 200;
-    var recent = lines
-      .map(function(l) { try { return JSON.parse(l); } catch (_) { return null; } })
-      .filter(function(d) { return d && d.ts >= cutoff; })
-      .slice(0, MAX_RECORDS);
-    if (recent.length === 0) {
-      console.log('[ADR] No decisions in the last 7 days. Older entries: ' + lines.length + '.');
-      return;
-    }
-
-    var adrsDir = path.resolve(CWD, 'docs', 'adrs');
-    if (!adrsDir.startsWith(path.resolve(CWD) + path.sep) && adrsDir !== path.resolve(CWD)) {
-      console.error('[ADR] adrsDir resolved outside CWD — aborting'); return;
-    }
-    try { fs.mkdirSync(adrsDir, { recursive: true }); } catch (_) {}
-    // Use lstatSync to avoid following symlinks when listing existing ADRs
-    var existing = [];
-    try {
-      existing = fs.readdirSync(adrsDir).filter(function(f) {
-        if (!/^ADR-\d{4}/.test(f)) return false;
-        try { var st = fs.lstatSync(path.join(adrsDir, f)); return st.isFile(); } catch (_) { return false; }
-      });
-    } catch (_) {}
-    var nextNum = existing.length + 1;
-    var num = String(nextNum).padStart(4, '0');
-    var stamp = new Date().toISOString().slice(0, 10);
-    var fname = 'ADR-' + num + '-' + stamp + '-session-decisions.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';
-      var excerpts = Array.isArray(d.excerpts) ? d.excerpts.slice(0, 20) : [];
-      for (var j = 0; j < excerpts.length; j++) {
-        body += '> ' + String(excerpts[j]).slice(0, 500).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.');
-  },
-};

package/packages/@monomind/cli/.claude/helpers/handlers/agent-start-handler.cjs

@@ -1,132 +0,0 @@
-'use strict';
-// Extracted from hook-handler.cjs — handles 'agent-start' (SubagentStart) hook event.
-// Receives hCtx from dispatcher. See route-handler.cjs for hCtx field docs.
-
-const path = require('path');
-const fs = require('fs');
-const { purgeStaleRegistrations } = require('../utils/agent-registrations.cjs');
-const { cleanEntries, atomicWriteFileSync, withLock } = require('../utils/fs-helpers.cjs');
-
-module.exports = {
-  handle: async function(hCtx) {
-    var hookInput = hCtx.hookInput;
-    var CWD = hCtx.CWD;
-    var _openMonographDb = hCtx._openMonographDb;
-    var getMonographSuggestions = hCtx.getMonographSuggestions;
-
-    // Register this agent so the statusline can count active agents.
-    const regDir = path.join(CWD, '.monomind', 'agents', 'registrations');
-    try {
-      fs.mkdirSync(regDir, { recursive: true });
-      const id = Date.now() + '-' + Math.random().toString(36).slice(2, 6);
-      const regFile = path.join(regDir, 'agent-' + id + '.json');
-      // P3-15: also stamp the agent's type/slug so handlePostTask (task-handler.cjs)
-      // can correlate a completion event back to THIS registration instead of
-      // blindly popping the oldest file — the registration previously carried no
-      // identity beyond a random id, so post-task had nothing to match against.
-      // Same field precedence as the last-dispatch.json write below, computed
-      // early so both writers agree on the agent's identity.
-      const MAX_TYPE_LEN = 128;
-      const agentType = String(hookInput.subagent_type || hookInput.agentType || hookInput.agent_type || hookInput.agentSlug || 'unknown').slice(0, MAX_TYPE_LEN);
-      fs.writeFileSync(regFile, JSON.stringify({
-        agentId: id,
-        agentType: agentType,
-        startedAt: new Date().toISOString(),
-        pid: process.pid,
-      }));
-      // Purge stragglers older than 30 min on every agent-start too — not just
-      // on TeammateIdle/TaskCompleted (task-handler.cjs) — since sessions that
-      // never emit those events would otherwise leak registrations forever.
-      const activeAfterPurge = purgeStaleRegistrations(regDir);
-      // Refresh swarm-activity.json within the 5-min staleness window.
-      const activityDir = path.join(CWD, '.monomind', 'metrics');
-      fs.mkdirSync(activityDir, { recursive: true });
-      const activityPath = path.join(activityDir, 'swarm-activity.json');
-      const MAX_AGENTS = 1000;
-      const active = Math.min(
-        activeAfterPurge != null ? activeAfterPurge : cleanEntries(regDir, f => f.endsWith('.json')).length,
-        MAX_AGENTS
-      );
-      // P2-21: swarm-activity.json is written by both this handler and
-      // task-handler.cjs's handlePostTask, concurrently (Claude Code fires
-      // hook events for parallel tool calls in one message). The old
-      // read-prevLastActive-then-write was a lost-update race — two
-      // processes could both read the same prevLastActive before either
-      // wrote, so whichever wrote last silently erased the other's peak.
-      // Share one lock file with task-handler.cjs so the read-merge-write
-      // cycle is a single critical section across both writers.
-      withLock(activityPath + '.lock', function() {
-        // Preserve lastActive (peak) so statusline shows non-zero after completion.
-        let prevLastActive = 0;
-        try {
-          const MAX_ACTIVITY = 64 * 1024; // 64 KiB
-          var actStat = fs.statSync(activityPath);
-          if (actStat.size <= MAX_ACTIVITY) {
-            prevLastActive = (JSON.parse(fs.readFileSync(activityPath, 'utf-8'))?.swarm?.lastActive) || 0;
-          }
-        } catch { /* ignore */ }
-        atomicWriteFileSync(activityPath, JSON.stringify({
-          timestamp: new Date().toISOString(),
-          swarm: {
-            active: active > 0,
-            agent_count: active,
-            coordination_active: active > 0,
-            lastActive: Math.max(active, prevLastActive),
-          },
-        }));
-      }, 5000);
-
-      // Write last-dispatch.json so the route handler can suppress redundant
-      // suggestions on the next turn when the same agent type is recommended.
-      const MAX_DESC_LEN = 500;
-      const agentDesc = String(hookInput.description || hookInput.prompt_description || '').slice(0, MAX_DESC_LEN);
-      fs.writeFileSync(
-        path.join(CWD, '.monomind', 'last-dispatch.json'),
-        JSON.stringify({
-          agentType: agentType,
-          description: agentDesc.substring(0, 120),
-          dispatchedAt: new Date().toISOString(),
-        }),
-        'utf-8'
-      );
-    } catch (e) { /* non-fatal — never block a subagent from starting */ }
-
-    // monolean: compact single-line graph context instead of multi-line map.
-    // Subagents get task-relevant files only — god nodes are noise for a focused task.
-    try {
-      var subAgentDesc = hookInput.description || hookInput.prompt_description || '';
-      if (subAgentDesc && subAgentDesc.length > 8) {
-        var subHints = getMonographSuggestions(subAgentDesc, 3);
-        if (subHints.length > 0) {
-          var parts = subHints.map(function(s) {
-            return s.name + ' [' + s.label + '] — ' + (s.file || '');
-          });
-          console.log('[MONOGRAPH] Top files: ' + parts.join(' · '));
-        }
-      }
-    } catch (e) { /* non-fatal */ }
-
-    // Bridge to @monoes/hooks registry — fires AgentSpawn hooks (was previously never
-    // wired: HookEvent.AgentSpawn existed but no CJS handler ever fired it).
-    try {
-      var _hooksModule = hCtx._ensureHooksModule ? await hCtx._ensureHooksModule() : null;
-      if (_hooksModule && _hooksModule.executeHooks && _hooksModule.HookEvent) {
-        var agentTypeBridge = String(hookInput.subagent_type || hookInput.agentType || hookInput.agent_type || hookInput.agentSlug || 'unknown');
-        var agentDescBridge = String(hookInput.description || hookInput.prompt_description || '');
-        // Must be awaited (bounded by runWithTimeout, 1500ms) — hook-handler.cjs's
-        // main().finally(() => process.exit(...)) reaps any unawaited fire-and-forget
-        // promise before it does real I/O. See session-restore-handler.cjs's
-        // SessionStart bridge for the reference pattern this mirrors.
-        await hCtx.runWithTimeout(function() {
-          return _hooksModule.executeHooks(_hooksModule.HookEvent.AgentSpawn, {
-            agent: {
-              id: hookInput.agentId || hookInput.agent_id || (agentTypeBridge + '-' + Date.now()),
-              type: agentTypeBridge,
-              description: agentDescBridge.slice(0, 500),
-            },
-          }, { continueOnError: true, timeout: 1500 });
-        }, '@monoes/hooks.AgentSpawn');
-      }
-    } catch (e) { /* non-fatal */ }
-  },
-};

package/packages/@monomind/cli/.claude/helpers/handlers/budget-status-handler.cjs

@@ -1,14 +0,0 @@
-'use strict';
-// Extracted from hook-handler.cjs — handles 'budget-status' command.
-
-module.exports = {
-  handle: function(hCtx) {
-    var _getBudgetStatus = hCtx._getBudgetStatus;
-    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.');
-  },
-};