great-cto 3.2.0 → 3.4.0

package/README.md

@@ -20,6 +20,25 @@ That's it. The CLI detects your stack, picks the right archetype, clones the plu
 
 After install, restart Claude Code and run `/inbox` or `/audit`.
 
+## What the plugin gives you
+
+The CLI installs it; these are what it installs.
+
+- **A pipeline of specialist agents** — architect, product owner, senior dev, QA,
+  security officer, and archetype-specific reviewers — that run in sequence with
+  human approval gates at the points that are expensive to undo.
+- **Spending caps that refuse.** Set a per-agent cap; when measured spend passes
+  it the dispatcher declines to run that agent instead of quietly continuing. An
+  agent with no measurement reads as `unmeasured`, never as `$0`.
+- **A board at `localhost:3141`** — tasks, metrics, per-agent budgets, docs
+  search, and the decision journal, all served from your own machine. Nothing
+  leaves it.
+- **A decision journal** that records what each dispatch decided and why, so a
+  pipeline that did not run looks different from one that ran and found nothing.
+
+Telemetry is opt-in and off by default — see
+[docs/PRIVACY.md](https://github.com/avelikiy/great_cto/blob/main/docs/PRIVACY.md).
+
 ## Examples
 
 ### Commerce detection (Stripe + Next.js)
@@ -82,8 +101,10 @@ npx great-cto init [options]
 ## Trust signals
 
 - Zero runtime dependencies — only Node built-ins (`node:fs`, `node:path`, etc.)
-- 47 unit tests covering stack detection, archetype scoring, settings merge
-- CI matrix: Node 18/20/22 × Ubuntu/macOS/Windows
+- 305 unit tests covering stack detection, archetype scoring, and settings merge
+- Tests and the release gate run locally (`scripts/ci-local.sh`) — the hosted CI
+  workflows are present in the repo but have not run since June 2026, so treat the
+  badge-shaped claims in this file as claims about the local gate, not a cloud matrix
 - Source: [`packages/cli/src/`](https://github.com/avelikiy/great_cto/tree/main/packages/cli/src) — ~1.2k LOC TypeScript
 
 ## License

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": "3.2.0",
+  "version": "3.4.0",
   "author": {
     "name": "Great CTO",
     "url": "https://github.com/avelikiy/great_cto"

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

@@ -1174,9 +1174,24 @@ async function dispatch(req, res, url, cwd) {
         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';
+    // Direction, not inequality. `installed !== BUILD_VERSION` is true in both
+    // directions, and the banner it fed said "restart to pick up the new
+    // version" either way — so a board running 3.2.0 against an installed 3.1.0
+    // was told to restart into the OLDER build. A prompt to downgrade that
+    // looks exactly like a prompt to upgrade is the same defect this endpoint
+    // was written to fix, pointed the other way.
+    //
+    // Four states: `behind` (an install is waiting), `ahead` (the running code
+    // is newer — restarting would lose it), `no`, and `unknown`.
+    const cmp = (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]);
+    };
+    let stale = 'unknown';
+    if (installed && BUILD_VERSION !== 'unknown' && /^\d+\.\d+\.\d+$/.test(BUILD_VERSION)) {
+      const d = cmp(installed, BUILD_VERSION);
+      stale = d > 0 ? 'behind' : d < 0 ? 'ahead' : 'no';
+    }
     res.writeHead(200, { 'Content-Type': 'application/json', 'Cache-Control': 'no-store' });
     res.end(JSON.stringify({
       version: BUILD_VERSION, installed, stale,