@yemi33/minions 0.1.2161 → 0.1.2163

package/dashboard/js/refresh.js

@@ -146,7 +146,7 @@ const RENDER_VERSIONS = {
   dispatch: 2,
   engineLog: 2,
   metrics: 1,
-  workItems: 2,
+  workItems: 3,
   skills: 1,
   mcpServers: 1,
   schedules: 1,

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

@@ -35,12 +35,13 @@ const _WI_ENRICHMENT_FIELDS = [
 //
 // Triggers:
 //   * _preDispatchEval.valid === false (pre-dispatch acceptance gate rejected)
-//   * _pendingReason in { pr_not_found, no_agent, budget_exceeded, dependency_unmet }
+//   * _pendingReason in { pr_not_found, no_agent, budget_exceeded }
 //
 // Does NOT trigger for transient reasons that auto-clear:
 //   * cooldown / retry_cooldown — wait it out
 //   * already_dispatched — engine reconciles on next tick
 //   * branch_locked — wait for the holding dispatch
+//   * dependency_unmet — auto-clears when upstream dep finishes (engine discovery loop + DEPENDENCY_MET watch)
 //
 // Returns { kind, short, full } when the item needs attention, else null.
 // Pure helper (no DOM / escapeHtml deps) so it can be unit-tested in Node.
@@ -74,13 +75,6 @@ function needsAttentionInfo(item) {
     var budgetMsg = 'Assigned agent ' + agent + ' is over its maxBudgetUsd cap.';
     return { kind: 'budget_exceeded', short: budgetMsg, full: budgetMsg };
   }
-  if (reason === 'dependency_unmet') {
-    var deps = Array.isArray(item.depends_on) && item.depends_on.length
-      ? item.depends_on.join(', ')
-      : '<unknown>';
-    var depMsg = 'Waiting on dependencies: ' + deps + '. (One or more are not yet done.)';
-    return { kind: 'dependency_unmet', short: depMsg, full: depMsg };
-  }
   return null;
 }
 

package/docs/preflight.md

@@ -0,0 +1,43 @@
+# Preflight & Doctor
+
+`minions doctor` (and the lighter `minions preflight` that runs on every CLI
+invocation) inspects the local environment for the conditions Minions needs
+to dispatch agents reliably. Every row is one of: `OK`, `WARN`, `FAIL`.
+
+This page documents the rows that are not self-explanatory from their message.
+
+## "Permission bypass: \<runtime\>"
+
+Minions dispatches agents in **headless** mode — no human is sitting at the
+terminal to answer "Allow this tool to run X?" permission prompts. Every
+agent runtime adapter therefore declares a `permissionBypassFlags` list (the
+flag set that tells the underlying CLI to skip every interactive permission
+prompt). At doctor time we shell out to `<runtime> --help` and confirm those
+flags still appear in the help text.
+
+The check emits **WARN** (not FAIL) so an outdated or unusual CLI install
+doesn't block existing dispatches — Minions still passes the flags, the
+agent just risks hanging on a prompt if the CLI doesn't honor them.
+
+WARN cases and remedies:
+
+| Case | Meaning | Fix |
+|------|---------|-----|
+| `adapter did not declare permissionBypassFlags` | The runtime adapter is missing its declared bypass-flag list. Internal bug — open an issue. | Code change in `engine/runtimes/<name>.js`. |
+| `could not invoke <runtime> --help` | The runtime binary was found but `--help` failed (exit non-zero, timeout, or no output). | Re-install the CLI; verify `<runtime> --help` works in a fresh shell. |
+| `--help does not list expected flag(s): <flags>` | The installed CLI version is older than the flags Minions expects, **or** the resolved binary is a different CLI with the same name. | Update the CLI: `npm i -g @anthropic-ai/claude-code` for Claude, `winget upgrade Microsoft.CopilotCLI` (Windows) or `npm i -g @github/copilot` for the Copilot CLI. |
+
+### The `gh copilot` vs Copilot-CLI gotcha
+
+On Linux CI agents, `which copilot` often resolves to `/usr/bin/gh` — the
+GitHub CLI's **`gh copilot`** extension, not the standalone **Copilot CLI**
+(`@github/copilot`). They share the binary name but have completely
+different flag sets. The `gh copilot` extension does NOT accept
+`--autopilot`, `--allow-all`, or `--no-ask-user`, so the WARN row will fire
+even though the binary "works".
+
+The warn is legitimate — dispatched agents using that binary would hang on
+permission prompts. Install the standalone Copilot CLI (`npm i -g
+@github/copilot`) ahead of `gh` in `$PATH`, or configure
+`agents.<id>.cli` to point at the absolute path of the real Copilot CLI
+binary.

package/package.json

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