@yemi33/minions 0.1.384 → 0.1.385

package/CHANGELOG.md

@@ -1,8 +1,9 @@
 # Changelog
 
-## 0.1.384 (2026-04-06)
+## 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)

package/dashboard/js/render-dispatch.js

@@ -215,19 +215,24 @@ function renderVersionBanner(version) {
   if (!el) return;
   if (!version) { el.style.display = 'none'; return; }
 
-  // Show version in footer area
-  const label = version.running ? 'v' + version.running : '';
+  const v = version.running || version.disk || '?';
   const commitLabel = version.runningCommit ? ' (' + version.runningCommit + ')' : '';
-  el.textContent = label + commitLabel;
-  el.title = 'Engine: v' + (version.running || '?') + ' ' + (version.runningCommit || '') +
-    '\nDisk: v' + (version.disk || '?') + ' ' + (version.diskCommit || '');
 
   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 || '?') + ' (' + (version.runningCommit || '?') + ') — disk has v' + (version.disk || '?') + ' (' + (version.diskCommit || '?') + '). Restart to apply.';
+    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)' : '');
   }
 }
 

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();
@@ -261,6 +302,8 @@ function getStatus() {
         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(),
@@ -3367,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/package.json

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