@yemi33/minions 0.1.7 → 0.1.9

package/CHANGELOG.md

@@ -1,5 +1,51 @@
 # Changelog
 
+## 0.1.9 (2026-03-26)
+
+### Engine
+- engine.js
+- engine/ado.js
+- engine/cli.js
+- engine/github.js
+- engine/lifecycle.js
+- engine/scheduler.js
+- engine/shared.js
+
+### Dashboard
+- dashboard.html
+- dashboard.js
+
+### Playbooks
+- decompose.md
+
+### Documentation
+- README.md
+
+### Other
+- CLAUDE.md
+- TODO.md
+- routing.md
+- test/playwright/dashboard.spec.js
+
+## 0.1.8 (2026-03-25)
+
+### Engine
+- engine.js
+- engine/cli.js
+- engine/preflight.js
+- engine/shared.js
+- engine/spawn-agent.js
+
+### Documentation
+- README.md
+- auto-discovery.md
+
+### Other
+- CLAUDE.md
+- bin/minions.js
+- config.template.json
+- test/unit.test.js
+
 ## 0.1.7 (2026-03-24)
 
 ### Documentation

package/README.md

@@ -473,7 +473,7 @@ Engine behavior is controlled via `config.json`. Key settings:
 {
   "engine": {
     "tickInterval": 60000,
-    "maxConcurrent": 3,
+    "maxConcurrent": 5,
     "agentTimeout": 18000000,
     "heartbeatTimeout": 300000,
     "maxTurns": 100,
@@ -487,7 +487,7 @@ Engine behavior is controlled via `config.json`. Key settings:
 | Setting | Default | Description |
 |---------|---------|-------------|
 | `tickInterval` | 60000 (1min) | Milliseconds between engine ticks |
-| `maxConcurrent` | 3 | Max agents running simultaneously |
+| `maxConcurrent` | 5 | Max agents running simultaneously |
 | `agentTimeout` | 18000000 (5h) | Max total agent runtime |
 | `heartbeatTimeout` | 300000 (5min) | Kill agents silent longer than this |
 | `maxTurns` | 100 | Max Claude CLI turns per agent session |
@@ -497,6 +497,60 @@ Engine behavior is controlled via `config.json`. Key settings:
 | `worktreeRoot` | `../worktrees` | Where git worktrees are created |
 | `idleAlertMinutes` | 15 | Alert after no dispatch for this many minutes |
 | `restartGracePeriod` | 1200000 (20min) | Grace period for agent re-attachment after engine restart |
+| `shutdownTimeout` | 300000 (5min) | Max wait for active agents during graceful shutdown (SIGTERM/SIGINT) |
+| `allowTempAgents` | false | Spawn ephemeral agents when all permanent agents are busy |
+| `autoDecompose` | true | Auto-decompose `implement:large` items into sub-tasks before dispatch |
+
+### Scheduled Tasks
+
+Add recurring work via `config.schedules`:
+
+```json
+{
+  "schedules": [
+    {
+      "id": "nightly-tests",
+      "cron": "0 2 *",
+      "type": "test",
+      "title": "Nightly test suite",
+      "project": "MyProject",
+      "agent": "dallas",
+      "enabled": true
+    }
+  ]
+}
+```
+
+Cron format is simplified 3-field: `minute hour dayOfWeek` (0=Sun..6=Sat). Supports `*`, `*/N`, and specific values. Examples:
+- `0 2 *` — 2am daily
+- `0 9 1` — 9am every Monday
+- `*/30 * *` — every 30 minutes
+- `0 9 1,3,5` — 9am Mon/Wed/Fri
+
+### Graceful Shutdown
+
+The engine handles `SIGTERM` and `SIGINT` (Ctrl+C) gracefully:
+1. Stops accepting new work (enters `stopping` state)
+2. Waits for active agents to finish (up to `shutdownTimeout`, default 5 minutes)
+3. Exits cleanly
+
+Active agents continue running as independent processes and will be re-attached on next engine start.
+
+### Task Decomposition
+
+Work items with `complexity: "large"` or `estimated_complexity: "large"` are auto-decomposed before dispatch (controlled by `engine.autoDecompose`, default `true`). The engine dispatches a `decompose` agent that breaks the item into 2-5 smaller sub-tasks, each becoming an independent work item with dependency tracking.
+
+### Temporary Agents
+
+Set `engine.allowTempAgents: true` to let the engine spawn ephemeral agents when all 5 permanent agents are busy. Temp agents:
+- Get a `temp-{id}` identifier
+- Use a minimal system prompt (no charter)
+- Are auto-cleaned up after task completion
+- Count toward `maxConcurrent` slots
+
+### Live Output Streaming
+
+The dashboard streams agent output in real-time via Server-Sent Events (SSE) instead of polling. The `GET /api/agent/:id/live-stream` endpoint pushes output chunks as they're written. Falls back to 3-second polling if SSE is unavailable.
 
 ## Node.js Upgrade Caution
 
@@ -535,6 +589,8 @@ To move to a new machine: `npm install -g @yemi33/minions && minions init --forc
     ado.js               <- ADO token management, PR polling, PR reconciliation
     llm.js               <- callLLM() with session resume, trackEngineUsage()
     spawn-agent.js       <- Agent spawn wrapper (resolves claude cli.js)
+    preflight.js         <- Prerequisite checks (Node, Git, Claude CLI, API key)
+    scheduler.js         <- Cron-style scheduled task discovery
     ado-mcp-wrapper.js   <- ADO MCP authentication wrapper
     check-status.js      <- Quick status check without full engine load
     control.json         <- running/paused/stopped (runtime, generated)
@@ -542,6 +598,7 @@ To move to a new machine: `npm install -g @yemi33/minions && minions init --forc
     log.json             <- Audit trail, capped at 500 (runtime, generated)
     metrics.json         <- Per-agent quality metrics (runtime, generated)
     cooldowns.json       <- Dispatch cooldown tracking (runtime, generated)
+    schedule-runs.json   <- Last-run timestamps for scheduled tasks (runtime, generated)
   dashboard.js           <- Web dashboard server
   dashboard.html         <- Dashboard UI (single-file)
   config.json            <- projects[], agents, engine, claude settings (generated by minions init)
@@ -566,6 +623,7 @@ To move to a new machine: `npm install -g @yemi33/minions && minions init --forc
     implement-shared.md  <- Implement on a shared branch
     ask.md               <- Answer a question about the codebase
     verify.md            <- Plan verification: build, test, start webapp, testing guide
+    decompose.md         <- Break large work items into 2-5 sub-tasks
   skills/                <- Agent-created reusable workflows (generated)
   agents/
     {name}/

package/bin/minions.js

@@ -297,6 +297,13 @@ function init() {
     showChangelog(installedVersion);
   }
 
+  // Run preflight checks (warn only — don't block init)
+  try {
+    const { runPreflight, printPreflight } = require(path.join(MINIONS_HOME, 'engine', 'preflight'));
+    const { results } = runPreflight();
+    printPreflight(results, { label: 'Preflight checks' });
+  } catch {}
+
   // Auto-start on fresh install; force-upgrade restarts automatically.
   if (isUpgrade) {
     try { execSync(`node "${path.join(MINIONS_HOME, 'engine.js')}" stop`, { stdio: 'ignore', cwd: MINIONS_HOME }); } catch {}
@@ -315,7 +322,17 @@ function init() {
   });
   dashProc.unref();
   console.log(`  Dashboard started (PID: ${dashProc.pid})`);
-  console.log('  Dashboard: http://localhost:7331\n');
+  console.log('  Dashboard: http://localhost:7331');
+
+  // Next steps guidance
+  console.log(`
+  Next steps:
+    minions work "Explore the codebase"   Give your first task
+    minions status                         Check engine state
+    http://localhost:7331                  Open the dashboard
+    minions doctor                         Verify everything is working
+    minions --help                         See all commands
+`);
 }
 
 function copyDir(src, dest, excludeTop, alwaysUpdate, neverOverwrite, isUpgrade, actions, relPath = '') {
@@ -391,6 +408,16 @@ function showVersion() {
   } else {
     console.log('  Not installed yet. Run: minions init');
   }
+
+  // Check npm registry for latest version (best-effort, non-blocking)
+  try {
+    const latest = execSync('npm view @yemi33/minions version', { encoding: 'utf8', timeout: 5000, windowsHide: true }).trim();
+    if (latest && latest !== pkg) {
+      console.log(`\n  Latest on npm:     ${latest}`);
+      console.log('  To update: npm update -g @yemi33/minions && minions init --force');
+    }
+  } catch {} // offline or npm not available — skip silently
+
   console.log('');
 }
 
@@ -428,12 +455,14 @@ if (!cmd || cmd === 'help' || cmd === '--help' || cmd === '-h') {
     minions init [--skip-scan]       Bootstrap ~/.minions/ (first time)
     minions init --force             Upgrade engine code + add new files (auto-skip scan)
     minions version                  Show installed vs package version
+    minions doctor                   Check prerequisites and runtime health
     minions add <project-dir>        Link a project (interactive)
     minions remove <project-dir>     Unlink a project
     minions list                     List linked projects
 
   Engine:
-    minions start                    Start engine daemon
+    minions up                       Start engine + dashboard (use after reboot)
+    minions start                    Start engine daemon only
     minions stop                     Stop the engine
     minions status                   Show agents, projects, queue
     minions pause / resume           Pause/resume dispatching
@@ -455,6 +484,26 @@ if (!cmd || cmd === 'help' || cmd === '--help' || cmd === '-h') {
   showVersion();
 } else if (cmd === 'add' || cmd === 'remove' || cmd === 'list') {
   delegate('minions.js', [cmd, ...rest]);
+} else if (cmd === 'up' || cmd === 'restart') {
+  // Start both engine and dashboard — the go-to command after a reboot
+  ensureInstalled();
+  // Stop engine if running (ignore errors)
+  try { execSync(`node "${path.join(MINIONS_HOME, 'engine.js')}" stop`, { stdio: 'ignore', cwd: MINIONS_HOME }); } catch {}
+  const engineProc = spawn(process.execPath, [path.join(MINIONS_HOME, 'engine.js'), 'start'], {
+    cwd: MINIONS_HOME, stdio: 'ignore', detached: true, windowsHide: true
+  });
+  engineProc.unref();
+  console.log(`\n  Engine started (PID: ${engineProc.pid})`);
+  const dashProc = spawn(process.execPath, [path.join(MINIONS_HOME, 'dashboard.js')], {
+    cwd: MINIONS_HOME, stdio: 'ignore', detached: true, windowsHide: true
+  });
+  dashProc.unref();
+  console.log(`  Dashboard started (PID: ${dashProc.pid})`);
+  console.log('  Dashboard: http://localhost:7331\n');
+} else if (cmd === 'doctor') {
+  ensureInstalled();
+  const { doctor } = require(path.join(MINIONS_HOME, 'engine', 'preflight'));
+  doctor(MINIONS_HOME).then(ok => process.exit(ok ? 0 : 1));
 } else if (cmd === 'dash' || cmd === 'dashboard') {
   delegate('dashboard.js', rest);
 } else if (engineCmds.has(cmd)) {

package/config.template.json

@@ -1,28 +1,4 @@
 {
-  "projects": [
-    {
-      "name": "YOUR_PROJECT_NAME",
-      "localPath": "/path/to/your/project",
-      "repoHost": "ado",
-      "repositoryId": "YOUR_REPO_ID",
-      "adoOrg": "YOUR_ORG",
-      "adoProject": "YOUR_PROJECT",
-      "repoName": "YOUR_REPO_NAME",
-      "mainBranch": "main",
-      "prUrlBase": "",
-      "workSources": {
-        "pullRequests": {
-          "enabled": true,
-          "path": ".minions/pull-requests.json",
-          "cooldownMinutes": 30
-        },
-        "workItems": {
-          "enabled": true,
-          "path": ".minions/work-items.json",
-          "cooldownMinutes": 0
-        }
-      }
-    }
-  ]
+  "projects": []
 }
 

package/dashboard.html

@@ -917,7 +917,7 @@ function closeDetail() {
   document.getElementById('detail-overlay').classList.remove('open');
   document.getElementById('detail-panel').classList.remove('open');
   currentAgentId = null;
-  stopLivePolling();
+  stopLiveStream();
 }
 
 function renderDetailTabs(detail) {
@@ -978,10 +978,10 @@ function renderDetailContent(detail, tab) {
   } else if (tab === 'live') {
     el.innerHTML = '<div class="section" id="live-output" style="max-height:60vh;overflow-y:auto;font-size:11px;line-height:1.6">Loading live output...</div>' +
       '<div style="margin-top:8px;display:flex;gap:8px;align-items:center">' +
-        '<span class="pulse"></span><span style="font-size:11px;color:var(--green)">Auto-refreshing every 3s</span>' +
+        '<span class="pulse"></span><span id="live-status-label" style="font-size:11px;color:var(--green)">Streaming live</span>' +
         '<button class="pr-pager-btn" onclick="refreshLiveOutput()" style="font-size:10px">Refresh now</button>' +
       '</div>';
-    startLivePolling();
+    startLiveStream(currentAgentId);
   } else if (tab === 'charter') {
     el.innerHTML = '<div class="section">' + escHtml(detail.charter || 'No charter found.') + '</div>';
   } else if (tab === 'history') {
@@ -1011,6 +1011,49 @@ function renderDetailContent(detail, tab) {
 }
 
 let livePollingInterval = null;
+let liveEventSource = null;
+
+function startLiveStream(agentId) {
+  stopLiveStream();
+  if (!agentId) return;
+
+  const outputEl = document.getElementById('live-output');
+  if (outputEl) outputEl.textContent = '';
+
+  liveEventSource = new EventSource('/api/agent/' + agentId + '/live-stream');
+
+  liveEventSource.onmessage = function(e) {
+    try {
+      const chunk = JSON.parse(e.data);
+      const el = document.getElementById('live-output');
+      if (el) {
+        const wasAtBottom = el.scrollHeight - el.scrollTop - el.clientHeight < 100;
+        el.textContent += chunk;
+        if (wasAtBottom) el.scrollTop = el.scrollHeight;
+      }
+    } catch {}
+  };
+
+  liveEventSource.addEventListener('done', function() {
+    stopLiveStream();
+  });
+
+  liveEventSource.onerror = function() {
+    // Fall back to polling on SSE error
+    stopLiveStream();
+    startLivePolling();
+    const label = document.getElementById('live-status-label');
+    if (label) label.textContent = 'Auto-refreshing every 3s';
+  };
+}
+
+function stopLiveStream() {
+  if (liveEventSource) {
+    liveEventSource.close();
+    liveEventSource = null;
+  }
+  stopLivePolling();
+}
 
 function startLivePolling() {
   stopLivePolling();
@@ -2209,6 +2252,7 @@ function renderDispatch(dispatch) {
           '<span class="dispatch-type ' + (d.type || '') + '">' + escHtml(d.type || '') + '</span>' +
           '<span class="dispatch-agent">' + escHtml(d.agentName || d.agent || '') + '</span>' +
           '<span class="dispatch-task" title="' + escHtml(d.task || '') + '">' + escHtml(d.task || '') + '</span>' +
+          (d.skipReason ? '<span style="font-size:9px;color:var(--muted);margin-left:6px" title="' + escHtml(d.skipReason) + '">' + escHtml(d.skipReason.replace(/_/g, ' ')) + '</span>' : '') +
         '</div>'
       ).join('') + '</div>';
   } else {
@@ -2516,6 +2560,7 @@ function wiRow(item) {
     '<td>' + typeBadge(item.type) + '</td>' +
     '<td>' + priBadge(item.priority) + '</td>' +
     '<td>' + statusBadge(item.status || 'pending') +
+      (item._pendingReason ? ' <span style="font-size:9px;color:var(--muted);margin-left:4px" title="Pending reason: ' + escHtml(item._pendingReason) + '">' + escHtml(item._pendingReason.replace(/_/g, ' ')) + '</span>' : '') +
       (item.status === 'failed' ? ' <button class="pr-pager-btn" style="font-size:9px;padding:1px 6px;color:var(--yellow);border-color:var(--yellow);margin-left:4px" onclick="event.stopPropagation();retryWorkItem(\'' + escHtml(item.id) + '\',\'' + escHtml(item._source || '') + '\')">Retry</button>' : '') +
     '</td>' +
     '<td>' +
@@ -2527,6 +2572,7 @@ function wiRow(item) {
     '<td>' + prLink + '</td>' +
     '<td><span class="pr-date">' + shortTime(item.created) + '</span></td>' +
     '<td style="white-space:nowrap">' +
+      ((item.status === 'pending' || item.status === 'failed') ? '<button class="pr-pager-btn" style="font-size:9px;padding:1px 6px;color:var(--blue);border-color:var(--blue);margin-right:4px" onclick="event.stopPropagation();editWorkItem(\'' + escHtml(item.id) + '\',\'' + escHtml(item._source || '') + '\')" title="Edit work item">&#x270E;</button>' : '') +
       ((item.status === 'done' || item.status === 'failed') ? '<button class="pr-pager-btn" style="font-size:9px;padding:1px 6px;color:var(--muted);border-color:var(--border);margin-right:4px" onclick="event.stopPropagation();archiveWorkItem(\'' + escHtml(item.id) + '\',\'' + escHtml(item._source || '') + '\')" title="Archive work item">&#x1F4E6;</button>' : '') +
       '<button class="pr-pager-btn" style="font-size:9px;padding:1px 6px;color:var(--red);border-color:var(--red)" onclick="event.stopPropagation();deleteWorkItem(\'' + escHtml(item.id) + '\',\'' + escHtml(item._source || '') + '\')" title="Delete work item and kill agent">&#x2715;</button>' +
     '</td>' +
@@ -2588,6 +2634,63 @@ async function retryWorkItem(id, source) {
   } catch (e) { alert('Retry error: ' + e.message); }
 }
 
+function editWorkItem(id, source) {
+  const item = allWorkItems.find(i => i.id === id);
+  if (!item) return;
+  const types = ['implement', 'fix', 'review', 'plan', 'verify', 'investigate', 'refactor', 'test', 'docs'];
+  const priorities = ['critical', 'high', 'medium', 'low'];
+  const agentOpts = cmdAgents.map(a => '<option value="' + escHtml(a.id) + '"' + (item.agent === a.id ? ' selected' : '') + '>' + escHtml(a.name) + '</option>').join('');
+  const typeOpts = types.map(t => '<option value="' + t + '"' + ((item.type || 'implement') === t ? ' selected' : '') + '>' + t + '</option>').join('');
+  const priOpts = priorities.map(p => '<option value="' + p + '"' + ((item.priority || 'medium') === p ? ' selected' : '') + '>' + p + '</option>').join('');
+
+  document.getElementById('modal-title').textContent = 'Edit Work Item ' + id;
+  document.getElementById('modal-body').style.whiteSpace = 'normal';
+  document.getElementById('modal-body').innerHTML =
+    '<div style="display:flex;flex-direction:column;gap:12px;font-family:inherit">' +
+      '<label style="color:var(--text);font-size:var(--text-md)">Title' +
+        '<input id="wi-edit-title" value="' + escHtml(item.title || '') + '" style="display:block;width:100%;margin-top:4px;padding:6px 8px;background:var(--bg);border:1px solid var(--border);border-radius:var(--radius-sm);color:var(--text);font-size:var(--text-md);font-family:inherit">' +
+      '</label>' +
+      '<label style="color:var(--text);font-size:var(--text-md)">Description' +
+        '<textarea id="wi-edit-desc" rows="3" style="display:block;width:100%;margin-top:4px;padding:6px 8px;background:var(--bg);border:1px solid var(--border);border-radius:var(--radius-sm);color:var(--text);font-size:var(--text-md);font-family:inherit;resize:vertical">' + escHtml(item.description || '') + '</textarea>' +
+      '</label>' +
+      '<div style="display:flex;gap:12px">' +
+        '<label style="color:var(--text);font-size:var(--text-md);flex:1">Type' +
+          '<select id="wi-edit-type" style="display:block;width:100%;margin-top:4px;padding:6px 8px;background:var(--bg);border:1px solid var(--border);border-radius:var(--radius-sm);color:var(--text);font-size:var(--text-md)">' + typeOpts + '</select>' +
+        '</label>' +
+        '<label style="color:var(--text);font-size:var(--text-md);flex:1">Priority' +
+          '<select id="wi-edit-priority" style="display:block;width:100%;margin-top:4px;padding:6px 8px;background:var(--bg);border:1px solid var(--border);border-radius:var(--radius-sm);color:var(--text);font-size:var(--text-md)">' + priOpts + '</select>' +
+        '</label>' +
+        '<label style="color:var(--text);font-size:var(--text-md);flex:1">Agent' +
+          '<select id="wi-edit-agent" style="display:block;width:100%;margin-top:4px;padding:6px 8px;background:var(--bg);border:1px solid var(--border);border-radius:var(--radius-sm);color:var(--text);font-size:var(--text-md)"><option value="">Auto</option>' + agentOpts + '</select>' +
+        '</label>' +
+      '</div>' +
+      '<div style="display:flex;justify-content:flex-end;gap:8px;margin-top:8px">' +
+        '<button onclick="closeModal()" class="pr-pager-btn" style="padding:6px 16px;font-size:var(--text-md)">Cancel</button>' +
+        '<button onclick="submitWorkItemEdit(\'' + escHtml(id) + '\',\'' + escHtml(source || '') + '\')" style="padding:6px 16px;font-size:var(--text-md);background:var(--blue);color:#fff;border:none;border-radius:var(--radius-sm);cursor:pointer">Save</button>' +
+      '</div>' +
+    '</div>';
+  document.getElementById('modal').classList.add('open');
+}
+
+async function submitWorkItemEdit(id, source) {
+  const title = document.getElementById('wi-edit-title').value.trim();
+  const description = document.getElementById('wi-edit-desc').value;
+  const type = document.getElementById('wi-edit-type').value;
+  const priority = document.getElementById('wi-edit-priority').value;
+  const agent = document.getElementById('wi-edit-agent').value;
+  if (!title) { alert('Title is required'); return; }
+  try {
+    const res = await fetch('/api/work-items/update', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ id, source: source || undefined, title, description, type, priority, agent })
+    });
+    if (res.ok) { closeModal(); refresh(); showToast('cmd-toast', 'Work item updated', true); } else {
+      const d = await res.json();
+      alert('Update failed: ' + (d.error || 'unknown'));
+    }
+  } catch (e) { alert('Update error: ' + e.message); }
+}
+
 async function deleteWorkItem(id, source) {
   if (!confirm('Delete work item ' + id + '? This will kill any running agent and remove all dispatch history.')) return;
   try {

package/dashboard.js

@@ -852,6 +852,44 @@ const server = http.createServer(async (req, res) => {
     } catch (e) { return jsonReply(res, 400, { error: e.message }); }
   }
 
+  // POST /api/work-items/update — edit a pending/failed work item
+  if (req.method === 'POST' && req.url === '/api/work-items/update') {
+    try {
+      const body = await readBody(req);
+      const { id, source, title, description, type, priority, agent } = body;
+      if (!id) return jsonReply(res, 400, { error: 'id required' });
+
+      let wiPath;
+      if (!source || source === 'central') {
+        wiPath = path.join(MINIONS_DIR, 'work-items.json');
+      } else {
+        const proj = PROJECTS.find(p => p.name === source);
+        if (proj) {
+          wiPath = shared.projectWorkItemsPath(proj);
+        }
+      }
+      if (!wiPath) return jsonReply(res, 404, { error: 'source not found' });
+
+      const items = JSON.parse(safeRead(wiPath) || '[]');
+      const item = items.find(i => i.id === id);
+      if (!item) return jsonReply(res, 404, { error: 'item not found' });
+
+      if (item.status === 'dispatched') {
+        return jsonReply(res, 400, { error: 'Cannot edit dispatched items' });
+      }
+
+      if (title !== undefined) item.title = title;
+      if (description !== undefined) item.description = description;
+      if (type !== undefined) item.type = type;
+      if (priority !== undefined) item.priority = priority;
+      if (agent !== undefined) item.agent = agent || null;
+      item.updatedAt = new Date().toISOString();
+
+      safeWrite(wiPath, items);
+      return jsonReply(res, 200, { ok: true, item });
+    } catch (e) { return jsonReply(res, 400, { error: e.message }); }
+  }
+
   // POST /api/notes — write to inbox so it flows through normal consolidation
   if (req.method === 'POST' && req.url === '/api/notes') {
     try {
@@ -1076,6 +1114,69 @@ const server = http.createServer(async (req, res) => {
     } catch (e) { return jsonReply(res, 400, { error: e.message }); }
   }
 
+  // GET /api/agent/:id/live-stream — SSE real-time live output streaming
+  const liveStreamMatch = req.url.match(/^\/api\/agent\/([\w-]+)\/live-stream(?:\?.*)?$/);
+  if (liveStreamMatch && req.method === 'GET') {
+    const agentId = liveStreamMatch[1];
+    const liveLogPath = path.join(MINIONS_DIR, 'agents', agentId, 'live-output.log');
+
+    res.writeHead(200, {
+      'Content-Type': 'text/event-stream',
+      'Cache-Control': 'no-cache',
+      'Connection': 'keep-alive',
+      'Access-Control-Allow-Origin': '*',
+    });
+
+    // Send initial content
+    let offset = 0;
+    try {
+      const content = fs.readFileSync(liveLogPath, 'utf8');
+      if (content.length > 0) {
+        res.write(`data: ${JSON.stringify(content)}\n\n`);
+        offset = Buffer.byteLength(content, 'utf8');
+      }
+    } catch {}
+
+    // Watch for changes using fs.watchFile (cross-platform, works on Windows)
+    const watcher = () => {
+      try {
+        const stat = fs.statSync(liveLogPath);
+        if (stat.size > offset) {
+          const fd = fs.openSync(liveLogPath, 'r');
+          const buf = Buffer.alloc(stat.size - offset);
+          fs.readSync(fd, buf, 0, buf.length, offset);
+          fs.closeSync(fd);
+          offset = stat.size;
+          const chunk = buf.toString('utf8');
+          if (chunk) res.write(`data: ${JSON.stringify(chunk)}\n\n`);
+        }
+      } catch {}
+    };
+
+    fs.watchFile(liveLogPath, { interval: 500 }, watcher);
+
+    // Check if agent is still active (poll every 5s)
+    const doneCheck = setInterval(() => {
+      const dispatch = getDispatchQueue();
+      const isActive = (dispatch.active || []).some(d => d.agent === agentId);
+      if (!isActive) {
+        watcher(); // flush final content
+        res.write(`event: done\ndata: complete\n\n`);
+        clearInterval(doneCheck);
+        fs.unwatchFile(liveLogPath, watcher);
+        res.end();
+      }
+    }, 5000);
+
+    // Cleanup on client disconnect
+    req.on('close', () => {
+      clearInterval(doneCheck);
+      fs.unwatchFile(liveLogPath, watcher);
+    });
+
+    return;
+  }
+
   // GET /api/agent/:id/live — tail live output for a working agent
   const liveMatch = req.url.match(/^\/api\/agent\/([\w-]+)\/live(?:\?.*)?$/);
   if (liveMatch && req.method === 'GET') {

package/docs/auto-discovery.md

@@ -196,7 +196,7 @@ Discovered items land in `engine/dispatch.json`:
 Each tick, the engine checks available slots:
 
 ```
-slotsAvailable = maxConcurrent (3) - activeCount
+slotsAvailable = maxConcurrent (5) - activeCount
 ```
 
 It takes up to `slotsAvailable` items from pending and spawns them. Items are processed in discovery-priority order (fixes first, then reviews, then implements, then work-items).
@@ -378,7 +378,7 @@ All discovery behavior is controlled via `config.json`:
 {
   "engine": {
     "tickInterval": 60000,       // ms between ticks
-    "maxConcurrent": 3,          // max agents running at once
+    "maxConcurrent": 5,          // max agents running at once
     "agentTimeout": 18000000,     // 5 hours — kill hung processes
     "heartbeatTimeout": 300000,  // 5min — kill stale/silent agents
     "maxTurns": 100,             // max claude CLI turns per agent

package/engine/ado.js

@@ -192,6 +192,7 @@ async function pollPrStatus(config) {
       pr.buildStatus = buildStatus;
       if (buildFailReason) pr.buildFailReason = buildFailReason;
       else delete pr.buildFailReason;
+      if (buildStatus !== 'failing') delete pr._buildFailNotified;
       updated = true;
     }