@sjawhar/claude-envoy 1.12.1 → 1.14.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.1"
+  "version": "1.14.0"
 }

package/.omp-plugin/plugin.json

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

package/dist/dispatch.js

@@ -14662,7 +14662,8 @@ var IssueEventPayloadSchema = object({
   route: string2().nullish(),
   changed: array(string2()).optional(),
   ancestors: array(string2()).optional(),
-  thread_logins: array(string2()).optional()
+  thread_logins: array(string2()).optional(),
+  forced: object({ past: array(string2()) }).optional()
 });
 var ArtifactCreatedEventPayloadSchema = object({
   artifact: object({ id: string2().optional(), slug: string2().optional(), name: string2().optional() }).optional()
@@ -15615,12 +15616,12 @@ var dispatchToolSpecs = [
   {
     name: "dispatch_related",
     example: { project: "CORE", title: "Retry failed webhook deliveries" },
-    description: "Run the related-item check that dispatch issue, dispatch ask and a new decision block in " + "dispatch doc-edit run on their own write, and write nothing: it lists the three items of " + "one project most like a title and a text (at most one per issue or document, open ones " + "first), each ask with whether it is answered, and a past decision that already answers " + "the same question. Use it to check a draft before filing it. It searches by meaning and by " + "the text's rarest words, and says how it searched; when meaning search cannot run it " + "searches by keywords only and says why. When it could not search at all it says why and " + "names the dispatch search to run instead. exclude_issue leaves that issue's own items out, " + "as a check on that issue's own write does; keywords_only skips meaning search.",
+    description: "Run the related-item check that dispatch issue, dispatch ask and a new decision block in " + "dispatch doc-edit run on their own write, and write nothing: it lists the three items of " + "one project most like a title and a text (at most one per issue or document, open ones " + "first), each ask with whether it is answered, and a past decision that already answers " + "the same question. Use it to check a draft before filing it. It searches by meaning and by " + "the text's rarest words, and says how it searched; when meaning search cannot run it " + "searches by keywords only and says why. When it could not search at all it says why and " + "names the dispatch search to run instead. exclude_issues leaves each named issue's own " + "items out of the results, at most 50 of them, so a draft under a parent can leave out " + "that parent and its children without changing how rare the text's words are; " + "keywords_only skips meaning search.",
     arguments: (z) => ({
       project: z.string().describe("Project key to search within, such as CORE."),
       title: z.string({ max: ISSUE_TITLE_MAX }).describe("Optional title to check, as an issue title; at most 1,000 characters.").optional(),
       text: z.string().describe("Optional text to check, such as a draft spec or a question.").optional(),
-      exclude_issue: z.string().describe("Optional issue key in the project whose own items are left out.").optional(),
+      exclude_issues: z.array(z.string()).describe("Optional issue keys in the project whose own items are left out of the results; at most 50.").optional(),
       keywords_only: z.boolean().describe("Search by keywords only, skipping meaning search.").optional()
     }),
     validation: {
@@ -17565,9 +17566,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 +17612,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 +17627,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)
@@ -20540,11 +20544,19 @@ function relatedCheckLines(suggestions, context) {
       lines.push(`A past decision may already answer this: ${suggestionLabel(decision)}, answered by ${decision.answered_by}${when} \u2192 ${absoluteHref(decision.href, context.configUrl)}`);
       lines.push(...askLines(decision.ask));
     }
+    const likely = suggestions.likely_duplicate;
+    if (likely !== undefined && likely !== null) {
+      lines.push(`Likely duplicate: ${likely.key} [${likely.status}] ${likely.title} \u2192 ${absoluteHref(likely.href, context.configUrl)}`);
+      lines.push("Read it. If it is the same work, fold this issue into it by the duplicate rule of skill://dispatch-first.");
+    }
+    if (suggestions.near_copy_check !== undefined && suggestions.near_copy_check !== "") {
+      lines.push(`No near-copy check was made: ${suggestions.near_copy_check}.`);
+    }
     for (const match of suggestions.title_matches ?? []) {
-      lines.push(`Title overlaps you forced past: ${match.key} [${match.status}] ${match.title} \u2192 ${absoluteHref(match.href, context.configUrl)}`);
+      lines.push(`Near copy you forced past: ${match.key} [${match.status}] ${match.title} \u2192 ${absoluteHref(match.href, context.configUrl)}`);
     }
   } catch (error) {
-    lines.push(`The check's past decision or title overlaps could not be shown: ${messageFor(error)}`);
+    lines.push(`The check's past decision or near copies could not be shown: ${messageFor(error)}`);
   }
   return lines;
 }
@@ -22427,7 +22439,13 @@ function eventHead(event) {
       return textHead(`${event.payload.name} v${event.payload.version.number}${event.payload.version.summary ? `: ${event.payload.version.summary}` : ""}`);
     case "artifact.human_edited":
       return textHead(humanEditHead(event.payload));
-    case "issue.created":
+    case "issue.created": {
+      const forced = event.payload.forced;
+      const head = `status ${event.payload.status}`;
+      if (forced === undefined)
+        return head;
+      return forced.past.length === 0 ? `${head} \xB7 forced, the near-copy check did not answer` : `${head} \xB7 forced past ${forced.past.join(", ")}`;
+    }
     case "issue.updated":
     case "issue.closed":
       return `status ${event.payload.status}`;
@@ -22443,10 +22461,14 @@ function eventRef(event) {
   const kind = event.type.startsWith("message.") ? "message" : event.type.startsWith("comment.") || event.type.startsWith("suggestion.") ? "comment" : event.type.startsWith("ask.") ? "ask" : undefined;
   return kind === undefined ? undefined : `dispatch://${event.issue_key}/${kind}/${id}`;
 }
+function eventActorText(actor) {
+  const title = actor.kind === "session" ? actor.origin?.session_title : undefined;
+  return title === undefined || title === "" ? actorText(actor) : `${actorText(actor)} (${title})`;
+}
 function eventLine(event) {
   const head = eventHead(event);
   const ref = eventRef(event);
-  return `- #${event.seq} ${event.type}${ref === undefined ? "" : ` ${ref}`} \xB7 ${actorText(event.actor)} \xB7 ${event.created_at}${head === undefined || head === "" ? "" : ` \xB7 ${head}`}`;
+  return `- #${event.seq} ${event.type}${ref === undefined ? "" : ` ${ref}`} \xB7 ${eventActorText(event.actor)} \xB7 ${event.created_at}${head === undefined || head === "" ? "" : ` \xB7 ${head}`}`;
 }
 function childrenSummary(issue) {
   return [
@@ -23263,15 +23285,17 @@ async function executeDispatchTool(input) {
         const candidates = duplicateCandidates(error);
         return {
           text: [
-            `Not created: "${title}" looks like a duplicate.`,
+            `Not created: "${title}" is a near copy of an open issue.`,
             ...candidates.map((candidate) => {
               const href = new URL(candidate.href, linkBase).toString();
               return `${candidate.key} [${candidate.status}] ${candidate.title} \u2192 ${href}`;
             }),
-            "Reference the existing issue, or run dispatch issue again with --force after reading it."
+            "Read each issue above. If one is the same work, fold this into it by the duplicate rule of skill://dispatch-first.",
+            "If none is, run dispatch issue again with --force, and write in the new issue's spec why it is not each issue named here."
           ].join(`
 `),
-          details: { duplicates: candidates }
+          details: { duplicates: candidates },
+          refused: true
         };
       }
     }
@@ -23439,12 +23463,12 @@ async function executeDispatchTool(input) {
       const project = stringArg(args, "project");
       const title = optionalString(args, "title");
       const text = optionalString(args, "text");
-      const excludeIssue = optionalString(args, "exclude_issue");
+      const excludeIssues = optionalStringArray(args, "exclude_issues");
       const keywordsOnly = optionalBoolean(args, "keywords_only");
       const suggestions = await client.related(project, {
         ...title === undefined ? {} : { title },
         ...text === undefined ? {} : { text },
-        ...excludeIssue === undefined ? {} : { exclude_issue: excludeIssue },
+        ...excludeIssues === undefined ? {} : { exclude_issues: excludeIssues },
         ...keywordsOnly === undefined ? {} : { keywords_only: keywordsOnly }
       });
       return {
@@ -27532,6 +27556,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 +27570,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 +27664,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 +27673,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 +28093,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 }))),
@@ -28283,7 +28314,7 @@ async function runDispatchCli(argv, rawEnv, io) {
   if (parsed.kind === "refused") {
     return parsed.tool === undefined ? refuse([`dispatch: ${parsed.problems.join(`
 `)}`, "Run dispatch --help."].join(`
-`), USAGE) : refuse(new ToolInputError(parsed.tool, parsed.problems).message, REFUSED, parsed.tool);
+`), USAGE) : refuse(new ToolInputError(parsed.tool, parsed.problems).message, USAGE, parsed.tool);
   }
   const hostName = env.DISPATCH_HOST ?? (env.CLAUDE_CODE_CHILD_SESSION === "1" ? "claude" : undefined);
   const host = HOSTS.find((name) => name === hostName);
@@ -28311,7 +28342,7 @@ async function runDispatchCli(argv, rawEnv, io) {
       serverUrls: settings?.enabled === true ? dispatchServerUrls(settings) : []
     });
     if (problems.length > 0) {
-      return refuse(new ToolInputError(parsed.tool, problems).message, REFUSED, parsed.tool);
+      return refuse(new ToolInputError(parsed.tool, problems).message, USAGE, parsed.tool);
     }
     print(JSON.stringify(parsed.args, null, 2));
     return OK;
@@ -28448,7 +28479,7 @@ async function runDispatchCli(argv, rawEnv, io) {
       notes.push(followNoticeText(followed, await subscriptions()));
     }
     entry = { tool, details: result.details };
-    code = OK;
+    code = result.refused === true ? REFUSED : OK;
   } catch (error) {
     text = messageFor(error);
     if (error instanceof DispatchWriteLandedError) {
@@ -28456,7 +28487,7 @@ async function runDispatchCli(argv, rawEnv, io) {
       code = OK;
     } else {
       entry = { tool, error: text };
-      code = REFUSED;
+      code = error instanceof ToolInputError ? USAGE : REFUSED;
     }
   }
   try {

package/dist/envoy-channel.js

@@ -36311,7 +36311,8 @@ var IssueEventPayloadSchema = object({
   route: string2().nullish(),
   changed: array(string2()).optional(),
   ancestors: array(string2()).optional(),
-  thread_logins: array(string2()).optional()
+  thread_logins: array(string2()).optional(),
+  forced: object({ past: array(string2()) }).optional()
 });
 var ArtifactCreatedEventPayloadSchema = object({
   artifact: object({ id: string2().optional(), slug: string2().optional(), name: string2().optional() }).optional()
@@ -37264,12 +37265,12 @@ var dispatchToolSpecs = [
   {
     name: "dispatch_related",
     example: { project: "CORE", title: "Retry failed webhook deliveries" },
-    description: "Run the related-item check that dispatch issue, dispatch ask and a new decision block in " + "dispatch doc-edit run on their own write, and write nothing: it lists the three items of " + "one project most like a title and a text (at most one per issue or document, open ones " + "first), each ask with whether it is answered, and a past decision that already answers " + "the same question. Use it to check a draft before filing it. It searches by meaning and by " + "the text's rarest words, and says how it searched; when meaning search cannot run it " + "searches by keywords only and says why. When it could not search at all it says why and " + "names the dispatch search to run instead. exclude_issue leaves that issue's own items out, " + "as a check on that issue's own write does; keywords_only skips meaning search.",
+    description: "Run the related-item check that dispatch issue, dispatch ask and a new decision block in " + "dispatch doc-edit run on their own write, and write nothing: it lists the three items of " + "one project most like a title and a text (at most one per issue or document, open ones " + "first), each ask with whether it is answered, and a past decision that already answers " + "the same question. Use it to check a draft before filing it. It searches by meaning and by " + "the text's rarest words, and says how it searched; when meaning search cannot run it " + "searches by keywords only and says why. When it could not search at all it says why and " + "names the dispatch search to run instead. exclude_issues leaves each named issue's own " + "items out of the results, at most 50 of them, so a draft under a parent can leave out " + "that parent and its children without changing how rare the text's words are; " + "keywords_only skips meaning search.",
     arguments: (z) => ({
       project: z.string().describe("Project key to search within, such as CORE."),
       title: z.string({ max: ISSUE_TITLE_MAX }).describe("Optional title to check, as an issue title; at most 1,000 characters.").optional(),
       text: z.string().describe("Optional text to check, such as a draft spec or a question.").optional(),
-      exclude_issue: z.string().describe("Optional issue key in the project whose own items are left out.").optional(),
+      exclude_issues: z.array(z.string()).describe("Optional issue keys in the project whose own items are left out of the results; at most 50.").optional(),
       keywords_only: z.boolean().describe("Search by keywords only, skipping meaning search.").optional()
     }),
     validation: {
@@ -44626,6 +44627,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 +44641,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 +44735,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 +44744,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 +45071,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 +46877,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 +46923,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 +46938,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)
@@ -47315,11 +47326,19 @@ function relatedCheckLines(suggestions, context) {
       lines.push(`A past decision may already answer this: ${suggestionLabel(decision)}, answered by ${decision.answered_by}${when} \u2192 ${absoluteHref(decision.href, context.configUrl)}`);
       lines.push(...askLines(decision.ask));
     }
+    const likely = suggestions.likely_duplicate;
+    if (likely !== undefined && likely !== null) {
+      lines.push(`Likely duplicate: ${likely.key} [${likely.status}] ${likely.title} \u2192 ${absoluteHref(likely.href, context.configUrl)}`);
+      lines.push("Read it. If it is the same work, fold this issue into it by the duplicate rule of skill://dispatch-first.");
+    }
+    if (suggestions.near_copy_check !== undefined && suggestions.near_copy_check !== "") {
+      lines.push(`No near-copy check was made: ${suggestions.near_copy_check}.`);
+    }
     for (const match of suggestions.title_matches ?? []) {
-      lines.push(`Title overlaps you forced past: ${match.key} [${match.status}] ${match.title} \u2192 ${absoluteHref(match.href, context.configUrl)}`);
+      lines.push(`Near copy you forced past: ${match.key} [${match.status}] ${match.title} \u2192 ${absoluteHref(match.href, context.configUrl)}`);
     }
   } catch (error) {
-    lines.push(`The check's past decision or title overlaps could not be shown: ${messageFor(error)}`);
+    lines.push(`The check's past decision or near copies could not be shown: ${messageFor(error)}`);
   }
   return lines;
 }
@@ -49170,7 +49189,13 @@ function eventHead(event) {
       return textHead(`${event.payload.name} v${event.payload.version.number}${event.payload.version.summary ? `: ${event.payload.version.summary}` : ""}`);
     case "artifact.human_edited":
       return textHead(humanEditHead(event.payload));
-    case "issue.created":
+    case "issue.created": {
+      const forced = event.payload.forced;
+      const head = `status ${event.payload.status}`;
+      if (forced === undefined)
+        return head;
+      return forced.past.length === 0 ? `${head} \xB7 forced, the near-copy check did not answer` : `${head} \xB7 forced past ${forced.past.join(", ")}`;
+    }
     case "issue.updated":
     case "issue.closed":
       return `status ${event.payload.status}`;
@@ -49186,10 +49211,14 @@ function eventRef(event) {
   const kind = event.type.startsWith("message.") ? "message" : event.type.startsWith("comment.") || event.type.startsWith("suggestion.") ? "comment" : event.type.startsWith("ask.") ? "ask" : undefined;
   return kind === undefined ? undefined : `dispatch://${event.issue_key}/${kind}/${id}`;
 }
+function eventActorText(actor) {
+  const title = actor.kind === "session" ? actor.origin?.session_title : undefined;
+  return title === undefined || title === "" ? actorText(actor) : `${actorText(actor)} (${title})`;
+}
 function eventLine(event) {
   const head = eventHead(event);
   const ref = eventRef(event);
-  return `- #${event.seq} ${event.type}${ref === undefined ? "" : ` ${ref}`} \xB7 ${actorText(event.actor)} \xB7 ${event.created_at}${head === undefined || head === "" ? "" : ` \xB7 ${head}`}`;
+  return `- #${event.seq} ${event.type}${ref === undefined ? "" : ` ${ref}`} \xB7 ${eventActorText(event.actor)} \xB7 ${event.created_at}${head === undefined || head === "" ? "" : ` \xB7 ${head}`}`;
 }
 function childrenSummary(issue) {
   return [
@@ -50006,15 +50035,17 @@ async function executeDispatchTool(input) {
         const candidates = duplicateCandidates(error);
         return {
           text: [
-            `Not created: "${title}" looks like a duplicate.`,
+            `Not created: "${title}" is a near copy of an open issue.`,
             ...candidates.map((candidate) => {
               const href = new URL(candidate.href, linkBase).toString();
               return `${candidate.key} [${candidate.status}] ${candidate.title} \u2192 ${href}`;
             }),
-            "Reference the existing issue, or run dispatch issue again with --force after reading it."
+            "Read each issue above. If one is the same work, fold this into it by the duplicate rule of skill://dispatch-first.",
+            "If none is, run dispatch issue again with --force, and write in the new issue's spec why it is not each issue named here."
           ].join(`
 `),
-          details: { duplicates: candidates }
+          details: { duplicates: candidates },
+          refused: true
         };
       }
     }
@@ -50182,12 +50213,12 @@ async function executeDispatchTool(input) {
       const project = stringArg(args, "project");
       const title = optionalString(args, "title");
       const text = optionalString(args, "text");
-      const excludeIssue = optionalString(args, "exclude_issue");
+      const excludeIssues = optionalStringArray(args, "exclude_issues");
       const keywordsOnly = optionalBoolean(args, "keywords_only");
       const suggestions = await client.related(project, {
         ...title === undefined ? {} : { title },
         ...text === undefined ? {} : { text },
-        ...excludeIssue === undefined ? {} : { exclude_issue: excludeIssue },
+        ...excludeIssues === undefined ? {} : { exclude_issues: excludeIssues },
         ...keywordsOnly === undefined ? {} : { keywords_only: keywordsOnly }
       });
       return {
@@ -55145,7 +55176,7 @@ var import_nats2 = __toESM(require_mod4(), 1);
 
 // package.json
 var name = "@sjawhar/claude-envoy";
-var version2 = "1.12.1";
+var version2 = "1.14.0";
 var legion = {
   daemonApiVersion: 55
 };
@@ -57218,9 +57249,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 +57316,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 +57323,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 +57386,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");