@sjawhar/pi-legion-envoy 5.5.3 → 5.5.5

package/dist/envoy.js

@@ -29960,7 +29960,7 @@ function dispatchToolSchema(spec, z2, opts) {
   const schemaOptions = strict === undefined ? undefined : { strict };
   return spec.validation === undefined ? z2.object(shape, schemaOptions) : z2.refineObject(shape, spec.validation.check, spec.validation.message, schemaOptions);
 }
-var ISSUE_REFERENCE = "An issue is a native KEY or external owner/repo#n reference; an external reference creates its native issue in the repository's dashboard-configured project or, failing that, the default project (DISPATCH_DEFAULT_PROJECT).";
+var ISSUE_REFERENCE = "An issue is a native KEY or external owner/repo#n reference. An external reference addresses an existing Dispatch issue, including one linked to that GitHub pull request; only dispatch_issue with external creates a native issue.";
 var OWNER_REFERENCE = "Exactly one of issue and project is required. An issue is a native KEY or external owner/repo#n reference; a project is a project key such as CORE and addresses an unlinked project document named by artifact.";
 function documentOwnerValidation(requireArtifact, alwaysRequireArtifact = false) {
   return {
@@ -32265,7 +32265,6 @@ class DispatchClient {
   fetchImpl;
   #baseUrl;
   #resolvedIssues = new Map;
-  #creatingIssues = new Map;
   #signal;
   constructor(baseUrl, token, fetchImpl = fetch, signal) {
     this.token = token;
@@ -32276,6 +32275,9 @@ class DispatchClient {
   async issue(input) {
     return this.#json("POST", ["api", "v1", "issues"], input);
   }
+  async resolveIssue(issueReference) {
+    return this.#resolveIssue(issueReference);
+  }
   async listIssues(options = {}) {
     return this.#json("GET", ["api", "v1", "issues"], undefined, options);
   }
@@ -32471,43 +32473,6 @@ class DispatchClient {
       ...query.since === undefined ? {} : { since: query.since }
     });
   }
-  async ensureIssue(issueReference, actor) {
-    if (!issueReference.includes("#"))
-      return issueReference;
-    try {
-      return await this.#resolveIssue(issueReference);
-    } catch (error48) {
-      if (!(error48 instanceof DispatchServiceError) || error48.status !== 404)
-        throw error48;
-    }
-    let creating = this.#creatingIssues.get(issueReference);
-    if (!creating) {
-      creating = this.#createExternalIssue(issueReference, actor);
-      this.#creatingIssues.set(issueReference, creating);
-    }
-    try {
-      return await creating;
-    } finally {
-      if (this.#creatingIssues.get(issueReference) === creating) {
-        this.#creatingIssues.delete(issueReference);
-      }
-    }
-  }
-  async#createExternalIssue(issueReference, actor) {
-    try {
-      const created = await this.#json("POST", ["api", "v1", "issues"], {
-        external: issueReference,
-        actor
-      });
-      this.#resolvedIssues.set(issueReference, Promise.resolve(created.key));
-      return created.key;
-    } catch (error48) {
-      if (error48 instanceof DispatchServiceError && (error48.status === 409 || error48.status === 500)) {
-        return this.#resolveIssue(issueReference);
-      }
-      throw error48;
-    }
-  }
   async#resolveIssue(issueReference) {
     if (!issueReference.includes("#"))
       return issueReference;
@@ -33685,7 +33650,7 @@ async function executeDispatchTool(input) {
   const client = dispatchClient();
   const owner = ownerArguments.owner?.kind === "issue" ? {
     kind: "issue",
-    issue: await ensureIssue(client, ownerArguments.owner.issue, actor)
+    issue: await resolveExistingIssue(client, ownerArguments.owner.issue)
   } : ownerArguments.owner;
   const issue2 = () => {
     if (owner?.kind !== "issue")
@@ -34337,13 +34302,12 @@ ${trailer.join(`
       throw new Error(`Unknown Dispatch tool: ${input.tool}`);
   }
 }
-async function ensureIssue(client, issueReference, actor) {
+async function resolveExistingIssue(client, issueReference) {
   try {
-    return await client.ensureIssue(issueReference, actor);
+    return await client.resolveIssue(issueReference);
   } catch (error48) {
-    if (error48 instanceof DispatchServiceError && error48.code === "PROJECT_UNMAPPED") {
-      const repository = issueReference.slice(0, issueReference.lastIndexOf("#"));
-      throw new Error(`repository ${repository} is not mapped in repository settings and no DISPATCH_DEFAULT_PROJECT is configured`);
+    if (error48 instanceof DispatchServiceError && error48.status === 404) {
+      throw new Error(`no Dispatch issue is linked to ${issueReference}; create it first with ` + `dispatch_issue({ external: "${issueReference}", ... })`);
     }
     throw error48;
   }

package/dist/legion.js

@@ -16142,7 +16142,7 @@ import { logger } from "@oh-my-pi/pi-utils";
 // package.json
 var package_default = {
   name: "@sjawhar/pi-legion-envoy",
-  version: "5.5.3",
+  version: "5.5.5",
   type: "module",
   omp: {
     extensions: [
@@ -30033,7 +30033,7 @@ function dispatchToolSchema(spec, z2, opts) {
   const schemaOptions = strict === undefined ? undefined : { strict };
   return spec.validation === undefined ? z2.object(shape, schemaOptions) : z2.refineObject(shape, spec.validation.check, spec.validation.message, schemaOptions);
 }
-var ISSUE_REFERENCE = "An issue is a native KEY or external owner/repo#n reference; an external reference creates its native issue in the repository's dashboard-configured project or, failing that, the default project (DISPATCH_DEFAULT_PROJECT).";
+var ISSUE_REFERENCE = "An issue is a native KEY or external owner/repo#n reference. An external reference addresses an existing Dispatch issue, including one linked to that GitHub pull request; only dispatch_issue with external creates a native issue.";
 var OWNER_REFERENCE = "Exactly one of issue and project is required. An issue is a native KEY or external owner/repo#n reference; a project is a project key such as CORE and addresses an unlinked project document named by artifact.";
 function documentOwnerValidation(requireArtifact, alwaysRequireArtifact = false) {
   return {

package/dist/skills/dispatch/SKILL.md

@@ -147,8 +147,9 @@ See [Typed blocks](#typed-blocks) for the syntax and [Before you ask](#before-yo
 Every session works on an issue or project document. Legion pre-fills `issue` from `LEGION_ISSUE`: use a native issue key such as
 `LEGION-3`, an external `owner/repo#n` reference, or a bare positive number (resolved against the cwd repository). Otherwise pass
 exactly one owner to every owner-scoped tool: `issue` for an issue, or `project` and `artifact` for an unlinked project document (see
-[References](#references) for the resulting ref shape). On first use, an external issue reference creates its native issue in the
-project configured for that repository in Dispatch Settings, then falls back to `DISPATCH_DEFAULT_PROJECT`.
+[References](#references) for the resulting ref shape). An external issue reference addresses the existing Dispatch issue linked to
+that GitHub issue or pull request. Only `dispatch_issue` with `external` creates a native issue; if no issue is linked, call
+`dispatch_issue({ external: "owner/repo#n", project: "<project>", title: "<title>" })` before addressing it.
 
 Issue reads include `rank`, the server-owned ordering key used by project boards; reorder through `PATCH /api/v1/issues/{key}` with neighboring issue keys. They also include nullable coarse priority (`P0` highest through `P3` lowest) and `assignee`: the lowercase GitHub login of the human who answers the issue's asks, or `null` when nobody holds it. `dispatch_read` of an issue prints it as `Assignee: <login>` or `Assignee: unassigned`.
 

package/package.json

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