@yemi33/minions 0.1.824 → 0.1.826

package/CHANGELOG.md

@@ -1,8 +1,12 @@
 # Changelog
 
-## 0.1.824 (2026-04-11)
+## 0.1.826 (2026-04-11)
+
+### Features
+-  stale PRD shows Regenerate PRD + Resume as-is buttons
 
 ### Fixes
+-  hide conflicting action buttons when stale PRD banner is showing
 -  diff-aware plan-to-prd triggered by Resume, not auto-dispatch
 
 ## 0.1.823 (2026-04-11)

package/dashboard/js/render-prd.js

@@ -30,8 +30,9 @@ function renderPrd(prd, prog) {
     const prdStatus = existing[0]?.status || '';
     const effectiveStatus = allDone && !hasActive ? 'completed' : hasActive ? 'dispatched' : prdStatus || 'active';
 
+    const headerStale = existing[0]?.planStale || prdItems.some(i => i.planStale);
     let actions = '';
-    if (prdFile) {
+    if (prdFile && !headerStale) {
       if (effectiveStatus === 'awaiting-approval') {
         actions = ' <button class="pr-pager-btn" style="font-size:9px;padding:1px 6px;color:var(--green);border-color:var(--green);margin-left:4px" onclick="planApprove(\'' + escHtml(prdFile) + '\',this)">Approve</button>';
       } else if (effectiveStatus === 'completed') {
@@ -269,19 +270,22 @@ function renderPrdProgress(prog) {
     const staleRecovery = (!isBlocked && g.planStale)
       ? '<div style="width:100%;margin-top:4px;padding:6px 8px;border:1px solid rgba(210,153,34,0.35);border-radius:4px;background:rgba(210,153,34,0.08);display:flex;align-items:center;gap:8px;flex-wrap:wrap">' +
           '<span style="color:var(--orange);font-size:10px;font-weight:600">&#x26A0;&#xFE0F; Source plan was revised. This PRD may be outdated.</span>' +
-          '<span onclick="event.stopPropagation();prdRegenerate(\'' + escHtml(g.file) + '\')" style="color:var(--green);cursor:pointer;font-size:10px;font-weight:700;padding:2px 8px;background:rgba(63,185,80,0.12);border:1px solid rgba(63,185,80,0.35);border-radius:4px" title="Regenerate PRD from latest plan">Regenerate now</span>' +
+          '<span onclick="event.stopPropagation();prdRegenerate(\'' + escHtml(g.file) + '\')" style="color:var(--green);cursor:pointer;font-size:10px;font-weight:700;padding:2px 8px;background:rgba(63,185,80,0.12);border:1px solid rgba(63,185,80,0.35);border-radius:4px" title="Compare revised plan against existing PRD and update items">Regenerate PRD</span>' +
+          '<span onclick="event.stopPropagation();prdResumeWithoutRegen(\'' + escHtml(g.file) + '\')" style="color:var(--muted);cursor:pointer;font-size:10px;padding:2px 8px;background:var(--surface);border:1px solid var(--border);border-radius:4px" title="Resume without regenerating — use current PRD as-is">Resume as-is</span>' +
           '<span onclick="event.stopPropagation();planView(\'' + escHtml(g.sourcePlan || g.file) + '\')" style="color:var(--blue);cursor:pointer;font-size:10px;padding:2px 8px;background:rgba(56,139,253,0.1);border:1px solid rgba(56,139,253,0.3);border-radius:4px" title="Review latest plan changes">Review plan</span>' +
         '</div>'
       : '';
     const isCompleted = done > 0 && done === g.items.length;
-    const pauseResumeBtn = isAwaitingApproval
+    // Hide regular action buttons when stale banner is showing — stale banner has its own actions
+    const isStale = !isBlocked && g.planStale;
+    const pauseResumeBtn = isStale ? '' : isAwaitingApproval
       ? '<span onclick="event.stopPropagation();planApprove(\'' + escHtml(g.file) + '\',this)" style="color:var(--green);cursor:pointer;font-size:9px;padding:1px 6px;background:rgba(63,185,80,0.1);border:1px solid rgba(63,185,80,0.3);border-radius:3px">Approve</span>'
       : isPaused
         ? '<span onclick="event.stopPropagation();planApprove(\'' + escHtml(g.file) + '\',this)" style="color:var(--green);cursor:pointer;font-size:9px;padding:1px 6px;background:rgba(63,185,80,0.1);border:1px solid rgba(63,185,80,0.3);border-radius:3px">Resume</span>'
         : isCompleted && !(window._lastWorkItems || []).some(w => w.itemType === 'verify' && w.sourcePlan === g.file)
           ? '<span onclick="event.stopPropagation();triggerVerify(\'' + escHtml(g.file) + '\',this)" style="color:var(--green);cursor:pointer;font-size:9px;padding:1px 6px;background:rgba(63,185,80,0.1);border:1px solid rgba(63,185,80,0.3);border-radius:3px">Verify</span>'
           : isCompleted ? '' : '<span onclick="event.stopPropagation();planPause(\'' + escHtml(g.file) + '\',this)" style="color:var(--yellow);cursor:pointer;font-size:9px;padding:1px 6px;background:rgba(210,153,34,0.1);border:1px solid rgba(210,153,34,0.3);border-radius:3px">Pause</span>';
-    const archiveBtn = (isCompleted || isPaused) ? '<span onclick="event.stopPropagation();planArchive(\'' + escHtml(g.file) + '\',this)" style="color:var(--muted);cursor:pointer;font-size:9px;padding:1px 6px;background:rgba(139,148,158,0.1);border:1px solid rgba(139,148,158,0.3);border-radius:3px">Archive</span>' : '';
+    const archiveBtn = (!isStale && (isCompleted || isPaused)) ? '<span onclick="event.stopPropagation();planArchive(\'' + escHtml(g.file) + '\',this)" style="color:var(--muted);cursor:pointer;font-size:9px;padding:1px 6px;background:rgba(139,148,158,0.1);border:1px solid rgba(139,148,158,0.3);border-radius:3px">Archive</span>' : '';
     const deleteBtn = '<span onclick="event.stopPropagation();planDelete(\'' + escHtml(g.file) + '\')" style="color:var(--red);cursor:pointer;font-size:9px;padding:1px 6px;background:rgba(248,81,73,0.1);border:1px solid rgba(248,81,73,0.3);border-radius:3px">Delete</span>';
     const sourcePlanLink = g.sourcePlan
       ? '<span onclick="event.stopPropagation();planView(\'' + escHtml(g.sourcePlan) + '\')" style="color:var(--blue);cursor:pointer;font-size:9px;padding:1px 6px;background:rgba(56,139,253,0.1);border:1px solid rgba(56,139,253,0.3);border-radius:3px" title="View source plan">&#x1F4C4; Plan</span>'
@@ -763,15 +767,32 @@ async function prdItemRequeue(workItemId, source, prdFile) {
 }
 
 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;
+  if (!confirm('Source plan was revised.\n\nRegenerate PRD? An agent will compare the updated plan against existing implementation and update items accordingly.\n\nDone items stay done unless modified. New items are added. Removed items are cancelled.')) return;
   try {
-    const res = await fetch('/api/prd/regenerate', {
+    const res = await fetch('/api/plans/approve', {
       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);
+      showToast('cmd-toast', d.diffAwareUpdate ? 'Diff-aware PRD update queued' : 'Plan approved', true);
+      refresh();
+    } else {
+      alert('Failed: ' + (d.error || 'unknown'));
+    }
+  } catch (e) { alert('Error: ' + e.message); }
+}
+
+async function prdResumeWithoutRegen(prdFile) {
+  if (!confirm('Resume this plan without regenerating the PRD?\n\nThe current PRD items will be used as-is. New work items will be materialized from any missing/planned items.')) return;
+  try {
+    const res = await fetch('/api/plans/approve', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ file: prdFile, skipRegen: true })
+    });
+    const d = await res.json();
+    if (res.ok) {
+      showToast('cmd-toast', 'Plan resumed (PRD unchanged)', true);
       refresh();
     } else {
       alert('Failed: ' + (d.error || 'unknown'));

package/dashboard.js

@@ -2183,6 +2183,7 @@ If nothing to do: { "duplicates": [], "reclassify": [], "remove": [] }`;
       if (!body.file) return jsonReply(res, 400, { error: 'file required' });
       const planPath = resolvePlanPath(body.file);
       const plan = safeJsonObj(planPath);
+      const wasStale = !!plan.planStale;
       plan.status = 'approved';
       plan.approvedAt = new Date().toISOString();
       plan.approvedBy = body.approvedBy || os.userInfo().username;
@@ -2227,55 +2228,52 @@ If nothing to do: { "duplicates": [], "reclassify": [], "remove": [] }`;
         }, { defaultValue: { pending: [], active: [], completed: [] } });
       }
 
-      // Diff-aware PRD update: if plan has done work and a source_plan .md, dispatch plan-to-prd
-      // to compare the revised plan against existing implementation
+      // Diff-aware PRD update: if plan was stale (source .md revised), dispatch plan-to-prd
+      // to compare the revised plan against existing PRD and produce an updated version
       let diffAwareQueued = false;
-      if (plan.source_plan && plan.missing_features) {
+      if (plan.source_plan && plan.missing_features && wasStale && !body.skipRegen) {
         const config = queries.getConfig();
         const allWorkItems = queries.getWorkItems(config);
         const planWis = allWorkItems.filter(w => w.sourcePlan === body.file && w.itemType !== 'pr' && w.itemType !== 'verify');
-        const doneWis = planWis.filter(w => shared.DONE_STATUSES.has(w.status));
-        if (doneWis.length > 0) {
-          const allPrs = PROJECTS.flatMap(p => shared.safeJson(shared.projectPrPath(p)) || []);
-          const prLinks = shared.getPrLinks();
-          const implContext = (plan.missing_features || []).map(f => {
-            const wi = planWis.find(w => w.id === f.id);
-            const pr = allPrs.find(p => prLinks[p.id] === f.id || (p.prdItems || []).includes(f.id));
-            return `- **${f.id}**: ${f.name} [status: ${wi?.status || f.status}]${pr ? ` (PR: ${pr.id}, branch: \`${pr.branch}\`)` : ''}`;
-          }).join('\n');
-
-          const projectName = plan.project || body.file.replace(/-\d{4}-\d{2}-\d{2}\.json$/, '');
-          const targetProject = PROJECTS.find(p => p.name?.toLowerCase() === projectName.toLowerCase()) || PROJECTS[0];
-          if (targetProject) {
-            const centralWiPath = path.join(MINIONS_DIR, 'work-items.json');
-            mutateJsonFileLocked(centralWiPath, items => {
-              if (!Array.isArray(items)) items = [];
-              if (items.some(w => w.type === 'plan-to-prd' && w.planFile === plan.source_plan && (w.status === 'pending' || w.status === 'dispatched'))) return items;
-              items.push({
-                id: 'W-' + shared.uid(),
-                title: `Update PRD from revised plan: ${plan.source_plan}`,
-                type: 'plan-to-prd',
-                priority: 'high',
-                description: `Plan file: plans/${plan.source_plan}\nPRD file: prd/${body.file}\n\n` +
-                  `Source plan was revised. Compare the updated plan against existing implementation and update the PRD.\n\n` +
-                  `**Existing implementation state:**\n${implContext}\n\n` +
-                  `**Rules for updating:**\n` +
-                  `- Items that are done and unchanged in the plan → keep status "done" (preserve their ID)\n` +
-                  `- Items that are done but modified in the plan (new requirements) → set status "updated" (engine will re-open)\n` +
-                  `- New items in the plan → set status "missing" (engine will materialize)\n` +
-                  `- Items removed from the plan → drop from PRD (engine will cancel pending WIs)\n` +
-                  `- Preserve all existing item IDs for unchanged/modified items — do NOT generate new IDs for them`,
-                status: 'pending',
-                created: new Date().toISOString(),
-                createdBy: 'dashboard:plan-resume',
-                project: targetProject.name,
-                planFile: plan.source_plan,
-                _existingPrdFile: body.file,
-              });
-              diffAwareQueued = true;
-              return items;
-            }, { defaultValue: [] });
-          }
+        const allPrs = PROJECTS.flatMap(p => shared.safeJson(shared.projectPrPath(p)) || []);
+        const prLinks = shared.getPrLinks();
+        const implContext = (plan.missing_features || []).map(f => {
+          const wi = planWis.find(w => w.id === f.id);
+          const pr = allPrs.find(p => prLinks[p.id] === f.id || (p.prdItems || []).includes(f.id));
+          return `- **${f.id}**: ${f.name} [status: ${wi?.status || f.status}]${pr ? ` (PR: ${pr.id}, branch: \`${pr.branch}\`)` : ''}`;
+        }).join('\n');
+
+        const projectName = plan.project || body.file.replace(/-\d{4}-\d{2}-\d{2}\.json$/, '');
+        const targetProject = PROJECTS.find(p => p.name?.toLowerCase() === projectName.toLowerCase()) || PROJECTS[0];
+        if (targetProject) {
+          const centralWiPath = path.join(MINIONS_DIR, 'work-items.json');
+          mutateJsonFileLocked(centralWiPath, items => {
+            if (!Array.isArray(items)) items = [];
+            if (items.some(w => w.type === 'plan-to-prd' && w.planFile === plan.source_plan && (w.status === 'pending' || w.status === 'dispatched'))) return items;
+            items.push({
+              id: 'W-' + shared.uid(),
+              title: `Update PRD from revised plan: ${plan.source_plan}`,
+              type: 'plan-to-prd',
+              priority: 'high',
+              description: `Plan file: plans/${plan.source_plan}\nPRD file: prd/${body.file}\n\n` +
+                `Source plan was revised. Compare the updated plan against existing PRD and produce an updated version.\n\n` +
+                `**Current PRD implementation state:**\n${implContext}\n\n` +
+                `**Rules for updating:**\n` +
+                `- Items that are done and unchanged in the plan → keep status "done" (preserve their ID)\n` +
+                `- Items that are done but modified in the plan (new requirements) → set status "updated" (engine will re-open)\n` +
+                `- New items in the plan → set status "missing" (engine will materialize)\n` +
+                `- Items removed from the plan → drop from PRD (engine will cancel pending WIs)\n` +
+                `- Preserve all existing item IDs for unchanged/modified items — do NOT generate new IDs for them`,
+              status: 'pending',
+              created: new Date().toISOString(),
+              createdBy: 'dashboard:plan-resume',
+              project: targetProject.name,
+              planFile: plan.source_plan,
+              _existingPrdFile: body.file,
+            });
+            diffAwareQueued = true;
+            return items;
+          }, { defaultValue: [] });
         }
       }
 

package/package.json

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