@outputai/cli 0.1.13-next.f537949.0 → 0.2.1-dev.82acd68.0

package/dist/commands/credentials/set.spec.js

@@ -0,0 +1,160 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { confirm } from '@inquirer/prompts';
+import * as credentialsService from '#services/credentials_service.js';
+import CredentialsSet from './set.js';
+vi.mock('#services/credentials_service.js');
+vi.mock('@inquirer/prompts', () => ({
+    confirm: vi.fn()
+}));
+vi.mock('js-yaml', () => ({
+    load: vi.fn((yaml) => {
+        if (yaml.includes('__PRIMITIVE_AT_X_Y__')) {
+            return { x: { y: 'FOO' } };
+        }
+        if (yaml.includes('__OBJECT_AT_X_Y__')) {
+            return { x: { y: { z: 'FOO' } } };
+        }
+        if (yaml.includes('sk-existing')) {
+            return { anthropic: { api_key: 'sk-existing' } };
+        }
+        return {};
+    }),
+    dump: vi.fn((obj) => JSON.stringify(obj))
+}));
+describe('credentials set command', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        vi.mocked(credentialsService.credentialsExist).mockReturnValue(true);
+        vi.mocked(credentialsService.decryptCredentials).mockReturnValue('anthropic:\n  api_key: sk-existing\n');
+        vi.mocked(credentialsService.writeEncrypted).mockImplementation(() => { });
+        vi.mocked(confirm).mockResolvedValue(true);
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    const createTestCommand = (parsedArgs = {}, flags = {}) => {
+        const cmd = new CredentialsSet([], {});
+        cmd.log = vi.fn();
+        cmd.warn = vi.fn();
+        cmd.error = vi.fn((msg) => {
+            throw new Error(msg);
+        });
+        Object.defineProperty(cmd, 'parse', {
+            value: vi.fn().mockResolvedValue({
+                args: { path: 'anthropic.api_key', value: 'sk-new-key', ...parsedArgs },
+                flags: { environment: undefined, workflow: undefined, yes: false, ...flags }
+            }),
+            configurable: true
+        });
+        return cmd;
+    };
+    describe('command structure', () => {
+        it('should have correct description', () => {
+            expect(CredentialsSet.description).toContain('credential value');
+        });
+        it('should have required path and value arguments', () => {
+            expect(CredentialsSet.args.path).toBeDefined();
+            expect(CredentialsSet.args.path.required).toBe(true);
+            expect(CredentialsSet.args.value).toBeDefined();
+            expect(CredentialsSet.args.value.required).toBe(true);
+        });
+        it('should have environment, workflow, and yes flags', () => {
+            expect(CredentialsSet.flags.environment).toBeDefined();
+            expect(CredentialsSet.flags.workflow).toBeDefined();
+            expect(CredentialsSet.flags.yes).toBeDefined();
+        });
+    });
+    describe('command execution', () => {
+        it('should decrypt, update, and re-encrypt credentials', async () => {
+            const cmd = createTestCommand();
+            await cmd.run();
+            expect(credentialsService.decryptCredentials).toHaveBeenCalledWith(undefined, undefined);
+            expect(credentialsService.writeEncrypted).toHaveBeenCalledWith(undefined, expect.any(String), undefined);
+            expect(confirm).not.toHaveBeenCalled();
+            expect(cmd.log).toHaveBeenCalledWith('Set anthropic.api_key');
+        });
+        it('should create nested keys that do not exist', async () => {
+            vi.mocked(credentialsService.decryptCredentials).mockReturnValue('');
+            const cmd = createTestCommand({ path: 'new.nested.key', value: 'my-value' });
+            await cmd.run();
+            expect(credentialsService.writeEncrypted).toHaveBeenCalledTimes(1);
+            expect(confirm).not.toHaveBeenCalled();
+            expect(cmd.log).toHaveBeenCalledWith('Set new.nested.key');
+        });
+        it('should pass environment flag to service functions', async () => {
+            const cmd = createTestCommand({}, { environment: 'production' });
+            await cmd.run();
+            expect(credentialsService.credentialsExist).toHaveBeenCalledWith('production', undefined);
+            expect(credentialsService.decryptCredentials).toHaveBeenCalledWith('production', undefined);
+            expect(credentialsService.writeEncrypted).toHaveBeenCalledWith('production', expect.any(String), undefined);
+        });
+        it('should pass workflow flag to service functions', async () => {
+            const cmd = createTestCommand({}, { workflow: 'my_workflow' });
+            await cmd.run();
+            expect(credentialsService.credentialsExist).toHaveBeenCalledWith(undefined, 'my_workflow');
+            expect(credentialsService.decryptCredentials).toHaveBeenCalledWith(undefined, 'my_workflow');
+            expect(credentialsService.writeEncrypted).toHaveBeenCalledWith(undefined, expect.any(String), 'my_workflow');
+        });
+        it('should error when both environment and workflow are specified', async () => {
+            const cmd = createTestCommand({}, { environment: 'production', workflow: 'my_workflow' });
+            await expect(cmd.run()).rejects.toThrow('Cannot specify both');
+        });
+        it('should error when credentials file does not exist', async () => {
+            vi.mocked(credentialsService.credentialsExist).mockReturnValue(false);
+            vi.mocked(credentialsService.resolveCredentialsPath).mockReturnValue('/project/config/credentials.yml.enc');
+            const cmd = createTestCommand();
+            await expect(cmd.run()).rejects.toThrow('No credentials file found');
+        });
+        it('should surface a friendly error when decryption fails', async () => {
+            vi.mocked(credentialsService.decryptCredentials).mockImplementation(() => {
+                throw new Error('Invalid key');
+            });
+            const cmd = createTestCommand();
+            await expect(cmd.run()).rejects.toThrow('Failed to update credentials: Invalid key');
+        });
+        it('should surface a friendly error when encryption fails', async () => {
+            vi.mocked(credentialsService.writeEncrypted).mockImplementation(() => {
+                throw new Error('Permission denied');
+            });
+            const cmd = createTestCommand();
+            await expect(cmd.run()).rejects.toThrow('Failed to update credentials: Permission denied');
+        });
+    });
+    describe('shape-change confirmation', () => {
+        it('should prompt before converting a primitive value into an object', async () => {
+            vi.mocked(credentialsService.decryptCredentials).mockReturnValue('__PRIMITIVE_AT_X_Y__');
+            const cmd = createTestCommand({ path: 'x.y.z', value: 'BAR' });
+            await cmd.run();
+            expect(cmd.warn).toHaveBeenCalledWith(expect.stringContaining('convert "x.y" from a value into an object'));
+            expect(confirm).toHaveBeenCalledTimes(1);
+            expect(credentialsService.writeEncrypted).toHaveBeenCalledTimes(1);
+            expect(cmd.log).toHaveBeenCalledWith('Set x.y.z');
+        });
+        it('should prompt before replacing an object with a primitive value', async () => {
+            vi.mocked(credentialsService.decryptCredentials).mockReturnValue('__OBJECT_AT_X_Y__');
+            const cmd = createTestCommand({ path: 'x.y', value: 'BAR' });
+            await cmd.run();
+            expect(cmd.warn).toHaveBeenCalledWith(expect.stringContaining('replace the existing object'));
+            expect(confirm).toHaveBeenCalledTimes(1);
+            expect(credentialsService.writeEncrypted).toHaveBeenCalledTimes(1);
+        });
+        it('should abort without writing when the user declines the prompt', async () => {
+            vi.mocked(credentialsService.decryptCredentials).mockReturnValue('__PRIMITIVE_AT_X_Y__');
+            vi.mocked(confirm).mockResolvedValue(false);
+            const cmd = createTestCommand({ path: 'x.y.z', value: 'BAR' });
+            await cmd.run();
+            expect(credentialsService.writeEncrypted).not.toHaveBeenCalled();
+            expect(cmd.log).toHaveBeenCalledWith('Aborted.');
+            expect(cmd.log).not.toHaveBeenCalledWith('Set x.y.z');
+        });
+        it('should skip the prompt when --yes is passed', async () => {
+            vi.mocked(credentialsService.decryptCredentials).mockReturnValue('__PRIMITIVE_AT_X_Y__');
+            const cmd = createTestCommand({ path: 'x.y.z', value: 'BAR' }, { yes: true });
+            await cmd.run();
+            expect(confirm).not.toHaveBeenCalled();
+            expect(credentialsService.writeEncrypted).toHaveBeenCalledTimes(1);
+            expect(cmd.log).toHaveBeenCalledWith('Set x.y.z');
+        });
+    });
+});

package/dist/commands/dev/index.js

@@ -7,8 +7,16 @@ import { validateDockerEnvironment, startDockerCompose, startDockerComposeDetach
 import { getErrorMessage } from '#utils/error_utils.js';
 import { ensureClaudePlugin } from '#services/coding_agents.js';
 import { DevApp } from '#views/dev.js';
+import { config } from '#config.js';
 export default class Dev extends Command {
-    static description = 'Start Output development services (auto-restarts worker on file changes)';
+    static description = [
+        'Start Output development services (auto-restarts worker on file changes)',
+        '',
+        'To run a second dev stack concurrently, override host ports in .env:',
+        '',
+        '  OUTPUT_API_HOST_PORT=3002',
+        '  OUTPUT_TEMPORAL_UI_HOST_PORT=8081'
+    ].join('\n');
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --compose-file ./custom-docker-compose.yml',
@@ -38,6 +46,8 @@ export default class Dev extends Command {
         // Ensure Claude plugin is configured (fire-and-forget, silent)
         ensureClaudePlugin(process.cwd(), { silent: true }).catch(() => { });
         validateDockerEnvironment();
+        // Eagerly resolve ports so InvalidPortError surfaces before Ink mounts.
+        void config.ports;
         const dockerComposePath = flags['compose-file'] ?
             path.resolve(process.cwd(), flags['compose-file']) :
             getDefaultDockerComposePath();
@@ -48,6 +58,7 @@ export default class Dev extends Command {
             throw new DockerComposeConfigNotFoundError(dockerComposePath);
         }
         this.log('\n🚀 Starting Output development services...\n');
+        this.log(`Docker project name: ${config.dockerServiceName}\n`);
         if (flags['compose-file']) {
             this.log(`Using custom docker-compose file: ${flags['compose-file']}\n`);
         }

package/dist/commands/fix.js

@@ -1,5 +1,5 @@
 import { Command } from '@oclif/core';
-import { confirm } from '@inquirer/prompts';
+import { confirm } from '#utils/prompt.js';
 import { applyFix, planFix } from '#services/fix_package.js';
 import { getErrorMessage } from '#utils/error_utils.js';
 const Ansi = {

package/dist/commands/fix.spec.js

@@ -2,12 +2,12 @@
 import { describe, it, expect, beforeEach, vi } from 'vitest';
 import Fix from './fix.js';
 import * as fixService from '#services/fix_package.js';
-import { confirm } from '@inquirer/prompts';
+import { confirm } from '#utils/prompt.js';
 vi.mock('#services/fix_package.js', () => ({
     planFix: vi.fn(),
     applyFix: vi.fn()
 }));
-vi.mock('@inquirer/prompts', () => ({
+vi.mock('#utils/prompt.js', () => ({
     confirm: vi.fn()
 }));
 const basePlan = () => ({

package/dist/commands/init.d.ts

@@ -7,6 +7,7 @@ export default class Init extends Command {
     };
     static flags: {
         'skip-env': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'skip-git': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

package/dist/commands/init.js

@@ -18,12 +18,16 @@ export default class Init extends Command {
         'skip-env': Flags.boolean({
             description: 'Skip interactive environment variable configuration',
             default: false
+        }),
+        'skip-git': Flags.boolean({
+            description: 'Skip git repository initialization',
+            default: false
         })
     };
     async run() {
         try {
             const { args, flags } = await this.parse(Init);
-            await runInit(flags['skip-env'], args.folderName);
+            await runInit(flags['skip-env'], flags['skip-git'], args.folderName);
         }
         catch (error) {
             if (error instanceof UserCancelledError) {

package/dist/commands/init.spec.js

@@ -37,7 +37,7 @@ describe('init command', () => {
             Object.defineProperty(cmd, 'parse', {
                 value: vi.fn().mockResolvedValue({
                     args: { folderName: undefined, ...parsedArgs },
-                    flags: { 'skip-env': false, ...flags }
+                    flags: { 'skip-env': false, 'skip-git': false, ...flags }
                 }),
                 configurable: true
             });
@@ -52,10 +52,10 @@ describe('init command', () => {
             expect(cmd.run).toBeDefined();
             expect(typeof cmd.run).toBe('function');
         });
-        it('should call runInit with skip-env flag and folder name', async () => {
+        it('should call runInit with skip-env flag, skip-git flag, and folder name', async () => {
             const cmd = createTestCommand();
             await cmd.run();
-            expect(projectScaffold.runInit).toHaveBeenCalledWith(false, undefined);
+            expect(projectScaffold.runInit).toHaveBeenCalledWith(false, false, undefined);
         });
         it('should handle UserCancelledError', async () => {
             const error = new UserCancelledError();
@@ -89,12 +89,17 @@ describe('init command', () => {
         it('should pass skip-env flag to runInit when --skip-env is provided', async () => {
             const cmd = createTestCommand([], { 'skip-env': true });
             await cmd.run();
-            expect(projectScaffold.runInit).toHaveBeenCalledWith(true, undefined);
+            expect(projectScaffold.runInit).toHaveBeenCalledWith(true, false, undefined);
+        });
+        it('should pass skip-git flag to runInit when --skip-git is provided', async () => {
+            const cmd = createTestCommand([], { 'skip-git': true });
+            await cmd.run();
+            expect(projectScaffold.runInit).toHaveBeenCalledWith(false, true, undefined);
         });
         it('should pass folder name to runInit when provided', async () => {
             const cmd = createTestCommand([], {}, { folderName: 'my-project' });
             await cmd.run();
-            expect(projectScaffold.runInit).toHaveBeenCalledWith(false, 'my-project');
+            expect(projectScaffold.runInit).toHaveBeenCalledWith(false, false, 'my-project');
         });
     });
 });

package/dist/commands/migrate.d.ts

@@ -0,0 +1,11 @@
+import { Command } from '@oclif/core';
+export default class Migrate extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        from: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        to: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        notes: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/migrate.js

@@ -0,0 +1,40 @@
+import { Command, Flags } from '@oclif/core';
+import { ensureOutputAISystem } from '#services/coding_agents.js';
+import { invokeMigrate } from '#services/claude_client.js';
+export default class Migrate extends Command {
+    static description = 'Upgrade a project between versions of the Output framework. ' +
+        'Fetches the matching migration guide from docs.output.ai and applies it.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --to 0.2.0',
+        '<%= config.bin %> <%= command.id %> --from 0.1.12 --to 0.2.0',
+        '<%= config.bin %> <%= command.id %> --to 0.2.0 --notes "skip the http changes, we don\'t use that package"'
+    ];
+    static flags = {
+        from: Flags.string({
+            description: 'Version to migrate from. Defaults to the framework version in your package.json.',
+            required: false
+        }),
+        to: Flags.string({
+            description: 'Version to migrate to. Defaults to the latest published version.',
+            required: false
+        }),
+        notes: Flags.string({
+            char: 'n',
+            description: 'Extra guidance passed through to the migration agent.',
+            required: false
+        })
+    };
+    async run() {
+        const { flags } = await this.parse(Migrate);
+        const projectRoot = process.cwd();
+        this.log('Checking .outputai directory structure...');
+        await ensureOutputAISystem(projectRoot);
+        this.log('\nInvoking the /output-migrate skill...');
+        this.log('This may take a moment...\n');
+        const summary = await invokeMigrate(flags.from ?? '', flags.to ?? '', flags.notes);
+        this.log('\n=========');
+        this.log(summary);
+        this.log('=========\n');
+    }
+}

package/dist/commands/update.js

@@ -1,5 +1,5 @@
 import { Command, Flags } from '@oclif/core';
-import { confirm } from '@inquirer/prompts';
+import { confirm } from '#utils/prompt.js';
 import { fetchLatestVersion, getGlobalInstalledVersion, getLocalInstalledVersion, updateGlobal, updateLocal, isOutdated } from '#services/npm_update_service.js';
 import { ensureClaudePlugin } from '#services/coding_agents.js';
 import { getErrorMessage } from '#utils/error_utils.js';

package/dist/commands/update.spec.js

@@ -3,7 +3,7 @@ import { describe, it, expect, beforeEach, vi } from 'vitest';
 import Update from './update.js';
 import { fetchLatestVersion, getGlobalInstalledVersion, getLocalInstalledVersion, updateGlobal, updateLocal, isOutdated } from '#services/npm_update_service.js';
 import { ensureClaudePlugin } from '#services/coding_agents.js';
-import { confirm } from '@inquirer/prompts';
+import { confirm } from '#utils/prompt.js';
 vi.mock('#services/npm_update_service.js', () => ({
     fetchLatestVersion: vi.fn(),
     getGlobalInstalledVersion: vi.fn(),
@@ -15,7 +15,7 @@ vi.mock('#services/npm_update_service.js', () => ({
 vi.mock('#services/coding_agents.js', () => ({
     ensureClaudePlugin: vi.fn()
 }));
-vi.mock('@inquirer/prompts', () => ({
+vi.mock('#utils/prompt.js', () => ({
     confirm: vi.fn()
 }));
 describe('update command', () => {

package/dist/commands/workflow/plan.js

@@ -1,5 +1,6 @@
 import { Command, Flags, ux } from '@oclif/core';
-import { input } from '@inquirer/prompts';
+import { input } from '#utils/prompt.js';
+import { isInteractive } from '#utils/interactive.js';
 import { generatePlanName, updateAgentTemplates, writePlanFile } from '#services/workflow_planner.js';
 import { ensureOutputAISystem } from '#services/coding_agents.js';
 import { invokePlanWorkflow, PLAN_COMMAND_OPTIONS, replyToClaude } from '#services/claude_client.js';
@@ -45,6 +46,9 @@ export default class WorkflowPlan extends Command {
         this.log('=========');
         this.log(originalPlanContent);
         this.log('=========');
+        if (!isInteractive()) {
+            return originalPlanContent;
+        }
         const modifications = await input({
             message: ux.colorize('gray', `Reply or type ${acceptKey} to accept the plan as is: `),
             validate: (value) => value.length >= 10 || value === acceptKey
@@ -56,7 +60,7 @@ export default class WorkflowPlan extends Command {
         return this.planModificationLoop(modifiedPlanContent);
     }
     async planGenerationLoop(promptDescription, planName, projectRoot) {
-        this.log('\nInvoking the /outputai:plan_workflow command...');
+        this.log('\nInvoking the /output-plan-workflow command...');
         this.log('This may take a moment...\n');
         const planContent = await invokePlanWorkflow(promptDescription);
         const modifiedPlanContent = await this.planModificationLoop(planContent);

package/dist/commands/workflow/plan.spec.js

@@ -3,11 +3,12 @@ import WorkflowPlan from './plan.js';
 import { generatePlanName, writePlanFile, updateAgentTemplates } from '#services/workflow_planner.js';
 import { ensureOutputAISystem } from '#services/coding_agents.js';
 import { invokePlanWorkflow, replyToClaude, ClaudeInvocationError } from '#services/claude_client.js';
-import { input } from '@inquirer/prompts';
+import { input } from '#utils/prompt.js';
 vi.mock('#services/workflow_planner.js');
 vi.mock('#services/coding_agents.js');
 vi.mock('#services/claude_client.js');
-vi.mock('@inquirer/prompts');
+vi.mock('#utils/prompt.js');
+vi.mock('#utils/interactive.js', () => ({ isInteractive: () => true }));
 describe('WorkflowPlan Command', () => {
     const createCommand = () => {
         const cmd = new WorkflowPlan([], {});

package/dist/commands/workflow/run.d.ts

@@ -8,7 +8,7 @@ export default class WorkflowRun extends Command {
     };
     static flags: {
         input: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'task-queue': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        catalog: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;

package/dist/commands/workflow/run.js

@@ -35,7 +35,7 @@ export default class WorkflowRun extends Command {
         '<%= config.bin %> <%= command.id %> simple my_scenario --format json',
         '<%= config.bin %> <%= command.id %> simple --input \'{"values":[1,2,3]}\'',
         '<%= config.bin %> <%= command.id %> simple --input input.json',
-        '<%= config.bin %> <%= command.id %> simple --input \'{"key":"value"}\' --task-queue my-queue'
+        '<%= config.bin %> <%= command.id %> simple --input \'{"key":"value"}\' --catalog my-catalog'
     ];
     static args = {
         workflowName: Args.string({
@@ -53,9 +53,12 @@ export default class WorkflowRun extends Command {
             description: 'Workflow input as JSON string or file path (overrides scenario)',
             required: false
         }),
-        'task-queue': Flags.string({
-            char: 'q',
-            description: 'Task queue name for workflow execution (defaults to OUTPUT_CATALOG_ID)',
+        catalog: Flags.string({
+            char: 'c',
+            aliases: ['task-queue'],
+            charAliases: ['q'],
+            deprecateAliases: true,
+            description: 'Catalog name for workflow execution (defaults to OUTPUT_CATALOG_ID)',
             env: 'OUTPUT_CATALOG_ID'
         }),
         format: Flags.string({
@@ -73,7 +76,7 @@ export default class WorkflowRun extends Command {
             body: {
                 workflowName: args.workflowName,
                 input,
-                taskQueue: flags['task-queue']
+                catalog: flags.catalog
             },
             options: { config: { timeout: 600000 } },
             log: msg => this.log(msg)

package/dist/commands/workflow/run.spec.js

@@ -27,7 +27,7 @@ describe('workflow run command', () => {
             expect(WorkflowRun.args).toHaveProperty('workflowName');
             expect(WorkflowRun.flags).toHaveProperty('input');
             expect(WorkflowRun.flags).toHaveProperty('format');
-            expect(WorkflowRun.flags).toHaveProperty('task-queue');
+            expect(WorkflowRun.flags).toHaveProperty('catalog');
         });
         it('should have correct flag configuration', async () => {
             const WorkflowRun = (await import('./run.js')).default;
@@ -53,7 +53,7 @@ describe('workflow run command', () => {
             });
             cmd.parse = vi.fn().mockResolvedValue({
                 args: { workflowName: 'my_workflow', scenario: undefined },
-                flags: { input: undefined, 'task-queue': undefined, format: 'text' }
+                flags: { input: undefined, catalog: undefined, format: 'text' }
             });
             return { cmd, postWorkflowRun: vi.mocked(postWorkflowRun), resolveInput: vi.mocked(resolveInput) };
         };
@@ -67,7 +67,7 @@ describe('workflow run command', () => {
             });
             await cmd.run();
             expect(postWorkflowRun).toHaveBeenCalledTimes(1);
-            expect(postWorkflowRun).toHaveBeenCalledWith({ workflowName: 'my_workflow', input: { key: 'value' }, taskQueue: undefined }, expect.objectContaining({ config: { timeout: 600000 } }));
+            expect(postWorkflowRun).toHaveBeenCalledWith({ workflowName: 'my_workflow', input: { key: 'value' }, catalog: undefined }, expect.objectContaining({ config: { timeout: 600000 } }));
             expect(cmd.log).toHaveBeenCalledWith('Executing workflow: my_workflow...');
             expect(cmd.log).toHaveBeenCalledWith(expect.stringMatching(/\n/));
         });

package/dist/commands/workflow/runs/list.d.ts

@@ -6,6 +6,7 @@ export default class WorkflowRunsList extends Command {
         workflowName: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static flags: {
+        catalog: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };

package/dist/commands/workflow/runs/list.js

@@ -55,6 +55,7 @@ export default class WorkflowRunsList extends Command {
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> simple',
         '<%= config.bin %> <%= command.id %> simple --limit 10',
+        '<%= config.bin %> <%= command.id %> --catalog my-catalog',
         '<%= config.bin %> <%= command.id %> --format json',
         '<%= config.bin %> <%= command.id %> --format table'
     ];
@@ -65,6 +66,11 @@ export default class WorkflowRunsList extends Command {
         })
     };
     static flags = {
+        catalog: Flags.string({
+            char: 'c',
+            description: 'Filter runs by catalog (defaults to OUTPUT_CATALOG_ID)',
+            env: 'OUTPUT_CATALOG_ID'
+        }),
         limit: Flags.integer({
             char: 'l',
             description: 'Maximum number of runs to return',
@@ -81,6 +87,7 @@ export default class WorkflowRunsList extends Command {
         const { args, flags } = await this.parse(WorkflowRunsList);
         const { runs, count } = await fetchWorkflowRuns({
             workflowType: args.workflowName,
+            catalog: flags.catalog,
             limit: flags.limit
         });
         if (runs.length === 0) {

package/dist/commands/workflow/start.d.ts

@@ -8,7 +8,7 @@ export default class WorkflowStart extends Command {
     };
     static flags: {
         input: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'task-queue': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        catalog: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
     catch(error: Error): Promise<void>;

package/dist/commands/workflow/start.js

@@ -8,7 +8,7 @@ export default class WorkflowStart extends Command {
         '<%= config.bin %> <%= command.id %> simple basic_input',
         '<%= config.bin %> <%= command.id %> simple --input \'{"values":[1,2,3]}\'',
         '<%= config.bin %> <%= command.id %> simple --input input.json',
-        '<%= config.bin %> <%= command.id %> simple --input \'{"key":"value"}\' --task-queue my-queue'
+        '<%= config.bin %> <%= command.id %> simple --input \'{"key":"value"}\' --catalog my-catalog'
     ];
     static args = {
         workflowName: Args.string({
@@ -26,9 +26,12 @@ export default class WorkflowStart extends Command {
             description: 'Workflow input as JSON string or file path (overrides scenario)',
             required: false
         }),
-        'task-queue': Flags.string({
-            char: 'q',
-            description: 'Task queue name for workflow execution (defaults to OUTPUT_CATALOG_ID)',
+        catalog: Flags.string({
+            char: 'c',
+            aliases: ['task-queue'],
+            charAliases: ['q'],
+            deprecateAliases: true,
+            description: 'Catalog name for workflow execution (defaults to OUTPUT_CATALOG_ID)',
             env: 'OUTPUT_CATALOG_ID'
         })
     };
@@ -39,7 +42,7 @@ export default class WorkflowStart extends Command {
         const response = await postWorkflowStart({
             workflowName: args.workflowName,
             input,
-            taskQueue: flags['task-queue']
+            catalog: flags.catalog
         });
         if (!response || !response.data) {
             this.error('API returned invalid response', { exit: 1 });

package/dist/commands/workflow/start.spec.js

@@ -14,7 +14,7 @@ describe('workflow start command', () => {
             expect(WorkflowStart.description).toContain('Start a workflow');
             expect(WorkflowStart.args).toHaveProperty('workflowName');
             expect(WorkflowStart.flags).toHaveProperty('input');
-            expect(WorkflowStart.flags).toHaveProperty('task-queue');
+            expect(WorkflowStart.flags).toHaveProperty('catalog');
         });
         it('should have correct flag configuration', async () => {
             const WorkflowStart = (await import('./start.js')).default;

package/dist/config.d.ts

@@ -1,44 +1,17 @@
-/**
- * CLI configuration
- */
 export declare const config: {
-    /**
-     * Base URL for the Output.ai API server
-     * Can be overridden with OUTPUT_API_URL environment variable
-     */
-    apiUrl: string;
-    /**
-     * API authentication token
-     * Set via OUTPUT_API_AUTH_TOKEN environment variable
-     */
-    apiToken: string | undefined;
-    /**
-     * Default timeout for API requests (in milliseconds)
-     */
+    readonly apiUrl: string;
+    readonly ports: {
+        temporalUi: number;
+        api: number;
+    };
+    readonly temporalUiUrl: string;
+    readonly apiToken: string | undefined;
     requestTimeout: number;
-    /**
-     * Docker Compose project name
-     * Can be overridden with DOCKER_SERVICE_NAME environment variable
-     */
-    dockerServiceName: string;
-    /**
-     * Set the debug mode
-     */
-    debugMode: boolean;
-    /**
-     * Where the env vars are stored, defaults to `.env`
-     */
-    envFile: string;
-    /**
-     * Agent configuration directory name
-     */
+    readonly dockerServiceName: string;
+    readonly debugMode: boolean;
+    readonly envFile: string;
     agentConfigDir: string;
-    /**
-     * S3 configuration for remote trace storage
-     * Set via OUTPUT_TRACE_REMOTE_S3_BUCKET, OUTPUT_AWS_REGION,
-     * OUTPUT_AWS_ACCESS_KEY_ID, and OUTPUT_AWS_SECRET_ACCESS_KEY environment variables
-     */
-    s3: {
+    readonly s3: {
         bucket: string | undefined;
         region: string | undefined;
         accessKeyId: string | undefined;