trantor 0.17.39 → 0.17.40

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "trantor",
-  "version": "0.17.39",
+  "version": "0.17.40",
   "description": "Trantor — the hub-world for AI agent crews: live message bus, presence, project Kanban/flow board + crew orchestration for independent AI coding agents (Claude, Codex, Gemini, Kimi, DeepSeek)",
   "mcpServers": {
     "relay": {

package/bin/baton.mjs

@@ -30,7 +30,7 @@ function findTranscript() {
 }
 
 const transcript = findTranscript();
-const { file } = writeHandoff({ projectDir: cwd, sessionId: "", transcript, trigger: "manual-cli" });
+const { file } = writeHandoff({ projectDir: cwd, sessionId: "", transcript, trigger: "manual-cli", force: true });   // manual = intentional, bypass the storm guard
 console.log(`📋 handoff saved for ${project}: ${file}`);
 const { spawned, armed, windowId } = spawnBaton({ projectDir: cwd, handoffFile: file });
 console.log(spawned

package/hooks/handoff-now.mjs

@@ -12,7 +12,9 @@ import { basename } from "node:path";
 const [, , projectDir = process.cwd(), sessionId = "", transcript = "", trigger = "context-warn", windowId = "", tty = ""] = process.argv;
 try {
   const conf = readConfig();
-  const { file, record } = writeHandoff({ projectDir, sessionId, transcript, trigger });
+  const result = writeHandoff({ projectDir, sessionId, transcript, trigger });   // auto path — honors the hub storm guard
+  if (result.skipped) { process.stderr.write(`[trantor] handoff SKIPPED by storm-guard (${result.reason}; ${result.sinceSec ?? "?"}s since last) — no fresh window spawned\n`); process.exit(0); }
+  const { file, record } = result;
   process.stderr.write(`[trantor] baton handoff written: ${file}\n`);
   await pingBus(basename(projectDir), record.id, conf);
   if (maybeSpawn(projectDir, conf)) {                 // open the fresh session that takes over

package/hooks/heartbeat.mjs

@@ -20,6 +20,7 @@ import { spawn } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { readConfig, contextUsage, warnFrac, alreadyHandedOff, markHandedOff, controllingTty, terminalWindowForTty, subagentsActive } from "./lib/handoff.mjs";
 import { resolveProject, hostId } from "../lib/project.mjs";
+import { installedVersion } from "./lib/update-check.mjs";   // report our hook version so the hub can flag stale sessions
 
 const HEARTBEAT_MS = Number(process.env.RELAY_HEARTBEAT_MS || 60 * 1000);
 const FETCH_TIMEOUT_MS = Number(process.env.RELAY_HEARTBEAT_TIMEOUT_MS || 1500);
@@ -121,7 +122,7 @@ async function main(stdinRaw) {
     await fetch(`${relayUrl()}/register`, {
       method: "POST",
       headers: { "content-type": "application/json" },
-      body: JSON.stringify({ session, project }),
+      body: JSON.stringify({ session, project, hookVersion: (() => { try { return installedVersion(); } catch { return ""; } })() }),
       signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
     });
   } catch {}

package/hooks/lib/handoff.mjs

@@ -213,8 +213,21 @@ export function verbatimRecentTail(transcript, chars = 7000) {
 }
 
 // ---- write + announce + spawn ----------------------------------------------
-export function writeHandoff({ projectDir, sessionId, transcript, trigger, summary }) {
+export function writeHandoff({ projectDir, sessionId, transcript, trigger, summary, force = false }) {
   const projectName = basename(projectDir);
+  // Server-side storm guard: a session running OLD hooks (before the local markHandedOff guard) re-fires
+  // context-warn handoffs every few minutes — the crebral-cortex storm (9 in 49 min, each spawning a
+  // window). Ask the hub for clearance (rate-limit per project+session); a non-forced handoff inside the
+  // cooldown is SKIPPED — no file, no spawn. Manual (/trantor:handoff) + at-wall (precompact) handoffs
+  // force through. Fail-OPEN if the hub is unreachable, so a legit handoff is never blocked.
+  if (!force) {
+    try {
+      const body = JSON.stringify({ project: projectName, session: sessionId || "", trigger: trigger || "auto" });
+      const out = execSync(`curl -s --max-time 2 -X POST -H 'content-type: application/json' -d ${JSON.stringify(body)} ${JSON.stringify(relayUrl() + "/handoff")}`, { encoding: "utf8", timeout: 2500 });
+      const r = JSON.parse(out);
+      if (r && r.allow === false) return { skipped: true, reason: r.reason || "storm-guard", sinceSec: r.sinceSec };
+    } catch {}
+  }
   if (!existsSync(HANDOFF_DIR)) mkdirSync(HANDOFF_DIR, { recursive: true });
   const stamp = nowSec() || Date.now();
   let gitStatus = "";

package/hooks/precompact.mjs

@@ -25,7 +25,7 @@ try {
   const sessionId = input.session_id || "";
   const conf = readConfig();
 
-  const { file, record } = writeHandoff({ projectDir, sessionId, transcript, trigger });
+  const { file, record } = writeHandoff({ projectDir, sessionId, transcript, trigger, force: true });   // at-wall backstop — must never be storm-guard-suppressed
   process.stderr.write(`[trantor] handoff written: ${file} (trigger=${trigger})\n`);
 
   await pingBus(projectName, record.id, conf);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trantor",
-  "version": "0.17.39",
+  "version": "0.17.40",
   "type": "module",
   "bin": {
     "trantor": "bin/cli.mjs"
@@ -10,7 +10,7 @@
     "zod": "^4.4.3"
   },
   "scripts": {
-    "test": "node test.mjs && node test-scenarios.mjs && node test-failure.mjs && node test-handoff.mjs && node test-agents.mjs && node test-update.mjs && node test-balances.mjs && node test-subagent-cost.mjs"
+    "test": "node test.mjs && node test-scenarios.mjs && node test-failure.mjs && node test-handoff.mjs && node test-agents.mjs && node test-update.mjs && node test-handoff-guard.mjs && node test-balances.mjs && node test-subagent-cost.mjs"
   },
   "description": "The hub-world for AI agent crews — orchestrate Claude Code, Codex, Gemini, Kimi & DeepSeek as live crews with a plan-aware Advisor, a Kanban/flow command center, a testing gate, and an economics brain (Scrooge).",
   "files": [

package/ui.html

@@ -53,6 +53,7 @@ main:not(.learn-open) .learn-body{display:none}
 .agents{display:flex;gap:6px;flex-wrap:wrap}
 .agent{display:flex;align-items:center;gap:5px;background:var(--card);border:1px solid var(--line);border-radius:16px;padding:2px 9px 2px 6px;font-size:11.5px;color:var(--mut)}
 .agent .nm{color:var(--tx)}
+.agent .stale{font-size:9.5px;font-weight:700;color:#ffb454;background:#2a1f10;border:1px solid #5a3c1a;border-radius:7px;padding:1px 5px;cursor:help}
 .agent svg{flex:none}
 .agent.offl{opacity:.42}
 .agent.err{border-color:#ef4444;color:#ef4444}
@@ -768,7 +769,7 @@ async function render(){
     const pmsgs = msgs.filter(m=>projOf(m)===p.project);
     const done=pt.filter(t=>t.status==='done').length;
     const pct=pt.length?Math.round(done/pt.length*100):0;
-    const agents=p.agents.sort((a,b)=>b.online-a.online).map(a=>`<span class="agent ${a.online?'':'offl'}${a.health==='down'?' down':a.health==='errored'?' err':''}" title="${esc(a.session)}${a.online?' · online':' · offline'}${a.health&&a.health!=='ok'?' · '+a.health:''}">${iconFor(a.session,15)}<span class="nm">${esc(a.session)}</span>${a.status?` <span class="ast">· ${esc(a.status)}</span>`:''}${poolOf(a.session)?` <span class="ast" style="opacity:.7">[${esc(poolOf(a.session))}]</span>`:''}</span>`).join('');
+    const agents=p.agents.sort((a,b)=>b.online-a.online).map(a=>`<span class="agent ${a.online?'':'offl'}${a.health==='down'?' down':a.health==='errored'?' err':''}" title="${esc(a.session)}${a.online?' · online':' · offline'}${a.health&&a.health!=='ok'?' · '+a.health:''}${a.staleHooks?' · OLD Trantor hooks ('+esc(a.hookVersion)+') — restart this session to get the baton safety fixes':''}">${iconFor(a.session,15)}<span class="nm">${esc(a.session)}</span>${a.staleHooks?` <span class="stale" title="running old Trantor hooks (${esc(a.hookVersion)}) — restart to load the baton storm/kill safety fixes">⚠ old hooks</span>`:''}${a.status?` <span class="ast">· ${esc(a.status)}</span>`:''}${poolOf(a.session)?` <span class="ast" style="opacity:.7">[${esc(poolOf(a.session))}]</span>`:''}</span>`).join('');
     const cols=COLS.map(([k,label])=>{
       let cards=pt.filter(t=>k==='testing'?(t.status==='testing'||t.status==='failed'):t.status===k);
       if(k==='done')cards=[...cards].sort((a,b)=>(b.updated||0)-(a.updated||0)); // newest finished on top