@sjawhar/opencode-legion-envoy 1.38.0 → 1.38.1

package/dist/src/server.js

@@ -13552,6 +13552,7 @@ function date4(params) {
 // ../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/classic/external.js
 config(en_default());
 // ../contracts/src/dispatch-api.ts
+var ASK_TURNS = ["human", "agent"];
 var DELIVERY_CAPABILITIES = ["aside", "btw", "steer"];
 var DispatchEventSchema = object({
   issue_key: string2().nullable(),
@@ -13632,8 +13633,8 @@ var CommentEventPayloadSchema = object({
   ask_id: string2().nullish(),
   ask_question: string2().optional(),
   ask_state: _enum2(["open", "answered", "resolved"]).optional(),
-  ask_waiting_on: _enum2(["human", "agent"]).optional(),
-  turn: _enum2(["human", "agent"]).nullish(),
+  ask_waiting_on: _enum2(ASK_TURNS).optional(),
+  turn: _enum2(ASK_TURNS).nullish(),
   anchor: object({ block_id: string2().nullable().optional(), quote: string2().optional() }).nullish(),
   suggestion: object({ replace_with: string2().optional() }).nullish(),
   author: object({ kind: string2(), id: string2() }).optional(),
@@ -13756,16 +13757,14 @@ function documentOwnerValidation(requireArtifact, alwaysRequireArtifact = false)
     message: alwaysRequireArtifact ? "Exactly one of issue and project is required; artifact or ref must name the document." : "Exactly one of issue and project is required; with project, artifact names the document."
   };
 }
-var commentValidation = (() => {
-  const owner = documentOwnerValidation(true);
-  return {
-    check: (value) => {
-      const input = value;
-      return owner.check(value) && (input.turn === undefined || typeof input.reply_to_ask === "string");
-    },
-    message: `${owner.message} turn requires reply_to_ask.`
-  };
-})();
+var commentOwner = documentOwnerValidation(true);
+var commentValidation = {
+  check: (value) => {
+    const input = value;
+    return commentOwner.check(value) && (input.turn === undefined || typeof input.reply_to_ask === "string");
+  },
+  message: `${commentOwner.message} turn requires reply_to_ask.`
+};
 var ISSUE_COMPONENTS_MODES = ["inherit", "explicit", "none"];
 function componentsArgument(z) {
   return z.object({
@@ -13787,6 +13786,7 @@ var SPEC_SECTIONS = [
 ];
 var SPEC_WRITING_GUIDANCE = `When writing a spec, use these sections in order: ${SPEC_SECTIONS.join(", ")}. ` + "Write for a reader who has not seen the code: plain sentences, every identifier expanded on " + "first use, no coined shorthand; see skills/dispatch Writing for the human and Writing a spec.";
 var ASK_URGENCIES = ["low", "med", "high", "blocking"];
+var ASK_QUESTION_MAX = 800;
 var ISSUE_STATUSES = [
   "triage",
   "icebox",
@@ -13840,13 +13840,13 @@ var dispatchToolSpecs = [
   },
   {
     name: "dispatch_ask",
-    description: "Open a durable, answerable decision on an issue or project document. Do not use it for a status update or discussion; " + "use dispatch_message instead. A to-do a human must complete is a question phrased as that to-do, with the options you want (for example Done / Can't). " + "Anchor a document question, thread reply_to/reply_to_ask, or cite a dispatch:// " + 'reference \u2014 it must be answerable from its own text and anchor alone, never "see above". A quote anchor is pinned to its block. Question is at most 800 ' + `characters and has at most 8 options. ${OWNER_REFERENCE}`,
+    description: "Open a durable, answerable decision on an issue or project document. Do not use it for a status update or discussion; " + "use dispatch_message instead. A to-do a human must complete is a question phrased as that to-do, with the options you want (for example Done / Can't). " + "Anchor a document question, thread reply_to/reply_to_ask, or cite a dispatch:// " + `reference \u2014 it must be answerable from its own text and anchor alone, never "see above". A quote anchor is pinned to its block. Question is at most ${ASK_QUESTION_MAX} ` + `characters and has at most 8 options. ${OWNER_REFERENCE}`,
     arguments: (z) => ({
       issue: z.string().describe(ISSUE_REFERENCE).optional(),
       project: z.string().describe("Project key owning the document.").optional(),
       artifact: z.string().describe("Project document artifact id, slug, or filename.").optional(),
       ref: z.string().describe("Optional dispatch:// reference (issue, document, message, or ask); appended to the question and rendered as a link.").optional(),
-      question: z.string({ max: 800 }).describe("Decision question, at most 800 characters."),
+      question: z.string({ max: ASK_QUESTION_MAX }).describe(`Decision question, at most ${ASK_QUESTION_MAX} characters.`),
       options: z.array(z.object({
         label: z.string().describe("Selectable option label."),
         description: z.string().describe("Optional option context.").optional()
@@ -13866,7 +13866,7 @@ var dispatchToolSpecs = [
     description: "Edit an open question in place. Use it to correct or refine the same decision; retract the " + "old ask and open a new one when the decision itself changes. Previous text remains in the " + "event log. Only the asking session can edit it; answered or resolved asks cannot be edited.",
     arguments: (z) => ({
       ask: z.string().describe("Ask id to edit."),
-      question: z.string({ max: 800 }).describe("Replacement decision question, at most 800 characters.").optional(),
+      question: z.string({ max: ASK_QUESTION_MAX }).describe(`Replacement decision question, at most ${ASK_QUESTION_MAX} characters.`).optional(),
       options: z.array(z.object({
         label: z.string().describe("Selectable option label."),
         description: z.string().describe("Optional option context.").optional()
@@ -14700,9 +14700,9 @@ import { resolve as resolvePath } from "path";
 
 // ../envoy-client/src/ask-answer.ts
 var HEAD_LENGTH = 120;
-function textHead(text, limit = HEAD_LENGTH) {
+function textHead(text) {
   const flat = text.replace(/\s+/g, " ").trim();
-  return flat.length > limit ? `${flat.slice(0, limit)}\u2026` : flat;
+  return flat.length > HEAD_LENGTH ? `${flat.slice(0, HEAD_LENGTH)}\u2026` : flat;
 }
 function askAnswerText(answer) {
   if (answer === null || answer === undefined)
@@ -15126,6 +15126,29 @@ class DispatchClient {
   }
 }
 
+// ../envoy-client/src/dispatch-owner.ts
+function documentLabel(project, slug) {
+  return `${project}/${slug}`;
+}
+function issueTopic(key) {
+  return { label: key, topic: dispatchIssueSubject(key, ">") };
+}
+function documentTopicOf(project, slug) {
+  return {
+    label: documentLabel(project, slug),
+    topic: dispatchDocumentSubject(project, slug, ">")
+  };
+}
+function dispatchIssueRef(key) {
+  return `dispatch://${key}`;
+}
+function dispatchDocumentRef(owner, slug) {
+  return `dispatch://${owner}/artifact/${slug}`;
+}
+function dispatchChildRef(ownerRef, kind, id) {
+  return `${ownerRef}/${kind}/${id}`;
+}
+
 // ../envoy-client/src/tool-input-errors.ts
 class ToolInputError extends Error {
   tool;
@@ -15237,14 +15260,8 @@ function formatZodIssues(issues, schema) {
 }
 
 // ../envoy-client/src/dispatch-execute.ts
-function issueTopic(key) {
-  return { label: key, topic: dispatchIssueSubject(key, ">") };
-}
 function documentTopic(artifact) {
-  return {
-    label: `${artifact.project}/${artifact.slug}`,
-    topic: dispatchDocumentSubject(artifact.project, artifact.slug, ">")
-  };
+  return documentTopicOf(artifact.project, artifact.slug);
 }
 function resolvedTopic(resolved) {
   if (resolved.owner.kind === "project")
@@ -15263,7 +15280,7 @@ function documentResultDetails(artifact) {
   return {
     project: artifact.project,
     artifact: artifact.id,
-    document: `${artifact.project}/${artifact.slug}`
+    document: documentLabel(artifact.project, artifact.slug)
   };
 }
 function writeResultDetails(resolved, fields) {
@@ -15274,15 +15291,15 @@ function writeResultDetails(resolved, fields) {
     throw new Error("issue document is missing its issue");
   return { issue: resolved.issue.key, ...fields };
 }
-async function askOwnerDetails(client, ask, resolved) {
+async function askOwnerDetails(client, ask, artifact) {
   if (ask.issue_key !== null) {
     return { issue: ask.issue_key, ask: ask.id };
   }
   if (ask.artifact_id === undefined || ask.artifact_id === null) {
     throw new Error("document ask is missing its artifact ID");
   }
-  const artifact = resolved?.artifact ?? await client.getArtifact(ask.artifact_id);
-  return { ...documentResultDetails(artifact), ask: ask.id };
+  const owner = artifact ?? await client.getArtifact(ask.artifact_id);
+  return { ...documentResultDetails(owner), ask: ask.id };
 }
 async function commentOwnerResult(client, comment, artifact) {
   if (comment.issue_key !== null) {
@@ -15293,12 +15310,12 @@ async function commentOwnerResult(client, comment, artifact) {
   }
   const owner = artifact ?? await client.getArtifact(comment.artifact_id);
   return {
-    label: documentTopic(owner).label,
+    label: documentLabel(owner.project, owner.slug),
     details: { ...documentResultDetails(owner), comment: comment.id }
   };
 }
-async function followedAskDetails(client, ask, resolved) {
-  return { ...await askOwnerDetails(client, ask, resolved), follows: { ask: ask.id } };
+async function followedAskDetails(client, ask, artifact) {
+  return { ...await askOwnerDetails(client, ask, artifact), follows: { ask: ask.id } };
 }
 var nativeIssueKeyPattern = /^[A-Z][A-Z0-9]{1,9}-[0-9]+$/;
 var externalIssueRefPattern = /^([^/\s]+)\/([^/\s#]+)#([1-9][0-9]*)$/;
@@ -15373,7 +15390,7 @@ function searchResultLine(result, baseUrl) {
   const href = new URL(result.href, baseUrl).toString();
   const { owner } = result;
   if (owner.kind === "document") {
-    const reference = `dispatch://${owner.project}/artifact/${owner.slug}`;
+    const reference = dispatchDocumentRef(owner.project, owner.slug);
     return `${reference} [document] ${owner.name} - ${result.kind}: ${snippetText(result.snippet)} -> ${href}`;
   }
   const artifactName = result.artifact ? ` ${result.artifact.name}` : "";
@@ -15384,7 +15401,6 @@ function askUrgency(args) {
   const value = args.urgency;
   return ASK_URGENCIES.find((urgency) => urgency === value);
 }
-var maxAskQuestion16 = 800;
 function questionWithRef(question, ref) {
   return ref === undefined || question.includes(ref) ? question : `${question}
 
@@ -15394,7 +15410,7 @@ function askQuestionWithRef(args) {
   return questionWithRef(stringArg(args, "question"), optionalString(args, "ref"));
 }
 function askQuestionProblem(withRef) {
-  return withRef.length > maxAskQuestion16 ? `question plus ref ${overCapMessage(withRef.length, maxAskQuestion16)}; shorten the question or drop the ref` : undefined;
+  return withRef.length > ASK_QUESTION_MAX ? `question plus ref ${overCapMessage(withRef.length, ASK_QUESTION_MAX)}; shorten the question or drop the ref` : undefined;
 }
 function parseDispatchRef(ref) {
   const projectDocument = ref.match(/^dispatch:\/\/([A-Z][A-Z0-9]{1,9})\/artifact\/([^/@]+)(?:@v(\d+))?(?:\/(ask|comment)\/([^/]+))?$/);
@@ -15449,6 +15465,10 @@ function parseDispatchRef(ref) {
     return { owner, kind: "message", id: message };
   return { owner, kind: "issue", id: issue };
 }
+function refTarget(ref, kind, id) {
+  const ownerRef = ref.owner.kind === "issue" ? dispatchIssueRef(ref.owner.issue) : dispatchDocumentRef(ref.owner.project, `${ref.artifact}`);
+  return dispatchChildRef(ownerRef, kind, id);
+}
 var uuidPattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 var askIdProblem = "ask must be a bare ask id or a dispatch://.../ask/<id> reference";
 var commentIdProblem = "comment must be a bare comment id or a dispatch://.../comment/<id> reference";
@@ -15492,7 +15512,7 @@ function argumentProblems(tool, args) {
     case "dispatch_ask": {
       const question = optionalString(args, "question");
       const ref = optionalString(args, "ref");
-      if (question !== undefined && ref !== undefined && question.length <= maxAskQuestion16) {
+      if (question !== undefined && ref !== undefined && question.length <= ASK_QUESTION_MAX) {
         const problem = askQuestionProblem(questionWithRef(question, ref));
         if (problem !== undefined)
           problems.push(problem);
@@ -15582,11 +15602,17 @@ function dispatchRefFromUrl(value, serverUrl) {
 }
 var refGrammarProblem = "ref must be a valid dispatch:// reference such as dispatch://KEY-1, " + "dispatch://KEY-1/ask/<uuid>, dispatch://KEY-1/comment/<uuid>, " + "dispatch://KEY-1/message/<uuid>, dispatch://KEY-1/artifact/<slug>, or " + "dispatch://PROJECT/artifact/<document-ref> (an artifact id, slug, or filename); " + "a dashboard URL on this Dispatch server is accepted too";
 var ownerRequiredProblem = "issue is required; supply issue or set LEGION_ISSUE";
+var toolSchemas = new Map;
 function toolSchema(tool) {
+  const cached = toolSchemas.get(tool);
+  if (cached !== undefined)
+    return cached;
   const spec = dispatchToolSpecs.find((candidate) => candidate.name === tool);
   if (!spec)
     throw new Error(`Unknown Dispatch tool: ${tool}`);
-  return dispatchToolSchema(spec, zodSchemaApi(exports_external), { strict: true });
+  const schema = dispatchToolSchema(spec, zodSchemaApi(exports_external), { strict: true });
+  toolSchemas.set(tool, schema);
+  return schema;
 }
 async function resolveOwnerArguments(tool, input, cwd, env, exec, serverUrl, problems) {
   if (issueFreeTools[tool] === true)
@@ -15794,11 +15820,21 @@ function referenceLines(edges) {
     return `- ${edge.kind} ${edge.node.kind} ${edge.node.ref ?? edge.node.id} (${excerpt}${edge.created_at})`;
   });
 }
+function unavailableReason(error) {
+  return error instanceof DispatchServiceError && error.status === 404 ? "unavailable" : `unavailable: ${messageFor(error)}`;
+}
 async function graphEdges(client, query) {
   try {
     return (await client.getReferences(query)).edges;
   } catch (error) {
-    return error instanceof DispatchServiceError && error.status === 404 ? "unavailable" : `unavailable: ${error instanceof Error ? error.message : String(error)}`;
+    return unavailableReason(error);
+  }
+}
+async function issueReferencesOrUnavailable(client, key) {
+  try {
+    return await client.getIssueReferences(key);
+  } catch (error) {
+    return unavailableReason(error);
   }
 }
 async function graphSections(client, ref) {
@@ -16008,8 +16044,9 @@ async function executeDispatchTool(input) {
   problems.push(...argumentProblems(input.tool, ownerArguments.args));
   if (problems.length > 0)
     throw new ToolInputError(input.tool, problems);
+  const dispatchClient = () => new DispatchClient(configUrl, configToken, fetchImpl, input.signal);
   if (input.tool === "dispatch_open_asks") {
-    const client = new DispatchClient(configUrl, configToken, fetchImpl, input.signal);
+    const client = dispatchClient();
     const project = optionalString(ownerArguments.args, "project");
     if (project !== undefined) {
       const response = await client.openAsksForProject(project);
@@ -16025,7 +16062,7 @@ async function executeDispatchTool(input) {
     const sessionId = input.sessionId?.trim();
     if (!sessionId)
       throw new Error("host session id is required for dispatch_whoami");
-    const client = new DispatchClient(configUrl, configToken, fetchImpl, input.signal);
+    const client = dispatchClient();
     const identity = await client.whoami();
     const owner = identity.kind === "agent" ? identity.owner : identity.login.toLowerCase();
     return {
@@ -16035,7 +16072,7 @@ async function executeDispatchTool(input) {
   }
   const args = parsed.success ? parsed.data : ownerArguments.args;
   const actor = toolActor(await resolveOrigin(env, exec, input.cwd), input);
-  const client = new DispatchClient(configUrl, configToken, fetchImpl, input.signal);
+  const client = dispatchClient();
   const owner = ownerArguments.owner?.kind === "issue" ? {
     kind: "issue",
     issue: await ensureIssue(client, ownerArguments.owner.issue, actor)
@@ -16274,7 +16311,7 @@ async function executeDispatchTool(input) {
       return {
         text: `Asked ${ask.id} on ${askOwner.label} (urgency ${ask.urgency}): ${ask.question}
 ${followsAsk(askOwner)}`,
-        details: await followedAskDetails(client, ask, resolved)
+        details: await followedAskDetails(client, ask, resolved?.artifact)
       };
     }
     case "dispatch_edit_ask": {
@@ -16356,7 +16393,7 @@ ${followsAsk(askOwner)}`,
         ...inReplyTo === undefined ? {} : { in_reply_to: inReplyTo },
         actor
       });
-      const messageRef = `dispatch://${issueKey}/message/${message.id}`;
+      const messageRef = dispatchChildRef(dispatchIssueRef(issueKey), "message", message.id);
       return {
         text: `Posted message ${message.id} (${messageRef}) ${notSubscribed(issueTopic(issueKey))}`,
         details: { issue: issueKey, message: message.id }
@@ -16418,7 +16455,7 @@ ${trailer.join(`
           }
         };
       }
-      const details = await followedAskDetails(client, result.ask, resolved);
+      const details = await followedAskDetails(client, result.ask, resolved.artifact);
       return {
         text: `Approval requested for ${resolved.artifact.name} (document id ${resolved.artifact.id}) at version ${result.version} (ask ${result.ask.id}). The answer arrives as artifact.approved or artifact.changes_requested; an edit after approval makes it stale, so request again for the new version.`,
         details: { ...details, artifact: resolved.artifact.id, version: result.version }
@@ -16441,7 +16478,7 @@ ${trailer.join(`
       };
       const artifactOwner = documentOwner();
       const result = artifactOwner.kind === "project" ? await client.projectArtifact(artifactOwner.project, artifactInput) : await client.artifact(issue(), artifactInput);
-      const artifactRef = artifactOwner.kind === "project" ? `dispatch://${artifactOwner.project}/artifact/${result.artifact.slug}` : `dispatch://${issue()}/artifact/${result.artifact.slug}`;
+      const artifactRef = dispatchDocumentRef(artifactOwner.kind === "project" ? artifactOwner.project : issue(), result.artifact.slug);
       const uploadOwner = artifactOwner.kind === "project" ? documentTopic(result.artifact) : issueTopic(issue());
       return {
         text: `Uploaded ${result.artifact.name} as version ${result.version.number} (artifact slug ${result.artifact.slug}; ${artifactRef}) ${notSubscribed(uploadOwner)}`,
@@ -16477,7 +16514,7 @@ ${trailer.join(`
         const ref = ownerArguments.ref;
         const id = await resolveIdPrefix(input.tool, "ask", ref, async () => ref.owner.kind === "issue" ? client.listIssueAsks(ref.owner.issue) : client.getArtifactAsks((await resolveArtifact(client, ref.owner, ref.artifact)).artifact.id, "all"));
         const askRead = await client.getAsk(id);
-        const askRef = ref.owner.kind === "issue" ? `dispatch://${ref.owner.issue}/ask/${id}` : `dispatch://${ref.owner.project}/artifact/${ref.artifact}/ask/${id}`;
+        const askRef = refTarget(ref, "ask", id);
         return {
           text: askSummary(askRead, await graphSections(client, askRef)),
           details: ref.owner.kind === "project" ? { project: ref.owner.project } : { issue: ref.owner.issue }
@@ -16487,7 +16524,7 @@ ${trailer.join(`
         const ref = ownerArguments.ref;
         const id = await resolveIdPrefix(input.tool, "comment", ref, async () => ref.owner.kind === "issue" ? client.getComments(ref.owner.issue) : client.getArtifactComments((await resolveArtifact(client, ref.owner, ref.artifact)).artifact.id));
         const comment = await client.getComment(id);
-        const commentRef = ref.owner.kind === "issue" ? `dispatch://${ref.owner.issue}/comment/${id}` : `dispatch://${ref.owner.project}/artifact/${ref.artifact}/comment/${id}`;
+        const commentRef = refTarget(ref, "comment", id);
         return {
           text: commentSummary(comment, await graphSections(client, commentRef)),
           details: ref.owner.kind === "project" ? { project: ref.owner.project } : { issue: comment.comment.issue_key }
@@ -16498,7 +16535,7 @@ ${trailer.join(`
           throw new Error("message references are issue-scoped");
         }
         const messageRead = await client.getMessage(ownerArguments.ref.owner.issue, ownerArguments.ref.id);
-        const messageRef = `dispatch://${ownerArguments.ref.owner.issue}/message/${ownerArguments.ref.id}`;
+        const messageRef = dispatchChildRef(dispatchIssueRef(ownerArguments.ref.owner.issue), "message", ownerArguments.ref.id);
         return {
           text: messageSummary(messageRead, await graphSections(client, messageRef)),
           details: { issue: messageRead.message.issue_key }
@@ -16506,7 +16543,7 @@ ${trailer.join(`
       }
       if (documentOwner().kind === "project") {
         const resolved = await resolveArtifact(client, documentOwner(), stringArg(args, "artifact"));
-        const documentRef = `dispatch://${resolved.artifact.project}/artifact/${resolved.artifact.slug}`;
+        const documentRef = dispatchDocumentRef(resolved.artifact.project, resolved.artifact.slug);
         return {
           text: [
             `Document: ${resolved.artifact.project} / ${resolved.artifact.name}`,
@@ -16518,7 +16555,7 @@ ${trailer.join(`
 `),
           details: {
             project: resolved.artifact.project,
-            document: `${resolved.artifact.project}/${resolved.artifact.slug}`
+            document: documentLabel(resolved.artifact.project, resolved.artifact.slug)
           }
         };
       }
@@ -16535,14 +16572,12 @@ ${trailer.join(`
           details: { issue: read.issue.key }
         };
       }
-      let references;
-      try {
-        references = await client.getIssueReferences(read.issue.key);
-      } catch (error) {
-        references = error instanceof DispatchServiceError && error.status === 404 ? "unavailable" : `unavailable: ${error instanceof Error ? error.message : String(error)}`;
-      }
+      const [references, graph] = await Promise.all([
+        issueReferencesOrUnavailable(client, read.issue.key),
+        graphSections(client, dispatchIssueRef(read.issue.key))
+      ]);
       return {
-        text: issueSummary(read.issue, read.events, references, await graphSections(client, `dispatch://${read.issue.key}`)),
+        text: issueSummary(read.issue, read.events, references, graph),
         details: { issue: read.issue.key }
       };
     }
@@ -16685,6 +16720,7 @@ var envoyToolSpecs = [
     requiresSubscriptionCapability: false
   }
 ];
+var envoyToolSchemas = new Map;
 
 // ../envoy-client/src/transport.ts
 var DEFAULT_TIMEOUT_MS = 5000;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sjawhar/opencode-legion-envoy",
-  "version": "1.38.0",
+  "version": "1.38.1",
   "type": "module",
   "main": "dist/src/server.js",
   "exports": {

package/skills/dispatch/SKILL.md

@@ -30,6 +30,8 @@ vocabulary, and is often on a phone. Write for that person.
   what each costs, and your recommendation with its reason.
 - Before posting, test it: could Sami, reading only this text on his phone, know what he is being
   told or asked? If not, rewrite it. Length is not the problem; density is.
+- When an ask or message communicates a judgment, lead with that judgment in one sentence and put the mechanism underneath it. Do not make the reader ask a second time whether the result is a win. This shapes communication only when a judgment exists; it does not pre-decide an open question or remove its genuine options. Inferred from the AGENTC-186 12-hour-cap incident (platform PO, 2026-09-17).
+- When a Dispatch message states a root cause, include the reproducing command or test in that same message. Without it, label the diagnosis a hypothesis; a diagnosis still in progress may say so plainly. This boundary applies to causal claims, not to reporting that an investigation has started. Inferred from the astro lane's 2026-09-16 retro (platform PO, 2026-09-17).
 
 ## Agent authentication
 
@@ -267,6 +269,8 @@ It returns the imported commit, or the recorded error when the model was rejecte
 
 Before saying you are waiting for human input, call `dispatch_open_asks`. With no arguments it lists this session's active asks across open issues and project documents, including whether the human or agent owes the next reply. With `dispatch_open_asks({ project })` it lists every open ask in that project — on its issues and on its documents, whoever authored them — which is how you audit what a whole project is waiting on rather than just your own asks.
 
+**Unsettled product shape needs a decision before implementation.** When a page, navigation entry, table key, customer-scoping rule, or persisted sidecar would set product shape that Sami has not already settled, send a one-line ask before the first implementation commit. A platform-PO schema or contract ruling does not settle product shape. This does not turn a user-specified decision or routine implementation into an approval request; it is inferred from AGENTC-186's 2026-09-16 retro (platform PO, 2026-09-17).
+
 **Anything that needs the human is an ask, or it does not exist.** An approval, a credential,
 a setting only they can change, a review click, a conflict between two of their own rules - if
 your work waits on it, open a `dispatch_ask` the moment you know, the action as the question.