@yemi33/minions 0.1.2231 → 0.1.2232

package/dashboard/js/render-other.js

@@ -38,6 +38,14 @@ function _renderProjectBranch(p) {
   if (p.gitState === 'missing') return '<span class="project-warn" title="Project localPath does not exist on disk">(path not found)</span>';
   if (p.gitState === 'non-git') return '<span class="project-muted" title="Project path exists but is not a git repository">(not a git repo)</span>';
   if (p.gitState !== 'ok' || !p.gitBranch) return '';
+  // opg-microsoft/minions#295: the engine flags `gitStale: true` when tracked
+  // git refs have advanced past the cached snapshot (e.g. the operator ran
+  // `git switch` / `git pull` directly in a live checkout outside the
+  // dashboard). The cached gitBranch/gitDirty are then known-stale — rendering
+  // them would briefly show the OLD branch name as if current. Fall back to a
+  // neutral "refreshing" chip until the async cache refresh lands on the next
+  // poll, rather than presenting a known-stale branch/dirty indicator.
+  if (p.gitStale) return '<span class="project-muted" title="Branch changed outside the dashboard — refreshing…">(refreshing…)</span>';
   const branch = escHtml(p.gitBranch);
   const mainBranch = p.mainBranch ? escHtml(p.mainBranch) : '';
   const remoteDefault = p.remoteDefaultBranch ? escHtml(p.remoteDefaultBranch) : '';

package/dashboard/js/settings.js

@@ -244,7 +244,10 @@ async function openSettings() {
     } catch (e) { liveProj = null; }
     var remoteDefault = (liveProj && liveProj.remoteDefaultBranch) || '';
     var mismatch = !!(liveProj && liveProj.branchMismatch);
-    var localBranch = (liveProj && liveProj.gitBranch) || '';
+    // Suppress the "Local HEAD" hint when the engine flags this status stale
+    // (opg-microsoft/minions#295) — the cached gitBranch is known-stale after
+    // an external checkout change and would show the OLD branch as current.
+    var localBranch = (liveProj && !liveProj.gitStale && liveProj.gitBranch) || '';
     var driftNote = mismatch
       ? '<div style="font-size:var(--text-sm);color:var(--yellow);margin-top:4px">⚠ Configured main (<code>' + escHtml(p.mainBranch || '') + '</code>) differs from origin/HEAD (<code>' + escHtml(remoteDefault) + '</code>) — config is likely stale.</div>'
       : '';

package/engine/queries.js

@@ -2698,12 +2698,23 @@ function getProjectGitStatus(localPath, configuredMainBranch = null) {
   // "behind: 8" after the user has already pulled to current — see
   // yemi33/minions#2848. Null those specific counters so the dashboard
   // shows a pending state for ahead/behind until the background probe
-  // settles; branch and dirty flags stay valid enough on the cached
-  // value (and update on the next poll once the probe lands). TTL-expiry
-  // fall-throughs (refsAdvanced=false) still return the prior counters
-  // because nothing local has actually changed there.
+  // settles. TTL-expiry fall-throughs (refsAdvanced=false) still return the
+  // prior counters because nothing local has actually changed there.
+  //
+  // opg-microsoft/minions#295: gitBranch/gitDirty on the cached value are
+  // ALSO known-stale once refs have advanced (e.g. the operator ran
+  // `git switch` / `git pull` directly in a live checkout outside the
+  // dashboard). The cached value still carries the OLD branch name, so a
+  // consumer rendering `gitBranch` as authoritative briefly shows the
+  // pre-switch branch as if current. We keep the cached gitBranch/gitDirty
+  // on the object (so the next poll can self-correct without a flash of
+  // "missing"), but add a `gitStale: true` marker so render paths can avoid
+  // presenting the known-stale branch/dirty as current and fall back to a
+  // neutral "refreshing" presentation. The async refresh scheduled above
+  // self-corrects on the next poll. We do NOT add a synchronous git probe
+  // here — status rebuild must never block the event loop.
   if (refsAdvanced) {
-    return { ...cached.value, ahead: null, behind: null };
+    return { ...cached.value, ahead: null, behind: null, gitStale: true };
   }
   return cached.value;
 }

package/package.json

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