@yemi33/minions 0.1.234 → 0.1.236

package/CHANGELOG.md

@@ -1,10 +1,14 @@
 # Changelog
 
-## 0.1.234 (2026-04-03)
+## 0.1.236 (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
 
+### Other
+- docs: fix outdated references across all documentation
+
 ## 0.1.233 (2026-04-03)
 
 ### Fixes

package/README.md

@@ -354,18 +354,14 @@ When an agent fails (timeout, crash, error), the engine marks the work item as `
 
 ## Auto-Discovery Pipeline
 
-The engine discovers work from 5 sources, in priority order:
+The engine discovers work from 4 sources, in priority order:
 
 | Priority | Source | Dispatch Type |
 |----------|--------|---------------|
-| 1 | PRs with changes-requested | `fix` |
-| 2 | PRs with human `@minions` feedback | `fix` |
-| 3 | PRs with build failures | `fix` |
-| 4 | PRs pending review | `review` |
-| 5 | PRs needing build/test verification | `test` |
-| 6 | Plan items (`plans/*.json`, approved) | `implement` |
-| 7 | Per-project work items | item's `type` |
-| 8 | Central work items | item's `type` |
+| 1 | Pull requests (changes-requested, human feedback, build failures, pending review) | `fix`, `review`, `test` |
+| 2 | Plan items (`plans/*.json`, approved) | `implement` |
+| 3 | Per-project work items | item's `type` |
+| 4 | Central work items (project-agnostic tasks) | item's `type` |
 
 Each item passes through: dedup (checks pending, active, AND recently completed), cooldown, and agent availability gates. See `docs/auto-discovery.md` for the full pipeline.
 

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/docs/auto-discovery.md

@@ -20,7 +20,7 @@ tick()
 
 ## Work Discovery
 
-`discoverWork()` iterates every project in `config.projects[]` and runs three core discovery sources. Results are prioritized: fixes > reviews > implements > work-items.
+`discoverWork()` iterates every project in `config.projects[]` and runs four core discovery sources: pull requests, per-project work items, central work items, and pipeline/scheduled tasks. Results are prioritized: fixes > reviews > implements > work-items.
 
 Before scanning, the engine materializes plans and specs into project work items (side-effect writes to `work-items.json`), so they're picked up by the work items source below.
 

package/docs/command-center.md

@@ -13,7 +13,7 @@ CC maintains a true multi-turn session using Claude CLI's `--resume` flag. Unlik
 **Session lifecycle:**
 - **Created** on first message (or after expiry/new-session)
 - **Resumed** on subsequent messages via `--resume <sessionId>`
-- **Expires** after 2 hours of inactivity or 50 turns
+- **Expires** after 2 hours of inactivity
 - **Persisted** to `engine/cc-session.json` — survives dashboard restarts
 - **Frontend messages** saved to `localStorage` — survive page refresh
 
@@ -108,7 +108,7 @@ User message (CC panel, doc modal, or steer)
     ▼
 POST /api/command-center  (or /api/doc-chat, /api/steer-document)
     │
-    ├── Validate session (expiry, turn limit)
+    ├── Validate session (expiry check)
     ├── Build dynamic state preamble (buildCCStatePreamble)
     ├── callLLM() with sessionId (resume) or without (new)
     │     model: sonnet

package/docs/deprecated.json

@@ -1 +1,10 @@
-[]
+[
+  {
+    "id": "evaluate-work-type",
+    "summary": "evaluate work type removed — eval loop uses review exclusively",
+    "deprecated": "2026-04-02",
+    "reason": "Consolidated into review + evalLoop config. No separate evaluate dispatch.",
+    "locations": ["routing.md: evaluate row removed", "CLAUDE.md: evaluate references removed"],
+    "cleanup": "Already cleaned — routing.md and CLAUDE.md updated 2026-04-02"
+  }
+]

package/docs/distribution.md

@@ -92,5 +92,4 @@ git checkout master
 git branch -D dist-clean
 ```
 
-The full workflow is documented in `.claude/skills/sync-to-personal/SKILL.md`.
 

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yemi33/minions",
-  "version": "0.1.234",
+  "version": "0.1.236",
   "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/routing.md

@@ -17,7 +17,6 @@ How the engine decides who handles what. Parsed by engine.js — keep the table
 | test | dallas | ralph |
 | ask | ripley | rebecca |
 | verify | dallas | ralph |
-| evaluate | ripley | rebecca |
 | decompose | ripley | rebecca |
 | meeting | ripley | rebecca |