@skrr-ai/cli 0.1.14 → 0.1.17

package/dist/commands/agents/instructions/preview.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../../base-command");
+const agent_resolver_1 = require("../../../lib/agent-resolver");
+const agent_instructions_1 = require("../../../lib/agent-instructions");
+class AgentsInstructionsPreview extends base_command_1.BaseCommand {
+    static description = 'Revalidate and preview the exact custom instructions an Agent composition renders';
+    static examples = [
+        '<%= config.bin %> agents instructions preview <agent-id>',
+        '<%= config.bin %> agents instructions preview --json',
+    ];
+    static args = {
+        id: core_1.Args.string({
+            description: 'Agent ID. Omit to use OVERSKY_SESSION_AGENT_ID.',
+            required: false,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output preview metadata and text as JSON' }),
+        agent: core_1.Flags.string({ description: 'Agent ID (alias for the positional argument)' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AgentsInstructionsPreview);
+        let agentId;
+        try {
+            agentId = await (0, agent_instructions_1.resolveInstructionAgentId)(args.id, flags.agent);
+        }
+        catch (error) {
+            const failure = (0, agent_resolver_1.agentResolutionFailure)(error);
+            this.failWithCliError({
+                message: failure.message,
+                code: failure.code,
+                exit: 2,
+                retryable: false,
+            });
+        }
+        let preview;
+        try {
+            const { composition } = await (0, agent_instructions_1.loadAgentInstructions)(agentId);
+            preview = await data_provider_1.dataService.previewInstructionComposition(composition);
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+        if (flags.json)
+            return this.log(JSON.stringify({ agentId, ...preview }, null, 2));
+        this.log(`Agent: ${agentId}`);
+        this.log(`Compiled: ${preview.bytes} bytes · ~${preview.estimatedTokens} tokens · ${preview.composition.entries.length} block(s)`);
+        this.log('');
+        this.log(preview.instructions || '(No enabled custom instruction blocks.)');
+        this.log('');
+        this.log('This is behavior guidance only; it does not grant tools, integrations, scope, or approval authority.');
+    }
+}
+exports.default = AgentsInstructionsPreview;

package/dist/commands/agents/instructions/remove.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../../base-command';
+export default class AgentsInstructionsRemove extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        instance: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        agent: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/agents/instructions/remove.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const agent_resolver_1 = require("../../../lib/agent-resolver");
+const agent_instructions_1 = require("../../../lib/agent-instructions");
+const instruction_blocks_1 = require("../../../lib/instruction-blocks");
+class AgentsInstructionsRemove extends base_command_1.BaseCommand {
+    static description = 'Remove one instruction block from an Agent (the library source remains intact)';
+    static examples = [
+        '<%= config.bin %> agents instructions remove library_… --agent <agent-id>',
+    ];
+    static args = {
+        instance: core_1.Args.string({ description: 'Block instance ID', required: true, ignoreStdin: true }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output the updated Agent as JSON' }),
+        agent: core_1.Flags.string({ description: 'Agent ID (alias for the positional argument)' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AgentsInstructionsRemove);
+        let agentId;
+        try {
+            agentId = await (0, agent_instructions_1.resolveInstructionAgentId)(undefined, flags.agent);
+        }
+        catch (error) {
+            const failure = (0, agent_resolver_1.agentResolutionFailure)(error);
+            this.failWithCliError({
+                message: failure.message,
+                code: failure.code,
+                exit: 2,
+                retryable: false,
+            });
+        }
+        let updated;
+        try {
+            const { composition } = await (0, agent_instructions_1.loadAgentInstructions)(agentId);
+            updated = await (0, agent_instructions_1.saveAgentInstructions)(agentId, (0, instruction_blocks_1.removeEntry)(composition, args.instance));
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+        if (flags.json)
+            return this.log(JSON.stringify(updated, null, 2));
+        this.log(`Removed ${args.instance} from ${agentId}. The reusable library block, if any, was not changed.`);
+    }
+}
+exports.default = AgentsInstructionsRemove;

package/dist/commands/agents/instructions/set.d.ts

@@ -0,0 +1,17 @@
+import { BaseCommand } from '../../../base-command';
+/** Replace a composition atomically — the automation-friendly escape hatch. */
+export default class AgentsInstructionsSet extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        agent: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        file: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        empty: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        yes: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/agents/instructions/set.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const agent_resolver_1 = require("../../../lib/agent-resolver");
+const agent_instructions_1 = require("../../../lib/agent-instructions");
+const prompt_1 = require("../../../lib/prompt");
+/** Replace a composition atomically — the automation-friendly escape hatch. */
+class AgentsInstructionsSet extends base_command_1.BaseCommand {
+    static description = 'Replace an Agent’s instruction composition from JSON (the server validates and compiles it atomically)';
+    static examples = [
+        '<%= config.bin %> agents instructions set <agent-id> --file composition.json',
+        'cat composition.json | <%= config.bin %> agents instructions set --file -',
+        '<%= config.bin %> agents instructions set <agent-id> --empty --yes',
+    ];
+    static args = {
+        id: core_1.Args.string({
+            description: 'Agent ID. Omit to use OVERSKY_SESSION_AGENT_ID.',
+            required: false,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output the updated Agent as JSON' }),
+        agent: core_1.Flags.string({ description: 'Agent ID (alias for the positional argument)' }),
+        file: core_1.Flags.string({ description: 'Composition JSON file, or - for stdin' }),
+        empty: core_1.Flags.boolean({ description: 'Remove every custom instruction block' }),
+        yes: core_1.Flags.boolean({ char: 'y', description: 'Required with --empty' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AgentsInstructionsSet);
+        if (Boolean(flags.file) === Boolean(flags.empty)) {
+            this.error('Provide exactly one of --file or --empty.', { exit: 2 });
+        }
+        if (flags.empty && !flags.yes) {
+            this.error('Refusing to remove all custom instructions without --yes.', { exit: 2 });
+        }
+        let agentId;
+        try {
+            agentId = await (0, agent_instructions_1.resolveInstructionAgentId)(args.id, flags.agent);
+        }
+        catch (error) {
+            const failure = (0, agent_resolver_1.agentResolutionFailure)(error);
+            this.failWithCliError({
+                message: failure.message,
+                code: failure.code,
+                exit: 2,
+                retryable: false,
+            });
+        }
+        let composition;
+        try {
+            composition = flags.empty
+                ? { schemaVersion: 1, entries: [] }
+                : (await (0, prompt_1.readJsonBody)(flags.file));
+            if (!composition ||
+                typeof composition !== 'object' ||
+                composition.schemaVersion !== 1 ||
+                !Array.isArray(composition.entries)) {
+                throw new Error('Composition JSON must contain { "schemaVersion": 1, "entries": [...] }.');
+            }
+        }
+        catch (error) {
+            this.error(error.message, { exit: 2 });
+        }
+        let updated;
+        try {
+            updated = await (0, agent_instructions_1.saveAgentInstructions)(agentId, composition);
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+        if (flags.json)
+            return this.log(JSON.stringify(updated, null, 2));
+        this.log(`Replaced custom instructions for ${agentId}; the server compiled and saved the new composition.`);
+    }
+}
+exports.default = AgentsInstructionsSet;

package/dist/commands/agents/instructions/show.d.ts

@@ -0,0 +1,15 @@
+import { BaseCommand } from '../../../base-command';
+/** Inspect the editable composition, not merely its legacy rendered string. */
+export default class AgentsInstructionsShow extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        agent: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        rendered: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/agents/instructions/show.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const agent_resolver_1 = require("../../../lib/agent-resolver");
+const agent_instructions_1 = require("../../../lib/agent-instructions");
+/** Inspect the editable composition, not merely its legacy rendered string. */
+class AgentsInstructionsShow extends base_command_1.BaseCommand {
+    static description = 'Show an Agent’s custom-instruction composition, ordering, versions, and instance IDs';
+    static examples = [
+        '<%= config.bin %> agents instructions show <agent-id>',
+        '<%= config.bin %> agents instructions show --rendered',
+        '<%= config.bin %> agents instructions show <agent-id> --json',
+    ];
+    static args = {
+        id: core_1.Args.string({
+            description: 'Agent ID. Omit to use OVERSKY_SESSION_AGENT_ID.',
+            required: false,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+        agent: core_1.Flags.string({ description: 'Agent ID (alias for the positional argument)' }),
+        rendered: core_1.Flags.boolean({ description: 'Also print the exact compiled custom instructions' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AgentsInstructionsShow);
+        let agentId;
+        try {
+            agentId = await (0, agent_instructions_1.resolveInstructionAgentId)(args.id, flags.agent);
+        }
+        catch (error) {
+            const failure = (0, agent_resolver_1.agentResolutionFailure)(error);
+            this.failWithCliError({
+                message: failure.message,
+                code: failure.code,
+                exit: 2,
+                retryable: false,
+                details: { suggestion: failure.suggestion, context: failure.details },
+            });
+        }
+        let loaded;
+        try {
+            loaded = await (0, agent_instructions_1.loadAgentInstructions)(agentId);
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+        const { agent, composition } = loaded;
+        if (flags.json) {
+            this.log(JSON.stringify({
+                agentId,
+                composition,
+                instructions: agent.instructions ?? '',
+            }, null, 2));
+            return;
+        }
+        this.log(`Agent: ${agent.name ?? agentId} (${agentId})`);
+        this.log(`Revision: ${composition.revisionId ?? 'legacy/unsaved'} · ${composition.entries.length} block(s)`);
+        this.log('');
+        for (const line of (0, agent_instructions_1.renderCompositionLines)(composition))
+            this.log(line);
+        if (flags.rendered) {
+            this.log('');
+            this.log('Compiled instructions:');
+            this.log(agent.instructions || '(No enabled custom instruction blocks.)');
+        }
+        else {
+            this.log('');
+            this.log('Use --rendered to inspect the exact compiled text, or `preview` to revalidate it.');
+        }
+    }
+}
+exports.default = AgentsInstructionsShow;

package/dist/commands/agents/instructions/upgrade.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../../../base-command';
+/** Explicit is intentional: no library editor can silently change a live Agent. */
+export default class AgentsInstructionsUpgrade extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        instance: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        agent: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        version: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        latest: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/agents/instructions/upgrade.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../../base-command");
+const agent_resolver_1 = require("../../../lib/agent-resolver");
+const agent_instructions_1 = require("../../../lib/agent-instructions");
+const instruction_blocks_1 = require("../../../lib/instruction-blocks");
+/** Explicit is intentional: no library editor can silently change a live Agent. */
+class AgentsInstructionsUpgrade extends base_command_1.BaseCommand {
+    static description = 'Move one attached library block to a reviewed version explicitly';
+    static examples = [
+        '<%= config.bin %> agents instructions upgrade library_… --agent <agent-id> --version 2',
+        '<%= config.bin %> agents instructions upgrade library_… --agent <agent-id> --latest',
+    ];
+    static args = {
+        instance: core_1.Args.string({
+            description: 'Library block instance ID',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output the updated Agent as JSON' }),
+        agent: core_1.Flags.string({ description: 'Agent ID (alias for the positional argument)' }),
+        version: core_1.Flags.integer({ description: 'Exact version to pin' }),
+        latest: core_1.Flags.boolean({ description: 'Pin the source’s current version' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AgentsInstructionsUpgrade);
+        if (Boolean(flags.version) === Boolean(flags.latest)) {
+            this.error('Choose exactly one of --version <n> or --latest.', { exit: 2 });
+        }
+        let agentId;
+        try {
+            agentId = await (0, agent_instructions_1.resolveInstructionAgentId)(undefined, flags.agent);
+        }
+        catch (error) {
+            const failure = (0, agent_resolver_1.agentResolutionFailure)(error);
+            this.failWithCliError({
+                message: failure.message,
+                code: failure.code,
+                exit: 2,
+                retryable: false,
+            });
+        }
+        let updated;
+        let selectedVersion;
+        try {
+            const { composition } = await (0, agent_instructions_1.loadAgentInstructions)(agentId);
+            const entry = (0, instruction_blocks_1.entryByInstance)(composition, args.instance);
+            if (entry.source.kind !== 'library') {
+                throw new Error(`${args.instance} is an inline block and has no library version to upgrade.`);
+            }
+            const block = await data_provider_1.dataService.getInstructionBlock(entry.source.blockId);
+            selectedVersion = flags.latest ? block.currentVersion : flags.version;
+            if (!block.versions.some((candidate) => candidate.version === selectedVersion)) {
+                throw new Error(`${block.id} has no v${selectedVersion}. Run \`skrr instruction-blocks show ${block.id}\`.`);
+            }
+            updated = await (0, agent_instructions_1.saveAgentInstructions)(agentId, (0, instruction_blocks_1.replaceEntry)(composition, args.instance, {
+                ...entry,
+                source: { kind: 'library', blockId: entry.source.blockId, version: selectedVersion },
+                // The controller resolves the selected source server-side and writes
+                // a new immutable snapshot.  Never carry the old snapshot forward.
+                resolved: undefined,
+            }));
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+        if (flags.json)
+            return this.log(JSON.stringify(updated, null, 2));
+        this.log(`Upgraded ${args.instance} on ${agentId} to v${selectedVersion}.`);
+    }
+}
+exports.default = AgentsInstructionsUpgrade;

package/dist/commands/agents/show.js

@@ -112,6 +112,11 @@ class AgentsShow extends base_command_1.BaseCommand {
         this.log(`Tone:        ${agentToneLine(a)}`);
         this.log(`Category:    ${a.category ?? '-'}`);
         this.log(`Author:      ${a.author ?? '-'}`);
+        // A cap the user cannot see is a cap they cannot diagnose: a saturated
+        // agent makes its assigned tasks wait, which reads as "the board is stuck".
+        this.log(`Task limit:  ${typeof a.maxConcurrentTaskExecutions === 'number' && a.maxConcurrentTaskExecutions > 0
+            ? `${a.maxConcurrentTaskExecutions} concurrent across all spaces`
+            : 'unlimited'}`);
         for (const line of agentExecutionOrderLines(a))
             this.log(line);
         if (a.harnessName || a.harnessProvider || a.harnessStatus) {

package/dist/commands/agents/triggers/policy.js

@@ -4,7 +4,10 @@ const core_1 = require("@oclif/core");
 const base_command_1 = require("../../../base-command");
 const prompt_1 = require("../../../lib/prompt");
 const triggers_1 = require("../../../lib/triggers");
-const POLICY_MODES = ['off', 'suggestions_only', 'ask_first', 'auto_run_limited'];
+// The server validates `mode` against the full autonomy ladder. This command
+// used to carry its own copy that stopped one rung short, so `auto_run` was
+// accepted by the API and unreachable from the CLI.
+const data_provider_1 = require("@skrr-ai/data-provider");
 class AgentsTriggersPolicy extends base_command_1.BaseCommand {
     static description = "Show or update an agent's initiative policy for agent-scoped triggers";
     static examples = [
@@ -23,7 +26,10 @@ class AgentsTriggersPolicy extends base_command_1.BaseCommand {
         'audit-limit': core_1.Flags.integer({
             description: 'Recent fire rows to include when showing policy',
         }),
-        mode: core_1.Flags.string({ description: 'Initiative policy mode', options: [...POLICY_MODES] }),
+        mode: core_1.Flags.string({
+            description: 'Initiative policy mode',
+            options: [...data_provider_1.AGENT_INITIATIVE_POLICY_MODES],
+        }),
         'allowed-kind': core_1.Flags.string({
             description: 'Allowed trigger kind under auto_run_limited (repeatable or comma-separated)',
             multiple: true,

package/dist/commands/agents/update.d.ts

@@ -29,6 +29,7 @@ export default class AgentsUpdate extends BaseCommand {
         'tone-mode': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'tone-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'tone-notes': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'max-concurrent-task-executions': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         skills: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'agent-actions': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'tool-policy': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;

package/dist/commands/agents/update.js

@@ -11,7 +11,7 @@ class AgentsUpdate extends base_command_1.BaseCommand {
     static description = 'Update an existing agent (partial patch)';
     static examples = [
         '<%= config.bin %> agents update <agent-id> --name "New name"',
-        '<%= config.bin %> agents update <agent-id> --instructions "You are a helpful..."',
+        '<%= config.bin %> agents instructions add <agent-id> --inline --title "Working preferences" --body "Lead with the answer."',
         '<%= config.bin %> agents update <agent-id> --model claude-sonnet-5',
         '<%= config.bin %> agents update <agent-id> --target sbs_123',
         '<%= config.bin %> agents update <agent-id> --target rt_local --next-target hosted-machine',
@@ -27,7 +27,9 @@ class AgentsUpdate extends base_command_1.BaseCommand {
         }),
         name: core_1.Flags.string({ description: 'New name' }),
         description: core_1.Flags.string({ description: 'New description' }),
-        instructions: core_1.Flags.string({ description: 'New system instructions' }),
+        instructions: core_1.Flags.string({
+            description: 'Replace all custom instructions with one raw legacy block. For block-aware edits use `agents instructions`.',
+        }),
         provider: core_1.Flags.string({ description: 'New provider' }),
         model: core_1.Flags.string({ description: 'New model' }),
         category: core_1.Flags.string({ description: 'New category' }),
@@ -56,6 +58,10 @@ class AgentsUpdate extends base_command_1.BaseCommand {
         'tone-mode': core_1.Flags.string({ description: 'Tone mode' }),
         'tone-id': core_1.Flags.string({ description: 'Tone ID' }),
         'tone-notes': core_1.Flags.string({ description: 'Per-agent tone notes' }),
+        'max-concurrent-task-executions': core_1.Flags.integer({
+            description: 'Max Task executions this agent may run at once ACROSS every space (0 = unlimited). ' +
+                'Ready tasks assigned to a saturated agent wait instead of starting.',
+        }),
         skills: core_1.Flags.string({ description: 'Skills JSON array' }),
         'agent-actions': core_1.Flags.string({ description: 'Embedded actions JSON array' }),
         'tool-policy': core_1.Flags.string({ description: 'Tool policy JSON object' }),

package/dist/commands/commitments/autonomy.js

@@ -29,6 +29,7 @@ class CommitmentsAutonomy extends base_command_1.BaseCommand {
     static examples = [
         '<%= config.bin %> commitments autonomy <commitment-id> --mode ask_first',
         '<%= config.bin %> commitments autonomy <commitment-id> --mode auto_run_limited --reason "trusted after 2 weeks"',
+        '<%= config.bin %> commitments autonomy <commitment-id> --mode auto_run --reason "owns the pipeline end to end"',
     ];
     static args = {
         id: core_1.Args.string({ description: 'Commitment ID', required: true, ignoreStdin: true }),
@@ -36,7 +37,14 @@ class CommitmentsAutonomy extends base_command_1.BaseCommand {
     static flags = {
         json: core_1.Flags.boolean({ description: 'Output as JSON' }),
         mode: core_1.Flags.string({
-            description: 'Autonomy mode',
+            // The web surface groups these into three choices; the CLI keeps the
+            // canonical five because an operator and a coding agent both need to name
+            // the stored value. What it must NOT keep is the silence: the two acting
+            // rungs were indistinguishable in the decision core until the authority
+            // rework, and this help text never said what separated them.
+            description: 'Autonomy mode: off (stop) | suggestions_only (propose only) | ask_first (prepare, wait for approval) | ' +
+                'auto_run_limited (act unattended on low/medium-risk work, bring high-risk to the owner) | ' +
+                'auto_run (act unattended, high-risk work included)',
             options: [...commitments_1.COMMITMENT_AUTONOMY_MODES],
             required: true,
         }),

package/dist/commands/commitments/create.d.ts

@@ -1,10 +1,10 @@
 import { BaseCommand } from '../../base-command';
 /**
- * Public commitment creation is intentionally trust-first: an action-capable
- * mode requested in the create payload is staged as suggestions_only until an
- * owner explicitly grants it. That safety boundary must be visible at the CLI
- * boundary; otherwise a successful create response reads like the requested
- * autonomy is live when it is not.
+ * Creation preserves the policy its author wrote, so the mode that comes back
+ * is normally the mode that was asked for. When it is not — normalization
+ * rejected the value, or a governance layer sits lower — the difference has to
+ * be said out loud at the CLI boundary; otherwise a successful create response
+ * reads like the requested autonomy is live when something else is running.
  */
 export declare function autonomyStagingNotice({ payload, commitment, bin, }: {
     payload: Record<string, unknown>;
@@ -32,6 +32,8 @@ export default class CommitmentsCreate extends BaseCommand {
         title: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         outcome: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         description: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'agent-directive': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'agent-directive-file': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         goal: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         status: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         deadline: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
@@ -47,6 +49,7 @@ export default class CommitmentsCreate extends BaseCommand {
         'cadence-mode': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         timezone: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         autonomy: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        isolation: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'max-nudges': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     run(): Promise<void>;