@outputai/cli 0.2.1-next.8836247.0 → 0.2.1-next.b87b58f.0

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
@@ -725,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
@@ -759,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.8836247.0}
+    image: outputai/api:${OUTPUT_API_VERSION:-0.2.1-next.b87b58f.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:

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/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.8836247.0"
+    "framework": "0.2.1-next.b87b58f.0"
 }

package/dist/services/docker.js

@@ -3,6 +3,7 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { ux } from '@oclif/core';
 import semver from 'semver';
+import { config } from '#config.js';
 const DEFAULT_COMPOSE_PATH = '../assets/docker/docker-compose-dev.yml';
 export const SERVICE_HEALTH = {
     HEALTHY: 'healthy',
@@ -100,7 +101,7 @@ export function parseServiceStatus(jsonOutput) {
     });
 }
 export async function getServiceStatus(dockerComposePath) {
-    const result = execFileSync('docker', ['compose', '-f', dockerComposePath, 'ps', '--all', '--format', 'json'], { encoding: 'utf-8', cwd: process.cwd() });
+    const result = execFileSync('docker', ['compose', '-f', dockerComposePath, '--project-name', config.dockerServiceName, 'ps', '--all', '--format', 'json'], { encoding: 'utf-8', cwd: process.cwd() });
     return parseServiceStatus(result);
 }
 export function isServiceHealthy(service) {
@@ -126,6 +127,7 @@ export async function startDockerCompose(dockerComposePath, pullPolicy) {
         'compose',
         '-f', dockerComposePath,
         '--project-directory', process.cwd(),
+        '--project-name', config.dockerServiceName,
         'up'
     ];
     if (pullPolicy) {
@@ -143,6 +145,7 @@ export function startDockerComposeDetached(dockerComposePath, pullPolicy) {
         'compose',
         '-f', dockerComposePath,
         '--project-directory', process.cwd(),
+        '--project-name', config.dockerServiceName,
         'up', '-d'
     ];
     if (pullPolicy) {
@@ -152,6 +155,6 @@ export function startDockerComposeDetached(dockerComposePath, pullPolicy) {
 }
 export async function stopDockerCompose(dockerComposePath) {
     ux.stdout('⏹️  Stopping services...\n');
-    execFileSync('docker', ['compose', '-f', dockerComposePath, 'down'], { stdio: 'inherit', cwd: process.cwd() });
+    execFileSync('docker', ['compose', '-f', dockerComposePath, '--project-directory', process.cwd(), '--project-name', config.dockerServiceName, 'down'], { stdio: 'inherit', cwd: process.cwd() });
 }
 export { isDockerInstalled, DockerValidationError };

package/dist/services/docker.spec.js

@@ -1,6 +1,6 @@
 import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
-import { execFileSync } from 'node:child_process';
-import { parseServiceStatus, getServiceStatus, waitForServicesHealthy, isServiceHealthy, isServiceFailed } from './docker.js';
+import { execFileSync, spawn } from 'node:child_process';
+import { parseServiceStatus, getServiceStatus, startDockerCompose, startDockerComposeDetached, stopDockerCompose, waitForServicesHealthy, isServiceHealthy, isServiceFailed } from './docker.js';
 vi.mock('node:child_process', () => ({
     execSync: vi.fn(),
     execFileSync: vi.fn(),
@@ -73,7 +73,7 @@ describe('docker service', () => {
             const mockOutput = '{"Service":"redis","State":"running","Health":"healthy","Publishers":[]}';
             vi.mocked(execFileSync).mockReturnValue(mockOutput);
             await getServiceStatus('/path/to/docker-compose.yml');
-            expect(execFileSync).toHaveBeenCalledWith('docker', ['compose', '-f', '/path/to/docker-compose.yml', 'ps', '--all', '--format', 'json'], expect.objectContaining({ encoding: 'utf-8' }));
+            expect(execFileSync).toHaveBeenCalledWith('docker', ['compose', '-f', '/path/to/docker-compose.yml', '--project-name', 'output-sdk', 'ps', '--all', '--format', 'json'], expect.objectContaining({ encoding: 'utf-8' }));
         });
         it('should return parsed service status', async () => {
             const mockOutput = '{"Service":"redis","State":"running","Health":"healthy","Publishers":[{"PublishedPort":6379,"TargetPort":6379}]}';
@@ -89,6 +89,77 @@ describe('docker service', () => {
             await expect(getServiceStatus('/path/to/docker-compose.yml')).rejects.toThrow();
         });
     });
+    describe('startDockerCompose', () => {
+        it('should pass --project-name to docker compose up', async () => {
+            await startDockerCompose('/path/to/docker-compose.yml');
+            expect(spawn).toHaveBeenCalledWith('docker', [
+                'compose', '-f', '/path/to/docker-compose.yml',
+                '--project-directory', process.cwd(),
+                '--project-name', 'output-sdk',
+                'up'
+            ], expect.objectContaining({ stdio: ['ignore', 'pipe', 'pipe'], cwd: process.cwd() }));
+        });
+        it('should append --pull when pullPolicy is provided', async () => {
+            await startDockerCompose('/path/to/docker-compose.yml', 'always');
+            expect(spawn).toHaveBeenCalledWith('docker', [
+                'compose', '-f', '/path/to/docker-compose.yml',
+                '--project-directory', process.cwd(),
+                '--project-name', 'output-sdk',
+                'up', '--pull', 'always'
+            ], expect.objectContaining({ stdio: ['ignore', 'pipe', 'pipe'], cwd: process.cwd() }));
+        });
+    });
+    describe('startDockerComposeDetached', () => {
+        it('should pass --project-name and -d to docker compose up', () => {
+            vi.mocked(execFileSync).mockReturnValue('');
+            startDockerComposeDetached('/path/to/docker-compose.yml');
+            expect(execFileSync).toHaveBeenCalledWith('docker', [
+                'compose', '-f', '/path/to/docker-compose.yml',
+                '--project-directory', process.cwd(),
+                '--project-name', 'output-sdk',
+                'up', '-d'
+            ], expect.objectContaining({ stdio: 'inherit', cwd: process.cwd() }));
+        });
+        it('should append --pull when pullPolicy is provided', () => {
+            vi.mocked(execFileSync).mockReturnValue('');
+            startDockerComposeDetached('/path/to/docker-compose.yml', 'missing');
+            expect(execFileSync).toHaveBeenCalledWith('docker', [
+                'compose', '-f', '/path/to/docker-compose.yml',
+                '--project-directory', process.cwd(),
+                '--project-name', 'output-sdk',
+                'up', '-d', '--pull', 'missing'
+            ], expect.objectContaining({ stdio: 'inherit', cwd: process.cwd() }));
+        });
+    });
+    describe('DOCKER_SERVICE_NAME wiring', () => {
+        const saved = process.env.DOCKER_SERVICE_NAME;
+        afterEach(() => {
+            if (saved === undefined) {
+                delete process.env.DOCKER_SERVICE_NAME;
+            }
+            else {
+                process.env.DOCKER_SERVICE_NAME = saved;
+            }
+        });
+        it('threads DOCKER_SERVICE_NAME through to --project-name (not hardcoded output-sdk)', async () => {
+            process.env.DOCKER_SERVICE_NAME = 'custom-project';
+            vi.mocked(execFileSync).mockReturnValue('');
+            await stopDockerCompose('/path/to/docker-compose.yml');
+            expect(execFileSync).toHaveBeenCalledWith('docker', [
+                'compose', '-f', '/path/to/docker-compose.yml',
+                '--project-directory', process.cwd(),
+                '--project-name', 'custom-project',
+                'down'
+            ], expect.objectContaining({ stdio: 'inherit' }));
+        });
+    });
+    describe('stopDockerCompose', () => {
+        it('should pass --project-name and --project-directory to docker compose down', async () => {
+            vi.mocked(execFileSync).mockReturnValue('');
+            await stopDockerCompose('/path/to/docker-compose.yml');
+            expect(execFileSync).toHaveBeenCalledWith('docker', ['compose', '-f', '/path/to/docker-compose.yml', '--project-directory', process.cwd(), '--project-name', 'output-sdk', 'down'], expect.objectContaining({ stdio: 'inherit' }));
+        });
+    });
     describe('isServiceHealthy', () => {
         it('should return true for a running service with health: healthy', () => {
             expect(isServiceHealthy({ name: 'redis', state: 'running', health: 'healthy', ports: [] })).toBe(true);

package/dist/services/messages.js

@@ -2,6 +2,7 @@
  * Success and informational messages for project initialization
  */
 import { ux } from '@oclif/core';
+import { config } from '#config.js';
 /**
  * Creates a colored ASCII art banner for Output.ai
  */
@@ -180,7 +181,7 @@ export const getProjectSuccessMessage = (folderName, installSuccess, credentials
         note: 'Execute in a new terminal after services are running'
     }, {
         step: 'Monitor workflows',
-        command: 'open http://localhost:8080',
+        command: `open ${config.temporalUiUrl}`,
         note: 'Access Temporal UI for workflow visualization'
     });
     // Format each step with proper indentation and colors

package/dist/templates/project/.env.example.template

@@ -7,3 +7,20 @@ ANTHROPIC_API_KEY=credential:anthropic.api_key
 # Configure if you plan to use OpenAI in your LLM prompts
 OPENAI_API_KEY=credential:openai.api_key
 
+# --- Host port overrides (for running multiple dev stacks) ---
+# Only the host-side port changes; inter-service traffic (e.g. worker -> Temporal
+# at temporal:7233) is unaffected.
+# OUTPUT_API_HOST_PORT=3001
+# OUTPUT_TEMPORAL_UI_HOST_PORT=8080
+
+# --- API connection ---
+# If OUTPUT_API_URL is set, it overrides OUTPUT_API_HOST_PORT.
+# Use OUTPUT_API_URL for remote/staging servers; use OUTPUT_API_HOST_PORT for local port shifts.
+# OUTPUT_API_URL=http://localhost:3001
+
+# --- Project isolation ---
+# Compose prefixes named volumes with the project name, so changing
+# DOCKER_SERVICE_NAME creates fresh volumes and leaves the previous ones behind.
+# Run `docker volume ls --filter name=<old-project-name>` to find orphaned
+# volumes and `docker volume rm` to remove them.
+

package/dist/utils/validation.d.ts

@@ -11,3 +11,16 @@ export declare function validateWorkflowName(name: string): void;
  * Validate that a directory path is safe to create
  */
 export declare function validateOutputDirectory(outputDir: string): void;
+export declare class InvalidPortError extends Error {
+    constructor(envVarName: string, raw: string, reason: string);
+}
+/**
+ * Parse a port number from an env var. Empty string and undefined fall back to
+ * the default silently (matching Compose's `${VAR:-default}` semantics).
+ * Throws InvalidPortError on anything else: non-numeric, signed, decimal,
+ * trailing junk (e.g. "3001abc"), or out of range 1-65535. Throwing (vs
+ * warn-and-fallback) prevents CLI/Docker disagreement: Compose reads the same
+ * env var via `${VAR:-default}` and uses its own parser, so a CLI fallback
+ * would silently desync from the bound port.
+ */
+export declare function parsePort(raw: string | undefined, defaultPort: number, envVarName: string): number;

package/dist/utils/validation.js

@@ -23,3 +23,34 @@ export function validateOutputDirectory(outputDir) {
         throw new InvalidOutputDirectoryError(outputDir, 'Output directory cannot be empty');
     }
 }
+const MIN_PORT = 1;
+const MAX_PORT = 65535;
+export class InvalidPortError extends Error {
+    constructor(envVarName, raw, reason) {
+        super(`${envVarName}=${raw} is invalid (${reason}). ` +
+            `Set a port in ${MIN_PORT}-${MAX_PORT} in your .env file, or unset the variable to use the default.`);
+        this.name = 'InvalidPortError';
+    }
+}
+/**
+ * Parse a port number from an env var. Empty string and undefined fall back to
+ * the default silently (matching Compose's `${VAR:-default}` semantics).
+ * Throws InvalidPortError on anything else: non-numeric, signed, decimal,
+ * trailing junk (e.g. "3001abc"), or out of range 1-65535. Throwing (vs
+ * warn-and-fallback) prevents CLI/Docker disagreement: Compose reads the same
+ * env var via `${VAR:-default}` and uses its own parser, so a CLI fallback
+ * would silently desync from the bound port.
+ */
+export function parsePort(raw, defaultPort, envVarName) {
+    if (raw === undefined || raw === '') {
+        return defaultPort;
+    }
+    if (!/^\d+$/.test(raw)) {
+        throw new InvalidPortError(envVarName, raw, 'not a positive integer');
+    }
+    const n = parseInt(raw, 10);
+    if (n < MIN_PORT || n > MAX_PORT) {
+        throw new InvalidPortError(envVarName, raw, `out of range ${MIN_PORT}-${MAX_PORT}`);
+    }
+    return n;
+}

package/dist/utils/validation.spec.js

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { isValidWorkflowName } from './validation.js';
+import { isValidWorkflowName, parsePort, InvalidPortError } from './validation.js';
 describe('isValidWorkflowName', () => {
     describe('valid workflow names', () => {
         it('should accept single letter', () => {
@@ -138,3 +138,49 @@ describe('isValidWorkflowName', () => {
         });
     });
 });
+describe('parsePort', () => {
+    it('returns the parsed value for a valid port', () => {
+        expect(parsePort('3001', 3001, 'P')).toBe(3001);
+        expect(parsePort('7234', 7233, 'P')).toBe(7234);
+    });
+    it('falls back to default for undefined silently', () => {
+        expect(parsePort(undefined, 3001, 'P')).toBe(3001);
+    });
+    it('falls back to default for empty string silently (matches Compose ${VAR:-default})', () => {
+        expect(parsePort('', 3001, 'P')).toBe(3001);
+    });
+    it('throws InvalidPortError for non-numeric input', () => {
+        expect(() => parsePort('abc', 3001, 'OUTPUT_API_HOST_PORT')).toThrow(InvalidPortError);
+        expect(() => parsePort('abc', 3001, 'OUTPUT_API_HOST_PORT'))
+            .toThrow(/OUTPUT_API_HOST_PORT=abc/);
+    });
+    it('throws for trailing junk (parseInt would silently truncate)', () => {
+        expect(() => parsePort('3001abc', 3001, 'P')).toThrow(InvalidPortError);
+    });
+    it('throws for negative input', () => {
+        expect(() => parsePort('-1', 3001, 'P')).toThrow(InvalidPortError);
+    });
+    it('throws for port 0 (CLI rejects but Compose would treat as ephemeral - prevents desync)', () => {
+        expect(() => parsePort('0', 3001, 'P')).toThrow(InvalidPortError);
+    });
+    it('throws for port above 65535', () => {
+        expect(() => parsePort('65536', 3001, 'P')).toThrow(InvalidPortError);
+        expect(() => parsePort('99999', 3001, 'P')).toThrow(InvalidPortError);
+    });
+    it('accepts boundary ports 1 and 65535', () => {
+        expect(parsePort('1', 3001, 'P')).toBe(1);
+        expect(parsePort('65535', 3001, 'P')).toBe(65535);
+    });
+    it('error message includes env var name and remediation hint', () => {
+        try {
+            parsePort('abc', 3001, 'OUTPUT_API_HOST_PORT');
+            expect.fail('expected throw');
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(InvalidPortError);
+            expect(err.message).toContain('OUTPUT_API_HOST_PORT=abc');
+            expect(err.message).toContain('1-65535');
+            expect(err.message).toContain('.env file');
+        }
+    });
+});

package/dist/views/dev.js

@@ -138,10 +138,10 @@ const DevSuccessMessage = ({ services }) => {
     const divider = '─'.repeat(80);
     const sortedNames = services.map(s => s.name).sort().join('|');
     const logsCommand = `docker compose -p ${config.dockerServiceName} logs -f <${sortedNames}>`;
-    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsx(Box, { marginTop: 1, marginBottom: 1, children: _jsx(Text, { dimColor: true, children: divider }) }), _jsxs(Box, { children: [_jsx(Text, { color: "green", bold: true, children: '✅ SUCCESS! ' }), _jsx(Text, { bold: true, children: "Development services are running" })] }), _jsx(Box, { marginTop: 1, marginBottom: 1, children: _jsx(Text, { dimColor: true, children: divider }) }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, children: "\uD83D\uDC33 SERVICES" }) }), _jsxs(Box, { flexDirection: "column", marginLeft: 2, children: [_jsxs(Box, { children: [_jsx(Text, { color: "white", children: 'Temporal:    ' }), _jsx(Text, { color: "yellow", children: "localhost:7233" })] }), _jsxs(Box, { children: [_jsx(Text, { color: "white", children: 'Temporal UI: ' }), _jsx(Text, { color: "cyan", children: "http://localhost:8080" })] }), _jsxs(Box, { children: [_jsx(Text, { color: "white", children: 'API Server:  ' }), _jsx(Text, { color: "yellow", children: "localhost:3001" })] }), _jsxs(Box, { children: [_jsx(Text, { color: "white", children: 'Redis:       ' }), _jsx(Text, { color: "yellow", children: "localhost:6379" })] })] }), _jsx(Box, { marginTop: 1, marginBottom: 1, children: _jsx(Text, { dimColor: true, children: divider }) }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, children: "\uD83D\uDE80 RUN A WORKFLOW" }) }), _jsxs(Box, { flexDirection: "column", marginLeft: 2, children: [_jsx(Text, { color: "white", children: "In a new terminal, execute:" }), _jsx(Box, { marginLeft: 2, children: _jsx(Text, { color: "cyan", children: "npx output workflow run blog_evaluator paulgraham_hwh" }) })] }), _jsx(Box, { marginTop: 1, marginBottom: 1, children: _jsx(Text, { dimColor: true, children: divider }) }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, children: "\u26A1 USEFUL COMMANDS" }) }), _jsxs(Box, { flexDirection: "column", marginLeft: 2, children: [_jsxs(Box, { children: [_jsx(Text, { color: "white", children: 'Open Temporal UI: ' }), _jsx(Text, { color: "cyan", children: "open http://localhost:8080" })] }), _jsxs(Box, { children: [_jsx(Text, { color: "white", children: 'View logs:        ' }), _jsx(Text, { color: "cyan", children: logsCommand })] }), _jsxs(Box, { children: [_jsx(Text, { color: "white", children: 'Stop services:    ' }), _jsx(Text, { color: "cyan", children: "Press Ctrl+C" })] })] }), _jsx(Box, { marginTop: 1, marginBottom: 1, children: _jsx(Text, { dimColor: true, children: divider }) }), _jsx(Text, { dimColor: true, children: "\uD83D\uDCA1 Tip: The Temporal UI lets you monitor workflow executions in real-time" })] }));
+    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsx(Box, { marginTop: 1, marginBottom: 1, children: _jsx(Text, { dimColor: true, children: divider }) }), _jsxs(Box, { children: [_jsx(Text, { color: "green", bold: true, children: '✅ SUCCESS! ' }), _jsx(Text, { bold: true, children: "Development services are running" })] }), _jsx(Box, { marginTop: 1, marginBottom: 1, children: _jsx(Text, { dimColor: true, children: divider }) }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, children: "\uD83D\uDC33 SERVICES" }) }), _jsxs(Box, { flexDirection: "column", marginLeft: 2, children: [_jsxs(Box, { children: [_jsx(Text, { color: "white", children: 'Temporal UI: ' }), _jsx(Text, { color: "cyan", children: config.temporalUiUrl })] }), _jsxs(Box, { children: [_jsx(Text, { color: "white", children: 'API Server:  ' }), _jsxs(Text, { color: "yellow", children: ["localhost:", config.ports.api] })] })] }), _jsx(Box, { marginTop: 1, marginBottom: 1, children: _jsx(Text, { dimColor: true, children: divider }) }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, children: "\uD83D\uDE80 RUN A WORKFLOW" }) }), _jsxs(Box, { flexDirection: "column", marginLeft: 2, children: [_jsx(Text, { color: "white", children: "In a new terminal, execute:" }), _jsx(Box, { marginLeft: 2, children: _jsx(Text, { color: "cyan", children: "npx output workflow run blog_evaluator paulgraham_hwh" }) })] }), _jsx(Box, { marginTop: 1, marginBottom: 1, children: _jsx(Text, { dimColor: true, children: divider }) }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, children: "\u26A1 USEFUL COMMANDS" }) }), _jsxs(Box, { flexDirection: "column", marginLeft: 2, children: [_jsxs(Box, { children: [_jsx(Text, { color: "white", children: 'Open Temporal UI: ' }), _jsxs(Text, { color: "cyan", children: ["open ", config.temporalUiUrl] })] }), _jsxs(Box, { children: [_jsx(Text, { color: "white", children: 'View logs:        ' }), _jsx(Text, { color: "cyan", children: logsCommand })] }), _jsxs(Box, { children: [_jsx(Text, { color: "white", children: 'Stop services:    ' }), _jsx(Text, { color: "cyan", children: "Press Ctrl+C" })] })] }), _jsx(Box, { marginTop: 1, marginBottom: 1, children: _jsx(Text, { dimColor: true, children: divider }) }), _jsx(Text, { dimColor: true, children: "\uD83D\uDCA1 Tip: The Temporal UI lets you monitor workflow executions in real-time" })] }));
 };
 const WaitingView = ({ services }) => (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { color: "yellow", children: _jsx(Spinner, { type: "dots" }) }), _jsx(Text, { children: " Waiting for services to become healthy..." })] }), services.length > 0 && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: services.map(s => _jsx(ServiceRow, { service: s }, s.name)) }))] }));
-const RunningView = ({ services, workflowSummary }) => (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, children: "\uD83D\uDCCA Service Status" }), _jsx(Box, { flexDirection: "column", marginTop: 1, children: services.map(s => _jsx(ServiceRow, { service: s }, s.name)) }), _jsx(FailureWarning, { services: services }), workflowSummary && _jsx(WorkflowSummarySection, { summary: workflowSummary }), _jsxs(Box, { marginTop: 1, children: [_jsx(Text, { color: "cyan", children: '🌐 Temporal UI: ' }), _jsx(Text, { bold: true, children: "http://localhost:8080" })] }), _jsx(CommandFooter, { hints: [
+const RunningView = ({ services, workflowSummary }) => (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, children: "\uD83D\uDCCA Service Status" }), _jsx(Box, { flexDirection: "column", marginTop: 1, children: services.map(s => _jsx(ServiceRow, { service: s }, s.name)) }), _jsx(FailureWarning, { services: services }), workflowSummary && _jsx(WorkflowSummarySection, { summary: workflowSummary }), _jsxs(Box, { marginTop: 1, children: [_jsx(Text, { color: "cyan", children: '🌐 Temporal UI: ' }), _jsx(Text, { bold: true, children: config.temporalUiUrl })] }), _jsx(CommandFooter, { hints: [
                 { key: 'o', label: 'open ui' },
                 { key: 'w', label: 'view workflow runs' },
                 { key: 'ctrl+c', label: 'stop' }
@@ -173,7 +173,7 @@ export const DevApp = ({ dockerComposePath, onCleanup }) => {
     useStatusRefresh(dockerComposePath, phase === 'running', setServices);
     useWorkflowPolling(phase === 'running' || phase === 'failed', setWorkflowRuns);
     useMainViewInput(activeView === 'main' && phase !== 'waiting', {
-        onOpenTemporal: () => openUrl('http://localhost:8080'),
+        onOpenTemporal: () => openUrl(config.temporalUiUrl),
         onOpenWorkflows: () => setActiveView('workflows')
     });
     useCtrlC(onCleanup);

package/dist/views/workflow/list.js

@@ -7,7 +7,7 @@ import { StatusIcon, statusColor } from '#components/status_icon.js';
 import { elapsedMs, formatDurationCompact } from '#utils/date_formatter.js';
 import { CommandFooter } from '#components/command_footer.js';
 import { openUrl } from '#utils/open_url.js';
-const TEMPORAL_UI_BASE = 'http://localhost:8080';
+import { config } from '#config.js';
 const VISIBLE_ROWS = 15;
 const STATUS_ORDER = {
     running: 0,
@@ -108,7 +108,7 @@ export const WorkflowListView = ({ runs, onBack }) => {
             onBack();
         }
         else if (input === 'o' && selectedWorkflowId) {
-            openUrl(`${TEMPORAL_UI_BASE}/namespaces/default/workflows/${selectedWorkflowId}`);
+            openUrl(`${config.temporalUiUrl}/namespaces/default/workflows/${selectedWorkflowId}`);
         }
     });
     const windowStart = useMemo(() => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@outputai/cli",
-  "version": "0.2.1-next.8836247.0",
+  "version": "0.2.1-next.b87b58f.0",
   "description": "CLI for Output.ai workflow generation",
   "type": "module",
   "main": "dist/index.js",
@@ -15,11 +15,11 @@
   },
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "0.2.92",
-    "@aws-sdk/client-s3": "3.1031.0",
+    "@aws-sdk/client-s3": "3.1038.0",
     "@hackylabs/deep-redact": "3.0.5",
-    "@inquirer/prompts": "8.4.1",
-    "@oclif/core": "4.10.5",
-    "@oclif/plugin-help": "6.2.44",
+    "@inquirer/prompts": "8.4.2",
+    "@oclif/core": "4.10.6",
+    "@oclif/plugin-help": "6.2.45",
     "change-case": "5.4.4",
     "cli-progress": "3.12.0",
     "cli-table3": "0.6.5",
@@ -34,11 +34,11 @@
     "ky": "1.14.3",
     "react": "19.2.5",
     "semver": "7.7.4",
-    "undici": "8.0.2",
+    "undici": "8.1.0",
     "yaml": "^2.8.3",
-    "@outputai/credentials": "0.2.1-next.8836247.0",
-    "@outputai/evals": "0.2.1-next.8836247.0",
-    "@outputai/llm": "0.2.1-next.8836247.0"
+    "@outputai/evals": "0.2.1-next.b87b58f.0",
+    "@outputai/llm": "0.2.1-next.b87b58f.0",
+    "@outputai/credentials": "0.2.1-next.b87b58f.0"
   },
   "devDependencies": {
     "@types/cli-progress": "3.11.6",
@@ -46,7 +46,7 @@
     "@types/js-yaml": "4.0.9",
     "@types/react": "19.2.14",
     "@types/semver": "7.7.1",
-    "orval": "8.8.0"
+    "orval": "8.9.0"
   },
   "license": "Apache-2.0",
   "publishConfig": {