great-cto 3.58.0 → 3.58.2

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

@@ -1,7 +1,7 @@
 {
   "name": "great-cto",
   "description": "You already have the agent. This is everything around it. great_cto runs Claude Code as a pipeline of 72 specialist agents \u2014 an independent model checks each stage before the next builds on it, spending caps refuse rather than warn, and three decisions stay yours: what gets built, how, and whether it ships.",
-  "version": "3.58.0",
+  "version": "3.58.2",
   "author": {
     "name": "Alexander Velikiy",
     "url": "https://hashnode.com/@Greatcto"

package/board/packages/board/lib/config.mjs

@@ -4,7 +4,16 @@ import { fileURLToPath } from 'url';
 import os from 'os';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const PORT = parseInt(process.env.BOARD_PORT || process.env.PORT || '3141', 10);
+// `--port N` (or `--port=N`) first — server.mjs's usage line documents it, and
+// ignoring it put a test board started with `--port 3177` onto :3141 (3.58.1).
+// Then BOARD_PORT, PORT, and 3141. A value that is not a port is skipped.
+export function portFrom(argv = process.argv, env = process.env) {
+  const ok = (v) => { const n = Number(v); return Number.isInteger(n) && n > 0 && n < 65536 ? n : null; };
+  const i = argv.indexOf('--port');
+  const eq = argv.find((a) => typeof a === 'string' && a.startsWith('--port='));
+  return ok(i > -1 ? argv[i + 1] : eq ? eq.slice(7) : null) ?? ok(env.BOARD_PORT) ?? ok(env.PORT) ?? 3141;
+}
+const PORT = portFrom();
 const PUBLIC = path.join(__dirname, '..', 'public');
 // Build version — read the plugin manifest this board ships inside (packages/board → ../../.claude-plugin).
 const BUILD_VERSION = (() => {

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

@@ -13,7 +13,8 @@ import { sseClients, notifHistory } from './state.mjs';
 import { autoRegisterProject, listProjects, resolveProjectCwd, resolveProjectInfo, getChangeTier, readProjectsRegistry, getRegistryDegradation } from './projects.mjs';
 import { readVerdictsWithHealth } from './verdicts.mjs';
 import { agentUsage, usageSnapshot } from '../../../scripts/lib/agent-usage.mjs';
-import { usageIndexSnapshot, summarizeUsage, readCodexTitles, readClaudeLimits } from '../../../scripts/lib/session-usage.mjs';
+import { isProjectState } from '../../../scripts/lib/great-cto-scope.mjs';
+import { usageIndexSnapshot, summarizeUsage, readCodexTitles, readClaudeLimits, claudeRecorder } from '../../../scripts/lib/session-usage.mjs';
 import { outcomes as computeOutcomes } from '../../../scripts/lib/outcomes.mjs';
 import { reviewerStatus } from '../../../scripts/lib/required-reviewers.mjs';
 import { readSessionStatus } from '../../../scripts/lib/session-status.mjs';
@@ -276,6 +277,13 @@ async function dispatch(req, res, url, cwd) {
         return;
       }
       const view = String(parsed.view || '');
+      // Only into a project. The board's cwd can be a directory that is not one —
+      // a release worktree, deleted since — and mkdir here recreated it (3.58.1).
+      if (!isProjectState(path.join(c, '.great_cto'))) {
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ ok: true, view, recorded: false, why: 'not a project' }));
+        return;
+      }
       try {
         recordView({ root: c, view });
       } catch (e) {
@@ -284,7 +292,7 @@ async function dispatch(req, res, url, cwd) {
         return;
       }
       res.writeHead(200, { 'Content-Type': 'application/json' });
-      res.end(JSON.stringify({ ok: true, view }));
+      res.end(JSON.stringify({ ok: true, view, recorded: true }));
     });
     return true;
   }
@@ -1507,7 +1515,7 @@ async function dispatch(req, res, url, cwd) {
     if (snap.state !== 'ready') {
       body = { state: snap.state, why: snap.why };
     } else {
-      const sum = summarizeUsage(snap.index, { days, codexTitles: readCodexTitles(), claudeReadings: readClaudeLimits() });
+      const sum = summarizeUsage(snap.index, { days, codexTitles: readCodexTitles(), claudeReadings: readClaudeLimits(), claudeRecorderState: claudeRecorder() });
       const ours = new Set(boardAgentNames());
       for (const host of Object.keys(sum.lists)) {
         sum.lists[host].agents = sum.lists[host].agents.map((a) => ({ ...a, ours: ours.has(a.name) }));

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

@@ -6091,8 +6091,8 @@ function usageHostCard(d, host) {
     const meters = P ? meter(P.fiveHour) + meter(P.weekly) : '';
     limit = meters
       ? `<div class="usage-limit">${meters}<div class="usage-sub">as Claude Code reported it to the status line, ${esc(relTime(new Date(Math.max(...Object.values(P).map((l) => (l.current && l.current.readAt) || 0))).toISOString()))} ago · ${hits.plan} refused at a limit in ${d.window.days} days</div></div>`
-      : `<div class="usage-limit"><div class="usage-limit-head"><span>Plan limit</span>${absent('unloaded', 'Claude Code reports plan use only to the status line — turn on the recorder: great-cto statusline install')}</div>
-      <div class="usage-sub">${hits.plan} refused at the plan limit · ${hits.server} server-side throttles (not your limit) in ${d.window.days} days · plan percentage: <code>great-cto statusline install</code></div></div>`;
+      : `<div class="usage-limit"><div class="usage-limit-head"><span>Plan limit</span>${absent('unloaded', usageRecorderHint(d).short)}</div>
+      <div class="usage-sub">${hits.plan} refused at the plan limit · ${hits.server} server-side throttles (not your limit) in ${d.window.days} days · plan percentage: ${d.limits && d.limits.claude && d.limits.claude.recorder === 'on' ? 'from <code>claude</code> in a terminal' : '<code>great-cto statusline install</code>'}</div></div>`;
   }
   return `<section class="usage-card" data-host="${host}">
     <h3><span>${name}</span><span class="muted">${esc(d.window.from)} → ${esc(d.window.to)}</span></h3>
@@ -6205,9 +6205,21 @@ function usageLineSvg({ from, to, points, max, marks = [], ceiling = null, label
     <line class="grid" x1="0" x2="${W}" y1="${H}" y2="${H}"></line>${ceil}${ticks}<path class="ln" d="${path}"></path></svg>`;
 }
 
+// Plan percentage reaches only a status line Claude Code draws: the terminal
+// `claude` draws one, the desktop app's Code tab does not. So "recorder on, no
+// reading yet" gets its own words — sending the operator to install what they
+// already installed is the hint that misled on the first day.
+function usageRecorderHint(d) {
+  const on = d.limits && d.limits.claude && d.limits.claude.recorder === 'on';
+  return on
+    ? { short: 'recorder on, no reading yet — readings come from claude in a terminal', long: 'The recorder is on and has no reading yet. Claude Code passes its plan percentage only to a status line it draws: the terminal <code>claude</code> does, the desktop app\'s Code tab does not. One terminal session fills this in.' }
+    : { short: 'Claude Code reports plan use only to the status line — turn on the recorder: great-cto statusline install', long: 'Claude Code hands its plan percentage to the status line and to nothing else. <code>great-cto statusline install</code> records it here and keeps your own status line; readings come from <code>claude</code> in a terminal.' };
+}
+
 function usageClaudeLimits(d) {
-  const plan = d.limits && d.limits.claude && d.limits.claude.plan;
-  const head = `<h3><span>Claude Code limits</span><span class="muted">${plan ? 'as Claude Code reported them to the status line' : 'from refusals — turn on the status line recorder for plan percentages'}</span></h3>`;
+  const L0 = d.limits && d.limits.claude;
+  const plan = L0 && L0.plan;
+  const head = `<h3><span>Claude Code limits</span><span class="muted">${plan ? 'as Claude Code reported them to the status line' : L0 && L0.recorder === 'on' ? 'from refusals — plan percentages arrive from claude in a terminal' : 'from refusals — turn on the status line recorder for plan percentages'}</span></h3>`;
   if (!d.seen || !d.seen.claude) return `<section class="usage-card" data-limits="claude">${head}<p class="usage-note">No Claude Code logs on this machine.</p></section>`;
   const L = d.limits && d.limits.claude;
   if (!L) return `<section class="usage-card" data-limits="claude">${head}<p class="usage-note">Not computed.</p></section>`;
@@ -6229,7 +6241,7 @@ function usageClaudeLimits(d) {
   const CLAUDE_LANE = { fiveHour: '5-hour limit', weekly: 'Weekly limit', seven_day_opus: 'Weekly limit · Opus', seven_day_sonnet: 'Weekly limit · Sonnet', seven_day_oauth_apps: 'Weekly limit · apps' };
   const lanes = plan
     ? ['fiveHour', 'weekly', ...Object.keys(plan).filter((k) => k !== 'fiveHour' && k !== 'weekly')].filter((k) => plan[k]).map((k) => usageCodexLane(k, plan[k], d, CLAUDE_LANE[k] || k)).join('')
-    : `<p class="usage-note">Claude Code hands its plan percentage to the status line and to nothing else. <code>great-cto statusline install</code> records it here and keeps your own status line.</p>`;
+    : `<p class="usage-note">${usageRecorderHint(d).long}</p>`;
   return `<section class="usage-card" data-limits="claude">${head}
     ${lanes}
     <div class="usage-stats">${stat(esc(fmtUsdEq(L.fiveHour.usd)), 'last 5 hours, $ list')}${stat(esc(fmtUsdEq(L.sevenDay.usd)), 'last 7 days, $ list')}${stat(esc(String(hits.plan || 0)), `refusals in ${d.window.days} days`)}</div>

package/board/scripts/lib/session-usage.mjs

@@ -744,6 +744,21 @@ export function readClaudeLimits(file = path.join(home(), '.great_cto', 'claude-
   return out;
 }
 
+/**
+ * Is the plan-use recorder on? `great-cto statusline install` points Claude Code's
+ * statusLine at ~/.great_cto/statusline.mjs. On with no reading yet is not the
+ * same as never installed: only a status line Claude Code DRAWS gets the plan
+ * percentage — the terminal `claude` draws one, the desktop app's Code tab does
+ * not — so the board must say which of the two the operator is in.
+ */
+export function claudeRecorder(homeDir = home()) {
+  try {
+    const s = JSON.parse(fs.readFileSync(path.join(homeDir, '.claude', 'settings.json'), 'utf8'));
+    const cmd = s && s.statusLine && s.statusLine.command;
+    return typeof cmd === 'string' && /\.great_cto[\\/]statusline\.mjs/.test(cmd) ? 'on' : 'off';
+  } catch { return 'off'; }
+}
+
 /**
  * Plan windows from readings [{t, lane, minutes, used, resets}]: every window the
  * period touched with its peak and when it filled, the readings to draw, and —
@@ -808,7 +823,7 @@ function laneDetail(samples, { fromMs, now }) {
  * @param {object} index  from scanUsage
  * @param {{days?:number, now?:number, codexTitles?:Record<string,string>, prices?:object, top?:number}} opts
  */
-export function summarizeUsage(index, { days = 30, now = Date.now(), codexTitles = {}, prices = effectivePrices(), top = 10, claudeReadings = [] } = {}) {
+export function summarizeUsage(index, { days = 30, now = Date.now(), codexTitles = {}, prices = effectivePrices(), top = 10, claudeReadings = [], claudeRecorderState = 'off' } = {}) {
   const span = Math.max(1, Math.min(365, Math.floor(days) || 30));
   const dates = [];
   for (let i = span - 1; i >= 0; i--) dates.push(dayOf(now - i * 86400000));
@@ -943,7 +958,7 @@ export function summarizeUsage(index, { days = 30, now = Date.now(), codexTitles
     }])),
     limits: {
       codex: codexLimits ? { ...codexLimits, plan: codexLimits.plan || codexPlan?.plan || null, detail: codexLimitDetail(codexPoints, { fromMs, now }) } : null,
-      claude: { ...claudeLimits(hourly.claude, { fromMs, now, lastHit }), plan: claudePlanDetail(claudeReadings, { fromMs, now }) },
+      claude: { ...claudeLimits(hourly.claude, { fromMs, now, lastHit }), plan: claudePlanDetail(claudeReadings, { fromMs, now }), recorder: claudeRecorderState },
     },
     unpricedModels: [...unpriced].sort(),
     // Claude Code only: Codex does not write hook outcomes to its session logs.

package/dist/statusline.js

@@ -117,6 +117,7 @@ export function runStatuslineCommand(argv) {
         }
         success(`${r.message} ${dim(r.backup ? `(settings backup: ${r.backup})` : "")}`);
         console.log("  Claude's plan use is recorded on the next status line refresh; the board shows it under Usage → Limits.");
+        console.log("  Readings come from `claude` in a terminal: the desktop app's Code tab does not draw a status line.");
         console.log(`  Undo: ${dim("great-cto statusline uninstall")}`);
         return 0;
     }
@@ -135,6 +136,8 @@ export function runStatuslineCommand(argv) {
         if (st.chain)
             console.log(`your status line (shown through it): ${st.chain}`);
         console.log(`last reading: ${st.lastReading ? JSON.stringify(st.lastReading) : "none yet"}`);
+        if (st.installed && !st.lastReading)
+            console.log("  (readings come from `claude` in a terminal; the desktop app's Code tab does not draw a status line)");
         return 0;
     }
     warn(`unknown: great-cto statusline ${sub} — use install, uninstall or status`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "great-cto",
-  "version": "3.58.0",
+  "version": "3.58.2",
   "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",