@zq-silk/yui 0.2.0 → 0.4.2

package/dist/cli/interactionPolicy.js

@@ -9,7 +9,49 @@ const taskTarget = (command, argumentIndex = 2, statuses) => ({
         }]
 });
 export const INTERACTION_POLICIES = Object.freeze([
-    ...["show", "update", "remove"].map((command) => ({
+    {
+        commandPath: ["project", "refresh"],
+        selectors: [{
+                argumentIndex: 2,
+                entity: "project",
+                provider: "projects",
+                actionTarget: true
+            }]
+    },
+    {
+        commandPath: ["project", "update"],
+        selectors: [{
+                argumentIndex: 2,
+                entity: "project",
+                provider: "projects",
+                actionTarget: true
+            }],
+        trailingOptions: {
+            "--alias": "value",
+            "--clear-aliases": "flag",
+            "--remote": "value",
+            "--clear-remote": "flag",
+            "--stable": "value",
+            "--development": "value"
+        }
+    },
+    ...["add", "update", "retire", "list", "show"].map((command) => ({
+        commandPath: ["project", "knowledge", command],
+        selectors: [{
+                argumentIndex: 3,
+                entity: "project",
+                provider: "projects",
+                actionTarget: command !== "list"
+            }],
+        ...(command === "add"
+            ? { trailingOptions: { "--body": "value" } }
+            : command === "update"
+                ? { trailingOptions: { "--title": "value", "--body": "value" } }
+                : command === "list"
+                    ? { trailingOptions: { "--all": "flag" } }
+                    : {})
+    })),
+    ...["show", "capabilities", "update", "remove"].map((command) => ({
         commandPath: ["agent", command],
         selectors: [{
                 argumentIndex: 2,
@@ -34,8 +76,9 @@ export const INTERACTION_POLICIES = Object.freeze([
             "--agent": "value", "--workspace": "value", "--description": "value",
             "--responsibility": "value", "--constraint": "value", "--expected-output": "value",
             "--system-prompt": "value", "--skill": "value", "--model": "value",
-            "--effort": "value", "--sandbox": "value", "--approval": "value",
-            "--permission-mode": "value", "--search": "value"
+            "--effort": "value", "--permission-strategy": "value", "--sandbox": "value", "--approval": "value",
+            "--permission-mode": "value", "--allowed-tool": "value", "--disallowed-tool": "value",
+            "--search": "value"
         }
     },
     ...["show", "update", "remove", "enter"].map((command) => ({
@@ -50,13 +93,13 @@ export const INTERACTION_POLICIES = Object.freeze([
             ? { confirmation: { action: "Remove Role", targetArgumentIndex: 2 } }
             : {})
     })),
-    {
-        commandPath: ["role", "bind"],
+    ...["bind", "unbind"].map((command) => ({
+        commandPath: ["role", command],
         selectors: [
             { argumentIndex: 2, entity: "global-role", provider: "global-roles", actionTarget: true },
             { argumentIndex: 3, entity: "agent", provider: "configured-agents", actionTarget: false }
         ]
-    },
+    })),
     ...["record", "replace"].map((command) => ({
         commandPath: ["role", "session", command],
         selectors: [{
@@ -69,6 +112,36 @@ export const INTERACTION_POLICIES = Object.freeze([
             ? { "--native-id": "value", "--reason": "value" }
             : { "--native-id": "value" }
     })),
+    {
+        commandPath: ["profile", "add"],
+        selectors: [],
+        trailingOptions: {
+            "--description": "value", "--instructions": "value",
+            "--skill": "value", "--model": "value", "--effort": "value", "--access": "value"
+        }
+    },
+    ...["show", "update", "remove"].map((command) => ({
+        commandPath: ["profile", command],
+        selectors: [{
+                argumentIndex: 2,
+                entity: "agent-profile",
+                provider: "agent-profiles",
+                actionTarget: true
+            }],
+        ...(command === "update"
+            ? {
+                trailingOptions: {
+                    "--description": "option-like-value",
+                    "--instructions": "option-like-value", "--skill": "value",
+                    "--model": "option-like-value", "--effort": "option-like-value",
+                    "--access": "value"
+                }
+            }
+            : {}),
+        ...(command === "remove"
+            ? { confirmation: { action: "Remove Agent Profile", targetArgumentIndex: 2 } }
+            : {})
+    })),
     taskTarget("show"),
     taskTarget("context"),
     {
@@ -92,7 +165,22 @@ export const INTERACTION_POLICIES = Object.freeze([
     },
     taskTarget("reopen", 2, ["completed"]),
     {
-        ...taskTarget("archive"),
+        ...taskTarget("retire", 2, ["draft", "active"]),
+        trailingOptions: {
+            "--summary": "value",
+            "--summary-file": "value",
+            "--replacement": "value"
+        },
+        confirmation: { action: "Retire task", targetArgumentIndex: 2 }
+    },
+    {
+        commandPath: ["task", "list"],
+        selectors: [],
+        trailingOptions: { "--all": "flag", "--verbose": "flag" }
+    },
+    {
+        ...taskTarget("archive", 2, ["completed", "retired"]),
+        trailingOptions: { "--integrated": "flag", "--abandon": "flag" },
         confirmation: { action: "Archive task", targetArgumentIndex: 2 }
     },
     taskTarget("reconcile"),
@@ -109,12 +197,12 @@ export const INTERACTION_POLICIES = Object.freeze([
     {
         commandPath: ["task", "create"],
         selectors: [{
-                option: "--repository",
-                entity: "repository",
-                provider: "repositories",
+                option: "--project",
+                entity: "project",
+                provider: "projects",
                 actionTarget: false
             }],
-        trailingOptions: { "--repository": "value", "--base": "value" }
+        trailingOptions: { "--project": "value", "--base": "value" }
     },
     ...["send", "list"].map((command) => ({
         commandPath: ["task", "message", command],
@@ -189,14 +277,20 @@ export const INTERACTION_POLICIES = Object.freeze([
         commandPath: ["task", "role", "add"],
         selectors: [
             { argumentIndex: 3, entity: "task", provider: "tasks", actionTarget: true },
-            { option: "--agent", entity: "agent", provider: "configured-agents", actionTarget: false }
+            { option: "--profile", entity: "agent-profile", provider: "agent-profiles", actionTarget: false },
+            {
+                option: "--agent",
+                entity: "agent",
+                provider: "configured-agents",
+                actionTarget: false
+            }
         ],
         trailingOptions: {
-            "--agent": "value", "--description": "value", "--responsibility": "value",
+            "--profile": "value", "--agent": "value", "--description": "value", "--responsibility": "value",
             "--constraint": "value", "--expected-output": "value", "--system-prompt": "value",
             "--skill": "value", "--model": "value", "--effort": "value",
-            "--sandbox": "value", "--approval": "value", "--permission-mode": "value",
-            "--search": "value"
+            "--permission-strategy": "value", "--sandbox": "value", "--approval": "value", "--permission-mode": "value",
+            "--allowed-tool": "value", "--disallowed-tool": "value", "--search": "value"
         }
     },
     {
@@ -213,14 +307,20 @@ export const INTERACTION_POLICIES = Object.freeze([
                 provider: "task-roles",
                 dependsOn: 3,
                 actionTarget: true
-            }
+            },
+            ...(command === "update"
+                ? [
+                    { option: "--profile", entity: "agent-profile", provider: "agent-profiles", actionTarget: false },
+                    { option: "--agent", entity: "agent", provider: "configured-agents", actionTarget: false }
+                ]
+                : [])
         ],
         ...(command === "remove"
             ? { confirmation: { action: "Remove Task Role", targetArgumentIndex: 4 } }
             : {})
     })),
-    {
-        commandPath: ["task", "role", "bind"],
+    ...["bind", "unbind"].map((command) => ({
+        commandPath: ["task", "role", command],
         selectors: [
             { argumentIndex: 3, entity: "task", provider: "tasks", actionTarget: true },
             {
@@ -232,6 +332,21 @@ export const INTERACTION_POLICIES = Object.freeze([
             },
             { argumentIndex: 5, entity: "agent", provider: "configured-agents", actionTarget: false }
         ]
+    })),
+    {
+        commandPath: ["task", "role", "reset"],
+        selectors: [
+            { argumentIndex: 3, entity: "task", provider: "tasks", actionTarget: true, statuses: ["active"] },
+            {
+                argumentIndex: 4,
+                entity: "task-role",
+                provider: "task-roles",
+                dependsOn: 3,
+                actionTarget: true
+            }
+        ],
+        trailingOptions: { "--reason": "value" },
+        confirmation: { action: "Reset Task Role Session", targetArgumentIndex: 4 }
     },
     {
         commandPath: ["task", "role", "enter"],
@@ -258,30 +373,152 @@ export const INTERACTION_POLICIES = Object.freeze([
                 actionTarget: false
             }
         ],
-        trailingOptions: { "--role": "value" }
+        trailingOptions: {
+            "--objective": "value", "--accept": "value", "--after": "value", "--role": "value"
+        }
     },
     {
         commandPath: ["task", "work", "list"],
         selectors: [{ argumentIndex: 3, entity: "task", provider: "tasks", actionTarget: true }]
     },
+    ...["show", "update", "dispatch", "isolate", "capture", "cleanup", "accept", "reject"]
+        .map((command) => ({
+        commandPath: ["task", "work", command],
+        selectors: [{
+                argumentIndex: 3,
+                entity: "work-item",
+                provider: "work-items",
+                actionTarget: true
+            }],
+        ...(command === "update"
+            ? { trailingOptions: { "--summary": "value" } }
+            : command === "dispatch"
+                ? { trailingOptions: { "--input": "value" } }
+                : command === "cleanup"
+                    ? {
+                        trailingOptions: {
+                            "--integrated": "flag",
+                            "--abandon": "flag"
+                        }
+                    }
+                    : ["accept", "reject"].includes(command)
+                        ? { trailingOptions: { "--summary": "value" } }
+                        : {})
+    })),
     {
-        commandPath: ["task", "work", "update"],
-        selectors: [{ argumentIndex: 3, entity: "work-item", provider: "work-items", actionTarget: true }],
-        trailingOptions: { "--summary": "value" }
-    },
-    {
-        commandPath: ["task", "work", "dispatch"],
-        selectors: [{ argumentIndex: 3, entity: "work-item", provider: "work-items", actionTarget: true }],
-        trailingOptions: { "--input": "value" }
+        commandPath: ["task", "work", "retire"],
+        selectors: [
+            {
+                argumentIndex: 3,
+                entity: "work-item",
+                provider: "work-items",
+                actionTarget: true
+            },
+            {
+                option: "--replacement",
+                entity: "work-item",
+                provider: "work-items",
+                dependsOn: 3,
+                actionTarget: false
+            }
+        ],
+        trailingOptions: { "--summary": "value", "--replacement": "value" },
+        confirmation: { action: "Retire Work Item", targetArgumentIndex: 3 }
     },
     {
         commandPath: ["task", "run", "list"],
-        selectors: [{ argumentIndex: 3, entity: "work-item", provider: "work-items", actionTarget: true }]
+        selectors: [{ argumentIndex: 3, entity: "work-item", provider: "work-items", actionTarget: true }],
     },
     ...["retry", "yield"].map((command) => ({
         commandPath: ["task", "run", command],
-        selectors: [{ argumentIndex: 3, entity: "run", provider: "runs", actionTarget: true }],
-        ...(command === "yield" ? { trailingOptions: { "--summary": "value" } } : {})
+        selectors: [{
+                argumentIndex: 3,
+                entity: "run",
+                provider: "runs",
+                actionTarget: true
+            }],
+        ...(command === "yield"
+            ? { trailingOptions: { "--summary": "value" } }
+            : {})
+    })),
+    {
+        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: [
+            {
+                argumentIndex: 3,
+                entity: "task",
+                provider: "tasks",
+                actionTarget: true,
+                statuses: ["active"]
+            },
+            {
+                option: "--role",
+                entity: "global-role",
+                provider: "global-roles",
+                actionTarget: false
+            }
+        ],
+        trailingOptions: { "--role": "value", "--strategy": "value", "--lane-role": "value" }
+    },
+    {
+        commandPath: ["task", "integration", "start"],
+        selectors: [
+            { argumentIndex: 3, entity: "task", provider: "tasks", actionTarget: true },
+            {
+                option: "--change-set",
+                requiredOption: true,
+                entity: "change-set",
+                provider: "change-sets",
+                dependsOn: 3,
+                actionTarget: false
+            }
+        ],
+        trailingOptions: { "--change-set": "value", "--target": "value", "--check": "value" }
+    },
+    {
+        commandPath: ["task", "integration", "list"],
+        selectors: [{ argumentIndex: 3, entity: "task", provider: "tasks", actionTarget: true }]
+    },
+    {
+        commandPath: ["task", "integration", "cleanup"],
+        selectors: [{
+                argumentIndex: 3,
+                entity: "integration-attempt",
+                provider: "integration-attempts",
+                actionTarget: true,
+                statuses: ["committed", "failed"]
+            }]
+    },
+    ...["show", "continue", "resolve", "abort"].map((command) => ({
+        commandPath: ["task", "integration", command],
+        selectors: [{
+                argumentIndex: 3,
+                entity: "integration-attempt",
+                provider: "integration-attempts",
+                actionTarget: true,
+                ...(command === "continue" ? { statuses: ["blocked", "validating"] } : {}),
+                ...(command === "resolve" ? { statuses: ["blocked"] } : {}),
+                ...(command === "abort" ? { statuses: ["running", "blocked"] } : {})
+            }],
+        ...(command === "resolve"
+            ? { trailingOptions: { "--option": "value", "--rationale": "value" } }
+            : command === "abort"
+                ? { trailingOptions: { "--reason": "value" } }
+                : {})
     })),
     {
         commandPath: ["task", "enter"],

package/dist/cli/interactiveSelection.js

@@ -92,11 +92,13 @@ function interactionPrerequisitesReady(args, node, policy) {
         if (token.startsWith("--")) {
             const optionIndex = args.indexOf(token);
             const next = tail[index + 1];
-            if (optionIndex < 0)
+            const selectable = policy?.selectors.some((selector) => selector.option === token) === true
+                || Object.hasOwn(node.optionValues, token);
+            if (optionIndex < 0 && !selectable)
                 return false;
             if (next?.startsWith("<") === true) {
                 const value = args[optionIndex + 1];
-                if (value === undefined || value.startsWith("--"))
+                if ((value === undefined || value.startsWith("--")) && !selectable)
                     return false;
                 index += 1;
             }
@@ -116,6 +118,8 @@ function interactionPrerequisitesReady(args, node, policy) {
         const optionIndex = args.indexOf(option);
         if (optionIndex < 0)
             continue;
+        if (policy?.trailingOptions?.[option] === "flag")
+            continue;
         const value = args[optionIndex + 1];
         const selectable = policy?.selectors.some((selector) => selector.option === option) === true
             || Object.hasOwn(node.optionValues, option);

package/dist/cli/invocationRouter.js

@@ -30,7 +30,11 @@ function resolveExecutionPath(args) {
         if (node.kind === "leaf")
             break;
         const child = findChild(node, args[index] ?? "");
-        if (child === undefined) {
+        const internalExecutable = child !== undefined && ((node === ROOT_COMMAND && child.name === "internal")
+            || (node.path.join(" ") === "yui completion" && child.name === "candidates")
+            || (node.path.join(" ") === "yui task run" && child.name === "checkpoint")
+            || (node.path.join(" ") === "yui controller" && child.name === "identity"));
+        if (child === undefined || (child.hidden && !internalExecutable)) {
             if (node.kind === "hybrid" && node.acceptsArguments)
                 break;
             return {

package/dist/cli/operatorWizard.js

@@ -0,0 +1,87 @@
+import { renderTable } from "../output/table.js";
+import { formatRelativeTimestamp } from "../output/timePresentation.js";
+export async function resolveOperatorWizardArguments(commandArgs, role, sessions, io, now = new Date()) {
+    const args = [...commandArgs];
+    if (!io.interactive || io.json || role === null || args[0] !== "operator") {
+        return { kind: "unchanged", args };
+    }
+    if (args[1] === "new" && args.length === 2) {
+        const bindings = Object.values(role.agentBindings);
+        if (bindings.length === 0)
+            return { kind: "unchanged", args };
+        const selected = bindings.length === 1
+            ? bindings[0]?.agentId
+            : await choose("Select Operator Agent", bindings.map((binding) => ({
+                value: binding.agentId,
+                cells: [
+                    adapterLabel(binding.adapterId),
+                    binding.agentId,
+                    binding.agentId === role.activeAgentId ? "active" : "bound"
+                ]
+            })), [
+                { header: "Adapter", minWidth: 7, maxWidth: 12 },
+                { header: "Agent", minWidth: 6, maxWidth: 24 },
+                { header: "State", minWidth: 6, maxWidth: 8 }
+            ], io, role.activeAgentId, "Agent");
+        return selected === undefined
+            ? { kind: "cancelled", args }
+            : { kind: "resolved", args: [...args, "--agent", selected] };
+    }
+    if (args[1] === "resume" && args.length === 2) {
+        const newSession = "__operator_new_session__";
+        const selected = await choose("Resume an Operator session", [
+            ...sessions.map((session) => ({
+                value: session.ref,
+                cells: [
+                    formatRelativeTimestamp(session.updatedAt, now),
+                    adapterLabel(session.adapterId),
+                    session.displayTitle,
+                    session.state
+                ]
+            })),
+            {
+                value: newSession,
+                cells: ["", "", "Start a new session", "new"]
+            }
+        ], [
+            { header: "Updated", minWidth: 7, maxWidth: 12 },
+            { header: "Agent", minWidth: 6, maxWidth: 12 },
+            { header: "Conversation", minWidth: 20, maxWidth: 64 },
+            { header: "State", minWidth: 7, maxWidth: 10 }
+        ], io, sessions[0]?.ref ?? newSession, "session");
+        if (selected === newSession) {
+            return resolveOperatorWizardArguments(["operator", "new"], role, sessions, io, now);
+        }
+        return selected === undefined
+            ? { kind: "cancelled", args }
+            : { kind: "resolved", args: [...args, selected] };
+    }
+    return { kind: "unchanged", args };
+}
+async function choose(title, choices, columns, io, defaultValue, label) {
+    if (choices.length === 0) {
+        io.write("○ No Operator sessions are available.\n");
+        return undefined;
+    }
+    io.write(`${renderTable(title, [{ header: "#", minWidth: 1, maxWidth: 4 }, ...columns], choices.map((choice, index) => [String(index + 1), ...choice.cells]), io.width)}\n\n`);
+    const answer = (await io.question(`Choose ${label} [1-${choices.length}/value, q]: `))?.trim();
+    if (answer === undefined || answer.toLowerCase() === "q" || answer.toLowerCase() === "quit") {
+        return undefined;
+    }
+    if (answer.length === 0) {
+        return choices.find((choice) => choice.value === defaultValue)?.value
+            ?? choices[0]?.value;
+    }
+    const index = Number(answer);
+    if (Number.isSafeInteger(index) && index >= 1 && index <= choices.length) {
+        return choices[index - 1]?.value;
+    }
+    return choices.find((choice) => choice.value === answer)?.value;
+}
+function adapterLabel(adapterId) {
+    return adapterId === "codex"
+        ? "Codex"
+        : adapterId === "claude"
+            ? "Claude"
+            : adapterId;
+}

package/dist/cli/roleOptionCatalog.js

@@ -4,6 +4,7 @@ const CLAUDE_ONLY = Object.freeze(["claude"]);
 export const ROLE_AGENT_OPTION_SPECS = Object.freeze([
     roleAgentOption("--model", "model", "model", false, BOTH_ADAPTERS),
     roleAgentOption("--effort", "effort", "effort", false, BOTH_ADAPTERS),
+    roleAgentOption("--permission-strategy", "permission.strategy", "strategy", false, BOTH_ADAPTERS, { staticValues: ["default", "bypass", "configured"] }),
     roleAgentOption("--sandbox", "permission.sandbox", "mode", false, CODEX_ONLY),
     roleAgentOption("--approval", "permission.approval", "policy", false, CODEX_ONLY),
     roleAgentOption("--permission-mode", "permission.mode", "mode", false, CLAUDE_ONLY),