@yemi33/minions 0.1.13 → 0.1.15

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 0.1.15 (2026-03-28)
+
+### Dashboard
+- dashboard/js/command-center.js
+- dashboard/js/render-plans.js
+- dashboard/js/render-prd.js
+- dashboard/js/render-work-items.js
+- dashboard/js/utils.js
+
+## 0.1.14 (2026-03-26)
+
+### Dashboard
+- dashboard-build.js
+- dashboard.js
+- dashboard/js/modal-qa.js
+- dashboard/js/render-agents.js
+- dashboard/js/render-dispatch.js
+- dashboard/js/render-inbox.js
+- dashboard/js/render-kb.js
+- dashboard/js/render-plans.js
+- dashboard/js/render-prd.js
+- dashboard/js/settings.js
+
+### Other
+- test/playwright/dashboard.spec.js
+
 ## 0.1.13 (2026-03-26)
 
 ### Dashboard

package/dashboard/js/command-center.js

@@ -222,6 +222,7 @@ async function ccExecuteAction(action) {
         const d = await res.json();
         status.innerHTML = '&#10003; Dispatched: <strong>' + escHtml(d.id || action.title) + '</strong>';
         status.style.color = 'var(--green)';
+        wakeEngine();
         break;
       }
       case 'note': {
@@ -261,6 +262,7 @@ async function ccExecuteAction(action) {
         }
         status.innerHTML = '&#10003; Retried: <strong>' + escHtml((action.ids || []).join(', ')) + '</strong>';
         status.style.color = 'var(--green)';
+        wakeEngine();
         break;
       }
       case 'pause-plan': {
@@ -338,6 +340,7 @@ async function ccExecuteAction(action) {
         });
         status.innerHTML = '&#10003; Plan execution queued: <strong>' + escHtml(action.file) + '</strong>';
         status.style.color = 'var(--green)';
+        wakeEngine();
         refreshPlans();
         break;
       }

package/dashboard/js/modal-qa.js

@@ -266,3 +266,44 @@ async function _processQaMessage(message, selection) {
     document.getElementById('modal-qa-input')?.focus();
   }
 }
+
+async function qaNewPrd(planFile) {
+  qaDisablePrdButtons();
+  const allPlans = window._lastStatus?.plans || [];
+  const mdPlan = allPlans.find(p => p.file === planFile);
+  const project = mdPlan?.project || '';
+
+  planExecute(planFile, project, null);
+
+  const btn = document.getElementById('qa-generate-prd-btn');
+  if (btn) btn.innerHTML = '<span style="color:var(--green);font-size:12px">New PRD dispatched — existing work continues, agent creating fresh PRD from revised plan.</span>';
+}
+
+async function qaReplacePrd(planFile) {
+  qaDisablePrdButtons();
+  const allPlans = window._lastStatus?.plans || [];
+  const mdPlan = allPlans.find(p => p.file === planFile);
+  const project = mdPlan?.project || '';
+  const existingPrd = allPlans.find(p => p.file.endsWith('.json') && p.project === project);
+
+  if (existingPrd) {
+    // Pause first to stop materialization, then clean pending items
+    try {
+      await fetch('/api/plans/pause', {
+        method: 'POST', headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ file: existingPrd.file })
+      });
+    } catch {}
+    try {
+      await fetch('/api/plans/regenerate', {
+        method: 'POST', headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ source: existingPrd.file })
+      });
+    } catch {}
+  }
+
+  planExecute(planFile, project, null);
+
+  const btn = document.getElementById('qa-generate-prd-btn');
+  if (btn) btn.innerHTML = '<span style="color:var(--orange);font-size:12px">Replacing PRD — old items paused, agent regenerating from revised plan.</span>';
+}

package/dashboard/js/render-agents.js

@@ -15,3 +15,30 @@ function renderAgents(agents) {
     </div>
   `).join('');
 }
+
+async function openAgentDetail(id) {
+  currentAgentId = id;
+  const agent = agentData.find(a => a.id === id);
+  currentTab = (agent?.status === 'working') ? 'live' : 'thought-process';
+  if (!agent) return;
+
+  document.getElementById('detail-agent-name').innerHTML =
+    '<span style="font-size:22px">' + agent.emoji + '</span> ' + agent.name + ' — ' + agent.role;
+
+  const badgeClass = agent.status;
+  document.getElementById('detail-status-line').innerHTML =
+    '<span class="status-badge ' + badgeClass + '">' + agent.status.toUpperCase() + '</span> ' +
+    '<span style="color:var(--muted)">' + escHtml(agent.lastAction) + '</span>' +
+    (agent.resultSummary ? '<div style="margin-top:4px;font-size:11px;color:var(--text);line-height:1.4">' + escHtml(agent.resultSummary.slice(0, 300)) + '</div>' : '');
+
+  try {
+    const detail = await fetch('/api/agent/' + id).then(r => r.json());
+    renderDetailTabs(detail);
+    renderDetailContent(detail, currentTab);
+  } catch(e) {
+    document.getElementById('detail-content').textContent = 'Error loading agent detail: ' + e.message;
+  }
+
+  document.getElementById('detail-overlay').classList.add('open');
+  document.getElementById('detail-panel').classList.add('open');
+}

package/dashboard/js/render-dispatch.js

@@ -146,3 +146,26 @@ function shortTime(t) {
   if (!t) return '';
   try { return new Date(t).toLocaleTimeString(); } catch { return t; }
 }
+
+async function showErrorDetails(agentId, reason, task) {
+  document.getElementById('modal-title').textContent = 'Error: ' + task;
+  document.getElementById('modal-body').textContent = 'Reason: ' + reason + '\n\nLoading agent output...';
+  document.getElementById('modal-body').style.fontFamily = 'Consolas, monospace';
+  document.getElementById('modal-body').style.whiteSpace = 'pre-wrap';
+  document.getElementById('modal').classList.add('open');
+
+  try {
+    const output = await fetch('/api/agent/' + agentId + '/output').then(r => r.text());
+    const lines = output.split('\n');
+    const stderrIdx = lines.findIndex(l => l.startsWith('## stderr'));
+    let summary = '';
+    if (stderrIdx >= 0) {
+      const stderr = lines.slice(stderrIdx + 1).join('\n').trim();
+      if (stderr) summary = 'STDERR:\n' + stderr.slice(-2000);
+    }
+    if (!summary) summary = output.slice(-3000);
+    document.getElementById('modal-body').textContent = 'Reason: ' + reason + '\n\n---\n\n' + summary;
+  } catch {
+    document.getElementById('modal-body').textContent = 'Reason: ' + reason + '\n\n(Could not load agent output)';
+  }
+}

package/dashboard/js/render-inbox.js

@@ -124,3 +124,40 @@ function modalCancelEdit() {
   document.getElementById('modal-save-btn').style.display = 'none';
   document.getElementById('modal-cancel-edit-btn').style.display = 'none';
 }
+
+async function deleteInboxItem(name) {
+  if (!confirm('Delete "' + name + '" from inbox?')) return;
+  try {
+    const res = await fetch('/api/inbox/delete', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ name })
+    });
+    if (res.ok) { refresh(); } else { const d = await res.json(); alert('Failed: ' + (d.error || 'unknown')); }
+  } catch (e) { alert('Error: ' + e.message); }
+}
+
+async function openInboxInExplorer(name) {
+  try {
+    await fetch('/api/inbox/open', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ name })
+    });
+  } catch {}
+}
+
+async function doPromoteToKB(name, category) {
+  try {
+    const res = await fetch('/api/inbox/promote-kb', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ name, category })
+    });
+    const data = await res.json();
+    if (res.ok) {
+      closeModal();
+      refresh();
+      refreshKnowledgeBase();
+    } else {
+      alert('Failed: ' + (data.error || 'unknown'));
+    }
+  } catch (e) { alert('Error: ' + e.message); }
+}

package/dashboard/js/render-kb.js

@@ -105,3 +105,21 @@ async function kbSweep() {
   }
   setTimeout(() => { btn.textContent = origText; btn.style.color = 'var(--muted)'; btn.disabled = false; }, 3000);
 }
+
+async function kbOpenItem(category, file) {
+  try {
+    const content = await fetch('/api/knowledge/' + category + '/' + encodeURIComponent(file)).then(r => r.text());
+    const display = content.replace(/^---[\s\S]*?---\n*/m, '');
+    document.getElementById('modal-title').textContent = file;
+    document.getElementById('modal-body').textContent = display;
+    _modalDocContext = { title: file, content: display, selection: '' };
+    _modalFilePath = 'knowledge/' + category + '/' + file; showModalQa();
+    // Clear notification badge when opening this document
+    const card = findCardForFile(_modalFilePath);
+    if (card) clearNotifBadge(card);
+    // steer btn removed — unified send
+    document.getElementById('modal').classList.add('open');
+  } catch (e) {
+    console.error('Failed to load KB item:', e);
+  }
+}

package/dashboard/js/render-plans.js

@@ -269,6 +269,7 @@ async function planExecute(file, project, btn) {
       }
       closeModal();
       showToast('cmd-toast', data.alreadyQueued ? 'Already queued (' + data.id + ')' : 'Queued ' + data.id + ' — agent will convert plan to PRD', true);
+      wakeEngine();
       refreshPlans();
     } else {
       if (btn) { btn.textContent = 'Execute'; btn.disabled = false; btn.style.color = 'var(--green)'; }
@@ -302,3 +303,235 @@ function planHideRevise(file) {
   const id = 'revise-input-' + file.replace(/\./g, '-');
   document.getElementById(id).style.display = 'none';
 }
+
+async function planView(file) {
+  try {
+    const normalizedFile = normalizePlanFile(file);
+    const planRes = await fetch('/api/plans/' + encodeURIComponent(normalizedFile));
+    const lastMod = planRes.headers.get('Last-Modified');
+    const resolvedPath = planRes.headers.get('X-Resolved-Path');
+    const raw = await planRes.text();
+    let title = normalizedFile;
+    let text = '';
+
+    if (normalizedFile.endsWith('.json')) {
+      // PRD JSON — format nicely
+      const plan = JSON.parse(raw);
+      title = plan.plan_summary || normalizedFile;
+      const items = (plan.missing_features || []).map((f, i) =>
+        (i + 1) + '. [' + f.id + '] ' + f.name + ' (' + (f.estimated_complexity || '?') + ', ' + (f.priority || '?') + ')' +
+        (f.depends_on?.length ? ' → depends on: ' + f.depends_on.join(', ') : '') +
+        '\n   ' + (f.description || '').slice(0, 200) +
+        (f.acceptance_criteria?.length ? '\n   Criteria: ' + f.acceptance_criteria.join('; ') : '')
+      ).join('\n\n');
+      text = 'Project: ' + (plan.project || '?') +
+        '\nStrategy: ' + (plan.branch_strategy || 'parallel') +
+        '\nBranch: ' + (plan.feature_branch || 'per-item') +
+        '\nStatus: ' + (plan.status || 'active') +
+        '\nGenerated by: ' + (plan.generated_by || '?') + ' on ' + (plan.generated_at || '?') +
+        '\n\n--- Items (' + (plan.missing_features || []).length + ') ---\n\n' + items +
+        (plan.open_questions?.length ? '\n\n--- Open Questions ---\n\n' + plan.open_questions.map(q => '• ' + q).join('\n') : '');
+    } else {
+      // Markdown plan — show as-is
+      text = raw;
+      const titleMatch = raw.match(/^#\s+(?:Plan:\s*)?(.+)/m);
+      if (titleMatch) title = titleMatch[1];
+    }
+
+    // Version badge for the modal title
+    const vMatch = normalizedFile.match(/-v(\d+)/);
+    const versionLabel = vMatch ? ' (v' + vMatch[1] + ')' : '';
+
+    // Determine plan type and status for action buttons
+    const isMdPlan = normalizedFile.endsWith('.md');
+    let planStatus = '';
+    try { if (normalizedFile.endsWith('.json')) planStatus = JSON.parse(raw).status || ''; } catch {}
+    const isActive = planStatus === 'approved' || planStatus === 'active';
+    const isPaused = planStatus === 'awaiting-approval' || planStatus === 'paused';
+    // Check if work is in progress for this plan
+    const wi = window._lastWorkItems || [];
+    const hasActiveWork = wi.some(w =>
+      (w.status === 'pending' || w.status === 'dispatched') &&
+      (w.planFile === normalizedFile || w.sourcePlan === normalizedFile ||
+       // For .md plans: any work item with a sourcePlan .json means the plan is being executed
+        (isMdPlan && w.sourcePlan && w.sourcePlan.endsWith('.json')))
+    );
+    const prdCompleted = wi.some(w => w.type === 'plan-to-prd' && w.status === 'done' && w.planFile === normalizedFile);
+    // Check if a PRD already exists for this plan (via plans list sourcePlan linkage)
+    const hasPrd = (window._lastStatus?.plans || []).some(p => p.sourcePlan === normalizedFile && p.format === 'prd');
+    const modalShowResume = isPaused;
+    const modalExecuteBtn = isMdPlan && !modalShowResume && !hasActiveWork && !prdCompleted && !hasPrd ? '<button class="pr-pager-btn" style="font-size:10px;padding:2px 10px;color:var(--green);font-weight:600" ' +
+      'onclick="planExecute(\'' + escHtml(normalizedFile) + '\',\'\',this)">Execute</button>' : '';
+    const modalCompletedLabel = prdCompleted && !hasActiveWork ? '<span style="font-size:10px;color:var(--green);font-weight:600">Completed</span>' : '';
+    const modalInProgressLabel = hasActiveWork ? '<span style="font-size:10px;color:var(--blue)">In Progress</span>' : '';
+    const isModalCompleted = planStatus === 'completed';
+    const modalPauseBtn = isActive && !isMdPlan && !isModalCompleted ? '<button class="pr-pager-btn" style="font-size:10px;padding:2px 10px;color:var(--yellow)" ' +
+      'onclick="planPause(\'' + escHtml(normalizedFile) + '\');closeModal()">Pause</button>' : '';
+    const modalResumeBtn = isPaused ? '<button class="pr-pager-btn" style="font-size:10px;padding:2px 10px;color:var(--green)" ' +
+      'onclick="planApprove(\'' + escHtml(normalizedFile) + '\');closeModal()">Resume</button>' : '';
+
+    const lastModLabel = lastMod ? '<div style="font-size:10px;color:var(--muted);font-weight:400;margin-top:2px">Last updated: ' + new Date(lastMod).toLocaleString() + '</div>' : '';
+    const actionBtns = '<div style="display:flex;gap:4px;flex-wrap:wrap;margin-top:4px">' +
+      (modalCompletedLabel || '') + (modalInProgressLabel || '') + (modalExecuteBtn || '') + (modalPauseBtn || '') + (modalResumeBtn || '') +
+      ' <button class="pr-pager-btn" style="font-size:10px;padding:2px 10px;color:var(--red)" ' +
+      'onclick="planDelete(\'' + escHtml(normalizedFile) + '\')">Delete</button>' +
+    '</div>';
+    document.getElementById('modal-title').innerHTML = escHtml(title) + (versionLabel ? ' <span style="font-size:11px;font-weight:700;padding:1px 6px;border-radius:3px;background:rgba(56,139,253,0.15);color:var(--blue)">' + escHtml(versionLabel) + '</span>' : '') + lastModLabel + actionBtns;
+    document.getElementById('modal-body').textContent = text;
+    document.getElementById('modal-body').style.fontFamily = 'Consolas, monospace';
+    document.getElementById('modal-body').style.whiteSpace = 'pre-wrap';
+    _modalDocContext = { title, content: text, selection: '' };
+    _modalFilePath = resolvedPath || ((normalizedFile.endsWith('.json') ? 'prd/' : 'plans/') + normalizedFile); showModalQa();
+    // Clear notification badge when opening this document
+    const card = findCardForFile(_modalFilePath);
+    if (card) clearNotifBadge(card);
+    // steer btn removed — unified send
+    document.getElementById('modal').classList.add('open');
+  } catch (e) { console.error(e); }
+}
+
+async function planApprove(file) {
+  try {
+    await fetch('/api/plans/approve', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ file }) });
+    showToast('cmd-toast', 'Plan approved — work will begin on next engine tick', true);
+    refreshPlans();
+  } catch (e) { showToast('cmd-toast', 'Error: ' + e.message, false); }
+}
+
+async function planDelete(file) {
+  if (!confirm('Delete plan "' + file + '"? This cannot be undone.')) return;
+  try {
+    const res = await fetch('/api/plans/delete', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ file })
+    });
+    if (res.ok) {
+      closeModal();
+      showToast('cmd-toast', 'Plan deleted', true);
+      refreshPlans();
+      refresh();
+    } else {
+      const d = await res.json();
+      alert('Failed: ' + (d.error || 'unknown'));
+    }
+  } catch (e) { alert('Error: ' + e.message); }
+}
+
+async function planPause(file) {
+  try {
+    await fetch('/api/plans/pause', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ file }) });
+    showToast('cmd-toast', 'Plan paused — no new items will be dispatched', true);
+    refreshPlans();
+    refresh();
+  } catch (e) { showToast('cmd-toast', 'Error: ' + e.message, false); }
+}
+
+async function planReject(file) {
+  if (!confirm('Reject this plan? It will not be executed.')) return;
+  const reason = prompt('Reason for rejection (optional):') || '';
+  try {
+    await fetch('/api/plans/reject', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ file, reason }) });
+    showToast('cmd-toast', 'Plan rejected', true);
+    refreshPlans();
+  } catch (e) { showToast('cmd-toast', 'Error: ' + e.message, false); }
+}
+
+async function planDiscuss(file) {
+  try {
+    const res = await fetch('/api/plans/discuss', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ file })
+    });
+    const data = await res.json();
+    if (!res.ok) throw new Error(data.error);
+
+    // Show the launch command in a modal
+    const content = `To discuss and revise this plan interactively, run this command in a terminal:\n\n` +
+      `━━━ Bash / Git Bash ━━━\n${data.command}\n\n` +
+      `━━━ PowerShell ━━━\n${data.psCommand}\n\n` +
+      `━━━━━━━━━━━━━━━━━━━━━━━\n\n` +
+      `This launches an interactive Claude session with the plan pre-loaded.\n` +
+      `Chat naturally to review and refine. When you're satisfied, say "approve" and the session will write the approved plan back to disk.\n\n` +
+      `The engine will pick it up on the next tick and start dispatching work.`;
+
+    document.getElementById('modal-title').textContent = 'Discuss Plan: ' + file;
+    document.getElementById('modal-body').textContent = content;
+    document.getElementById('modal').classList.add('open');
+  } catch (e) {
+    showToast('cmd-toast', 'Error: ' + e.message, false);
+  }
+}
+
+async function planOpenInDocChat(file) {
+  try {
+    const normalizedFile = normalizePlanFile(file);
+    const planRes = await fetch('/api/plans/' + encodeURIComponent(normalizedFile));
+    const resolvedPath = planRes.headers.get('X-Resolved-Path');
+    const raw = await planRes.text();
+    let title = normalizedFile;
+    let text = raw;
+    if (normalizedFile.endsWith('.json')) {
+      try { title = JSON.parse(raw).plan_summary || file; } catch {}
+    }
+    document.getElementById('modal-title').textContent = 'Edit: ' + title;
+    document.getElementById('modal-body').textContent = text;
+    document.getElementById('modal-body').style.fontFamily = 'Consolas, monospace';
+    document.getElementById('modal-body').style.whiteSpace = 'pre-wrap';
+    _modalDocContext = { title: title, content: text, selection: '' };
+    _modalFilePath = resolvedPath || ((normalizedFile.endsWith('.json') ? 'prd/' : 'plans/') + normalizedFile); showModalQa();
+    const card = findCardForFile(_modalFilePath);
+    if (card) clearNotifBadge(card);
+    document.getElementById('modal').classList.add('open');
+  } catch (e) { alert('Error opening plan: ' + e.message); }
+}
+
+async function planRegeneratePRD(source) {
+  if (!confirm('Reset pending/failed items to pick up plan changes?\n\nIn-progress and completed items won\'t be affected.')) return;
+  try {
+    const res = await fetch('/api/plans/regenerate', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ source })
+    });
+    const d = await res.json();
+    if (res.ok && d.ok) {
+      refresh();
+      showToast('cmd-toast', 'Regenerated: ' + d.reset + ' reset, ' + d.kept + ' kept, ' + d.new + ' new', true);
+    } else {
+      alert('Failed: ' + (d.error || 'unknown'));
+    }
+  } catch (e) { alert('Error: ' + e.message); }
+}
+
+async function openVerifyGuide(file) {
+  try {
+    const normalizedFile = normalizePlanFile(file);
+    const content = await fetch('/api/plans/' + encodeURIComponent(normalizedFile)).then(r => r.text());
+    document.getElementById('modal-title').innerHTML = 'Manual Testing Guide' +
+      ' <button class="pr-pager-btn" style="font-size:9px;padding:2px 8px;margin-left:8px;vertical-align:middle" onclick="openArchivedPrdModal()">Back</button>';
+    document.getElementById('modal-body').textContent = content;
+    document.getElementById('modal-body').style.fontFamily = 'Consolas, monospace';
+    document.getElementById('modal-body').style.whiteSpace = 'pre-wrap';
+    _modalDocContext = { title: 'Manual Testing Guide', content, selection: '' };
+    _modalFilePath = 'prd/' + normalizedFile; showModalQa();
+    const card = findCardForFile(_modalFilePath);
+    if (card) clearNotifBadge(card);
+    document.getElementById('modal').classList.add('open');
+  } catch (e) { alert('Failed to load guide: ' + e.message); }
+}
+
+async function triggerVerify(file) {
+  try {
+    const res = await fetch('/api/plans/trigger-verify', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ file })
+    });
+    const d = await res.json();
+    if (res.ok && d.ok) {
+      closeModal();
+      refresh();
+      showToast('cmd-toast', d.verifyId ? 'Verify task ' + d.verifyId + ' created' : (d.message || 'Done'), true);
+    } else {
+      alert('Failed: ' + (d.error || 'unknown'));
+    }
+  } catch (e) { alert('Error: ' + e.message); }
+}

package/dashboard/js/render-prd.js

@@ -467,3 +467,223 @@ function showArchivedPrdDetail(idx) {
   document.getElementById('modal-body').style.whiteSpace = 'normal';
   document.getElementById('modal').classList.add('open');
 }
+
+async function prdItemEdit(source, itemId) {
+  const item = _prdItems.find(i => i.source === source && i.id === itemId);
+  if (!item) return;
+
+  // Look up work item and dispatch completion info
+  const wi = (window._lastWorkItems || []).find(w => w.id === itemId && w.sourcePlan === source);
+  const dispatch = window._lastStatus?.dispatch || {};
+  const completedEntry = (dispatch.completed || []).find(d =>
+    d.meta?.item?.id === itemId && d.meta?.item?.sourcePlan === source
+  );
+
+  // Build completion summary section
+  let completionHtml = '';
+  const isDone = item.status === 'done' || item.status === 'implemented' || item.status === 'complete' || item.status === 'in-pr'; // in-pr treated as done for backward compat
+  const isFailed = item.status === 'failed';
+  const isActive = item.status === 'in-progress' || item.status === 'dispatched';
+
+  if (isDone || isFailed || isActive) {
+    const agent = wi?.dispatched_to || completedEntry?.agent || '';
+    const completedAt = wi?.completedAt || completedEntry?.completed_at || '';
+    const summary = completedEntry?.resultSummary || '';
+    const prLinks = (item.prs || []).map(function(pr) {
+      return '<a href="' + escHtml(pr.url || '#') + '" target="_blank" rel="noopener" style="color:var(--green);text-decoration:underline">' + escHtml(pr.id) + '</a>';
+    }).join(', ');
+
+    const statusColor = isDone ? 'var(--green)' : isFailed ? 'var(--red)' : 'var(--blue)';
+    const statusLabel = isDone ? 'Completed' : isFailed ? 'Failed' : 'In Progress';
+
+    completionHtml = '<div style="background:var(--surface);border:1px solid var(--border);border-left:3px solid ' + statusColor + ';border-radius:4px;padding:10px 12px;margin-bottom:12px">' +
+      '<div style="display:flex;align-items:center;gap:8px;margin-bottom:6px">' +
+        '<span style="font-size:11px;font-weight:700;color:' + statusColor + '">' + statusLabel + '</span>' +
+        (agent ? '<span style="font-size:11px;color:var(--muted)">by ' + escHtml(agent) + '</span>' : '') +
+        (completedAt ? '<span style="font-size:10px;color:var(--muted)">' + escHtml(completedAt.slice(0, 16).replace('T', ' ')) + '</span>' : '') +
+      '</div>' +
+      (prLinks ? '<div style="font-size:11px;margin-bottom:6px">PR: ' + prLinks + '</div>' : '') +
+      (summary ? '<div style="font-size:12px;color:var(--text);line-height:1.5;white-space:pre-wrap;max-height:300px;overflow-y:auto">' + escHtml(summary) + '</div>' : '') +
+      (isFailed && completedEntry?.reason ? '<div style="font-size:11px;color:var(--red);margin-top:4px">' + escHtml(completedEntry.reason) + '</div>' : '') +
+    '</div>';
+  }
+
+  const html = '<div style="padding:8px 0">' +
+    completionHtml +
+    '<label style="font-size:11px;color:var(--muted);display:block;margin-bottom:4px">Name</label>' +
+    '<input id="prd-edit-name" value="' + escHtml(item.name || '') + '" style="width:100%;padding:6px 10px;background:var(--surface);border:1px solid var(--border);border-radius:4px;color:var(--text);font-size:13px;margin-bottom:10px">' +
+    '<label style="font-size:11px;color:var(--muted);display:block;margin-bottom:4px">Description</label>' +
+    '<textarea id="prd-edit-desc" rows="4" style="width:100%;padding:6px 10px;background:var(--surface);border:1px solid var(--border);border-radius:4px;color:var(--text);font-size:12px;resize:vertical;margin-bottom:10px">' + escHtml(item.description || '') + '</textarea>' +
+    '<div style="display:flex;gap:12px;margin-bottom:12px">' +
+      '<div><label style="font-size:11px;color:var(--muted);display:block;margin-bottom:4px">Priority</label>' +
+        '<select id="prd-edit-priority" style="padding:4px 8px;background:var(--surface);border:1px solid var(--border);border-radius:4px;color:var(--text)">' +
+          '<option value="high"' + (item.priority === 'high' ? ' selected' : '') + '>High</option>' +
+          '<option value="medium"' + (item.priority === 'medium' ? ' selected' : '') + '>Medium</option>' +
+          '<option value="low"' + (item.priority === 'low' ? ' selected' : '') + '>Low</option>' +
+        '</select></div>' +
+      '<div><label style="font-size:11px;color:var(--muted);display:block;margin-bottom:4px">Complexity</label>' +
+        '<select id="prd-edit-complexity" style="padding:4px 8px;background:var(--surface);border:1px solid var(--border);border-radius:4px;color:var(--text)">' +
+          '<option value="small"' + (item.complexity === 'small' ? ' selected' : '') + '>Small</option>' +
+          '<option value="medium"' + (item.complexity === 'medium' ? ' selected' : '') + '>Medium</option>' +
+          '<option value="large"' + (item.complexity === 'large' ? ' selected' : '') + '>Large</option>' +
+        '</select></div>' +
+    '</div>' +
+    '<div style="display:flex;gap:8px">' +
+      '<button class="plan-btn approve" onclick="prdItemSave(\'' + escHtml(source) + '\',\'' + escHtml(itemId) + '\')">Save</button>' +
+      '<button class="plan-btn" onclick="closeModal()">Cancel</button>' +
+      '<button class="plan-btn reject" style="margin-left:auto" onclick="prdItemRemove(\'' + escHtml(source) + '\',\'' + escHtml(itemId) + '\')">Remove Item</button>' +
+    '</div>' +
+  '</div>';
+
+  document.getElementById('modal-title').textContent = item.id + ' — ' + (item.name || '').slice(0, 60);
+  document.getElementById('modal-body').innerHTML = html;
+  document.getElementById('modal-body').style.fontFamily = '';
+  document.getElementById('modal-body').style.whiteSpace = '';
+  document.getElementById('modal').classList.add('open');
+}
+
+async function prdItemSave(source, itemId) {
+  try {
+    const res = await fetch('/api/prd-items/update', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        source, itemId,
+        name: document.getElementById('prd-edit-name').value,
+        description: document.getElementById('prd-edit-desc').value,
+        priority: document.getElementById('prd-edit-priority').value,
+        estimated_complexity: document.getElementById('prd-edit-complexity').value,
+      })
+    });
+    if (res.ok) { closeModal(); refresh(); showToast('cmd-toast', 'Item updated', true); }
+    else { const d = await res.json(); alert('Failed: ' + (d.error || 'unknown')); }
+  } catch (e) { alert('Error: ' + e.message); }
+}
+
+async function prdItemRemove(source, itemId) {
+  if (!confirm('Remove item ' + itemId + '? This also cancels any pending work item.')) return;
+  try {
+    const res = await fetch('/api/prd-items/remove', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ source, itemId })
+    });
+    if (res.ok) { closeModal(); refresh(); showToast('cmd-toast', 'Item removed', true); }
+    else { const d = await res.json(); alert('Failed: ' + (d.error || 'unknown')); }
+  } catch (e) { alert('Error: ' + e.message); }
+}
+
+async function prdItemRequeue(workItemId, source) {
+  setPrdRequeueState(workItemId, { status: 'pending', message: '' });
+  rerenderPrdFromCache();
+  try {
+    const res = await fetch('/api/work-items/retry', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ id: workItemId, source })
+    });
+    if (res.ok) {
+      setPrdRequeueState(workItemId, { status: 'queued', until: Date.now() + 10000 });
+      rerenderPrdFromCache();
+      wakeEngine();
+      refresh();
+      showToast('cmd-toast', workItemId + ' requeued', true);
+    } else {
+      const d = await res.json();
+      const msg = d.error || 'unknown';
+      setPrdRequeueState(workItemId, { status: 'error', message: msg, until: Date.now() + 10000 });
+      rerenderPrdFromCache();
+      alert('Failed: ' + msg);
+    }
+  } catch (e) {
+    setPrdRequeueState(workItemId, { status: 'error', message: e.message, until: Date.now() + 10000 });
+    rerenderPrdFromCache();
+    alert('Error: ' + e.message);
+  }
+}
+
+async function prdRegenerate(prdFile) {
+  if (!confirm('This PRD is stale because the source plan changed.\n\nRegenerate now from the latest plan?\n\nThis resets PRD status to awaiting-approval and queues a fresh plan-to-prd conversion.')) return;
+  try {
+    const res = await fetch('/api/prd/regenerate', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ file: prdFile })
+    });
+    const d = await res.json();
+    if (res.ok) {
+      showToast('cmd-toast', 'PRD regeneration queued', true);
+      refresh();
+    } else {
+      alert('Failed: ' + (d.error || 'unknown'));
+    }
+  } catch (e) { alert('Error: ' + e.message); }
+}
+
+function openArchive(i) {
+  const a = archivedPrds[i];
+  if (!a) return;
+
+  document.getElementById('modal-title').textContent = 'Archived PRD — ' + a.version + ' (' + a.total + ' items)';
+
+  let html = '<div style="font-family:\'Segoe UI\',system-ui,sans-serif;white-space:normal">';
+
+  // Summary
+  if (a.summary) {
+    html += '<div class="archive-detail-section"><h4>Summary</h4><p style="font-size:12px;color:var(--muted);line-height:1.6">' + escHtml(a.summary) + '</p></div>';
+  }
+
+  // Existing features
+  if (a.existing_features.length) {
+    html += '<div class="archive-detail-section"><h4>Existing Features (' + a.existing_features.length + ')</h4>';
+    a.existing_features.forEach(f => {
+      html += '<div class="archive-feature">' +
+        '<span class="feat-id">' + escHtml(f.id) + '</span>' +
+        '<div class="feat-name">' + escHtml(f.name) + '</div>' +
+        '<div class="feat-desc">' + escHtml(f.description || '') + '</div>' +
+        '<div class="feat-meta">' +
+          (f.agent ? '<span>Agent: ' + escHtml(f.agent) + '</span>' : '') +
+          (f.status ? '<span>Status: ' + escHtml(f.status) + '</span>' : '') +
+        '</div>' +
+      '</div>';
+    });
+    html += '</div>';
+  }
+
+  // Missing features
+  if (a.missing_features.length) {
+    html += '<div class="archive-detail-section"><h4>Gap Items (' + a.missing_features.length + ')</h4>';
+    a.missing_features.forEach(f => {
+      const pClass = f.priority === 'high' ? 'high' : f.priority === 'medium' ? 'medium' : 'low';
+      html += '<div class="archive-feature">' +
+        '<span class="feat-id">' + escHtml(f.id) + '</span> ' +
+        '<span class="prd-item-priority ' + pClass + '">' + escHtml(f.priority || '') + '</span>' +
+        (f.status ? ' <span class="pr-badge ' + (f.status === 'complete' || f.status === 'done' || f.status === 'in-pr' ? 'approved' : 'draft') + '" style="font-size:9px">' + escHtml(f.status === 'in-pr' ? 'done' : f.status) + '</span>' : '') +
+        '<div class="feat-name">' + escHtml(f.name) + '</div>' +
+        '<div class="feat-desc">' + escHtml(f.description || '') + '</div>' +
+        (f.rationale ? '<div class="feat-desc" style="margin-top:4px;color:var(--yellow)">Rationale: ' + escHtml(f.rationale) + '</div>' : '') +
+        '<div class="feat-meta">' +
+          (f.estimated_complexity ? '<span>Complexity: ' + escHtml(f.estimated_complexity) + '</span>' : '') +
+          (f.affected_areas ? '<span>Areas: ' + escHtml(f.affected_areas.join(', ')) + '</span>' : '') +
+        '</div>' +
+      '</div>';
+    });
+    html += '</div>';
+  }
+
+  // Open questions
+  if (a.open_questions.length) {
+    html += '<div class="archive-detail-section"><h4>Open Questions (' + a.open_questions.length + ')</h4>';
+    a.open_questions.forEach(q => {
+      html += '<div class="archive-question">' +
+        '<span class="q-id">' + escHtml(q.id) + '</span>' +
+        '<div class="q-text">' + escHtml(q.question) + '</div>' +
+        (q.context ? '<div class="q-context">' + escHtml(q.context) + '</div>' : '') +
+      '</div>';
+    });
+    html += '</div>';
+  }
+
+  html += '</div>';
+
+  document.getElementById('modal-body').innerHTML = html;
+  document.getElementById('modal-body').style.fontFamily = "'Segoe UI', system-ui, sans-serif";
+  document.getElementById('modal-body').style.whiteSpace = 'normal';
+  document.getElementById('modal').classList.add('open');
+}

package/dashboard/js/render-work-items.js

@@ -198,7 +198,7 @@ async function retryWorkItem(id, source) {
       method: 'POST', headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify({ id, source: source || undefined })
     });
-    if (res.ok) { refresh(); } else {
+    if (res.ok) { wakeEngine(); refresh(); } else {
       const d = await res.json();
       alert('Retry failed: ' + (d.error || 'unknown'));
     }

package/dashboard/js/settings.js

@@ -133,3 +133,23 @@ async function saveSettings() {
     status.style.color = 'var(--red)';
   }
 }
+
+async function addProject() {
+  try {
+    // Open folder picker
+    const browseRes = await fetch('/api/projects/browse', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: '{}' });
+    const browseData = await browseRes.json();
+    if (browseData.cancelled || !browseData.path) return;
+
+    // Add the project
+    const addRes = await fetch('/api/projects/add', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ path: browseData.path })
+    });
+    const addData = await addRes.json();
+    if (!addRes.ok) { alert('Failed: ' + (addData.error || 'unknown')); return; }
+
+    showToast('cmd-toast', 'Project "' + addData.name + '" added — restart engine to pick it up', true);
+    refresh();
+  } catch (e) { alert('Error: ' + e.message); }
+}

package/dashboard/js/utils.js

@@ -1,5 +1,8 @@
 // dashboard/js/utils.js — Utility functions extracted from dashboard.html
 
+// Signal the engine to tick immediately (pick up new work without waiting 60s)
+function wakeEngine() { fetch('/api/engine/wakeup', { method: 'POST' }).catch(() => {}); }
+
 function escHtml(s) {
   return String(s).replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;').replace(/'/g,'&#39;');
 }

package/dashboard-build.js

@@ -42,10 +42,11 @@ function buildDashboardHtml() {
     jsHtml += `\n// ─── ${f}.js ────────────────────────────────────────\n${content}\n`;
   }
 
+  // Use function replacer to avoid $ special patterns in String.replace
   return layout
-    .replace('/* __CSS__ */', css)
-    .replace('<!-- __PAGES__ -->', pageHtml)
-    .replace('/* __JS__ */', jsHtml);
+    .replace('/* __CSS__ */', () => css)
+    .replace('<!-- __PAGES__ -->', () => pageHtml)
+    .replace('/* __JS__ */', () => jsHtml);
 }
 
 module.exports = { buildDashboardHtml };

package/dashboard.js

@@ -54,7 +54,7 @@ function buildDashboardHtml() {
   const dashDir = path.join(MINIONS_DIR, 'dashboard');
   const layoutPath = path.join(dashDir, 'layout.html');
 
-  // Fall back to monolith if dashboard/ directory doesn't exist yet
+  // Fall back to monolith if fragments don't exist
   if (!fs.existsSync(layoutPath)) {
     return safeRead(path.join(MINIONS_DIR, 'dashboard.html')) || '';
   }
@@ -87,9 +87,9 @@ function buildDashboardHtml() {
   }
 
   return layout
-    .replace('/* __CSS__ */', css)
-    .replace('<!-- __PAGES__ -->', pageHtml)
-    .replace('/* __JS__ */', jsHtml);
+    .replace('/* __CSS__ */', () => css)
+    .replace('<!-- __PAGES__ -->', () => pageHtml)
+    .replace('/* __JS__ */', () => jsHtml);
 }
 
 const HTML_RAW = buildDashboardHtml();

package/package.json

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