@zq-silk/yui 0.15.7 → 0.15.9

package/dist/cli/commandCatalog.js

@@ -1,4 +1,5 @@
 import { supportedAgentAdapterIds } from "../agent/adapterCatalog.js";
+import { supportedAgentExecutionComponentIds } from "../agent/executionComponents.js";
 import { CONFIG_DEFINITIONS, CONFIG_DOMAINS, configDefinitionsForDomain } from "../config/configCatalog.js";
 function buildNode(input, parentPath = []) {
     const path = [...parentPath, input.name];
@@ -101,10 +102,13 @@ function durableConfigDomainNode(domain) {
 const agentChildren = [
     {
         name: "add",
-        summary: "Add a configured native Agent CLI.",
-        usage: "yui config agent add <id> [--adapter <adapter>] --command <command> [--arg <arg> ...] [--env TARGET=PROCESS_NAME ...]",
-        options: ["--adapter", "--command", "--arg", "--env"],
-        optionValues: { "--adapter": supportedAgentAdapterIds() },
+        summary: "Add a configured Agent execution component.",
+        usage: "yui config agent add <id> [--component <component>] [--adapter <adapter>] --command <command> [--arg <arg> ...] [--env TARGET=PROCESS_NAME ...]",
+        options: ["--component", "--adapter", "--command", "--arg", "--env"],
+        optionValues: {
+            "--component": supportedAgentExecutionComponentIds(),
+            "--adapter": supportedAgentAdapterIds()
+        },
         executableOptions: ["--command"]
     },
     { name: "list", summary: "List configured Agents." },
@@ -117,9 +121,12 @@ const agentChildren = [
     {
         name: "update",
         summary: "Update a configured Agent.",
-        usage: "yui config agent update <id> [--adapter <adapter>] [--command <command>] [--arg <arg> ... | --clear-args] [--env TARGET=PROCESS_NAME ... | --clear-env]",
-        options: ["--adapter", "--command", "--arg", "--clear-args", "--env", "--clear-env", "--yes"],
-        optionValues: { "--adapter": supportedAgentAdapterIds() },
+        usage: "yui config agent update <id> [--component <component>] [--adapter <adapter>] [--command <command>] [--arg <arg> ... | --clear-args] [--env TARGET=PROCESS_NAME ... | --clear-env]",
+        options: ["--component", "--adapter", "--command", "--arg", "--clear-args", "--env", "--clear-env", "--yes"],
+        optionValues: {
+            "--component": supportedAgentExecutionComponentIds(),
+            "--adapter": supportedAgentAdapterIds()
+        },
         executableOptions: ["--command"]
     },
     { name: "remove", summary: "Remove a configured Agent.", usage: "yui config agent remove <id>" }
@@ -282,6 +289,35 @@ const taskChildren = [
         }
     },
     { name: "activate", summary: "Activate a Draft Task.", usage: "yui task activate <id>" },
+    {
+        name: "activation",
+        summary: "Request, cancel or inspect explicit Task Activation.",
+        sections: [{ id: "manage", title: "Commands", entries: ["request", "cancel", "show"] }],
+        children: [
+            {
+                name: "request",
+                summary: "Record an Activation request. empty adds no extra environment (bound Projects still get managed worktrees); scratch creates a Task directory; local requires a registered Resource and grant, not a Project ID.",
+                usage: "yui task activation request <task> --request-id <id> "
+                    + "--environment <empty|scratch|local:<resource>:<read|write>>",
+                options: ["--request-id", "--environment"],
+                examples: [
+                    "yui task activation request <task> --request-id start-1 --environment empty",
+                    "yui task activation request <gitless-task> --request-id start-1 --environment scratch"
+                ]
+            },
+            {
+                name: "cancel",
+                summary: "Cancel a pending Activation request so it is never adopted.",
+                usage: "yui task activation cancel <task> --request-id <id> --reason <text>",
+                options: ["--request-id", "--reason"]
+            },
+            {
+                name: "show",
+                summary: "Show the Task's Activation request and its disposition.",
+                usage: "yui task activation show <task>"
+            }
+        ]
+    },
     {
         name: "execution",
         summary: "Fence or resume all execution for a Task.",
@@ -303,8 +339,8 @@ const taskChildren = [
     {
         name: "complete",
         summary: "Complete an active Task and stop automatic wakeups.",
-        usage: "yui task complete <id> (--summary <text>|--summary-file <path|->) [--refresh-remote] [--accept-published-tree <publication-id>]",
-        options: ["--summary", "--summary-file", "--refresh-remote", "--accept-published-tree"],
+        usage: "yui task complete <id> (--summary <text>|--summary-file <path|->) [--artifact-ref <artifact-id|turn:id|url> ...] [--refresh-remote] [--accept-published-tree <publication-id>]",
+        options: ["--summary", "--summary-file", "--artifact-ref", "--refresh-remote", "--accept-published-tree"],
         fileOptions: ["--summary-file"]
     },
     {
@@ -320,7 +356,14 @@ const taskChildren = [
             }
         ]
     },
-    { name: "reopen", summary: "Reopen a completed Task.", usage: "yui task reopen <id>" },
+    { name: "reopen", summary: "Explicitly reopen completed or cancelled intent without replaying historical inputs.", usage: "yui task reopen <id>" },
+    {
+        name: "cancel",
+        summary: "Stop pursuing a Task without claiming its processes stopped.",
+        usage: "yui task cancel <task> (--summary <text>|--summary-file <path|->)",
+        options: ["--summary", "--summary-file"],
+        fileOptions: ["--summary-file"]
+    },
     {
         name: "retire",
         summary: "Retire a stale Task while preserving its historical evidence.",
@@ -335,10 +378,21 @@ const taskChildren = [
         options: ["--all", "--verbose"]
     },
     { name: "show", summary: "Show a Task.", usage: "yui task show <id>" },
+    {
+        name: "artifact",
+        summary: "Save Task files in local Git and read current or commit-pinned content.",
+        sections: [{ id: "manage", title: "Commands", entries: ["list", "read", "save"] }],
+        children: [
+            { name: "list", summary: "List saved Task artifacts.", usage: "yui task artifact list <task>" },
+            { name: "read", summary: "Read a file at HEAD or an exact commit.", usage: "yui task artifact read <task> <relative-path> [<commit>]" },
+            { name: "save", summary: "Save and locally commit one file.", usage: "yui task artifact save <task> <relative-path> <content> [--message <text>] [--expected-head <commit>]", options: ["--message", "--expected-head"] }
+        ]
+    },
     {
         name: "context",
-        summary: "Show consolidated working context for a Task.",
-        usage: "yui task context <task>"
+        summary: "Read compact authorized facts, fixed-bound delta, or inspect a Context reference.",
+        usage: "yui task context [read|delta|inspect] <task> [--after <cursor>] [--continuation <cursor>] [--limit <n>] [--store <store> --ref <id>] [--digest <digest>]",
+        options: ["--after", "--continuation", "--limit", "--store", "--ref", "--digest"]
     },
     {
         name: "next-action",
@@ -381,14 +435,21 @@ const taskChildren = [
     {
         name: "message",
         summary: "Manage durable Task messages.",
-        sections: [{ id: "manage", title: "Commands", entries: ["send", "list", "update", "retire"] }],
+        sections: [{ id: "manage", title: "Commands", entries: ["send", "handoff", "list", "show", "update", "retire"] }],
         children: [
+            {
+                name: "handoff",
+                summary: "Explicitly hand an unassigned Message to the current dispatched owner of the same work.",
+                usage: "yui task message handoff <task/message> --to <role>",
+                options: ["--to"]
+            },
             {
                 name: "send",
-                summary: "Send a Task message.",
-                usage: "yui task message send <id> (<body>|--body-file <path|->) [--wake-policy leader|none]",
-                options: ["--body-file", "--wake-policy"],
+                summary: "Send a Task message. An unaddressed user/operator message carries a submission intent (record|discuss|develop) and an optional idempotency key.",
+                usage: "yui task message send <id> (<body>|--body-file <path|->) [--intent record|discuss|develop] [--request-id <key>] [--wake-policy leader|none] [--to <role> --work-item <id>|--review-round <id>]",
+                options: ["--body-file", "--intent", "--request-id", "--wake-policy", "--to", "--work-item", "--review-round"],
                 optionValues: {
+                    "--intent": ["record", "discuss", "develop"],
                     "--wake-policy": ["leader", "none"]
                 },
                 fileOptions: ["--body-file"]
@@ -399,6 +460,11 @@ const taskChildren = [
                 usage: "yui task message list <id> [--after <timestamp>] [--limit <n>]",
                 options: ["--after", "--limit"]
             },
+            {
+                name: "show",
+                summary: "Read a scoped Message and expand its single execution result.",
+                usage: "yui task message show <task>/<message>"
+            },
             {
                 name: "update",
                 summary: "Replace the mutable body and wake policy of a Draft user/operator Message.",
@@ -424,7 +490,7 @@ const taskChildren = [
         children: [
             {
                 name: "request",
-                summary: "Pause the active Leader Turn and request user input.",
+                summary: "Pause the active Leader AgentRun and request user input.",
                 usage: "yui task input request <task> --question <text> [--choice <key=label> ...] [--blocks <work-item:id|turn:id> ...] [--recommend <key> --timeout-seconds <seconds>]",
                 options: ["--question", "--choice", "--blocks", "--recommend", "--timeout-seconds"]
             },
@@ -576,8 +642,8 @@ const taskChildren = [
             {
                 name: "update",
                 summary: "Update a Task Role; Agent settings target the named or active binding without switching it.",
-                usage: "yui task role update <task> <role> [--profile <id>] [--agent <id>] [Role and Agent settings]",
-                options: ["--profile", "--agent", ...roleProfileOptions, ...roleAgentOptions,
+                usage: "yui task role update <task> <role> [--profile <id>] [--agent <id>] [--environment <preparation-id> | --managed-environment] [Role and Agent settings]",
+                options: ["--profile", "--agent", "--environment", "--managed-environment", ...roleProfileOptions, ...roleAgentOptions,
                     ...roleProfileClearOptions, ...roleAgentClearOptions, "--yes"],
                 optionValues: roleAgentOptionValues
             },
@@ -586,20 +652,26 @@ const taskChildren = [
             { name: "unbind", summary: "Unbind a dormant Agent from a Task Role.", usage: "yui task role unbind <task> <role> <agent-id>" },
             {
                 name: "session",
-                summary: "Inspect or stop one Task Role's native Session.",
+                summary: "Inspect, stop or explicitly select a new Task Role Session.",
                 executable: true,
-                sections: [{ id: "manage", title: "Commands", entries: ["inspect", "stop"] }],
+                sections: [{ id: "manage", title: "Commands", entries: ["inspect", "stop", "new"] }],
                 children: [
                     {
                         name: "inspect",
-                        summary: "Read the current Session, Host activation, and Turn facts.",
+                        summary: "Read the current Session, Host process, and AgentRun facts.",
                         usage: "yui task role session inspect <task> <role>"
                     },
                     {
                         name: "stop",
-                        summary: "Stop one idle Session and its exact Host activation.",
+                        summary: "Stop the exact Session execution and retain its conversation for possible reuse; preserve Task progress.",
                         usage: "yui task role session stop <task> <role> --reason <text>",
                         options: ["--reason"]
+                    },
+                    {
+                        name: "new",
+                        summary: "Request replacement even for active or ended Sessions; stop exact execution and preserve Task context, results and workspaces.",
+                        usage: "yui task role session new <task> <role> --reason <text>",
+                        options: ["--reason"]
                     }
                 ]
             },
@@ -627,7 +699,7 @@ const taskChildren = [
                 id: "manage",
                 title: "Commands",
                 entries: [
-                    "create", "list", "show", "edit", "update", "scope", "dispatch", "isolate", "capture", "cleanup",
+                    "create", "list", "show", "edit", "update", "scope", "dispatch", "synthesize", "isolate", "capture", "cleanup",
                     "review", "accept", "reject", "retire"
                 ]
             }],
@@ -642,7 +714,7 @@ const taskChildren = [
             { name: "show", summary: "Show one Work Item.", usage: "yui task work show <work>" },
             {
                 name: "edit",
-                summary: "Replace mutable definition fields on an execution-free Draft WorkItem.",
+                summary: "Edit current requirements without changing frozen Assignments or acceptance.",
                 usage: "yui task work edit <task>/<work> [--title <text>] [--objective <text>] [--accept <criterion> ...|--clear-acceptance] [--after <work> ...|--clear-dependencies] [--project <project> ...|--clear-projects] [--base-ref <project>=<ref> ...|--clear-base-refs] [--role <name>|--clear-role]",
                 options: [
                     "--title", "--objective", "--accept", "--clear-acceptance",
@@ -652,9 +724,9 @@ const taskChildren = [
             },
             {
                 name: "update",
-                summary: "Update a work item's state.",
-                usage: "yui task work update <task>/<work> <todo|running|done|failed> [--summary <text>]",
-                options: ["--summary"],
+                summary: "Record progress or submit a Candidate; acceptance remains explicit.",
+                usage: "yui task work update <task>/<work> <todo|running|done|failed> [--summary <text>] [--artifact-ref <artifact-id> ...]",
+                options: ["--summary", "--artifact-ref"],
                 argumentValues: {
                     1: ["todo", "running", "done", "failed"]
                 }
@@ -671,6 +743,12 @@ const taskChildren = [
                 usage: "yui task work dispatch <task>/<work> [--input <text>] [--lane-role <role> ...]",
                 options: ["--input", "--lane-role"]
             },
+            {
+                name: "synthesize",
+                summary: "Dispatch synthesis over explicitly selected original Producer AgentRuns.",
+                usage: "yui task work synthesize <task>/<work> --source-run <task>/<run> ...",
+                options: ["--source-run"]
+            },
             {
                 name: "isolate",
                 summary: "Create a WorkItem-owned isolated worktree.",
@@ -700,7 +778,7 @@ const taskChildren = [
                 children: [
                     {
                         name: "retry",
-                        summary: "Retry a failed Task-final ReviewRound that has no Reviewer Turn.",
+                        summary: "Retry a failed Task-final ReviewRound that has no Reviewer AgentRun.",
                         usage: "yui task work review retry <task>/<review-round>"
                     },
                     {
@@ -718,87 +796,93 @@ const taskChildren = [
             {
                 name: "accept",
                 summary: "Accept a successful, validated, integrated Work Item.",
-                usage: "yui task work accept <task>/<work> --summary <text>",
-                options: ["--summary"]
+                usage: "yui task work accept <task>/<work> --summary <text> [--candidate <id>]",
+                options: ["--summary", "--candidate"]
             },
             {
                 name: "reject",
-                summary: "Reject an awaiting Work Item so it can be retried.",
+                summary: "Decline a result or withdraw acceptance while preserving its history.",
                 usage: "yui task work reject <task>/<work> --summary <text>",
                 options: ["--summary"]
             },
             {
                 name: "retire",
-                summary: "Retire a WorkItem and settle its exact Turns.",
+                summary: "Retire a WorkItem and settle its exact AgentRuns.",
                 usage: "yui task work retire <work> --summary <text> [--replacement <work>]",
                 options: ["--summary", "--replacement"]
             }
         ]
     },
     {
-        name: "turn",
-        summary: "Inspect and control Task Role Turns.",
+        name: "run",
+        summary: "Inspect and control Task Role AgentRuns.",
         sections: [{ id: "manage", title: "Commands", entries: ["list", "show", "retry", "settle", "context", "checkpoint", "retire"] }],
         children: [
-            { name: "list", summary: "List all Turns for a Task or one WorkItem.", usage: "yui task turn list <task|task/work>" },
+            { name: "list", summary: "List all AgentRuns for a Task or one WorkItem.", usage: "yui task run list <task|task/work>" },
             {
                 name: "show",
-                summary: "Show one Turn and its retained audit evidence.",
-                usage: "yui task turn show <task>/<turn> [--json]"
+                summary: "Show one AgentRun and its retained audit evidence.",
+                usage: "yui task run show <task>/<run> [--json]"
             },
             {
                 name: "retry",
-                summary: "Retry an exact failed execution or review Turn while preserving its semantic unit.",
-                usage: "yui task turn retry <task>/<turn>"
+                summary: "Retry an exact failed execution or review AgentRun while preserving its semantic unit.",
+                usage: "yui task run retry <task>/<run>"
             },
             {
                 name: "settle",
-                summary: "Explicitly settle a failed WorkItem Lane or an obsolete stranded final Review Turn.",
-                usage: "yui task turn settle <task>/<turn>"
+                summary: "Explicitly settle a failed WorkItem Lane or an obsolete stranded final Review AgentRun.",
+                usage: "yui task run settle <task>/<run>"
             },
             {
                 name: "context",
-                summary: "Load the exact authorized Turn context.",
-                usage: "yui task turn context <task>/<turn> [--json]",
+                summary: "Load the exact authorized AgentRun context.",
+                usage: "yui task run context <task>/<run> [--json]",
                 executable: true,
                 hidden: true,
                 sections: [{ id: "load", title: "Commands", entries: ["expand", "delta"] }],
                 children: [
                     {
                         name: "expand",
-                        summary: "Expand one authorized Turn context reference.",
-                        usage: "yui task turn context expand <task>/<turn> <ref-id> [--store <store>] [--mode full]",
+                        summary: "Expand one authorized AgentRun context reference.",
+                        usage: "yui task run context expand <task>/<run> <ref-id> [--store <store>] [--mode full]",
                         options: ["--store", "--mode"]
                     },
                     {
                         name: "delta",
-                        summary: "Load authorized Turn context changes after a cursor.",
-                        usage: "yui task turn context delta <task>/<turn> --after <cursor>",
+                        summary: "Load authorized AgentRun context changes after a cursor.",
+                        usage: "yui task run context delta <task>/<run> --after <cursor>",
                         options: ["--after"]
                     }
                 ]
             },
             {
                 name: "checkpoint",
-                summary: "Record durable progress for a long-running Turn.",
-                usage: "yui task turn checkpoint <turn> (--note <text>|--note-file <path|->)",
+                summary: "Record durable progress for a long-running AgentRun.",
+                usage: "yui task run checkpoint <run> (--note <text>|--note-file <path|->)",
                 options: ["--note", "--note-file"],
                 fileOptions: ["--note-file"],
                 hidden: true
             },
             {
                 name: "retire",
-                summary: "Retire an incorrect historical Turn without deleting its audit record.",
-                usage: "yui task turn retire <task>/<turn> --reason <text> [--expected-progress-at <timestamp>] [--agent-id <id>] [--adapter-id <id>] [--native-session-id <id>] [--launch-id <id>]",
-                options: ["--reason", "--expected-progress-at", "--progress-at", "--agent-id", "--adapter-id", "--native-session-id", "--launch-id"]
+                summary: "Retire an incorrect historical AgentRun without deleting its audit record.",
+                usage: "yui task run retire <task>/<run> --reason <text> [--expected-progress-at <timestamp>] [--agent-id <id>] [--adapter-id <id>] [--native-session-id <id>]",
+                options: ["--reason", "--expected-progress-at", "--progress-at", "--agent-id", "--adapter-id", "--native-session-id"]
             }
         ]
     },
     {
         name: "review",
         summary: "Control Task-final ReviewRounds.",
-        sections: [{ id: "manage", title: "Commands", entries: ["request", "retry"] }],
+        sections: [{ id: "manage", title: "Commands", entries: ["request", "synthesize", "retry"] }],
         children: [
+            {
+                name: "synthesize",
+                summary: "Dispatch main Review over selected Producer AgentRuns and the frozen candidate.",
+                usage: "yui task review synthesize <task>/<review-round> --source-run <task>/<run> ...",
+                options: ["--source-run"]
+            },
             {
                 name: "request",
                 summary: "Request a direct or replicated Task-local final ReviewRound.",
@@ -807,7 +891,7 @@ const taskChildren = [
             },
             {
                 name: "retry",
-                summary: "Retry a failed Task-final ReviewRound without a Reviewer Turn.",
+                summary: "Retry a failed Task-final ReviewRound without a Reviewer AgentRun.",
                 usage: "yui task review retry <task>/<review-round>"
             }
         ]
@@ -826,7 +910,7 @@ const taskChildren = [
             },
             {
                 name: "continue",
-                summary: "Continue a Leader-approved manual resolution.",
+                summary: "Consume a finished check Job and finalize this exact Integration, or continue an approved manual resolution.",
                 usage: "yui task integration continue <task>/<integration>"
             },
             {
@@ -953,10 +1037,12 @@ const taskChildren = [
     {
         name: "wake",
         summary: "Inspect the durable Leader wake ledger and its delta content.",
-        sections: [{ id: "manage", title: "Commands", entries: ["list", "show"] }],
+        sections: [{ id: "manage", title: "Commands", entries: ["list", "show", "resolve"] }],
         children: [
             { name: "list", summary: "List recorded Leader wakes.", usage: "yui task wake list <task>" },
-            { name: "show", summary: "Show one wake and its delta content.", usage: "yui task wake show <task> <wake>" }
+            { name: "show", summary: "Show one wake and its delta content.", usage: "yui task wake show <task> <wake>" },
+            { name: "resolve", summary: "Release an unknown notification claim after explicit quiescence evidence, without replay.",
+                usage: "yui task wake resolve <task> <wake> --reason <quiescence-evidence>", options: ["--reason"] }
         ]
     },
     {
@@ -1007,9 +1093,9 @@ export const ROOT_COMMAND = buildNode({
         { name: "doctor", summary: "Check Yui dependencies and file state." },
         {
             name: "web",
-            summary: "Serve the local Task and Agent control room.",
-            usage: "yui web [--host <loopback>] [--port <port>]",
-            options: ["--host", "--port"]
+            summary: "Serve the control room using the running Controller's capability Host.",
+            usage: "yui web [--host <loopback>] [--port <port>] | --status | --stop",
+            options: ["--host", "--port", "--status", "--stop"]
         },
         {
             name: "controller",
@@ -1039,7 +1125,7 @@ export const ROOT_COMMAND = buildNode({
                 },
                 {
                     name: "live-identity",
-                    summary: "Read the authenticated live Controller runtime generation identity.",
+                    summary: "Read the authenticated live Controller runtime identity.",
                     hidden: true
                 },
                 { name: "stop", summary: "Stop the Controller." },
@@ -1057,7 +1143,7 @@ export const ROOT_COMMAND = buildNode({
             children: [
                 {
                     name: "audit",
-                    summary: "Report Turns, wakes, Sessions, Reviews, Integrations, and telemetry volume.",
+                    summary: "Report AgentRuns, wakes, Sessions, Reviews, Integrations, and telemetry volume.",
                     usage: "yui execution audit [--task <id>] [--since <iso>] [--until <iso>]",
                     options: ["--task", "--since", "--until"]
                 }
@@ -1152,7 +1238,7 @@ export const ROOT_COMMAND = buildNode({
                 },
                 {
                     name: "role",
-                    summary: "Manage reusable global Roles and desired Agent launch configuration for the next Host activation.",
+                    summary: "Manage reusable global Roles and desired Agent launch configuration for the next Host process.",
                     examples: ["yui config role list", "yui config role show operator"],
                     sections: [
                         { id: "inspect", title: "Inspect", entries: ["list", "show"] },
@@ -1201,9 +1287,12 @@ export const ROOT_COMMAND = buildNode({
                 },
                 {
                     name: "submit",
-                    summary: "Submit work through the Operator.",
-                    usage: "yui operator submit (<body>|--body-file <path|->) [--task <id>]",
-                    options: ["--task", "--body-file"],
+                    summary: "Submit work through the Operator with a submission intent (record|discuss|develop); a task-less submit opens a Draft. An optional idempotency key makes a retry safe.",
+                    usage: "yui operator submit (<body>|--body-file <path|->) [--task <id>] [--intent record|discuss|develop] [--request-id <key>]",
+                    options: ["--task", "--body-file", "--intent", "--request-id"],
+                    optionValues: {
+                        "--intent": ["record", "discuss", "develop"]
+                    },
                     fileOptions: ["--body-file"]
                 }
             ]
@@ -1378,10 +1467,10 @@ export const ROOT_COMMAND = buildNode({
         },
         {
             name: "task",
-            summary: "Manage Tasks, WorkItems, Turns, and integration.",
+            summary: "Manage Tasks, WorkItems, AgentRuns, and integration.",
             sections: [
-                { id: "lifecycle", title: "Lifecycle", entries: ["create", "project", "base", "update", "activate", "execution", "complete", "reopen", "retire", "list", "show", "context", "next-action", "remote-delivery", "archive", "replace", "reconcile", "upstream"] },
-                { id: "collaboration", title: "Collaboration", entries: ["message", "input", "grant", "workflow", "publication", "work", "turn", "review", "integration", "role", "overlap", "change-set"] },
+                { id: "lifecycle", title: "Lifecycle", entries: ["create", "project", "base", "update", "activate", "activation", "execution", "complete", "cancel", "reopen", "retire", "list", "show", "context", "next-action", "remote-delivery", "archive", "replace", "reconcile", "upstream", "artifact"] },
+                { id: "collaboration", title: "Collaboration", entries: ["message", "input", "grant", "workflow", "publication", "work", "run", "review", "integration", "role", "overlap", "change-set"] },
                 { id: "knowledge", title: "Task Knowledge", entries: ["brief", "decision", "milestone", "event", "continuation", "wake"] }
             ],
             children: taskChildren
@@ -1389,9 +1478,11 @@ export const ROOT_COMMAND = buildNode({
         {
             name: "capability",
             summary: "Discover and call authorized capabilities through the Controller.",
-            sections: [{ id: "entry", title: "Commands", entries: ["search", "describe", "call"] }],
+            sections: [{ id: "entry", title: "Commands", entries: ["search", "commands", "panels", "describe", "call"] }],
             children: [
                 { name: "search", summary: "Search the current authorized directory.", usage: "yui capability search [query] --task <id>" },
+                { name: "commands", summary: "List current command names, help and capability mappings; invoke via capability call.", usage: "yui capability commands --task <id>" },
+                { name: "panels", summary: "List authorized text/link or query-only JSON panel descriptors.", usage: "yui capability panels --task <id>" },
                 { name: "describe", summary: "Describe one contract or report Provider ambiguity.", usage: "yui capability describe <name> --task <id> [--provider <id>] [--version <version>]" },
                 { name: "call", summary: "Invoke one implementation under the current managed identity.", usage: "yui capability call <name> --task <id> --input <json> [--provider <id>] [--version <version>] [--request-id <id>]" }
             ]
@@ -1422,8 +1513,8 @@ export const ROOT_COMMAND = buildNode({
             sections: [{ id: "manage", title: "Commands", entries: ["status", "prune", "read"] }],
             children: [
                 { name: "status", summary: "Show sidecar health, row counts, and retention settings.", usage: "yui telemetry status" },
-                { name: "prune", summary: "Apply terminal retention and active-Turn caps.", usage: "yui telemetry prune [--task <id>] [--keep <n>] [--dry-run]" },
-                { name: "read", summary: "Page through retained progress rows or read a Turn aggregate.", usage: "yui telemetry read --task <id> [--turn <id>] [--aggregate] [--limit <n>] [--offset <n>]" }
+                { name: "prune", summary: "Apply terminal retention and active-AgentRun caps.", usage: "yui telemetry prune [--task <id>] [--keep <n>] [--dry-run]" },
+                { name: "read", summary: "Page through retained progress rows or read a AgentRun aggregate.", usage: "yui telemetry read --task <id> [--run <id>] [--aggregate] [--limit <n>] [--offset <n>]" }
             ]
         },
         {
@@ -1439,7 +1530,7 @@ export const ROOT_COMMAND = buildNode({
                 {
                     name: "agent-host",
                     summary: "Run the persistent structured Provider host.",
-                    usage: "yui internal agent-host <launch-id> <ticket>"
+                    usage: "yui internal agent-host <ticket>"
                 },
                 {
                     name: "session-notify",

package/dist/cli/interactionCandidates.js

@@ -1,4 +1,4 @@
-import { orderRoleOptions } from "./roleOptionCatalog.js";
+import { orderRoleOptions } from "./roleOptionOrder.js";
 export async function getSelectionCandidates(selector, ports, args) {
     switch (selector.provider) {
         case "tasks":
@@ -70,11 +70,11 @@ export async function getSelectionCandidates(selector, ports, args) {
         }
         case "work-items":
             return entities("work item", "Select work item", qualifyTaskRecords(await listAllWorkItems(ports)), ["qualifiedId", "title", "status"]);
-        case "turns": {
+        case "runs": {
             const workItemId = dependencyValue(selector, args);
-            const turns = await listAllByTask(ports, "task.turn.list", "turns");
-            return entities("turn", workItemId === undefined ? "Select Turn" : `Select Turn: ${workItemId}`, qualifyTaskRecords(turns.filter((turn) => workItemId === undefined
-                || matchesTaskRecordReference(turn, "workItemId", workItemId))), ["qualifiedId", "roleName", "status", "summary"]);
+            const runs = await listAllByTask(ports, "task.run.list", "runs");
+            return entities("run", workItemId === undefined ? "Select AgentRun" : `Select AgentRun: ${workItemId}`, qualifyTaskRecords(runs.filter((run) => workItemId === undefined
+                || matchesTaskRecordReference(run, "workItemId", workItemId))), ["qualifiedId", "roleName", "status", "summary"]);
         }
         case "integration-attempts":
             return entities("Integration Attempt", "Select Integration Attempt", qualifyTaskRecords((await listAllByTask(ports, "task.integration.list", "integrations")).filter((attempt) => selector.statuses === undefined

package/dist/cli/interactionPolicy.js

@@ -176,11 +176,41 @@ export const INTERACTION_POLICIES = Object.freeze([
         }
     },
     taskTarget("activate", 2, ["draft"]),
+    {
+        commandPath: ["task", "activation", "request"],
+        selectors: [{
+                argumentIndex: 3,
+                entity: "task",
+                provider: "tasks",
+                actionTarget: true,
+                statuses: ["draft"]
+            }],
+        trailingOptions: { "--request-id": "value", "--environment": "value" }
+    },
+    {
+        commandPath: ["task", "activation", "cancel"],
+        selectors: [{
+                argumentIndex: 3,
+                entity: "task",
+                provider: "tasks",
+                actionTarget: true,
+                statuses: ["draft"]
+            }],
+        trailingOptions: { "--request-id": "value", "--reason": "value" }
+    },
+    {
+        commandPath: ["task", "activation", "show"],
+        selectors: [{ argumentIndex: 3, entity: "task", provider: "tasks", actionTarget: true }]
+    },
     {
         ...taskTarget("complete", 2, ["active"]),
         trailingOptions: { "--summary": "value" }
     },
-    taskTarget("reopen", 2, ["completed"]),
+    taskTarget("reopen", 2, ["completed", "cancelled"]),
+    {
+        ...taskTarget("cancel", 2, ["draft", "active"]),
+        trailingOptions: { "--summary": "value", "--summary-file": "value" }
+    },
     {
         ...taskTarget("retire", 2, ["draft", "active"]),
         trailingOptions: {
@@ -200,7 +230,7 @@ export const INTERACTION_POLICIES = Object.freeze([
         trailingOptions: { "--json": "flag" }
     },
     {
-        ...taskTarget("archive", 2, ["completed", "retired"]),
+        ...taskTarget("archive", 2, ["completed", "cancelled"]),
         trailingOptions: { "--integrated": "flag", "--abandon": "flag", "--force": "flag" },
         confirmation: { action: "Archive task", targetArgumentIndex: 2 }
     },
@@ -436,7 +466,7 @@ export const INTERACTION_POLICIES = Object.freeze([
                 }
             }
             : command === "update"
-                ? { trailingOptions: { "--summary": "value" } }
+                ? { trailingOptions: { "--summary": "value", "--artifact-ref": "value" } }
                 : command === "dispatch"
                     ? { trailingOptions: { "--input": "value" } }
                     : command === "cleanup"
@@ -471,15 +501,15 @@ export const INTERACTION_POLICIES = Object.freeze([
         confirmation: { action: "Retire Work Item", targetArgumentIndex: 3 }
     },
     {
-        commandPath: ["task", "turn", "list"],
+        commandPath: ["task", "run", "list"],
         selectors: [{ argumentIndex: 3, entity: "work-item", provider: "work-items", actionTarget: true }],
     },
     {
-        commandPath: ["task", "turn", "retry"],
+        commandPath: ["task", "run", "retry"],
         selectors: [{
                 argumentIndex: 3,
-                entity: "turn",
-                provider: "turns",
+                entity: "run",
+                provider: "runs",
                 actionTarget: true
             }]
     },
@@ -573,7 +603,7 @@ export const INTERACTION_POLICIES = Object.freeze([
     ].map(([group, command]) => {
         const trailingOptions = {};
         if (group === "brief" && command === "update") {
-            Object.assign(trailingOptions, { "--objective": "value", "--boundary": "value", "--focus": "value", "--leader-summary": "value" });
+            Object.assign(trailingOptions, { "--objective": "value", "--boundary": "value", "--approach": "value", "--focus": "value", "--leader-summary": "value" });
         }
         else if (group === "decision" && command === "record") {
             Object.assign(trailingOptions, { "--title": "value", "--rationale": "value" });