@yemi33/minions 0.1.173 → 0.1.175

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.1.175 (2026-04-02)
+
+### Engine
+- engine/cli.js
+
+### Dashboard
+- dashboard/js/refresh.js
+- dashboard/layout.html
+
+### Other
+- minions.js
+
+## 0.1.174 (2026-04-02)
+
+### Dashboard
+- dashboard/js/refresh.js
+
 ## 0.1.173 (2026-04-02)
 
 ### Engine

package/dashboard/js/refresh.js

@@ -6,21 +6,37 @@ let _prevEngineAlert = false;
 function _detectPageChanges(data) {
   const counts = {
     completions: (data.dispatch?.completed || []).length,
+    activeDispatches: (data.dispatch?.active || []).length,
     workDone: (data.workItems || []).filter(w => w.status === 'done' || w.status === 'failed').length,
     workTotal: (data.workItems || []).length,
+    workDispatched: (data.workItems || []).filter(w => w.status === 'dispatched').length,
     prdComplete: data.prdProgress?.complete || 0,
+    prdInProgress: data.prdProgress?.inProgress || 0,
+    plansTotal: (data.plans || []).length,
+    prsTotal: (data.pullRequests || []).length,
     prsMerged: (data.pullRequests || []).filter(p => p.status === 'merged').length,
+    prsReviewed: (data.pullRequests || []).filter(p => p.reviewStatus === 'approved' || p.reviewStatus === 'changes-requested').length,
     inbox: (data.inbox?.items || []).length,
+    kbTotal: Object.values(data.knowledgeBase || {}).reduce((s, v) => s + (Array.isArray(v) ? v.length : 0), 0),
+    skillsTotal: (data.skills || []).length,
+    mcpTotal: (data.mcpServers || []).length,
+    scheduleTotal: (data.schedules || []).length,
+    pipelineRuns: (data.pipelines || []).reduce((s, p) => s + (p.runs || []).length, 0),
+    pipelineActive: (data.pipelines || []).filter(p => (p.runs || []).some(r => r.status === 'running')).length,
     meetingRounds: (data.meetings || []).reduce((s, m) => s + (m.round || 0), 0),
+    meetingTotal: (data.meetings || []).length,
   };
   const changes = {};
   if (_prevCounts.completions !== undefined) {
-    if (counts.completions > _prevCounts.completions) changes.home = true;
-    if (counts.workDone > _prevCounts.workDone || counts.workTotal > _prevCounts.workTotal) changes.work = true;
-    if (counts.prdComplete > _prevCounts.prdComplete) changes.plans = true;
-    if (counts.prsMerged > _prevCounts.prsMerged) changes.prs = true;
-    if (counts.inbox > _prevCounts.inbox) changes.inbox = true;
-    if (counts.meetingRounds > _prevCounts.meetingRounds) changes.meetings = true;
+    if (counts.completions > _prevCounts.completions || counts.activeDispatches > _prevCounts.activeDispatches) changes.home = true;
+    if (counts.workDone > _prevCounts.workDone || counts.workTotal > _prevCounts.workTotal || counts.workDispatched !== _prevCounts.workDispatched) changes.work = true;
+    if (counts.prdComplete > _prevCounts.prdComplete || counts.prdInProgress > _prevCounts.prdInProgress || counts.plansTotal > _prevCounts.plansTotal) changes.plans = true;
+    if (counts.prsTotal > _prevCounts.prsTotal || counts.prsMerged > _prevCounts.prsMerged || counts.prsReviewed > _prevCounts.prsReviewed) changes.prs = true;
+    if (counts.inbox > _prevCounts.inbox || counts.kbTotal > _prevCounts.kbTotal) changes.inbox = true;
+    if (counts.skillsTotal > _prevCounts.skillsTotal || counts.mcpTotal > _prevCounts.mcpTotal) changes.tools = true;
+    if (counts.scheduleTotal > _prevCounts.scheduleTotal) changes.schedule = true;
+    if (counts.pipelineRuns > _prevCounts.pipelineRuns || counts.pipelineActive > _prevCounts.pipelineActive) changes.pipelines = true;
+    if (counts.meetingRounds > _prevCounts.meetingRounds || counts.meetingTotal > _prevCounts.meetingTotal) changes.meetings = true;
   }
   _prevCounts = counts;
 
@@ -81,7 +97,9 @@ function _processStatusUpdate(data) {
   }
   document.getElementById('ts').textContent = new Date(data.timestamp).toLocaleTimeString();
   const engineState = (data.engine && data.engine.state) ? data.engine.state : 'stopped';
-  document.getElementById('setup-banner').style.display = (!data.initialized && engineState !== 'stopped') ? 'block' : 'none';
+  // Show setup banner if no projects linked (the key onboarding step)
+  const noProjects = !data.projects || data.projects.length === 0;
+  document.getElementById('setup-banner').style.display = (noProjects && engineState !== 'stopped') ? 'block' : 'none';
   renderAgents(data.agents);
   renderPrdProgress(data.prdProgress);
   _cachePrdItems(data.prdProgress);
@@ -146,7 +164,16 @@ async function refresh() {
 refresh();
 
 // Poll for status updates (SSE caused HTTP/1.1 connection exhaustion — CC fetch would fail)
-setInterval(refresh, 4000);
+var _refreshTimer = setInterval(refresh, 4000);
+document.addEventListener('visibilitychange', function() {
+  if (document.hidden) {
+    clearInterval(_refreshTimer);
+    _refreshTimer = null;
+  } else if (!_refreshTimer) {
+    refresh();
+    _refreshTimer = setInterval(refresh, 4000);
+  }
+});
 
 // Wire sidebar navigation
 document.querySelectorAll('.sidebar-link').forEach(link => {

package/dashboard/layout.html

@@ -21,7 +21,7 @@
 <div class="engine-alert" id="engine-alert"></div>
 
 <!-- Command Center Drawer -->
-<div id="cc-drawer" style="display:none;position:fixed;top:0;right:0;bottom:0;width:420px;background:var(--surface);border-left:1px solid var(--border);z-index:300;flex-direction:column;overscroll-behavior:contain">
+<div id="cc-drawer" style="display:none;position:fixed;top:0;right:0;bottom:0;width:420px;background:var(--surface);border-left:1px solid var(--border);z-index:350;flex-direction:column;overscroll-behavior:contain">
   <div id="cc-resize-handle" class="cc-resize-handle"></div>
   <div style="padding:12px 16px;border-bottom:1px solid var(--border);display:flex;align-items:center;justify-content:space-between">
     <div style="display:flex;align-items:center;gap:8px">
@@ -48,10 +48,13 @@
   <div id="projects-list" style="display:flex;gap:8px;flex-wrap:wrap;">—</div>
 </div>
 
-<div id="setup-banner" style="display:none;margin:16px 24px;padding:16px 20px;background:var(--surface2);border:1px dashed var(--blue);border-radius:8px;text-align:center;color:var(--text)">
-  <div style="font-size:18px;margin-bottom:6px">Welcome to Minions</div>
-  <div style="color:var(--muted);font-size:13px;margin-bottom:10px">Your minions hasn't been initialized yet. Run the following command to get started:</div>
-  <code style="background:var(--bg);padding:6px 16px;border-radius:4px;font-size:14px;color:var(--blue);border:1px solid var(--border)">minions init</code>
+<div id="setup-banner" style="display:none;margin:16px 24px;padding:16px 20px;background:var(--surface2);border:1px dashed var(--blue);border-radius:8px;color:var(--text)">
+  <div style="font-size:18px;margin-bottom:6px;text-align:center">Getting Started</div>
+  <div style="color:var(--muted);font-size:13px;margin-bottom:12px;text-align:center">No projects linked yet. Link a project so agents know what code to work on.</div>
+  <div style="display:flex;flex-direction:column;gap:8px;align-items:center">
+    <code style="background:var(--bg);padding:6px 16px;border-radius:4px;font-size:13px;color:var(--blue);border:1px solid var(--border)">minions add &lt;path-to-your-repo&gt;</code>
+    <div style="font-size:11px;color:var(--muted)">Then try: <code style="background:var(--bg);padding:2px 6px;border-radius:3px;font-size:11px">minions work "Explore the codebase"</code> or use the Command Center above</div>
+  </div>
 </div>
 
 <!-- Layout replaced by page-layout sidebar navigation -->

package/engine/cli.js

@@ -92,6 +92,10 @@ const commands = {
 
     const { getProjects } = require('./shared');
     const projects = getProjects(config);
+    if (projects.length === 0) {
+      console.log('  \x1b[33mNo projects configured.\x1b[0m Link one with: minions add <path-to-repo>');
+      console.log('  Agents can still work on tasks via the Command Center without a project.');
+    }
     for (const p of projects) {
       const root = p.localPath ? path.resolve(p.localPath) : null;
       if (!root || !fs.existsSync(root)) {
@@ -322,6 +326,7 @@ const commands = {
 
     // File-change-driven work discovery — trigger tick when work-items or PRDs change
     const _watchedFiles = new Set();
+    let _globalDebounce = null;
     function watchForWorkChanges() {
       const filesToWatch = [
         path.join(MINIONS_DIR, 'work-items.json'),
@@ -344,13 +349,12 @@ const commands = {
         if (_watchedFiles.has(filePath)) continue;
         _watchedFiles.add(filePath);
         try {
-          let _debounce = null;
           fs.watchFile(filePath, { interval: 2000 }, () => {
-            // Debounce — multiple rapid writes should only trigger one tick
-            if (_debounce) return;
-            _debounce = setTimeout(() => {
-              _debounce = null;
-              e.log('info', `File change detected: ${path.basename(filePath)} — triggering tick`);
+            // Global debounce — coalesce rapid multi-file changes into one tick
+            if (_globalDebounce) clearTimeout(_globalDebounce);
+            _globalDebounce = setTimeout(() => {
+              _globalDebounce = null;
+              e.log('info', `File change detected — triggering tick`);
               e.tick();
             }, 1000);
           });

package/minions.js

@@ -393,8 +393,15 @@ async function initMinions({ skipScan = false, scanRoot, scanDepth } = {}) {
   const config = loadConfig();
   if (!config.projects) config.projects = [];
   const removedPlaceholders = cleanupPlaceholderProjects(config);
-  if (!config.engine) config.engine = { ...ENGINE_DEFAULTS };
-  if (!config.claude) config.claude = { ...DEFAULT_CLAUDE };
+  // Merge defaults — fills in new fields from upgrades while preserving user customizations
+  if (!config.engine) config.engine = {};
+  for (const [k, v] of Object.entries(ENGINE_DEFAULTS)) {
+    if (config.engine[k] === undefined) config.engine[k] = v;
+  }
+  if (!config.claude) config.claude = {};
+  for (const [k, v] of Object.entries(DEFAULT_CLAUDE)) {
+    if (config.claude[k] === undefined) config.claude[k] = v;
+  }
   if (!config.agents || Object.keys(config.agents).length === 0) {
     config.agents = { ...DEFAULT_AGENTS };
   }

package/package.json

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