trantor 0.17.27 → 0.17.29

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "trantor",
-  "version": "0.17.27",
+  "version": "0.17.29",
   "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/hooks/sessionstart.mjs

@@ -11,7 +11,7 @@ import { join, basename } from "node:path";
 import { homedir, hostname } from "node:os";
 import { execSync } from "node:child_process";
 import { resolveProject, hostId } from "../lib/project.mjs";
-import { updateAvailable, maybeNotifyDesktop } from "./lib/update-check.mjs";
+import { updateAvailable, maybeNotifyDesktop, readConfig } from "./lib/update-check.mjs";
 
 // Load the most recent UNCONSUMED handoff for this project (written by precompact.mjs
 // / the heartbeat early-warning). `claim` marks it consumed so exactly one session
@@ -93,6 +93,7 @@ function sanitize(s) {
 }
 
 let additionalContext = "";
+let userBanner = "";   // shown to the USER in-terminal via the hook's `systemMessage` (not model-only context)
 try {
   let source = "", stdinObj = {};
   try { stdinObj = JSON.parse((await readStdin()) || "{}"); source = stdinObj.source || ""; } catch {}
@@ -158,14 +159,23 @@ try {
     }
   } catch {}
 
-  // Update available? Like a desktop app's "an update is ready" — surface it two ways: a one-time
-  // native desktop notification (once per new version, not per session) AND an in-session context
-  // block so the running model can tell the user the exact update commands. Throttled + fail-silent;
-  // most starts do zero network (6h TTL cache). Disable: TRANTOR_NO_UPDATE_CHECK / _NOTIFY.
+  // Update available? Surface it the way a terminal tool should — an in-terminal `systemMessage`
+  // line the USER sees at session start (NOT a macOS desktop popup, which macOS misattributes to
+  // Script Editor and which fires off-screen). It shows every session while an update is pending and
+  // auto-clears the moment they update (updateAvailable() flips false) — a persistent-until-resolved
+  // reminder, like the built-in MCP-disconnected indicator. The model also gets the <trantor-update>
+  // context block so it can give the exact commands on request. Desktop notification is now OPT-IN
+  // (config.updateDesktopNotify:true) for anyone who genuinely wants the OS-level ping.
+  // Throttled + fail-silent; most starts do zero network (6h TTL cache). Disable: TRANTOR_NO_UPDATE_CHECK.
   try {
     const upd = await updateAvailable();
     if (upd.available) {
-      maybeNotifyDesktop(upd);
+      if (readConfig().updateDesktopNotify === true) maybeNotifyDesktop(upd);   // opt-in only
+      // Bold-orange ANSI so it's not lost in Claude Code's dim systemMessage styling; a leading
+      // 🟠 emoji anchor keeps it visibly colored even on a terminal that ignores the ANSI (so it
+      // can never silently fall back to low-contrast gray). \x1b[1;38;5;208m = bold orange, \x1b[0m resets.
+      const O = "\x1b[1;38;5;208m", R = "\x1b[0m";
+      userBanner = `🟠 ${O}Trantor update available: ${upd.installed} → ${upd.latest}${R}  ·  update with:  ${O}claude plugin update trantor@trantor${R}`;
       additionalContext += `<trantor-update installed="${sanitize(upd.installed)}" latest="${sanitize(upd.latest)}">\n`;
       additionalContext += `⬆️ **A newer Trantor is available — ${sanitize(upd.installed)} → ${sanitize(upd.latest)}.** Tell the user, and offer the update: \`claude plugin update trantor@trantor\` (plugin) + \`npm i -g trantor@${sanitize(upd.latest)}\` (CLI), then restart to apply.\n`;
       additionalContext += `</trantor-update>\n`;
@@ -195,13 +205,21 @@ try {
   process.stderr.write(`[trantor] sessionstart error: ${err?.message || err}\n`);
 }
 
-// Hook protocol: emit additionalContext via stdout JSON. Self-validate so we never
-// emit something Claude Code can't parse — fall back to sanitized, then to {}.
-function emit(ctx) {
-  const obj = ctx ? { hookSpecificOutput: { hookEventName: "SessionStart", additionalContext: ctx } } : {};
+// Hook protocol: emit additionalContext (model-facing) via stdout JSON, plus an optional
+// `systemMessage` (USER-facing — rendered as a line in the terminal, our update indicator).
+// Self-validate so we never emit something Claude Code can't parse — fall back to sanitized, then {}.
+function emit(ctx, sysMsg) {
+  const obj = {};
+  if (ctx) obj.hookSpecificOutput = { hookEventName: "SessionStart", additionalContext: ctx };
+  if (sysMsg) obj.systemMessage = sysMsg;
   const out = JSON.stringify(obj);
   try { JSON.parse(out); return out; } catch { /* fall through */ }
-  try { return JSON.stringify({ hookSpecificOutput: { hookEventName: "SessionStart", additionalContext: sanitize(ctx) } }); } catch { return "{}"; }
+  try {
+    const safe = {};
+    if (ctx) safe.hookSpecificOutput = { hookEventName: "SessionStart", additionalContext: sanitize(ctx) };
+    if (sysMsg) safe.systemMessage = sanitize(sysMsg);
+    return JSON.stringify(safe);
+  } catch { return "{}"; }
 }
-process.stdout.write(emit(additionalContext));
+process.stdout.write(emit(additionalContext, userBanner));
 process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trantor",
-  "version": "0.17.27",
+  "version": "0.17.29",
   "type": "module",
   "bin": {
     "trantor": "bin/cli.mjs"
@@ -12,7 +12,7 @@
   "scripts": {
     "test": "node test.mjs && node test-scenarios.mjs && node test-failure.mjs && node test-handoff.mjs && node test-update.mjs"
   },
-  "description": "The hub-world for AI agent crews \u2014 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).",
+  "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": [
     "hub.mjs",
     "mcp.mjs",