@yemi33/minions 0.1.140 → 0.1.142

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 0.1.142 (2026-04-01)
+
+### Engine
+- engine/cleanup.js
+
+### Dashboard
+- dashboard.js
+- dashboard/js/render-meetings.js
+- dashboard/js/render-plans.js
+
+### Playbooks
+- build-and-test.md
+- explore.md
+- fix.md
+- implement.md
+- test.md
+- work-item.md
+
+## 0.1.141 (2026-04-01)
+
+### Dashboard
+- dashboard/pages/pipelines.html
+- dashboard/pages/schedule.html
+
 ## 0.1.140 (2026-04-01)
 
 ### Dashboard

package/dashboard/js/render-meetings.js

@@ -87,12 +87,15 @@ function _toggleArchivedMeetings() {
   refresh();
 }
 
-function openMeetingDetail(id) {
-  fetch('/api/meetings/' + encodeURIComponent(id))
-    .then(r => r.json())
-    .then(data => {
-      if (!data.meeting) { alert('Meeting not found'); return; }
-      const m = data.meeting;
+let _meetingPollInterval = null;
+let _meetingPollId = null;
+
+function _stopMeetingPoll() {
+  if (_meetingPollInterval) { clearInterval(_meetingPollInterval); _meetingPollInterval = null; }
+  _meetingPollId = null;
+}
+
+function _renderMeetingDetail(m) {
       const statusColors = { investigating: 'var(--blue)', debating: 'var(--purple,#a855f7)', concluding: 'var(--yellow)', completed: 'var(--green)' };
       const statusLabels = { investigating: 'Round 1 — Investigating', debating: 'Round 2 — Debating', concluding: 'Round 3 — Concluding', completed: 'Completed' };
 
@@ -182,9 +185,12 @@ function openMeetingDetail(id) {
       html += '</div>';
 
       document.getElementById('modal-title').textContent = 'Meeting: ' + m.title;
-      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';
+      var body = document.getElementById('modal-body');
+      var scrollTop = body.scrollTop;
+      body.innerHTML = html;
+      body.style.fontFamily = "'Segoe UI', system-ui, sans-serif";
+      body.style.whiteSpace = 'normal';
+      body.scrollTop = scrollTop;
 
       // Wire up doc-chat Q&A panel for the meeting transcript
       const transcript = (m.transcript || []).map(t =>
@@ -192,11 +198,33 @@ 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: '' };
-      // 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';
+      // Always set filePath so doc-chat detects this as a meeting (uses Sonnet with tools).
+      // Server-side handleDocChat prevents writes to completed meeting JSON.
+      _modalFilePath = 'meetings/' + m.id + '.json';
       try { showModalQa(); } catch { /* expected if QA not loaded */ }
 
       document.getElementById('modal').classList.add('open');
+}
+
+function openMeetingDetail(id) {
+  _stopMeetingPoll();
+  fetch('/api/meetings/' + encodeURIComponent(id))
+    .then(r => r.json())
+    .then(data => {
+      if (!data.meeting) { alert('Meeting not found'); return; }
+      _renderMeetingDetail(data.meeting);
+
+      // Live-poll while modal is open
+      _meetingPollId = id;
+      _meetingPollInterval = setInterval(function() {
+        if (!document.getElementById('modal')?.classList?.contains('open') || _meetingPollId !== id) {
+          _stopMeetingPoll(); return;
+        }
+        fetch('/api/meetings/' + encodeURIComponent(id))
+          .then(r => r.json())
+          .then(d => { if (d.meeting && _meetingPollId === id) _renderMeetingDetail(d.meeting); })
+          .catch(function() {});
+      }, 3000);
     })
     .catch(e => alert('Error: ' + e.message));
 }
@@ -310,6 +338,7 @@ async function _unarchiveMeeting(id) {
 }
 
 function _viewPlanWithBack(file, meetingId) {
+  _stopMeetingPoll();
   planView(file);
   // After modal opens, prepend a back button to return to meeting
   setTimeout(function() {

package/dashboard/js/render-plans.js

@@ -403,100 +403,121 @@ function planHideRevise(file) {
   document.getElementById(id).style.display = 'none';
 }
 
+let _planPollInterval = null;
+let _planPollFile = null;
+
+function _stopPlanPoll() {
+  if (_planPollInterval) { clearInterval(_planPollInterval); _planPollInterval = null; }
+  _planPollFile = null;
+}
+
+function _renderPlanModal(normalizedFile, raw, lastMod) {
+  let title = normalizedFile;
+  let text = '';
+
+  if (normalizedFile.endsWith('.json')) {
+    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 ? ' \u2192 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 => '\u2022 ' + q).join('\n') : '');
+  } else {
+    text = raw;
+    const titleMatch = raw.match(/^#\s+(?:Plan:\s*)?(.+)/m);
+    if (titleMatch) title = titleMatch[1];
+  }
+
+  const vMatch = normalizedFile.match(/-v(\d+)/);
+  const versionLabel = vMatch ? ' (v' + vMatch[1] + ')' : '';
+  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';
+  const wi = window._lastWorkItems || [];
+  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 ||
+      (linkedPrdFile && w.sourcePlan === linkedPrdFile))
+  );
+  const prdCompleted = wi.some(w => w.type === 'plan-to-prd' && w.status === 'done' && w.planFile === normalizedFile);
+  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) + '\',this)">Pause</button>' : '';
+  const modalResumeBtn = isPaused ? '<button class="pr-pager-btn" style="font-size:10px;padding:2px 10px;color:var(--green)" ' +
+    'onclick="planApprove(\'' + escHtml(normalizedFile) + '\',this)">Resume</button>' : '';
+  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>';
+
+  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;
+  const modalBody = document.getElementById('modal-body');
+  const scrollTop = modalBody.scrollTop;
+  if (normalizedFile.endsWith('.json')) {
+    modalBody.textContent = text;
+    modalBody.style.fontFamily = 'Consolas, monospace';
+    modalBody.style.whiteSpace = 'pre-wrap';
+  } else {
+    modalBody.innerHTML = renderMd(text);
+  }
+  modalBody.scrollTop = scrollTop;
+
+  return { title, text };
+}
+
 async function planView(file) {
+  _stopPlanPoll();
   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];
-    }
+    const { title, text } = _renderPlanModal(normalizedFile, raw, lastMod);
 
-    // 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 || [];
-    // 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 ||
-        (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)
-    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) + '\',this)">Pause</button>' : '';
-    const modalResumeBtn = isPaused ? '<button class="pr-pager-btn" style="font-size:10px;padding:2px 10px;color:var(--green)" ' +
-      'onclick="planApprove(\'' + escHtml(normalizedFile) + '\',this)">Resume</button>' : '';
-    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>';
-    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;
-    const modalBody = document.getElementById('modal-body');
-    if (normalizedFile.endsWith('.json')) {
-      modalBody.textContent = text;
-      modalBody.style.fontFamily = 'Consolas, monospace';
-      modalBody.style.whiteSpace = 'pre-wrap';
-    } else {
-      modalBody.innerHTML = renderMd(text);
-    }
     _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');
+
+    // Live-poll while modal is open
+    _planPollFile = normalizedFile;
+    _planPollInterval = setInterval(function() {
+      if (!document.getElementById('modal')?.classList?.contains('open') || _planPollFile !== normalizedFile) {
+        _stopPlanPoll(); return;
+      }
+      fetch('/api/plans/' + encodeURIComponent(normalizedFile))
+        .then(function(r) { return r.text().then(function(raw) { return { raw: raw, lastMod: r.headers.get('Last-Modified') }; }); })
+        .then(function(d) { if (_planPollFile === normalizedFile) _renderPlanModal(normalizedFile, d.raw, d.lastMod); })
+        .catch(function() {});
+    }, 3000);
   } catch (e) { console.error(e); }
 }
 
@@ -517,6 +538,7 @@ async function planApprove(file, btn) {
 }
 
 async function planDelete(file) {
+  _stopPlanPoll();
   if (!confirm('Delete plan "' + file + '"? This cannot be undone.')) return;
   try {
     const res = await fetch('/api/plans/delete', {
@@ -536,6 +558,7 @@ async function planDelete(file) {
 }
 
 async function planArchive(file, btn) {
+  _stopPlanPoll();
   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 {

package/dashboard/pages/pipelines.html

@@ -1,7 +1,7 @@
 <section>
   <h2>Pipelines <span class="count" id="pipelines-count">0</span>
     <button class="pr-pager-btn" style="font-size:9px;padding:1px 6px;color:var(--green);border-color:var(--green);margin-left:8px" onclick="openCreatePipelineModal()">+ New Pipeline</button>
-    <span style="font-size:10px;color:var(--muted);font-weight:400;text-transform:none;letter-spacing:0">custom multi-stage workflows — e.g. audit → meeting → plan → merge, or any sequence you define</span>
+    <span style="font-size:10px;color:var(--muted);font-weight:400;text-transform:none;letter-spacing:0">multi-stage workflows with dependencies — chain meetings, plans, tasks, merges in any order, on a schedule or manual</span>
   </h2>
   <div id="pipelines-content"><p class="empty">No pipelines yet. Create one to chain stages like audit → meeting → plan → merge.</p></div>
 </section>

package/dashboard/pages/schedule.html

@@ -1,7 +1,7 @@
       <section id="scheduled-section">
         <h2>Scheduled Tasks <span class="count" id="scheduled-count">0</span>
           <button class="pr-pager-btn" style="font-size:9px;padding:1px 6px;color:var(--green);border-color:var(--green);margin-left:8px" onclick="openCreateScheduleModal()">+ New</button>
-          <span style="font-size:10px;color:var(--muted);font-weight:400;text-transform:none;letter-spacing:0">cron-style recurring tasks dispatched automatically</span>
+          <span style="font-size:10px;color:var(--muted);font-weight:400;text-transform:none;letter-spacing:0">single recurring tasks on a cron — for multi-step workflows, use Pipelines</span>
         </h2>
         <div id="scheduled-content"><p class="empty">No scheduled tasks. Add one to automate recurring work.</p></div>
       </section>

package/dashboard.js

@@ -644,6 +644,7 @@ async function ccDocCall({ message, document, title, filePath, selection, canEdi
   });
 
   if (result.code !== 0 || !result.text) {
+    console.error(`[doc-chat] Failed: code=${result.code}, empty=${!result.text}, filePath=${filePath}, model=${isRich ? 'sonnet' : 'haiku'}, stderr=${(result.stderr || '').slice(0, 200)}`);
     return { answer: 'Failed to process request. Try again.', content: null, actions: [] };
   }
 
@@ -2525,6 +2526,16 @@ What would you like to discuss or change? When you're happy, say "approve" and I
         }
       }
       if (canEdit && fullPath) {
+        // Block writes to completed/archived meeting JSON files
+        if (body.filePath && /^meetings\//.test(body.filePath) && isJson) {
+          try {
+            const mtg = safeJson(fullPath);
+            if (mtg && (mtg.status === 'completed' || mtg.status === 'archived')) {
+              return jsonReply(res, 200, { ok: true, answer, edited: false, actions });
+            }
+          } catch { /* proceed with write if can't read */ }
+        }
+
         safeWrite(fullPath, content);
 
         // If editing a plan .md that has an active PRD, auto-pause execution

package/engine/cleanup.js

@@ -79,8 +79,14 @@ function runCleanup(config, verbose = false) {
     const root = project.localPath ? path.resolve(project.localPath) : null;
     if (!root || !fs.existsSync(root)) continue;
 
-    const worktreeRoot = path.resolve(root, config.engine?.worktreeRoot || '../worktrees');
-    if (!fs.existsSync(worktreeRoot)) continue;
+    // Scan all potential worktree locations: configured root + common project-local dirs
+    const worktreeRoots = new Set();
+    const configuredRoot = path.resolve(root, config.engine?.worktreeRoot || '../worktrees');
+    if (fs.existsSync(configuredRoot)) worktreeRoots.add(configuredRoot);
+    const localDirs = ['worktrees', '.claude/worktrees'].map(d => path.join(root, d));
+    for (const d of localDirs) { if (fs.existsSync(d)) worktreeRoots.add(d); }
+
+    for (const worktreeRoot of worktreeRoots) {
 
     // Get PRs for this project
     const prs = safeJson(projectPrPath(project)) || [];
@@ -94,13 +100,30 @@ function runCleanup(config, verbose = false) {
     // List worktrees — collect info for age-based + cap-based cleanup
     const MAX_WORKTREES = 10;
     try {
-      const dirs = fs.readdirSync(worktreeRoot);
+      // Collect all worktree directories (including nested ones like minions-work/P-xxx)
+      const allDirs = [];
+      const topDirs = fs.readdirSync(worktreeRoot);
+      for (const dir of topDirs) {
+        const dirPath = path.join(worktreeRoot, dir);
+        try { if (!fs.statSync(dirPath).isDirectory()) continue; } catch { continue; }
+        // Check if this is a git worktree (has .git file) or a parent directory
+        if (fs.existsSync(path.join(dirPath, '.git'))) {
+          allDirs.push({ dir, wtPath: dirPath });
+        } else {
+          // Scan subdirectories for worktrees
+          try {
+            for (const sub of fs.readdirSync(dirPath)) {
+              const subPath = path.join(dirPath, sub);
+              try { if (fs.statSync(subPath).isDirectory()) allDirs.push({ dir: dir + '/' + sub, wtPath: subPath }); } catch { /* skip */ }
+            }
+          } catch { /* skip */ }
+        }
+      }
+
       const wtEntries = []; // { dir, wtPath, mtime, shouldClean, isProtected }
       const dispatch = getDispatch();
 
-      for (const dir of dirs) {
-        const wtPath = path.join(worktreeRoot, dir);
-        try { if (!fs.statSync(wtPath).isDirectory()) continue; } catch { continue; }
+      for (const { dir, wtPath } of allDirs) {
 
         let shouldClean = false;
         let isProtected = false;
@@ -189,6 +212,7 @@ function runCleanup(config, verbose = false) {
         }
       }
     } catch (e) { log('warn', 'cleanup worktrees: ' + e.message); }
+    } // end worktreeRoots loop
   }
 
   // 4. Kill zombie claude processes not tracked by the engine

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yemi33/minions",
-  "version": "0.1.140",
+  "version": "0.1.142",
   "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/build-and-test.md

@@ -19,12 +19,7 @@ Your job is to **check out the branch, build it, run tests, and if it's a webapp
 
 ### 1. Set up a worktree for the PR branch
 
-```bash
-cd {{project_path}}
-git fetch origin {{pr_branch}}
-git worktree add ../worktrees/bt-{{pr_number}} origin/{{pr_branch}}
-cd ../worktrees/bt-{{pr_number}}
-```
+You are already in the correct working directory on branch `{{pr_branch}}`. Do NOT create additional worktrees.
 
 ### 2. Install dependencies
 

package/playbooks/explore.md

@@ -42,12 +42,11 @@ Write your findings to `{{team_root}}/notes/inbox/{{agent_id}}-explore-{{task_id
 
 ### 5. Create Deliverable (if the task asks for one)
 If the task asks you to write a design doc, architecture doc, or any durable artifact:
-1. Create a git worktree: `git worktree add ../worktrees/explore-{{task_id}} -b feat/{{task_id}}-<short-desc> {{main_branch}}`
-2. Write the document (e.g., `docs/design-<topic>.md`)
-3. Commit, push, and create a PR:
+1. Write the document in the current working directory (e.g., `docs/design-<topic>.md`)
+2. Commit, push, and create a PR:
    {{pr_create_instructions}}
-4. Clean up worktree when done
 
+Do NOT create additional worktrees — the engine handles worktree management.
 If the task is purely exploratory (no deliverable requested), skip this step.
 
 ### 6. Status

package/playbooks/fix.md

@@ -17,14 +17,7 @@ Branch: `{{pr_branch}}`
 
 ## How to Fix
 
-1. Create or enter the worktree (this checks out the existing PR branch, not creating a new one):
-   ```bash
-   cd {{team_root}}
-   git fetch origin {{pr_branch}}
-   git worktree add ../worktrees/{{pr_branch}} {{pr_branch}} 2>/dev/null || true
-   cd ../worktrees/{{pr_branch}}
-   git pull origin {{pr_branch}}
-   ```
+1. You are already in the correct worktree on branch `{{pr_branch}}`. Do NOT create additional worktrees.
 
 2. Fix each issue listed above
 
@@ -35,11 +28,7 @@ Branch: `{{pr_branch}}`
    git push
    ```
 
-4. Clean up:
-   ```bash
-   cd {{team_root}}
-   git worktree remove ../worktrees/{{pr_branch}} --force
-   ```
+Do NOT remove the worktree — the engine handles cleanup automatically.
 
 ## Handling Merge Conflicts
 If you encounter merge conflicts (e.g., during `git pull` or when the PR shows conflicts):

package/playbooks/implement.md

@@ -34,15 +34,11 @@ If this feature spans multiple projects, you may need to:
 2. Follow existing patterns exactly — check `agents/create-agent/` or the closest comparable agent
 3. Follow the project's logging and coding conventions (check CLAUDE.md)
 
-## Git Workflow (WORKTREE — CRITICAL)
+## Git Workflow
 
-```bash
-cd {{team_root}}
-git worktree add ../worktrees/{{branch_name}} -b {{branch_name}} {{main_branch}}
-cd ../worktrees/{{branch_name}}
-```
+You are already running in a git worktree on branch `{{branch_name}}`. Do NOT create additional worktrees — the engine pre-created one for you.
 
-Do ALL work in the worktree. When done:
+When done:
 
 ```bash
 git add <specific files>
@@ -50,11 +46,7 @@ git commit -m "{{commit_message}}"
 git push -u origin {{branch_name}}
 ```
 
-Then return and clean up:
-```bash
-cd {{team_root}}
-git worktree remove ../worktrees/{{branch_name}} --force
-```
+Do NOT remove the worktree — the engine handles cleanup automatically.
 
 ## Create PR (MANDATORY)
 

package/playbooks/test.md

@@ -20,12 +20,7 @@ Team root: {{team_root}}
 This is a **test/build/run task**. Your goal is to build, run, test, or verify something — NOT to create new features or PRs.
 
 1. **Navigate** to the correct project directory
-2. **If the task references a branch or PR**, check it out in a worktree:
-   ```bash
-   cd {{project_path}}
-   git worktree add ../worktrees/test-{{item_id}} <branch-name>
-   cd ../worktrees/test-{{item_id}}
-   ```
+2. You are already in the correct working directory. If you need a specific branch, use `git checkout` — do NOT create additional worktrees.
 3. **Build** the project — follow the repo's build instructions (check CLAUDE.md, package.json, README)
 4. **Run** if the task asks for it (e.g., `yarn start`, `yarn dev`, docker-compose, etc.)
 5. **Test** if the task asks for it (e.g., `yarn test`, `pytest`, etc.)
@@ -66,10 +61,4 @@ Include:
 
 **Note:** Do NOT write to `agents/*/status.json` — the engine manages your status automatically.
 
-## Cleanup
-
-If you created a worktree, clean it up when done:
-```bash
-cd {{project_path}}
-git worktree remove ../worktrees/test-{{item_id}} --force
-```
+Do NOT remove worktrees — the engine handles cleanup automatically.

package/playbooks/work-item.md

@@ -24,19 +24,14 @@ Keep branch names lowercase, use hyphens, max 60 chars.
 
 1. **Understand the task** — read the description carefully, explore relevant code
 2. **Navigate** to the correct project directory: `{{project_path}}`
-3. **Create a worktree** for your changes:
-   ```bash
-   cd {{project_path}}
-   git worktree add ../worktrees/feat-{{item_id}} -b feat/{{item_id}}-<short-desc> {{main_branch}}
-   cd ../worktrees/feat-{{item_id}}
-   ```
+3. You are already in a worktree on branch `{{branch_name}}`. Do NOT create additional worktrees.
 4. **Implement** the changes
 5. **Build and verify** — ensure the build passes. If it fails, fix and retry (up to 3 times)
 6. **Commit and push**:
    ```bash
-   git add -A
+   git add <specific files>
    git commit -m "feat({{item_id}}): <description>"
-   git push -u origin feat/{{item_id}}-<short-desc>
+   git push -u origin {{branch_name}}
    ```
 7. **Create a PR:**
    {{pr_create_instructions}}
@@ -49,11 +44,7 @@ Keep branch names lowercase, use hyphens, max 60 chars.
    ```json
    { "id": "PR-<number>", "title": "...", "agent": "{{agent_name}}", "branch": "...", "reviewStatus": "pending", "status": "active", "created": "<date>", "url": "<pr-url>", "prdItems": ["{{item_id}}"] }
    ```
-10. **Clean up worktree**:
-    ```bash
-    cd {{project_path}}
-    git worktree remove ../worktrees/feat-{{item_id}} --force
-    ```
+10. Do NOT remove the worktree — the engine handles cleanup automatically.
 
 ## After Completion