@skrr-ai/cli 0.1.13 → 0.1.15

package/dist/commands/instruction-blocks/create.d.ts

@@ -0,0 +1,19 @@
+import { BaseCommand } from '../../base-command';
+export default class InstructionBlocksCreate extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        name: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        summary: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        body: 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>;
+        category: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        tag: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        visibility: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'parameter-schema': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        requirements: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        changelog: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/instruction-blocks/create.js

@@ -0,0 +1,94 @@
+"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 instruction_blocks_1 = require("../../lib/instruction-blocks");
+const instruction_input_1 = require("../../lib/instruction-input");
+const CATEGORIES = [
+    'github',
+    'communication',
+    'research',
+    'output',
+    'planning',
+    'other',
+];
+class InstructionBlocksCreate extends base_command_1.BaseCommand {
+    static description = 'Create a reusable, version-pinned Agent instruction block';
+    static examples = [
+        '<%= config.bin %> instruction-blocks create --name "Evidence first" --body "State evidence before conclusions."',
+        '<%= config.bin %> instruction-blocks create --name "PR review" --file ./review.md --category github --tag github --tag review',
+        '<%= config.bin %> instruction-blocks create --name "Team research" --file ./research.md --visibility workspace',
+    ];
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+        name: core_1.Flags.string({ description: 'Short, reusable block name', required: true }),
+        summary: core_1.Flags.string({ description: 'One-line description for library pickers' }),
+        body: core_1.Flags.string({ description: 'Instruction template text' }),
+        file: core_1.Flags.string({ description: 'Read template text from a file, or - for stdin' }),
+        category: core_1.Flags.string({ description: 'Library category', options: CATEGORIES }),
+        tag: core_1.Flags.string({ description: 'Library tag (repeatable)', multiple: true }),
+        visibility: core_1.Flags.string({
+            description: 'private (default), workspace, or public',
+            options: ['private', 'workspace', 'public'],
+        }),
+        'parameter-schema': core_1.Flags.string({
+            description: 'JSON array of typed parameter definitions (never secrets)',
+        }),
+        requirements: core_1.Flags.string({
+            description: 'JSON array of declarative capability/integration requirements; never grants access',
+        }),
+        changelog: core_1.Flags.string({ description: 'Why this initial version exists' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(InstructionBlocksCreate);
+        let bodyTemplate;
+        let parameterSchema;
+        let requirements;
+        try {
+            bodyTemplate = (await (0, instruction_input_1.readInstructionBody)({
+                body: flags.body,
+                file: flags.file,
+                required: true,
+            }));
+            parameterSchema = (0, instruction_blocks_1.parseJsonFlag)(flags['parameter-schema'], '--parameter-schema');
+            requirements = (0, instruction_blocks_1.parseJsonFlag)(flags.requirements, '--requirements');
+            if (parameterSchema && !Array.isArray(parameterSchema)) {
+                throw new Error('--parameter-schema must be a JSON array');
+            }
+            if (requirements && !Array.isArray(requirements)) {
+                throw new Error('--requirements must be a JSON array');
+            }
+        }
+        catch (error) {
+            this.error(error.message, { exit: 2 });
+        }
+        let block;
+        try {
+            block = await data_provider_1.dataService.createInstructionBlock({
+                name: flags.name,
+                ...(flags.summary !== undefined ? { summary: flags.summary } : {}),
+                ...(flags.category !== undefined
+                    ? { category: flags.category }
+                    : {}),
+                ...(flags.tag?.length ? { tags: flags.tag } : {}),
+                ...(flags.visibility !== undefined
+                    ? { visibility: flags.visibility }
+                    : {}),
+                bodyTemplate,
+                ...(parameterSchema !== undefined ? { parameterSchema } : {}),
+                ...(requirements !== undefined ? { requirements } : {}),
+                ...(flags.changelog !== undefined ? { changelog: flags.changelog } : {}),
+            });
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+        if (flags.json)
+            return this.log(JSON.stringify(block, null, 2));
+        this.log(`Created ${block.name} (${block.id}) at v${block.currentVersion}.`);
+        this.log(`Attach it: skrr agents instructions add --agent <agent-id> --block ${block.id}`);
+    }
+}
+exports.default = InstructionBlocksCreate;

package/dist/commands/instruction-blocks/delete.d.ts

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

package/dist/commands/instruction-blocks/delete.js

@@ -0,0 +1,35 @@
+"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 prompt_1 = require("../../lib/prompt");
+class InstructionBlocksDelete extends base_command_1.BaseCommand {
+    static description = 'Archive a block you authored (existing Agent compositions keep their pinned snapshot)';
+    static examples = ['<%= config.bin %> instruction-blocks delete block_… --yes'];
+    static args = {
+        id: core_1.Args.string({ description: 'Instruction block ID', required: true, ignoreStdin: true }),
+    };
+    static flags = {
+        yes: core_1.Flags.boolean({ char: 'y', description: 'Skip confirmation' }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(InstructionBlocksDelete);
+        const confirmed = await (0, prompt_1.confirmDestructive)(`Archive ${args.id}? Existing Agents keep their version-pinned snapshot, but it can no longer be newly attached.`, flags.yes);
+        if (!confirmed)
+            return this.log('Aborted.');
+        let result;
+        try {
+            result = await data_provider_1.dataService.archiveInstructionBlock(args.id);
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+        if (flags.json)
+            return this.log(JSON.stringify(result, null, 2));
+        this.log(`Archived ${result.id}. Existing Agents retain their pinned snapshots.`);
+    }
+}
+exports.default = InstructionBlocksDelete;

package/dist/commands/instruction-blocks/list.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../base-command';
+/** List the picker catalog in a form an Agent can act on without a browser. */
+export default class InstructionBlocksList extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        official: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        library: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        category: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/instruction-blocks/list.js

@@ -0,0 +1,71 @@
+"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 format_1 = require("../../lib/format");
+const CATEGORIES = [
+    'github',
+    'communication',
+    'research',
+    'output',
+    'planning',
+    'other',
+];
+/** List the picker catalog in a form an Agent can act on without a browser. */
+class InstructionBlocksList extends base_command_1.BaseCommand {
+    static description = 'List reusable Agent instruction blocks (official blocks and your visible library)';
+    static examples = [
+        '<%= config.bin %> instruction-blocks list',
+        '<%= config.bin %> instruction-blocks list --library',
+        '<%= config.bin %> instruction-blocks list --category github --json',
+    ];
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+        official: core_1.Flags.boolean({ description: 'Only code-owned official blocks' }),
+        library: core_1.Flags.boolean({ description: 'Only blocks visible from your library' }),
+        category: core_1.Flags.string({ description: 'Only blocks in this category', options: CATEGORIES }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(InstructionBlocksList);
+        if (flags.official && flags.library) {
+            this.error('Use either --official or --library, not both.', { exit: 2 });
+        }
+        let catalog;
+        try {
+            catalog = await data_provider_1.dataService.listInstructionBlocks();
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+        const all = [
+            ...(flags.library ? [] : catalog.official),
+            ...(flags.official ? [] : catalog.library),
+        ].filter((block) => !flags.category || block.category === flags.category);
+        if (flags.json) {
+            this.log(JSON.stringify({ blocks: all }, null, 2));
+            return;
+        }
+        if (!all.length) {
+            this.log('No instruction blocks match. Create one with `skrr instruction-blocks create`.');
+            return;
+        }
+        (0, format_1.renderTable)(all.map((block) => ({
+            id: block.id,
+            name: block.name,
+            source: block.source,
+            version: `v${block.currentVersion}`,
+            category: block.category,
+            summary: block.summary,
+        })), [
+            { key: 'id', header: 'ID', verbatim: true },
+            { key: 'name', header: 'NAME', maxWidth: 30 },
+            { key: 'source', header: 'SOURCE' },
+            { key: 'version', header: 'VERSION' },
+            { key: 'category', header: 'CATEGORY' },
+            { key: 'summary', header: 'SUMMARY', maxWidth: 52 },
+        ], (line) => this.log(line));
+    }
+}
+exports.default = InstructionBlocksList;

package/dist/commands/instruction-blocks/show.d.ts

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

package/dist/commands/instruction-blocks/show.js

@@ -0,0 +1,35 @@
+"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 instruction_blocks_1 = require("../../lib/instruction-blocks");
+class InstructionBlocksShow extends base_command_1.BaseCommand {
+    static description = 'Show a reusable block, including its pinned source and requirements';
+    static examples = [
+        '<%= config.bin %> instruction-blocks show block_official_decision_memo',
+        '<%= config.bin %> instruction-blocks show block_… --json',
+    ];
+    static args = {
+        id: core_1.Args.string({ description: 'Instruction block ID', required: true, ignoreStdin: true }),
+    };
+    static flags = { json: core_1.Flags.boolean({ description: 'Output as JSON' }) };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(InstructionBlocksShow);
+        let block;
+        try {
+            block = await data_provider_1.dataService.getInstructionBlock(args.id);
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(block, null, 2));
+            return;
+        }
+        for (const line of (0, instruction_blocks_1.renderInstructionBlockDetail)(block))
+            this.log(line);
+    }
+}
+exports.default = InstructionBlocksShow;

package/dist/commands/instruction-blocks/update.d.ts

@@ -0,0 +1,23 @@
+import { BaseCommand } from '../../base-command';
+/** Any edit produces a new immutable source version; attached Agents stay pinned. */
+export default class InstructionBlocksUpdate extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        name: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        summary: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        body: 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>;
+        category: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        tag: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        visibility: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'parameter-schema': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        requirements: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        changelog: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/instruction-blocks/update.js

@@ -0,0 +1,94 @@
+"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 instruction_blocks_1 = require("../../lib/instruction-blocks");
+const instruction_input_1 = require("../../lib/instruction-input");
+const CATEGORIES = [
+    'github',
+    'communication',
+    'research',
+    'output',
+    'planning',
+    'other',
+];
+/** Any edit produces a new immutable source version; attached Agents stay pinned. */
+class InstructionBlocksUpdate extends base_command_1.BaseCommand {
+    static description = 'Update a block you authored (creates a new immutable version; attached Agents stay pinned)';
+    static examples = [
+        '<%= config.bin %> instruction-blocks update block_… --body "Lead with evidence." --changelog "Clarify order"',
+        '<%= config.bin %> instruction-blocks update block_… --file ./review.md',
+        '<%= config.bin %> instruction-blocks update block_… --visibility workspace',
+    ];
+    static args = {
+        id: core_1.Args.string({ description: 'Instruction block ID', required: true, ignoreStdin: true }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+        name: core_1.Flags.string({ description: 'New block name' }),
+        summary: core_1.Flags.string({ description: 'New one-line description' }),
+        body: core_1.Flags.string({ description: 'New instruction template text' }),
+        file: core_1.Flags.string({ description: 'Read new template text from a file, or - for stdin' }),
+        category: core_1.Flags.string({ description: 'New library category', options: CATEGORIES }),
+        tag: core_1.Flags.string({
+            description: 'Replace tags with these values (repeatable)',
+            multiple: true,
+        }),
+        visibility: core_1.Flags.string({ options: ['private', 'workspace', 'public'] }),
+        'parameter-schema': core_1.Flags.string({ description: 'Replace parameters with this JSON array' }),
+        requirements: core_1.Flags.string({ description: 'Replace requirements with this JSON array' }),
+        changelog: core_1.Flags.string({ description: 'Reason for this version' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(InstructionBlocksUpdate);
+        let bodyTemplate;
+        let parameterSchema;
+        let requirements;
+        try {
+            bodyTemplate = await (0, instruction_input_1.readInstructionBody)({ body: flags.body, file: flags.file });
+            parameterSchema = (0, instruction_blocks_1.parseJsonFlag)(flags['parameter-schema'], '--parameter-schema');
+            requirements = (0, instruction_blocks_1.parseJsonFlag)(flags.requirements, '--requirements');
+            if (parameterSchema && !Array.isArray(parameterSchema)) {
+                throw new Error('--parameter-schema must be a JSON array');
+            }
+            if (requirements && !Array.isArray(requirements)) {
+                throw new Error('--requirements must be a JSON array');
+            }
+        }
+        catch (error) {
+            this.error(error.message, { exit: 2 });
+        }
+        const patch = {
+            ...(flags.name !== undefined ? { name: flags.name } : {}),
+            ...(flags.summary !== undefined ? { summary: flags.summary } : {}),
+            ...(bodyTemplate !== undefined ? { bodyTemplate } : {}),
+            ...(flags.category !== undefined
+                ? { category: flags.category }
+                : {}),
+            ...(flags.tag !== undefined ? { tags: flags.tag } : {}),
+            ...(flags.visibility !== undefined
+                ? { visibility: flags.visibility }
+                : {}),
+            ...(parameterSchema !== undefined ? { parameterSchema } : {}),
+            ...(requirements !== undefined ? { requirements } : {}),
+            ...(flags.changelog !== undefined ? { changelog: flags.changelog } : {}),
+        };
+        if (!Object.keys(patch).length) {
+            this.error('Nothing to update. Pass at least one field to change.', { exit: 2 });
+        }
+        let block;
+        try {
+            block = await data_provider_1.dataService.updateInstructionBlock(args.id, patch);
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+        if (flags.json)
+            return this.log(JSON.stringify(block, null, 2));
+        this.log(`Updated ${block.name} (${block.id}) to v${block.currentVersion}.`);
+        this.log('Existing Agent compositions remain pinned; upgrade them explicitly when ready.');
+    }
+}
+exports.default = InstructionBlocksUpdate;

package/dist/commands/login.js

@@ -38,7 +38,10 @@ const auth_storage_1 = require("../lib/auth-storage");
  * `cliLoginWithRefreshToken` for the full rationale.
  */
 class Login extends base_command_1.BaseCommand {
-    static description = 'Sign in to a skrr instance (PKCE localhost callback; device-code fallback)';
+    static description = 'Sign in to a skrr instance (PKCE localhost callback; device-code fallback). ' +
+        'On an interactive first login without a local runtime, skrr offers to install it as a ' +
+        'background service. Choose no, or set SKRR_SKIP_DAEMON_HANDOFF=1 before running this ' +
+        'command, to skip that optional setup.';
     static examples = [
         '<%= config.bin %> login',
         '<%= config.bin %> login --env prod',
@@ -186,7 +189,9 @@ class Login extends base_command_1.BaseCommand {
                 // profile, and until this login there was no session to take them from.
                 // Keyed off `reason` rather than the sentence in `detail`, which is
                 // written for a person and expected to be reworded.
-                if (handoff.reason === 'no-binary' || handoff.reason === 'no-service') {
+                if (handoff.reason === 'no-binary' ||
+                    handoff.reason === 'legacy-binary' ||
+                    handoff.reason === 'no-service') {
                     const setup = await (0, daemon_setup_1.offerDaemonSetup)({
                         binaryPresent: handoff.reason === 'no-service',
                         log: (line) => this.log(line),

package/dist/commands/spaces/auto-executor/preview.d.ts

@@ -1,6 +1,7 @@
 import { BaseCommand } from '../../../base-command';
 export default class SpacesAutoExecutorPreview extends BaseCommand {
     static description: string;
+    static examples: string[];
     static args: {
         id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
     };

package/dist/commands/spaces/auto-executor/preview.js

@@ -6,21 +6,80 @@ const base_command_1 = require("../../../base-command");
 const space_output_1 = require("../../../lib/space-output");
 class SpacesAutoExecutorPreview extends base_command_1.BaseCommand {
     static description = 'Preview what a space auto-executor run would do';
+    static examples = [
+        '<%= config.bin %> spaces auto-executor preview <space-id>',
+        '<%= config.bin %> spaces auto-executor preview <space-id> --json',
+    ];
     static args = {
         id: core_1.Args.string({ description: 'Space ID', required: true, ignoreStdin: true }),
     };
     static flags = { json: core_1.Flags.boolean({ description: 'Output as JSON' }) };
     async run() {
         this.requireAuth();
-        const { args } = await this.parse(SpacesAutoExecutorPreview);
+        // `flags` was previously not destructured at all: --json was declared,
+        // ignored, and raw JSON printed unconditionally. There was no readable
+        // rendering of a preview anywhere in the CLI.
+        const { args, flags } = await this.parse(SpacesAutoExecutorPreview);
         let result;
         try {
-            result = await data_provider_1.dataService.previewSpaceAutoExecutor(args.id);
+            result = (await data_provider_1.dataService.previewSpaceAutoExecutor(args.id));
         }
         catch (err) {
             this.handleApiError(err);
         }
-        this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, args.id, 'execution', { result }), null, 2));
+        if (flags.json) {
+            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, args.id, 'execution', { result }), null, 2));
+            return;
+        }
+        const { space, plan } = result;
+        if (!plan) {
+            this.log('No plan was returned for this space.');
+            return;
+        }
+        this.log(`Space:      ${space.title ?? args.id}`);
+        this.log(`Autopilot:  ${space.autoExecuteEnabled ? 'enabled' : 'disabled'}` +
+            (space.autoExecuteLifecycleState === 'sleeping'
+                ? ` (sleeping${space.autoExecuteSuspensionReason ? `: ${String(space.autoExecuteSuspensionReason).replace(/_/g, ' ')}` : ''})`
+                : '') +
+            ` · ${plan.policy.mode}`);
+        const { capacity } = plan;
+        this.log(`Running:    ${(0, data_provider_1.formatRunningCapacity)(capacity.activeCount, capacity.maxActiveTasks)}` +
+            (capacity.maxActiveTasks === null ? ' (no concurrency cap)' : ''));
+        this.log(`Can start:  ${(0, data_provider_1.formatLimit)(capacity.startsAvailable)} now`);
+        if (capacity.budget && !capacity.budget.unlimited) {
+            this.log(`Budget:     ${capacity.budget.consumedStarts}/${capacity.budget.maxStarts} starts used this round`);
+        }
+        const { actions, summary } = plan;
+        this.log('');
+        this.log(`Board:      ${summary.readyCount} ready · ${summary.unassignedCount} unassigned · ` +
+            `${summary.runningCount} running · ${summary.failedCount} failed · ${summary.scheduledCount} scheduled`);
+        section(this.log.bind(this), 'Would start now', actions.startNow, (a) => taskLine(a.task));
+        section(this.log.bind(this), 'Would assign', actions.assignments, (a) => `${taskLine(a.task)} → ${a.suggestedAgentName ?? a.suggestedAgentId ?? 'no eligible agent'}`);
+        section(this.log.bind(this), 'Would schedule later', actions.scheduleLater, (a) => `${taskLine(a.task)} @ ${a.scheduledFor}`);
+        section(this.log.bind(this), 'Failures to review', actions.failureReviews, (a) => taskLine(a.task));
+        // The single most useful diagnostic in the payload: a ready task that is
+        // not starting because ITS agent is saturated elsewhere, not because this
+        // space is full. Without it the board just looks stuck.
+        section(this.log.bind(this), 'Waiting on agent capacity', actions.capacityWaits, (a) => `${taskLine(a.task)} (agent ${a.agentId ?? 'unknown'} is at its cross-space cap)`);
+        if (plan.risks?.length) {
+            this.log('');
+            this.log('Risks:');
+            for (const risk of plan.risks)
+                this.log(`  ! ${risk}`);
+        }
     }
 }
 exports.default = SpacesAutoExecutorPreview;
+function taskLine(task) {
+    return `${task.identifier ? `${task.identifier} ` : ''}${task.title}`;
+}
+function section(log, heading, items, render, limit = 10) {
+    if (!items?.length)
+        return;
+    log('');
+    log(`${heading} (${items.length}):`);
+    for (const item of items.slice(0, limit))
+        log(`  - ${render(item)}`);
+    if (items.length > limit)
+        log(`  … ${items.length - limit} more (use --json for all)`);
+}

package/dist/commands/spaces/auto-executor/update.d.ts

@@ -9,7 +9,11 @@ export default class SpacesAutoExecutorUpdate extends BaseCommand {
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'from-json': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         enabled: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        mode: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'interval-ms': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        cron: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'daily-time': 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>;
         'max-starts-per-run': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'max-active-tasks': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };