@yemi33/minions 0.1.233 → 0.1.235

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.1.235 (2026-04-03)
+
+### Fixes
+-  CLI audit — kill dashboard on restart, expose kill/complete, update help
+-  clean _pendingReason on all status→done transitions, not just updateWorkItemStatus
+
 ## 0.1.233 (2026-04-03)
 
 ### Fixes

package/bin/minions.js

@@ -431,6 +431,7 @@ const engineCmds = new Set([
   'start', 'stop', 'status', 'pause', 'resume',
   'queue', 'sources', 'discover', 'dispatch',
   'spawn', 'work', 'cleanup', 'mcp-sync', 'plan',
+  'kill', 'complete',
 ]);
 
 if (!cmd || cmd === 'help' || cmd === '--help' || cmd === '-h') {
@@ -454,9 +455,13 @@ if (!cmd || cmd === 'help' || cmd === '--help' || cmd === '-h') {
     minions pause / resume           Pause/resume dispatching
     minions dispatch                 Force a dispatch cycle
     minions discover                 Dry-run work discovery
+    minions queue                    Show dispatch queue (pending/active/completed)
+    minions sources                  Show work source status per project
     minions work <title> [opts]      Add a work item
     minions spawn <agent> <prompt>   Manually spawn an agent
     minions plan <file|text> [proj]  Run a plan
+    minions kill                     Kill all active agents and reset to pending
+    minions complete <dispatch-id>   Manually mark a dispatch as completed
     minions cleanup                  Clean temp files, worktrees, zombies
     minions nuke --confirm           Factory reset (delete state, reset config to defaults)
 
@@ -484,8 +489,22 @@ if (!cmd || cmd === 'help' || cmd === '--help' || cmd === '-h') {
 } else if (cmd === 'up' || cmd === 'restart') {
   // Start both engine and dashboard — the go-to command after a reboot
   ensureInstalled();
-  // Stop engine if running (ignore errors)
+  // Stop engine if running
   try { execSync(`node "${path.join(MINIONS_HOME, 'engine.js')}" stop`, { stdio: 'ignore', cwd: MINIONS_HOME }); } catch {}
+  // Kill existing dashboard
+  try {
+    if (process.platform === 'win32') {
+      const out = execSync('wmic process where "name=\'node.exe\'" get processid,commandline /format:csv', { encoding: 'utf8', timeout: 10000, windowsHide: true });
+      for (const line of out.split('\n')) {
+        if (line.includes('dashboard.js') && line.includes('minions')) {
+          const pid = line.split(',').pop()?.trim();
+          if (pid && pid !== String(process.pid)) try { process.kill(parseInt(pid)); } catch {}
+        }
+      }
+    } else {
+      try { execSync('lsof -ti:7331 | xargs kill -9 2>/dev/null', { timeout: 5000 }); } catch {}
+    }
+  } catch {}
   const engineProc = spawn(process.execPath, [path.join(MINIONS_HOME, 'engine.js'), 'start'], {
     cwd: MINIONS_HOME, stdio: 'ignore', detached: true, windowsHide: true
   });

package/engine/cleanup.js

@@ -364,6 +364,7 @@ function runCleanup(config, verbose = false) {
       for (const item of items) {
         if (LEGACY_DONE_STATUSES.has(item.status)) {
           item.status = 'done';
+          delete item._pendingReason;
           migrated++;
         }
       }
@@ -381,6 +382,7 @@ function runCleanup(config, verbose = false) {
     for (const item of centralItems) {
       if (LEGACY_DONE_STATUSES.has(item.status)) {
         item.status = 'done';
+        delete item._pendingReason;
         migrated++;
       }
     }

package/engine/cli.js

@@ -37,8 +37,9 @@ function handleCommand(cmd, args) {
     console.log('  spawn <a> <p>    Manually spawn agent with prompt');
     console.log('  work <title> [o] Add to work-items.json queue');
     console.log('  plan <src> [p]   Generate PRD from a plan (file or text)');
-    console.log('  complete <id>    Mark dispatch as done');
-    console.log('  cleanup           Clean temp files, worktrees, zombies');
+    console.log('  kill             Kill all active agents, reset to pending');
+    console.log('  complete <id>    Mark a dispatch as done');
+    console.log('  cleanup          Clean temp files, worktrees, zombies');
     console.log('  mcp-sync         Sync MCP servers from ~/.claude.json');
     console.log('  doctor           Check prerequisites and runtime health');
     process.exit(1);
@@ -567,11 +568,19 @@ const commands = {
 
   complete(id) {
     if (!id) {
-      console.log('Usage: node .minions/engine.js complete <dispatch-id>');
+      console.log('Usage: minions complete <dispatch-id>');
+      return;
+    }
+    const dispatch = getDispatch();
+    const found = (dispatch.active || []).some(d => d.id === id);
+    if (!found) {
+      console.log(`  Dispatch "${id}" not found in active queue.`);
+      const pending = (dispatch.pending || []).some(d => d.id === id);
+      if (pending) console.log('  (It is in pending — it hasn\'t started yet.)');
       return;
     }
     engine().completeDispatch(id, 'success');
-    console.log(`Marked ${id} as completed.`);
+    console.log(`  Marked ${id} as completed.`);
   },
 
   dispatch() {

package/engine/lifecycle.js

@@ -284,23 +284,33 @@ function checkPlanCompletion(meta, config) {
     shared.safeWrite(planPath, plan);
   }
 
-  // Also archive the source .md plan if it exists
+  // Also archive the source .md plan if it exists (use source_plan field, not content matching)
   const planArchiveDir = path.join(PLANS_DIR, 'archive');
   if (!fs.existsSync(planArchiveDir)) fs.mkdirSync(planArchiveDir, { recursive: true });
-  try {
-    const mdFiles = fs.readdirSync(PLANS_DIR).filter(f => f.endsWith('.md'));
-    for (const md of mdFiles) {
-      const mdContent = shared.safeRead(path.join(PLANS_DIR, md)) || '';
-      // Match by project name or plan summary appearing in the .md content
-      if (mdContent.includes(projectName) || mdContent.includes(plan.plan_summary?.slice(0, 40) || '___nomatch___')) {
-        try {
-          fs.renameSync(path.join(PLANS_DIR, md), path.join(planArchiveDir, md));
-          log('info', `Archived source plan: plans/archive/${md}`);
-        } catch (err) { log('warn', `Failed to archive plan ${md}: ${err.message}`); }
-        break;
-      }
+  if (plan.source_plan) {
+    const mdPath = path.join(PLANS_DIR, plan.source_plan);
+    if (fs.existsSync(mdPath)) {
+      try {
+        fs.renameSync(mdPath, path.join(planArchiveDir, plan.source_plan));
+        log('info', `Archived source plan: plans/archive/${plan.source_plan}`);
+      } catch (err) { log('warn', `Failed to archive source plan ${plan.source_plan}: ${err.message}`); }
     }
-  } catch (err) { log('warn', `Plan archive scan: ${err.message}`); }
+  } else {
+    // Fallback: scan for matching .md files (legacy PRDs without source_plan)
+    try {
+      const mdFiles = fs.readdirSync(PLANS_DIR).filter(f => f.endsWith('.md'));
+      for (const md of mdFiles) {
+        const mdContent = shared.safeRead(path.join(PLANS_DIR, md)) || '';
+        if (mdContent.includes(projectName) || mdContent.includes(plan.plan_summary?.slice(0, 40) || '___nomatch___')) {
+          try {
+            fs.renameSync(path.join(PLANS_DIR, md), path.join(planArchiveDir, md));
+            log('info', `Archived source plan: plans/archive/${md}`);
+          } catch (err) { log('warn', `Failed to archive plan ${md}: ${err.message}`); }
+          break;
+        }
+      }
+    } catch (err) { log('warn', `Plan archive scan: ${err.message}`); }
+  }
 
   // 6. Clean up ALL worktrees created for this plan's work items (shared-branch + per-item)
   try {
@@ -791,6 +801,7 @@ async function handlePostMerge(pr, project, config, newStatus) {
             log('info', `Post-merge: marking work item ${mergedItemId} as done (was ${item.status}) for ${pr.id}`);
             item.status = 'done';
             item.completedAt = ts();
+            delete item._pendingReason;
             item._mergedVia = pr.id;
             found = true;
           }

package/package.json

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