@yemi33/minions 0.1.53 → 0.1.55

package/CHANGELOG.md

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

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/engine.js

@@ -2361,7 +2361,8 @@ function materializePlansAsWorkItems(config) {
     const defaultProjectName = plan.project || file.replace(/-\d{4}-\d{2}-\d{2}\.json$/, '');
     const allProjects = getProjects(config);
     const defaultProject = allProjects.find(p => p.name?.toLowerCase() === defaultProjectName.toLowerCase());
-    if (!defaultProject) continue;
+    // No project found — use central work-items.json (engine works without projects)
+    const useCentral = !defaultProject;
 
     const statusFilter = ['missing', 'planned'];
     // Also materialize in-pr/done items that never got a work item (race with PR status sync)
@@ -2371,20 +2372,31 @@ function materializePlansAsWorkItems(config) {
         if (w.id) allExistingWiIds.add(w.id);
       }
     }
+    // Also check central work-items.json
+    for (const w of (safeJson(path.join(MINIONS_DIR, 'work-items.json')) || [])) {
+      if (w.id) allExistingWiIds.add(w.id);
+    }
     const items = plan.missing_features.filter(f =>
       statusFilter.includes(f.status) ||
       ((f.status === 'in-pr' || f.status === 'done') && f.id && !allExistingWiIds.has(f.id))
     );
 
     // Group items by target project (per-item project field overrides plan-level project)
+    // When no projects are configured, all items go to central work-items.json
     const itemsByProject = new Map(); // projectName -> { project, items: [] }
     for (const item of items) {
-      const itemProjectName = item.project || defaultProjectName;
-      const itemProject = allProjects.find(p => p.name?.toLowerCase() === itemProjectName.toLowerCase()) || defaultProject;
-      if (!itemsByProject.has(itemProject.name)) {
-        itemsByProject.set(itemProject.name, { project: itemProject, items: [] });
+      if (useCentral) {
+        if (!itemsByProject.has('_central')) itemsByProject.set('_central', { project: null, items: [] });
+        itemsByProject.get('_central').items.push(item);
+      } else {
+        const itemProjectName = item.project || defaultProjectName;
+        const itemProject = allProjects.find(p => p.name?.toLowerCase() === itemProjectName.toLowerCase()) || defaultProject;
+        if (!itemProject) continue;
+        if (!itemsByProject.has(itemProject.name)) {
+          itemsByProject.set(itemProject.name, { project: itemProject, items: [] });
+        }
+        itemsByProject.get(itemProject.name).items.push(item);
       }
-      itemsByProject.get(itemProject.name).items.push(item);
     }
 
     // Cycle detection BEFORE materialization — skip cyclic items
@@ -2406,7 +2418,7 @@ function materializePlansAsWorkItems(config) {
 
     let totalCreated = 0;
     for (const [projName, { project, items: projItems }] of itemsByProject) {
-      const wiPath = projectWorkItemsPath(project);
+      const wiPath = project ? projectWorkItemsPath(project) : path.join(MINIONS_DIR, 'work-items.json');
       const existingItems = safeJson(wiPath) || [];
       let created = 0;
       const newlyCreatedIds = new Set(); // tracks IDs created in this pass for reconciliation scoping

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yemi33/minions",
-  "version": "0.1.53",
+  "version": "0.1.55",
   "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"