trantor 0.18.65 → 0.18.67

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "trantor",
-  "version": "0.18.65",
+  "version": "0.18.67",
   "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

@@ -1014,14 +1014,32 @@ async function loadLessons() {
 // #5683: every prompt section is capped (bin/crew-payload.mjs) and the payload has ONE hard total
 // cap; below the caps the composition is byte-identical to the old concatenation.
 function composedTurn({ base = "", wakeText = "", ctxText = "", againText = "", tailText = "", rulesText = "", lessons = null }) {
+  // STABLE FIRST, VOLATILE LAST — this order is a COST decision, not a stylistic one (#8199).
+  // Every provider we send this to caches on an exact prefix match from token 0: DeepSeek's docs say
+  // "only requests with identical prefixes (starting from the 0th token) will be considered
+  // duplicates, and partial matches in the middle of the input will not trigger a cache hit", and a
+  // hit bills at roughly a tenth of a miss. This array used to open with `base` and then the
+  // per-turn WAKE, with the big unchanging blocks (RULES, lessons) buried at the end. On an ordinary
+  // turn `base` is empty — the sha rides inside `again` — so token 0 was the wake text itself, which
+  // is different every turn by definition. No cache could ever hit, and ~4,800 tokens of identical preamble were re-bought at full rate per turn,
+  // on every foreign-CLI seat: dsh, codex, kimi and every opencode/BYOM seat. The state path had
+  // known this for weeks — lib/state/assemble.mjs: "the bytes before STATE_DELIM are the caller's
+  // preamble and NOTHING else, or prefix caching never engages" — and it was never carried across.
+  //
+  // Reading order improves with it rather than suffering: rules and lessons are the standing brief,
+  // then context and history, and the ASK lands last, which is what #7063 found a work order wants.
+  //
+  // The `order` field is UNRELATED to this and deliberately unchanged: it ranks what gets trimmed
+  // when the payload busts its total cap, and wake is trimmed last there because losing the
+  // instruction is worse than losing the cache on that one turn.
   const built = composePrompt([
-    { name: "base", text: base },
-    { name: "wake", text: wakeText, trim: "truncate", order: 4 },
-    { name: "ctx", text: ctxText, trim: "drop", order: 1 },
-    { name: "again", text: againText },
-    { name: "tail", text: tailText },
     { name: "rules", text: rulesText, trim: "drop", order: 3 },
     { name: "lessons", text: lessons?.text || "", trim: "drop", order: 2 },
+    { name: "ctx", text: ctxText, trim: "drop", order: 1 },
+    { name: "tail", text: tailText },
+    { name: "again", text: againText },
+    { name: "base", text: base },
+    { name: "wake", text: wakeText, trim: "truncate", order: 4 },
   ]);
   const parts = built.sections.filter(s => s.chars).map(s => `${s.name} ${s.chars.toLocaleString("en-US")}c`).join(" · ");
   const lessonsNote = lessons && lessons.total ? ` (lessons ${lessons.kept}/${lessons.total})` : "";

package/hooks/lib/handoff.mjs

@@ -751,33 +751,23 @@ export function maybeSpawn(projectDir, conf = readConfig(), handoffFile = "", de
   try {
     if (_platform !== "darwin") return false;
     if (_env.TRANTOR_NO_HANDOFF_SPAWN === "1") return false;
-    // #8089: a pane session gets NO Terminal window — but it does get a successor. This used to
-    // return false on the theory that "the pane claims the handoff (trantor open) on its own",
-    // and for an ARMED baton nothing was driving that: /trantor:handoff always runs inside a turn,
-    // so it always arms, so this is always the path taken — and spawnPaneBaton, which the direct
-    // path (spawnBaton) calls right here, was never reached. The record was written and the session
-    // sat there. Witnessed on crebral-health 2026-09-19: written 00:18:58, unclaimed, original alive.
-    const paneId = _pane(_env);
-    if (paneId) {
-      if (!handoffFile) {
-        _log(`[trantor] pane ${paneId} needs the handoff file to pass the baton and none was given — no successor opened\n`);
-        return false;
-      }
-      const ok = _spawnPane(projectDir, handoffFile, paneId);
-      _log(`[trantor] herdr pane ${paneId}: ${ok ? "baton driver spawned — it replaces this pane in place" : "baton driver FAILED to spawn — no successor"}\n`);
-      return ok;
+    // #8089 REVERTED 2026-09-19, and the revert is the point. A pane session gets NO Terminal
+    // window AND no baton driver from here: the APP owns the replacement. app handoff_now runs
+    // `trantor handoff --write-only`, waits for the record (including the armed-mid-turn case it
+    // explicitly handles), then does its OWN idle gate, kill and reopen (#6081, #5509). Making this
+    // spawn a pane baton put a SECOND driver on the same pane, racing the app's — which broke the
+    // chat handoff button and the skill, both of which had been working. The stranding this was
+    // meant to fix is real but lives in the SKILL path, where no app driver exists; fixing it here
+    // cannot tell the two flows apart, so it must be fixed where the flows are distinguishable.
+    if (_pane(_env)) {
+      _log(`[trantor] session lives in herdr pane ${_pane(_env)} — no Terminal window and no baton driver from here; the app (or the skill path) owns the replacement\n`);
+      return false;
     }
     if (conf.autoHandoffPrompt === false) return false;
     if (_hasPane(basename(projectDir))) {
-      // Same correction as above for the cwd-keyed pane: drive the replacement, do not assume
-      // something else will. Without HERDR_PANE_ID the driver resolves the pane from crew-windows.
-      if (!handoffFile) {
-        _log(`[trantor] orch pane hosts ${basename(projectDir)} but no handoff file was given — no successor opened\n`);
-        return false;
-      }
-      const ok = _spawnPane(projectDir, handoffFile);
-      _log(`[trantor] orch pane hosts ${basename(projectDir)}: ${ok ? "baton driver spawned — it replaces the pane in place" : "baton driver FAILED to spawn — no successor"}\n`);
-      return ok;
+      _log(`[trantor] orch pane hosts ${basename(projectDir)} — no Terminal window; the app or the skill path claims the handoff
+`);
+      return false;
     }
     const script = join(HERE, "..", "..", "bin", "handoff-prompt.sh");
     if (!existsSync(script)) { _log(`[trantor] handoff-prompt.sh missing\n`); return false; }

package/package.json

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