@yemi33/minions 0.1.94 → 0.1.96

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## 0.1.96 (2026-04-01)
+
+### Engine
+- engine.js
+- engine/ado.js
+- engine/github.js
+- engine/queries.js
+
+### Dashboard
+- dashboard.js
+- dashboard/js/detail-panel.js
+- dashboard/js/live-stream.js
+- dashboard/js/modal-qa.js
+- dashboard/js/render-agents.js
+- dashboard/js/render-inbox.js
+- dashboard/js/render-meetings.js
+- dashboard/js/render-pinned.js
+- dashboard/js/render-work-items.js
+- dashboard/js/utils.js
+
+### Playbooks
+- meeting-conclude.md
+
+## 0.1.95 (2026-04-01)
+
+### Dashboard
+- dashboard/js/render-plans.js
+
 ## 0.1.94 (2026-04-01)
 
 ### Dashboard

package/dashboard/js/detail-panel.js

@@ -44,21 +44,21 @@ function renderDetailContent(detail, tab) {
       if (detail.statusData.completed_at) html += 'Completed: ' + detail.statusData.completed_at + '\n';
       html += '</div>';
       if (detail.statusData.resultSummary) {
-        html += '<h4>Last Result</h4><div class="section" style="border-left:3px solid var(--green);padding-left:12px">' + escHtml(detail.statusData.resultSummary) + '</div>';
+        html += '<h4>Last Result</h4><div class="section" style="border-left:3px solid var(--green);padding-left:12px">' + renderMd(detail.statusData.resultSummary) + '</div>';
       }
     }
 
     if (detail.inboxContents && detail.inboxContents.length > 0) {
       html += '<h4>Notes & Findings (' + detail.inboxContents.length + ')</h4>';
       detail.inboxContents.forEach(item => {
-        html += '<div class="section"><strong style="color:var(--purple)">' + escHtml(item.name) + '</strong>\n\n' + escHtml(item.content) + '</div>';
+        html += '<div class="section"><strong style="color:var(--purple)">' + escHtml(item.name) + '</strong><div style="margin-top:4px">' + renderMd(item.content) + '</div></div>';
       });
     } else {
       html += '<h4>Notes & Findings</h4><div class="section" style="color:var(--muted);font-style:italic">No notes or findings written yet.</div>';
     }
 
     if (detail.outputLog) {
-      html += '<h4>Latest Output</h4><div class="section">' + escHtml(detail.outputLog) + '</div>';
+      html += '<h4>Latest Output</h4><div class="section">' + renderMd(detail.outputLog) + '</div>';
     }
 
     el.innerHTML = html;
@@ -79,7 +79,7 @@ function renderDetailContent(detail, tab) {
       '</div>';
     startLiveStream(currentAgentId);
   } else if (tab === 'charter') {
-    el.innerHTML = '<div class="section">' + escHtml(detail.charter || 'No charter found.') + '</div>';
+    el.innerHTML = '<div class="section">' + renderMd(detail.charter || 'No charter found.') + '</div>';
   } else if (tab === 'history') {
     let html = '';
     // Recent dispatch results

package/dashboard/js/live-stream.js

@@ -14,7 +14,7 @@ function renderLiveChatMessage(raw) {
           el.innerHTML += '<div style="font-size:10px;color:var(--muted);padding:2px 8px;font-style:italic">\u{1F4AD} Thinking...</div>';
         }
         if (block.type === 'text' && block.text) {
-          el.innerHTML += '<div style="background:var(--surface2);padding:8px 12px;border-radius:12px 12px 12px 2px;max-width:90%;margin:4px 0;font-size:12px;white-space:pre-wrap;word-break:break-word">' + escHtml(block.text) + '</div>';
+          el.innerHTML += '<div style="background:var(--surface2);padding:8px 12px;border-radius:12px 12px 12px 2px;max-width:90%;margin:4px 0;font-size:12px;word-break:break-word">' + renderMd(block.text) + '</div>';
         }
         if (block.type === 'tool_use') {
           el.innerHTML += '<div style="background:var(--surface);border:1px solid var(--border);padding:4px 8px;border-radius:4px;margin:2px 0;font-size:10px;color:var(--muted);cursor:pointer" onclick="this.nextElementSibling.style.display=this.nextElementSibling.style.display===\'none\'?\'block\':\'none\'">' +

package/dashboard/js/modal-qa.js

@@ -201,7 +201,7 @@ async function _processQaMessage(message, selection) {
       const suffix = data.edited ? '\n\n\u2713 Document saved.' : '';
       const qaElapsed = Math.round((Date.now() - qaStartTime) / 1000);
       const qaTimeLabel = '<div style="font-size:9px;color:var(--muted);margin-top:4px;text-align:right">' + qaElapsed + 's</div>';
-      thread.innerHTML += '<div class="modal-qa-a" style="border-left-color:' + borderColor + '">' + llmCopyBtn() + escHtml(data.answer + suffix) + qaTimeLabel + '</div>';
+      thread.innerHTML += '<div class="modal-qa-a" style="border-left-color:' + borderColor + '">' + llmCopyBtn() + renderMd(data.answer + suffix) + qaTimeLabel + '</div>';
 
       // Track conversation history
       _qaHistory.push({ role: 'user', text: message });
@@ -215,7 +215,15 @@ async function _processQaMessage(message, selection) {
       // Refresh modal body if document was edited
       if (data.edited && data.content) {
         const display = data.content.replace(/^---[\s\S]*?---\n*/m, '');
-        document.getElementById('modal-body').textContent = display;
+        const isJson = capturedFilePath && capturedFilePath.endsWith('.json');
+        const body = document.getElementById('modal-body');
+        if (isJson) {
+          body.textContent = display;
+        } else {
+          body.innerHTML = '<div style="font-size:12px;line-height:1.6">' + renderMd(display) + '</div>';
+          body.style.fontFamily = "'Segoe UI', system-ui, sans-serif";
+          body.style.whiteSpace = 'normal';
+        }
         _modalDocContext.content = display;
       }
 

package/dashboard/js/render-agents.js

@@ -11,7 +11,7 @@ function renderAgents(agents) {
       </div>
       <div class="agent-role">${a.role}</div>
       <div class="agent-action" title="${escHtml(a.lastAction)}">${escHtml(a.lastAction)}</div>
-      ${a.resultSummary ? `<div class="agent-result" title="${escHtml(a.resultSummary)}">${escHtml(a.resultSummary.slice(0, 200))}${a.resultSummary.length > 200 ? '...' : ''}</div>` : ''}
+      ${a.resultSummary ? `<div class="agent-result" title="${escHtml(a.resultSummary)}">${renderMd(a.resultSummary.slice(0, 200))}${a.resultSummary.length > 200 ? '...' : ''}</div>` : ''}
     </div>
   `).join('');
 }
@@ -29,7 +29,7 @@ async function openAgentDetail(id) {
   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>' : '');
+    (agent.resultSummary ? '<div style="margin-top:4px;font-size:11px;color:var(--text);line-height:1.4">' + renderMd(agent.resultSummary.slice(0, 300)) + '</div>' : '');
 
   try {
     const detail = await fetch('/api/agent/' + id).then(r => r.json());

package/dashboard/js/render-inbox.js

@@ -55,7 +55,7 @@ function renderNotes(notes) {
   }
 
   if (!content || !content.trim()) { el.innerHTML = '<p class="empty">No team notes yet.</p>'; return; }
-  el.innerHTML = '<div class="notes-preview" onclick="openNotesModal()" title="Click to expand">' + escHtml(content) + '</div>';
+  el.innerHTML = '<div class="notes-preview" onclick="openNotesModal()" title="Click to expand">' + renderMd(content) + '</div>';
 }
 
 function openNotesModal() {

package/dashboard/js/render-meetings.js

@@ -136,10 +136,16 @@ function openMeetingDetail(id) {
           '<button class="pr-pager-btn" style="font-size:9px;padding:2px 8px;color:var(--red);border-color:var(--red)" onclick="_deleteMeeting(\'' + escHtml(m.id) + '\')">Delete</button>' +
         '</div>';
       } else if (m.status === 'completed') {
-        html += '<div style="display:flex;gap:8px;border-top:1px solid var(--border);padding-top:8px">' +
+        const linkedPlan = _findLinkedPlan(m);
+        html += '<div style="display:flex;gap:8px;flex-wrap:wrap;border-top:1px solid var(--border);padding-top:8px">' +
+          (linkedPlan
+            ? '<button class="pr-pager-btn" style="font-size:9px;padding:2px 8px;color:var(--blue);border-color:var(--blue)" onclick="_viewPlanWithBack(\'' + escHtml(linkedPlan.file) + '\',\'' + escHtml(m.id) + '\')">View Plan</button>' +
+              '<button class="pr-pager-btn" style="font-size:9px;padding:2px 8px;color:var(--green);border-color:var(--green)" onclick="_createPlanFromMeeting(\'' + escHtml(m.id) + '\',this)">New Plan</button>'
+            : '<button class="pr-pager-btn" style="font-size:9px;padding:2px 8px;color:var(--green);border-color:var(--green)" onclick="_createPlanFromMeeting(\'' + escHtml(m.id) + '\',this)">Create Plan from Meeting</button>') +
           '<button class="pr-pager-btn" style="font-size:9px;padding:2px 8px" onclick="_archiveMeeting(\'' + escHtml(m.id) + '\')">Archive</button>' +
           '<button class="pr-pager-btn" style="font-size:9px;padding:2px 8px;color:var(--red);border-color:var(--red)" onclick="_deleteMeeting(\'' + escHtml(m.id) + '\')">Delete</button>' +
-        '</div>';
+        '</div>' +
+        '<div style="font-size:9px;color:var(--muted);margin-top:4px">Use the Q&amp;A below to discuss action items' + (linkedPlan ? '' : ', then create a plan to execute them') + '.</div>';
       } else {
         html += '<div style="display:flex;gap:8px;border-top:1px solid var(--border);padding-top:8px">' +
           '<input id="meeting-note-input" type="text" placeholder="Add context for all agents..." style="flex:1;padding:6px 8px;background:var(--bg);border:1px solid var(--border);border-radius:var(--radius-sm);color:var(--text);font-size:12px" onkeydown="if(event.key===\'Enter\')_submitMeetingNote(\'' + escHtml(m.id) + '\')">' +
@@ -165,7 +171,8 @@ function openMeetingDetail(id) {
       ).join('\n\n---\n\n');
       const meetingDoc = '# Meeting: ' + m.title + '\n\n**Agenda:** ' + m.agenda + '\n\n' + transcript;
       _modalDocContext = { title: 'Meeting: ' + m.title, content: meetingDoc, selection: '' };
-      _modalFilePath = 'meetings/' + m.id + '.json';
+      // Completed/archived meetings: read-only Q&A (no file editing to avoid corrupting JSON)
+      _modalFilePath = (m.status === 'completed' || m.status === 'archived') ? null : 'meetings/' + m.id + '.json';
       try { showModalQa(); } catch { /* expected if QA not loaded */ }
 
       document.getElementById('modal').classList.add('open');
@@ -277,6 +284,102 @@ async function _unarchiveMeeting(id) {
   } catch (e) { alert('Error: ' + e.message); }
 }
 
+function _viewPlanWithBack(file, meetingId) {
+  planView(file);
+  // After modal opens, prepend a back button to return to meeting
+  setTimeout(function() {
+    const title = document.getElementById('modal-title');
+    if (title && !title.querySelector('.mtg-back-btn')) {
+      const back = document.createElement('button');
+      back.className = 'pr-pager-btn mtg-back-btn';
+      back.style.cssText = 'font-size:9px;padding:2px 8px;margin-right:8px;vertical-align:middle';
+      back.textContent = '\u2190 Back to Meeting';
+      back.onclick = function() { openMeetingDetail(meetingId); };
+      title.prepend(back);
+    }
+  }, 100);
+}
+
+function _findLinkedPlan(meeting) {
+  if (!meeting?.conclusion?.content) return null;
+  const match = meeting.conclusion.content.match(/plans\/([\w-]+\.md)/);
+  if (!match) return null;
+  const file = match[1];
+  const plans = window._lastStatus?.plans || [];
+  return plans.find(function(p) { return p.file === file; }) || { file, summary: file };
+}
+
+async function _createPlanFromMeeting(id, btn) {
+  if (btn) { btn.dataset.origText = btn.textContent; btn.textContent = 'Checking...'; btn.style.pointerEvents = 'none'; btn.style.opacity = '0.6'; }
+  function resetBtn() { if (btn) { btn.textContent = btn.dataset.origText || 'Create Plan'; btn.style.pointerEvents = ''; btn.style.opacity = ''; } }
+  try {
+    const res = await fetch('/api/meetings/' + encodeURIComponent(id));
+    const data = await res.json();
+    if (!data.meeting) { resetBtn(); alert('Meeting not found'); return; }
+    const m = data.meeting;
+
+    // Check if a plan already exists for this meeting
+    const existing = _findLinkedPlan(m);
+    if (existing) {
+      resetBtn();
+      if (!confirm('A plan already exists: "' + existing.summary + '"\n\nCreate a new one anyway?')) return;
+    }
+
+    if (btn) btn.textContent = 'Generating plan...';
+
+    // Use doc-chat to generate a structured plan from the meeting
+    const transcript = (m.transcript || []).map(function(t) {
+      return '### ' + t.agent + ' (' + t.type + ', Round ' + t.round + ')\n\n' + (t.content || '');
+    }).join('\n\n---\n\n');
+    const meetingDoc = '# Meeting: ' + m.title + '\n\n**Agenda:** ' + m.agenda + '\n\n' + transcript;
+
+    // Include Q&A thread if present
+    let humanContext = '';
+    const qaThread = document.getElementById('modal-qa-thread');
+    if (qaThread) {
+      const qaText = qaThread.innerText.trim();
+      if (qaText.length > 20) humanContext = '\n\n## Human Discussion\n\n' + qaText.slice(0, 3000);
+    }
+
+    const genRes = await fetch('/api/doc-chat', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        message: 'Create an actionable implementation plan from this meeting. Extract concrete action items from the conclusion and debates. For each item include: what to do, which files/areas to change, priority (high/medium/low), and estimated complexity (small/medium/large). Structure it as a plan ready for execution. Do NOT include preamble — start with the plan title.' + humanContext,
+        document: meetingDoc,
+        title: 'Meeting: ' + m.title,
+      })
+    });
+    const genData = await genRes.json();
+    if (!genRes.ok || !genData.ok) { resetBtn(); alert('Failed to generate plan: ' + (genData.error || 'unknown')); return; }
+
+    const planContent = genData.answer || '';
+    const title = 'Meeting follow-up: ' + (m.title || id);
+    const planRes = await fetch('/api/plans/create', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ title, content: planContent })
+    });
+    const planData = await planRes.json();
+    if (planRes.ok && planData.ok) {
+      showToast('cmd-toast', 'Plan created: ' + planData.file, true);
+      if (btn) {
+        btn.textContent = 'Plan created';
+        btn.style.color = 'var(--green)';
+        btn.style.borderColor = 'var(--green)';
+        btn.style.opacity = '1';
+        const viewLink = document.createElement('button');
+        viewLink.className = 'pr-pager-btn';
+        viewLink.style.cssText = 'font-size:9px;padding:2px 8px;color:var(--blue);border-color:var(--blue);pointer-events:auto';
+        viewLink.textContent = 'View Plan';
+        viewLink.onclick = function() { _viewPlanWithBack(planData.file, id); };
+        btn.parentElement.insertBefore(viewLink, btn.nextSibling);
+      }
+    } else {
+      resetBtn();
+      alert('Failed: ' + (planData.error || 'unknown'));
+    }
+  } catch (e) { resetBtn(); alert('Error: ' + e.message); }
+}
+
 async function _deleteMeeting(id) {
   if (!confirm('Delete this meeting? This cannot be undone.')) return;
   try {

package/dashboard/js/render-pinned.js

@@ -15,7 +15,7 @@ function renderPinned(entries) {
         '<strong style="font-size:var(--text-md)">' + escHtml(e.title) + '</strong>' +
         '<button class="pr-pager-btn" style="font-size:9px;padding:1px 6px;color:var(--red);border-color:var(--red)" onclick="removePinnedNote(\'' + escHtml(e.title) + '\')">Unpin</button>' +
       '</div>' +
-      '<div style="font-size:var(--text-sm);color:var(--muted);margin-top:4px">' + escHtml(e.content.slice(0, 200)) + '</div>' +
+      '<div style="font-size:var(--text-sm);color:var(--muted);margin-top:4px">' + renderMd(e.content.slice(0, 200)) + '</div>' +
     '</div>'
   ).join('');
 }

package/dashboard/js/render-plans.js

@@ -80,9 +80,14 @@ function derivePlanStatus(prdFile, mdFile, prdJsonStatus, workItems) {
   if (allDone && !hasActiveWork) return 'completed';
   if (hasActiveWork || hasPendingPrd) return 'in-progress';
   if (hasFailed && !hasActiveWork) return 'has-failures';
+
   if (prdJsonStatus === 'awaiting-approval' && implementWi.length === 0) return 'awaiting-approval';
   if (prdJsonStatus === 'approved' && implementWi.length === 0) return 'approved';
 
+  // plan-to-prd conversion done but no implement items and PRD is gone — truly completed
+  const prdConversionDone = wi.some(w => w.type === 'plan-to-prd' && w.status === 'done');
+  if (prdConversionDone && implementWi.length === 0) return 'completed';
+
   return prdJsonStatus || 'active';
 }
 
@@ -172,7 +177,14 @@ function renderPlans(plans) {
     if (prdFile && p.format !== 'prd') {
       const linkedPrd = plans.find(pp => pp.file === prdFile && pp.format === 'prd');
       if (linkedPrd) prdJsonStatus = linkedPrd.status || prdJsonStatus;
+      // If the linked PRD was archived, treat the .md plan as completed
+      else if (!linkedPrd) {
+        const archivedPrd = archivedPlans.find(pp => pp.file === prdFile && pp.format === 'prd');
+        if (archivedPrd) prdJsonStatus = 'completed';
+      }
     }
+    // 'converted' means plan-to-PRD succeeded — treat as 'approved' for status derivation
+    if (prdJsonStatus === 'converted') prdJsonStatus = prdFile ? 'approved' : 'completed';
 
     // Single source of truth: derive status from work items
     const effectiveStatus = isArchived ? 'completed' : derivePlanStatus(prdFile, p.file, prdJsonStatus, allWi);
@@ -180,7 +192,8 @@ function renderPlans(plans) {
     const statusLabelsMap = {
       'completed': 'Completed', 'in-progress': 'In Progress', 'paused': 'Paused',
       'awaiting-approval': 'Awaiting Approval', 'approved': 'Approved', 'rejected': 'Rejected',
-      'revision-requested': 'Revision Requested', 'has-failures': 'Has Failures', 'active': 'Active'
+      'revision-requested': 'Revision Requested', 'has-failures': 'Has Failures', 'active': 'Active',
+      'converted': 'Converted to PRD', 'draft': 'Draft'
     };
     const label = statusLabelsMap[effectiveStatus] || effectiveStatus;
     const needsAction = (effectiveStatus === 'awaiting-approval' || effectiveStatus === 'paused') && !isArchived;
@@ -222,6 +235,10 @@ function renderPlans(plans) {
       : '';
     const verifyBtn = showVerify ? '<button class="pr-pager-btn" style="font-size:9px;padding:2px 8px;color:var(--green)" ' +
       'onclick="event.stopPropagation();triggerVerify(\'' + escHtml(prdFile) + '\',this)">Verify</button>' : '';
+    const showArchive = !isArchived;
+    const archiveFile = prdFile || p.file;
+    const archiveBtn = showArchive ? '<button class="pr-pager-btn" style="font-size:9px;padding:2px 8px" ' +
+      'onclick="event.stopPropagation();planArchive(\'' + escHtml(archiveFile) + '\',this)">Archive</button>' : '';
     const deleteBtn = !isArchived ? '<button class="pr-pager-btn" style="font-size:9px;padding:2px 8px;color:var(--red)" ' +
       'onclick="event.stopPropagation();planDelete(\'' + escHtml(p.file) + '\')">Delete</button>' : '';
 
@@ -238,7 +255,7 @@ function renderPlans(plans) {
             (p.updatedAt ? '<span title="Last updated: ' + p.updatedAt + '">Updated ' + timeAgo(p.updatedAt) + '</span>' : '') +
             (p.completedAt ? '<span>' + p.completedAt.slice(0, 10) + '</span>' : '') +
             (p.generatedBy ? '<span>by ' + escHtml(p.generatedBy) + '</span>' : '') +
-            executeBtn + pauseBtn + resumeBtn + verifyBtn + deleteBtn +
+            executeBtn + pauseBtn + resumeBtn + verifyBtn + archiveBtn + deleteBtn +
           '</div>' +
         '</div>' +
       '</div>' +
@@ -432,11 +449,12 @@ async function planView(file) {
     const isPaused = planStatus === 'awaiting-approval' || planStatus === 'paused';
     // Check if work is in progress for this plan
     const wi = window._lastWorkItems || [];
+    // Find the linked PRD for this .md plan (if any)
+    const linkedPrdFile = isMdPlan ? (window._lastStatus?.plans || []).find(p => p.sourcePlan === normalizedFile && p.format === 'prd')?.file : null;
     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')))
+        (linkedPrdFile && w.sourcePlan === linkedPrdFile))
     );
     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)
@@ -454,9 +472,12 @@ async function planView(file) {
     const modalVerifyBtn = isModalCompleted ? '<button class="pr-pager-btn" style="font-size:10px;padding:2px 10px;color:var(--green)" ' +
       'onclick="triggerVerify(\'' + escHtml(normalizedFile) + '\',this)">Verify</button>' : '';
 
+    const modalArchiveBtn = '<button class="pr-pager-btn" style="font-size:10px;padding:2px 10px;color:var(--muted)" ' +
+      'onclick="planArchive(\'' + escHtml(normalizedFile) + '\')">Archive</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 || '') + (modalVerifyBtn || '') +
+      ' ' + modalArchiveBtn +
       ' <button class="pr-pager-btn" style="font-size:10px;padding:2px 10px;color:var(--red)" ' +
       'onclick="planDelete(\'' + escHtml(normalizedFile) + '\')">Delete</button>' +
     '</div>';
@@ -516,23 +537,27 @@ async function planDelete(file) {
   } catch (e) { alert('Error: ' + e.message); }
 }
 
-async function planArchive(file) {
-  if (!confirm('Archive PRD "' + file + '"? Work items will be preserved.')) return;
+async function planArchive(file, btn) {
+  if (btn) { btn.dataset.origText = btn.textContent; btn.textContent = 'Archiving...'; btn.style.pointerEvents = 'none'; btn.style.opacity = '0.6'; }
+  function resetBtn() { if (btn) { btn.textContent = btn.dataset.origText || 'Archive'; btn.style.pointerEvents = ''; btn.style.opacity = ''; } }
   try {
     const res = await fetch('/api/plans/archive', {
       method: 'POST', headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify({ file })
     });
-    if (res.ok) {
-      closeModal();
-      showToast('cmd-toast', 'PRD archived', true);
+    const ct = res.headers.get('content-type') || '';
+    if (!ct.includes('json')) { resetBtn(); alert('Archive failed — dashboard may need a restart'); return; }
+    const d = await res.json().catch(() => ({}));
+    if (res.ok && d.ok) {
+      try { closeModal(); } catch { /* may not be open */ }
+      showToast('cmd-toast', 'Archived' + (file.endsWith('.json') ? ' PRD and source plan' : ''), true);
       refreshPlans();
       refresh();
     } else {
-      const d = await res.json();
+      resetBtn();
       alert('Archive failed: ' + (d.error || 'unknown'));
     }
-  } catch (e) { alert('Error: ' + e.message); }
+  } catch (e) { resetBtn(); alert('Error: ' + e.message); }
 }
 
 async function planPause(file, btn) {
@@ -674,4 +699,26 @@ async function triggerVerify(file, btn) {
   } catch (e) { if (btn) { btn.textContent = btn.dataset.origText || 'Verify'; btn.style.pointerEvents = ''; btn.style.opacity = ''; } alert('Error: ' + e.message); }
 }
 
-window.MinionsPlans = { openCreatePlanModal, refreshPlans, derivePlanStatus, renderPlans, openArchivedPlansModal, qaDisablePrdButtons, showPlanVersionActions, qaJustSave, planExecute, planSubmitRevise, planShowRevise, planHideRevise, planView, planApprove, planArchive, planDelete, planPause, planReject, planDiscuss, planOpenInDocChat, planRegeneratePRD, openVerifyGuide, triggerVerify };
+async function planUnarchive(file, btn) {
+  if (btn) { btn.dataset.origText = btn.textContent; btn.textContent = 'Restoring...'; btn.style.pointerEvents = 'none'; btn.style.opacity = '0.6'; }
+  function resetBtn() { if (btn) { btn.textContent = btn.dataset.origText || 'Unarchive'; btn.style.pointerEvents = ''; btn.style.opacity = ''; } }
+  try {
+    const res = await fetch('/api/plans/unarchive', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ file })
+    });
+    const ct = res.headers.get('content-type') || '';
+    if (!ct.includes('json')) { resetBtn(); alert('Unarchive failed — dashboard may need a restart'); return; }
+    const d = await res.json().catch(() => ({}));
+    if (res.ok && d.ok) {
+      showToast('cmd-toast', 'Restored from archive', true);
+      refreshPlans();
+      refresh();
+    } else {
+      resetBtn();
+      alert('Unarchive failed: ' + (d.error || 'unknown'));
+    }
+  } catch (e) { resetBtn(); alert('Error: ' + e.message); }
+}
+
+window.MinionsPlans = { openCreatePlanModal, refreshPlans, derivePlanStatus, renderPlans, openArchivedPlansModal, qaDisablePrdButtons, showPlanVersionActions, qaJustSave, planExecute, planSubmitRevise, planShowRevise, planHideRevise, planView, planApprove, planArchive, planUnarchive, planDelete, planPause, planReject, planDiscuss, planOpenInDocChat, planRegeneratePRD, openVerifyGuide, triggerVerify };

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

@@ -2,7 +2,7 @@
 
 let allWorkItems = [];
 let wiPage = 0;
-const WI_PER_PAGE = 6;
+const WI_PER_PAGE = 20;
 
 function wiRow(item) {
   const statusBadge = (s) => {
@@ -23,7 +23,7 @@ function wiRow(item) {
     '<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>' : '') +
+      (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 || '') + '\',this)">Retry</button>' : '') +
     '</td>' +
     '<td>' +
       (item.completedAgents && item.completedAgents.length > 0
@@ -210,17 +210,23 @@ async function toggleWorkItemArchive() {
   } catch (e) { el.innerHTML = '<p class="empty">Failed to load archive.</p>'; }
 }
 
-async function retryWorkItem(id, source) {
+async function retryWorkItem(id, source, btn) {
+  if (btn) { btn.dataset.origText = btn.textContent; btn.textContent = 'Retrying...'; btn.style.pointerEvents = 'none'; btn.style.opacity = '0.6'; }
   try {
     const res = await fetch('/api/work-items/retry', {
       method: 'POST', headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify({ id, source: source || undefined })
     });
-    if (res.ok) { wakeEngine(); refresh(); } else {
-      const d = await res.json();
+    if (res.ok) {
+      showToast('cmd-toast', 'Work item ' + id + ' reset to pending', true);
+      wakeEngine();
+      refresh();
+    } else {
+      if (btn) { btn.textContent = btn.dataset.origText || 'Retry'; btn.style.pointerEvents = ''; btn.style.opacity = ''; }
+      const d = await res.json().catch(() => ({}));
       alert('Retry failed: ' + (d.error || 'unknown'));
     }
-  } catch (e) { alert('Retry error: ' + e.message); }
+  } catch (e) { if (btn) { btn.textContent = btn.dataset.origText || 'Retry'; btn.style.pointerEvents = ''; btn.style.opacity = ''; } alert('Retry error: ' + e.message); }
 }
 
 function wiPrev() { if (wiPage > 0) { wiPage--; renderWorkItems(allWorkItems); } }
@@ -365,7 +371,7 @@ function openWorkItemDetail(id) {
     '<span class="dispatch-type ' + (item.type || 'implement') + '">' + escHtml(item.type || 'implement') + '</span>' +
     '<span class="prd-item-priority ' + (item.priority || '') + '">' + escHtml(item.priority || 'medium') + '</span>' +
     '</div>';
-  html += field('Description', '<div style="white-space:pre-wrap;font-size:12px">' + escHtml(item.description || item.title || '—') + '</div>');
+  html += field('Description', '<div style="font-size:12px">' + renderMd(item.description || item.title || '—') + '</div>');
   html += field('Agent', escHtml(item.dispatched_to || item.agent || 'Auto'));
   html += field('Source', escHtml(item._source || 'central'));
   if (item.created) html += field('Created', escHtml(new Date(item.created).toLocaleString()));

package/dashboard/js/utils.js

@@ -41,4 +41,118 @@ function copyLlmText(btn) {
   setTimeout(() => { btn.innerHTML = '⎘'; }, 1500);
 }
 
-window.MinionsUtils = { wakeEngine, escHtml, normalizePlanFile, timeAgo, statusColor, llmCopyBtn, copyLlmText };
+/**
+ * Lightweight markdown → HTML renderer. XSS-safe (escapes first, then transforms).
+ * Handles: headings, bold, italic, inline code, code blocks, links, blockquotes,
+ * horizontal rules, ordered/unordered/checkbox lists, and tables.
+ */
+function renderMd(s) {
+  if (!s) return '';
+  let html = escHtml(s);
+
+  // 1. Extract code blocks and inline code into placeholders (protect from other transforms)
+  const codeSlots = [];
+  html = html.replace(/```(\w*)\n([\s\S]*?)```/g, function(_, lang, code) {
+    codeSlots.push('<pre style="background:var(--bg);padding:8px;border-radius:4px;overflow-x:auto;font-size:11px;margin:4px 0"><code>' + code + '</code></pre>');
+    return '\x00CB' + (codeSlots.length - 1) + '\x00';
+  });
+  html = html.replace(/`([^`\n]+)`/g, function(_, code) {
+    codeSlots.push('<code style="background:var(--bg);padding:1px 4px;border-radius:3px;font-size:0.9em">' + code + '</code>');
+    return '\x00CB' + (codeSlots.length - 1) + '\x00';
+  });
+
+  // 2. Inline transforms (before block processing so they work inside list items etc.)
+  html = html.replace(/\*\*(.+?)\*\*/g, '<strong>$1</strong>');
+  html = html.replace(/__(.+?)__/g, '<strong>$1</strong>');
+  html = html.replace(/(?<!\w)\*([^*\n]+)\*(?!\w)/g, '<em>$1</em>');
+  html = html.replace(/(?<!\w)_([^_\n]+)_(?!\w)/g, '<em>$1</em>');
+  html = html.replace(/~~(.+?)~~/g, '<s>$1</s>');
+  html = html.replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2" target="_blank" style="color:var(--blue)">$1</a>');
+
+  // 3. Block-level processing (line by line)
+  var lines = html.split('\n');
+  var out = [];
+  var inList = false;
+  var listType = '';
+
+  function closeList() { if (inList) { out.push(listType === 'ol' ? '</ol>' : '</ul>'); inList = false; } }
+  function openList(type) {
+    if (inList && listType !== type) closeList();
+    if (!inList) {
+      var style = type === 'ol' ? 'margin:2px 0 2px 20px;padding:0' : type === 'cb' ? 'margin:2px 0 2px 16px;padding:0;list-style:none' : 'margin:2px 0 2px 16px;padding:0';
+      out.push('<' + (type === 'ol' ? 'ol' : 'ul') + ' style="' + style + '">');
+      inList = true; listType = type === 'cb' ? 'ul' : type;
+    }
+  }
+
+  for (var i = 0; i < lines.length; i++) {
+    var line = lines[i];
+
+    // Code block placeholder — pass through as-is
+    if (line.match(/^\x00CB\d+\x00$/)) { closeList(); out.push(line); continue; }
+
+    // Headings
+    var headMatch = line.match(/^(#{1,4})\s+(.+)/);
+    if (headMatch) {
+      closeList();
+      var sizes = { 1: '16px', 2: '14px', 3: '13px', 4: '12px' };
+      out.push('<div style="font-weight:600;font-size:' + sizes[headMatch[1].length] + ';margin:8px 0 4px">' + headMatch[2] + '</div>');
+      continue;
+    }
+
+    // Horizontal rule (only bare ---, ***, ___ lines)
+    if (/^[-*_]{3,}\s*$/.test(line) && !/\S/.test(line.replace(/[-*_]/g, ''))) {
+      closeList();
+      out.push('<hr style="border:none;border-top:1px solid var(--border);margin:8px 0">');
+      continue;
+    }
+
+    // Blockquote
+    if (line.match(/^&gt;\s?/)) {
+      closeList();
+      out.push('<div style="border-left:3px solid var(--border);padding-left:8px;color:var(--muted);margin:2px 0">' + line.replace(/^(&gt;\s?)+/, '') + '</div>');
+      continue;
+    }
+
+    // Checkbox list (must come before UL — both start with - )
+    var cbMatch = line.match(/^(\s*)[-*]\s\[([ xX])\]\s(.+)/);
+    if (cbMatch) {
+      openList('cb');
+      out.push('<li>' + (cbMatch[2] !== ' ' ? '\u2611' : '\u2610') + ' ' + cbMatch[3] + '</li>');
+      continue;
+    }
+
+    // Unordered list (- or * followed by space and content, not bare --- or ***)
+    var ulMatch = line.match(/^(\s*)[-*]\s+(.+)/);
+    if (ulMatch) {
+      openList('ul');
+      out.push('<li>' + ulMatch[2] + '</li>');
+      continue;
+    }
+
+    // Ordered list
+    var olMatch = line.match(/^(\s*)\d+\.\s+(.+)/);
+    if (olMatch) {
+      openList('ol');
+      out.push('<li>' + olMatch[2] + '</li>');
+      continue;
+    }
+
+    // Non-list line — close any open list
+    closeList();
+
+    // Blank line → spacer
+    if (!line.trim()) { out.push('<div style="height:4px"></div>'); continue; }
+
+    out.push('<div>' + line + '</div>');
+  }
+  closeList();
+  html = out.join('\n');
+
+  // 4. Restore code placeholders
+  html = html.replace(/\x00CB(\d+)\x00/g, function(_, idx) { return codeSlots[idx]; });
+
+  return html;
+}
+
+window.MinionsUtils = { wakeEngine, escHtml, renderMd, normalizePlanFile, timeAgo, statusColor, llmCopyBtn, copyLlmText };

package/dashboard.js

@@ -2082,17 +2082,61 @@ If nothing to do, return: { "duplicates": [], "reclassify": [], "remove": [] }`;
       fs.renameSync(planPath, archivePath);
 
       // Mark archived in JSON if PRD
+      let archivedSource = null;
       if (body.file.endsWith('.json')) {
         try {
           const prd = JSON.parse(safeRead(archivePath) || '{}');
           prd.status = 'archived';
           prd.archivedAt = new Date().toISOString();
           safeWrite(archivePath, prd);
+          // Also archive linked source plan
+          if (prd.source_plan) {
+            const mdPath = path.join(PLANS_DIR, prd.source_plan);
+            if (fs.existsSync(mdPath)) {
+              const planArchive = path.join(PLANS_DIR, 'archive');
+              if (!fs.existsSync(planArchive)) fs.mkdirSync(planArchive, { recursive: true });
+              fs.renameSync(mdPath, path.join(planArchive, prd.source_plan));
+              archivedSource = prd.source_plan;
+            }
+          }
+        } catch { /* optional */ }
+      }
+
+      invalidateStatusCache();
+      return jsonReply(res, 200, { ok: true, archived: body.file, archivedSource });
+    } catch (e) { return jsonReply(res, 400, { error: e.message }); }
+  }
+
+  async function handlePlansUnarchive(req, res) {
+    try {
+      const body = await readBody(req);
+      if (!body.file) return jsonReply(res, 400, { error: 'file required' });
+      if (body.file.includes('..') || body.file.includes('\0') || body.file.includes('/') || body.file.includes('\\')) {
+        return jsonReply(res, 400, { error: 'invalid filename' });
+      }
+      const isJson = body.file.endsWith('.json');
+      const targetDir = isJson ? PRD_DIR : PLANS_DIR;
+      const archivePath = path.join(targetDir, 'archive', body.file);
+      if (!fs.existsSync(archivePath)) return jsonReply(res, 404, { error: 'File not found in archive' });
+      fs.renameSync(archivePath, path.join(targetDir, body.file));
+
+      // Also unarchive linked source plan
+      let unarchivedSource = null;
+      if (isJson) {
+        try {
+          const prd = safeJson(path.join(targetDir, body.file));
+          if (prd?.source_plan) {
+            const mdArchivePath = path.join(PLANS_DIR, 'archive', prd.source_plan);
+            if (fs.existsSync(mdArchivePath)) {
+              fs.renameSync(mdArchivePath, path.join(PLANS_DIR, prd.source_plan));
+              unarchivedSource = prd.source_plan;
+            }
+          }
         } catch { /* optional */ }
       }
 
       invalidateStatusCache();
-      return jsonReply(res, 200, { ok: true, archived: body.file });
+      return jsonReply(res, 200, { ok: true, unarchivedSource });
     } catch (e) { return jsonReply(res, 400, { error: e.message }); }
   }
 
@@ -3115,6 +3159,7 @@ What would you like to discuss or change? When you're happy, say "approve" and I
     { method: 'POST', path: '/api/plans/regenerate', desc: 'Reset pending/failed work items for a plan so they re-materialize', params: 'source', handler: handlePlansRegenerate },
     { method: 'POST', path: '/api/plans/delete', desc: 'Delete a plan file and clean up work items', params: 'file', handler: handlePlansDelete },
     { method: 'POST', path: '/api/plans/archive', desc: 'Move a plan/PRD to archive (preserves work items)', params: 'file', handler: handlePlansArchive },
+    { method: 'POST', path: '/api/plans/unarchive', desc: 'Restore a plan/PRD from archive', params: 'file', handler: handlePlansUnarchive },
     { method: 'POST', path: '/api/plans/revise', desc: 'Request revision with feedback, dispatches agent to revise', params: 'file, feedback, requestedBy?', handler: handlePlansRevise },
     { method: 'POST', path: '/api/plans/discuss', desc: 'Generate a plan discussion session script for Claude CLI', params: 'file', handler: handlePlansDiscuss },
     { method: 'GET', path: /^\/api\/plans\/archive\/([^?]+)$/, desc: 'Read an archived plan file', handler: handlePlansArchiveRead },

package/engine/ado.js

@@ -344,8 +344,8 @@ async function reconcilePrs(config) {
       const branch = (adoPr.sourceRefName || '').replace('refs/heads/', '');
       const title = adoPr.title || '';
       // Extract item ID from branch name or PR title (e.g., feat(P-2cafdc2a): ...)
-      const branchMatch = branch.match(/(P-[a-f0-9]{6,})/i) || branch.match(/(PL-W\d+)/i);
-      const titleMatch = title.match(/\((P-[a-f0-9]{6,})\)/) || title.match(/\((PL-W\d+)\)/);
+      const branchMatch = branch.match(/(P-[a-z0-9]{6,})/i) || branch.match(/(PL-W\d+)/i);
+      const titleMatch = title.match(/\((P-[a-z0-9]{6,})\)/) || title.match(/\((PL-W\d+)\)/);
       const linkedItemId = branchMatch?.[1] || titleMatch?.[1] || null;
       const linkedItem = linkedItemId ? allItems.find(i => i.id === linkedItemId) : null;
       const confirmedItemId = linkedItem ? linkedItemId : null;
@@ -368,7 +368,7 @@ async function reconcilePrs(config) {
       existingPrs.push({
         id: prId,
         title: (adoPr.title || `PR #${adoPr.pullRequestId}`).slice(0, 120),
-        agent: (adoPr.createdBy?.displayName || 'unknown').toLowerCase(),
+        agent: (linkedItem?.dispatched_to || adoPr.createdBy?.displayName || 'unknown').toLowerCase(),
         branch,
         reviewStatus: 'pending',
         status: 'active',

package/engine/github.js

@@ -334,7 +334,7 @@ async function reconcilePrs(config) {
     for (const ghPr of ghPrs) {
       const prId = `PR-${ghPr.number}`;
       const branch = ghPr.head?.ref || '';
-      const wiMatch = branch.match(/(P-[a-f0-9]{6,})/i) || branch.match(/(PL-W\d+)/i);
+      const wiMatch = branch.match(/(P-[a-z0-9]{6,})/i) || branch.match(/(PL-W\d+)/i);
       const linkedItemId = wiMatch ? wiMatch[1] : null;
       const linkedItem = linkedItemId ? allItems.find(i => i.id === linkedItemId) : null;
       const confirmedItemId = linkedItem ? linkedItemId : null;
@@ -356,7 +356,7 @@ async function reconcilePrs(config) {
       existingPrs.push({
         id: prId,
         title: (ghPr.title || `PR #${ghPr.number}`).slice(0, 120),
-        agent: (ghPr.user?.login || 'unknown').toLowerCase(),
+        agent: (linkedItem?.dispatched_to || ghPr.user?.login || 'unknown').toLowerCase(),
         branch,
         reviewStatus: 'pending',
         status: 'active',

package/engine/queries.js

@@ -187,6 +187,16 @@ function getAgents(config) {
     ? config.agents
     : shared.DEFAULT_AGENTS;
   const roster = Object.entries(agents).map(([id, info]) => ({ id, ...info }));
+
+  // Include temp agents that are currently active so they show up in agent tiles
+  const dispatch = getDispatch();
+  const seen = new Set(roster.map(a => a.id));
+  for (const d of (dispatch.active || [])) {
+    if (d.agent && d.agent.startsWith('temp-') && !seen.has(d.agent)) {
+      roster.push({ id: d.agent, name: d.agentName || d.agent, role: d.agentRole || 'Temp Agent', emoji: '\u{1F4A8}', skills: [], _temp: true });
+      seen.add(d.agent);
+    }
+  }
   const allInboxFiles = safeReadDir(INBOX_DIR);
 
   return roster.map(a => {

package/engine.js

@@ -262,7 +262,10 @@ function spawnAgent(dispatchItem, config) {
   const startedAt = ts();
 
   // Resolve project context for this dispatch
-  const project = meta?.project || getProjects(config)[0] || {};
+  // meta.project has {name, localPath} — enrich with full config (mainBranch, repoHost, etc.)
+  const metaProject = meta?.project || {};
+  const fullProject = getProjects(config).find(p => p.name === metaProject.name || p.localPath === metaProject.localPath) || getProjects(config)[0] || {};
+  const project = { ...fullProject, ...metaProject };
   const rootDir = project.localPath ? path.resolve(project.localPath) : path.resolve(MINIONS_DIR, '..');
 
   // Determine working directory
@@ -318,47 +321,61 @@ function spawnAgent(dispatchItem, config) {
             }
           } else {
             log('info', `Creating worktree: ${worktreePath} on branch ${branchName}`);
+            const mainRef = sanitizeBranch(project.mainBranch || 'main');
             try {
-              runWorktreeAdd(rootDir, worktreePath, `-b "${branchName}" ${sanitizeBranch(project.mainBranch || 'main')}`, _worktreeGitOpts, worktreeCreateRetries);
+              runWorktreeAdd(rootDir, worktreePath, `-b "${branchName}" ${mainRef}`, _worktreeGitOpts, worktreeCreateRetries);
             } catch (e1) {
-              // Branch already exists or checked out elsewhere — try without -b
-              try { exec(`git fetch origin "${branchName}"`, { ..._gitOpts, cwd: rootDir }); } catch (e) { log('warn', 'git: ' + e.message); }
-              try {
-                runWorktreeAdd(rootDir, worktreePath, `"${branchName}"`, _worktreeGitOpts, worktreeCreateRetries);
-                log('info', `Reusing existing branch: ${branchName}`);
-              } catch (e2) {
-                // "already checked out" or "already used by worktree" — find and reuse or recover
-                const alreadyUsed = e2.message?.includes('already checked out') || e2.message?.includes('already used by worktree')
-                  || e1.message?.includes('already checked out') || e1.message?.includes('already used by worktree');
-                if (alreadyUsed) {
-                  const existingWtPath = findExistingWorktree(rootDir, branchName);
-                  if (existingWtPath && fs.existsSync(existingWtPath)) {
-                    // Directory exists — reuse it if no other active dispatch is using it
-                    const dispatch = safeJson(DISPATCH_PATH) || {};
-                    const activelyUsed = (dispatch.active || []).some(d => {
-                      const dBranch = d.meta?.branch ? sanitizeBranch(d.meta.branch) : '';
-                      return dBranch === branchName && d.id !== id;
-                    });
-                    if (activelyUsed) {
-                      log('warn', `Branch ${branchName} actively used by another agent at ${existingWtPath} — cannot create worktree`);
-                      throw e2;
+              const branchExists = e1.message?.includes('already exists');
+              log('warn', `Worktree -b failed for ${branchName}: ${e1.message?.split('\n')[0]}`);
+              if (!branchExists) {
+                // Transient error (lock, timeout) — prune, clean, and retry -b once more
+                log('info', `Retrying -b create after prune for ${branchName}`);
+                try { exec(`git worktree prune`, { ..._gitOpts, cwd: rootDir, timeout: 15000 }); } catch { /* optional */ }
+                removeStaleIndexLock(rootDir);
+                // Clean up partial worktree directory from failed attempt
+                try { if (fs.existsSync(worktreePath)) fs.rmSync(worktreePath, { recursive: true, force: true }); } catch { /* optional */ }
+                try {
+                  runWorktreeAdd(rootDir, worktreePath, `-b "${branchName}" ${mainRef}`, _worktreeGitOpts, 0);
+                } catch (e1b) {
+                  log('error', `Worktree -b retry also failed for ${branchName}: ${e1b.message?.split('\n')[0]}`);
+                  throw e1b;
+                }
+              } else {
+                // Branch already exists — try checkout without -b
+                try { exec(`git fetch origin "${branchName}"`, { ..._gitOpts, cwd: rootDir }); } catch (e) { log('warn', 'git: ' + e.message); }
+                try {
+                  runWorktreeAdd(rootDir, worktreePath, `"${branchName}"`, _worktreeGitOpts, worktreeCreateRetries);
+                  log('info', `Reusing existing branch: ${branchName}`);
+                } catch (e2) {
+                  // "already checked out" or "already used by worktree" — find and reuse or recover
+                  const alreadyUsed = e2.message?.includes('already checked out') || e2.message?.includes('already used by worktree')
+                    || e1.message?.includes('already checked out') || e1.message?.includes('already used by worktree');
+                  if (alreadyUsed) {
+                    const existingWtPath = findExistingWorktree(rootDir, branchName);
+                    if (existingWtPath && fs.existsSync(existingWtPath)) {
+                      const dispatch = safeJson(DISPATCH_PATH) || {};
+                      const activelyUsed = (dispatch.active || []).some(d => {
+                        const dBranch = d.meta?.branch ? sanitizeBranch(d.meta.branch) : '';
+                        return dBranch === branchName && d.id !== id;
+                      });
+                      if (activelyUsed) {
+                        log('warn', `Branch ${branchName} actively used by another agent at ${existingWtPath} — cannot create worktree`);
+                        throw e2;
+                      }
+                      log('info', `Branch ${branchName} already checked out at ${existingWtPath} — reusing`);
+                      worktreePath = existingWtPath;
+                    } else if (existingWtPath && !fs.existsSync(existingWtPath)) {
+                      log('warn', `Branch ${branchName} tracked in missing dir ${existingWtPath} — pruning and recreating`);
+                      try { exec(`git worktree prune`, { ..._gitOpts, cwd: rootDir, timeout: 10000 }); } catch (e) { log('warn', 'git: ' + e.message); }
+                      runWorktreeAdd(rootDir, worktreePath, `"${branchName}"`, _worktreeGitOpts, worktreeCreateRetries);
+                      log('info', `Recovered worktree for ${branchName} after stale entry prune`);
+                    } else {
+                      try { exec(`git worktree prune`, { ..._gitOpts, cwd: rootDir, timeout: 10000 }); } catch (e) { log('warn', 'git: ' + e.message); }
+                      runWorktreeAdd(rootDir, worktreePath, `"${branchName}"`, _worktreeGitOpts, worktreeCreateRetries);
                     }
-                    // Reuse the existing worktree — update path so the rest of spawnAgent uses it
-                    log('info', `Branch ${branchName} already checked out at ${existingWtPath} — reusing`);
-                    worktreePath = existingWtPath;
-                  } else if (existingWtPath && !fs.existsSync(existingWtPath)) {
-                    // Directory gone but git still tracks it — prune and recreate
-                    log('warn', `Branch ${branchName} tracked in missing dir ${existingWtPath} — pruning and recreating`);
-                    try { exec(`git worktree prune`, { ..._gitOpts, cwd: rootDir, timeout: 10000 }); } catch (e) { log('warn', 'git: ' + e.message); }
-                    runWorktreeAdd(rootDir, worktreePath, `"${branchName}"`, _worktreeGitOpts, worktreeCreateRetries);
-                    log('info', `Recovered worktree for ${branchName} after stale entry prune`);
                   } else {
-                    // Can't find the worktree at all — prune and retry
-                    try { exec(`git worktree prune`, { ..._gitOpts, cwd: rootDir, timeout: 10000 }); } catch (e) { log('warn', 'git: ' + e.message); }
-                    runWorktreeAdd(rootDir, worktreePath, `"${branchName}"`, _worktreeGitOpts, worktreeCreateRetries);
+                    throw e2;
                   }
-                } else {
-                  throw e2;
                 }
               }
             }
@@ -1378,6 +1395,7 @@ function discoverFromWorkItems(config, project) {
       safeWrite(projectWorkItemsPath(project), items);
     }
     if (isAlreadyDispatched(key)) {
+      if (item.status === 'pending') { item.status = 'dispatched'; needsWrite = true; }
       if (item._pendingReason !== 'already_dispatched') { item._pendingReason = 'already_dispatched'; needsWrite = true; }
       skipped.gated++; continue;
     }

package/package.json

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

package/playbooks/meeting-conclude.md

@@ -24,12 +24,52 @@ You are {{agent_name}} ({{agent_role}}), synthesizing the team meeting results.
 
 ## Your Task
 
-Write a clear meeting conclusion:
+Write a clear meeting conclusion covering:
 
 1. **Areas of consensus** — what does the team agree on?
 2. **Unresolved disagreements** — where do positions still differ?
 3. **Recommended decision** — what should we do?
-4. **Action items** — specific next steps with owners
+4. **Action items** — specific next steps with owners (leave empty if none)
 5. **Open questions** — what still needs human input?
 
 Be decisive. If there's a clear best option, say so.
+
+## Plan Creation (conditional)
+
+After writing the conclusion, decide: **are there concrete action items that require implementation work?**
+
+- **If YES** — write a plan file to `plans/<slugified-meeting-title>-<YYYY-MM-DD>.md` using the Minions plan format below. Only create this file if there are real, actionable implementation tasks — not just discussion points or observations.
+
+- **If NO** — do not create a plan file. A conclusion with only open questions, observations, or decisions that require no code/implementation changes does not need a plan.
+
+### Plan format (only if action items exist)
+
+```markdown
+# <Plan Title>
+
+> Source: Meeting {{meeting_title}} — <date>
+
+## Background
+
+<1-2 sentence summary of why this plan exists, from the meeting conclusion>
+
+## Tasks
+
+### 1. <Task title>
+- **What**: <what needs to be done>
+- **Why**: <from the meeting — what problem does this fix>
+- **Owner**: <agent role best suited: Engineer / Architect / Analyst>
+- **Files**: <relevant files if known>
+
+### 2. <Task title>
+...
+
+## Open Questions
+
+<Any unresolved items that need human input before work begins>
+```
+
+Do NOT create a plan for:
+- Informational findings with no follow-up work
+- Decisions that have already been made and require no changes
+- Items that are purely "monitor and observe"