@sjawhar/opencode-legion-envoy 1.10.0 → 1.11.0

package/dist/src/server.js

@@ -13740,7 +13740,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 DOC_EDIT_OPS = ["replace", "delete", "insert"];
+var DOC_EDIT_OPS = ["replace", "delete", "insert", "retype"];
 var dispatchToolSpecs = [
   {
     name: "dispatch_issue",
@@ -13850,7 +13850,7 @@ var dispatchToolSpecs = [
   },
   {
     name: "dispatch_doc_edit",
-    description: "Apply deterministic text edits to an issue or project document. Do not use it for review feedback or for reading; use " + "dispatch_comment, dispatch_suggest, or dispatch_doc_read instead. The spec (or any document) holds requirements, " + `design, and decisions - never progress, status, or timestamps. ${OWNER_REFERENCE} ${SPEC_WRITING_GUIDANCE}`,
+    description: "Apply deterministic document edits, including retyping an identified paragraph into a schema-declared typed block. " + "Do not use it for review feedback or for reading; use dispatch_comment, dispatch_suggest, or dispatch_doc_read instead. " + `The spec (or any document) holds requirements, design, and decisions - never progress, status, or timestamps. ${OWNER_REFERENCE} ${SPEC_WRITING_GUIDANCE}`,
     arguments: (z) => ({
       issue: z.string().describe(ISSUE_REFERENCE).optional(),
       project: z.string().describe("Project key owning the document.").optional(),
@@ -13863,7 +13863,10 @@ var dispatchToolSpecs = [
         occurrence: z.number({ int: true, min: 0 }).describe("Optional zero-based match occurrence.").optional(),
         markdown: z.string().describe("Markdown to insert.").optional(),
         after: z.string().describe("Anchor after which to insert.").optional(),
-        before: z.string().describe("Anchor before which to insert.").optional()
+        before: z.string().describe("Anchor before which to insert.").optional(),
+        block: z.string().describe("Block id to retype.").optional(),
+        type: z.string().describe("Typed block name for retype.").optional(),
+        attributes: z.unknown().describe("Typed block attributes for retype.").optional()
       })).describe("Flat tagged edits; the server validates fields required for each operation."),
       summary: z.string().describe("Optional named-version summary.").optional()
     }),
@@ -14307,6 +14310,7 @@ function zodSchemaApi(zod) {
     },
     boolean: () => api.boolean(),
     enum: (values) => api.enum(values),
+    unknown: () => api.unknown(),
     array: (item, opts = {}) => {
       let schema = api.array(item);
       if (opts.min !== undefined)
@@ -15487,8 +15491,10 @@ async function executeDispatchTool(input) {
         ...summary === undefined ? {} : { summary },
         actor
       });
+      const retyped = ops.filter((operation) => operation.op === "retype").length;
+      const versionText = edited.version === null ? "no new version" : `version ${edited.version.number}`;
       return {
-        text: edited.version === null ? `Applied ${edited.applied} ops (no new version)` : `Applied ${edited.applied} ops (version ${edited.version.number})`,
+        text: retyped === 0 ? `Applied ${edited.applied} ops (${versionText})` : `Applied ${edited.applied} ops; retyped ${retyped} block${retyped === 1 ? "" : "s"} (${versionText})`,
         details: writeResultDetails(resolved, {
           applied: edited.applied,
           ...edited.version === null ? {} : { version: edited.version.number }

package/package.json

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

package/skills/dispatch/SKILL.md

@@ -199,13 +199,16 @@ exact `EditOp` shape:
 
 ```ts
 type EditOp = {
-  op: "replace" | "delete" | "insert";
+  op: "replace" | "delete" | "insert" | "retype";
   find?: string;
   with?: string;
   occurrence?: number;
   markdown?: string;
   after?: string;
   before?: string;
+  block?: string;
+  type?: string;
+  attributes?: Record<string, unknown>;
 };
 ```
 
@@ -221,6 +224,9 @@ and deleting a cell's quoted text removes only that text.
 
 Use `replace` for inline continuation. Use zero-based `occurrence` for a repeated target; re-read a missing or ambiguous target before
 retrying. Pass `summary` to name the version when recording a decision.
+`retype` turns the paragraph with `block` into the named typed `type` in place. It keeps the
+block id and uses `attributes` for client-owned typed attributes. Use it when an existing
+paragraph is the question that should become a decision.
 
 ## Typed blocks
 
@@ -236,6 +242,19 @@ quoted: `:::callout{kind="warning" title="Risk"}`. Do not write Pandoc-style `::
 block. Do not set attributes the schema marks `server: true`; the server ignores them and reasserts
 its authoritative value at settlement.
 
+Questions about a document must be `ask` blocks, never an `Open questions` prose section. An ask
+body is one or more question paragraphs followed by an optional bullet list of options, where each
+item is `Label: description`. For example:
+
+```md
+:::ask{urgency="high" multiple="false"}
+Should we ship the migration?
+
+- Ship: Release the verified change.
+- Hold: Wait for another review.
+:::
+```
+
 ## Comments and suggestions
 
 Add feedback with: