trantor 0.18.94 → 0.18.96

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "trantor",
-  "version": "0.18.94",
+  "version": "0.18.96",
   "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/crew-runner.mjs

@@ -29,7 +29,7 @@ import {
 } from "../lib/turn-policy.mjs";
 import { snapshotBeforeCut } from "./cut-snapshot.mjs";
 import { ocTurnUsage, dshTurnUsage, usageTotal } from "../lib/turn-usage.mjs";
-import { ocCompactionContent } from "../lib/seat-compaction.mjs";
+import { ocCompactionContent, ocCompactionLogLine } from "../lib/seat-compaction.mjs";
 import { listContainers, newContainers, recordContainers, statePathFor as dockerStatePathFor, sweep as dockerSweep } from "../lib/docker-janitor.mjs";
 import {
   auditDutyNudges, claimDutyNudges, claudeTranscriptDir, dutyEscalations, dutyNudgeDirective,
@@ -37,7 +37,7 @@ import {
 } from "../lib/duty-nudges.mjs";
 import { reserveNudgeIds, releaseNudgeIds } from "../lib/nudge-ledger.mjs";
 import { dutyRecipientResolver } from "../lib/duty-recipient.mjs";
-import { cliEffortFlag } from "../lib/model-catalog.mjs";
+import { cliEffortFlag, contextWindow } from "../lib/model-catalog.mjs";
 import {
   BREAKER_WINDOW, STATE_ENV, TURN_RESULT_SCHEMA,
   breakerVerdict, describeTurn, hasJsonSchemaFlag, parseEnvelope, renderCardTail, runStep,
@@ -758,10 +758,12 @@ let cardStartedAt = releaseState?.cardStartedAt || 0;
 let budgetStop = releaseState?.budgetStop || null;   // { card, tokens } once the card crossed
 let budgetRetryAt = releaseState?.budgetRetryAt || 0;   // paces the paused card's OWN redeliveries
 
-// #11559: the compaction block injected to opencode-family seats via OPENCODE_CONFIG_CONTENT.
-// "" injects nothing (the operator set TRANTOR_OC_COMPACTION=off, or its JSON is invalid — the
-// seat then behaves exactly as before, never with a half-armed config).
-const OC_COMPACTION = ocCompactionContent(process.env);
+// #11559: the compaction block injected to opencode-family seats via OPENCODE_CONFIG_CONTENT (""
+// injects nothing: TRANTOR_OC_COMPACTION=off or invalid JSON). opencode has no absolute-threshold
+// knob — auto-compact fires at window − reserved (opencode.ai/config.json; calculateCeiling in
+// core/src/session/compaction.ts) — so reserved is sized from the seat model's catalog window.
+const OC_COMPACTION_WINDOW = contextWindow(MODEL);
+const OC_COMPACTION = ocCompactionContent(process.env, OC_COMPACTION_WINDOW);
 
 let sid = releaseState?.sid || "";
 // #6206: the watchdog is DETACHED, so a runner that dies without ending it leaves an orphan
@@ -836,6 +838,8 @@ async function runTurn(prompt, isFirst, trigger = "kickoff", opts = {}) {
   log(`turn starting (${isFirst ? "fresh session" : "resume"})${MODEL ? ` · model=${MODEL}` : ""}`);
   // #7777: the one effort line — which effort parameters were set, or that the model is uncatalogued.
   if (EFFORT && EFFORT_FLAG.text) log(EFFORT_FLAG.text);
+  // #11559: the one compaction line — only where the block actually rides the spawn.
+  if (cli.pinned && OC_COMPACTION) log(ocCompactionLogLine(OC_COMPACTION_WINDOW));
   cmuxStatus("building", "#4a90d9", "hammer", { priority: 50 }); herdrAgent("working");
   // 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.

package/hooks/lib/memory-start.mjs

@@ -4,6 +4,8 @@ import { isMainThread, parentPort, Worker, workerData } from "node:worker_thread
 import { gitCheckoutRoot } from "./git-checkout.mjs";
 
 const SLOW = "pin check skipped (slow), run trantor memory check";
+// Tests on a loaded CI runner raise this; the hook itself keeps 500 ms.
+const BUDGET_MS = Number(process.env.TRANTOR_PIN_CHECK_BUDGET_MS) || 500;
 
 export function memoryStartLine(project) {
   return new Promise(resolveLine => {
@@ -17,7 +19,7 @@ export function memoryStartLine(project) {
       if (worker) void worker.terminate().catch(() => {});
     };
     // Keep synchronous graph parsing and file reads off the hook's deadline timer.
-    const timer = setTimeout(() => finish(SLOW), 500);
+    const timer = setTimeout(() => finish(SLOW), BUDGET_MS);
     try {
       worker = new Worker(new URL(import.meta.url), { workerData: { project } });
       worker.once("message", finish);
@@ -37,7 +39,7 @@ async function cachedMemoryLine(directory) {
   const graph = JSON.parse(readFileSync(graphPath, "utf8"));
   const nodes = new Map(graph.nodes.map(node => [node.id, node]));
   const graphTime = statSync(graphPath).mtimeMs;
-  let unchecked = 0;
+  const unchecked = new Set();
   const stale = new Set(), broken = new Set();
   const notes = readdirSync(memoryDir, { withFileTypes: true })
     .filter(entry => entry.isFile() && entry.name.endsWith(".md") && entry.name !== "MEMORY.md");
@@ -45,7 +47,7 @@ async function cachedMemoryLine(directory) {
     try {
       const pins = notePins(readFileSync(join(memoryDir, note.name), "utf8"));
       for (const pin of pins) {
-        if (pinFileNewer(project, pin, graphTime)) { unchecked++; continue; }
+        if (pinFileNewer(project, pin, graphTime)) { unchecked.add(note.name); continue; }
         const { status } = checkPin(pin, project, nodes);
         if (status === "stale") stale.add(note.name);
         if (status === "broken") broken.add(note.name);
@@ -53,8 +55,11 @@ async function cachedMemoryLine(directory) {
     } catch { /* A concurrent edit or invalid span must not suppress other notes. */ }
   }
   const names = [...new Set([...stale, ...broken])].sort().map(name => name.replace(/[\s\x00-\x1f\x7f]+/g, " "));
-  const suffix = unchecked ? ` (${unchecked} unchecked: graph older than code, run trantor memory check)` : "";
-  return names.length || unchecked ? `${stale.size} stale, ${broken.size} broken notes: ${names.join(", ")}; run trantor memory check${suffix}` : "";
+  const parts = [];
+  if (names.length) parts.push(`${stale.size} stale, ${broken.size} broken notes: ${names.join(", ")}`);
+  if (unchecked.size) parts.push(`${unchecked.size} pinned notes unchecked (graph older than code)`);
+  if (!parts.length) return "";
+  return `${parts.join("; ")}${unchecked.size ? "," : ";"} run trantor memory check`;
 }
 
 if (!isMainThread) {

package/hooks/sessionstart.mjs

@@ -405,6 +405,11 @@ try {
   // A RESUMED session must never claim a handoff: it already carries its history, so the takeover banner
   // would land in the same maxed-out context and look right while the window never reset.
   const isResume = source === "resume";
+  // A print-mode one-shot (`claude -p`) is never the successor either (#11577): SessionStart fires
+  // for it with source "startup" — the hook INPUT is indistinguishable from a human start — but
+  // the CLI marks the hook ENV (CLAUDE_CODE_ENTRYPOINT=sdk-cli; interactive "cli", SDKs sdk-*).
+  // Unguarded, it claimed the waiting handoff and superseded the live orchestrator.
+  const isPrintRun = String(process.env.CLAUDE_CODE_ENTRYPOINT || "cli").startsWith("sdk-");
   const orchEnv = process.env.TRANTOR_ORCH || "";
   const isOrchPane = !!orchEnv && (orchEnv === "1" || orchEnv === project);   // project-matched: a child claude in another dir must not inherit the badge
   const orchSid = readOrchSession(project);
@@ -413,19 +418,24 @@ try {
   const orchOrigin = !!(peek && orchSid && peek.session_id && peek.session_id === orchSid);
   const ageMs = peek ? Date.now() - (Number(peek.stamp) || 0) * 1000 : 0;
   const held = orchOrigin && !isOrchPane && !isCompact && ageMs < holdMs;
-  const handoff = !peek ? null
+  const handoff = !peek || isPrintRun ? null
     : (isCompact || held || isResume) ? peek
     : loadPendingHandoff(basename(projectDir), {
         claim: true,
         freshSession: { session_id: stdinObj.session_id || "", transcript_path: stdinObj.transcript_path || "" },
       });
   const claimed = !!handoff && !isCompact && !held && !isResume;
+  // The handoff banner never rides a one-shot either: it is not the successor and nobody asked it
+  // to recap, so a print start with a pending handoff gets one quiet stderr line and nothing else.
+  if (isPrintRun && peek && !isCompact) {
+    process.stderr.write(`[trantor] pending handoff ${peek.id} NOT claimed — print-mode one-shot (claude -p) is never the successor\n`);
+  }
   // Follow the thread: claiming the orchestrator's baton makes THIS session the orchestrator
   // thread, so the map `trantor open` resumes and the app's chat reads moves with it. The pane
   // also records itself on every fresh start — that keeps the map honest even if a future
   // claude forks the session id on resume.
   if (claimed && orchOrigin && stdinObj.session_id) writeOrchSession(project, String(stdinObj.session_id), "sessionstart-claim");
-  if (isOrchPane && !isCompact && stdinObj.session_id) writeOrchSession(project, String(stdinObj.session_id), "orch-pane-start");
+  if (isOrchPane && !isCompact && !isPrintRun && stdinObj.session_id) writeOrchSession(project, String(stdinObj.session_id), "orch-pane-start");
   if (handoff && held) {
     process.stderr.write(`[trantor] pending handoff ${handoff.id} HELD for the orch pane (${Math.round(ageMs / 60000)}m old)\n`);
     const mins = Math.max(1, Math.round((holdMs - ageMs) / 60000));

package/lib/model-catalog.mjs

@@ -40,6 +40,15 @@ export function lookup(modelId, cat = loadCatalog()) {
   return uncatalogued(id);
 }
 
+// The model's context window from its catalog entry: a positive finite number, or undefined
+// when the id is uncatalogued or its context is absent/invalid — callers keep their own
+// default instead of guessing a window.
+export function contextWindow(modelId, cat = loadCatalog()) {
+  const entry = lookup(modelId, cat);
+  const context = entry.found ? entry.context : undefined;
+  return Number.isFinite(context) && context > 0 ? context : undefined;
+}
+
 // The request parameters one difficulty level maps to for one API kind. Returns null when the
 // model is uncatalogued (or the level is missing); an EMPTY object means catalogued but the
 // model takes no effort parameters (provider default — e.g. K2.7 Code thinks always).

package/lib/project.mjs

@@ -1,17 +1,23 @@
 // trantor — canonical project identity (client side): one repo = one lane, keyed by the id recorded
 // in the checkout (.trantor/project.json) or, unmarked, by the git repo root basename; an explicit
 // RELAY_PROJECT always wins and the hub folds aliases on top.
-import { execSync } from "node:child_process";
+import { execSync, execFileSync } from "node:child_process";
 import { readFileSync, writeFileSync, appendFileSync, existsSync, mkdirSync, readdirSync, statSync, realpathSync } from "node:fs";
 import { basename, join, dirname, resolve, sep } from "node:path";
 import { homedir, hostname } from "node:os";
 import { asRecord, asString } from "./decode.mjs";
 
 export function gitRoot(dir) {
-  try {
-    return execSync(`git -C ${JSON.stringify(dir)} rev-parse --show-toplevel`,
-      { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"], timeout: 2000 }).trim();
-  } catch { return ""; }
+  // A loaded runner can miss the short deadline; retry timeouts, not non-repository errors (#11580).
+  for (const timeout of [2000, 10000]) {
+    try {
+      return execFileSync("git", ["-C", dir, "rev-parse", "--show-toplevel"],
+        { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"], timeout }).trim();
+    } catch (error) {
+      if (error.code !== "ETIMEDOUT") return "";
+    }
+  }
+  return "";
 }
 
 // A BUS SEAT WORKTREE is named for its project BY CONSTRUCTION — the bus creates

package/lib/seat-compaction.mjs

@@ -1,29 +1,45 @@
-// #11559: seats run long cards in ONE opencode session (#6134's design), and opencode only
-// auto-compacts when the context is FULL - far past 100K on big-limit models. The knob is the
-// top-level `compaction` block (schema: opencode.ai/config.json), injected per seat via
-// OPENCODE_CONFIG_CONTENT (override: TRANTOR_OC_COMPACTION), which MERGES with the operator's global config.
+// #11559: seats run long cards in one opencode session (#6134), and opencode auto-compacts only at
+// window − reserved — there is NO absolute-threshold knob (opencode.ai/config.json,
+// additionalProperties:false; calculateCeiling in packages/core/src/session/compaction.ts). So the
+// seat target "compact near 100K" is reached by sizing reserved from the model's window.
 
 export const OC_COMPACTION_ENV = "TRANTOR_OC_COMPACTION";
+// The context level a seat card should stay near: on a 1M-window model reserved becomes 900K
+// so auto-compact fires at ~100K, not the ~936K a fixed 64K buffer leaves.
+export const OC_COMPACT_AT = 100_000;
+// The buffer floor: kept when the model's window is unknown, or smaller than would still
+// leave OC_COMPACT_AT free.
+export const OC_RESERVED_FLOOR = 64_000;
 
 // The seat default: compaction on, old tool outputs pruned, a small recent window preserved.
-// `reserved` is the buffer subtracted from the model's window before opencode calls the context
-// full, so a larger value fires compaction earlier. Override the whole block with
-// TRANTOR_OC_COMPACTION=<json>, or set it to "off" to ship no config content at all.
+// Override the whole block with TRANTOR_OC_COMPACTION=<json>, or set it to "off" to ship no
+// config content at all.
 export const OC_COMPACTION_DEFAULT = {
   auto: true,
   prune: true,
   tail_turns: 4,
   preserve_recent_tokens: 24_000,
-  reserved: 64_000,
+  reserved: OC_RESERVED_FLOOR,
 };
 
+// reservedForContext(window) — the buffer that makes opencode compact near OC_COMPACT_AT, or
+// undefined when the window is unknown/invalid (the caller keeps the floor default).
+export function reservedForContext(window) {
+  if (!Number.isFinite(window) || window <= 0) return undefined;
+  return Math.max(OC_RESERVED_FLOOR, window - OC_COMPACT_AT);
+}
+
 /// A JSON string for OPENCODE_CONFIG_CONTENT, or "" when nothing should be injected: "off" opts
 /// out, invalid JSON opts out loudly at the caller (never arms a half-parsed block), custom JSON
-/// is wrapped as { compaction: <the value> } so the env stays one knob.
-export function ocCompactionContent(env = process.env) {
+/// is wrapped as { compaction: <the value> } so the env stays one knob. Given the model's catalog
+/// window the DEFAULT block's reserved is sized; a custom TRANTOR_OC_COMPACTION wins verbatim.
+export function ocCompactionContent(env = process.env, window = undefined) {
   const raw = String(env[OC_COMPACTION_ENV] || "").trim();
   if (raw === "off") return "";
-  if (!raw) return JSON.stringify({ compaction: OC_COMPACTION_DEFAULT });
+  if (!raw) {
+    const reserved = reservedForContext(window) ?? OC_COMPACTION_DEFAULT.reserved;
+    return JSON.stringify({ compaction: { ...OC_COMPACTION_DEFAULT, reserved } });
+  }
   let parsed;
   try { parsed = JSON.parse(raw); } catch { return ""; }
   // SAFETY: the operator's raw JSON arrives here untyped — a bare number, string or null must
@@ -32,3 +48,10 @@ export function ocCompactionContent(env = process.env) {
   if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return "";
   return JSON.stringify({ compaction: parsed });
 }
+
+// The one per-turn runner line: what the injected block will actually do for this seat.
+export function ocCompactionLogLine(window = undefined) {
+  const reserved = reservedForContext(window);
+  if (reserved === undefined) return `compaction: reserved=${OC_RESERVED_FLOOR} (floor — model window unknown)`;
+  return `compaction: reserved=${reserved} — auto-compact fires near ${OC_COMPACT_AT} tokens (window ${window} − reserved; opencode has no absolute-threshold knob)`;
+}

package/mcp.mjs

@@ -4,12 +4,10 @@
 // via the agent's MCP config. Identity + hub URL come from env (RELAY_SESSION, RELAY_URL).
 // Loading this server AUTO-REGISTERS the session — so presence works on every agent.
 import { writeFileSync, readFileSync, existsSync, mkdirSync } from "node:fs";
-import { join, basename, dirname } from "node:path";
+import { join, basename } from "node:path";
 import { homedir, hostname } from "node:os";
 import { execSync, spawnSync } from "node:child_process";
 import { randomUUID } from "node:crypto";
-import { createRequire } from "node:module";
-import { fileURLToPath, pathToFileURL } from "node:url";
 import { advise, loadWorld } from "./bin/advise.mjs";
 import { loadSeatRecord } from "./lib/seat-record.mjs";
 import { resolveProject, hostId, resolveHubInfo, nonSeatReason, handoffDir, orchWriterSid } from "./lib/project.mjs";
@@ -20,43 +18,7 @@ import { assertNoSecrets } from "./lib/scrub.mjs";
 import { isMessageCardTitle, OPEN_CARD_STATUSES } from "./lib/turn-policy.mjs";
 import { markDoing, hollowVerdict, blastRadius, blastLine } from "./hooks/lib/hollow-move.mjs";
 
-// Runtime dep resolution: `claude plugin install` snapshots the repo, not an npm tarball, so a
-// GitHub-sourced plugin ships no node_modules and a static SDK import dies with
-// ERR_MODULE_NOT_FOUND before any line runs — silently: every relay tool just disappears.
-// Resolve ourselves: plain import(spec) first; on NOT_FOUND borrow the global trantor's tree.
-const HERE = dirname(fileURLToPath(import.meta.url));
-const req = createRequire(import.meta.url);
-
-let fallbackRoots = null;
-function borrowRoots() {
-  if (fallbackRoots) return fallbackRoots;
-  const roots = [];
-  const add = (p) => { if (p && !roots.includes(p)) roots.push(p); };
-  // Cheap guesses first — every one of these is a string join, no process spawn.
-  if (process.env.npm_config_prefix) add(join(process.env.npm_config_prefix, "lib", "node_modules"));
-  add(join(dirname(process.execPath), "..", "lib", "node_modules"));   // homebrew, nvm, volta, asdf
-  // Only shell out if the guesses missed — `npm root -g` costs ~0.5s of MCP startup.
-  if (!roots.some((r) => existsSync(join(r, "trantor")))) {
-    try { add(execSync("npm root -g", { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim()); } catch {}
-  }
-  fallbackRoots = roots.flatMap((r) => [join(r, "trantor"), r]);
-  return fallbackRoots;
-}
-
-async function dep(spec) {
-  try {
-    return await import(spec);
-  } catch (err) {
-    if (err?.code !== "ERR_MODULE_NOT_FOUND" && err?.code !== "ERR_PACKAGE_PATH_NOT_EXPORTED") throw err;
-  }
-  for (const path of [HERE, ...borrowRoots()]) {
-    try { return await import(pathToFileURL(req.resolve(spec, { paths: [path] })).href); } catch {}
-  }
-  throw new Error(
-    `[trantor-mcp] cannot resolve '${spec}'. This plugin snapshot has no node_modules and no global ` +
-    `trantor install was found to borrow from. Fix: npm i -g trantor  (or: cd ${HERE} && npm install --omit=dev)`,
-  );
-}
+import { dep } from "./lib/dep.mjs";
 
 const { McpServer } = await dep("@modelcontextprotocol/sdk/server/mcp.js");
 const { StdioServerTransport } = await dep("@modelcontextprotocol/sdk/server/stdio.js");

package/package.json

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