@zq-silk/yui 0.14.0 → 0.14.2

package/dist/cli/commandCatalog.js

@@ -59,7 +59,7 @@ function durableConfigDomainNode(domain) {
     const values = CONFIG_KEY_VALUES.filter(({ name }) => keys.includes(name));
     const options = domain === "workflow"
         ? [
-            "--soft-tokens", "--hard-tokens", "--role", "--trigger", "--finding-ledger"
+            "--soft-tokens", "--hard-tokens", "--role", "--trigger"
         ]
         : domain === "runtime"
             ? ["--quiet-after-seconds", "--diagnostic-after-seconds", "--stall-after-seconds"]
@@ -85,7 +85,6 @@ function durableConfigDomainNode(domain) {
                 optionValues: domain === "workflow"
                     ? {
                         "--trigger": ["always", "leader", "final"],
-                        "--finding-ledger": ["shadow", "enforce"]
                     }
                     : {}
             },
@@ -142,7 +141,8 @@ const roleAgentClearOptions = [
     "--clear-search", "--clear-agent-config"
 ];
 const agentProfileOptions = [
-    "--description", "--instructions", "--skill", "--model", "--effort"
+    "--description", "--instructions", "--skill",
+    "--agent", "--model", "--effort", "--inherit-worker"
 ];
 const agentProfileClearOptions = [
     "--clear-description", "--clear-instructions", "--clear-skills",
@@ -213,8 +213,8 @@ const globalSessionChildren = [
 const profileChildren = [
     {
         name: "add",
-        summary: "Add a reusable Agent Profile.",
-        usage: "yui config profile add <id> [--access <read|write>] [Profile settings]",
+        summary: "Add a reusable Agent Profile that inherits Worker runtime or selects one explicit Agent.",
+        usage: "yui config profile add <id> [--access <read|write>] [--inherit-worker | --agent <id> [--model <model>] [--effort <effort>]] [Profile settings]",
         options: ["--access", ...agentProfileOptions],
         optionValues: { "--access": ["read", "write"] }
     },
@@ -222,8 +222,8 @@ const profileChildren = [
     { name: "show", summary: "Show one Agent Profile.", usage: "yui config profile show <id>" },
     {
         name: "update",
-        summary: "Update an Agent Profile.",
-        usage: "yui config profile update <id> [--access <read|write>] [Profile settings]",
+        summary: "Update an Agent Profile's behavior or runtime source.",
+        usage: "yui config profile update <id> [--access <read|write>] [--inherit-worker | [--agent <id>] [--model <model>|--clear-model] [--effort <effort>|--clear-effort]] [Profile settings]",
         options: ["--access", ...agentProfileOptions, ...agentProfileClearOptions],
         optionValues: { "--access": ["read", "write"] }
     },
@@ -346,11 +346,17 @@ const taskChildren = [
         usage: "yui task next-action <task> [--json]",
         options: ["--json"]
     },
+    {
+        name: "remote-delivery",
+        summary: "Project exact Task heads and current PR/MR evidence into merge coverage.",
+        usage: "yui task remote-delivery <task> [--json]",
+        options: ["--json"]
+    },
     {
         name: "archive",
         summary: "Archive a Task after confirming the main worktree outcome.",
-        usage: "yui task archive <id> (--integrated|--abandon)",
-        options: ["--integrated", "--abandon"]
+        usage: "yui task archive <id> (--integrated [--force]|--abandon)",
+        options: ["--integrated", "--abandon", "--force"]
     },
     { name: "reconcile", summary: "Run one immediate Controller reconciliation.", usage: "yui task reconcile <id>" },
     {
@@ -360,9 +366,9 @@ const taskChildren = [
         children: [
             {
                 name: "integrate",
-                summary: "Merge the remote development head into the Task workspace.",
-                usage: "yui task upstream integrate <task> [--latest] [--project <project>]",
-                options: ["--latest", "--project"]
+                summary: "Rebase Task changes onto the remote development head through Integration.",
+                usage: "yui task upstream integrate <task> (--latest|--project <project>) [--check <command> ...]",
+                options: ["--latest", "--project", "--check"]
             }
         ]
     },
@@ -375,7 +381,7 @@ const taskChildren = [
     {
         name: "message",
         summary: "Manage durable Task messages.",
-        sections: [{ id: "manage", title: "Commands", entries: ["send", "list", "retire"] }],
+        sections: [{ id: "manage", title: "Commands", entries: ["send", "list", "update", "retire"] }],
         children: [
             {
                 name: "send",
@@ -393,6 +399,16 @@ const taskChildren = [
                 usage: "yui task message list <id> [--after <timestamp>] [--limit <n>]",
                 options: ["--after", "--limit"]
             },
+            {
+                name: "update",
+                summary: "Replace the mutable body and wake policy of a Draft user/operator Message.",
+                usage: "yui task message update <task>/<message> (<body>|--body-file <path|->) [--wake-policy leader|none]",
+                options: ["--body-file", "--wake-policy"],
+                optionValues: {
+                    "--wake-policy": ["leader", "none"]
+                },
+                fileOptions: ["--body-file"]
+            },
             {
                 name: "retire",
                 summary: "Retire an incorrect historical Task Message without deleting its audit record.",
@@ -509,14 +525,19 @@ const taskChildren = [
     },
     {
         name: "publication",
-        summary: "Record external PR/MR publication evidence for a Task.",
-        sections: [{ id: "manage", title: "Commands", entries: ["add", "list", "show"] }],
+        summary: "Create or update external PR/MR publication evidence for a Task.",
+        sections: [{ id: "manage", title: "Commands", entries: ["upsert", "verify", "list", "show"] }],
         children: [
             {
-                name: "add",
-                summary: "Record an external PR/MR and its publication state.",
-                usage: "yui task publication add <task> --project <project> --provider <github|gitlab> --repository <owner/name> --kind <pull-request|merge-request> --id <external-id> [--url <url>] [--title <text>] [--source-branch <branch>] [--target-branch <branch>] [--local-commit <sha>] [--remote-commit <sha>] [--state <open|merged|closed>] [--reported|--verified] [--evidence <text>] [--supersede <publication-id>] [--merged-at <iso-timestamp>]",
-                options: ["--project", "--provider", "--repository", "--kind", "--id", "--url", "--title", "--source-branch", "--target-branch", "--local-commit", "--remote-commit", "--state", "--reported", "--verified", "--evidence", "--supersede", "--merged-at"]
+                name: "upsert",
+                summary: "Create or immutably update an external PR/MR and its publication state.",
+                usage: "yui task publication upsert <task> --project <project> --provider <github|gitlab> --repository <owner/name> --kind <pull-request|merge-request> --id <external-id> [--url <url>] [--title <text>] [--source-branch <branch>] [--target-branch <branch>] [--local-commit <sha>] [--remote-commit <sha>] [--state <open|merged|closed>] [--reported|--verified] [--evidence <text>] [--merged-at <iso-timestamp>]",
+                options: ["--project", "--provider", "--repository", "--kind", "--id", "--url", "--title", "--source-branch", "--target-branch", "--local-commit", "--remote-commit", "--state", "--reported", "--verified", "--evidence", "--merged-at"]
+            },
+            {
+                name: "verify",
+                summary: "Verify one current GitHub PR against the exact Task delivery head through gh.",
+                usage: "yui task publication verify (<task>/<publication-id> | <task> <publication-id>)"
             },
             {
                 name: "list",
@@ -540,8 +561,8 @@ const taskChildren = [
         children: [
             {
                 name: "add",
-                summary: "Add a Role to a Task.",
-                usage: "yui task role add <task> <name> [--profile <id>] [--agent <id>] [Role and Agent settings]",
+                summary: "Add a Task Role from a frozen Profile/Worker runtime or one explicit Agent.",
+                usage: "yui task role add <task> <name> [--profile <id>] [--agent <id> [Agent settings]] [Role settings]",
                 options: ["--profile", "--agent", ...roleProfileOptions, ...roleAgentOptions],
                 optionValues: roleAgentOptionValues
             },
@@ -554,8 +575,8 @@ const taskChildren = [
             { name: "show", summary: "Show one Task Role.", usage: "yui task role show <task> <role>" },
             {
                 name: "update",
-                summary: "Update a Task Role.",
-                usage: "yui task role update <task> <role> [Role and Agent settings]",
+                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,
                     ...roleProfileClearOptions, ...roleAgentClearOptions],
                 optionValues: roleAgentOptionValues
@@ -606,8 +627,8 @@ const taskChildren = [
                 id: "manage",
                 title: "Commands",
                 entries: [
-                    "create", "list", "show", "update", "scope", "dispatch", "isolate", "capture", "cleanup",
-                    "review", "group", "accept", "reject", "retire"
+                    "create", "list", "show", "edit", "update", "scope", "dispatch", "isolate", "capture", "cleanup",
+                    "review", "accept", "reject", "retire"
                 ]
             }],
         children: [
@@ -619,6 +640,16 @@ const taskChildren = [
             },
             { name: "list", summary: "List work items for a Task.", usage: "yui task work list <task>" },
             { 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.",
+                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",
+                    "--after", "--clear-dependencies", "--project", "--clear-projects",
+                    "--base-ref", "--clear-base-refs", "--role", "--clear-role"
+                ]
+            },
             {
                 name: "update",
                 summary: "Update a work item's state.",
@@ -637,24 +668,8 @@ const taskChildren = [
             {
                 name: "dispatch",
                 summary: "Dispatch a work item to its Role.",
-                usage: "yui task work dispatch <task>/<work> [--input <text>] [--strategy fixed:<count>|adaptive:<max>] [--lane-role <role> ...] [--mode <single|parallel-diverse|ensemble-replicated|adversarial|adaptive-exploration>] [--max-rounds <count>] [--stage-max-attempts <count>] [--stage-max-tokens <count>] [--stage-max-tool-calls <count>] [--stage-max-seconds <count>] [--stage-quorum <count>] [--stage-straggler-seconds <count>] [--stage-min-marginal-value <0-100>]",
-                options: ["--input", "--strategy", "--lane-role", "--mode", "--max-rounds", "--stage-max-attempts", "--stage-max-tokens", "--stage-max-tool-calls", "--stage-max-seconds", "--stage-quorum", "--stage-straggler-seconds", "--stage-min-marginal-value"],
-                optionValues: {
-                    "--mode": ["single", "parallel-diverse", "ensemble-replicated", "adversarial", "adaptive-exploration"]
-                }
-            },
-            {
-                name: "group",
-                summary: "Resolve a Worker ExecutionGroup after its Lanes finish.",
-                executable: true,
-                sections: [{ id: "manage", title: "Commands", entries: ["resolve"] }],
-                children: [{
-                        name: "resolve",
-                        summary: "Select Lane outputs and resolve the Worker group.",
-                        usage: "yui task work group resolve <task>/<work> --decision <accept|reject|retry|blocked> --summary <text> [--lane <lane-id> ...] [--early-stop <marginal-value-percent>]",
-                        options: ["--decision", "--summary", "--lane", "--early-stop"],
-                        optionValues: { "--decision": ["accept", "reject", "retry", "blocked"] }
-                    }]
+                usage: "yui task work dispatch <task>/<work> [--input <text>] [--lane-role <role> ...]",
+                options: ["--input", "--lane-role"]
             },
             {
                 name: "isolate",
@@ -674,8 +689,9 @@ const taskChildren = [
             },
             {
                 name: "review",
-                summary: "Ask the configured reviewer to inspect a WorkItem candidate.",
-                usage: "yui task work review <task>/<work>",
+                summary: "Ask the configured reviewer to inspect a WorkItem candidate directly or with replicated Producers.",
+                usage: "yui task work review <task>/<work> [--lane-role <producer-role> --lane-role <producer-role> ...]",
+                options: ["--lane-role"],
                 executable: true,
                 sections: [
                     { id: "retry", title: "Task-final recovery", entries: ["retry"] },
@@ -732,12 +748,12 @@ const taskChildren = [
             },
             {
                 name: "retry",
-                summary: "Retry a failed execution Turn or request a fresh Round for an exact failed final Review Turn.",
+                summary: "Retry an exact failed execution or review Turn while preserving its semantic unit.",
                 usage: "yui task turn retry <task>/<turn>"
             },
             {
                 name: "settle",
-                summary: "Close an obsolete stranded final Review Turn without requesting a retry Round.",
+                summary: "Explicitly settle a failed WorkItem Lane or an obsolete stranded final Review Turn.",
                 usage: "yui task turn settle <task>/<turn>"
             },
             {
@@ -781,83 +797,32 @@ const taskChildren = [
     {
         name: "review",
         summary: "Control Task-final ReviewRounds.",
-        sections: [{ id: "manage", title: "Commands", entries: ["request", "force-fresh", "group", "retry", "finding"] }],
+        sections: [{ id: "manage", title: "Commands", entries: ["request", "retry"] }],
         children: [
             {
                 name: "request",
-                summary: "Request one Task-local final ReviewRound from a Global Role.",
-                usage: "yui task review request <task> --role <global-role> [--strategy fixed:<count>|adaptive:<max>] [--lane-role <role> ...] [--delta-recheck]",
-                options: ["--role", "--strategy", "--lane-role", "--delta-recheck"]
-            },
-            {
-                name: "force-fresh",
-                summary: "Replace one exact terminal non-semantic Task-final Review with a distinct full Round.",
-                usage: "yui task review force-fresh <task>/<review-round>"
-            },
-            {
-                name: "group",
-                summary: "Resolve a Reviewer ExecutionGroup after its Lanes finish.",
-                executable: true,
-                sections: [{ id: "manage", title: "Commands", entries: ["resolve"] }],
-                children: [{
-                        name: "resolve",
-                        summary: "Select Reviewer Lane evidence and resolve the group.",
-                        usage: "yui task review group resolve <task>/<review-round> --decision <accept|reject|blocked> --summary <text> [--lane <lane-id> ...]",
-                        options: ["--decision", "--summary", "--lane"],
-                        optionValues: { "--decision": ["accept", "reject", "blocked"] }
-                    }]
+                summary: "Request a direct or replicated Task-local final ReviewRound.",
+                usage: "yui task review request <task> --role <main-role> [--lane-role <producer-role> --lane-role <producer-role> ...] [--delta-recheck]",
+                options: ["--role", "--lane-role", "--delta-recheck"]
             },
             {
                 name: "retry",
                 summary: "Retry a failed Task-final ReviewRound without a Reviewer Turn.",
                 usage: "yui task review retry <task>/<review-round>"
-            },
-            {
-                name: "finding",
-                summary: "Inspect and disposition the cross-Round Review finding ledger.",
-                executable: true,
-                sections: [{ id: "manage", title: "Commands", entries: ["list", "dispose", "repair-wave", "extract"] }],
-                children: [
-                    {
-                        name: "list",
-                        summary: "List the Task's review findings with disposition and repair lineage.",
-                        usage: "yui task review finding list <task>"
-                    },
-                    {
-                        name: "dispose",
-                        summary: "Record one Leader disposition for a review finding.",
-                        usage: "yui task review finding dispose <task>/<finding> --disposition <fixed-pending-review|verified-fixed|accepted-risk|not-actionable|superseded> [--work-item <id>] [--commit <sha>] [--verification <text>] [--note <text>] [--superseded-by <stable-key>]",
-                        options: ["--disposition", "--work-item", "--commit", "--verification", "--note", "--superseded-by"],
-                        optionValues: {
-                            "--disposition": ["fixed-pending-review", "verified-fixed", "accepted-risk", "not-actionable", "superseded"]
-                        }
-                    },
-                    {
-                        name: "repair-wave",
-                        summary: "Consolidate open P1/P2 findings, or explicitly plan parallel repair groups.",
-                        usage: "yui task review finding repair-wave <task> [--strategy <consolidated|parallel>] [--create]",
-                        options: ["--strategy", "--create"],
-                        optionValues: { "--strategy": ["consolidated", "parallel"] }
-                    },
-                    {
-                        name: "extract",
-                        summary: "Reconcile findings from one completed ReviewRound into the ledger.",
-                        usage: "yui task review finding extract <task>/<review-round>"
-                    }
-                ]
             }
         ]
     },
     {
         name: "integration",
-        summary: "Safely integrate ChangeSets with Leader-owned conflict decisions.",
+        summary: "Integrate WorkItem results and upstream commits with Leader-owned decisions.",
         sections: [{ id: "manage", title: "Commands", entries: ["start", "continue", "resolve", "abort", "supersede", "list", "show", "cleanup", "queue"] }],
         children: [
             {
                 name: "start",
                 summary: "Build, validate, and CAS-commit an integration candidate.",
-                usage: "yui task integration start <task> [--project <project>] --change-set <id> [--change-set <id> ...] [--target <ref>] [--check <command> ...]",
-                options: ["--project", "--change-set", "--target", "--check"]
+                usage: "yui task integration start <task> --work-item <id> --strategy <ff|cherry-pick|merge|manual> [--project <project>] [--target <ref>] [--check <command> ...]",
+                options: ["--work-item", "--strategy", "--project", "--target", "--check"],
+                optionValues: { "--strategy": ["ff", "cherry-pick", "merge", "manual"] }
             },
             {
                 name: "continue",
@@ -1030,7 +995,7 @@ export const ROOT_COMMAND = buildNode({
         { name: "update", summary: "Install the latest published Yui package globally." },
         {
             name: "upgrade",
-            summary: "Inspect this Home and apply any supported storage upgrade.",
+            summary: "Validate this Home against the exact current storage contract.",
             usage: "yui upgrade [--dry-run]",
             options: ["--dry-run"]
         },
@@ -1074,7 +1039,7 @@ export const ROOT_COMMAND = buildNode({
                 },
                 {
                     name: "live-identity",
-                    summary: "Read the authenticated live Controller launch identity.",
+                    summary: "Read the authenticated live Controller runtime generation identity.",
                     hidden: true
                 },
                 { name: "stop", summary: "Stop the Controller." },
@@ -1415,7 +1380,7 @@ export const ROOT_COMMAND = buildNode({
             name: "task",
             summary: "Manage Tasks, WorkItems, Turns, and integration.",
             sections: [
-                { id: "lifecycle", title: "Lifecycle", entries: ["create", "project", "base", "update", "activate", "execution", "complete", "reopen", "retire", "list", "show", "context", "next-action", "archive", "replace", "reconcile", "upstream"] },
+                { 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: "knowledge", title: "Task Knowledge", entries: ["brief", "decision", "milestone", "event", "continuation", "wake"] }
             ],

package/dist/cli/helpRenderer.js

@@ -32,8 +32,7 @@ function describeOption(option) {
         "--role": "Select a Task role.",
         "--summary": "Set summary text.",
         "--task": "Select a Task.",
-        "--trigger": "Set the review trigger (always, leader, final).",
-        "--finding-ledger": "Set the review finding ledger mode (shadow, enforce)."
+        "--trigger": "Set the review trigger (always, leader, final)."
     };
     return descriptions[option] ?? `Set ${option.slice(2).replaceAll("-", " ")}.`;
 }

package/dist/cli/interactionCandidates.js

@@ -60,6 +60,8 @@ export async function getSelectionCandidates(selector, ports, args) {
                 return null;
             return entities("milestone", `Select Milestone: ${taskId}`, await list(ports, "task.milestone.list", { taskId }), ["id", "title", "createdAt"]);
         }
+        case "messages":
+            return entities("message", "Select Task message", qualifyTaskRecords(await listAllMessages(ports)), ["qualifiedId", "kind", "createdAt", "body"]);
         case "task-events": {
             const taskId = dependencyValue(selector, args);
             if (taskId === undefined)
@@ -109,6 +111,14 @@ async function listAllWorkItems(ports) {
     }));
     return groups.flat();
 }
+async function listAllMessages(ports) {
+    const tasks = await list(ports, "task.list", {});
+    const groups = await Promise.all(tasks.flatMap((task) => {
+        const taskId = stringField(task, "id");
+        return taskId === undefined ? [] : [list(ports, "task.message.list", { taskId })];
+    }));
+    return groups.flat();
+}
 async function listAllByTask(ports, method, resultKey) {
     const tasks = await list(ports, "task.list", {});
     const groups = await Promise.all(tasks.flatMap((task) => {

package/dist/cli/interactionPolicy.js

@@ -130,7 +130,8 @@ export const INTERACTION_POLICIES = Object.freeze([
         selectors: [],
         trailingOptions: {
             "--description": "value", "--instructions": "value",
-            "--skill": "value", "--model": "value", "--effort": "value", "--access": "value"
+            "--skill": "value", "--agent": "value", "--model": "value",
+            "--effort": "value", "--access": "value", "--inherit-worker": "flag"
         }
     },
     ...["show", "update", "remove"].map((command) => ({
@@ -146,8 +147,11 @@ export const INTERACTION_POLICIES = Object.freeze([
                 trailingOptions: {
                     "--description": "option-like-value",
                     "--instructions": "option-like-value", "--skill": "value",
+                    "--agent": "value", "--inherit-worker": "flag",
                     "--model": "option-like-value", "--effort": "option-like-value",
-                    "--access": "value"
+                    "--access": "value", "--clear-description": "flag",
+                    "--clear-instructions": "flag", "--clear-skills": "flag",
+                    "--clear-model": "flag", "--clear-effort": "flag"
                 }
             }
             : {}),
@@ -191,9 +195,13 @@ export const INTERACTION_POLICIES = Object.freeze([
         selectors: [],
         trailingOptions: { "--all": "flag", "--verbose": "flag" }
     },
+    {
+        ...taskTarget("remote-delivery"),
+        trailingOptions: { "--json": "flag" }
+    },
     {
         ...taskTarget("archive", 2, ["completed", "retired"]),
-        trailingOptions: { "--integrated": "flag", "--abandon": "flag" },
+        trailingOptions: { "--integrated": "flag", "--abandon": "flag", "--force": "flag" },
         confirmation: { action: "Archive task", targetArgumentIndex: 2 }
     },
     taskTarget("reconcile"),
@@ -226,6 +234,27 @@ export const INTERACTION_POLICIES = Object.freeze([
                 actionTarget: true
             }]
     })),
+    {
+        commandPath: ["task", "message", "update"],
+        selectors: [{
+                argumentIndex: 3,
+                entity: "message",
+                provider: "messages",
+                actionTarget: true
+            }],
+        trailingOptions: { "--body-file": "value", "--wake-policy": "value" }
+    },
+    {
+        commandPath: ["task", "message", "retire"],
+        selectors: [{
+                argumentIndex: 3,
+                entity: "message",
+                provider: "messages",
+                actionTarget: true
+            }],
+        trailingOptions: { "--reason": "value" },
+        confirmation: { action: "Retire Task Message", targetArgumentIndex: 3 }
+    },
     {
         commandPath: ["task", "input", "request"],
         selectors: [{
@@ -372,14 +401,15 @@ export const INTERACTION_POLICIES = Object.freeze([
             }
         ],
         trailingOptions: {
-            "--objective": "value", "--accept": "value", "--after": "value", "--role": "value"
+            "--objective": "value", "--accept": "value", "--after": "value", "--role": "value",
+            "--project": "value", "--base-ref": "value"
         }
     },
     {
         commandPath: ["task", "work", "list"],
         selectors: [{ argumentIndex: 3, entity: "task", provider: "tasks", actionTarget: true }]
     },
-    ...["show", "update", "dispatch", "isolate", "capture", "cleanup", "accept", "reject"]
+    ...["show", "edit", "update", "dispatch", "isolate", "capture", "cleanup", "accept", "reject"]
         .map((command) => ({
         commandPath: ["task", "work", command],
         selectors: [{
@@ -388,20 +418,37 @@ export const INTERACTION_POLICIES = Object.freeze([
                 provider: "work-items",
                 actionTarget: true
             }],
-        ...(command === "update"
-            ? { trailingOptions: { "--summary": "value" } }
-            : command === "dispatch"
-                ? { trailingOptions: { "--input": "value" } }
-                : command === "cleanup"
-                    ? {
-                        trailingOptions: {
-                            "--integrated": "flag",
-                            "--abandon": "flag"
+        ...(command === "edit"
+            ? {
+                trailingOptions: {
+                    "--title": "value",
+                    "--objective": "value",
+                    "--accept": "value",
+                    "--clear-acceptance": "flag",
+                    "--after": "value",
+                    "--clear-dependencies": "flag",
+                    "--project": "value",
+                    "--clear-projects": "flag",
+                    "--base-ref": "value",
+                    "--clear-base-refs": "flag",
+                    "--role": "value",
+                    "--clear-role": "flag"
+                }
+            }
+            : command === "update"
+                ? { trailingOptions: { "--summary": "value" } }
+                : command === "dispatch"
+                    ? { trailingOptions: { "--input": "value" } }
+                    : command === "cleanup"
+                        ? {
+                            trailingOptions: {
+                                "--integrated": "flag",
+                                "--abandon": "flag"
+                            }
                         }
-                    }
-                    : ["accept", "reject"].includes(command)
-                        ? { trailingOptions: { "--summary": "value" } }
-                        : {})
+                        : ["accept", "reject"].includes(command)
+                            ? { trailingOptions: { "--summary": "value" } }
+                            : {})
     })),
     {
         commandPath: ["task", "work", "retire"],
@@ -436,20 +483,6 @@ export const INTERACTION_POLICIES = Object.freeze([
                 actionTarget: true
             }]
     },
-    {
-        commandPath: ["task", "work", "group", "resolve"],
-        selectors: [{
-                argumentIndex: 4,
-                entity: "work-item",
-                provider: "work-items",
-                actionTarget: true
-            }],
-        trailingOptions: {
-            "--decision": "value",
-            "--summary": "value",
-            "--lane": "value"
-        }
-    },
     {
         commandPath: ["task", "review", "request"],
         selectors: [
@@ -467,22 +500,28 @@ export const INTERACTION_POLICIES = Object.freeze([
                 actionTarget: false
             }
         ],
-        trailingOptions: { "--role": "value", "--strategy": "value", "--lane-role": "value" }
+        trailingOptions: { "--role": "value", "--lane-role": "value" }
     },
     {
         commandPath: ["task", "integration", "start"],
         selectors: [
             { argumentIndex: 3, entity: "task", provider: "tasks", actionTarget: true },
             {
-                option: "--change-set",
+                option: "--work-item",
                 requiredOption: true,
-                entity: "change-set",
-                provider: "change-sets",
+                entity: "work-item",
+                provider: "work-items",
                 dependsOn: 3,
                 actionTarget: false
             }
         ],
-        trailingOptions: { "--change-set": "value", "--target": "value", "--check": "value" }
+        trailingOptions: {
+            "--work-item": "value",
+            "--strategy": "value",
+            "--project": "value",
+            "--target": "value",
+            "--check": "value"
+        }
     },
     {
         commandPath: ["task", "integration", "list"],

package/dist/cli/roleWizard.js

@@ -75,18 +75,17 @@ async function addTaskRole(args, ports, io) {
         return { kind: "cancelled", args: withTask };
     if (hasExplicitAddSettings(named, 5))
         return { kind: "resolved", args: named };
-    const roleName = named[4] ?? "";
-    const [globalRoleValue, agents] = await Promise.all([
-        Promise.resolve(ports.call("role.show", { name: roleName })),
+    const [workerRoleValue, agents] = await Promise.all([
+        Promise.resolve(ports.call("role.show", { name: "worker" })),
         loadAgentSelection(ports)
     ]);
-    const globalRole = asRole(globalRoleValue);
+    const workerRole = asRole(workerRoleValue);
     const explicitAgent = optionValue(named, "--agent");
-    if (globalRole !== undefined && explicitAgent === undefined) {
+    if (workerRole !== undefined && explicitAgent === undefined) {
         const source = await choose("Create Task Role from", [
             {
                 value: "copy",
-                cells: ["Copy existing Global Role", `Active Agent: ${globalRole.activeAgentId}`]
+                cells: ["Copy Global Worker", `Active Agent: ${workerRole.activeAgentId}`]
             },
             {
                 value: "agent",