@yemi33/minions 0.1.1892 → 0.1.1894

package/docs/index.html

@@ -247,31 +247,30 @@ minions update</pre>
 <div class="arch">
   <h2>Architecture</h2>
   <pre>
-  ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
-  Γöé                  ~/.minions/ (central hub)           Γöé
-  Γöé                                                     Γöé
-  Γöé   engine.js ΓöÇΓöÇΓöÇΓöÇ 60s tick loop ΓöÇΓöÇΓöÇΓöÇΓöÉ                Γöé
-  Γöé       Γöé                            Γöé                Γöé
-  Γöé   discover work    spawn agents    poll PRs/comments Γöé
-  Γöé       Γöé                Γöé              Γöé             Γöé
-  Γöé   ΓöîΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÉ    ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ   ΓöîΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÉ         Γöé
-  Γöé   Γöé Plans Γöé    Γöé  Worktrees  Γöé   Γöé ADO  Γöé         Γöé
-  Γöé   Γöé PRDs  Γöé    Γöé  (isolated) Γöé   ΓöéGitHubΓöé         Γöé
-  Γöé   Γöé Items Γöé    Γöé  per agent  Γöé   Γöé      Γöé         Γöé
-  Γöé   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ    ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ         Γöé
-  Γöé                                                     Γöé
-  Γöé   dashboard.js ΓöÇΓöÇ port 7331 ΓöÇΓöÇ mission control      Γöé
-  Γöé   runtimes/ ΓöÇΓöÇ Claude Code or GitHub Copilot CLI    Γöé
-  Γöé   meetings/ ΓöÇΓöÇ multi-agent discussions              Γöé
-  Γöé   pipelines/ ΓöÇΓöÇ multi-stage workflows               Γöé
-  Γöé   schedules + watches ΓöÇΓöÇ recurring/conditional work Γöé
-  Γöé   notes.md + knowledge/ ΓöÇΓöÇ team memory and KB       Γöé
-  ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
+  +-----------------------------------------------------+
+  |                  ~/.minions/ (central hub)          |
+  |                                                     |
+  |   engine.js ---- 60s tick loop ----+                |
+  |       |                            |                |
+  |   discover work    spawn agents    poll PRs/comments|
+  |       |                |              |             |
+  |   +-------+    +-------------+   +--------+         |
+  |   | Plans |    |  Worktrees  |   | ADO /  |         |
+  |   | PRDs  |    |  isolated   |   | GitHub |         |
+  |   | Items |    |  per agent  |   +--------+         |
+  |   +-------+    +-------------+                      |
+  |                                                     |
+  |   dashboard.js -- port 7331 -- mission control      |
+  |   runtimes/ -- Claude Code or GitHub Copilot CLI    |
+  |   meetings/ -- multi-agent discussions              |
+  |   pipelines/ -- multi-stage workflows               |
+  |   schedules + watches -- recurring/conditional work |
+  |   notes.md + knowledge/ -- team memory and KB       |
+  +-----------------------------------------------------+
   </pre>
 </div>
 
 </div>
-
 <footer>
   <p>Minions &mdash; built by <a href="https://github.com/yemi33">yemi33</a> &mdash; <a href="https://www.npmjs.com/package/@yemi33/minions">npm</a> &mdash; <a href="https://yemi33.github.io/minions/">Public site</a> &mdash; MIT License &mdash; Claude Code or GitHub Copilot CLI runtime</p>
 </footer>

package/engine/preflight.js

@@ -123,7 +123,7 @@ function _checkRuntimeBinary(runtimeName, { optional = false } = {}) {
     return {
       name: `Runtime: ${runtimeName}`,
       ok: false,
-      message: `unknown runtime — ${e.message}`,
+      message: `unknown runtime — ${e.message} (see docs/copilot-cli-schema.md)`,
     };
   }
   let resolved = null;
@@ -146,8 +146,8 @@ function _checkRuntimeBinary(runtimeName, { optional = false } = {}) {
     name: `Runtime: ${runtimeName}`,
     ok: optional ? 'warn' : false,
     message: optional
-      ? `not installed (optional) — ${hint}`
-      : `not found — ${hint}`,
+      ? `not installed (optional) — ${hint} (see docs/copilot-cli-schema.md)`
+      : `not found — ${hint} (see docs/copilot-cli-schema.md)`,
   };
 }
 
@@ -400,11 +400,11 @@ async function _modelDiscoveryResults(config) {
     catch { continue; /* unknown-cli warning was already emitted by runtimeConfigWarnings */ }
 
     if (fleetDisabled) {
-      results.push({ name: `Models: ${runtimeName}`, ok: 'warn', message: 'discovery disabled (engine.disableModelDiscovery)' });
+      results.push({ name: `Models: ${runtimeName}`, ok: 'warn', message: 'discovery disabled (engine.disableModelDiscovery) — see docs/copilot-cli-schema.md' });
       continue;
     }
     if (!adapter.capabilities || adapter.capabilities.modelDiscovery !== true) {
-      results.push({ name: `Models: ${runtimeName}`, ok: 'warn', message: 'discovery unavailable (no enumeration mechanism)' });
+      results.push({ name: `Models: ${runtimeName}`, ok: 'warn', message: 'discovery unavailable (no enumeration mechanism) — see docs/copilot-cli-schema.md' });
       continue;
     }
     try {
@@ -412,10 +412,10 @@ async function _modelDiscoveryResults(config) {
       if (Array.isArray(out.models) && out.models.length > 0) {
         results.push({ name: `Models: ${runtimeName}`, ok: true, message: `${out.models.length} models cached` });
       } else {
-        results.push({ name: `Models: ${runtimeName}`, ok: 'warn', message: 'discovery unavailable (API returned no models — check token)' });
+        results.push({ name: `Models: ${runtimeName}`, ok: 'warn', message: 'discovery unavailable (API returned no models — check token) — see docs/copilot-cli-schema.md' });
       }
     } catch (e) {
-      results.push({ name: `Models: ${runtimeName}`, ok: 'warn', message: `discovery error — ${e && e.message ? e.message : 'unknown'}` });
+      results.push({ name: `Models: ${runtimeName}`, ok: 'warn', message: `discovery error — ${e && e.message ? e.message : 'unknown'} (see docs/copilot-cli-schema.md)` });
     }
   }
   return results;
@@ -442,7 +442,7 @@ function doctor(minionsHome) {
   if (fs.existsSync(engineJs)) {
     runtimeResults.push({ name: 'Minions installed', ok: true, message: minionsHome });
   } else {
-    runtimeResults.push({ name: 'Minions installed', ok: false, message: `not found at ${minionsHome} — run: minions init` });
+    runtimeResults.push({ name: 'Minions installed', ok: false, message: `not found at ${minionsHome} — run: minions init (see docs/distribution.md)` });
   }
 
   // Check config.json
@@ -454,13 +454,13 @@ function doctor(minionsHome) {
     if (real.length > 0) {
       runtimeResults.push({ name: 'Projects configured', ok: true, message: `${real.length} project(s)` });
     } else {
-      runtimeResults.push({ name: 'Projects configured', ok: false, message: 'no projects — run: minions add <dir>' });
+      runtimeResults.push({ name: 'Projects configured', ok: false, message: 'no projects — run: minions add <dir> (see docs/auto-discovery.md)' });
     }
 
     // Check project paths exist
     for (const p of real) {
       if (p.localPath && !fs.existsSync(p.localPath)) {
-        runtimeResults.push({ name: `Project "${p.name}"`, ok: false, message: `path not found: ${p.localPath}` });
+        runtimeResults.push({ name: `Project "${p.name}"`, ok: false, message: `path not found: ${p.localPath} — fix config.json or re-run: minions add <dir> (see docs/auto-discovery.md)` });
       }
     }
 
@@ -469,7 +469,7 @@ function doctor(minionsHome) {
     if (Object.keys(agents).length > 0) {
       runtimeResults.push({ name: 'Agents configured', ok: true, message: `${Object.keys(agents).length} agent(s)` });
     } else {
-      runtimeResults.push({ name: 'Agents configured', ok: false, message: 'no agents in config.json' });
+      runtimeResults.push({ name: 'Agents configured', ok: false, message: 'no agents in config.json — re-run: minions init (see docs/auto-discovery.md)' });
     }
 
     // Check Teams integration — supports client secret OR certificate auth
@@ -482,7 +482,7 @@ function doctor(minionsHome) {
           !teams.appId && 'appId',
           !teams.appPassword && !teams.certPath && 'appPassword or certPath+privateKeyPath+tenantId',
         ].filter(Boolean).join(', ');
-        runtimeResults.push({ name: 'Teams integration', ok: 'warn', message: `enabled but missing: ${missing}` });
+        runtimeResults.push({ name: 'Teams integration', ok: 'warn', message: `enabled but missing: ${missing} — see docs/teams-setup.md` });
       } else {
         const authMode = hasCert ? 'certificate' : 'client secret';
         runtimeResults.push({ name: 'Teams integration', ok: true, message: `configured (${authMode})` });
@@ -491,7 +491,7 @@ function doctor(minionsHome) {
       runtimeResults.push({ name: 'Teams integration', ok: 'warn', message: 'disabled — see docs/teams-setup.md' });
     }
   } catch {
-    runtimeResults.push({ name: 'Config', ok: false, message: `missing or invalid — run: minions init` });
+    runtimeResults.push({ name: 'Config', ok: false, message: `missing or invalid — run: minions init (see docs/distribution.md)` });
   }
 
   // Check engine status
@@ -509,12 +509,12 @@ function doctor(minionsHome) {
           alive = true;
         }
       } catch { /* process may be dead */ }
-      runtimeResults.push({ name: 'Engine', ok: alive, message: alive ? `running (PID ${control.pid})` : `stale PID ${control.pid} — run: minions start` });
+      runtimeResults.push({ name: 'Engine', ok: alive, message: alive ? `running (PID ${control.pid})` : `stale PID ${control.pid} — run: minions start (see docs/engine-restart.md)` });
     } else {
-      runtimeResults.push({ name: 'Engine', ok: 'warn', message: `${control.state || 'stopped'} — run: minions start` });
+      runtimeResults.push({ name: 'Engine', ok: 'warn', message: `${control.state || 'stopped'} — run: minions start (see docs/engine-restart.md)` });
     }
   } catch {
-    runtimeResults.push({ name: 'Engine', ok: 'warn', message: 'not started — run: minions start' });
+    runtimeResults.push({ name: 'Engine', ok: 'warn', message: 'not started — run: minions start (see docs/engine-restart.md)' });
   }
 
   // Check dashboard (try HTTP)
@@ -523,8 +523,8 @@ function doctor(minionsHome) {
     const req = http.get('http://localhost:7331/api/health', { timeout: 2000 }, res => {
       resolve({ name: 'Dashboard', ok: true, message: 'running on http://localhost:7331' });
     });
-    req.on('error', () => resolve({ name: 'Dashboard', ok: 'warn', message: 'not reachable on :7331 — run: minions dash' }));
-    req.on('timeout', () => { req.destroy(); resolve({ name: 'Dashboard', ok: 'warn', message: 'not reachable on :7331 — run: minions dash' }); });
+    req.on('error', () => resolve({ name: 'Dashboard', ok: 'warn', message: 'not reachable on :7331 — run: minions dash (see docs/engine-restart.md)' }));
+    req.on('timeout', () => { req.destroy(); resolve({ name: 'Dashboard', ok: 'warn', message: 'not reachable on :7331 — run: minions dash (see docs/engine-restart.md)' }); });
   });
 
   return dashCheck.then(async dashResult => {
@@ -537,12 +537,12 @@ function doctor(minionsHome) {
     if (playbooks.length > 0) {
       runtimeResults.push({ name: 'Playbooks', ok: true, message: `${playbooks.length} playbooks found` });
     } else {
-      runtimeResults.push({ name: 'Playbooks', ok: false, message: 'no playbooks found in playbooks/ — run: minions init --force' });
+      runtimeResults.push({ name: 'Playbooks', ok: false, message: 'no playbooks found in playbooks/ — run: minions init --force (see docs/distribution.md)' });
     }
 
     // Check port 7331 availability (only if dashboard isn't running)
     if (dashResult.ok !== true) {
-      runtimeResults.push({ name: 'Port 7331', ok: 'warn', message: 'dashboard not running — port status unknown' });
+      runtimeResults.push({ name: 'Port 7331', ok: 'warn', message: 'dashboard not running — port status unknown (see docs/engine-restart.md)' });
     }
 
     // Fleet defaults + per-runtime model discovery (P-9e8a3f1d). Both depend

package/package.json

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