trantor 0.17.63 → 0.17.65

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "trantor",
-  "version": "0.17.63",
+  "version": "0.17.65",
   "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/app.mjs

@@ -40,7 +40,10 @@ function installedVersion() {
 // Newest release carrying a Trantor DMG for this arch (falls back to any Trantor DMG — old
 // releases may predate multi-arch naming). GITHUB_TOKEN is honored but not required (public repo).
 async function latestAppRelease() {
-  const headers = { accept: "application/vnd.github+json", "user-agent": "trantor-app" };
+  // cache-control: GitHub serves unauthenticated API responses through a shared ~60s cache — a
+  // release published seconds ago comes back MISSING and `app update` re-installs the previous
+  // version (observed live on the 0.2.0 release). no-cache punches through it.
+  const headers = { accept: "application/vnd.github+json", "user-agent": "trantor-app", "cache-control": "no-cache" };
   if (process.env.GITHUB_TOKEN) headers.authorization = `Bearer ${process.env.GITHUB_TOKEN}`;
   const r = await fetch(`https://api.github.com/repos/${REPO}/releases?per_page=30`, { headers, signal: AbortSignal.timeout(15000) });
   if (!r.ok) throw new Error(`GitHub API ${r.status} — ${(await r.text()).slice(0, 200)}`);

package/bin/crew-runner.mjs

@@ -83,14 +83,23 @@ async function api(path, body) {
 const CMUX_BIN = process.env.CMUX_BIN
   || (existsSync("/Applications/cmux.app/Contents/Resources/bin/cmux") ? "/Applications/cmux.app/Contents/Resources/bin/cmux" : "cmux");
 const inCmux = () => !!process.env.CMUX_SURFACE_ID;
-function cmuxStatus(value, color, icon = "robot") {
+// Brand colors — the SAME hexes the desktop app's Avatar.tsx uses, so a seat is the same color in
+// the cmux sidebar and the Trantor app. cmux status icons are a fixed named set (no images), so an
+// actual LLM logo in the pill is not possible — brand COLOR + the agent's name in the label is the
+// closest cmux allows.
+const BRAND_HEX = { claude: "#D97757", codex: "#e8e8ee", openai: "#e8e8ee", deepseek: "#5786FE",
+  kimi: "#8b8bf5", moonshot: "#8b8bf5", glm: "#5ea0f5", zai: "#5ea0f5", gemini: "#8E75B2", openrouter: "#94A3B8" };
+function cmuxStatus(value, color, icon = "robot", opts = {}) {
   if (!inCmux()) return;
   // Label with the REAL seat identity, not a literal. This was hardcoded to "trantor", so every seat
   // in every project reported under one name — four different agents (and their duplicates) rendered
   // identically in the sidebar, which is why a runner leak looked like mystery sessions instead of
   // obvious duplicates. Note this is the DISPLAY path; two previous fixes to the crossed-label
   // symptom both landed on the *bus* identity and never touched this line.
-  try { spawnSync(CMUX_BIN, ["set-status", SESSION, value, "--color", color, "--icon", icon], { stdio: "ignore", timeout: 1500, env: { ...process.env, CMUX_QUIET: "1" } }); } catch {}
+  // Pill = "<agent> · <state>" in the agent's BRAND color (alerts keep their alarm color — a red
+  // error must read as red at a glance); errors sort first via --priority.
+  const col = opts.alert ? color : (BRAND_HEX[AGENT.toLowerCase()] || color);
+  try { spawnSync(CMUX_BIN, ["set-status", SESSION, `${AGENT} · ${value}`, "--color", col, "--icon", icon, "--priority", String(opts.priority ?? 0)], { stdio: "ignore", timeout: 1500, env: { ...process.env, CMUX_QUIET: "1" } }); } catch {}
 }
 function cmuxLog(message, level = "info") {
   if (!inCmux()) return;
@@ -170,7 +179,7 @@ async function reportFailure(exit, trigger) {
     ? `🛑 ${SESSION} DOWN — ${consecFails} consecutive failures (${reason}, exit ${exit})${hint}`
     : `⚠️ ${SESSION} turn FAILED (${trigger}, exit ${exit} · ${reason})${hint}`;
   await api("/send", { from: SESSION, to: "all", text, project: PROJ }).catch(() => {});
-  cmuxStatus(down ? "down" : "error", "#ef6a6a", "alert"); cmuxLog(`turn failed: ${reason} (exit ${exit})`, "error");
+  cmuxStatus(down ? "down" : "error", "#ef6a6a", "alert", { alert: true, priority: 90 }); cmuxLog(`turn failed: ${reason} (exit ${exit})`, "error");
   log(`\x1b[31mreported failure to bus: ${reason} (exit ${exit})\x1b[0m`);
 }
 
@@ -195,7 +204,7 @@ function runTurn(prompt, isFirst, trigger = "kickoff") {
   const envs = [join(homedir(), ".agent-bus", ".env"), cli.env].filter(f => f && existsSync(f));
   for (const f of envs.reverse()) cmd = `set -a; source ${f}; set +a; ${cmd}`;   // ~/.agent-bus/.env wins
   log(`turn starting (${isFirst ? "fresh session" : "resume"})${MODEL ? ` · model=${MODEL}` : ""}`);
-  cmuxStatus("building", "#4a90d9", "hammer");
+  cmuxStatus("building", "#4a90d9", "hammer", { priority: 50 });
   // inherit stdio so the window shows the agent working live; also capture for sid-parsing.
   // Tee stderr to ERRF (still shown live in the window) so a failed turn can be classified.
   try { appendFileSync(ERRF, "", { flag: "w" }); } catch {}
@@ -256,7 +265,14 @@ async function loadLessons() {
     try {
       const r = await api(`/poll?session=${encodeURIComponent(SESSION)}&since=${cursor}&wait=280`);
       msgs = r.messages || []; cursor = r.cursor ?? cursor;
-    } catch (e) { log(`hub unreachable (${e.message}) — retrying in 5s`); await new Promise(s => setTimeout(s, 5000)); continue; }
+    } catch (e) {
+      // Deadline-abort on the LONG-POLL is not an outage — it means the hold expired with no hub
+      // response (stalled event loop, napped machine, dead socket). Reconnect immediately and say
+      // so calmly; reserve the scary "hub unreachable" + 5s backoff for real connection failures.
+      const expired = e && (e.name === "TimeoutError" || /abort/i.test(String(e.message)));
+      log(expired ? `long-poll hold expired with no hub response — reconnecting` : `hub unreachable (${e.message}) — retrying in 5s`);
+      await new Promise(s => setTimeout(s, expired ? 250 : 5000)); continue;
+    }
     if (!msgs.length) continue;                       // heartbeat tick, nothing for us
     const direct = msgs.filter(m => m.to === SESSION);
     const mentions = msgs.filter(m => m.to === "all" && (m.text.includes(`@${AGENT}`) || m.text.toLowerCase().includes(`${AGENT}:`)));

package/bin/crew.sh

@@ -554,7 +554,8 @@ spawn_cmux() {   # $@ = specs
     echo "  → $AGENT seat in cmux workspace ($PROJ)"
     i=$(( i + 1 ))
   done
-  [ "$DRY" = "1" ] || [ -z "$wsid" ] || _cmux set-status trantor "crew up" --icon rocket --color "#14b8a6" --workspace "$wsid" >/dev/null 2>&1
+  # (no workspace-level "crew up" pill — the per-seat pills the runners push carry all the signal;
+  # a fifth static pill just forced the sidebar into "Show more".)
   echo "— crew grouped in cmux: ONE workspace tab for $PROJ, seats tiled + sidebar status. Teardown (this project only): trantor down —"
 }
 

package/bin/duty.mjs

@@ -66,7 +66,9 @@ async function ensureFleetIdentity(hub) {
 function alivePid() {
   try {
     const pid = Number(readFileSync(PIDF, "utf8"));
-    if (pid && process.kill(pid, 0) === undefined) return pid;
+    // process.kill(pid, 0) returns TRUE on success (it throws when the pid is gone) — the original
+    // `=== undefined` comparison made alivePid always 0, so `duty status` reported NOT running forever.
+    if (pid) { process.kill(pid, 0); return pid; }
   } catch {}
   return 0;
 }

package/hooks/heartbeat.mjs

@@ -147,6 +147,22 @@ async function main(stdinRaw) {
     }
   } catch {}
 
+  // Overseer narration, same ambient pattern (10-min machine-wide stamp): the narrate worker was
+  // built "to run ambiently from the heartbeat" but was never actually wired in — warns sat
+  // mechanical forever unless someone ran it by hand. The worker exits in one cheap signed GET per
+  // hub when nothing is unnarrated; Scrooge is only invoked when there IS a warn to explain.
+  try {
+    const narStamp = join(homedir(), ".agent-bus", "narrate.stamp");
+    const last = existsSync(narStamp) ? Number(readFileSync(narStamp, "utf8")) || 0 : 0;
+    if (Date.now() - last > 10 * 60 * 1000) {
+      writeFileSync(narStamp, String(Date.now()));
+      const worker = spawn(process.execPath, [join(HERE, "..", "bin", "overseer-narrate.mjs"), "--quiet"], {
+        detached: true, stdio: "ignore",
+      });
+      worker.unref();
+    }
+  } catch {}
+
   // Same cadence as the presence ping: check context pressure and hand off early
   // if we've crossed the warn threshold of a known window.
   await maybeEarlyWarn(stdinRaw, session);

package/hub.mjs

@@ -214,6 +214,10 @@ import("./lib/overseer.mjs").then(m => { _overseer = m; }).catch(() => {});
 const OVERSEER_TICK_MS = Number(process.env.RELAY_OVERSEER_TICK_MS || 30 * 1000);
 const OVERSEER_DEDUP_MS = Number(process.env.RELAY_OVERSEER_DEDUP_MS || 10 * 60 * 1000);
 const overseerWarned = new Map();   // dedup key -> ts
+// Heartbeat for the WATCHER itself: /overseer/status must distinguish "fleet is clear" from "the
+// overseer stopped ticking" — a monitor that cannot prove it is alive reads as clear when dead.
+let overseerLastTick = 0;
+let overseerLastCollisions = [];
 function overseerPolicy() {
   const p = state.orgPolicy && typeof state.orgPolicy === "object" ? state.orgPolicy : {};
   return {
@@ -236,6 +240,7 @@ function overseerTick() {
   if (!_overseer?.detectCollisions) return;
   let collisions = [];
   try { collisions = _overseer.detectCollisions(overseerInputs()) || []; } catch { return; }
+  overseerLastTick = now(); overseerLastCollisions = collisions;
   const cut = now() - OVERSEER_DEDUP_MS;
   for (const [k, ts] of overseerWarned) if (ts < cut) overseerWarned.delete(k);
   const pol = overseerPolicy();
@@ -495,7 +500,7 @@ function cmpSemver(a, b) {
 const AUTH_HEADERS = ["x-trantor-pubkey", "x-trantor-sig", "x-trantor-ts", "x-trantor-nonce"];
 const PUBLIC_ENDPOINTS = new Set(["/", "/ui", "/health", "/enroll"]);
 const OWNER_ENDPOINTS = new Set(["/project/delete", "/sweep", "/reconcile", "/invite", "/import", "/policy"]);
-const READ_ENDPOINTS = new Set(["/peers", "/tasks", "/events", "/inbox", "/peer", "/card", "/stream", "/history", "/projects", "/catchup", "/phases", "/recent", "/handoffs", "/verify-gates", "/claims", "/overseer/context"]);
+const READ_ENDPOINTS = new Set(["/peers", "/tasks", "/events", "/inbox", "/peer", "/card", "/stream", "/history", "/projects", "/catchup", "/phases", "/recent", "/handoffs", "/verify-gates", "/claims", "/overseer/context", "/overseer/status"]);
 const roleRank = { read: 1, write: 2, owner: 3 };
 const hasAuthHeaders = (req) => AUTH_HEADERS.some(h => !!req.headers[h]);
 const authPath = (u) => `${u.pathname}${u.search || ""}`;
@@ -1013,6 +1018,32 @@ const server = http.createServer(async (req, res) => {
     }
     // What a session arriving on <project> needs to know: its autonomy level, who else is live,
     // which files are in flight, which projects are declared codependent, current collisions.
+    if (req.method === "GET" && P === "/overseer/status") {
+      // The Overseer view's backbone: is the watcher ALIVE, and what is it watching right now.
+      // `warnings` is the LIVE detection result from the last tick (pre-dedup), not the event log —
+      // the log answers "what did it do", this answers "what does it see".
+      const pol = overseerPolicy();
+      const cutoff = now() - ONLINE_MS;
+      const livePeers = Object.entries(state.peers).filter(([, v]) => v.lastSeen > cutoff);
+      pruneClaims();
+      return json(res, 200, {
+        engine: !!_overseer?.detectCollisions,
+        lastTickTs: overseerLastTick,
+        tickMs: OVERSEER_TICK_MS,
+        dedupMs: OVERSEER_DEDUP_MS,
+        dutySession: DUTY_SESSION || "",
+        watching: {
+          sessions: livePeers.length,
+          projects: new Set(livePeers.map(([, v]) => v.project).filter(Boolean)).size,
+          claims: fileClaims.size,
+          links: pol.links.length,
+        },
+        autonomy: pol.autonomy,
+        links: pol.links,
+        warnings: overseerLastCollisions,
+        warnedRecent: overseerWarned.size,
+      });
+    }
     if (req.method === "GET" && P === "/overseer/context") {
       const proj = canon(String(q.project || "").slice(0, 80));
       if (!proj) return json(res, 400, { error: "project required" });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trantor",
-  "version": "0.17.63",
+  "version": "0.17.65",
   "type": "module",
   "bin": {
     "trantor": "bin/cli.mjs"