@yemi33/minions 0.1.383 → 0.1.385

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.1.385 (2026-04-06)
+
+### Features
+-  npm update check — show when newer version is available
+-  show engine version and stale-code warning in dashboard
+
 ## 0.1.383 (2026-04-06)
 
 ### Fixes

package/dashboard/js/refresh.js

@@ -57,6 +57,7 @@ function _processStatusUpdate(data) {
   renderPrs(data.pullRequests || []);
   renderArchiveButtons(data.archivedPrds || []);
   renderEngineStatus(data.engine);
+  renderVersionBanner(data.version);
   renderDispatch(data.dispatch);
   window._lastDispatch = data.dispatch;
   window._lastWorkItems = data.workItems || [];

package/dashboard/js/render-dispatch.js

@@ -210,4 +210,30 @@ async function showErrorDetails(agentId, reason, task) {
   }
 }
 
-window.MinionsDispatch = { renderEngineStatus, renderEngineAlert, renderDispatch, renderEngineLog, shortTime, showErrorDetails };
+function renderVersionBanner(version) {
+  const el = document.getElementById('version-banner');
+  if (!el) return;
+  if (!version) { el.style.display = 'none'; return; }
+
+  const v = version.running || version.disk || '?';
+  const commitLabel = version.runningCommit ? ' (' + version.runningCommit + ')' : '';
+
+  if (version.stale) {
+    // Engine running old code — needs restart
+    el.style.cssText = 'font-size:9px;padding:2px 8px;background:rgba(210,153,34,0.15);border:1px solid rgba(210,153,34,0.3);border-radius:4px;color:var(--yellow);cursor:help';
+    el.textContent = '\u26A0 Engine running v' + (version.running || '?') + ' — disk has v' + (version.disk || '?') + '. Restart to apply.';
+    el.title = 'The engine process is running older code than what is on disk. Run: minions restart';
+  } else if (version.updateAvailable) {
+    // New version on npm
+    el.style.cssText = 'font-size:9px;padding:2px 8px;background:rgba(63,185,80,0.1);border:1px solid rgba(63,185,80,0.3);border-radius:4px;color:var(--green);cursor:help';
+    el.textContent = 'v' + v + commitLabel + ' — v' + version.latest + ' available. Run: npm update -g @yemi33/minions';
+    el.title = 'A newer version is available on npm';
+  } else {
+    // Up to date
+    el.style.cssText = 'font-size:9px;color:var(--muted)';
+    el.textContent = 'v' + v + commitLabel;
+    el.title = 'Minions v' + v + (version.latest ? ' (latest)' : '');
+  }
+}
+
+window.MinionsDispatch = { renderEngineStatus, renderEngineAlert, renderVersionBanner, renderDispatch, renderEngineLog, shortTime, showErrorDetails };

package/dashboard/layout.html

@@ -19,6 +19,7 @@
   </div>
 </header>
 <div class="engine-alert" id="engine-alert"></div>
+<div id="version-banner" style="font-size:9px;color:var(--muted);padding:0 16px"></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:350;flex-direction:column;overscroll-behavior:contain">

package/dashboard.js

@@ -161,6 +161,47 @@ function getVerifyGuides() {
 function getArchivedPrds() { return []; }
 function getEngineState() { return queries.getControl(); }
 
+// ── npm update check (cached for 4 hours) ──────────────────────────────────
+let _npmVersionCache = null;
+let _npmVersionCacheTs = 0;
+const NPM_CHECK_INTERVAL = 4 * 60 * 60 * 1000; // 4 hours
+const PKG_NAME = '@yemi33/minions';
+
+async function checkNpmVersion() {
+  const now = Date.now();
+  if (_npmVersionCache && (now - _npmVersionCacheTs) < NPM_CHECK_INTERVAL) return _npmVersionCache;
+  try {
+    const https = require('https');
+    const data = await new Promise((resolve, reject) => {
+      const req = https.get(`https://registry.npmjs.org/${PKG_NAME}/latest`, { timeout: 5000 }, (res) => {
+        let body = '';
+        res.on('data', c => body += c);
+        res.on('end', () => { try { resolve(JSON.parse(body)); } catch { reject(new Error('bad json')); } });
+      });
+      req.on('error', reject);
+      req.on('timeout', () => { req.destroy(); reject(new Error('timeout')); });
+    });
+    _npmVersionCache = { latest: data.version || null, checkedAt: new Date().toISOString() };
+    _npmVersionCacheTs = now;
+  } catch {
+    _npmVersionCache = _npmVersionCache || { latest: null, checkedAt: null, error: 'check failed' };
+  }
+  return _npmVersionCache;
+}
+
+function _compareVersions(a, b) {
+  const pa = (a || '').split('.').map(Number);
+  const pb = (b || '').split('.').map(Number);
+  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+    if ((pa[i] || 0) > (pb[i] || 0)) return 1;
+    if ((pa[i] || 0) < (pb[i] || 0)) return -1;
+  }
+  return 0;
+}
+
+// Kick off first npm check on startup (non-blocking)
+checkNpmVersion().catch(() => {});
+
 function getMcpServers() {
   try {
     const home = os.homedir();
@@ -248,6 +289,23 @@ function getStatus() {
     },
     initialized: !!(CONFIG.agents && Object.keys(CONFIG.agents).length > 0),
     installId: safeRead(path.join(MINIONS_DIR, '.install-id')).trim() || null,
+    version: (() => {
+      const engine = getEngineState();
+      let diskVersion = null;
+      try { diskVersion = require('./package.json').version; } catch {}
+      let diskCommit = null;
+      try { diskCommit = require('child_process').execSync('git rev-parse --short HEAD', { cwd: MINIONS_DIR, encoding: 'utf8', timeout: 5000, windowsHide: true }).trim(); } catch {}
+      return {
+        running: engine.codeVersion || null,
+        runningCommit: engine.codeCommit || null,
+        disk: diskVersion,
+        diskCommit,
+        stale: !!(engine.codeVersion && diskVersion && engine.codeVersion !== diskVersion) ||
+               !!(engine.codeCommit && diskCommit && engine.codeCommit !== diskCommit),
+        latest: _npmVersionCache?.latest || null,
+        updateAvailable: !!(diskVersion && _npmVersionCache?.latest && _npmVersionCache.latest !== diskVersion && _compareVersions(_npmVersionCache.latest, diskVersion) > 0),
+      };
+    })(),
     timestamp: new Date().toISOString(),
   };
   _statusCacheTs = now;
@@ -3352,6 +3410,20 @@ What would you like to discuss or change? When you're happy, say "approve" and I
 
   const ROUTES = [
     // Routes endpoint (self-describing API)
+    { method: 'GET', path: '/api/version', desc: 'Current + latest version info with update check', handler: async (req, res) => {
+      const npm = await checkNpmVersion();
+      let diskVersion = null;
+      try { diskVersion = require('./package.json').version; } catch {}
+      const engine = getEngineState();
+      return jsonReply(res, 200, {
+        current: diskVersion,
+        running: engine.codeVersion || null,
+        latest: npm.latest,
+        updateAvailable: !!(diskVersion && npm.latest && _compareVersions(npm.latest, diskVersion) > 0),
+        stale: !!(engine.codeVersion && diskVersion && engine.codeVersion !== diskVersion),
+        checkedAt: npm.checkedAt,
+      });
+    }},
     { method: 'GET', path: '/api/routes', desc: 'List all available API endpoints', handler: (req, res) => {
       const list = ROUTES.map(r => ({
         method: r.method,

package/engine/cli.js

@@ -84,7 +84,12 @@ const commands = {
       console.log(`Engine was running (PID ${control.pid}) but process is dead — restarting.`);
     }
 
-    safeWrite(CONTROL_PATH, { state: 'running', pid: process.pid, started_at: e.ts() });
+    // Record version + git commit so dashboard can detect stale engine code
+    let codeVersion = null;
+    try { codeVersion = require('../package.json').version; } catch {}
+    let codeCommit = null;
+    try { codeCommit = require('child_process').execSync('git rev-parse --short HEAD', { cwd: path.resolve(__dirname, '..'), encoding: 'utf8', timeout: 5000, windowsHide: true }).trim(); } catch {}
+    safeWrite(CONTROL_PATH, { state: 'running', pid: process.pid, started_at: e.ts(), codeVersion, codeCommit });
     e.log('info', 'Engine started');
     console.log(`Engine started (PID: ${process.pid})`);
 

package/package.json

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