@yemi33/minions 0.1.174 → 0.1.176

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.1.176 (2026-04-02)
+
+### Engine
+- engine/meeting.js
+
+### Dashboard
+- dashboard/js/settings.js
+
+## 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

package/dashboard/js/refresh.js

@@ -97,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);
@@ -162,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/js/settings.js

@@ -66,6 +66,7 @@ async function openSettings() {
 
   // Add save button to modal header actions (next to copy/close)
   const actions = document.querySelector('.modal-header-actions');
+  if (!actions) return;
   const existingSaveBtn = document.getElementById('modal-settings-save');
   if (!existingSaveBtn) {
     const saveBtn = document.createElement('button');

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/engine/meeting.js

@@ -28,7 +28,14 @@ function getMeetings() {
 
 function getMeeting(id) {
   const filePath = path.join(MEETINGS_DIR, id + '.json');
-  return safeJson(filePath);
+  const m = safeJson(filePath);
+  if (m) {
+    if (!m.findings) m.findings = {};
+    if (!m.debate) m.debate = {};
+    if (!m.humanNotes) m.humanNotes = [];
+    if (!m.participants) m.participants = [];
+  }
+  return m;
 }
 
 function saveMeeting(meeting) {

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.174",
+  "version": "0.1.176",
   "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/dashboard/pages/prd.html

@@ -1,5 +0,0 @@
-      <section class="prd-panel" id="prd-section">
-        <h2>PRD <span class="count" id="prd-progress-count">0%</span> <span id="prd-badge"></span> <span id="archive-btns"></span></h2>
-        <div id="prd-content"><p class="prd-pending">No PRD found.</p></div>
-        <div id="prd-progress-content" style="margin-top:12px"></div>
-      </section>