great-cto 2.98.0 → 2.99.0

package/board/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "great_cto",
   "id": "great_cto",
   "description": "Engineering process for solo founders and teams up to 50 engineers. Agents do architecture, code review, QA, and security. You make two decisions per feature.",
-  "version": "2.98.0",
+  "version": "2.99.0",
   "author": {
     "name": "Great CTO",
     "url": "https://github.com/avelikiy/great_cto"

package/board/packages/board/lib/beads.mjs

@@ -11,7 +11,18 @@ import { log } from './log.mjs';
 // .beads/interactions.jsonl changes (the file watcher in watchBeads() calls
 // bdCacheInvalidate(cwd) before broadcasting). This avoids spawning `bd list`
 // on every API call when 5+ projects are open in tabs.
-const BD_CACHE_TTL_MS = 2000;
+// Measured, not guessed: `bd list` on this repository takes 3.0–4.6 s and
+// `bd --version` — pure process startup, no query — takes 1.13 s. At a 2 s TTL
+// the entry expired before the call that filled it had returned, so a page load
+// firing /api/inbox, /api/tasks and /api/metrics paid full price three times and
+// every endpoint sat at ~5 s. A cache whose TTL is shorter than the operation it
+// caches is not a cache; it is a counter of missed opportunities.
+//
+// 30 s is safe because staleness is bounded by invalidation, not by the clock:
+// `bdCacheInvalidate` fires on every write through the board, and the file
+// watchers fire when anything changes the store underneath us. The TTL is only
+// the backstop for a change that arrived through neither.
+const BD_CACHE_TTL_MS = Number(process.env.GREAT_CTO_BD_CACHE_TTL_MS || 30000);
 
 function bdCacheInvalidate(cwd) { bdCache.delete(cwd); }
 
@@ -500,6 +511,7 @@ function detectAgent(task) {
 
 export {
   bdCacheInvalidate,
+  BD_CACHE_TTL_MS,
   BD_BIN,
   bdEnv,
   bd,

package/board/packages/board/lib/routes.mjs

@@ -1144,8 +1144,32 @@ async function dispatch(req, res, url, cwd) {
 
   // Build version — so the board shows which great_cto version it's running.
   if (pathname === '/api/version') {
+    // A board is a process, and a process keeps the version it started with.
+    // This one served v2.95.0 for nine days while three installs in a row
+    // reported success: the installer updated files, the running server kept
+    // answering, and nothing compared the two. The installer restarts the board
+    // now, but a board started any other way still needs to be able to say that
+    // it is behind — an install the operator cannot see is not an install.
+    //
+    // Three states, not two. `unknown` when the cache cannot be read: a version
+    // we failed to look up must not render as agreement.
+    let installed = null;
+    try {
+      const root = path.join(os.homedir(), '.claude', 'plugins', 'cache', 'local', 'great_cto');
+      const versions = fs.readdirSync(root).filter((d) => /^\d+\.\d+\.\d+$/.test(d));
+      installed = versions.sort((a, b) => {
+        const x = a.split('.').map(Number), y = b.split('.').map(Number);
+        return (x[0] - y[0]) || (x[1] - y[1]) || (x[2] - y[2]);
+      }).pop() || null;
+    } catch { installed = null; }
+    const stale = installed && BUILD_VERSION !== 'unknown'
+      ? (installed !== BUILD_VERSION ? 'yes' : 'no')
+      : 'unknown';
     res.writeHead(200, { 'Content-Type': 'application/json', 'Cache-Control': 'no-store' });
-    res.end(JSON.stringify({ version: BUILD_VERSION, surface: 'builder', node: process.version.replace(/^v/, '') }));
+    res.end(JSON.stringify({
+      version: BUILD_VERSION, installed, stale,
+      surface: 'builder', node: process.version.replace(/^v/, ''),
+    }));
     return true;
   }
 

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

@@ -153,6 +153,16 @@ button { font-family: inherit; cursor: pointer; }
     radial-gradient(ellipse 70% 50% at 100% 100%, rgba(0, 217, 126, 0.03), transparent 70%);
 }
 
+.stale-board {
+  display: flex; align-items: center; gap: 10px;
+  margin: 0 0 12px; padding: 10px 14px;
+  background: rgba(180, 83, 9, 0.10);
+  border: 1px solid var(--status-progress);
+  border-radius: 8px;
+  font-size: 13px; color: var(--text);
+}
+.stale-board code { font-family: var(--mono); font-size: 12px; }
+
 /* ── Sidebar ──────────────────────────────────────────────────────────────── */
 .sidebar {
   position: relative; z-index: 1;
@@ -564,11 +574,7 @@ button { font-family: inherit; cursor: pointer; }
    cannot be un-advanced. Scoped to `pointer: coarse` so the desktop density that
    makes a long gate list scannable is left exactly as it is. 44px is the iOS
    minimum; Android asks for 48dp, and the gap does the rest. */
-@media (pointer: coarse) {
-  .gate-btn { height: 44px; font-size: 13px; }
-  .inbox-row .actions .gate-btn { height: 44px; font-size: 13px; }
-  .gate-actions, .side-gate-actions, .inbox-row .actions { gap: 12px; }
-}
+
 .gate-approve { color: var(--status-review); border-color: rgba(22, 163, 74, 0.35); }
 .gate-approve:hover { background: rgba(22, 163, 74, 0.08); border-color: var(--status-review); }
 /* Agent runner (launch control) */
@@ -2241,8 +2247,16 @@ button { font-family: inherit; cursor: pointer; }
   .sidebar-scrim.open { opacity: 1; pointer-events: auto; }
   .menu-btn { display: inline-flex; }
   .topbar { padding: 0 10px; gap: 8px; }
+  /* Raising every control to 44px gave the actions 223px of a 375px bar and
+     crushed the breadcrumb to "g… / B." — present, unreadable, worse than absent.
+     The project name is already at the top of the drawer and the tab name is the
+     row you tapped to get here, so the phone keeps only where you are. */
   .topbar .crumbs { min-width: 0; overflow: hidden; white-space: nowrap; }
   .topbar .crumbs > span { overflow: hidden; text-overflow: ellipsis; }
+  .topbar .crumbs .proj-icon,
+  .topbar .crumbs .sep,
+  .topbar .crumbs #crumb-project { display: none; }
+  .topbar .crumbs .here { color: var(--text); font-weight: 600; }
   .topbar-actions { flex-shrink: 0; }
   /* The search box is the one topbar item that can give up its width; ⌘K still
      reaches it, and on a phone there is no ⌘K but there is the Search tab. */
@@ -2252,6 +2266,34 @@ button { font-family: inherit; cursor: pointer; }
   /* Icon-only, with the name moved to aria-label/title rather than deleted. */
   .btn-label { display: none; }
 
+  /* The row's own arithmetic, measured rather than eyeballed: the page gives
+     64px to its side padding and the row another 30px to border and padding,
+     leaving 281px for the tracks. The fixed ones — id 110, two 14px gaps, and a
+     44px Approve/Reject pair at about 156 — come to 294. The 1fr title column
+     resolves to ZERO and the row overflows its own border box.
+     Raising the buttons to a real touch target is what finished it off: at 24px
+     they fit, at 44px they do not. Fixing one defect deepened its neighbour.
+     So on a phone the row stops being three columns and becomes three rows:
+     title first at full width, the id demoted to a meta line, the actions
+     spanning the bottom. CSS only — the markup this renders from is shared with
+     the desktop layout, and the desktop layout is fine. */
+  .inbox-page { padding: 16px 16px 48px; }
+  .inbox-row {
+    display: flex; flex-wrap: wrap;
+    gap: 8px 10px; align-items: baseline;
+  }
+  .inbox-row .ttl { order: 1; flex: 1 1 100%; font-size: 14px; }
+  /* Two lines, wrapped — a phone has the vertical room it lacks sideways. */
+  .inbox-row .ttl > :first-child { -webkit-line-clamp: 2; white-space: normal; }
+  /* The id and the status share a line: stacked, each took a full row of its
+     own and a four-line card said three things. */
+  .inbox-row .id { order: 2; flex: 0 1 auto; padding-top: 0; }
+  .inbox-row .actions { order: 3; margin-left: auto; }
+  /* Except on a gate, where the line is a pair of 44px buttons and wants the
+     whole width — the one row on this screen where the target size is the point. */
+  .inbox-row .actions:has(.gate-btn) { flex: 1 0 100%; margin-left: 0; }
+  .inbox-row .actions .gate-btn { flex: 1; }
+
   /* Four columns of numbers do not fit in 375px; they were being clipped, which
      silently dropped the fourth stat rather than wrapping it. */
   .inbox-summary { grid-template-columns: repeat(2, 1fr); }
@@ -2259,6 +2301,29 @@ button { font-family: inherit; cursor: pointer; }
   .mp-hero { grid-template-columns: 1fr; }
   .mp-row { grid-template-columns: 1fr; }
 }
+@media (pointer: coarse) {
+  /* A floor, not a list.
+     Placed here, at the END of the stylesheet, for the same reason the
+     phone-width block is: at equal specificity the later rule wins. Written
+     higher up, its `.inbox-row .actions { gap: 12px }` lost to the base rule's
+     4px declared 900 lines below it — so Approve and Reject sat 4px apart on a
+     touch screen while a block that read as correct sat above saying 12.
+     A declaration that loses is not a declaration.
+     The first version of this block named .gate-btn and stopped there, because
+     those were the buttons a review had pointed at. Two controls this same file
+     had just added — the drawer's own hamburger at 40px and the topbar's icon
+     buttons at ~32px — sat under the minimum from the day they were written,
+     and nothing objected, because the rule was a list of what somebody had
+     remembered rather than a property of the page.
+     So: every control gets the floor, and the ones with something to say about
+     their own size say it after. A button added tomorrow is covered by default;
+     one that must stay small has to opt out in writing. */
+  button, [role="button"], .nav-item, .toggle, summary { min-height: 44px; }
+  .gate-btn, .inbox-row .actions .gate-btn { height: 44px; font-size: 13px; }
+  .menu-btn { width: 44px; height: 44px; }
+  .btn-bell { min-width: 44px; justify-content: center; }
+  .gate-actions, .side-gate-actions, .inbox-row .actions { gap: 12px; }
+}
 @keyframes pulse-glow { 0% { box-shadow: 0 0 0 0 rgba(76,175,80,.6);} 100% { box-shadow: 0 0 0 6px rgba(76,175,80,0);} }
 /* ── Scrollbar ────────────────────────────────────────────────────────────── */
 ::-webkit-scrollbar { width: 10px; height: 10px; }
@@ -4509,6 +4574,7 @@ function connectSSE() {
     // Sidebar counter FIRST, independent of render
     updateNavCounts();
     try { renderKanban(filterTasks(searchQuery)); } catch (e) { console.warn('SSE renderKanban failed', e); }
+    checkBoardFreshness();
     refreshInbox();
   };
   es.addEventListener('tasks', e => {
@@ -5397,6 +5463,33 @@ document.addEventListener('keydown', e => { if (e.key === 'Escape') closeSide();
 // Three things a drawer owes a keyboard, all of them things a transform alone
 // does not give you: it leaves the tab order when closed, Escape closes it, and
 // focus moves in on open and back to the button that opened it on close.
+/* The board tells on itself.
+ *
+ * A board is a process, and a process keeps the version it started with. This
+ * one served v2.95.0 for nine days while three installs in a row reported
+ * success — the installer wrote files, the running server kept answering, and
+ * nothing compared the two. The installer restarts the board now; this is for a
+ * board started any other way, so that being behind is visible rather than
+ * merely true.
+ *
+ * Three states, like everywhere else on this page: `yes` says so, `no` is
+ * silent, and `unknown` — the plugin cache could not be read — is also silent,
+ * because a comparison we could not make must not be announced as a mismatch.
+ */
+async function checkBoardFreshness() {
+  const v = await api('/api/version');
+  if (!v || v.stale !== 'yes') return;
+  const host = document.querySelector('.workspace');
+  if (!host || document.getElementById('stale-board')) return;
+  const el = document.createElement('div');
+  el.id = 'stale-board';
+  el.className = 'stale-board';
+  el.setAttribute('role', 'status');
+  el.innerHTML = `<span>This board is running <code>v${esc(v.version)}</code> — `
+    + `<code>v${esc(v.installed)}</code> is installed. Restart it to pick up the new version.</span>`;
+  host.insertBefore(el, host.firstChild);
+}
+
 function menuIsOpen() {
   return !!document.getElementById('sidebar')?.classList.contains('open');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "great-cto",
-  "version": "2.98.0",
+  "version": "2.99.0",
   "description": "One command install for the great_cto Claude Code plugin. Auto-detects your stack, picks the right archetype, bootstraps PROJECT.md.",
   "keywords": [
     "claude-code",