@zq-silk/yui 0.2.0 → 0.4.2

package/dist/cli/commandCatalog.js

@@ -47,6 +47,11 @@ const agentChildren = [
     },
     { name: "list", summary: "List configured Agents." },
     { name: "show", summary: "Show one configured Agent.", usage: "yui agent show <id>" },
+    {
+        name: "capabilities",
+        summary: "Probe one Agent CLI for runtime configuration options.",
+        usage: "yui agent capabilities <id>"
+    },
     {
         name: "update",
         summary: "Update a configured Agent.",
@@ -62,19 +67,28 @@ const roleProfileOptions = [
     "--expected-output", "--system-prompt", "--skill"
 ];
 const roleAgentOptions = [
-    "--model", "--effort", "--sandbox", "--approval", "--permission-mode", "--search"
+    "--model", "--effort", "--permission-strategy", "--sandbox", "--approval", "--permission-mode",
+    "--allowed-tool", "--disallowed-tool", "--search"
 ];
 const roleProfileClearOptions = [
     "--clear-description", "--clear-responsibilities", "--clear-constraints",
     "--clear-expected-output", "--clear-system-prompt", "--clear-skills"
 ];
 const roleAgentClearOptions = [
-    "--clear-model", "--clear-effort", "--clear-sandbox", "--clear-approval",
-    "--clear-permission-mode", "--clear-search", "--clear-agent-config"
+    "--clear-model", "--clear-effort", "--clear-allowed-tools", "--clear-disallowed-tools",
+    "--clear-search", "--clear-agent-config"
+];
+const agentProfileOptions = [
+    "--description", "--instructions", "--skill", "--model", "--effort"
+];
+const agentProfileClearOptions = [
+    "--clear-description", "--clear-instructions", "--clear-skills",
+    "--clear-model", "--clear-effort"
 ];
 const roleAgentOptionValues = {
     "--sandbox": ["read-only", "workspace-write", "danger-full-access"],
     "--approval": ["untrusted", "on-request", "never"],
+    "--permission-strategy": ["default", "bypass", "configured"],
     "--search": ["true"]
 };
 const roleChildren = [
@@ -99,6 +113,7 @@ const roleChildren = [
     },
     { name: "remove", summary: "Remove a global Role.", usage: "yui role remove <name>" },
     { name: "bind", summary: "Bind and activate an Agent for a global Role.", usage: "yui role bind <role> <agent-id>" },
+    { name: "unbind", summary: "Unbind a dormant Agent from a global Role.", usage: "yui role unbind <role> <agent-id>" },
     { name: "enter", summary: "Enter a global Role's native session.", usage: "yui role enter <role>" },
     {
         name: "session",
@@ -120,20 +135,59 @@ const roleChildren = [
         ]
     }
 ];
+const profileChildren = [
+    {
+        name: "add",
+        summary: "Add a reusable Agent Profile.",
+        usage: "yui profile add <id> [--access <read|write>] [Profile settings]",
+        options: ["--access", ...agentProfileOptions],
+        optionValues: { "--access": ["read", "write"] }
+    },
+    { name: "list", summary: "List Agent Profiles." },
+    { name: "show", summary: "Show one Agent Profile.", usage: "yui profile show <id>" },
+    {
+        name: "update",
+        summary: "Update an Agent Profile.",
+        usage: "yui profile update <id> [--access <read|write>] [Profile settings]",
+        options: ["--access", ...agentProfileOptions, ...agentProfileClearOptions],
+        optionValues: { "--access": ["read", "write"] }
+    },
+    { name: "remove", summary: "Remove a custom Agent Profile.", usage: "yui profile remove <id>" },
+    { name: "reset", summary: "Reset all built-in Agent Profiles." }
+];
 const taskChildren = [
     {
         name: "create",
         summary: "Create a Draft Task.",
-        usage: "yui task create <title> [--repository <id>] [--base <ref>]",
-        options: ["--repository", "--base"]
+        usage: "yui task create <title> [--project <project> ...] [--base <project>=<ref> ...] [--require-integration]",
+        options: ["--project", "--base", "--require-integration"]
+    },
+    {
+        name: "project",
+        summary: "Manage Projects bound to a Task.",
+        sections: [{ id: "manage", title: "Commands", entries: ["list", "add"] }],
+        children: [
+            {
+                name: "list",
+                summary: "List the Projects bound to a Task.",
+                usage: "yui task project list <task>"
+            },
+            {
+                name: "add",
+                summary: "Add a Project to a Task.",
+                usage: "yui task project add <task> <project> [--base <ref>] [--directory <name>]",
+                options: ["--base", "--directory"]
+            }
+        ]
     },
     {
         name: "update",
         summary: "Update Task metadata.",
-        usage: "yui task update <id> [--title <text>] [--description <text>|--clear-description] [--priority <low|medium|high|urgent>|--clear-priority] [--tags <comma-separated>|--clear-tags] [--due-at <RFC3339>|--clear-due-at]",
+        usage: "yui task update <id> [--title <text>] [--description <text>|--clear-description] [--priority <low|medium|high|urgent>|--clear-priority] [--tags <comma-separated>|--clear-tags] [--due-at <RFC3339>|--clear-due-at] [--require-integration]",
         options: [
             "--title", "--description", "--priority", "--tags", "--due-at",
-            "--clear-description", "--clear-priority", "--clear-tags", "--clear-due-at"
+            "--clear-description", "--clear-priority", "--clear-tags", "--clear-due-at",
+            "--require-integration"
         ],
         optionValues: { "--priority": ["low", "medium", "high", "urgent"] }
     },
@@ -141,25 +195,49 @@ const taskChildren = [
     {
         name: "complete",
         summary: "Complete an active Task and stop automatic wakeups.",
-        usage: "yui task complete <id> --summary <text>",
-        options: ["--summary"]
+        usage: "yui task complete <id> (--summary <text>|--summary-file <path|->)",
+        options: ["--summary", "--summary-file"],
+        fileOptions: ["--summary-file"]
     },
     { name: "reopen", summary: "Reopen a completed Task.", usage: "yui task reopen <id>" },
-    { name: "list", summary: "List Tasks." },
+    {
+        name: "retire",
+        summary: "Retire a stale Task while preserving its historical evidence.",
+        usage: "yui task retire <task> (--summary <text>|--summary-file <path|->) [--replacement <task>]",
+        options: ["--summary", "--summary-file", "--replacement"],
+        fileOptions: ["--summary-file"]
+    },
+    {
+        name: "list",
+        summary: "List unarchived Task overviews.",
+        usage: "yui task list [--all] [--verbose]",
+        options: ["--all", "--verbose"]
+    },
     { name: "show", summary: "Show a Task.", usage: "yui task show <id>" },
     {
         name: "context",
         summary: "Show consolidated working context for a Task.",
         usage: "yui task context <task>"
     },
-    { name: "archive", summary: "Archive a Task.", usage: "yui task archive <id>" },
+    {
+        name: "archive",
+        summary: "Archive a Task after confirming the main worktree outcome.",
+        usage: "yui task archive <id> (--integrated|--abandon)",
+        options: ["--integrated", "--abandon"]
+    },
     { name: "reconcile", summary: "Run one immediate Controller reconciliation.", usage: "yui task reconcile <id>" },
     {
         name: "message",
         summary: "Manage durable Task messages.",
         sections: [{ id: "manage", title: "Commands", entries: ["send", "list"] }],
         children: [
-            { name: "send", summary: "Send a Task message.", usage: "yui task message send <id> <body>" },
+            {
+                name: "send",
+                summary: "Send a Task message.",
+                usage: "yui task message send <id> (<body>|--body-file <path|->)",
+                options: ["--body-file"],
+                fileOptions: ["--body-file"]
+            },
             { name: "list", summary: "List Task messages.", usage: "yui task message list <id>" }
         ]
     },
@@ -183,13 +261,13 @@ const taskChildren = [
             {
                 name: "show",
                 summary: "Show one input request.",
-                usage: "yui task input show <input> [--task <task>]",
+                usage: "yui task input show (<task>/<input> | <input> --task <task>)",
                 options: ["--task"]
             },
             {
                 name: "answer",
                 summary: "Answer one open input request.",
-                usage: "yui task input answer <input> [--task <task>] (--choice <key> | --text <text>)",
+                usage: "yui task input answer (<task>/<input> | <input> --task <task>) (--choice <key> | --text <text>)",
                 options: ["--task", "--choice", "--text"]
             },
             {
@@ -204,14 +282,14 @@ const taskChildren = [
         name: "role",
         summary: "Manage Roles within a Task.",
         sections: [{ id: "manage", title: "Commands", entries: [
-                    "add", "list", "status", "show", "update", "remove", "bind", "enter"
+                    "add", "list", "status", "show", "update", "remove", "bind", "unbind", "reset", "enter"
                 ] }],
         children: [
             {
                 name: "add",
                 summary: "Add a Role to a Task.",
-                usage: "yui task role add <task> <name> [--agent <id>] [Role and Agent settings]",
-                options: ["--agent", ...roleProfileOptions, ...roleAgentOptions],
+                usage: "yui task role add <task> <name> [--profile <id>] [--agent <id>] [Role and Agent settings]",
+                options: ["--profile", "--agent", ...roleProfileOptions, ...roleAgentOptions],
                 optionValues: roleAgentOptionValues
             },
             { name: "list", summary: "List Task Roles.", usage: "yui task role list <task>" },
@@ -225,57 +303,243 @@ const taskChildren = [
                 name: "update",
                 summary: "Update a Task Role.",
                 usage: "yui task role update <task> <role> [Role and Agent settings]",
-                options: ["--agent", ...roleProfileOptions, ...roleAgentOptions,
+                options: ["--profile", "--agent", ...roleProfileOptions, ...roleAgentOptions,
                     ...roleProfileClearOptions, ...roleAgentClearOptions],
                 optionValues: roleAgentOptionValues
             },
             { name: "remove", summary: "Remove a Task Role.", usage: "yui task role remove <task> <role>" },
             { name: "bind", summary: "Bind and activate an Agent for a Task Role.", usage: "yui task role bind <task> <role> <agent-id>" },
+            { name: "unbind", summary: "Unbind a dormant Agent from a Task Role.", usage: "yui task role unbind <task> <role> <agent-id>" },
+            {
+                name: "reset",
+                summary: "Fail current work, forget the native Session, and request verified cleanup.",
+                usage: "yui task role reset <task> <role> --reason <text>",
+                options: ["--reason"]
+            },
             { name: "enter", summary: "Enter a Task Role's native session.", usage: "yui task role enter <task> <role>" }
         ]
     },
     {
         name: "work",
         summary: "Manage finite Task work items.",
-        sections: [{ id: "manage", title: "Commands", entries: ["create", "list", "update", "dispatch"] }],
+        sections: [{
+                id: "manage",
+                title: "Commands",
+                entries: [
+                    "create", "list", "show", "update", "scope", "dispatch", "isolate", "capture", "cleanup",
+                    "review", "group", "accept", "reject", "retire"
+                ]
+            }],
         children: [
             {
                 name: "create",
                 summary: "Create a work item.",
-                usage: "yui task work create <task> <title> [--role <name>]",
-                options: ["--role"]
+                usage: "yui task work create <task> <title> [--project <project> ...] [--base-ref <project>=<ref> ...] [--objective <text>] [--accept <criterion> ...] [--after <work> ...] [--role <name>]",
+                options: ["--project", "--base-ref", "--objective", "--accept", "--after", "--role"]
             },
             { 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: "update",
                 summary: "Update a work item's state.",
-                usage: "yui task work update <id> <todo|running|done|failed> [--summary <text>]",
+                usage: "yui task work update <task>/<work> <todo|running|done|failed> [--summary <text>]",
                 options: ["--summary"],
-                argumentValues: { 1: ["todo", "running", "done", "failed"] }
+                argumentValues: {
+                    1: ["todo", "running", "done", "failed"]
+                }
+            },
+            {
+                name: "scope",
+                summary: "Expand the Projects a WorkItem may modify.",
+                usage: "yui task work scope <task>/<work> [--project <project> ...]",
+                options: ["--project"]
             },
             {
                 name: "dispatch",
                 summary: "Dispatch a work item to its Role.",
-                usage: "yui task work dispatch <id> [--input <text>]",
-                options: ["--input"]
+                usage: "yui task work dispatch <task>/<work> [--input <text>] [--strategy fixed:<count>|adaptive:<max>] [--lane-role <role> ...]",
+                options: ["--input", "--strategy", "--lane-role"]
+            },
+            {
+                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|blocked> --summary <text> [--lane <lane-id> ...]",
+                        options: ["--decision", "--summary", "--lane"],
+                        optionValues: { "--decision": ["accept", "reject", "blocked"] }
+                    }]
+            },
+            {
+                name: "isolate",
+                summary: "Create a WorkItem-owned isolated worktree.",
+                usage: "yui task work isolate <task>/<work>"
+            },
+            {
+                name: "capture",
+                summary: "Capture a terminal isolated WorkItem result as a ChangeSet.",
+                usage: "yui task work capture <task>/<work>"
+            },
+            {
+                name: "cleanup",
+                summary: "Release an idle WorkItem runtime or remove its final clean worktree.",
+                usage: "yui task work cleanup <task>/<work> (--runtime-only|--integrated|--abandon)",
+                options: ["--runtime-only", "--integrated", "--abandon"]
+            },
+            {
+                name: "review",
+                summary: "Ask the configured reviewer to inspect a WorkItem candidate.",
+                usage: "yui task work review <task>/<work>",
+                executable: true,
+                sections: [
+                    { id: "retry", title: "Task-final recovery", entries: ["retry"] },
+                    { id: "workspace", title: "Review workspace", entries: ["cleanup", "preserve"] }
+                ],
+                children: [
+                    {
+                        name: "retry",
+                        summary: "Retry a failed Task-final ReviewRound that has no Reviewer Run.",
+                        usage: "yui task work review retry <task>/<review-round>"
+                    },
+                    {
+                        name: "cleanup",
+                        summary: "Remove only a clean terminal ReviewRound worktree.",
+                        usage: "yui task work review cleanup <task>/<review-round>"
+                    },
+                    {
+                        name: "preserve",
+                        summary: "Record that a terminal ReviewRound worktree is retained for diagnosis.",
+                        usage: "yui task work review preserve <task>/<review-round>"
+                    }
+                ]
+            },
+            {
+                name: "accept",
+                summary: "Accept a successful, validated, integrated Work Item.",
+                usage: "yui task work accept <task>/<work> --summary <text>",
+                options: ["--summary"]
+            },
+            {
+                name: "reject",
+                summary: "Reject an awaiting Work Item so it can be retried.",
+                usage: "yui task work reject <task>/<work> --summary <text>",
+                options: ["--summary"]
+            },
+            {
+                name: "retire",
+                summary: "Retire a WorkItem and settle its exact Runs.",
+                usage: "yui task work retire <work> --summary <text> [--replacement <work>]",
+                options: ["--summary", "--replacement"]
             }
         ]
     },
     {
         name: "run",
-        summary: "Inspect and control Agent Runs.",
-        sections: [{ id: "manage", title: "Commands", entries: ["list", "retry", "yield"] }],
+        summary: "Inspect and control Task Role Agent Runs.",
+        sections: [{ id: "manage", title: "Commands", entries: ["list", "retry", "settle", "recover", "yield", "checkpoint"] }],
         children: [
-            { name: "list", summary: "List Runs for a work item.", usage: "yui task run list <work>" },
-            { name: "retry", summary: "Retry a failed Run.", usage: "yui task run retry <run>" },
+            { name: "list", summary: "List Runs for a work item.", usage: "yui task run list <task>/<work>" },
+            {
+                name: "retry",
+                summary: "Retry a failed execution Run or request a fresh Round for an exact failed final Review Run.",
+                usage: "yui task run retry <task>/<run>"
+            },
+            {
+                name: "settle",
+                summary: "Close an obsolete stranded final Review Run without requesting a retry Round.",
+                usage: "yui task run settle <task>/<run>"
+            },
+            {
+                name: "recover",
+                summary: "Record one exact Leader-controlled Run recovery decision.",
+                usage: "yui task run recover <task>/<run> --action <diagnose|retry|replace-session|terminate> --expected-progress-at <timestamp> --provider-acceptance <accepted|rejected|ambiguous> --reason <text>",
+                options: ["--action", "--expected-progress-at", "--provider-acceptance", "--reason", "--role", "--agent-id", "--adapter-id", "--native-session-id", "--launch-id"]
+            },
             {
                 name: "yield",
                 summary: "Complete an active Run and wake the Leader.",
-                usage: "yui task run yield <run> --summary <text>",
-                options: ["--summary"]
+                usage: "yui task run yield <task>/<run> (--summary <text>|--summary-file <path|->)",
+                options: ["--summary", "--summary-file"],
+                fileOptions: ["--summary-file"]
+            },
+            {
+                name: "checkpoint",
+                summary: "Record durable progress for a long-running Agent Run.",
+                usage: "yui task run checkpoint <run> (--note <text>|--note-file <path|->)",
+                options: ["--note", "--note-file"],
+                fileOptions: ["--note-file"],
+                hidden: true
             }
         ]
     },
+    {
+        name: "review",
+        summary: "Control Task-final ReviewRounds.",
+        sections: [{ id: "manage", title: "Commands", entries: ["request", "group", "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> ...]",
+                options: ["--role", "--strategy", "--lane-role"]
+            },
+            {
+                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"] }
+                    }]
+            },
+            {
+                name: "retry",
+                summary: "Retry a failed Task-final ReviewRound without a Reviewer Run.",
+                usage: "yui task review retry <task>/<review-round>"
+            }
+        ]
+    },
+    {
+        name: "integration",
+        summary: "Safely integrate ChangeSets with Leader-owned conflict decisions.",
+        sections: [{ id: "manage", title: "Commands", entries: ["start", "continue", "resolve", "abort", "list", "show", "cleanup"] }],
+        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"]
+            },
+            {
+                name: "continue",
+                summary: "Continue a Leader-approved manual resolution.",
+                usage: "yui task integration continue <task>/<integration>"
+            },
+            {
+                name: "resolve",
+                summary: "Record the Leader's semantic conflict decision.",
+                usage: "yui task integration resolve <task>/<integration> --option <manual-resolution|reject> --rationale <text>",
+                options: ["--option", "--rationale"],
+                optionValues: { "--option": ["manual-resolution", "reject"] }
+            },
+            {
+                name: "abort",
+                summary: "Abandon a running or blocked Integration Attempt.",
+                usage: "yui task integration abort <task>/<integration> --reason <text>",
+                options: ["--reason"]
+            },
+            { name: "list", summary: "List Integration Attempts.", usage: "yui task integration list <task>" },
+            { name: "show", summary: "Show one Integration Attempt.", usage: "yui task integration show <task>/<integration>" },
+            { name: "cleanup", summary: "Remove a terminal Integration worktree and branch.", usage: "yui task integration cleanup <task>/<integration>" }
+        ]
+    },
     {
         name: "brief",
         summary: "Manage the Task Brief, the authoritative summary of current task state.",
@@ -285,8 +549,8 @@ const taskChildren = [
             {
                 name: "update",
                 summary: "Create or update the Task Brief.",
-                usage: "yui task brief update <task> [--objective <text>] [--boundary <text> ...] [--focus <text>] [--leader-summary <text>]",
-                options: ["--objective", "--boundary", "--focus", "--leader-summary"]
+                usage: "yui task brief update <task> [--objective <text>] [--boundary <text> ...] [--approach <text>] [--focus <text>] [--leader-summary <text>]",
+                options: ["--objective", "--boundary", "--approach", "--focus", "--leader-summary"]
             }
         ]
     },
@@ -345,21 +609,35 @@ const taskChildren = [
 ];
 export const ROOT_COMMAND = buildNode({
     name: "yui",
-    summary: "Coordinate native Agent CLI sessions through tmux.",
+    summary: "Coordinate durable, isolated Agent work.",
     usage: "yui [--json] <command>",
     sections: [
-        { id: "general", title: "General", entries: ["help", "version", "update", "setup", "doctor", "completion"] },
-        { id: "workflow", title: "Workflow", entries: ["operator", "repository", "task"] },
-        { id: "configuration", title: "Configuration", entries: ["agent", "role"] },
-        { id: "operations", title: "Operations", entries: ["controller", "jobs"] },
+        { id: "general", title: "General", entries: [
+                "help", "version", "update", "upgrade", "setup", "doctor", "completion"
+            ] },
+        { id: "workflow", title: "Workflow", entries: ["operator", "project", "task"] },
+        { id: "configuration", title: "Configuration", entries: ["config", "agent", "profile", "role"] },
+        { id: "operations", title: "Operations", entries: ["web", "controller", "jobs"] },
         { id: "internal", title: "Internal", entries: ["internal"] }
     ],
     children: [
         { name: "help", summary: "Show root or scoped command help.", usage: "yui help [command ...]", commandPathArguments: true },
         { name: "version", summary: "Print the installed Yui version." },
         { name: "update", summary: "Install the latest published Yui package globally." },
+        {
+            name: "upgrade",
+            summary: "Migrate this Home's storage to the current schema.",
+            usage: "yui upgrade [--dry-run]",
+            options: ["--dry-run"]
+        },
         { name: "setup", summary: "Initialize or update Yui configuration." },
         { 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"]
+        },
         {
             name: "completion",
             summary: "Interactively configure shell completion.",
@@ -384,68 +662,206 @@ export const ROOT_COMMAND = buildNode({
         },
         {
             name: "controller",
-            summary: "Inspect, stop, or restart the local Controller.",
-            sections: [{ id: "lifecycle", title: "Commands", entries: ["status", "stop", "restart"] }],
+            summary: "Inspect and recover local Controller runtime resources.",
+            sections: [{
+                    id: "lifecycle",
+                    title: "Commands",
+                    entries: ["status", "cleanup", "identity", "stop", "restart"]
+                }],
             children: [
-                { name: "status", summary: "Show Controller status." },
+                {
+                    name: "status",
+                    summary: "Show Controller and Agent runtime resources.",
+                    usage: "yui controller status [--all] [--verbose]",
+                    options: ["--all", "--verbose"]
+                },
+                {
+                    name: "cleanup",
+                    summary: "Interactively clean confirmed unused runtime resources.",
+                    usage: "yui controller cleanup [--all]",
+                    options: ["--all"]
+                },
+                {
+                    name: "identity",
+                    summary: "Read the authenticated Controller launch identity.",
+                    hidden: true
+                },
                 { name: "stop", summary: "Stop the Controller." },
                 { name: "restart", summary: "Restart internal services without stopping tmux sessions." }
             ]
         },
+        {
+            name: "config",
+            summary: "Inspect or update Yui configuration.",
+            sections: [{ id: "manage", title: "Commands", entries: ["show", "set", "review"] }],
+            children: [
+                { name: "show", summary: "Show effective Yui configuration." },
+                {
+                    name: "set",
+                    summary: "Update Yui configuration.",
+                    usage: "yui config set <--time-zone <IANA timezone> | --reconciliation-interval-seconds <5-300>>",
+                    options: ["--time-zone", "--reconciliation-interval-seconds"]
+                },
+                {
+                    name: "review",
+                    summary: "Configure WorkItem review.",
+                    sections: [{ id: "manage", title: "Commands", entries: ["show", "set", "clear"] }],
+                    children: [
+                        { name: "show", summary: "Show the global review rule." },
+                        {
+                            name: "set",
+                            summary: "Enable review with a Global Role.",
+                            usage: "yui config review set --role <global-role> --trigger <always|leader|final>",
+                            options: ["--role", "--trigger"],
+                            optionValues: { "--trigger": ["always", "leader", "final"] }
+                        },
+                        { name: "clear", summary: "Disable global review." }
+                    ]
+                }
+            ]
+        },
         {
             name: "operator",
-            summary: "Use the persistent Operator Role.",
-            sections: [{ id: "workflow", title: "Commands", entries: ["enter", "submit"] }],
+            summary: "Use the persistent Operator Actor.",
+            sections: [{
+                    id: "workflow",
+                    title: "Commands",
+                    entries: ["enter", "new", "list", "resume", "submit"]
+                }],
             children: [
                 { name: "enter", summary: "Enter the Operator's native session." },
+                {
+                    name: "new",
+                    summary: "Start a new Operator session.",
+                    usage: "yui operator new [--agent <id>]",
+                    options: ["--agent"]
+                },
+                { name: "list", summary: "List Operator session history." },
+                {
+                    name: "resume",
+                    summary: "Resume a previous Operator session.",
+                    usage: "yui operator resume [<ref> | --last]",
+                    options: ["--last"]
+                },
                 {
                     name: "submit",
                     summary: "Submit work through the Operator.",
-                    usage: "yui operator submit <body> [--task <id>]",
-                    options: ["--task"]
+                    usage: "yui operator submit (<body>|--body-file <path|->) [--task <id>]",
+                    options: ["--task", "--body-file"],
+                    fileOptions: ["--body-file"]
                 }
             ]
         },
         {
-            name: "repository",
-            summary: "Manage Git repositories available to Tasks.",
-            sections: [{ id: "manage", title: "Commands", entries: ["add", "list"] }],
+            name: "project",
+            summary: "Manage Projects, stable checkouts, branches, and Yui knowledge.",
+            sections: [{ id: "manage", title: "Commands", entries: ["add", "clone", "refresh", "update", "discover", "list", "show", "knowledge"] }],
             children: [
                 {
                     name: "add",
-                    summary: "Register a Git repository.",
-                    usage: "yui repository add <name> <path> [--base <ref>]",
-                    options: ["--base"],
+                    summary: "Bind a Project to a stable Git checkout.",
+                    usage: "yui project add <name> <path> [--alias <name> ...] [--remote <url>] [--stable <ref>] [--development <ref>]",
+                    options: ["--alias", "--remote", "--stable", "--development"],
                     fileArguments: [1]
                 },
-                { name: "list", summary: "List registered repositories." }
+                {
+                    name: "clone",
+                    summary: "Clone and bind a Project after user confirmation.",
+                    usage: "yui project clone <name> <remote> [--alias <name> ...] [--stable <ref>] [--development <ref>]",
+                    options: ["--alias", "--stable", "--development"]
+                },
+                {
+                    name: "refresh",
+                    summary: "Fast-forward a clean stable checkout from its configured remote.",
+                    usage: "yui project refresh <project>"
+                },
+                {
+                    name: "update",
+                    summary: "Update a bound Project's aliases, remote, or branch refs.",
+                    usage: "yui project update <project> [--alias <name> ...|--clear-aliases] [--remote <url>|--clear-remote] [--stable <ref>] [--development <ref>]",
+                    options: [
+                        "--alias", "--clear-aliases", "--remote", "--clear-remote",
+                        "--stable", "--development"
+                    ]
+                },
+                {
+                    name: "discover",
+                    summary: "Find Git projects directly under the configured workspace.",
+                    usage: "yui project discover [name]"
+                },
+                { name: "list", summary: "List bound Projects." },
+                { name: "show", summary: "Show one Project.", usage: "yui project show <project>" },
+                {
+                    name: "knowledge",
+                    summary: "Manage durable Project knowledge stored by Yui.",
+                    sections: [{ id: "manage", title: "Commands", entries: ["add", "update", "retire", "list", "show"] }],
+                    children: [
+                        {
+                            name: "add",
+                            summary: "Add Project knowledge.",
+                            usage: "yui project knowledge add <project> <title> --body <text>",
+                            options: ["--body"]
+                        },
+                        {
+                            name: "update",
+                            summary: "Update active Project knowledge.",
+                            usage: "yui project knowledge update <project> <knowledge> [--title <text>] [--body <text>]",
+                            options: ["--title", "--body"]
+                        },
+                        {
+                            name: "retire",
+                            summary: "Retire Project knowledge without deleting its record.",
+                            usage: "yui project knowledge retire <project> <knowledge>"
+                        },
+                        {
+                            name: "list",
+                            summary: "List Project knowledge.",
+                            usage: "yui project knowledge list <project> [--all]",
+                            options: ["--all"]
+                        },
+                        {
+                            name: "show",
+                            summary: "Read one Project knowledge entry.",
+                            usage: "yui project knowledge show <project> <knowledge>"
+                        }
+                    ]
+                }
             ]
         },
         {
             name: "agent",
             summary: "Manage configured native Agent CLIs.",
             sections: [
-                { id: "inspect", title: "Inspect", entries: ["list", "show"] },
+                { id: "inspect", title: "Inspect", entries: ["list", "show", "capabilities"] },
                 { id: "manage", title: "Manage", entries: ["add", "update", "remove"] }
             ],
             children: agentChildren
         },
+        {
+            name: "profile",
+            summary: "Manage reusable Agent Profiles.",
+            sections: [
+                { id: "inspect", title: "Inspect", entries: ["list", "show"] },
+                { id: "manage", title: "Manage", entries: ["add", "update", "remove", "reset"] }
+            ],
+            children: profileChildren
+        },
         {
             name: "role",
             summary: "Manage reusable global Roles and their native sessions.",
             sections: [
                 { id: "inspect", title: "Inspect", entries: ["list", "show"] },
-                { id: "manage", title: "Manage", entries: ["add", "update", "remove", "bind"] },
+                { id: "manage", title: "Manage", entries: ["add", "update", "remove", "bind", "unbind"] },
                 { id: "sessions", title: "Sessions", entries: ["enter", "session"] }
             ],
             children: roleChildren
         },
         {
             name: "task",
-            summary: "Manage Tasks, Roles, work items, and Runs.",
+            summary: "Manage Tasks, WorkItems, Agent Runs, and integration.",
             sections: [
-                { id: "lifecycle", title: "Lifecycle", entries: ["create", "update", "activate", "complete", "reopen", "list", "show", "context", "archive", "reconcile"] },
-                { id: "collaboration", title: "Collaboration", entries: ["message", "input", "role", "work", "run", "enter"] },
+                { id: "lifecycle", title: "Lifecycle", entries: ["create", "project", "update", "activate", "complete", "reopen", "retire", "list", "show", "context", "archive", "reconcile"] },
+                { id: "collaboration", title: "Collaboration", entries: ["message", "input", "work", "run", "review", "integration", "role", "enter"] },
                 { id: "knowledge", title: "Task Knowledge", entries: ["brief", "decision", "milestone", "event"] }
             ],
             children: taskChildren
@@ -463,12 +879,24 @@ export const ROOT_COMMAND = buildNode({
             name: "internal",
             summary: "Internal Yui callbacks.",
             hidden: true,
-            sections: [{ id: "callbacks", title: "Callbacks", entries: ["session-notify"] }],
-            children: [{
+            sections: [{ id: "callbacks", title: "Callbacks", entries: ["session-notify", "claude-hook", "codex-hook"] }],
+            children: [
+                {
                     name: "session-notify",
                     summary: "Record a structured native session notification.",
                     usage: "yui internal session-notify <payload>"
-                }]
+                },
+                {
+                    name: "claude-hook",
+                    summary: "Record a managed Claude StopFailure event from stdin.",
+                    usage: "yui internal claude-hook"
+                },
+                {
+                    name: "codex-hook",
+                    summary: "Record managed Codex provider lifecycle evidence from stdin.",
+                    usage: "yui internal codex-hook"
+                }
+            ]
         }
     ]
 });