@sjawhar/pi-legion-envoy 0.34.0 → 0.35.0

package/README.md

@@ -79,10 +79,10 @@ extension files it does not contain.
 
 ## Native Dispatch tools
 
-The extension registers `dispatch_issue`, `dispatch_ask`, `dispatch_resolve_ask`,
-`dispatch_comment`, `dispatch_suggest`, `dispatch_message`, `dispatch_doc_edit`,
-`dispatch_doc_read`, `dispatch_artifact`, and `dispatch_read` when Dispatch
-configuration resolves both a base URL and bearer token.
+The extension registers eleven native Dispatch tools: `dispatch_issue`, `dispatch_ask`,
+`dispatch_resolve_ask`, `dispatch_comment`, `dispatch_suggest`, `dispatch_message`,
+`dispatch_doc_edit`, `dispatch_doc_read`, `dispatch_artifact`, `dispatch_read`, and
+`dispatch_search`, when Dispatch configuration resolves both a base URL and bearer token.
 
 Configure the shared `envoy.json` with:
 
@@ -101,14 +101,14 @@ The user file is `~/.config/opencode/envoy.json`; a
 `DISPATCH_TOKEN` override the file values for one process. Omitting
 `dispatch.serverUrl` while `dispatch.enabled` is true targets
 `http://localhost:8766`, the Go server's listen address. Invalid configuration,
-an invalid URL, or an empty token leaves the nine tools unavailable and reports
+an invalid URL, or an empty token leaves the eleven tools unavailable and reports
 the source of the error.
 
-Native tools operate on a Dispatch issue: a native `KEY` or an external
-`owner/repo#n` reference. A Legion session may omit `issue` when
-`LEGION_ISSUE` identifies its root issue and its working directory resolves to a
-repository. `dispatch_doc_read` and `dispatch_read` also accept
-`dispatch://` references.
+Every native tool except `dispatch_search` operates on a Dispatch issue: a native
+`KEY` or an external `owner/repo#n` reference. A Legion session may omit `issue` when
+`LEGION_ISSUE` identifies its root issue and its working directory resolves to a repository.
+`dispatch_doc_read` and `dispatch_read` also accept `dispatch://` references;
+`dispatch_search` needs only its query and returns no subscription topic.
 
 Every mutation result carries `details.topic` as
 `notifications.dispatch.issue.<KEY>.>`. The extension's `tool_result` hook

package/dist/envoy.js

@@ -29694,6 +29694,56 @@ var ChildStatusEventPayloadSchema = object({
   from: string2().optional(),
   to: string2().optional()
 });
+// ../contracts/src/dispatch-snippet.ts
+var HTML_ENTITIES = [
+  ["&lt;", "<"],
+  ["&gt;", ">"],
+  ["&#39;", "'"],
+  ["&#34;", '"'],
+  ["&amp;", "&"]
+];
+function decodeEntities(text) {
+  let decoded = text;
+  for (const [entity, character] of HTML_ENTITIES) {
+    decoded = decoded.replaceAll(entity, character);
+  }
+  return decoded;
+}
+function hasOnlyBalancedMarkers(snippet) {
+  let marked = false;
+  for (const marker of snippet.matchAll(/<mark>|<\/mark>/gu)) {
+    if (marker[0] === "<mark>") {
+      if (marked)
+        return false;
+      marked = true;
+    } else {
+      if (!marked)
+        return false;
+      marked = false;
+    }
+  }
+  return !marked;
+}
+function snippetSegments(snippet) {
+  if (!hasOnlyBalancedMarkers(snippet)) {
+    return snippet === "" ? [] : [{ text: decodeEntities(snippet), mark: false }];
+  }
+  let mark = false;
+  const segments = [];
+  for (const part of snippet.split(/(<mark>|<\/mark>)/u)) {
+    if (part === "<mark>") {
+      mark = true;
+    } else if (part === "</mark>") {
+      mark = false;
+    } else if (part !== "") {
+      segments.push({ text: decodeEntities(part), mark });
+    }
+  }
+  return segments;
+}
+function snippetText(snippet) {
+  return snippetSegments(snippet).map(({ text, mark }) => mark ? `**${text}**` : text).join("");
+}
 // ../contracts/src/dispatch-tools.ts
 function dispatchToolSchema(spec, z, opts) {
   const shape = spec.arguments(z);
@@ -29715,12 +29765,13 @@ var DOC_EDIT_OPS = ["replace", "delete", "insert"];
 var dispatchToolSpecs = [
   {
     name: "dispatch_issue",
-    description: "Create a native Dispatch issue for newly tracked work. Do not use it when an existing issue " + `already covers the work; read or update that issue instead. ${ISSUE_REFERENCE}`,
+    description: "Create a native Dispatch issue for newly tracked work. Search first with dispatch_search; if potentially duplicate issues exist, this returns 409 POSSIBLE_DUPLICATE unless force is true after reading them. " + `Do not use it when an existing issue already covers the work; read or update that issue instead. ${ISSUE_REFERENCE}`,
     arguments: (z) => ({
       project: z.string().describe("Project key for the new issue."),
       title: z.string().describe("Concise issue title."),
       parent: z.string().describe("Optional parent issue.").optional(),
       external: z.string().describe("Optional external issue reference.").optional(),
+      force: z.boolean().describe("Create even though POSSIBLE_DUPLICATE listed similar issues; pass it only after reading them.").optional(),
       spec: z.string().describe(`Optional initial primary-document markdown. ${SPEC_WRITING_GUIDANCE}`).optional()
     })
   },
@@ -29838,6 +29889,15 @@ var dispatchToolSpecs = [
       issue: z.string().describe(ISSUE_REFERENCE).optional(),
       ref: z.string().describe("Optional dispatch:// issue reference.").optional()
     })
+  },
+  {
+    name: "dispatch_search",
+    description: "Search every issue, document, comment, ask, and message for a keyword or phrase and get deep links. " + "Use it before creating an issue or a design document, and to find where a word was written. " + 'Websearch syntax: "quoted phrase", -excluded, OR.',
+    arguments: (z) => ({
+      query: z.string({ min: 2 }).describe("Keyword, phrase, or websearch expression; at least 2 characters."),
+      project: z.string().describe("Optional project key to search within.").optional(),
+      limit: z.number({ int: true, min: 1, max: 50 }).describe("Maximum results, 1-50; default 20.").optional()
+    })
   }
 ];
 // ../contracts/src/envelope.ts
@@ -31169,6 +31229,9 @@ class DispatchClient {
   async listIssues(options = {}) {
     return this.#json("GET", ["api", "v1", "issues"], undefined, options);
   }
+  async search(query, options = {}) {
+    return this.#json("GET", ["api", "v1", "search"], undefined, { q: query, ...options });
+  }
   async getIssue(issue) {
     return this.#json("GET", ["api", "v1", "issues", await this.#resolveIssue(issue)]);
   }
@@ -31343,6 +31406,7 @@ class DispatchClient {
 var nativeIssueKeyPattern = /^[A-Z][A-Z0-9]{1,9}-[0-9]+$/;
 var externalIssueRefPattern = /^([^/\s]+)\/([^/\s#]+)#([1-9][0-9]*)$/;
 var bareIssueNumberPattern = /^[1-9][0-9]*$/;
+var issueFreeTools = new Set(["dispatch_issue", "dispatch_resolve_ask", "dispatch_search"]);
 function canonicalExternalIssueRef(value) {
   const match = value.trim().match(externalIssueRefPattern);
   return match ? `${canonicalRepo(match[1] ?? "", match[2] ?? "")}#${match[3]}` : value;
@@ -31365,6 +31429,23 @@ function optionalNumber(args, name) {
   const value = args[name];
   return typeof value === "number" ? value : undefined;
 }
+function isDuplicateCandidate(value) {
+  if (typeof value !== "object" || value === null)
+    return false;
+  const candidate = value;
+  return typeof candidate.key === "string" && typeof candidate.title === "string" && typeof candidate.status === "string" && typeof candidate.snippet === "string" && typeof candidate.shared_terms === "number" && typeof candidate.href === "string";
+}
+function duplicateCandidates(error) {
+  if (error.candidates === undefined || !error.candidates.every(isDuplicateCandidate))
+    throw error;
+  return error.candidates;
+}
+function searchResultLine(result, baseUrl) {
+  const artifactName = result.artifact ? ` ${result.artifact.name}` : "";
+  const label = `${result.issue.key} [${result.issue.status}] ${result.issue.title} - ${result.kind}${artifactName}`;
+  const href = new URL(result.href, baseUrl).toString();
+  return `${label}: ${snippetText(result.snippet)} -> ${href}`;
+}
 function askUrgency(args) {
   const value = args.urgency;
   return ASK_URGENCIES.find((urgency) => urgency === value);
@@ -31403,7 +31484,7 @@ function toolSchema(tool) {
   return dispatchToolSchema(spec, zodSchemaApi(exports_external), { strict: true });
 }
 async function resolveIssueArguments(tool, args, cwd, env, exec) {
-  if (tool === "dispatch_issue" || tool === "dispatch_resolve_ask")
+  if (issueFreeTools.has(tool))
     return { args, ref: null };
   const refArgument = args.ref;
   const ref = typeof refArgument === "string" ? parseDispatchRef(refArgument) ?? (() => {
@@ -31551,7 +31632,9 @@ async function openArtifactMarks(client, resolved) {
   ];
 }
 async function executeDispatchTool(input) {
-  if (!input.config.enabled || !input.config.url || !input.config.token) {
+  const configUrl = input.config.url;
+  const configToken = input.config.token;
+  if (!input.config.enabled || !configUrl || !configToken) {
     throw new Error("Dispatch is disabled; resolve both DISPATCH_URL and DISPATCH_TOKEN");
   }
   const env = input.env ?? process.env;
@@ -31559,8 +31642,8 @@ async function executeDispatchTool(input) {
   const issueArguments = await resolveIssueArguments(input.tool, input.args, input.cwd, env, exec);
   const args = toolSchema(input.tool).parse(issueArguments.args);
   const actor = toolActor(await resolveOrigin(env, exec, input.cwd), input);
-  const client = new DispatchClient(input.config.url, input.config.token, input.fetchImpl);
-  const issueKey = input.tool === "dispatch_issue" || input.tool === "dispatch_resolve_ask" ? null : await ensureIssue(client, stringArg(args, "issue"), actor);
+  const client = new DispatchClient(configUrl, configToken, input.fetchImpl);
+  const issueKey = issueFreeTools.has(input.tool) ? null : await ensureIssue(client, stringArg(args, "issue"), actor);
   const issue = () => {
     if (issueKey === null)
       throw new Error("issue is required");
@@ -31568,20 +31651,62 @@ async function executeDispatchTool(input) {
   };
   switch (input.tool) {
     case "dispatch_issue": {
+      const project = stringArg(args, "project");
+      const title = stringArg(args, "title");
       const parent = optionalString(args, "parent");
       const external = optionalString(args, "external");
+      const force = optionalBoolean(args, "force");
       const spec = optionalString(args, "spec");
-      const created = await client.issue({
-        project: stringArg(args, "project"),
-        title: stringArg(args, "title"),
-        ...parent === undefined ? {} : { parent },
-        ...external === undefined ? {} : { external },
-        ...spec === undefined ? {} : { spec },
-        actor
+      try {
+        const created = await client.issue({
+          project,
+          title,
+          ...parent === undefined ? {} : { parent },
+          ...external === undefined ? {} : { external },
+          ...force === undefined ? {} : { force },
+          ...spec === undefined ? {} : { spec },
+          actor
+        });
+        return {
+          text: `Created ${created.key}: ${created.title}`,
+          details: { issue: created.key, topic: dispatchIssueSubject(created.key, ">") }
+        };
+      } catch (error) {
+        if (!(error instanceof DispatchServiceError) || error.code !== "POSSIBLE_DUPLICATE") {
+          throw error;
+        }
+        const candidates = duplicateCandidates(error);
+        return {
+          text: [
+            `Not created: "${title}" looks like a duplicate.`,
+            ...candidates.map((candidate) => {
+              const href = new URL(candidate.href, configUrl).toString();
+              return `${candidate.key} [${candidate.status}] ${candidate.title} \u2192 ${href}`;
+            }),
+            "Reference the existing issue, or call dispatch_issue again with force: true after reading it."
+          ].join(`
+`),
+          details: { duplicates: candidates }
+        };
+      }
+    }
+    case "dispatch_search": {
+      const query = stringArg(args, "query");
+      const project = optionalString(args, "project");
+      const limit = optionalNumber(args, "limit");
+      const search = await client.search(query, {
+        ...project === undefined ? {} : { project },
+        ...limit === undefined ? {} : { limit }
       });
+      const results = search.results;
+      const count = results.length;
       return {
-        text: `Created ${created.key}: ${created.title}`,
-        details: { issue: created.key, topic: dispatchIssueSubject(created.key, ">") }
+        text: count === 0 ? `No results for "${query}".` : [
+          `${count} ${count === 1 ? "result" : "results"} for "${query}" (${search.took_ms} ms)`,
+          ...results.map((result) => searchResultLine(result, configUrl))
+        ].join(`
+`),
+        details: { query, results }
       };
     }
     case "dispatch_resolve_ask": {

package/dist/legion.js

@@ -29692,6 +29692,56 @@ var ChildStatusEventPayloadSchema = object({
   from: string2().optional(),
   to: string2().optional()
 });
+// ../contracts/src/dispatch-snippet.ts
+var HTML_ENTITIES = [
+  ["&lt;", "<"],
+  ["&gt;", ">"],
+  ["&#39;", "'"],
+  ["&#34;", '"'],
+  ["&amp;", "&"]
+];
+function decodeEntities(text) {
+  let decoded = text;
+  for (const [entity, character] of HTML_ENTITIES) {
+    decoded = decoded.replaceAll(entity, character);
+  }
+  return decoded;
+}
+function hasOnlyBalancedMarkers(snippet) {
+  let marked = false;
+  for (const marker of snippet.matchAll(/<mark>|<\/mark>/gu)) {
+    if (marker[0] === "<mark>") {
+      if (marked)
+        return false;
+      marked = true;
+    } else {
+      if (!marked)
+        return false;
+      marked = false;
+    }
+  }
+  return !marked;
+}
+function snippetSegments(snippet) {
+  if (!hasOnlyBalancedMarkers(snippet)) {
+    return snippet === "" ? [] : [{ text: decodeEntities(snippet), mark: false }];
+  }
+  let mark = false;
+  const segments = [];
+  for (const part of snippet.split(/(<mark>|<\/mark>)/u)) {
+    if (part === "<mark>") {
+      mark = true;
+    } else if (part === "</mark>") {
+      mark = false;
+    } else if (part !== "") {
+      segments.push({ text: decodeEntities(part), mark });
+    }
+  }
+  return segments;
+}
+function snippetText(snippet) {
+  return snippetSegments(snippet).map(({ text, mark }) => mark ? `**${text}**` : text).join("");
+}
 // ../contracts/src/dispatch-tools.ts
 function dispatchToolSchema(spec, z, opts) {
   const shape = spec.arguments(z);
@@ -29713,12 +29763,13 @@ var DOC_EDIT_OPS = ["replace", "delete", "insert"];
 var dispatchToolSpecs = [
   {
     name: "dispatch_issue",
-    description: "Create a native Dispatch issue for newly tracked work. Do not use it when an existing issue " + `already covers the work; read or update that issue instead. ${ISSUE_REFERENCE}`,
+    description: "Create a native Dispatch issue for newly tracked work. Search first with dispatch_search; if potentially duplicate issues exist, this returns 409 POSSIBLE_DUPLICATE unless force is true after reading them. " + `Do not use it when an existing issue already covers the work; read or update that issue instead. ${ISSUE_REFERENCE}`,
     arguments: (z) => ({
       project: z.string().describe("Project key for the new issue."),
       title: z.string().describe("Concise issue title."),
       parent: z.string().describe("Optional parent issue.").optional(),
       external: z.string().describe("Optional external issue reference.").optional(),
+      force: z.boolean().describe("Create even though POSSIBLE_DUPLICATE listed similar issues; pass it only after reading them.").optional(),
       spec: z.string().describe(`Optional initial primary-document markdown. ${SPEC_WRITING_GUIDANCE}`).optional()
     })
   },
@@ -29836,6 +29887,15 @@ var dispatchToolSpecs = [
       issue: z.string().describe(ISSUE_REFERENCE).optional(),
       ref: z.string().describe("Optional dispatch:// issue reference.").optional()
     })
+  },
+  {
+    name: "dispatch_search",
+    description: "Search every issue, document, comment, ask, and message for a keyword or phrase and get deep links. " + "Use it before creating an issue or a design document, and to find where a word was written. " + 'Websearch syntax: "quoted phrase", -excluded, OR.',
+    arguments: (z) => ({
+      query: z.string({ min: 2 }).describe("Keyword, phrase, or websearch expression; at least 2 characters."),
+      project: z.string().describe("Optional project key to search within.").optional(),
+      limit: z.number({ int: true, min: 1, max: 50 }).describe("Maximum results, 1-50; default 20.").optional()
+    })
   }
 ];
 // ../contracts/src/envelope.ts
@@ -31608,6 +31668,9 @@ class DispatchClient {
   async listIssues(options = {}) {
     return this.#json("GET", ["api", "v1", "issues"], undefined, options);
   }
+  async search(query, options = {}) {
+    return this.#json("GET", ["api", "v1", "search"], undefined, { q: query, ...options });
+  }
   async getIssue(issue) {
     return this.#json("GET", ["api", "v1", "issues", await this.#resolveIssue(issue)]);
   }
@@ -31782,6 +31845,7 @@ class DispatchClient {
 var nativeIssueKeyPattern = /^[A-Z][A-Z0-9]{1,9}-[0-9]+$/;
 var externalIssueRefPattern = /^([^/\s]+)\/([^/\s#]+)#([1-9][0-9]*)$/;
 var bareIssueNumberPattern = /^[1-9][0-9]*$/;
+var issueFreeTools = new Set(["dispatch_issue", "dispatch_resolve_ask", "dispatch_search"]);
 function canonicalExternalIssueRef(value) {
   const match = value.trim().match(externalIssueRefPattern);
   return match ? `${canonicalRepo(match[1] ?? "", match[2] ?? "")}#${match[3]}` : value;
@@ -31804,6 +31868,23 @@ function optionalNumber(args, name) {
   const value = args[name];
   return typeof value === "number" ? value : undefined;
 }
+function isDuplicateCandidate(value) {
+  if (typeof value !== "object" || value === null)
+    return false;
+  const candidate = value;
+  return typeof candidate.key === "string" && typeof candidate.title === "string" && typeof candidate.status === "string" && typeof candidate.snippet === "string" && typeof candidate.shared_terms === "number" && typeof candidate.href === "string";
+}
+function duplicateCandidates(error) {
+  if (error.candidates === undefined || !error.candidates.every(isDuplicateCandidate))
+    throw error;
+  return error.candidates;
+}
+function searchResultLine(result, baseUrl) {
+  const artifactName = result.artifact ? ` ${result.artifact.name}` : "";
+  const label = `${result.issue.key} [${result.issue.status}] ${result.issue.title} - ${result.kind}${artifactName}`;
+  const href = new URL(result.href, baseUrl).toString();
+  return `${label}: ${snippetText(result.snippet)} -> ${href}`;
+}
 function askUrgency(args) {
   const value = args.urgency;
   return ASK_URGENCIES.find((urgency) => urgency === value);
@@ -31842,7 +31923,7 @@ function toolSchema(tool) {
   return dispatchToolSchema(spec, zodSchemaApi(exports_external), { strict: true });
 }
 async function resolveIssueArguments(tool, args, cwd, env, exec) {
-  if (tool === "dispatch_issue" || tool === "dispatch_resolve_ask")
+  if (issueFreeTools.has(tool))
     return { args, ref: null };
   const refArgument = args.ref;
   const ref = typeof refArgument === "string" ? parseDispatchRef(refArgument) ?? (() => {
@@ -31990,7 +32071,9 @@ async function openArtifactMarks(client, resolved) {
   ];
 }
 async function executeDispatchTool(input) {
-  if (!input.config.enabled || !input.config.url || !input.config.token) {
+  const configUrl = input.config.url;
+  const configToken = input.config.token;
+  if (!input.config.enabled || !configUrl || !configToken) {
     throw new Error("Dispatch is disabled; resolve both DISPATCH_URL and DISPATCH_TOKEN");
   }
   const env = input.env ?? process.env;
@@ -31998,8 +32081,8 @@ async function executeDispatchTool(input) {
   const issueArguments = await resolveIssueArguments(input.tool, input.args, input.cwd, env, exec);
   const args = toolSchema(input.tool).parse(issueArguments.args);
   const actor = toolActor(await resolveOrigin(env, exec, input.cwd), input);
-  const client = new DispatchClient(input.config.url, input.config.token, input.fetchImpl);
-  const issueKey = input.tool === "dispatch_issue" || input.tool === "dispatch_resolve_ask" ? null : await ensureIssue(client, stringArg(args, "issue"), actor);
+  const client = new DispatchClient(configUrl, configToken, input.fetchImpl);
+  const issueKey = issueFreeTools.has(input.tool) ? null : await ensureIssue(client, stringArg(args, "issue"), actor);
   const issue = () => {
     if (issueKey === null)
       throw new Error("issue is required");
@@ -32007,20 +32090,62 @@ async function executeDispatchTool(input) {
   };
   switch (input.tool) {
     case "dispatch_issue": {
+      const project = stringArg(args, "project");
+      const title = stringArg(args, "title");
       const parent = optionalString(args, "parent");
       const external = optionalString(args, "external");
+      const force = optionalBoolean(args, "force");
       const spec = optionalString(args, "spec");
-      const created = await client.issue({
-        project: stringArg(args, "project"),
-        title: stringArg(args, "title"),
-        ...parent === undefined ? {} : { parent },
-        ...external === undefined ? {} : { external },
-        ...spec === undefined ? {} : { spec },
-        actor
+      try {
+        const created = await client.issue({
+          project,
+          title,
+          ...parent === undefined ? {} : { parent },
+          ...external === undefined ? {} : { external },
+          ...force === undefined ? {} : { force },
+          ...spec === undefined ? {} : { spec },
+          actor
+        });
+        return {
+          text: `Created ${created.key}: ${created.title}`,
+          details: { issue: created.key, topic: dispatchIssueSubject(created.key, ">") }
+        };
+      } catch (error) {
+        if (!(error instanceof DispatchServiceError) || error.code !== "POSSIBLE_DUPLICATE") {
+          throw error;
+        }
+        const candidates = duplicateCandidates(error);
+        return {
+          text: [
+            `Not created: "${title}" looks like a duplicate.`,
+            ...candidates.map((candidate) => {
+              const href = new URL(candidate.href, configUrl).toString();
+              return `${candidate.key} [${candidate.status}] ${candidate.title} \u2192 ${href}`;
+            }),
+            "Reference the existing issue, or call dispatch_issue again with force: true after reading it."
+          ].join(`
+`),
+          details: { duplicates: candidates }
+        };
+      }
+    }
+    case "dispatch_search": {
+      const query = stringArg(args, "query");
+      const project = optionalString(args, "project");
+      const limit = optionalNumber(args, "limit");
+      const search = await client.search(query, {
+        ...project === undefined ? {} : { project },
+        ...limit === undefined ? {} : { limit }
       });
+      const results = search.results;
+      const count = results.length;
       return {
-        text: `Created ${created.key}: ${created.title}`,
-        details: { issue: created.key, topic: dispatchIssueSubject(created.key, ">") }
+        text: count === 0 ? `No results for "${query}".` : [
+          `${count} ${count === 1 ? "result" : "results"} for "${query}" (${search.took_ms} ms)`,
+          ...results.map((result) => searchResultLine(result, configUrl))
+        ].join(`
+`),
+        details: { query, results }
       };
     }
     case "dispatch_resolve_ask": {

package/dist/skills/dispatch/SKILL.md

@@ -54,11 +54,24 @@ project configured for that repository in Dispatch Settings, then falls back to
 
 Architects create newly tracked child work with:
 ```ts
-dispatch_issue({ project, title, parent?, external?, spec? })
+dispatch_issue({ project, title, parent?, external?, spec?, force? })
 ```
 It returns `details` `{ issue, topic }`. Use `dispatch_issue` only to create an issue; never use
-it to park a question.
-When `spec` is supplied, follow [Writing a spec](#writing-a-spec).
+it to park a question. When `spec` is supplied, follow [Writing a spec](#writing-a-spec).
+
+## Search first
+
+Before you create an issue or start a design document, search:
+```ts
+dispatch_search({ query, project?, limit? })
+```
+It returns every issue, document, comment, ask, and message that contains the words, with the
+issue key and a link. Cite the hit you build on (`dispatch://KEY` or the document reference), or
+state "no prior issue" in the spec. Websearch syntax applies: `"merge queue"`, `-daemon`, `OR`.
+
+`dispatch_issue` refuses a title that near-duplicates an issue in the same project and returns
+the candidates (`POSSIBLE_DUPLICATE`). Read them; reference the existing issue, or repeat the
+call with `force: true` when it is genuinely new work.
 
 ## Asking
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sjawhar/pi-legion-envoy",
-  "version": "0.34.0",
+  "version": "0.35.0",
   "type": "module",
   "omp": {
     "extensions": [