@outputai/cli 0.2.1-next.bd54540.0 → 0.2.1-next.c3a8722.0

package/bin/run.js

@@ -3,11 +3,11 @@
 import { execute } from '@oclif/core';
 import { loadEnvironment } from '../dist/utils/env_loader.js';
 import { bootstrapProxy } from '../dist/utils/proxy.js';
-import { resolveCredentialRefs } from '@outputai/credentials';
+import { loadCredentialRefs } from '../dist/utils/credentials_loader.js';
 
 // Load environment variables from .env files before executing CLI
 loadEnvironment();
 bootstrapProxy();
-resolveCredentialRefs();
+loadCredentialRefs();
 
 await execute( { dir: import.meta.url } );

package/dist/api/generated/api.d.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v8.8.0 🍺
+ * Generated by orval v8.9.0 🍺
  * Do not edit manually.
  * Output.ai API
  * API for managing and executing Output.ai workflows
@@ -162,6 +162,8 @@ export declare const WorkflowRunInfoStatus: {
 export interface WorkflowRunInfo {
     /** Unique identifier for this run */
     workflowId?: string;
+    /** The specific run id for this execution */
+    runId?: string;
     /** Name of the workflow definition */
     workflowType?: string;
     /** Current run status */
@@ -291,7 +293,12 @@ export type PostWorkflowRunBody = {
     input: unknown;
     /** (Optional) The workflowId to use. Must be unique */
     workflowId?: string;
-    /** The name of the task queue to send the workflow to */
+    /** The catalog (Temporal task queue) to route the execution to. Falls back to the default catalog. */
+    catalog?: string;
+    /**
+       * Deprecated alias for `catalog`. If both are sent, `catalog` wins.
+       * @deprecated
+       */
     taskQueue?: string;
     /** (Optional) The max time to wait for the execution, defaults to 30s */
     timeout?: number;
@@ -325,7 +332,12 @@ export type PostWorkflowStartBody = {
     input: unknown;
     /** (Optional) The workflowId to use. Must be unique */
     workflowId?: string;
-    /** The name of the task queue to send the workflow to */
+    /** The catalog (Temporal task queue) to route the execution to. Falls back to the default catalog. */
+    catalog?: string;
+    /**
+       * Deprecated alias for `catalog`. If both are sent, `catalog` wins.
+       * @deprecated
+       */
     taskQueue?: string;
 };
 export type PostWorkflowStart200 = {
@@ -437,6 +449,10 @@ export type GetWorkflowRunsParams = {
      * Filter by workflow type/name
      */
     workflowType?: string;
+    /**
+     * Filter by catalog ID (scopes runs to a single worker's catalog/session)
+     */
+    catalog?: string;
     /**
      * Maximum number of runs to return
      * @minimum 1
@@ -709,7 +725,7 @@ export type postWorkflowIdRunsRidTerminateResponseError = (postWorkflowIdRunsRid
 };
 export type postWorkflowIdRunsRidTerminateResponse = (postWorkflowIdRunsRidTerminateResponseSuccess | postWorkflowIdRunsRidTerminateResponseError);
 export declare const getPostWorkflowIdRunsRidTerminateUrl: (id: string, rid: string) => string;
-export declare const postWorkflowIdRunsRidTerminate: (id: string, rid: string, postWorkflowIdRunsRidTerminateBody: PostWorkflowIdRunsRidTerminateBody, options?: ApiRequestOptions) => Promise<postWorkflowIdRunsRidTerminateResponse>;
+export declare const postWorkflowIdRunsRidTerminate: (id: string, rid: string, postWorkflowIdRunsRidTerminateBody?: PostWorkflowIdRunsRidTerminateBody, options?: ApiRequestOptions) => Promise<postWorkflowIdRunsRidTerminateResponse>;
 /**
  * Force terminates the latest run. Deprecated; use `POST /workflow/{id}/runs/{rid}/terminate` to target a specific run. Scheduled for removal after 2026-07-16.
  * @deprecated
@@ -743,7 +759,7 @@ export type postWorkflowIdTerminateResponseError = (postWorkflowIdTerminateRespo
 };
 export type postWorkflowIdTerminateResponse = (postWorkflowIdTerminateResponseSuccess | postWorkflowIdTerminateResponseError);
 export declare const getPostWorkflowIdTerminateUrl: (id: string) => string;
-export declare const postWorkflowIdTerminate: (id: string, postWorkflowIdTerminateBody: PostWorkflowIdTerminateBody, options?: ApiRequestOptions) => Promise<postWorkflowIdTerminateResponse>;
+export declare const postWorkflowIdTerminate: (id: string, postWorkflowIdTerminateBody?: PostWorkflowIdTerminateBody, options?: ApiRequestOptions) => Promise<postWorkflowIdTerminateResponse>;
 /**
  * Resets a pinned workflow run to the point after a completed step, creating a new run that replays from that point. The current execution is terminated.
  * @summary Reset a specific workflow run to re-run from after a completed step

package/dist/api/generated/api.js

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v8.8.0 🍺
+ * Generated by orval v8.9.0 🍺
  * Do not edit manually.
  * Output.ai API
  * API for managing and executing Output.ai workflows

package/dist/assets/docker/docker-compose-dev.yml

@@ -4,8 +4,6 @@ services:
     image: redis:8-alpine
     networks:
       - main
-    ports:
-      - '6379:6379'
     volumes:
       - redis:/data
     healthcheck:
@@ -48,8 +46,6 @@ services:
     image: temporalio/auto-setup:latest
     networks:
       - main
-    ports:
-      - '7233:7233'
     healthcheck:
       test:
         [
@@ -73,7 +69,7 @@ services:
     networks:
       - main
     ports:
-      - '8080:8080'
+      - '${OUTPUT_TEMPORAL_UI_HOST_PORT:-8080}:8080'
 
   api:
     depends_on:
@@ -81,7 +77,7 @@ services:
         condition: service_healthy
       worker:
         condition: service_healthy
-    image: outputai/api:${OUTPUT_API_VERSION:-0.2.1-next.bd54540.0}
+    image: outputai/api:${OUTPUT_API_VERSION:-0.2.1-next.c3a8722.0}
     init: true
     networks:
       - main
@@ -97,7 +93,7 @@ services:
       - OUTPUT_AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY:-}
       - TEMPORAL_ADDRESS=temporal:7233
     ports:
-      - '3001:3001'
+      - '${OUTPUT_API_HOST_PORT:-3001}:3001'
 
   worker:
     depends_on:
@@ -126,11 +122,11 @@ services:
       - OUTPUT_TRACE_HTTP_VERBOSE=${OUTPUT_TRACE_HTTP_VERBOSE:-true}
       - TEMPORAL_ADDRESS=temporal:7233
       - NODE_OPTIONS=${NODE_OPTIONS:---max-old-space-size=4096}
-    command: sh -c "corepack enable && npm run output:worker:watch"
+    command: sh -c "corepack enable && npm run output:worker:install && npm run output:worker:watch"
     working_dir: /app/${OUTPUT_WORKFLOWS_DIR:-.}
     volumes:
       - ./:/app
-      - worker_node_modules:/app/${OUTPUT_WORKFLOWS_DIR:-.}/node_modules
+      - worker_node_modules:/app/node_modules
 
 volumes:
   postgres:

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/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/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,5 +1,10 @@
 export declare const config: {
     readonly apiUrl: string;
+    readonly ports: {
+        temporalUi: number;
+        api: number;
+    };
+    readonly temporalUiUrl: string;
     readonly apiToken: string | undefined;
     requestTimeout: number;
     readonly dockerServiceName: string;

package/dist/config.js

@@ -1,6 +1,18 @@
+import { parsePort } from '#utils/validation.js';
+const DEFAULT_API_PORT = 3001;
+const DEFAULT_TEMPORAL_UI_PORT = 8080;
 export const config = {
     get apiUrl() {
-        return process.env.OUTPUT_API_URL || 'http://localhost:3001';
+        return process.env.OUTPUT_API_URL || `http://localhost:${this.ports.api}`;
+    },
+    get ports() {
+        return {
+            temporalUi: parsePort(process.env.OUTPUT_TEMPORAL_UI_HOST_PORT, DEFAULT_TEMPORAL_UI_PORT, 'OUTPUT_TEMPORAL_UI_HOST_PORT'),
+            api: parsePort(process.env.OUTPUT_API_HOST_PORT, DEFAULT_API_PORT, 'OUTPUT_API_HOST_PORT')
+        };
+    },
+    get temporalUiUrl() {
+        return `http://localhost:${this.ports.temporalUi}`;
     },
     get apiToken() {
         return process.env.OUTPUT_API_AUTH_TOKEN;

package/dist/config.spec.js

@@ -1,8 +1,11 @@
 import { describe, it, expect, beforeEach, afterEach } from 'vitest';
 import { config } from '#config.js';
+import { InvalidPortError } from '#utils/validation.js';
 describe('config', () => {
     const envVars = [
         'OUTPUT_API_URL',
+        'OUTPUT_API_HOST_PORT',
+        'OUTPUT_TEMPORAL_UI_HOST_PORT',
         'OUTPUT_API_AUTH_TOKEN',
         'DOCKER_SERVICE_NAME',
         'OUTPUT_DEBUG',
@@ -36,14 +39,65 @@ describe('config', () => {
     });
     it('falls back to defaults when env vars are unset', () => {
         delete process.env.OUTPUT_API_URL;
+        delete process.env.OUTPUT_API_HOST_PORT;
+        delete process.env.OUTPUT_TEMPORAL_UI_HOST_PORT;
         delete process.env.DOCKER_SERVICE_NAME;
         delete process.env.OUTPUT_DEBUG;
         delete process.env.OUTPUT_CLI_ENV;
         expect(config.apiUrl).toBe('http://localhost:3001');
+        expect(config.ports).toEqual({ temporalUi: 8080, api: 3001 });
+        expect(config.temporalUiUrl).toBe('http://localhost:8080');
         expect(config.dockerServiceName).toBe('output-sdk');
         expect(config.debugMode).toBe(false);
         expect(config.envFile).toBe('.env');
     });
+    it('derives apiUrl from OUTPUT_API_HOST_PORT when OUTPUT_API_URL is unset', () => {
+        delete process.env.OUTPUT_API_URL;
+        process.env.OUTPUT_API_HOST_PORT = '3002';
+        expect(config.apiUrl).toBe('http://localhost:3002');
+    });
+    it('OUTPUT_API_URL takes precedence over OUTPUT_API_HOST_PORT', () => {
+        process.env.OUTPUT_API_URL = 'https://api.example.com';
+        process.env.OUTPUT_API_HOST_PORT = '3002';
+        expect(config.apiUrl).toBe('https://api.example.com');
+    });
+    it('empty-string OUTPUT_API_URL falls through to OUTPUT_API_HOST_PORT (|| not ??)', () => {
+        process.env.OUTPUT_API_URL = '';
+        process.env.OUTPUT_API_HOST_PORT = '3002';
+        expect(config.apiUrl).toBe('http://localhost:3002');
+    });
+    it('reads port overrides from env vars', () => {
+        process.env.OUTPUT_TEMPORAL_UI_HOST_PORT = '8081';
+        process.env.OUTPUT_API_HOST_PORT = '3002';
+        expect(config.ports).toEqual({ temporalUi: 8081, api: 3002 });
+        expect(config.temporalUiUrl).toBe('http://localhost:8081');
+    });
+    it('treats empty-string port env vars as unset (matches Compose semantics)', () => {
+        delete process.env.OUTPUT_API_URL;
+        process.env.OUTPUT_API_HOST_PORT = '';
+        process.env.OUTPUT_TEMPORAL_UI_HOST_PORT = '';
+        expect(config.apiUrl).toBe('http://localhost:3001');
+        expect(config.ports).toEqual({ temporalUi: 8080, api: 3001 });
+        expect(config.temporalUiUrl).toBe('http://localhost:8080');
+    });
+    it('throws InvalidPortError on non-numeric port values', () => {
+        delete process.env.OUTPUT_API_URL;
+        process.env.OUTPUT_API_HOST_PORT = 'abc';
+        expect(() => config.ports).toThrow(InvalidPortError);
+        expect(() => config.apiUrl).toThrow(InvalidPortError);
+    });
+    it('throws InvalidPortError on out-of-range port values', () => {
+        process.env.OUTPUT_API_HOST_PORT = '99999';
+        expect(() => config.ports).toThrow(InvalidPortError);
+    });
+    it('throws InvalidPortError on trailing-junk port values', () => {
+        process.env.OUTPUT_TEMPORAL_UI_HOST_PORT = '8080abc';
+        expect(() => config.ports).toThrow(InvalidPortError);
+    });
+    it('throws InvalidPortError on port 0 (Compose treats 0 as ephemeral - prevents CLI/Docker desync)', () => {
+        process.env.OUTPUT_API_HOST_PORT = '0';
+        expect(() => config.ports).toThrow(InvalidPortError);
+    });
     it('reads apiToken from env', () => {
         process.env.OUTPUT_API_AUTH_TOKEN = 'test-token-123';
         expect(config.apiToken).toBe('test-token-123');

package/dist/generated/framework_version.json

@@ -1,3 +1,3 @@
 {
-    "framework": "0.2.1-next.bd54540.0"
+    "framework": "0.2.1-next.c3a8722.0"
 }

package/dist/hooks/init.d.ts

@@ -1,3 +1,7 @@
 import { Hook } from '@oclif/core';
+export declare const INTERACTIVE_FLAGS: string[];
+export declare const GLOBAL_FLAGS: Set<string>;
+export declare const hasInteractiveFlag: (argv: string[]) => boolean;
+export declare const stripGlobalFlags: (argv: string[]) => void;
 declare const hook: Hook<'init'>;
 export default hook;

package/dist/hooks/init.js

@@ -1,8 +1,20 @@
 import { ux } from '@oclif/core';
 import { checkForUpdate } from '#services/version_check.js';
 import { setNonInteractive } from '#utils/interactive.js';
-const hook = async function () {
-    if (process.argv.includes('--yes') || process.argv.includes('--non-interactive')) {
+export const INTERACTIVE_FLAGS = ['--yes', '--non-interactive'];
+export const GLOBAL_FLAGS = new Set(INTERACTIVE_FLAGS);
+export const hasInteractiveFlag = (argv) => argv.some(arg => INTERACTIVE_FLAGS.includes(arg));
+export const stripGlobalFlags = (argv) => {
+    const kept = argv.filter(arg => !GLOBAL_FLAGS.has(arg));
+    if (kept.length !== argv.length) {
+        argv.splice(0, argv.length, ...kept);
+    }
+};
+const hook = async function (opts) {
+    const interactive = hasInteractiveFlag(opts.argv) || hasInteractiveFlag(process.argv);
+    stripGlobalFlags(opts.argv);
+    stripGlobalFlags(process.argv);
+    if (interactive) {
         setNonInteractive(true);
     }
     try {