great-cto 3.75.9 → 3.76.0

package/board/packages/board/public/assets/work-view.js

@@ -251,6 +251,84 @@
     svg.dataset.zoom = String(next); svg.setAttribute('width', String(bounds.width * next)); svg.setAttribute('height', String(bounds.height * next));
     return true;
   }
+  // ── Merge readiness (design v12): on top of Overview, filled after the paint because gh is slow. ──
+  const READINESS_MS = 30000;
+  const readiness = new Map();
+  const MARKS = { pass: ['✓', 'passed'], fail: ['✗', 'failed'], 'not-read': ['✗', 'not read'], na: ['–', 'not required'] };
+  const ago = iso => { const min = Math.max(0, Math.round((Date.now() - Date.parse(iso)) / 60000)); return min ? `${min} min ago` : 'just now'; };
+  const safeHref = href => /^https:\/\/(github\.com|claude\.ai)\//.test(href || '') ? href : null;
+  function readinessAction(action) {
+    if (!action) return '';
+    if (action.kind === 'link') return safeHref(action.href) ? `<a class="rdy-link" href="${esc(action.href)}" target="_blank" rel="noopener">${esc(action.label)}</a>` : '';
+    if (action.kind === 'tab') return `<button type="button" class="rdy-link" data-work-tab="${esc(action.tab)}">${esc(action.label)}</button>`;
+    if (action.kind === 'issue') return `<button type="button" class="rdy-link" data-readiness-issue="${esc(action.issue)}"><span class="rdy-wide">${esc(action.label)}</span><span class="rdy-narrow">${esc(action.narrowLabel || action.label)}</span></button>`;
+    if (action.kind === 'copy') return `<button type="button" class="rdy-btn" data-readiness-copy="${esc(action.text)}">${esc(action.label)}</button>`;
+    if (action.kind === 'run-gate') return `<button type="button" class="rdy-btn" data-readiness-run>${esc(action.label)}</button>`;
+    return `<button type="button" class="rdy-btn" disabled>${esc(action.label)}</button>`;
+  }
+  function readinessRow(r) {
+    const [mark, label] = MARKS[r.state] || MARKS['not-read'];
+    const queue = r.queue ? ` New run: <b class="rdy-queue">${esc(r.queue)}</b>` : '';
+    const queueBrief = r.queue ? ` New run <b class="rdy-queue">${esc(r.queueBrief || r.queue)}</b>` : '';
+    const text = `<span class="rdy-detail"><span class="rdy-wide">${esc(r.detail)}${queue}</span><span class="rdy-narrow">${esc(r.brief || r.detail)}${queueBrief}</span></span>`;
+    return `<li class="rdy-row" data-state="${esc(r.state)}"><span class="rdy-mark" aria-label="${label}">${mark}</span><span class="rdy-label">${esc(r.label)}</span>${text}${readinessAction(r.action)}</li>`;
+  }
+  function renderReadiness(card) {
+    const noun = `${card.blockers} blocker${card.blockers === 1 ? '' : 's'}`;
+    const wide = card.ready ? 'Ready to merge' : `Ready to merge? Not yet — ${noun}`;
+    const narrow = card.ready ? 'Ready to merge' : `Not ready — ${noun}`;
+    const when = ago(card.checkedAt);
+    return `<section class="rdy" aria-labelledby="rdy-h" data-ready="${card.ready}"><div class="rdy-head"><div class="rdy-count">${card.ready ? '✓' : card.blockers}</div>`
+      + `<div class="rdy-title"><h2 id="rdy-h"><span class="rdy-wide">${esc(wide)}</span><span class="rdy-narrow">${esc(narrow)}</span></h2>`
+      + `<div class="rdy-sub"><span class="rdy-wide">Checked against head ${esc(card.shortHead)} · ${esc(when)}</span><span class="rdy-narrow">Head ${esc(card.shortHead)} · checked ${esc(when)}</span></div></div>`
+      + `<div class="rdy-note"><span class="rdy-wide">The board does not merge. When every row is green it shows the merge command to copy, or you ask an agent to merge.</span><span class="rdy-narrow">The board does not merge; when all rows pass it shows the command to copy.</span></div></div>`
+      + `<ul class="rdy-rows"><li class="rdy-group" data-group="blockers">BLOCKERS FIRST</li><li class="rdy-group" data-group="passed">PASSED</li>${card.rows.map(readinessRow).join('')}</ul>`
+      + `<div class="rdy-foot">A row that could not be read shows “Not read” and counts as a blocker, never as passed.</div></section>`
+      + (card.mergeCommand ? `<section class="rdy-ok" aria-label="Ready to merge"><span class="rdy-ok-mark" aria-hidden="true">✓</span><b>Ready to merge</b><code>${esc(card.mergeCommand)}</code><button type="button" class="rdy-btn" data-readiness-copy="${esc(card.mergeCommand)}">Copy command</button></section>` : '');
+  }
+  function readinessHtml(state) {
+    if (!state?.card && !state?.failed) return '';
+    if (state.failed) return '<p class="work-warning">Merge readiness could not be read. No row is assumed to pass.</p>';
+    return state.card.branch ? renderReadiness(state.card) : '';
+  }
+  const readinessSlot = entry => `<div data-readiness-slot="${esc(entry.key)}">${readinessHtml(readiness.get(entry.key))}</div>`;
+  async function hydrateReadiness(force = false) {
+    const slot = document.querySelector?.('[data-readiness-slot]');
+    if (!slot) return;
+    const key = slot.dataset.readinessSlot, project = config.project(), held = readiness.get(key);
+    if (!force && held && Date.now() - held.at < READINESS_MS) return;
+    readiness.set(key, { ...held, at: Date.now() });
+    let next;
+    try {
+      const card = await config.read(`/api/work/readiness?task=${encodeURIComponent(key)}${project ? '&project=' + encodeURIComponent(project) : ''}`);
+      next = !card || card.error ? { failed: true, at: Date.now() } : { card, at: Date.now() };
+    } catch { next = { failed: true, at: Date.now() }; }
+    if (project !== config.project()) return;
+    readiness.set(key, next);
+    const live = document.querySelector?.('[data-readiness-slot]');
+    if (live?.dataset.readinessSlot === key) live.innerHTML = readinessHtml(next);
+  }
+  async function readinessClick(event) {
+    const copy = event.target.closest?.('[data-readiness-copy]');
+    if (copy) {
+      try {
+        if (!navigator.clipboard) throw Error('no clipboard');
+        await navigator.clipboard.writeText(copy.dataset.readinessCopy);
+      } catch { status('Could not copy. Select the text and copy it by hand.'); return; }
+      const label = copy.textContent; copy.textContent = 'Copied'; setTimeout(() => { copy.textContent = label; }, 1500);
+      return;
+    }
+    const issue = event.target.closest?.('[data-readiness-issue]');
+    if (issue) { config.openIssue?.(issue.dataset.readinessIssue); return; }
+    const start = event.target.closest?.('[data-readiness-run]');
+    if (!start) return;
+    start.disabled = true;
+    const slot = start.closest('[data-readiness-slot]'), project = config.project();
+    const result = await config.publish(`/api/work/readiness/run-gate?task=${encodeURIComponent(slot.dataset.readinessSlot)}${project ? '&project=' + encodeURIComponent(project) : ''}`, {}).catch(() => null);
+    if (!result || result.error) status(result?.error || 'The gate could not be started.');
+    await hydrateReadiness(true);
+  }
+
   function renderCockpit(data, options = {}) {
     if (options.canvas) return renderWorkspace(data, options);
     const category = categories.some(([key]) => key === options.category) ? options.category : 'active';
@@ -267,7 +345,7 @@
     // Only the selected Overview owns mutation controls; observation tabs cannot duplicate them.
     const detail = tab === 'execution' ? renderExecution(selected) : tab === 'evidence'
       ? (Array.isArray(selected.evidenceSections) && selected.evidenceSections.length ? renderEvidence(selected.evidenceSections).replace('<details ', '<details open ') : '<p>Evidence unavailable. No verification or acceptance is inferred.</p>')
-      : render({ ...data, sources: [], sessions: [], entries: [{ ...selected, inspector: null, evidenceSections: null }] }, selected.terminal);
+      : readinessSlot(selected) + render({ ...data, sources: [], sessions: [], entries: [{ ...selected, inspector: null, evidenceSections: null }] }, selected.terminal);
     return toolbar + (tab === 'overview' ? '' : observed) + feedback + '<p class="work-meta">Running means host activity was recorded; current liveness is not measured. Closed records do not by themselves prove acceptance.</p>'
       + `<div class="work-cockpit">${list}<section class="work-detail" aria-label="Selected task details">${tabs}<div id="work-detail-panel" role="tabpanel" aria-labelledby="work-tab-${tab}" tabindex="0">${detail}</div></section></div>`
       + (data.sessions.length ? `<details><summary>Claude sessions (${data.sessions.length}) · task linkage not recorded</summary>${data.sessions.map(s => `<p>${esc(s.session)} · ${esc(s.state)} · ${esc(s.reason || '')}</p>`).join('')}</details>` : '');
@@ -316,7 +394,7 @@
     const tabs = '<div class="work-tabs" role="tablist" aria-label="Selected task">' + taskTabs.map(name => `<button type="button" class="work-tab" id="work-tab-${name}" data-work-tab="${name}" role="tab" aria-selected="${tab === name}" aria-controls="work-detail-panel" tabindex="${tab === name ? 0 : -1}">${name[0].toUpperCase() + name.slice(1)}</button>`).join('') + '</div>';
     const detail = tab === 'execution' ? renderExecution(selected, { canvas: true, direction: options.direction }) : tab === 'evidence'
       ? (Array.isArray(selected.evidenceSections) && selected.evidenceSections.length ? renderEvidence(selected.evidenceSections).replace('<details ', '<details open ') : '<p>Evidence unavailable. No verification or acceptance is inferred.</p>')
-      : render({ ...data, sources: [], sessions: [], entries: [{ ...selected, inspector: null, evidenceSections: null }] }, selected.terminal);
+      : readinessSlot(selected) + render({ ...data, sources: [], sessions: [], entries: [{ ...selected, inspector: null, evidenceSections: null }] }, selected.terminal);
     const runLabel = selected.title.match(/^Controlled run ([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$/i);
     const title = runLabel ? `Controlled run <small class="work-meta work-run-identifier">${esc(runLabel[1].slice(0, 8))}</small>` : esc(selected.title);
     return `<section class="work-workspace work-detail-only" data-selected-work="${esc(selected.key)}" data-observation-scope="${esc(JSON.stringify([options.observationProject || data.projectId || null, selected.key]))}"><header class="work-task-header"><div class="work-task-navigation">${back}<span class="work-meta">${esc(selected.kind)} · ${esc(selected.host || 'Host not linked')}</span><button type="button" data-work-switch>Switch task</button><button type="button" data-work-previous${rows.findIndex(e => e.key === selected.key) > 0 ? '' : ' disabled'} aria-label="Previous task in current filter">Previous</button><button type="button" data-work-next${rows.findIndex(e => e.key === selected.key) >= 0 && rows.findIndex(e => e.key === selected.key) < rows.length - 1 ? '' : ' disabled'} aria-label="Next task in current filter">Next</button></div><h2>${title}</h2><p>${esc(phaseLabel(selected))}</p></header>${tabs}${feedback}${tab === 'overview' ? '' : observation}<div id="work-detail-panel" role="tabpanel" aria-labelledby="work-tab-${tab}" tabindex="0">${detail}</div></section>`;
@@ -495,6 +573,7 @@
     const graphScroll = oldCanvas?.closest('[data-selected-work]')?.dataset.selectedWork === selectedKey && oldSvg?.dataset.graphLayout === graphDirection ? { left: oldCanvas.scrollLeft, top: oldCanvas.scrollTop } : null;
     document.getElementById('work-list').innerHTML = renderCockpit(snapshot, { search: filter, selectedKey, category, tab, canvas: !!config.canvas, direction: graphDirection, observationProject: snapshotProject });
     document.getElementById('history-list').innerHTML = render(snapshot, true, filter);
+    hydrateReadiness();
     if (graphScroll) {
       const canvas = document.querySelector?.('.execution-graph-canvas'), svg = canvas?.querySelector('svg');
       if (svg && Number.isFinite(oldZoom) && oldZoom > 0) { const bounds = svg.viewBox.baseVal; svg.dataset.zoom = String(oldZoom); svg.setAttribute('width', String(bounds.width * oldZoom)); svg.setAttribute('height', String(bounds.height * oldZoom)); canvas.scrollLeft = graphScroll.left; canvas.scrollTop = graphScroll.top; }
@@ -531,6 +610,7 @@
       document.getElementById('work-allow-row').hidden = event.target.value !== 'codex';
       document.getElementById('work-command').textContent = ''; status('');
     });
+    document.getElementById('work-list').addEventListener('click', readinessClick);
     for (const id of ['work-list', 'history-list']) document.getElementById(id).addEventListener('click', event => {
       if (config.canvas && snapshotProject !== config.project()) return;
       const pageButton = event.target.closest('[data-host-graph-next]');
@@ -578,5 +658,5 @@
     });
     setInterval(() => { if (!document.hidden && options.visible()) refresh(); }, 10000);
   }
-  window.GctoWork = { bind, refresh, reset, leaveView, parseRoute, navigateRoute, render, renderCockpit, renderExecutionGraph, commandFor, publicationCommand, getSnapshot() { return snapshot; }, showCompleted() { category = 'completed'; selectedKey = null; tab = 'overview'; notifyView(); paint(); }, search(value) { filter = value; if (config?.canvas) { if (!selectedKey) changeWorkspace(); } else paint(); } };
+  window.GctoWork = { bind, refresh, reset, leaveView, parseRoute, navigateRoute, render, renderCockpit, renderReadiness, renderExecutionGraph, commandFor, publicationCommand, getSnapshot() { return snapshot; }, showCompleted() { category = 'completed'; selectedKey = null; tab = 'overview'; notifyView(); paint(); }, search(value) { filter = value; if (config?.canvas) { if (!selectedKey) changeWorkspace(); } else paint(); } };
 })();

package/board/packages/board/public/index.html

@@ -23,6 +23,8 @@
 <link rel="icon" type="image/png" sizes="32x32" href="/assets/favicon-32.png" />
 <link rel="icon" type="image/png" sizes="16x16" href="/assets/favicon-16.png" />
 <link rel="shortcut icon" href="/assets/favicon.ico" />
+<link rel="manifest" href="/manifest.webmanifest" />
+<link rel="apple-touch-icon" href="/assets/apple-touch-icon.png" />
 <link href="/assets/fonts/fonts.css" rel="stylesheet" />
 <link href="/assets/admin-shell.css" rel="stylesheet" />
 <script src="/assets/vendor/marked.min.js"></script>
@@ -95,6 +97,7 @@
   --focus-ring: #00d97e;
   --rail-ok-bg: rgba(0, 217, 126, 0.12);
   --rail-fail-bg: rgba(255, 84, 102, 0.12);
+  --rdy-fail-bg: rgba(255, 84, 102, 0.06);
   --surface-drawer: #0f1411;
 
   --accent: #00d97e;
@@ -217,6 +220,7 @@
   --surface-translucent: rgba(255, 255, 255, 0.72);
   --rail-ok-bg: rgba(10, 125, 77, 0.12);
   --rail-fail-bg: rgba(196, 48, 48, 0.12);
+  --rdy-fail-bg: rgba(196, 48, 48, 0.05);
   --shadow-card: 0 1px 2px rgba(0, 0, 0, 0.08);
   --shadow-card-hover: 0 1px 3px rgba(0, 0, 0, 0.12), 0 8px 24px rgba(0, 168, 98, 0.08);
   --drawer-shadow: 0 16px 32px rgba(0, 0, 0, 0.18);
@@ -668,6 +672,16 @@ h1, h2, h3, h4 { font-weight: 600; font-family: var(--sans); }
   display: flex; align-items: center; transition: border-color .15s, color .15s;
 }
 .btn-bell:hover { border-color: var(--border-strong); color: var(--text); }
+/* Install app: shown only after the browser fires beforeinstallprompt, hidden in the
+   installed window (display-mode: standalone). */
+.btn-install {
+  display: none; align-items: center; gap: 6px; padding: 6px 10px; cursor: pointer;
+  border: 1px solid var(--accent); border-radius: 0; background: var(--accent-soft);
+  color: var(--text); font: inherit; font-size: var(--fs-small); font-weight: 500; white-space: nowrap;
+}
+.btn-install.on { display: flex; }
+.btn-install:hover { background: var(--accent-strong); }
+@media (display-mode: standalone) { .btn-install.on { display: none; } }
 .btn-bell-badge {
   position: absolute; top: -5px; right: -5px;
   background: var(--accent); color: var(--on-accent);
@@ -2963,6 +2977,7 @@ h1, h2, h3, h4 { font-weight: 600; font-family: var(--sans); }
 .notif-row .emoji { font-size: 16px; flex-shrink: 0; }
 .notif-row strong { color: var(--text); margin-right: 4px; }
 .notif-row input[type="checkbox"] { width: 16px; height: 16px; accent-color: var(--accent); cursor: pointer; }
+.notif-new { font-family: var(--mono); font-size: var(--fs-eyebrow); color: var(--accent-text); border: 1px solid var(--accent-text); padding: 1px 6px; margin-left: 4px; }
 
 .toggle {
   width: 38px; height: 22px;
@@ -3390,6 +3405,57 @@ h1, h2, h3, h4 { font-weight: 600; font-family: var(--sans); }
 .work-meta { color: var(--text2); font-size: var(--fs-caption); }
 .work-card [data-work-detail="evidence"] dt { margin-top: 12px; font-weight: 600; }
 .work-card [data-work-detail="evidence"] dd { margin: 4px 0 12px; color: var(--text2); font-size: var(--fs-body); overflow-wrap: anywhere; }
+.rdy { margin: 18px 0 16px; border: 1px solid var(--border-strong); border-radius: 12px; overflow: hidden; }
+.rdy-head { display: flex; align-items: center; gap: 14px; padding: 16px 20px; background: var(--bg-muted); flex-wrap: wrap; }
+.rdy-count { width: 36px; height: 36px; border-radius: 50%; background: var(--p0-fg); color: var(--bg-card); display: flex; align-items: center; justify-content: center; font-weight: 600; flex-shrink: 0; }
+.rdy[data-ready="true"] .rdy-count { background: var(--accent-text); }
+.rdy-title { flex: 1; min-width: 220px; }
+.work-page .rdy-title h2, .rdy-title h2 { margin: 0; font-size: var(--fs-title-s); font-weight: 600; }
+.rdy-sub { font-size: var(--fs-small); color: var(--text2); margin-top: 2px; }
+.rdy-note { font-size: var(--fs-small); color: var(--text2); max-width: 300px; }
+.rdy-narrow { display: none; }
+.rdy-rows { list-style: none; margin: 0; padding: 0; font-size: var(--fs-body); display: flex; flex-direction: column; }
+.rdy-group { display: none; }
+.rdy-row { display: flex; gap: 12px; align-items: center; padding: 12px 20px; border-top: 1px solid var(--border); flex-wrap: wrap; }
+.rdy-row[data-state="fail"], .rdy-row[data-state="not-read"] { background: var(--rdy-fail-bg); }
+.rdy-mark { width: 22px; font-weight: 600; color: var(--text2); }
+.rdy-row[data-state="pass"] .rdy-mark { color: var(--accent-text); }
+.rdy-row[data-state="fail"] .rdy-mark, .rdy-row[data-state="not-read"] .rdy-mark { color: var(--status-blocked-ink); }
+.rdy-label { width: 170px; font-weight: 500; }
+.rdy-detail { flex: 1; color: var(--text2); min-width: 200px; }
+.rdy-queue { color: var(--absent-warn-fg); font-weight: 500; }
+.rdy-link { font-size: var(--fs-small); color: var(--text); text-decoration: underline; background: none; border: 0; padding: 0; font-family: inherit; cursor: pointer; }
+.rdy-btn { height: 34px; padding: 0 12px; border-radius: 8px; border: 1px solid var(--border-strong); background: var(--bg-card); color: var(--text); font: inherit; font-size: var(--fs-small); cursor: pointer; }
+.rdy-btn:disabled { color: var(--text2); cursor: default; }
+.rdy-foot { padding: 10px 20px; border-top: 1px solid var(--border); font-size: var(--fs-caption); color: var(--text2); }
+.rdy-ok { margin: 16px 0; border: 1px solid var(--accent-text); border-radius: 12px; padding: 14px 20px; display: flex; gap: 14px; align-items: center; flex-wrap: wrap; font-size: var(--fs-body); }
+.rdy-ok-mark { width: 32px; height: 32px; border-radius: 50%; background: var(--accent-text); color: var(--bg-card); display: flex; align-items: center; justify-content: center; font-weight: 600; }
+.rdy-ok b { font-weight: 600; flex: 1; min-width: 200px; }
+.rdy-ok code { font-family: var(--mono); font-size: var(--fs-caption); background: var(--bg-muted); padding: 8px 10px; border-radius: 6px; overflow-wrap: anywhere; }
+@media (max-width: 600px) {
+  .rdy { margin: 12px 0; }
+  .rdy-wide { display: none; }
+  .rdy-narrow { display: inline; }
+  .rdy-head { flex-direction: column; align-items: stretch; gap: 10px; padding: 14px; }
+  .rdy-title { min-width: 0; }
+  .rdy-count { width: 32px; height: 32px; }
+  .rdy-title h2 { font-size: var(--fs-title-s); }
+  .rdy-note, .rdy-sub { font-size: var(--fs-caption); max-width: none; }
+  .rdy-group { display: block; order: 0; padding: 10px 14px; font-size: var(--fs-caption); font-weight: 600; color: var(--p0-fg); border-top: 1px solid var(--border); }
+  .rdy-group[data-group="passed"] { order: 2; color: var(--accent-text); }
+  .rdy-row { order: 3; padding: 10px 14px; font-size: var(--fs-small); color: var(--text2); gap: 4px; flex-wrap: nowrap; }
+  .rdy-row .rdy-mark { width: auto; margin-right: 2px; }
+  .rdy-row .rdy-label { width: auto; font-weight: 400; }
+  .rdy-row:not([data-state="fail"]):not([data-state="not-read"]) .rdy-label::after { content: " ·"; }
+  .rdy-row:not([data-state="fail"]):not([data-state="not-read"]) .rdy-detail { min-width: 0; }
+  .rdy-row:not([data-state="fail"]):not([data-state="not-read"]) .rdy-link, .rdy-row:not([data-state="fail"]):not([data-state="not-read"]) .rdy-btn { display: none; }
+  .rdy-row[data-state="fail"], .rdy-row[data-state="not-read"] { order: 1; flex-wrap: wrap; padding: 12px 14px; gap: 8px; font-size: var(--fs-body); color: var(--text); }
+  .rdy-row[data-state="fail"] .rdy-label, .rdy-row[data-state="not-read"] .rdy-label { font-weight: 500; flex: 1; }
+  .rdy-row[data-state="fail"] .rdy-detail, .rdy-row[data-state="not-read"] .rdy-detail { flex: 0 0 100%; min-width: 0; font-size: var(--fs-small); }
+  .rdy-row[data-state="fail"] .rdy-btn, .rdy-row[data-state="not-read"] .rdy-btn { flex: 0 0 100%; height: 44px; }
+  .rdy-row[data-state="fail"] .rdy-link, .rdy-row[data-state="not-read"] .rdy-link { min-height: 44px; display: flex; align-items: center; }
+  .rdy-foot { display: none; }
+}
 .work-warning { color: var(--absent-warn-fg); background: var(--bg-card); border: 1px solid var(--absent-warn-fg); padding: 12px; }
 .work-page pre { font-weight: 400; white-space: pre-wrap; overflow-wrap: anywhere; margin: 12px 0; }
 #work-compose textarea, #work-compose input, #work-compose select { display: block; width: 100%; margin: 8px 0 12px; padding: 8px; background: var(--bg-muted); color: var(--text); border: 1px solid var(--border-strong); border-radius: 4px; }
@@ -3534,6 +3600,10 @@ h1, h2, h3, h4 { font-weight: 600; font-family: var(--sans); }
              (#topbar-bell, opened the drawer) are deleted as top-level surfaces
              here — great_cto-ki1x.5. Their panels/functions are untouched for
              .11 to re-wire as Settings rows; nothing here calls them anymore. -->
+        <button class="btn-install" id="install-app-btn" type="button" onclick="installBoardApp()" title="Install the board as an app: own window and Dock icon">
+          <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true"><path d="M12 3v12"/><path d="M7 10l5 5 5-5"/><path d="M5 21h14"/></svg>
+          <span class="btn-label">Install app</span>
+        </button>
         <button class="btn-bell" id="board-theme-btn" onclick="toggleBoardTheme()" title="Toggle light / dark theme" aria-label="Toggle theme"><svg class="ico-moon" viewBox="0 0 16 16" aria-hidden="true"><path d="M13.5 9.5A6 6 0 0 1 6.5 2.5a6 6 0 1 0 7 7z"></path></svg><svg class="ico-sun" viewBox="0 0 16 16" aria-hidden="true"><circle cx="8" cy="8" r="3"></circle><path d="M8 1.5v1.5M8 13v1.5M1.5 8H3M13 8h1.5M3.4 3.4l1 1M11.6 11.6l1 1M3.4 12.6l1-1M11.6 4.4l1-1"></path></svg></button>
         <button class="btn-bell" id="topbar-settings-btn" data-tab="settings" onclick="switchTab('settings', this)" title="Settings" aria-label="Settings" style="gap:6px;padding:6px 10px;">
           <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8"><circle cx="12" cy="12" r="3"/><path d="M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 1 1-2.83 2.83l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 0 1-4 0v-.09A1.65 1.65 0 0 0 9 19.4a1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 1 1-2.83-2.83l.06-.06a1.65 1.65 0 0 0 .33-1.82 1.65 1.65 0 0 0-1.51-1H3a2 2 0 0 1 0-4h.09A1.65 1.65 0 0 0 4.6 9a1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 1 1 2.83-2.83l.06.06a1.65 1.65 0 0 0 1.82.33H9a1.65 1.65 0 0 0 1-1.51V3a2 2 0 0 1 4 0v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 1 1 2.83 2.83l-.06.06a1.65 1.65 0 0 0-.33 1.82V9a1.65 1.65 0 0 0 1.51 1H21a2 2 0 0 1 0 4h-.09a1.65 1.65 0 0 0-1.51 1z"/></svg>
@@ -4051,6 +4121,9 @@ h1, h2, h3, h4 { font-weight: 600; font-family: var(--sans); }
             <label class="notif-row"><input type="checkbox" data-trigger="gate.blocked"> <span class="emoji">🛡️</span><strong>Security BLOCKED</strong> — security-officer rejected a merge</label>
             <label class="notif-row"><input type="checkbox" data-trigger="cost.threshold"> <span class="emoji">💸</span><strong>Budget alert</strong> — LLM spend &gt; 80% / 100% of monthly cap</label>
             <label class="notif-row"><input type="checkbox" data-trigger="digest.weekly"> <span class="emoji">📊</span><strong>Weekly digest</strong> — Friday 09:00 DORA recap</label>
+            <label class="notif-row"><input type="checkbox" data-trigger="agent.blocked"> <span class="emoji">✋</span><strong>Agent blocked</strong> — a session is waiting for your input <span class="notif-new">NEW</span></label>
+            <label class="notif-row"><input type="checkbox" data-trigger="gate.local_red"> <span class="emoji">🔴</span><strong>Local gate red</strong> — a ci-local run finished with failures <span class="notif-new">NEW</span></label>
+            <label class="notif-row"><input type="checkbox" data-trigger="gate.waiting"> <span class="emoji">⏳</span><strong>Gate waiting now</strong> — at once, not after 2h <span class="notif-new">NEW</span></label>
           </div>
 
           <div class="cta-row" style="margin-top:24px;display:flex;gap:10px;flex-wrap:wrap">
@@ -4080,7 +4153,7 @@ h1, h2, h3, h4 { font-weight: 600; font-family: var(--sans); }
           </div>
           <div id="push-status" style="margin-top:10px;font-size: var(--fs-small);font-family:var(--mono);color:var(--text3)"></div>
           <div class="share-note" style="margin-top:16px">
-            Push subscriptions are stored locally in <code>~/.great_cto/push-subscriptions.json</code>. Notifications fire for the same 5 triggers as email alerts.
+            Push subscriptions are stored locally in <code>~/.great_cto/push-subscriptions.json</code>. Notifications fire for the same 8 triggers as email alerts; the three marked NEW only when ticked there.
           </div>
         </div>
 
@@ -10591,8 +10664,46 @@ async function _disablePush() {
   }
 }
 
+// ── Install app (PWA) ──────────────────────────────────────────────────────────
+// The button appears only when the browser offers installation (Chrome/Edge fire
+// beforeinstallprompt once the manifest is valid). Safari has no such event, so
+// the button stays hidden there. Once installed, the board runs in its own
+// window (display-mode: standalone) and the button never shows.
+let _installPrompt = null;
+function _installBtn() { return document.getElementById('install-app-btn'); }
+function _isStandalone() {
+  try { return window.matchMedia('(display-mode: standalone)').matches || navigator.standalone === true; }
+  catch { return false; }
+}
+function initInstallApp() {
+  window.addEventListener('beforeinstallprompt', (e) => {
+    e.preventDefault();
+    _installPrompt = e;
+    const btn = _installBtn();
+    if (btn && !_isStandalone()) btn.classList.add('on');
+  });
+  window.addEventListener('appinstalled', () => {
+    _installPrompt = null;
+    const btn = _installBtn();
+    if (btn) btn.classList.remove('on');
+    showToast('Board installed as an app', 'success', 3000);
+  });
+}
+async function installBoardApp() {
+  if (!_installPrompt) return;
+  const evt = _installPrompt;
+  _installPrompt = null;
+  // A prompt event can be used once: hide the button whatever the answer. If the
+  // user dismissed it, the browser fires beforeinstallprompt again later and the
+  // button comes back with a fresh event.
+  _installBtn()?.classList.remove('on');
+  evt.prompt();
+  try { await evt.userChoice; } catch { /* nothing to undo */ }
+}
+
 init();
 initPush();
+initInstallApp();
 loadNotifHistory();
 initPeriodChips();  // attaches click handlers + highlights active chip
 // Apply persisted period to labels on first paint

package/board/packages/board/public/manifest.webmanifest

@@ -0,0 +1,16 @@
+{
+  "name": "great_cto board",
+  "short_name": "great_cto",
+  "description": "Local board for great_cto: work, gates, decisions and agent activity.",
+  "id": "/",
+  "start_url": "/",
+  "scope": "/",
+  "display": "standalone",
+  "background_color": "#0a0e0c",
+  "theme_color": "#0a0e0c",
+  "icons": [
+    { "src": "/assets/icon-192.png", "sizes": "192x192", "type": "image/png" },
+    { "src": "/assets/icon-512.png", "sizes": "512x512", "type": "image/png" },
+    { "src": "/assets/icon-maskable-512.png", "sizes": "512x512", "type": "image/png", "purpose": "maskable" }
+  ]
+}

package/board/packages/board/public/sw.js

@@ -37,7 +37,7 @@ async function handlePush() {
     body,
     tag,
     // icon may not exist — browsers handle missing icon gracefully
-    icon: `${BOARD_ORIGIN}/assets/logo-192.png`,
+    icon: `${BOARD_ORIGIN}/assets/icon-192.png`,
     badge: `${BOARD_ORIGIN}/assets/favicon-32.png`,
     data: {
       url: `${BOARD_ORIGIN}/`,

package/board/packages/board/route-coverage-baseline.json

@@ -0,0 +1,25 @@
+{
+  "note": "API routes with no test referencing them. Shrink only: add a test, then remove the line. See docs/testing/BOARD-TEST-STRATEGY.md.",
+  "measured": "19 of 57 routes",
+  "untested": [
+    "/api/agent-budgets",
+    "/api/agents/",
+    "/api/change-tier",
+    "/api/gate-tiers",
+    "/api/memory",
+    "/api/memory-pattern",
+    "/api/notif-history",
+    "/api/notif-history/read",
+    "/api/notifications",
+    "/api/portfolio",
+    "/api/push/subscribe",
+    "/api/push/vapid-key",
+    "/api/receipt",
+    "/api/scores",
+    "/api/session-search",
+    "/api/sessions",
+    "/api/sessions/",
+    "/api/stand-downs",
+    "/api/views"
+  ]
+}

package/board/packages/board/server.mjs

@@ -105,7 +105,8 @@ const server = http.createServer(async (req, res) => {
   // signal to a prober about what exists outside PUBLIC.
   if (isInsideDir(PUBLIC, fullPath) && fs.existsSync(fullPath) && fs.statSync(fullPath).isFile()) {
     const ext = path.extname(fullPath);
-    const mime = { '.html': 'text/html', '.css': 'text/css', '.js': 'text/javascript', '.svg': 'image/svg+xml' };
+    const mime = { '.html': 'text/html', '.css': 'text/css', '.js': 'text/javascript', '.svg': 'image/svg+xml',
+      '.png': 'image/png', '.ico': 'image/x-icon', '.webmanifest': 'application/manifest+json' };
     // HTML must never cache — board UI is iterated daily and stale layouts
     // hide new features (period selector, push toggle, etc.) until hard refresh
     const headers = { 'Content-Type': mime[ext] || 'text/plain' };
@@ -186,6 +187,12 @@ server.listen(PORT, HOST, () => {
 
 server.on('error', e => {
   if (e.code === 'EADDRINUSE') {
+    // A workspace must not defer: the board already on this port belongs to another
+    // workspace, and its verdicts are not the ones this operator is looking at.
+    if (process.env.GREAT_CTO_WORKSPACE_PORT === String(PORT)) {
+      log.error(`Port ${PORT} is taken and this workspace was given it. Not attaching to another board.`);
+      process.exit(1);
+    }
     log.info(`Port ${PORT} in use — board already running at http://localhost:${PORT}`);
   } else {
     log.error(e);

package/board/scripts/lib/gate-run-record.mjs

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+/**
+ * Append one line per ci-local run to <main checkout>/.great_cto/gate-runs.jsonl,
+ * so the board can say "the local gate went red" (trigger gate.local_red) instead
+ * of the result living only in a terminal.
+ *
+ *   node scripts/lib/gate-run-record.mjs --result green|skipped|red [--failed "step a\nstep b"]
+ *
+ * The MAIN checkout, not the current one: gates run in worktrees, and the board
+ * watches the project. `git rev-parse --git-common-dir` points at the main
+ * repository's .git from any of its worktrees.
+ *
+ * A record is a report, never a reason to change the gate's result: every
+ * failure here is printed and swallowed, and the exit code is always 0.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { isMainModule } from './is-main.mjs';
+
+export const MAX_LINES = 200;
+export const RESULTS = Object.freeze(['green', 'skipped', 'red']);
+
+function git(args, cwd) {
+  try { return execFileSync('git', args, { cwd, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim(); }
+  catch { return ''; }
+}
+
+/** The main checkout's root, from the main checkout or any of its worktrees. Null outside git. */
+export function mainCheckout(cwd = process.cwd()) {
+  const common = git(['rev-parse', '--path-format=absolute', '--git-common-dir'], cwd);
+  if (!common) return null;
+  return path.basename(common) === '.git' ? path.dirname(common) : null;
+}
+
+export function buildRecord({ result, failed = '', cwd = process.cwd(), now = Date.now() }) {
+  if (!RESULTS.includes(result)) throw new Error(`result must be one of ${RESULTS.join(', ')}`);
+  return {
+    v: 1,
+    ts: new Date(now).toISOString(),
+    result,
+    branch: git(['branch', '--show-current'], cwd) || null,
+    sha: git(['rev-parse', '--short', 'HEAD'], cwd) || null,
+    failed: String(failed).split('\n').map((s) => s.trim()).filter(Boolean).slice(0, 20),
+  };
+}
+
+/** Append and keep the newest MAX_LINES. Returns the file written, or null when there is no project to write into. */
+export function appendRecord(record, { cwd = process.cwd() } = {}) {
+  const root = mainCheckout(cwd);
+  if (!root) return null;
+  const dir = path.join(root, '.great_cto');
+  // Only into a great_cto project: a gate in some other repository has no board to tell.
+  if (!fs.existsSync(path.join(dir, 'PROJECT.md'))) return null;
+  const file = path.join(dir, 'gate-runs.jsonl');
+  let lines = [];
+  try { lines = fs.readFileSync(file, 'utf8').split('\n').filter(Boolean); }
+  catch (e) { if (e.code !== 'ENOENT') throw e; } // unreadable: refuse to rewrite it from nothing
+  lines.push(JSON.stringify(record));
+  const tmp = `${file}.${process.pid}.tmp`;
+  fs.writeFileSync(tmp, lines.slice(-MAX_LINES).join('\n') + '\n');
+  fs.renameSync(tmp, file);
+  return file;
+}
+
+if (isMainModule(import.meta.url)) {
+  const arg = (n) => { const i = process.argv.indexOf(n); return i > 0 ? process.argv[i + 1] : undefined; };
+  try {
+    const file = appendRecord(buildRecord({ result: arg('--result'), failed: arg('--failed') || '' }));
+    if (file) process.stdout.write(`   run recorded: ${path.relative(process.cwd(), file) || file}\n`);
+  } catch (e) {
+    process.stdout.write(`   ⚠ run not recorded (${e.message}) — the board will not report this run\n`);
+  }
+  process.exit(0);
+}