monomind 2.5.3 → 2.5.5

package/packages/@monomind/cli/dist/src/ui/server.mjs

@@ -5,6 +5,7 @@ import os from 'os';
 import crypto from 'crypto';
 import { fileURLToPath } from 'url';
 import { createRequire } from 'module';
+import { spawn } from 'child_process';
 import { collectAll, getWatchPaths, collectProject, collectSessions, collectSwarm, collectSwarmHistory, appendSwarmHistory, collectSwarmEvents, getSwarmDataSize, cleanSwarmData, collectAgents, collectTokens, collectHooks, collectKnowledge, collectMetrics, collectMemory, collectMemoryFiles, collectSystem } from './collector.mjs';
 import { addSseClient, removeSseClient, broadcast, getSseClientCount, closeSseClients, addMmClient, removeMmClient, broadcastMm, getMmClientCount } from './sse-manager.mjs';
 
@@ -226,6 +227,23 @@ let _runDbInsertStmt = null; // prepared INSERT statement
 
 const _require = createRequire(import.meta.url);
 
+/**
+ * Guard against a stale PID file outliving its process and the OS recycling
+ * that PID for an unrelated process — verify the live process actually looks
+ * like ours (node/npx running something under this project or monomind)
+ * before signaling it or reporting it as "running".
+ */
+function looksLikeOurProcess(pid, dir) {
+  try {
+    const { execSync } = _require('child_process');
+    const cmd = execSync(`ps -p ${pid} -o command=`, { timeout: 2000, encoding: 'utf-8' }).trim();
+    const looksLikeNode = cmd.includes('node') || cmd.includes('npx') || cmd.includes('npm exec');
+    return looksLikeNode && (cmd.includes('monomind') || cmd.includes('monograph') || cmd.includes(dir));
+  } catch {
+    return false;
+  }
+}
+
 async function _initRunDb(monoHome) {
   try {
     const initSqlJs = _require('sql.js');
@@ -410,6 +428,7 @@ function appendToFile(filePath, line) {
 // reach /main/.git, then up one more to /main/ for the monomind data root.
 // Falls back to the working directory if git isn't available.
 const _gitMonomindCache = new Map();
+const _MAX_GIT_CACHE = 100;
 function _getGitMonomindDir(workDir) {
   if (!workDir) return null;
   if (_gitMonomindCache.has(workDir)) return _gitMonomindCache.get(workDir);
@@ -433,6 +452,10 @@ function _getGitMonomindDir(workDir) {
     }
   } catch {}
   if (!result) result = path.join(workDir, '.monomind'); // fallback
+  if (_gitMonomindCache.size >= _MAX_GIT_CACHE) {
+    const oldest = _gitMonomindCache.keys().next().value;
+    _gitMonomindCache.delete(oldest);
+  }
   _gitMonomindCache.set(workDir, result);
   return result;
 }
@@ -629,10 +652,15 @@ function bindServer(server, port) {
  * Falls back to cwd in session files, then to direct slug replacement.
  */
 const _slugPathCache = new Map();
+const _MAX_SLUG_CACHE = 200;
 
 function resolveSlugToPath(slug, projDir) {
   if (_slugPathCache.has(slug)) return _slugPathCache.get(slug);
   const resolved = _resolveSlugToPathUncached(slug, projDir);
+  if (_slugPathCache.size >= _MAX_SLUG_CACHE) {
+    const oldest = _slugPathCache.keys().next().value;
+    _slugPathCache.delete(oldest);
+  }
   _slugPathCache.set(slug, resolved);
   return resolved;
 }
@@ -3186,13 +3214,17 @@ new Sigma(g,document.getElementById('g'),{renderEdgeLabels:false,labelColor:{col
         const qs = new URL(req.url, 'http://localhost').searchParams;
         const dir = qs.get('dir') || projectDir || process.cwd();
         const d = path.resolve(dir || process.cwd());
-        const pidPath = path.join(d, '.monomind', 'monograph.watch.pid');
         let running = false, pid = null;
-        try {
-          pid = parseInt(fs.readFileSync(pidPath, 'utf-8').trim(), 10);
-          process.kill(pid, 0);
-          running = true;
-        } catch {}
+        for (const pidName of ['monograph.watch.pid', 'monograph-watch.pid']) {
+          try {
+            const pp = path.join(d, '.monomind', pidName);
+            pid = parseInt(fs.readFileSync(pp, 'utf-8').trim(), 10);
+            process.kill(pid, 0);
+            if (!looksLikeOurProcess(pid, d)) continue;
+            running = true;
+            break;
+          } catch {}
+        }
         res.writeHead(200, { 'Content-Type': 'application/json', ...(corsOrigin ? { 'Access-Control-Allow-Origin': corsOrigin } : {}) });
         res.end(JSON.stringify({ running, pid }));
       } catch (err) {
@@ -3210,13 +3242,17 @@ new Sigma(g,document.getElementById('g'),{renderEdgeLabels:false,labelColor:{col
         const d = path.resolve(dir || process.cwd());
         const pidPath = path.join(d, '.monomind', 'monograph.watch.pid');
         let wasRunning = false;
-        try {
-          const pid = parseInt(fs.readFileSync(pidPath, 'utf-8').trim(), 10);
-          process.kill(pid, 0);
-          wasRunning = true;
-          process.kill(pid, 'SIGTERM');
-          try { fs.unlinkSync(pidPath); } catch {}
-        } catch {}
+        for (const pidName of ['monograph.watch.pid', 'monograph-watch.pid']) {
+          try {
+            const pp = path.join(d, '.monomind', pidName);
+            const pid = parseInt(fs.readFileSync(pp, 'utf-8').trim(), 10);
+            process.kill(pid, 0);
+            if (!looksLikeOurProcess(pid, d)) continue;
+            wasRunning = true;
+            process.kill(pid, 'SIGTERM');
+            try { fs.unlinkSync(pp); } catch {}
+          } catch {}
+        }
 
         if (wasRunning) {
           res.writeHead(200, { 'Content-Type': 'application/json', ...(corsOrigin ? { 'Access-Control-Allow-Origin': corsOrigin } : {}) });
@@ -3237,6 +3273,28 @@ new Sigma(g,document.getElementById('g'),{renderEdgeLabels:false,labelColor:{col
       return;
     }
 
+    // -------------------------------------------------- POST /api/shutdown
+    if (req.method === 'POST' && url === '/api/shutdown') {
+      res.writeHead(200, { 'Content-Type': 'application/json', ...(corsOrigin ? { 'Access-Control-Allow-Origin': corsOrigin } : {}) });
+      res.end(JSON.stringify({ ok: true }));
+      // Kill monograph watcher if running
+      const d = projectDir || process.cwd();
+      for (const pidName of ['monograph.watch.pid', 'monograph-watch.pid']) {
+        try {
+          const wp = path.join(d, '.monomind', pidName);
+          if (fs.statSync(wp).size > 32) continue;
+          const wpid = parseInt(fs.readFileSync(wp, 'utf-8').trim(), 10);
+          if (!Number.isInteger(wpid) || wpid <= 0) { try { fs.unlinkSync(wp); } catch {} continue; }
+          if (looksLikeOurProcess(wpid, d)) process.kill(wpid, 'SIGTERM');
+          try { fs.unlinkSync(wp); } catch {}
+        } catch {}
+      }
+      // Remove control.json so startup knows we're gone
+      try { fs.unlinkSync(path.join(d, '.monomind', 'control.json')); } catch {}
+      setTimeout(shutdown, 100);
+      return;
+    }
+
     // -------------------------------------------------- POST /api/mcp/call
     if (req.method === 'POST' && url === '/api/mcp/call') {
       let body = '';
@@ -4559,6 +4617,43 @@ new Sigma(g,document.getElementById('g'),{renderEdgeLabels:false,labelColor:{col
       return;
     }
 
+    // POST /api/org/:name/agent/:roleId/avatar — set (or clear) a custom avatar for one
+    // role, stored inline as a data URL on the role itself so it travels with the org
+    // config export/import. Body: { avatarDataUrl } — null/omitted avatarDataUrl clears
+    // the custom avatar and reverts to the built-in library picture. `dir` (like every
+    // other dir-accepting route in this file, POST included — see /goals above) comes
+    // from the query string, not the body.
+    if (req.method === 'POST' && /^\/api\/org\/[a-z0-9][a-z0-9_-]{0,63}\/agent\/[a-z0-9][a-z0-9_-]{0,63}\/avatar$/i.test(url)) {
+      let body = '';
+      for await (const chunk of req) { body += chunk; if (body.length > 8388608) { req.destroy(); break; } }
+      try {
+        const parts = url.split('/');
+        const orgName = decodeURIComponent(parts[3]);
+        const roleId = decodeURIComponent(parts[5]);
+        if (orgName.length > 64 || !/^[a-z0-9][a-z0-9_-]*$/i.test(orgName)) { res.writeHead(400); res.end('{"ok":false,"error":"Invalid org name"}'); return; }
+        if (roleId.length > 64 || !/^[a-z0-9][a-z0-9_-]*$/i.test(roleId)) { res.writeHead(400); res.end('{"ok":false,"error":"Invalid role id"}'); return; }
+        const parsed = JSON.parse(body);
+        const avatarDataUrl = parsed.avatarDataUrl;
+        if (avatarDataUrl != null && (typeof avatarDataUrl !== 'string' || avatarDataUrl.length > 2_000_000 || !/^data:image\/(png|jpe?g|webp|gif);base64,[A-Za-z0-9+/=]+$/.test(avatarDataUrl))) {
+          res.writeHead(400); res.end('{"ok":false,"error":"Invalid or oversized avatarDataUrl"}'); return;
+        }
+        const _avatarQs = new URL(req.url, 'http://localhost').searchParams;
+        const d = path.resolve(_avatarQs.get('dir') || projectDir || process.cwd());
+        const orgFile = path.join(d, '.monomind', 'orgs', `${orgName}.json`);
+        if (!fs.existsSync(orgFile)) { res.writeHead(404); res.end('{"ok":false,"error":"org not found"}'); return; }
+        const config = JSON.parse(fs.readFileSync(orgFile, 'utf8'));
+        const role = (config.roles || []).find(r => r.id === roleId);
+        if (!role) { res.writeHead(404); res.end('{"ok":false,"error":"role not found"}'); return; }
+        if (avatarDataUrl) role.avatar = avatarDataUrl; else delete role.avatar;
+        const tmp = `${orgFile}.tmp`;
+        fs.writeFileSync(tmp, JSON.stringify(config, null, 2), 'utf-8');
+        fs.renameSync(tmp, orgFile);
+        res.writeHead(200, { 'Content-Type': 'application/json', ...(corsOrigin ? { 'Access-Control-Allow-Origin': corsOrigin } : {}) });
+        res.end(JSON.stringify({ ok: true }));
+      } catch (e) { res.writeHead(500); res.end(JSON.stringify({ ok: false, error: String(e.message || e) })); }
+      return;
+    }
+
     // GET /api/org/:name/search?q=<query> — fuzzy search across org data
     if (req.method === 'GET' && /^\/api\/org\/[a-z0-9][a-z0-9_-]{0,63}\/search(\?.*)?$/i.test(url)) {
       try {
@@ -4967,9 +5062,11 @@ new Sigma(g,document.getElementById('g'),{renderEdgeLabels:false,labelColor:{col
       return;
     }
 
-    // GET /api/questions?dir=<projectDir> — list unanswered ask_human questions for
-    // every org in one project. Mirrors the existing -approvals.json sidecar convention,
-    // but reads this feature's .monomind/orgs/<org>/questions.json files (one per org dir).
+    // GET /api/questions?dir=<projectDir> — list ask_human questions (pending and
+    // answered) for every org in one project. Mirrors the existing -approvals.json
+    // sidecar convention, but reads this feature's .monomind/orgs/<org>/questions.json
+    // files (one per org dir). Each entry's `answer`/`answeredAt` fields (present once
+    // answered, absent while pending) let the dashboard split them into tabs.
     if (req.method === 'GET' && url === '/api/questions') {
       try {
         const _qDir = new URL(req.url, 'http://localhost').searchParams.get('dir') || projectDir || process.cwd();
@@ -4982,7 +5079,7 @@ new Sigma(g,document.getElementById('g'),{renderEdgeLabels:false,labelColor:{col
             let data = { questions: [] };
             try { data = JSON.parse(fs.readFileSync(qFile, 'utf8')); } catch (_) {}
             for (const q of (data.questions || [])) {
-              if (q.answer === null || q.answer === undefined) out.push({ org: orgName, ...q });
+              out.push({ org: orgName, ...q });
             }
           }
         }
@@ -5059,8 +5156,19 @@ new Sigma(g,document.getElementById('g'),{renderEdgeLabels:false,labelColor:{col
           const queuedEvent = { type: 'org:question-answered', org, role, questionId, ts: Date.now(), queued: true };
           appendToFile(path.join(projDir, 'data', 'mastermind-events.jsonl'), JSON.stringify(queuedEvent) + '\n').catch(() => {});
           broadcastMm(queuedEvent);
+          // Auto-wake: a queued answer is worthless if nothing ever restarts the org to
+          // drain it (unlike the direct-daemon path, this control server holds no OrgDaemon
+          // instance to call autoWake() on). `org run` itself no-ops if the org's runtime.json
+          // already shows a live pid, so this is safe to fire even if another process is
+          // racing to start it.
+          try {
+            const child = spawn('npx', ['-y', 'monomind@latest', 'org', 'run', org], {
+              cwd: projDir, detached: true, stdio: 'ignore',
+            });
+            child.unref();
+          } catch (_) { /* best-effort — the answer is still queued on disk either way */ }
           res.writeHead(200, { 'Content-Type': 'application/json' });
-          res.end(JSON.stringify({ ok: true, queued: true }));
+          res.end(JSON.stringify({ ok: true, queued: true, waking: true }));
           return;
         }
         const fwd = await fetch(`${hostUrl}/api/answer-question`, {
@@ -5496,8 +5604,10 @@ new Sigma(g,document.getElementById('g'),{renderEdgeLabels:false,labelColor:{col
         const _delOrgQs = new URL(req.url, 'http://localhost').searchParams;
         const orgsDir = path.join(path.resolve(_delOrgQs.get('dir') || projectDir || process.cwd()), '.monomind', 'orgs');
         const configFile = path.join(orgsDir, `${orgName}.json`);
-        if (!fs.existsSync(configFile)) { res.writeHead(404); res.end('{"error":"org not found"}'); return; }
+        const v1ConfigFile = path.join(orgsDir, `${orgName}.v1.json`);
+        if (!fs.existsSync(configFile) && !fs.existsSync(v1ConfigFile)) { res.writeHead(404); res.end('{"error":"org not found"}'); return; }
         // Remove all org-associated files (config + state + data)
+        try { if (fs.existsSync(v1ConfigFile)) fs.unlinkSync(v1ConfigFile); } catch(_) {}
         const suffixes = ['', '-state', '-goals', '-routines', '-approvals', '-activity', '-issues', '-members', '-projects', '-workspaces', '-worktrees', '-environments', '-plugins', '-adapters', '-budgets', '-threads', '-secrets', '-join-requests', '-bootstrap', '-project-workspaces', '-approval-comments', '-skills'];
         for (const suf of suffixes) {
           const f = path.join(orgsDir, `${orgName}${suf}.json`);
@@ -6481,7 +6591,9 @@ new Sigma(g,document.getElementById('g'),{renderEdgeLabels:false,labelColor:{col
         try { _chPayload = JSON.parse(_chBody); } catch(_) {}
         const _chText = String(_chPayload.text || '').trim().slice(0, 4096);
         if (!_chText) { res.writeHead(400, { 'Content-Type': 'application/json' }); res.end(JSON.stringify({ error: 'text is required' })); return; }
-        const _chRoot = projectDir || process.cwd();
+        const _chQs = new URL(req.url, 'http://localhost').searchParams;
+        const _chServerRoot = path.resolve(_chQs.get('dir') || projectDir || process.cwd());
+        const _chRoot = _resolveOrgProjectDir(_chOrgName, _chServerRoot) || _chServerRoot;
         const _chMonoDir = _getGitMonomindDir(_chRoot) || path.join(_chRoot, '.monomind');
         const _chRunId = activeOrgRuns.get(_chOrgName) || _getActiveRunId(_chOrgName, _chRoot);
         const _chEvent = { type: 'user:message', org: _chOrgName, runId: _chRunId || null, text: _chText, ts: Date.now() };
@@ -6490,7 +6602,8 @@ new Sigma(g,document.getElementById('g'),{renderEdgeLabels:false,labelColor:{col
           const _chRunFile = path.join(_chMonoDir, 'orgs', _chOrgName, 'runs', `${_chRunId}.jsonl`);
           if (fs.existsSync(_chRunFile)) await appendToFile(_chRunFile, JSON.stringify(_chEvent) + '\n');
         }
-        // Write to mailbox file so boss agent can pick up on next cycle
+        // Write to mailbox file so boss agent can pick up on next cycle (durable
+        // record + offline fallback — the live-delivery attempt below is best-effort)
         const _chMailbox = path.join(_chRoot, '.monomind', 'orgs', `${_chOrgName}-threads.json`);
         try {
           let _chThreads = { messages: [] };
@@ -6506,8 +6619,36 @@ new Sigma(g,document.getElementById('g'),{renderEdgeLabels:false,labelColor:{col
           const _chLine = `data: ${JSON.stringify(_chEvent)}\n\n`;
           for (const _cl of _chFwdClients) { try { _cl.write(_chLine); } catch(_) { _chFwdClients.delete(_cl); } }
         }
+        // Forward to the org's live process (if any) so the message actually lands in a
+        // running role's mailbox — looked up via the same file-based broker registry
+        // orgrt's cross-process delivery already uses (mirrors POST /api/questions/answer).
+        let _chDelivered = false;
+        try {
+          const _chBrokerEntryPath = path.join(os.homedir(), '.monomind', 'orgrt-broker', `${_chOrgName}.json`);
+          const _chBrokerEntry = JSON.parse(fs.readFileSync(_chBrokerEntryPath, 'utf8'));
+          if (Date.now() - _chBrokerEntry.updatedAt < 90000 && _chBrokerEntry.url) {
+            let _chTargetRole = _chPayload.role;
+            if (!_chTargetRole) {
+              try {
+                const _chCfg = JSON.parse(fs.readFileSync(path.join(_chRoot, '.monomind', 'orgs', `${_chOrgName}.json`), 'utf8'));
+                const _chRoles = Array.isArray(_chCfg.roles) ? _chCfg.roles : [];
+                const _chBoss = _chRoles.find(r => r.type === 'boss' || r.reports_to === null) || _chRoles[0];
+                _chTargetRole = _chBoss?.id;
+              } catch(_) {}
+            }
+            if (_chTargetRole) {
+              const _chFwd = await fetch(`${_chBrokerEntry.url}/api/human-message`, {
+                method: 'POST', headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ org: _chOrgName, role: _chTargetRole, text: _chText }),
+                signal: AbortSignal.timeout(5000),
+              });
+              const _chFwdData = await _chFwd.json().catch(() => ({}));
+              _chDelivered = !!(_chFwd.ok && _chFwdData.ok);
+            }
+          }
+        } catch(_) {}
         res.writeHead(200, { 'Content-Type': 'application/json', ...(corsOrigin ? { 'Access-Control-Allow-Origin': corsOrigin } : {}) });
-        res.end(JSON.stringify({ ok: true }));
+        res.end(JSON.stringify({ ok: true, delivered: _chDelivered }));
       } catch (e) { res.writeHead(500, { 'Content-Type': 'application/json' }); res.end(JSON.stringify({ error: e.message })); }
       return;
     }
@@ -6942,12 +7083,14 @@ new Sigma(g,document.getElementById('g'),{renderEdgeLabels:false,labelColor:{col
         currentPort = null;
         currentUrl = null;
         activeServer = null;
+        process.exit(0);
       });
     });
   }
 
   process.once('SIGTERM', shutdown);
   process.once('SIGINT', shutdown);
+  process.once('SIGHUP', shutdown);
 
   // ---------------------------------------------------------- Auto-open
   if (openBrowser) {

package/packages/@monomind/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monoes/monomindcli",
-  "version": "2.5.3",
+  "version": "2.5.5",
   "type": "module",
   "description": "CLI engine for Monomind \u2014 an open-source MCP server that extends Claude Code with a codebase knowledge graph (tree-sitter + SQLite), persistent memory, multi-agent task coordination, and session hooks. MIT licensed, fully local.",
   "main": "dist/src/index.js",