@yemi33/minions 0.1.54 → 0.1.56

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.1.56 (2026-03-30)
+
+### Other
+- bin/minions.js
+
+## 0.1.55 (2026-03-30)
+
+### Engine
+- engine/cli.js
+
+### Dashboard
+- dashboard.js
+- dashboard/js/refresh.js
+
 ## 0.1.54 (2026-03-30)
 
 ### Engine

package/bin/minions.js

@@ -472,6 +472,7 @@ if (!cmd || cmd === 'help' || cmd === '--help' || cmd === '-h') {
     minions spawn <agent> <prompt>   Manually spawn an agent
     minions plan <file|text> [proj]  Run a plan
     minions cleanup                  Clean temp files, worktrees, zombies
+    minions reset --confirm          Factory reset (delete all state, keep config)
 
   Dashboard:
     minions dash                     Start web dashboard (default :7331)
@@ -500,6 +501,68 @@ if (!cmd || cmd === 'help' || cmd === '--help' || cmd === '-h') {
   dashProc.unref();
   console.log(`  Dashboard started (PID: ${dashProc.pid})`);
   console.log('  Dashboard: http://localhost:7331\n');
+} else if (cmd === 'reset') {
+  ensureInstalled();
+  if (!rest.includes('--confirm')) {
+    console.log(`
+  This will DELETE all runtime state:
+    - Work items, dispatch queue, PRDs, plans
+    - Agent history, sessions, output logs
+    - Notes, knowledge base, pinned notes
+    - Metrics, cooldowns, schedules
+
+  Config.json and agent charters are PRESERVED.
+
+  Run: minions reset --confirm
+`);
+    process.exit(0);
+  }
+  // Stop engine + dashboard
+  try { execSync(`node "${path.join(MINIONS_HOME, 'engine.js')}" stop`, { stdio: 'ignore', cwd: MINIONS_HOME }); } catch {}
+  const glob = (dir, pattern) => { try { return fs.readdirSync(dir).filter(f => pattern.test(f)).map(f => path.join(dir, f)); } catch { return []; } };
+  const rm = (f) => { try { fs.unlinkSync(f); } catch {} };
+  const rmDir = (d) => { try { fs.rmSync(d, { recursive: true, force: true }); } catch {} };
+  const engineDir = path.join(MINIONS_HOME, 'engine');
+  // Engine state
+  for (const f of ['dispatch.json', 'control.json', 'log.json', 'metrics.json', 'cooldowns.json', 'schedule-runs.json', 'kb-checkpoint.json', 'cc-session.json', 'doc-sessions.json']) rm(path.join(engineDir, f));
+  glob(engineDir, /^pid-.*\.pid$/).forEach(rm);
+  rmDir(path.join(engineDir, 'tmp'));
+  // Work items + PRs
+  rm(path.join(MINIONS_HOME, 'work-items.json'));
+  rm(path.join(MINIONS_HOME, 'work-items-archive.json'));
+  rm(path.join(MINIONS_HOME, 'pull-requests.json'));
+  // Plans + PRDs
+  glob(path.join(MINIONS_HOME, 'plans'), /\.md$/).forEach(rm);
+  glob(path.join(MINIONS_HOME, 'prd'), /\.json$/).forEach(rm);
+  rmDir(path.join(MINIONS_HOME, 'prd', 'archive'));
+  rmDir(path.join(MINIONS_HOME, 'prd', 'guides'));
+  // Notes + KB
+  rm(path.join(MINIONS_HOME, 'notes.md'));
+  rm(path.join(MINIONS_HOME, 'pinned.md'));
+  rmDir(path.join(MINIONS_HOME, 'notes', 'inbox'));
+  rmDir(path.join(MINIONS_HOME, 'notes', 'archive'));
+  fs.mkdirSync(path.join(MINIONS_HOME, 'notes', 'inbox'), { recursive: true });
+  fs.mkdirSync(path.join(MINIONS_HOME, 'notes', 'archive'), { recursive: true });
+  for (const cat of ['architecture', 'conventions', 'project-notes', 'build-reports', 'reviews']) {
+    const catDir = path.join(MINIONS_HOME, 'knowledge', cat);
+    glob(catDir, /\.md$/).forEach(rm);
+  }
+  // Agent state (preserve charters)
+  const agentsDir = path.join(MINIONS_HOME, 'agents');
+  try {
+    for (const agent of fs.readdirSync(agentsDir)) {
+      const agentDir = path.join(agentsDir, agent);
+      if (!fs.statSync(agentDir).isDirectory()) continue;
+      for (const f of ['live-output.log', 'session.json', 'history.md', 'steer.md', 'status.json']) rm(path.join(agentDir, f));
+      glob(agentDir, /^output.*\.log$/).forEach(rm);
+    }
+  } catch {}
+  // Projects state
+  rmDir(path.join(MINIONS_HOME, 'projects'));
+  fs.mkdirSync(path.join(MINIONS_HOME, 'projects'), { recursive: true });
+
+  console.log('\n  Reset complete. Config and charters preserved.');
+  console.log('  Run: minions up\n');
 } else if (cmd === 'doctor') {
   ensureInstalled();
   const { doctor } = require(path.join(MINIONS_HOME, 'engine', 'preflight'));

package/dashboard/js/refresh.js

@@ -1,57 +1,76 @@
 // refresh.js — Main refresh loop and initialization extracted from dashboard.html
 
+function _processStatusUpdate(data) {
+  // Detect fresh install — clear stale browser state if install ID changed
+  if (data.installId) {
+    const prev = localStorage.getItem('minions-install-id');
+    if (prev && prev !== data.installId) {
+      localStorage.clear();
+      console.log('Minions: fresh install detected, cleared browser state');
+    }
+    localStorage.setItem('minions-install-id', data.installId);
+  }
+  document.getElementById('ts').textContent = new Date(data.timestamp).toLocaleTimeString();
+  const engineState = (data.engine && data.engine.state) ? data.engine.state : 'stopped';
+  document.getElementById('setup-banner').style.display = (!data.initialized && engineState !== 'stopped') ? 'block' : 'none';
+  renderAgents(data.agents);
+  renderPrdProgress(data.prdProgress);
+  _cachePrdItems(data.prdProgress);
+  renderInbox(data.inbox);
+  cmdUpdateAgentList(data.agents);
+  cmdUpdateProjectList(data.projects || []);
+  renderNotes(data.notes);
+  renderPrd(data.prd, data.prdProgress);
+  renderPrs(data.pullRequests || []);
+  renderArchiveButtons(data.archivedPrds || []);
+  renderEngineStatus(data.engine);
+  renderDispatch(data.dispatch);
+  window._lastDispatch = data.dispatch;
+  window._lastWorkItems = data.workItems || [];
+  window._lastStatus = data;
+  prunePrdRequeueState(window._lastWorkItems);
+  renderEngineLog(data.engineLog || []);
+  renderProjects(data.projects || []);
+  renderMetrics(data.metrics || {});
+  renderWorkItems(data.workItems || []);
+  renderSkills(data.skills || []);
+  renderMcpServers(data.mcpServers || []);
+  renderSchedules(data.schedules || []);
+  renderPinned(data.pinned || []);
+  // Update sidebar counts
+  const swi = document.getElementById('sidebar-wi');
+  if (swi) swi.textContent = (data.workItems || []).length || '';
+  const spr = document.getElementById('sidebar-pr');
+  if (spr) spr.textContent = (data.pullRequests || []).length || '';
+  // Refresh KB and plans less frequently (every 3rd cycle = ~12s)
+  if (!window._kbRefreshCount) window._kbRefreshCount = 0;
+  if (window._kbRefreshCount++ % 3 === 0) { refreshKnowledgeBase(); refreshPlans(); }
+}
+
 async function refresh() {
   try {
     const data = await fetch('/api/status').then(r => r.json());
-    // Detect fresh install — clear stale browser state if install ID changed
-    if (data.installId) {
-      const prev = localStorage.getItem('minions-install-id');
-      if (prev && prev !== data.installId) {
-        localStorage.clear();
-        console.log('Minions: fresh install detected, cleared browser state');
-      }
-      localStorage.setItem('minions-install-id', data.installId);
-    }
-    document.getElementById('ts').textContent = new Date(data.timestamp).toLocaleTimeString();
-    const engineState = (data.engine && data.engine.state) ? data.engine.state : 'stopped';
-    document.getElementById('setup-banner').style.display = (!data.initialized && engineState !== 'stopped') ? 'block' : 'none';
-    renderAgents(data.agents);
-    renderPrdProgress(data.prdProgress);
-    _cachePrdItems(data.prdProgress);
-    renderInbox(data.inbox);
-    cmdUpdateAgentList(data.agents);
-    cmdUpdateProjectList(data.projects || []);
-    renderNotes(data.notes);
-    renderPrd(data.prd, data.prdProgress);
-    renderPrs(data.pullRequests || []);
-    renderArchiveButtons(data.archivedPrds || []);
-    renderEngineStatus(data.engine);
-    renderDispatch(data.dispatch);
-    window._lastDispatch = data.dispatch;
-    window._lastWorkItems = data.workItems || [];
-    window._lastStatus = data;
-    prunePrdRequeueState(window._lastWorkItems);
-    renderEngineLog(data.engineLog || []);
-    renderProjects(data.projects || []);
-    renderMetrics(data.metrics || {});
-    renderWorkItems(data.workItems || []);
-    renderSkills(data.skills || []);
-    renderMcpServers(data.mcpServers || []);
-    renderSchedules(data.schedules || []);
-    renderPinned(data.pinned || []);
-    // Update sidebar counts
-    const swi = document.getElementById('sidebar-wi');
-    if (swi) swi.textContent = (data.workItems || []).length || '';
-    const spr = document.getElementById('sidebar-pr');
-    if (spr) spr.textContent = (data.pullRequests || []).length || '';
-    // Refresh KB and plans less frequently (every 3rd cycle = ~12s)
-    if (!window._kbRefreshCount) window._kbRefreshCount = 0;
-    if (window._kbRefreshCount++ % 3 === 0) { refreshKnowledgeBase(); refreshPlans(); }
+    _processStatusUpdate(data);
   } catch(e) { console.error('refresh error', e); }
 }
 
 refresh();
-setInterval(refresh, 4000);
+
+// SSE status stream — real-time push, falls back to 4s polling
+let _statusStream = null;
+try {
+  _statusStream = new EventSource('/api/status-stream');
+  _statusStream.onmessage = (e) => {
+    try { _processStatusUpdate(JSON.parse(e.data)); } catch {}
+  };
+  _statusStream.onerror = () => {
+    // Fall back to polling
+    if (_statusStream) { _statusStream.close(); _statusStream = null; }
+    setInterval(refresh, 4000);
+  };
+} catch {
+  setInterval(refresh, 4000);
+}
 
 // Wire sidebar navigation
 document.querySelectorAll('.sidebar-link').forEach(link => {

package/dashboard.js

@@ -180,7 +180,23 @@ function parsePinnedEntries(content) {
 let _statusCache = null;
 let _statusCacheTs = 0;
 const STATUS_CACHE_TTL = 10000; // 10s — reduces expensive aggregation frequency; mutations call invalidateStatusCache()
-function invalidateStatusCache() { _statusCache = null; }
+const _statusStreamClients = new Set();
+let _statusPushTimer = null;
+let _lastStatusHash = '';
+
+function invalidateStatusCache() {
+  _statusCache = null;
+  // Push to SSE clients (debounced 500ms to avoid flooding during batch mutations)
+  if (_statusPushTimer) return;
+  _statusPushTimer = setTimeout(() => {
+    _statusPushTimer = null;
+    if (_statusStreamClients.size === 0) return;
+    const data = JSON.stringify(getStatus());
+    for (const res of _statusStreamClients) {
+      try { res.write('data: ' + data + '\n\n'); } catch { _statusStreamClients.delete(res); }
+    }
+  }, 500);
+}
 
 function getStatus() {
   const now = Date.now();
@@ -221,6 +237,19 @@ function getStatus() {
   return _statusCache;
 }
 
+// Periodic push for engine-driven changes (dispatch.json, control.json) that bypass invalidateStatusCache
+setInterval(() => {
+  if (_statusStreamClients.size === 0) return;
+  const status = getStatus();
+  const hash = require('crypto').createHash('md5').update(JSON.stringify(status)).digest('hex');
+  if (hash === _lastStatusHash) return;
+  _lastStatusHash = hash;
+  const data = JSON.stringify(status);
+  for (const res of _statusStreamClients) {
+    try { res.write('data: ' + data + '\n\n'); } catch { _statusStreamClients.delete(res); }
+  }
+}, 10000);
+
 
 // ── Command Center: session state + helpers ─────────────────────────────────
 
@@ -2816,6 +2845,12 @@ What would you like to discuss or change? When you're happy, say "approve" and I
 
     // Status & health
     { method: 'GET', path: '/api/status', desc: 'Full dashboard status snapshot (agents, PRDs, work items, dispatch, etc.)', handler: handleStatus },
+    { method: 'GET', path: '/api/status-stream', desc: 'SSE stream of real-time status updates', handler: (req, res) => {
+      res.writeHead(200, { 'Content-Type': 'text/event-stream', 'Cache-Control': 'no-cache', 'Connection': 'keep-alive' });
+      res.write('data: ' + JSON.stringify(getStatus()) + '\n\n');
+      _statusStreamClients.add(res);
+      req.on('close', () => _statusStreamClients.delete(res));
+    }},
     { method: 'GET', path: '/api/health', desc: 'Lightweight health check for monitoring', handler: handleHealth },
     { method: 'GET', path: '/api/hot-reload', desc: 'SSE stream for dashboard hot-reload notifications', handler: (req, res) => {
       res.writeHead(200, { 'Content-Type': 'text/event-stream', 'Cache-Control': 'no-cache', 'Connection': 'keep-alive' });

package/engine/cli.js

@@ -320,6 +320,45 @@ const commands = {
     console.log(`Tick interval: ${interval / 1000}s | Max concurrent: ${config.engine?.maxConcurrent || 5}`);
     console.log('Press Ctrl+C to stop');
 
+    // File-change-driven work discovery — trigger tick when work-items or PRDs change
+    const _watchedFiles = new Set();
+    function watchForWorkChanges() {
+      const filesToWatch = [
+        path.join(MINIONS_DIR, 'work-items.json'),
+        path.join(ENGINE_DIR, 'dispatch.json'),
+      ];
+      // Watch project-specific work-items.json
+      const { getProjects } = require('./shared');
+      for (const p of getProjects(config)) {
+        filesToWatch.push(shared.projectWorkItemsPath(p));
+      }
+      // Watch PRD files
+      const prdDir = path.join(MINIONS_DIR, 'prd');
+      try {
+        for (const f of fs.readdirSync(prdDir).filter(f => f.endsWith('.json'))) {
+          filesToWatch.push(path.join(prdDir, f));
+        }
+      } catch {}
+
+      for (const filePath of filesToWatch) {
+        if (_watchedFiles.has(filePath)) continue;
+        _watchedFiles.add(filePath);
+        try {
+          let _debounce = null;
+          fs.watchFile(filePath, { interval: 2000 }, () => {
+            // Debounce — multiple rapid writes should only trigger one tick
+            if (_debounce) return;
+            _debounce = setTimeout(() => {
+              _debounce = null;
+              e.log('info', `File change detected: ${path.basename(filePath)} — triggering tick`);
+              e.tick();
+            }, 1000);
+          });
+        } catch {}
+      }
+    }
+    watchForWorkChanges();
+
     // Graceful shutdown — wait for active agents before exiting
     let shuttingDown = false;
     function gracefulShutdown(signal) {
@@ -327,6 +366,7 @@ const commands = {
       shuttingDown = true;
       console.log(`\n${signal} received — initiating graceful shutdown...`);
       clearInterval(tickTimer);
+      for (const f of _watchedFiles) { try { fs.unwatchFile(f); } catch {} }
       safeWrite(CONTROL_PATH, { state: 'stopping', pid: process.pid, stopping_at: e.ts() });
       e.log('info', `Graceful shutdown initiated (${signal})`);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yemi33/minions",
-  "version": "0.1.54",
+  "version": "0.1.56",
   "description": "Multi-agent AI dev team that runs from ~/.minions/ — five autonomous agents share a single engine, dashboard, and knowledge base",
   "bin": {
     "minions": "bin/minions.js"