@yemi33/minions 0.1.2305 → 0.1.2306

package/dashboard/js/refresh.js

@@ -134,7 +134,8 @@ const RENDER_VERSIONS = {
   prdProgress: 2,
   prdPrs: 1,
   inbox: 2,
-  projects: 4,
+  // Bumped 4→5 for the clickable checkout-mode pill + picker (W-mr1b67zi0006b788).
+  projects: 5,
   notes: 1,
   prd: 3,
   prs: 3,
@@ -147,7 +148,7 @@ const RENDER_VERSIONS = {
   dispatch: 2,
   engineLog: 2,
   metrics: 1,
-  workItems: 6,
+  workItems: 7,
   skills: 1,
   commands: 1,
   mcpServers: 1,
@@ -1066,8 +1067,17 @@ let _refreshInFlight = false;
 // it's not obvious the dashboard itself is dead (vs. wedged, vs. the
 // engine being down).
 //
-// Trip conditions: 2 consecutive failed polls OR >12 s since the last
-// success (3× the 4 s poll cadence, so a single flaky tick doesn't fire).
+// Trip conditions (2026-06-30): SUSTAINED failure only — the banner must never
+// flash while the dashboard is merely slow. 3 consecutive failed polls
+// (timeout/abort or 5xx). At the 4s cadence a wedged dashboard aborts each poll
+// at safeFetch's 15s timeout, so 3 in a row is ~45s of continuous
+// unresponsiveness — well beyond the legitimate 15-25s cold getStatus() rebuild
+// documented in restart-health.js. A truly-dead dashboard still trips promptly
+// (~12s) because connection-refused rejects fast rather than waiting out the
+// 15s timeout. The old "> N seconds since last success" OR side was REMOVED:
+// aborts during a healthy cold rebuild pushed elapsed-time past the budget and
+// surfaced the banner while the dashboard was alive-but-busy. Consecutive
+// failures are the only reliable "actually unreachable" signal.
 // On trip we show a sticky red banner with two recovery actions:
 //   1. "Restart Minions"  → ccRestartMinions (works when dashboard is
 //      alive-but-stale; falls through to copy-to-clipboard when the POST
@@ -1080,14 +1090,7 @@ let _lastStatusOkAt = Date.now();
 let _consecutiveStatusFails = 0;
 let _unreachableSince = 0; // 0 = currently reachable
 let _unreachableAgeTimer = null;
-// 3 + 20s (was 2 + 12s) — the prior thresholds tripped a banner on a single
-// safeFetch abort (timeout 15s in state.js) because the OR'd age side was
-// already satisfied. With safeFetch=15s, the age budget needs >15s to avoid
-// the trip-on-first-slow-response footgun. 3 consecutive fails ≈ 12s of real
-// outage at the 4s poll cadence, which still surfaces the banner promptly
-// during a real dashboard crash but tolerates one slow rebuild + retry.
 const _UNREACHABLE_FAIL_THRESHOLD = 3;
-const _UNREACHABLE_AGE_MS = 20000;
 // Once the banner is up we throttle polls (exponential, capped at 30s) to
 // avoid hammering a struggling dashboard / network. Reset on recovery.
 let _nextPollAllowedAt = 0;
@@ -1345,8 +1348,9 @@ async function refresh(opts) {
       _diagEntry.error_message = String((e && e.message) || e);
     }
     _consecutiveStatusFails++;
-    const ageMs = Date.now() - _lastStatusOkAt;
-    if (_consecutiveStatusFails >= _UNREACHABLE_FAIL_THRESHOLD || ageMs > _UNREACHABLE_AGE_MS) {
+    // Sustained failure only — see the detector header for why elapsed time
+    // alone must not trip (it flashed the banner on healthy-but-slow rebuilds).
+    if (_consecutiveStatusFails >= _UNREACHABLE_FAIL_THRESHOLD) {
       _markDashboardUnreachable(e);
     }
     // Backoff: once we've tripped the banner, throttle subsequent polls

package/dashboard/js/render-other.js

@@ -96,18 +96,266 @@ function _renderProjectBranch(p) {
 // is set, coding WIs author in isolated worktrees and only the named validation
 // type runs in-place on the live checkout. This is a materially different
 // dispatch profile from full-live, so it gets its own pill.
+// W-mr1b67zi0006b788: the pill is clickable — opens an inline picker (see
+// _openCheckoutModeMenu below) to switch between Worktrees / Live checkout /
+// Hybrid dispatch modes without leaving the Projects view. Shared
+// data-checkout-pill / role="button" / tabindex / aria-haspopup attributes
+// are attached to all three pill variants; the delegated listener wired at
+// the bottom of this file reads data-checkout-pill to know which project to
+// open the menu for.
 function _renderWorktreeModePill(p) {
   if (!p) return '';
+  const name = escHtml(p.name);
+  const common = ' data-checkout-pill="' + name + '" role="button" tabindex="0" aria-haspopup="true" aria-label="Change checkout mode"';
   if (p.checkoutMode === 'live') {
     if (p.liveValidationType) {
       const vt = escapeHtml(p.liveValidationType);
-      return ' <span class="project-mode-pill project-mode-hybrid" title="Hybrid live-validation — coding work items author in isolated worktrees; only the &quot;' + vt + '&quot; validation type runs in-place on the live checkout (capped to one mutating dispatch, refused on a dirty tree)">⚡ Hybrid · ' + vt + '</span>';
+      return ' <span class="project-mode-pill project-mode-hybrid project-mode-pill-clickable"' + common + ' title="Hybrid live-validation — coding work items author in isolated worktrees; only the &quot;' + vt + '&quot; validation type runs in-place on the live checkout (capped to one mutating dispatch, refused on a dirty tree). Click to change.">⚡ Hybrid · ' + vt + '</span>';
     }
-    return ' <span class="project-mode-pill project-mode-live" title="Live-checkout dispatch mode — agents run in-place inside the project working tree (no isolated worktree); capped to one mutating dispatch and refused on a dirty tree">⚡ Live checkout</span>';
+    return ' <span class="project-mode-pill project-mode-live project-mode-pill-clickable"' + common + ' title="Live-checkout dispatch mode — agents run in-place inside the project working tree (no isolated worktree); capped to one mutating dispatch and refused on a dirty tree. Click to change.">⚡ Live checkout</span>';
   }
-  return ' <span class="project-mode-pill project-mode-isolated" title="Worktree dispatch mode (default) — each agent runs in its own git worktree">Worktrees</span>';
+  return ' <span class="project-mode-pill project-mode-isolated project-mode-pill-clickable"' + common + ' title="Worktree dispatch mode (default) — each agent runs in its own git worktree. Click to change.">Worktrees</span>';
 }
 
+// Work-item types eligible for hybrid live-validation (W-mr1b67zi0006b788).
+// Mirrors the set the server documents for project.liveValidation.type;
+// intentionally excludes the illustrative "build-and-test" example from the
+// server comments since that isn't a real WORK_TYPE value.
+const CHECKOUT_MODE_HYBRID_TYPES = ['implement', 'fix', 'docs', 'decompose', 'explore', 'ask', 'review', 'test', 'verify', 'setup'];
+const CHECKOUT_MODE_HYBRID_DEFAULT_TYPE = 'test';
+
+function _findProjectInLastStatus(name) {
+  const projects = window._lastStatus && window._lastStatus.projects;
+  if (!Array.isArray(projects)) return null;
+  return projects.find(function(p) { return p.name === name; }) || null;
+}
+
+function _closeCheckoutModeMenu() {
+  const existing = document.getElementById('checkout-mode-menu');
+  if (existing) existing.remove();
+  document.removeEventListener('mousedown', _checkoutModeMenuOutsideClick, true);
+  document.removeEventListener('keydown', _checkoutModeMenuKeydown, true);
+}
+
+function _checkoutModeMenuOutsideClick(e) {
+  const menu = document.getElementById('checkout-mode-menu');
+  if (!menu) return;
+  if (menu.contains(e.target)) return;
+  if (e.target.closest && e.target.closest('[data-checkout-pill]')) return;
+  _closeCheckoutModeMenu();
+}
+
+function _checkoutModeMenuKeydown(e) {
+  if (e.key === 'Escape') _closeCheckoutModeMenu();
+}
+
+// Builds and positions the checkout-mode picker popover beneath the clicked
+// pill. No innerHTML is used here (createElement/textContent throughout) to
+// stay clear of the innerHTML lint gate (npm run lint).
+function _openCheckoutModeMenu(projectName, anchorEl) {
+  _closeCheckoutModeMenu();
+  const project = _findProjectInLastStatus(projectName);
+  if (!project) return;
+
+  const menu = document.createElement('div');
+  menu.id = 'checkout-mode-menu';
+  menu.className = 'checkout-mode-menu';
+  menu.setAttribute('role', 'menu');
+
+  const title = document.createElement('div');
+  title.className = 'checkout-mode-menu-title';
+  title.textContent = 'Checkout mode — ' + projectName;
+  menu.appendChild(title);
+
+  function addItem(labelText, mode, descText) {
+    const item = document.createElement('div');
+    item.className = 'checkout-mode-menu-item';
+    item.setAttribute('role', 'menuitemradio');
+    item.tabIndex = 0;
+    const label = document.createElement('div');
+    label.className = 'checkout-mode-menu-item-label';
+    label.textContent = labelText;
+    item.appendChild(label);
+    if (descText) {
+      const desc = document.createElement('div');
+      desc.className = 'checkout-mode-menu-item-desc';
+      desc.textContent = descText;
+      item.appendChild(desc);
+    }
+    const isActive = (mode === 'worktree' && project.checkoutMode !== 'live')
+      || (mode === 'live' && project.checkoutMode === 'live' && !project.liveValidationType)
+      || (mode === 'hybrid' && project.checkoutMode === 'live' && !!project.liveValidationType);
+    if (isActive) {
+      item.setAttribute('aria-checked', 'true');
+      item.classList.add('checkout-mode-menu-item-active');
+    } else {
+      item.setAttribute('aria-checked', 'false');
+    }
+    item.addEventListener('click', function() {
+      if (mode === 'hybrid') {
+        _renderCheckoutModeHybridStep(menu, projectName);
+        return;
+      }
+      _closeCheckoutModeMenu();
+      _applyCheckoutModeChange(projectName, mode === 'live' ? 'live' : 'worktree', null);
+    });
+    item.addEventListener('keydown', function(e) {
+      if (e.key === 'Enter' || e.key === ' ') { e.preventDefault(); item.click(); }
+    });
+    menu.appendChild(item);
+  }
+
+  addItem('Worktrees (default)', 'worktree', 'Each dispatch runs in its own isolated git worktree. Fully parallel, never touches your working directory.');
+  addItem('Live checkout', 'live', 'Agents run in-place in the project folder. One mutating dispatch at a time; refuses to run on a dirty tree.');
+  addItem('Hybrid dispatch…', 'hybrid', 'Coding work authors in isolated worktrees; only a chosen validation step (e.g. build-and-test) runs on the real checkout.');
+
+  document.body.appendChild(menu);
+  const rect = anchorEl.getBoundingClientRect();
+  menu.style.position = 'absolute';
+  menu.style.top = (window.scrollY + rect.bottom + 4) + 'px';
+  menu.style.left = (window.scrollX + rect.left) + 'px';
+
+  document.addEventListener('mousedown', _checkoutModeMenuOutsideClick, true);
+  document.addEventListener('keydown', _checkoutModeMenuKeydown, true);
+  const first = menu.querySelector('.checkout-mode-menu-item');
+  if (first) first.focus();
+}
+
+// Second step of the picker for hybrid mode: pick which work-item type runs
+// in-place on the live checkout while everything else authors in isolated
+// worktrees. Renders a <select> + Back/Apply into the existing menu element.
+function _renderCheckoutModeHybridStep(menu, projectName) {
+  const project = _findProjectInLastStatus(projectName);
+  while (menu.firstChild) menu.removeChild(menu.firstChild);
+
+  const title = document.createElement('div');
+  title.className = 'checkout-mode-menu-title';
+  title.textContent = 'Hybrid dispatch — ' + projectName;
+  menu.appendChild(title);
+
+  const label = document.createElement('div');
+  label.className = 'checkout-mode-menu-item';
+  label.textContent = 'Work-item type to validate live:';
+  menu.appendChild(label);
+
+  const select = document.createElement('select');
+  select.className = 'checkout-mode-menu-select';
+  CHECKOUT_MODE_HYBRID_TYPES.forEach(function(t) {
+    const opt = document.createElement('option');
+    opt.value = t;
+    opt.textContent = t;
+    select.appendChild(opt);
+  });
+  select.value = (project && project.liveValidationType && CHECKOUT_MODE_HYBRID_TYPES.includes(project.liveValidationType))
+    ? project.liveValidationType
+    : CHECKOUT_MODE_HYBRID_DEFAULT_TYPE;
+  menu.appendChild(select);
+
+  const actions = document.createElement('div');
+  actions.className = 'checkout-mode-menu-actions';
+
+  const backBtn = document.createElement('button');
+  backBtn.type = 'button';
+  backBtn.className = 'checkout-mode-menu-btn';
+  backBtn.textContent = 'Back';
+  backBtn.addEventListener('click', function() {
+    const anchor = document.querySelector('[data-checkout-pill="' + CSS.escape(projectName) + '"]');
+    _closeCheckoutModeMenu();
+    if (anchor) _openCheckoutModeMenu(projectName, anchor);
+  });
+  actions.appendChild(backBtn);
+
+  const applyBtn = document.createElement('button');
+  applyBtn.type = 'button';
+  applyBtn.className = 'checkout-mode-menu-btn checkout-mode-menu-btn-primary';
+  applyBtn.textContent = 'Apply';
+  applyBtn.addEventListener('click', function() {
+    const type = select.value;
+    _closeCheckoutModeMenu();
+    _applyCheckoutModeChange(projectName, 'live', type);
+  });
+  actions.appendChild(applyBtn);
+
+  menu.appendChild(actions);
+}
+
+// Applies a checkout-mode change: confirms via confirmDialog(), optimistically
+// flips the cached project entry and re-renders BEFORE awaiting the network
+// call (mirrors projectChipRemove / removePinnedNote), then POSTs to
+// /api/settings. On failure, reverts the optimistic flip, re-renders, and
+// shows an error toast.
+async function _applyCheckoutModeChange(projectName, newMode, liveValidationType) {
+  const project = _findProjectInLastStatus(projectName);
+  if (!project) return;
+  const label = newMode === 'worktree'
+    ? 'Worktrees'
+    : (liveValidationType ? ('Hybrid (' + liveValidationType + ')') : 'Live checkout');
+  const ok = await confirmDialog({
+    title: 'Change checkout mode?',
+    message: 'Switch "' + projectName + '" to ' + label + '? This changes how every future dispatch on this project runs.',
+    confirmLabel: 'Change mode',
+    cancelLabel: 'Cancel',
+    danger: newMode !== 'worktree',
+  });
+  if (!ok) return;
+
+  const prevMode = project.checkoutMode;
+  const prevType = project.liveValidationType;
+  const nextType = (newMode === 'live' && liveValidationType) ? liveValidationType : null;
+  // Optimistic flip BEFORE awaiting the API call (per dashboard convention —
+  // see projectChipRemove / removePinnedNote); reverted in the catch below.
+  project.checkoutMode = newMode;
+  project.liveValidationType = nextType;
+  if (window._lastStatus && Array.isArray(window._lastStatus.projects)) renderProjects(window._lastStatus.projects);
+
+  try {
+    const res = await safeFetch('/api/settings', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        projects: [{
+          name: projectName,
+          checkoutMode: newMode,
+          liveValidation: nextType ? { type: nextType } : null,
+        }],
+      }),
+    });
+    const result = await res.json().catch(function() { return {}; });
+    if (!res.ok) throw new Error((result && result.error) || ('HTTP ' + res.status));
+    showToast('cmd-toast', 'Checkout mode updated for "' + projectName + '".', true);
+  } catch (err) {
+    project.checkoutMode = prevMode;
+    project.liveValidationType = prevType;
+    if (window._lastStatus && Array.isArray(window._lastStatus.projects)) renderProjects(window._lastStatus.projects);
+    showToast('cmd-toast', 'Failed to update checkout mode: ' + (err && err.message || err), false);
+  }
+}
+
+// Delegated click/keydown on the persistent #projects-list container (its
+// children are replaced wholesale on every renderProjects() call, but the
+// container itself survives re-renders — see the Long-Running Commands /
+// event-delegation convention referenced in the playbook).
+(function _wireCheckoutModePillDelegation() {
+  const list = document.getElementById('projects-list');
+  if (!list) return;
+  list.addEventListener('click', function(e) {
+    const pill = e.target.closest('[data-checkout-pill]');
+    if (!pill) return;
+    e.stopPropagation();
+    const name = pill.getAttribute('data-checkout-pill');
+    _openCheckoutModeMenu(name, pill);
+  });
+  list.addEventListener('keydown', function(e) {
+    if (e.key !== 'Enter' && e.key !== ' ') return;
+    const pill = e.target.closest('[data-checkout-pill]');
+    if (!pill) return;
+    e.preventDefault();
+    e.stopPropagation();
+    const name = pill.getAttribute('data-checkout-pill');
+    _openCheckoutModeMenu(name, pill);
+  });
+})();
+
 function _projectCachePath(project) {
   return String((project && (project.localPath || project.path)) || '').replace(/\\/g, '/');
 }

package/dashboard/js/render-plans.js

@@ -371,7 +371,7 @@ function renderPlans(plans) {
       'onclick="event.stopPropagation();planDelete(\'' + escapeHtml(p.file) + '\')">Delete</button>' : '';
 
     const versionBadge = p.version ? ' <span style="font-size:var(--text-xs);font-weight:700;padding:1px 5px;border-radius:3px;background:rgba(56,139,253,0.15);color:var(--blue);vertical-align:middle">v' + p.version + '</span>' : '';
-    const statusColors = { 'completed': 'var(--green)', 'dispatched': 'var(--blue)', 'converting': 'var(--yellow)', 'paused': 'var(--muted)', 'awaiting-approval': 'var(--yellow)', 'approved': 'var(--green)', 'rejected': 'var(--red)', 'has-failures': 'var(--red)', 'revision-requested': 'var(--purple,#a855f7)', 'active': 'var(--muted)', 'draft': 'var(--muted)' };
+    const statusColors = { 'completed': 'var(--green)', 'dispatched': 'var(--blue)', 'converting': 'var(--yellow)', 'paused': 'var(--muted)', 'awaiting-approval': 'var(--yellow)', 'approved': 'var(--purple,#a855f7)', 'rejected': 'var(--red)', 'has-failures': 'var(--red)', 'revision-requested': 'var(--purple,#a855f7)', 'active': 'var(--muted)', 'draft': 'var(--muted)' };
     const cardClass = effectiveStatus === 'dispatched' || effectiveStatus === 'converting' ? 'working' : effectiveStatus === 'awaiting-approval' || effectiveStatus === 'paused' ? 'awaiting' : effectiveStatus;
     // P-e8d49105 — cross-repo plans surface every touched project as its
     // own badge. Single-project plans (and old PRDs without _projects)

package/dashboard/js/render-prs.js

@@ -646,7 +646,10 @@ async function togglePrObserve(btn) {
   try {
     const res = await fetch('/api/pull-requests/observe', {
       method: 'POST', headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ host, slug, number, observe: next })
+      // Canonical contextOnly is the primary payload (P-2b6e4d81); the
+      // legacy `observe` body param remains a server-side back-compat
+      // fallback for any other caller, so the client no longer sends it.
+      body: JSON.stringify({ host, slug, number, contextOnly: !next })
     });
     if (!res.ok) {
       const d = await res.json().catch(() => ({}));

package/dashboard/js/render-utils.js

@@ -114,6 +114,19 @@ function ccSegmentsApplyChunk(segments, text, segmentId) {
   var last = segments.length ? segments[segments.length - 1] : null;
   if (hasId) {
     if (last && last.kind === 'text' && last.id === segmentId) { last.text = text; return segments; }
+    // W-mr1bgfyr — a reconnect replay (or any other id-less push, see the
+    // heuristic branch below) leaves the trailing text segment with `id:
+    // null` even though the resumed live stream now carries a real
+    // segmentId for that SAME logical block. Without this, the id
+    // mismatch (null !== segmentId) opened a brand-new duplicate text
+    // segment on every following chunk, rendering as a second bubble/block
+    // stacked under the first with a little more text each time instead of
+    // updating in place. Adopt the id and merge into the existing segment.
+    if (last && last.kind === 'text' && last.id === null) {
+      last.text = _ccSegMergeText(last.text, text);
+      last.id = segmentId;
+      return segments;
+    }
     segments.push({ kind: 'text', id: segmentId, text: text });
     return segments;
   }

package/dashboard/js/render-work-items.js

@@ -876,10 +876,17 @@ function _wiRenderDetail(item) {
   // Artifacts — branch (non-navigation) + navigation chips routed through
   // renderArtifactLink so chip click → openArtifact() → modal-stack push +
   // URL hash + browser-Back integration come for free (P-e265cd31).
-  // P-79b47b0c — also surface item._source (the WI's raw source file) as a
-  // dedicated chip when it isn't already covered by arts.plan / arts.prd /
-  // arts.sourcePlan. Chip type is inferred from the file extension (.md →
-  // plan, .json → prd).
+  // NOTE (issue #603): item._source is the WI's *project name* (stamped by
+  // fetchWorkItemsFromDisk above / used by every action button to route
+  // retry/cancel/delete/etc.), NOT a plan/PRD file id. A prior "Source" chip
+  // here treated item._source as if it held a genuine source-plan/PRD
+  // filename, which rendered a bogus chip labeled with the project name on
+  // nearly every work item and 404'd when clicked (there is no plan/PRD
+  // named e.g. "src"). The genuine source-plan/PRD case is already fully
+  // covered by arts.plan / arts.prd / arts.sourcePlan below, which are
+  // populated server-side from the WI's real sourcePlan/_planFileName/
+  // planFile fields (engine/queries.js) — no separate item._source-based
+  // chip is needed.
   var arts = item._artifacts || {};
   var artPills = '';
   var branchStyle = 'display:inline-flex;align-items:center;gap:3px;padding:2px 8px;border-radius:10px;font-size:var(--text-sm);background:var(--surface2);border:1px solid var(--border);color:var(--text);cursor:default';
@@ -887,15 +894,6 @@ function _wiRenderDetail(item) {
   if (arts.plan) artPills += renderArtifactLink({ type: 'plan', id: arts.plan, label: 'Plan' }) + ' ';
   if (arts.prd) artPills += renderArtifactLink({ type: 'prd', id: arts.prd, label: 'PRD' }) + ' ';
   if (arts.sourcePlan) artPills += renderArtifactLink({ type: 'plan', id: arts.sourcePlan, label: 'Source Plan' }) + ' ';
-  // Source chip (item._source) — render when it's a file path that isn't
-  // already represented in arts.plan / arts.prd / arts.sourcePlan.
-  if (item._source && typeof item._source === 'string' && item._source !== 'central') {
-    var sourceAlreadyShown = arts.plan === item._source || arts.prd === item._source || arts.sourcePlan === item._source;
-    if (!sourceAlreadyShown) {
-      var sourceType = item._source.endsWith('.json') ? 'prd' : 'plan';
-      artPills += renderArtifactLink({ type: sourceType, id: item._source, label: 'Source', title: item._source }) + ' ';
-    }
-  }
   if (arts.notes && arts.notes.length > 0) {
     arts.notes.forEach(function(n) {
       var noteFile = (n && typeof n === 'object') ? (n.file || n) : String(n || '');

package/dashboard/js/settings.js

@@ -282,8 +282,8 @@ async function openSettings() {
       '<div data-search="' + escHtml(wtModeSearch) + '" style="margin-bottom:6px">' +
         '<label style="font-size:var(--text-sm);color:var(--muted);display:block;margin-bottom:2px">Checkout mode</label>' +
         '<select id="set-checkoutMode-' + escHtml(p.name) + '" data-checkout-mode-select="' + escHtml(p.name) + '" style="width:100%;padding:4px 6px;background:var(--surface);border:1px solid var(--border);border-radius:4px;color:var(--text);font-size:var(--text-md)">' +
-          '<option value="worktree"' + (currentWtMode === 'worktree' ? ' selected' : '') + '>Worktree (default)</option>' +
-          '<option value="live"' + (currentWtMode === 'live' ? ' selected' : '') + '>Live checkout</option>' +
+          '<option value="worktree" title="Each dispatch runs in its own isolated git worktree. Fully parallel, never touches your working directory."' + (currentWtMode === 'worktree' ? ' selected' : '') + '>Worktree (default)</option>' +
+          '<option value="live" title="Agents run in-place in the project folder. One mutating dispatch at a time; refuses to run on a dirty tree."' + (currentWtMode === 'live' ? ' selected' : '') + '>Live checkout</option>' +
         '</select>' +
         '<div data-checkout-mode-chip="' + escHtml(p.name) + '" style="' + (currentWtMode === 'live' ? '' : 'display:none;') + 'margin-top:6px;padding:6px 8px;background:rgba(234,179,8,0.12);border:1px solid var(--yellow);border-radius:4px;color:var(--yellow);font-size:var(--text-xs);line-height:1.4">' +
           '⚠ Live mode: dispatches run directly in this repo\'s checkout. Only one mutating dispatch runs at a time. Dirty working trees block dispatch — commit or stash before running.' +
@@ -384,7 +384,7 @@ async function openSettings() {
       settingsToggle('Auto-reap orphan worktree holders', 'set-autoReapOrphanWorktreeHolders', !!e.autoReapOrphanWorktreeHolders,
         'When ON, the periodic orphan-worktree sweep automatically kills unambiguous orphan `spawn-agent.js` processes holding a stuck worktree\'s cwd (Windows file-lock pattern, e.g. W-mq1k8z6o003acd89 / PID 16828). Safe-reap criteria: cmdline must match spawn-agent.js, reference the worktree basename, AND process age must exceed `engine.agentTimeout * 2`. Default OFF because killing a foreign process is destructive. The holder SCAN runs either way and is appended to the escalation inbox note.') +
       settingsToggle('Live-checkout auto-reset (fleet-wide)', 'set-liveCheckoutAutoReset', !!e.liveCheckoutAutoReset,
-        'When ON, a dirty or broken live-checkout (in-place) tree is force-recovered before dispatch via `git fetch origin` + `git reset --hard origin/<branch>` instead of failing the dispatch with non-retryable LIVE_CHECKOUT_DIRTY. This is the FLEET-WIDE fallback; a per-project `liveCheckoutAutoReset` in config.json overrides it. Default OFF because the reset is DESTRUCTIVE — it discards the operator\'s uncommitted changes in the live checkout (a `live-checkout-autoreset-<workItem>` inbox note records exactly what was discarded for reflog recovery). Only affects projects running in live/in-place checkout mode.') +
+        'When ON, a dirty or broken live-checkout (in-place) tree is force-recovered before dispatch via `git fetch origin` + `git reset --hard origin/<branch>` instead of failing the dispatch with non-retryable LIVE_CHECKOUT_DIRTY. This is the FLEET-WIDE fallback; a per-project `liveCheckoutAutoReset` in config.json overrides it. Default ON — discarding disposable dirt keeps live-checkout branches aligned with origin instead of accumulating auto-save WIP commits; the reset is DESTRUCTIVE (it discards the operator\'s uncommitted changes in the live checkout, and a `live-checkout-autoreset-<workItem>` inbox note records exactly what was discarded for reflog recovery), so set it OFF for live checkouts whose local drift you want preserved. Only affects projects running in live/in-place checkout mode.') +
     '</div>' +
     '<div class="settings-grid-2">' +
       settingsField('CC Session Idle Timeout', 'set-ccWorkerIdleTimeoutMs', Math.round((e.ccWorkerIdleTimeoutMs || 1800000) / 60000), 'minutes', 'How long a persistent `copilot --acp` CC worker stays warm with no activity before the idle reaper kills it. After a reap the next message cold-spawns a FRESH session with no memory of prior turns and CC shows a "context cleared after inactivity" notice. Shorter = less idle memory/process footprint; longer = more context durability across gaps between messages. Only affects the Copilot worker-pool path (CC Worker Pool ON). Clamped 1–480 minutes.') +

package/dashboard/styles.css

@@ -1288,6 +1288,64 @@
   .project-mode-live { background: rgba(210,153,34,0.15); color: var(--yellow); border: 1px solid var(--yellow); }
   .project-mode-hybrid { background: rgba(88,166,255,0.15); color: var(--blue); border: 1px solid var(--blue); }
 
+  /* Clickable checkout-mode pill (W-mr1b67zi0006b788) — swaps the "help"
+   * cursor for "pointer" and adds a hover/focus highlight so it reads as
+   * interactive, opening the picker in _openCheckoutModeMenu(). */
+  .project-mode-pill-clickable { cursor: pointer; }
+  .project-mode-pill-clickable:hover,
+  .project-mode-pill-clickable:focus-visible {
+    filter: brightness(1.2);
+    outline: 1px solid var(--blue);
+    outline-offset: 1px;
+  }
+
+  /* Checkout-mode picker popover (W-mr1b67zi0006b788). Rendered via
+   * document.createElement in _openCheckoutModeMenu (no innerHTML), appended
+   * to <body> and positioned under the clicked pill. */
+  .checkout-mode-menu {
+    z-index: 1000;
+    min-width: 220px;
+    background: var(--surface2);
+    border: 1px solid var(--border);
+    border-radius: var(--radius-md, 6px);
+    box-shadow: 0 4px 16px rgba(0,0,0,0.3);
+    padding: 6px;
+    font-size: var(--text-sm);
+  }
+  .checkout-mode-menu-title {
+    font-weight: 600; color: var(--muted);
+    padding: 4px 8px 6px; border-bottom: 1px solid var(--border);
+    margin-bottom: 4px;
+  }
+  .checkout-mode-menu-item {
+    padding: 6px 8px; border-radius: 4px; cursor: pointer;
+    color: var(--text);
+  }
+  .checkout-mode-menu-item:hover,
+  .checkout-mode-menu-item:focus {
+    background: var(--surface); outline: none;
+  }
+  .checkout-mode-menu-item-active { color: var(--blue); font-weight: 600; }
+  .checkout-mode-menu-item-desc {
+    font-size: var(--text-xs); color: var(--muted); font-weight: 400;
+    margin-top: 2px; line-height: 1.35;
+  }
+  .checkout-mode-menu-select {
+    width: 100%; margin: 4px 0 8px; padding: 4px 6px;
+    background: var(--surface); color: var(--text); border: 1px solid var(--border);
+    border-radius: 4px;
+  }
+  .checkout-mode-menu-actions {
+    display: flex; justify-content: flex-end; gap: 6px; padding-top: 4px;
+  }
+  .checkout-mode-menu-btn {
+    padding: 4px 10px; border-radius: 4px; border: 1px solid var(--border);
+    background: var(--surface); color: var(--text); cursor: pointer; font-size: var(--text-sm);
+  }
+  .checkout-mode-menu-btn-primary {
+    background: var(--blue); color: #fff; border-color: var(--blue);
+  }
+
   /* QA tab (W-mpeiwz6k0005bf34-d) — targets / runbooks / runs sections.
    * Reuses surface/border/text tokens defined in :root so the QA page
    * blends with the rest of the dashboard. */

package/dashboard.js

@@ -1350,12 +1350,15 @@ function linkPullRequestForTracking({ url, title, project: projectName, contextO
 // W-mpmwxkzm0009ba0b — Per-row auto-observe toggle backing helper for
 // POST /api/pull-requests/observe. Flips canonical `contextOnly` on an
 // existing tracked PR record under a lock (per CLAUDE.md mutate convention).
-// Body shape: { host: 'github'|'ado', slug, number, observe: boolean }.
-// The public `observe` body param is preserved for backward compatibility
-// (W-mq5s5ttx000j7ab8-c); internally it maps to `contextOnly = !observe`.
+// Body shape: { host: 'github'|'ado', slug, number, contextOnly: boolean }.
+// `contextOnly` is canonical and read first; the legacy `observe` body
+// param (W-mq5s5ttx000j7ab8-c) is accepted as a documented back-compat
+// fallback (`contextOnly = !observe`) for any caller that still sends it —
+// the dashboard client itself now sends `contextOnly` exclusively
+// (P-2b6e4d81; see docs/deprecated.json#pr-observe-observe-body-param).
 // Returns the updated record + the PR path that was touched. Throws an
 // Error with `statusCode` for the route handler to map to an HTTP status.
-function updatePullRequestObserveFlag({ host, slug, number, observe } = {}, config = CONFIG, minionsDir = MINIONS_DIR) {
+function updatePullRequestObserveFlag({ host, slug, number, observe, contextOnly } = {}, config = CONFIG, minionsDir = MINIONS_DIR) {
   const hostStr = String(host || '').trim().toLowerCase();
   const slugStr = String(slug || '').trim();
   const numberInt = Number.parseInt(number, 10);
@@ -1374,8 +1377,13 @@ function updatePullRequestObserveFlag({ host, slug, number, observe } = {}, conf
     err.statusCode = 400;
     throw err;
   }
-  if (typeof observe !== 'boolean') {
-    const err = new Error('observe must be a boolean');
+  let contextOnlyValue;
+  if (typeof contextOnly === 'boolean') {
+    contextOnlyValue = contextOnly;
+  } else if (typeof observe === 'boolean') {
+    contextOnlyValue = !observe;
+  } else {
+    const err = new Error('contextOnly (or legacy observe) must be a boolean');
     err.statusCode = 400;
     throw err;
   }
@@ -1394,7 +1402,7 @@ function updatePullRequestObserveFlag({ host, slug, number, observe } = {}, conf
     shared.mutatePullRequests(prPath, (prs) => {
       const pr = prs.find(p => p && p.id === canonicalId);
       if (!pr) return prs;
-      pr.contextOnly = !observe;
+      pr.contextOnly = contextOnlyValue;
       updated = { id: pr.id, contextOnly: pr.contextOnly };
       updatedPath = prPath;
       return prs;
@@ -13086,6 +13094,11 @@ What would you like to discuss or change? When you're happy, say "approve" and I
       const inputs = [
         CONFIG_PATH,
         path.join(ENGINE_DIR, 'dispatch.json'),
+        // Central work-items.json at MINIONS_DIR root — backs the 'central'
+        // scope (schedule/pipeline/CC-created rootless WIs, per
+        // work-items-store.js#_filePathForScope). Without this, a new
+        // central-scope WI never busts the ETag until dispatch.json changes.
+        shared.centralWorkItemsPath(MINIONS_DIR),
       ];
       for (const p of projects) {
         if (p && p.name) {
@@ -13106,7 +13119,13 @@ What would you like to discuss or change? When you're happy, say "approve" and I
     { method: 'GET', path: '/api/pull-requests', desc: 'Fully-enriched pull requests (per-project files joined + url backfill + _project stamp)', handler: (req, res) => {
       const config = queries.getConfig();
       const projects = config.projects || [];
-      const inputs = [CONFIG_PATH];
+      const inputs = [
+        CONFIG_PATH,
+        // Central pull-requests.json at MINIONS_DIR root — backs the
+        // 'central' scope per pull-requests-store.js#_filePathForScope.
+        // Mirrors the same class of staleness fix as /api/work-items.
+        shared.centralPullRequestsPath(MINIONS_DIR),
+      ];
       for (const p of projects) {
         if (p && p.name) inputs.push(path.join(MINIONS_DIR, 'projects', p.name, 'pull-requests.json'));
       }
@@ -13137,6 +13156,10 @@ What would you like to discuss or change? When you're happy, say "approve" and I
       const inputs = [
         path.join(ENGINE_DIR, 'metrics.json'),
         path.join(ENGINE_DIR, 'dispatch.json'),
+        // getMetrics() enriches from getPullRequests(), which includes the
+        // central pull-requests.json scope — include it here too so a new
+        // central-scope PR busts the ETag (same class of bug as /api/work-items).
+        shared.centralPullRequestsPath(MINIONS_DIR),
       ];
       for (const p of projects) {
         if (p && p.name) inputs.push(path.join(MINIONS_DIR, 'projects', p.name, 'pull-requests.json'));
@@ -13721,7 +13744,7 @@ What would you like to discuss or change? When you're happy, say "approve" and I
       }
     }},
 
-    { method: 'POST', path: '/api/pull-requests/observe', desc: 'Toggle canonical contextOnly flag on a tracked PR (public `observe` body param is preserved as the inverse for backward compat)', params: 'host (github|ado), slug, number, observe (boolean)', handler: async (req, res) => {
+    { method: 'POST', path: '/api/pull-requests/observe', desc: 'Toggle canonical contextOnly flag on a tracked PR (legacy `observe` body param is preserved as the inverse for backward compat)', params: 'host (github|ado), slug, number, contextOnly (boolean; legacy observe (boolean) also accepted)', handler: async (req, res) => {
       const body = await readBody(req);
       reloadConfig();
       try {