great-cto 2.98.1 → 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.1",
+  "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;
@@ -4564,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 => {
@@ -5452,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.1",
+  "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",