@sjawhar/claude-envoy 1.12.0 → 1.13.0

package/.claude-plugin/plugin.json

@@ -2,5 +2,5 @@
   "name": "claude-envoy",
   "description": "Deliver Envoy events as Claude Code channel notifications and expose Envoy MCP tools.",
   "mcpServers": "./.mcp.json",
-  "version": "1.12.0"
+  "version": "1.13.0"
 }

package/.omp-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-envoy",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "description": "Deliver Envoy events as Claude Code channel notifications and expose Envoy MCP tools.",
   "mcpServers": {}
 }

package/dist/dispatch.js

@@ -17565,9 +17565,12 @@ async function tryExec(exec, file, args, cwd, limitMs) {
       exec(file, args, { cwd, signal: controller.signal }),
       expired.promise
     ]);
-    return answer?.stdout ?? null;
+    if (answer === null) {
+      return { failure: "timedOut", ok: false };
+    }
+    return { ok: true, stdout: answer.stdout };
   } catch {
-    return null;
+    return { failure: "refused", ok: false };
   } finally {
     clearTimeout(timer);
   }
@@ -17608,13 +17611,13 @@ function parseGitHubRemoteUrl(url) {
   return null;
 }
 async function resolveCwdRepo(cwd, exec) {
-  const jjOutput = await tryExec(exec, "jj", ["git", "remote", "list"], cwd, REMOTE_LOOKUP_MS);
-  if (jjOutput !== null) {
-    const url = selectRemoteUrl(parseRemoteList(jjOutput));
+  const remoteList = await tryExec(exec, "jj", ["git", "remote", "list"], cwd, REMOTE_LOOKUP_MS);
+  if (remoteList.ok) {
+    const url = selectRemoteUrl(parseRemoteList(remoteList.stdout));
     return url ? parseGitHubRemoteUrl(url) : null;
   }
-  const originUrl = await tryExec(exec, "git", ["remote", "get-url", "origin"], cwd, REMOTE_LOOKUP_MS);
-  return originUrl ? parseGitHubRemoteUrl(originUrl) : null;
+  const originRemote = await tryExec(exec, "git", ["remote", "get-url", "origin"], cwd, REMOTE_LOOKUP_MS);
+  return originRemote.ok ? parseGitHubRemoteUrl(originRemote.stdout) : null;
 }
 async function resolveOrigin(env, exec, cwd) {
   const origin = {
@@ -17623,8 +17626,8 @@ async function resolveOrigin(env, exec, cwd) {
   };
   const pane = env.TMUX_PANE;
   if (pane) {
-    const output = await tryExec(exec, "tmux", ["display-message", "-p", "-t", pane, "#S:#I.#P #{pane_id}"], cwd, TMUX_PANE_LOOKUP_MS);
-    const [target, paneId] = output?.trim().split(" ") ?? [];
+    const answer = await tryExec(exec, "tmux", ["display-message", "-p", "-t", pane, "#S:#I.#P #{pane_id}"], cwd, TMUX_PANE_LOOKUP_MS);
+    const [target, paneId] = answer.ok ? answer.stdout.trim().split(" ") : [];
     if (target)
       origin.tmux = target;
     if (paneId)
@@ -27532,6 +27535,7 @@ function dispatchTarget(env, config) {
 var DEFAULT_ENVOY_URL = "http://127.0.0.1:9020";
 var DEFAULT_HEARTBEAT_MS = SESSION_HEARTBEAT_MS;
 var MIN_PASS_DEADLINE_MS = 30000;
+var DEFAULT_TMUX_PLACE_CACHE_MS = 30000;
 var MIN_INTERVAL_MS = 25;
 var MAX_INTERVAL_MS = 2147483647;
 var REGISTRATION_SETTLE_MS = 5000;
@@ -27545,6 +27549,10 @@ function namedInterval(raw) {
   const parsed = Number(raw);
   return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;
 }
+function resolvedInterval(raw, fallback) {
+  const named = namedInterval(raw);
+  return named === undefined ? fallback : Math.min(Math.max(named, MIN_INTERVAL_MS), MAX_INTERVAL_MS);
+}
 function natsSeedFromEnvironment(env) {
   const { NATS_NKEY_SEED_FILE: file, NATS_NKEY_SEED: plain } = env;
   if (file !== undefined) {
@@ -27635,8 +27643,8 @@ function envoySettings(env, config, options = {}) {
       inbound = { off: messageFor(error) };
     }
   }
-  const namedHeartbeatMs = namedInterval(env.ENVOY_HEARTBEAT_MS);
-  const heartbeatMs = namedHeartbeatMs === undefined ? DEFAULT_HEARTBEAT_MS : Math.min(Math.max(namedHeartbeatMs, MIN_INTERVAL_MS), MAX_INTERVAL_MS);
+  const heartbeatMs = resolvedInterval(env.ENVOY_HEARTBEAT_MS, DEFAULT_HEARTBEAT_MS);
+  const tmuxPlaceCacheMs = resolvedInterval(env.ENVOY_TMUX_PLACE_CACHE_MS, DEFAULT_TMUX_PLACE_CACHE_MS);
   const namedPassDeadlineMs = namedInterval(env.ENVOY_PASS_DEADLINE_MS);
   return {
     enabled: true,
@@ -27644,6 +27652,7 @@ function envoySettings(env, config, options = {}) {
     credential,
     inbound,
     heartbeatMs,
+    tmuxPlaceCacheMs,
     passDeadlineMs: Math.min(Math.max(namedPassDeadlineMs ?? MIN_PASS_DEADLINE_MS, heartbeatMs), MAX_INTERVAL_MS),
     passDeadlineRaisedFrom: namedPassDeadlineMs !== undefined && namedPassDeadlineMs < heartbeatMs ? namedPassDeadlineMs : undefined
   };
@@ -28063,6 +28072,7 @@ function createEnvoyClient(config) {
       ...input.delivery === undefined ? {} : { delivery: input.delivery },
       ...input.clientInstanceID === undefined ? {} : { client_instance_id: input.clientInstanceID },
       host: machineID(),
+      ...input.place === undefined ? {} : { tmux_place: input.place },
       plugin: input.plugin.name,
       plugin_version: input.plugin.version
     }, { actingSession: input.sessionID }))),

package/dist/envoy-channel.js

@@ -44626,6 +44626,7 @@ function fileBearer(bearer, url, section, env, commands = "run") {
 var DEFAULT_ENVOY_URL = "http://127.0.0.1:9020";
 var DEFAULT_HEARTBEAT_MS = SESSION_HEARTBEAT_MS;
 var MIN_PASS_DEADLINE_MS = 30000;
+var DEFAULT_TMUX_PLACE_CACHE_MS = 30000;
 var MIN_INTERVAL_MS = 25;
 var MAX_INTERVAL_MS = 2147483647;
 var REGISTRATION_SETTLE_MS = 5000;
@@ -44639,6 +44640,10 @@ function namedInterval(raw) {
   const parsed = Number(raw);
   return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;
 }
+function resolvedInterval(raw, fallback) {
+  const named = namedInterval(raw);
+  return named === undefined ? fallback : Math.min(Math.max(named, MIN_INTERVAL_MS), MAX_INTERVAL_MS);
+}
 function natsSeedFromEnvironment(env) {
   const { NATS_NKEY_SEED_FILE: file, NATS_NKEY_SEED: plain } = env;
   if (file !== undefined) {
@@ -44729,8 +44734,8 @@ function envoySettings(env, config, options = {}) {
       inbound = { off: messageFor(error) };
     }
   }
-  const namedHeartbeatMs = namedInterval(env.ENVOY_HEARTBEAT_MS);
-  const heartbeatMs = namedHeartbeatMs === undefined ? DEFAULT_HEARTBEAT_MS : Math.min(Math.max(namedHeartbeatMs, MIN_INTERVAL_MS), MAX_INTERVAL_MS);
+  const heartbeatMs = resolvedInterval(env.ENVOY_HEARTBEAT_MS, DEFAULT_HEARTBEAT_MS);
+  const tmuxPlaceCacheMs = resolvedInterval(env.ENVOY_TMUX_PLACE_CACHE_MS, DEFAULT_TMUX_PLACE_CACHE_MS);
   const namedPassDeadlineMs = namedInterval(env.ENVOY_PASS_DEADLINE_MS);
   return {
     enabled: true,
@@ -44738,6 +44743,7 @@ function envoySettings(env, config, options = {}) {
     credential,
     inbound,
     heartbeatMs,
+    tmuxPlaceCacheMs,
     passDeadlineMs: Math.min(Math.max(namedPassDeadlineMs ?? MIN_PASS_DEADLINE_MS, heartbeatMs), MAX_INTERVAL_MS),
     passDeadlineRaisedFrom: namedPassDeadlineMs !== undefined && namedPassDeadlineMs < heartbeatMs ? namedPassDeadlineMs : undefined
   };
@@ -45064,6 +45070,7 @@ function createEnvoyClient(config) {
       ...input.delivery === undefined ? {} : { delivery: input.delivery },
       ...input.clientInstanceID === undefined ? {} : { client_instance_id: input.clientInstanceID },
       host: machineID(),
+      ...input.place === undefined ? {} : { tmux_place: input.place },
       plugin: input.plugin.name,
       plugin_version: input.plugin.version
     }, { actingSession: input.sessionID }))),
@@ -46869,9 +46876,12 @@ async function tryExec(exec, file, args, cwd, limitMs) {
       exec(file, args, { cwd, signal: controller.signal }),
       expired.promise
     ]);
-    return answer?.stdout ?? null;
+    if (answer === null) {
+      return { failure: "timedOut", ok: false };
+    }
+    return { ok: true, stdout: answer.stdout };
   } catch {
-    return null;
+    return { failure: "refused", ok: false };
   } finally {
     clearTimeout(timer);
   }
@@ -46912,13 +46922,13 @@ function parseGitHubRemoteUrl(url) {
   return null;
 }
 async function resolveCwdRepo(cwd, exec) {
-  const jjOutput = await tryExec(exec, "jj", ["git", "remote", "list"], cwd, REMOTE_LOOKUP_MS);
-  if (jjOutput !== null) {
-    const url = selectRemoteUrl(parseRemoteList(jjOutput));
+  const remoteList = await tryExec(exec, "jj", ["git", "remote", "list"], cwd, REMOTE_LOOKUP_MS);
+  if (remoteList.ok) {
+    const url = selectRemoteUrl(parseRemoteList(remoteList.stdout));
     return url ? parseGitHubRemoteUrl(url) : null;
   }
-  const originUrl = await tryExec(exec, "git", ["remote", "get-url", "origin"], cwd, REMOTE_LOOKUP_MS);
-  return originUrl ? parseGitHubRemoteUrl(originUrl) : null;
+  const originRemote = await tryExec(exec, "git", ["remote", "get-url", "origin"], cwd, REMOTE_LOOKUP_MS);
+  return originRemote.ok ? parseGitHubRemoteUrl(originRemote.stdout) : null;
 }
 async function resolveOrigin(env, exec, cwd) {
   const origin = {
@@ -46927,8 +46937,8 @@ async function resolveOrigin(env, exec, cwd) {
   };
   const pane = env.TMUX_PANE;
   if (pane) {
-    const output = await tryExec(exec, "tmux", ["display-message", "-p", "-t", pane, "#S:#I.#P #{pane_id}"], cwd, TMUX_PANE_LOOKUP_MS);
-    const [target, paneId] = output?.trim().split(" ") ?? [];
+    const answer = await tryExec(exec, "tmux", ["display-message", "-p", "-t", pane, "#S:#I.#P #{pane_id}"], cwd, TMUX_PANE_LOOKUP_MS);
+    const [target, paneId] = answer.ok ? answer.stdout.trim().split(" ") : [];
     if (target)
       origin.tmux = target;
     if (paneId)
@@ -55145,7 +55155,7 @@ var import_nats2 = __toESM(require_mod4(), 1);
 
 // package.json
 var name = "@sjawhar/claude-envoy";
-var version2 = "1.12.0";
+var version2 = "1.13.0";
 var legion = {
   daemonApiVersion: 55
 };
@@ -57218,9 +57228,63 @@ function replayStateWriter(file, restored) {
 }
 
 // src/session-title.ts
+import { basename as basename4 } from "path";
+
+// ../envoy-client/src/process-ancestry.ts
 import { execFileSync } from "child_process";
 import { readFileSync as readFileSync9 } from "fs";
-import { basename as basename4 } from "path";
+var MAX_ANCESTORS = 64;
+var PARENT_LOOKUP_MS = 1000;
+function procParentPid(pid) {
+  try {
+    const stat = readFileSync9(`/proc/${pid}/stat`, "utf8");
+    const parent = Number(stat.slice(stat.lastIndexOf(")") + 2).split(" ")[1]);
+    return Number.isInteger(parent) ? parent : undefined;
+  } catch {
+    return;
+  }
+}
+function processTable() {
+  const table = new Map;
+  try {
+    const listing = execFileSync("ps", ["-Ao", "pid=,ppid="], {
+      encoding: "utf8",
+      killSignal: "SIGKILL",
+      timeout: PARENT_LOOKUP_MS
+    });
+    for (const line of listing.split(`
+`)) {
+      const [, pid = "", parent = ""] = line.match(/^\s*(\d+)\s+(\d+)\s*$/) ?? [];
+      if (pid !== "")
+        table.set(Number(pid), Number(parent));
+    }
+  } catch {}
+  return table;
+}
+function isAncestor(candidate, pid = process.pid) {
+  let table;
+  const parentPid = (child) => {
+    if (process.platform === "linux")
+      return procParentPid(child);
+    table ??= processTable();
+    return table.get(child);
+  };
+  let current = pid;
+  for (let step = 0;current !== undefined && current > 1 && step < MAX_ANCESTORS; step++) {
+    if (String(current) === candidate)
+      return true;
+    current = parentPid(current);
+  }
+  return false;
+}
+
+// ../envoy-client/src/tmux-server.ts
+function tmuxServer(value) {
+  const parts = (value ?? "").split(",");
+  return { serverPid: parts.at(-2) ?? "", socket: parts.slice(0, -2).join(",") };
+}
+
+// src/session-title.ts
 var TMUX_PANE_FORMAT = [
   "#{session_name}",
   "#{window_name}",
@@ -57231,7 +57295,6 @@ var TMUX_PANE_FORMAT = [
 ].join("\t");
 var TMUX_TIMEOUT_MS = 1000;
 var SHORT_ID_LENGTH = 8;
-var MAX_ANCESTORS = 64;
 var CSI_SEQUENCE = new RegExp(`${String.fromCharCode(27)}\\[[0-?]*[ -/]*[@-~]`, "gu");
 function oneLine(value) {
   return value.replace(CSI_SEQUENCE, "").replace(/[\u202a-\u202e\u2066-\u2069]/gu, "").replace(/[\s\p{Cc}]+/gu, " ").trim();
@@ -57239,32 +57302,6 @@ function oneLine(value) {
 function visible(value) {
   return value.replace(/[\s\p{Cc}\p{Cf}\p{Cs}\p{Cn}\p{M}\p{Default_Ignorable_Code_Point}\u2800]/gu, "") !== "";
 }
-function parentPid(pid) {
-  try {
-    if (process.platform === "linux") {
-      const stat = readFileSync9(`/proc/${pid}/stat`, "utf8");
-      const parent = Number(stat.slice(stat.lastIndexOf(")") + 2).split(" ")[1]);
-      return Number.isInteger(parent) ? parent : undefined;
-    }
-    const parent = Number(execFileSync("ps", ["-o", "ppid=", "-p", String(pid)], {
-      encoding: "utf8",
-      timeout: TMUX_TIMEOUT_MS,
-      killSignal: "SIGKILL"
-    }).trim());
-    return Number.isInteger(parent) ? parent : undefined;
-  } catch {
-    return;
-  }
-}
-function isAncestor(candidate, pid = process.pid) {
-  let current = pid;
-  for (let step = 0;current !== undefined && current > 1 && step < MAX_ANCESTORS; step++) {
-    if (String(current) === candidate)
-      return true;
-    current = parentPid(current);
-  }
-  return false;
-}
 async function queryTmux(socket, pane, format) {
   let child;
   try {
@@ -57328,9 +57365,7 @@ async function sessionTitle(environment, directory, sources = {}) {
   const explicit = oneLine(configuredValue(environment.ENVOY_SESSION_TITLE) ?? "");
   if (visible(explicit))
     return () => explicit;
-  const parts = configuredValue(environment.TMUX)?.split(",") ?? [];
-  const socket = parts.slice(0, -2).join(",");
-  const serverPid = parts.at(-2) ?? "";
+  const { serverPid, socket } = tmuxServer(configuredValue(environment.TMUX));
   const pane = configuredValue(environment.TMUX_PANE)?.trim();
   const directoryName = oneLine(basename4(directory) || directory);
   const name = (socket === "" || serverPid === "" || pane === undefined ? undefined : await tmuxPaneTitle(socket, serverPid, pane, ownPane, query)) ?? (visible(directoryName) ? directoryName : "session");

package/dist/session-hook.js

@@ -16569,9 +16569,12 @@ async function tryExec(exec, file, args, cwd, limitMs) {
       exec(file, args, { cwd, signal: controller.signal }),
       expired.promise
     ]);
-    return answer?.stdout ?? null;
+    if (answer === null) {
+      return { failure: "timedOut", ok: false };
+    }
+    return { ok: true, stdout: answer.stdout };
   } catch {
-    return null;
+    return { failure: "refused", ok: false };
   } finally {
     clearTimeout(timer);
   }
@@ -16612,13 +16615,13 @@ function parseGitHubRemoteUrl(url) {
   return null;
 }
 async function resolveCwdRepo(cwd, exec) {
-  const jjOutput = await tryExec(exec, "jj", ["git", "remote", "list"], cwd, REMOTE_LOOKUP_MS);
-  if (jjOutput !== null) {
-    const url = selectRemoteUrl(parseRemoteList(jjOutput));
+  const remoteList = await tryExec(exec, "jj", ["git", "remote", "list"], cwd, REMOTE_LOOKUP_MS);
+  if (remoteList.ok) {
+    const url = selectRemoteUrl(parseRemoteList(remoteList.stdout));
     return url ? parseGitHubRemoteUrl(url) : null;
   }
-  const originUrl = await tryExec(exec, "git", ["remote", "get-url", "origin"], cwd, REMOTE_LOOKUP_MS);
-  return originUrl ? parseGitHubRemoteUrl(originUrl) : null;
+  const originRemote = await tryExec(exec, "git", ["remote", "get-url", "origin"], cwd, REMOTE_LOOKUP_MS);
+  return originRemote.ok ? parseGitHubRemoteUrl(originRemote.stdout) : null;
 }
 async function resolveOrigin(env, exec, cwd) {
   const origin = {
@@ -16627,8 +16630,8 @@ async function resolveOrigin(env, exec, cwd) {
   };
   const pane = env.TMUX_PANE;
   if (pane) {
-    const output = await tryExec(exec, "tmux", ["display-message", "-p", "-t", pane, "#S:#I.#P #{pane_id}"], cwd, TMUX_PANE_LOOKUP_MS);
-    const [target, paneId] = output?.trim().split(" ") ?? [];
+    const answer = await tryExec(exec, "tmux", ["display-message", "-p", "-t", pane, "#S:#I.#P #{pane_id}"], cwd, TMUX_PANE_LOOKUP_MS);
+    const [target, paneId] = answer.ok ? answer.stdout.trim().split(" ") : [];
     if (target)
       origin.tmux = target;
     if (paneId)
@@ -26411,6 +26414,7 @@ function dispatchTarget(env, config) {
 var DEFAULT_ENVOY_URL = "http://127.0.0.1:9020";
 var DEFAULT_HEARTBEAT_MS = SESSION_HEARTBEAT_MS;
 var MIN_PASS_DEADLINE_MS = 30000;
+var DEFAULT_TMUX_PLACE_CACHE_MS = 30000;
 var MIN_INTERVAL_MS = 25;
 var MAX_INTERVAL_MS = 2147483647;
 var REGISTRATION_SETTLE_MS = 5000;
@@ -26424,6 +26428,10 @@ function namedInterval(raw) {
   const parsed = Number(raw);
   return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;
 }
+function resolvedInterval(raw, fallback) {
+  const named = namedInterval(raw);
+  return named === undefined ? fallback : Math.min(Math.max(named, MIN_INTERVAL_MS), MAX_INTERVAL_MS);
+}
 function natsSeedFromEnvironment(env) {
   const { NATS_NKEY_SEED_FILE: file, NATS_NKEY_SEED: plain } = env;
   if (file !== undefined) {
@@ -26514,8 +26522,8 @@ function envoySettings(env, config, options = {}) {
       inbound = { off: messageFor(error) };
     }
   }
-  const namedHeartbeatMs = namedInterval(env.ENVOY_HEARTBEAT_MS);
-  const heartbeatMs = namedHeartbeatMs === undefined ? DEFAULT_HEARTBEAT_MS : Math.min(Math.max(namedHeartbeatMs, MIN_INTERVAL_MS), MAX_INTERVAL_MS);
+  const heartbeatMs = resolvedInterval(env.ENVOY_HEARTBEAT_MS, DEFAULT_HEARTBEAT_MS);
+  const tmuxPlaceCacheMs = resolvedInterval(env.ENVOY_TMUX_PLACE_CACHE_MS, DEFAULT_TMUX_PLACE_CACHE_MS);
   const namedPassDeadlineMs = namedInterval(env.ENVOY_PASS_DEADLINE_MS);
   return {
     enabled: true,
@@ -26523,6 +26531,7 @@ function envoySettings(env, config, options = {}) {
     credential,
     inbound,
     heartbeatMs,
+    tmuxPlaceCacheMs,
     passDeadlineMs: Math.min(Math.max(namedPassDeadlineMs ?? MIN_PASS_DEADLINE_MS, heartbeatMs), MAX_INTERVAL_MS),
     passDeadlineRaisedFrom: namedPassDeadlineMs !== undefined && namedPassDeadlineMs < heartbeatMs ? namedPassDeadlineMs : undefined
   };

package/legion/skills/legion-worker/references/merge-gate.md

@@ -55,13 +55,17 @@ other change to the head voids it.
   (`gh api repos/<o>/<r>/commits/<headRefOid>/check-runs --paginate --jq '.check_runs[] | [.name, .status, .conclusion] | @tsv'`):
   every required name present, `completed` and `success` (GitHub counts `neutral` and `skipped`
   as passing for a required check). A required check
-  `queued` or `in_progress`: wait. One `completed` as `cancelled`, or absent: re-run that run's
+  `queued` or `in_progress`: wait. One `completed` as `cancelled`, or absent: on a `pull_request`
+  run, re-run that run's
   failed and cancelled jobs, once, then wait — never the whole run, which runs again every job that
-  succeeded too. Find the run and job at the head: the head's runs
+  succeeded too. A merge-group run is never re-run: the implementer finishes its round instead,
+  and the pull request is tested again when it is queued again.
+  Find the run and job at the head: the head's runs
   (`gh api 'repos/<o>/<r>/actions/runs?head_sha=<headRefOid>&per_page=100' --jq '.workflow_runs[] | [.id, .name, .event, .status, .conclusion] | @tsv'`),
   then each candidate run's jobs
   (`gh api repos/<o>/<r>/actions/runs/<run-id>/jobs --jq '.jobs[] | [.id, .name, .status, .conclusion] | @tsv'`).
-  A cancelled job: `gh run rerun <run-id> --failed`, which GitHub applies to the run's failed and
+  A cancelled job of a pull-request run: `gh run rerun <run-id> --failed`, which GitHub applies to
+  the run's failed and
   cancelled jobs and the jobs that depend on them, and to nothing that succeeded. Never
   `--job <job-id>` alone: under a routing workflow, re-running only the final job reads the
   cancelled results again and stays red. GitHub refuses a re-run while an attempt of that run is

package/legion/skills/legion-worker/references/pr-body.md

@@ -54,11 +54,11 @@ gives them).
 Under the Go daemon a check or workflow the base branch requires that settles red on the head,
 before the completion or after it, sends the work back to `implementing` with the failing checks
 named, until `max_fix_attempts` is spent, when the architect decides. The one CI result an implementer waits for is a re-run: when its task names a red that
-failed on its own, it re-runs the failed jobs once (`gh run rerun <run-id> --failed`) and completes once
+failed on its own in a `pull_request` run, it re-runs the failed jobs once (`gh run rerun <run-id> --failed`) and completes once
 the re-run settles green, woken by the pull request's checks event (`skill://envoy`, *Wait for
-CI or a merge*: subscribe, then end the turn), never by a sleep loop. A completion while that red
-still stands is sent back, at once for a required check and at the daemon's next read of the runs
-(within two minutes) for a required workflow.
+CI or a merge*: subscribe, then end the turn), never by a sleep loop.
+A merge-group run is never re-run: the implementer finishes its round instead, and the pull request is tested again when it is queued again.
+A completion while that red still stands is sent back, at once for a required check and at the daemon's next read of the runs (within two minutes) for a required workflow.
 
 A pull-request body edit re-runs a check that judges the body at once, on the head as it is. While
 the pull request conflicts with its base (GitHub shows it `CONFLICTING`), no workflow triggered

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sjawhar/claude-envoy",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "license": "Apache-2.0",
   "description": "Claude Code channel plugin for Legion's Envoy bus",
   "type": "module",

package/src/session-title.ts

@@ -1,6 +1,6 @@
-import { execFileSync } from "node:child_process"
-import { readFileSync } from "node:fs"
 import { basename } from "node:path"
+import { isAncestor } from "@legion/envoy-client/process-ancestry"
+import { tmuxServer } from "@legion/envoy-client/tmux-server"
 import { configuredValue } from "./claude-session"
 
 export interface SessionTitleEnvironment {
@@ -48,9 +48,6 @@ const TMUX_PANE_FORMAT = [
 const TMUX_TIMEOUT_MS = 1_000
 const SHORT_ID_LENGTH = 8
 
-/** How many parents `isAncestor` follows before it stops. */
-const MAX_ANCESTORS = 64
-
 /** A terminal control sequence (a colour code: ESC [ parameters final byte). Built from the ESC
  *  code, since a control character in a regular expression literal is a lint error. */
 const CSI_SEQUENCE = new RegExp(`${String.fromCharCode(0x1b)}\\[[0-?]*[ -/]*[@-~]`, "gu")
@@ -80,39 +77,6 @@ function visible(value: string): boolean {
   )
 }
 
-/** The parent of process `pid`, or undefined when it cannot be read. */
-function parentPid(pid: number): number | undefined {
-  try {
-    if (process.platform === "linux") {
-      // The command name, in parentheses, may hold spaces; the parent is the second field after it.
-      const stat = readFileSync(`/proc/${pid}/stat`, "utf8")
-      const parent = Number(stat.slice(stat.lastIndexOf(")") + 2).split(" ")[1])
-      return Number.isInteger(parent) ? parent : undefined
-    }
-    const parent = Number(
-      execFileSync("ps", ["-o", "ppid=", "-p", String(pid)], {
-        encoding: "utf8",
-        timeout: TMUX_TIMEOUT_MS,
-        killSignal: "SIGKILL",
-      }).trim(),
-    )
-    return Number.isInteger(parent) ? parent : undefined
-  } catch {
-    return undefined
-  }
-}
-
-/** Whether process `candidate` is `pid` or one of its ancestors, walking up from `pid` and
- *  stopping at the first match, at init, or after `MAX_ANCESTORS` steps. */
-export function isAncestor(candidate: string, pid: number = process.pid): boolean {
-  let current: number | undefined = pid
-  for (let step = 0; current !== undefined && current > 1 && step < MAX_ANCESTORS; step++) {
-    if (String(current) === candidate) return true
-    current = parentPid(current)
-  }
-  return false
-}
-
 /**
  * `tmux -u -S <socket> display-message -p -t <pane> <format>`; undefined when tmux is missing, slow
  * or refuses, or prints nothing: a running tmux server answers a pane it does not have with an
@@ -232,10 +196,7 @@ export async function sessionTitle(
   // A title with nothing that shows once cleaned (a zero-width space, a colour code alone) would
   // be a blank row.
   if (visible(explicit)) return () => explicit
-  // `TMUX` is `<socket>,<server pid>,<session>`, and a socket path may hold a comma.
-  const parts = configuredValue(environment.TMUX)?.split(",") ?? []
-  const socket = parts.slice(0, -2).join(",")
-  const serverPid = parts.at(-2) ?? ""
+  const { serverPid, socket } = tmuxServer(configuredValue(environment.TMUX))
   const pane = configuredValue(environment.TMUX_PANE)?.trim()
   // A directory name holds whatever the filesystem allows, newlines and overrides among them.
   const directoryName = oneLine(basename(directory) || directory)