@outputai/cli 0.2.1-next.f1502fb.0 → 0.3.0

package/dist/config.spec.js

@@ -0,0 +1,129 @@
+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',
+        'OUTPUT_CLI_ENV',
+        'OUTPUT_TRACE_REMOTE_S3_BUCKET',
+        'OUTPUT_AWS_REGION',
+        'OUTPUT_AWS_ACCESS_KEY_ID',
+        'OUTPUT_AWS_SECRET_ACCESS_KEY'
+    ];
+    const saved = {};
+    beforeEach(() => {
+        for (const key of envVars) {
+            saved[key] = process.env[key];
+        }
+    });
+    afterEach(() => {
+        for (const key of envVars) {
+            if (saved[key] === undefined) {
+                delete process.env[key];
+            }
+            else {
+                process.env[key] = saved[key];
+            }
+        }
+    });
+    it('reads env vars lazily, not at module evaluation time', () => {
+        process.env.OUTPUT_API_URL = 'https://lazy-test.example.com';
+        expect(config.apiUrl).toBe('https://lazy-test.example.com');
+        process.env.OUTPUT_API_URL = 'https://changed.example.com';
+        expect(config.apiUrl).toBe('https://changed.example.com');
+    });
+    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');
+        delete process.env.OUTPUT_API_AUTH_TOKEN;
+        expect(config.apiToken).toBeUndefined();
+    });
+    it('reads debugMode as boolean', () => {
+        process.env.OUTPUT_DEBUG = 'true';
+        expect(config.debugMode).toBe(true);
+        process.env.OUTPUT_DEBUG = 'false';
+        expect(config.debugMode).toBe(false);
+    });
+    it('reads s3 config lazily', () => {
+        process.env.OUTPUT_TRACE_REMOTE_S3_BUCKET = 'my-bucket';
+        process.env.OUTPUT_AWS_REGION = 'us-west-2';
+        process.env.OUTPUT_AWS_ACCESS_KEY_ID = 'AKIA123';
+        process.env.OUTPUT_AWS_SECRET_ACCESS_KEY = 'secret123';
+        expect(config.s3).toEqual({
+            bucket: 'my-bucket',
+            region: 'us-west-2',
+            accessKeyId: 'AKIA123',
+            secretAccessKey: 'secret123'
+        });
+    });
+    it('has static properties that are not env-derived', () => {
+        expect(config.requestTimeout).toBe(30000);
+        expect(config.agentConfigDir).toBe('.outputai');
+    });
+});

package/dist/generated/framework_version.json

@@ -1,3 +1,3 @@
 {
-    "framework": "0.2.1-next.f1502fb.0"
+    "framework": "0.3.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 {

package/dist/hooks/init.spec.js

@@ -1,9 +1,13 @@
 /* eslint-disable @typescript-eslint/no-explicit-any */
-import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
 import { checkForUpdate } from '#services/version_check.js';
+import { setNonInteractive } from '#utils/interactive.js';
 vi.mock('#services/version_check.js', () => ({
     checkForUpdate: vi.fn()
 }));
+vi.mock('#utils/interactive.js', () => ({
+    setNonInteractive: vi.fn()
+}));
 vi.mock('@oclif/core', () => ({
     ux: {
         stdout: vi.fn(),
@@ -11,7 +15,7 @@ vi.mock('@oclif/core', () => ({
     }
 }));
 import { ux } from '@oclif/core';
-import hook from './init.js';
+import hook, { hasInteractiveFlag, stripGlobalFlags } from './init.js';
 describe('init hook', () => {
     beforeEach(() => {
         vi.clearAllMocks();
@@ -26,7 +30,7 @@ describe('init hook', () => {
             latestVersion: '1.0.0'
         });
         const ctx = createHookContext();
-        await hook.call(ctx, {});
+        await hook.call(ctx, { argv: [], id: undefined });
         expect(checkForUpdate).toHaveBeenCalledWith('0.8.4', '/tmp/test-cache');
         expect(ux.stdout).toHaveBeenCalled();
         const output = vi.mocked(ux.stdout).mock.calls.map(c => c[0]).join('\n');
@@ -42,13 +46,83 @@ describe('init hook', () => {
             latestVersion: '0.8.4'
         });
         const ctx = createHookContext();
-        await hook.call(ctx, {});
+        await hook.call(ctx, { argv: [], id: undefined });
         expect(ux.stdout).not.toHaveBeenCalled();
     });
     it('should silently handle errors', async () => {
         vi.mocked(checkForUpdate).mockRejectedValue(new Error('network failure'));
         const ctx = createHookContext();
-        await hook.call(ctx, {});
+        await hook.call(ctx, { argv: [], id: undefined });
         expect(ux.stdout).not.toHaveBeenCalled();
     });
+    describe('global interactive flags', () => {
+        const originalArgv = process.argv;
+        beforeEach(() => {
+            vi.mocked(checkForUpdate).mockResolvedValue({
+                updateAvailable: false,
+                currentVersion: '0.8.4',
+                latestVersion: '0.8.4'
+            });
+        });
+        afterEach(() => {
+            process.argv = originalArgv;
+        });
+        it('should mutate opts.argv in place to strip --yes', async () => {
+            process.argv = ['node', 'run.js', 'init', '--yes', 'my-project'];
+            const optsArgv = ['--yes', 'my-project'];
+            const argvRef = optsArgv;
+            const ctx = createHookContext();
+            await hook.call(ctx, { argv: optsArgv, id: 'init' });
+            expect(setNonInteractive).toHaveBeenCalledWith(true);
+            expect(optsArgv).toBe(argvRef);
+            expect(optsArgv).toEqual(['my-project']);
+            expect(process.argv).toEqual(['node', 'run.js', 'init', 'my-project']);
+        });
+        it('should mutate opts.argv in place to strip --non-interactive', async () => {
+            process.argv = ['node', 'run.js', 'init', '--non-interactive'];
+            const optsArgv = ['--non-interactive'];
+            const ctx = createHookContext();
+            await hook.call(ctx, { argv: optsArgv, id: 'init' });
+            expect(setNonInteractive).toHaveBeenCalledWith(true);
+            expect(optsArgv).toEqual([]);
+            expect(process.argv).toEqual(['node', 'run.js', 'init']);
+        });
+        it('should leave argv untouched when no global flag is present', async () => {
+            process.argv = ['node', 'run.js', 'init', '--skip-env'];
+            const optsArgv = ['--skip-env'];
+            const ctx = createHookContext();
+            await hook.call(ctx, { argv: optsArgv, id: 'init' });
+            expect(setNonInteractive).not.toHaveBeenCalled();
+            expect(optsArgv).toEqual(['--skip-env']);
+            expect(process.argv).toEqual(['node', 'run.js', 'init', '--skip-env']);
+        });
+    });
+    describe('hasInteractiveFlag', () => {
+        it('returns true when --yes is present', () => {
+            expect(hasInteractiveFlag(['init', '--yes', 'foo'])).toBe(true);
+        });
+        it('returns true when --non-interactive is present', () => {
+            expect(hasInteractiveFlag(['--non-interactive'])).toBe(true);
+        });
+        it('returns false for unrelated flags', () => {
+            expect(hasInteractiveFlag(['init', '--skip-env', '--skip-git'])).toBe(false);
+        });
+        it('returns false for an empty argv', () => {
+            expect(hasInteractiveFlag([])).toBe(false);
+        });
+    });
+    describe('stripGlobalFlags', () => {
+        it('mutates argv in place to remove global flags', () => {
+            const argv = ['init', '--yes', 'foo', '--non-interactive'];
+            const ref = argv;
+            stripGlobalFlags(argv);
+            expect(argv).toBe(ref);
+            expect(argv).toEqual(['init', 'foo']);
+        });
+        it('leaves argv untouched when no global flag is present', () => {
+            const argv = ['init', '--skip-env'];
+            stripGlobalFlags(argv);
+            expect(argv).toEqual(['init', '--skip-env']);
+        });
+    });
 });

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/services/project_scaffold.d.ts

@@ -27,5 +27,5 @@ export declare function createSigintHandler(projectPath: string, folderCreated:
  * @param skipEnv - Whether to skip environment configuration prompts
  * @param folderName - Optional folder name to skip folder name prompt
  */
-export declare function runInit(skipEnv?: boolean, folderName?: string): Promise<void>;
+export declare function runInit(skipEnv?: boolean, skipGit?: boolean, folderName?: string): Promise<void>;
 export {};

package/dist/services/project_scaffold.js

@@ -119,6 +119,18 @@ async function executeNpmInstall(projectPath) {
 async function initializeAgents(projectPath) {
     await initializeAgentConfig({ projectRoot: projectPath, force: false });
 }
+async function maybeInitializeGit(projectPath) {
+    const shouldInit = await confirm({
+        message: 'Initialize a git repository?',
+        default: true
+    });
+    if (!shouldInit) {
+        return false;
+    }
+    return executeCommandWithMessages(async () => {
+        await executeCommand('git', ['init'], projectPath);
+    }, 'Initializing git repository...', 'Git repository initialized');
+}
 /**
  * Format error message for init errors
  * Single responsibility: only format error messages, no cleanup logic
@@ -172,7 +184,7 @@ function handleRunInitError(error, projectPath, projectFolderCreated) {
  * @param skipEnv - Whether to skip environment configuration prompts
  * @param folderName - Optional folder name to skip folder name prompt
  */
-export async function runInit(skipEnv = false, folderName) {
+export async function runInit(skipEnv = false, skipGit = false, folderName) {
     // Track state for SIGINT cleanup using an object to avoid let
     const state = {
         projectFolderCreated: false,
@@ -210,6 +222,9 @@ export async function runInit(skipEnv = false, folderName) {
         await fs.copyFile(path.join(config.projectPath, '.env.example'), path.join(config.projectPath, '.env'));
         await executeCommandWithMessages(() => initializeAgents(config.projectPath), 'Initializing agent system...', 'Agent system initialized');
         const installSuccess = await executeCommandWithMessages(() => executeNpmInstall(config.projectPath), 'Installing dependencies...', 'Dependencies installed');
+        if (!skipGit) {
+            await maybeInitializeGit(config.projectPath);
+        }
         const nextSteps = getProjectSuccessMessage(config.folderName, installSuccess, credentialsConfigured);
         ux.stdout('Project created successfully!');
         ux.stdout(nextSteps);

package/dist/services/workflow_runs.d.ts

@@ -9,6 +9,7 @@ export interface WorkflowRunsResult {
 }
 export interface FetchWorkflowRunsOptions {
     workflowType?: string;
+    catalog?: string;
     limit?: number;
 }
 export declare function fetchWorkflowRuns(options?: FetchWorkflowRunsOptions): Promise<WorkflowRunsResult>;

package/dist/services/workflow_runs.js

@@ -10,6 +10,9 @@ export async function fetchWorkflowRuns(options = {}) {
     if (options.workflowType) {
         params.workflowType = options.workflowType;
     }
+    if (options.catalog) {
+        params.catalog = options.catalog;
+    }
     const response = await getWorkflowRuns(params);
     if (!response) {
         throw new Error('Failed to connect to API server. Is it running?');

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/credentials_loader.d.ts

@@ -0,0 +1 @@
+export declare const loadCredentialRefs: () => void;

package/dist/utils/credentials_loader.js

@@ -0,0 +1,18 @@
+import { InvalidCredentialsKeyError, MalformedCredentialsKeyError, MissingKeyError, resolveCredentialRefs } from '@outputai/credentials';
+const isCredentialsConfigError = (error) => error instanceof MissingKeyError ||
+    error instanceof InvalidCredentialsKeyError ||
+    error instanceof MalformedCredentialsKeyError;
+export const loadCredentialRefs = () => {
+    try {
+        resolveCredentialRefs();
+    }
+    catch (error) {
+        if (isCredentialsConfigError(error)) {
+            console.error(`Error: ${error.message}`);
+            process.exit(1);
+        }
+        else {
+            throw error;
+        }
+    }
+};

package/dist/utils/credentials_loader.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/credentials_loader.spec.js

@@ -0,0 +1,84 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import * as credentials from '@outputai/credentials';
+import { loadCredentialRefs } from './credentials_loader.js';
+vi.mock('@outputai/credentials', async () => {
+    const actual = await vi.importActual('@outputai/credentials');
+    return {
+        ...actual,
+        resolveCredentialRefs: vi.fn()
+    };
+});
+describe('loadCredentialRefs', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('should call resolveCredentialRefs without errors when no credentials are misconfigured', () => {
+        vi.mocked(credentials.resolveCredentialRefs).mockReturnValue([]);
+        expect(() => loadCredentialRefs()).not.toThrow();
+        expect(credentials.resolveCredentialRefs).toHaveBeenCalledTimes(1);
+    });
+    it('should print a clean error message and exit on MissingKeyError without dumping a stack trace', () => {
+        vi.mocked(credentials.resolveCredentialRefs).mockImplementation(() => {
+            throw new credentials.MissingKeyError();
+        });
+        const consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        const exitSpy = vi.spyOn(process, 'exit').mockImplementation((() => undefined));
+        loadCredentialRefs();
+        expect(consoleErrorSpy).toHaveBeenCalledTimes(1);
+        const printedMessage = consoleErrorSpy.mock.calls[0]?.[0];
+        expect(printedMessage).toContain('No credentials key found');
+        expect(printedMessage).toContain('OUTPUT_CREDENTIALS_KEY');
+        expect(printedMessage).toContain('config/credentials.key');
+        expect(printedMessage).not.toContain('    at ');
+        expect(exitSpy).toHaveBeenCalledWith(1);
+    });
+    it('should include the environment-specific hints in the printed message when an environment is set', () => {
+        vi.mocked(credentials.resolveCredentialRefs).mockImplementation(() => {
+            throw new credentials.MissingKeyError('production');
+        });
+        const consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        const exitSpy = vi.spyOn(process, 'exit').mockImplementation((() => undefined));
+        loadCredentialRefs();
+        const printedMessage = consoleErrorSpy.mock.calls[0]?.[0];
+        expect(printedMessage).toContain('OUTPUT_CREDENTIALS_KEY_PRODUCTION');
+        expect(printedMessage).toContain('config/credentials/production.key');
+        expect(exitSpy).toHaveBeenCalledWith(1);
+    });
+    it('should print a clean error message and exit on InvalidCredentialsKeyError', () => {
+        vi.mocked(credentials.resolveCredentialRefs).mockImplementation(() => {
+            throw new credentials.InvalidCredentialsKeyError('config/credentials.yml.enc');
+        });
+        const consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        const exitSpy = vi.spyOn(process, 'exit').mockImplementation((() => undefined));
+        loadCredentialRefs();
+        expect(consoleErrorSpy).toHaveBeenCalledTimes(1);
+        const printedMessage = consoleErrorSpy.mock.calls[0]?.[0];
+        expect(printedMessage).toContain('Failed to decrypt config/credentials.yml.enc');
+        expect(printedMessage).toContain('does not match');
+        expect(printedMessage).not.toContain('    at ');
+        expect(exitSpy).toHaveBeenCalledWith(1);
+    });
+    it('should print a clean error message and exit on MalformedCredentialsKeyError', () => {
+        vi.mocked(credentials.resolveCredentialRefs).mockImplementation(() => {
+            throw new credentials.MalformedCredentialsKeyError('config/credentials.yml.enc', 'hex string expected, got unpadded hex of length 55');
+        });
+        const consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        const exitSpy = vi.spyOn(process, 'exit').mockImplementation((() => undefined));
+        loadCredentialRefs();
+        const printedMessage = consoleErrorSpy.mock.calls[0]?.[0];
+        expect(printedMessage).toContain('is malformed');
+        expect(printedMessage).toContain('must be exactly 64 hex characters');
+        expect(printedMessage).toContain('unpadded hex of length 55');
+        expect(printedMessage).not.toContain('    at ');
+        expect(exitSpy).toHaveBeenCalledWith(1);
+    });
+    it('should rethrow unexpected errors so they are not silently swallowed', () => {
+        vi.mocked(credentials.resolveCredentialRefs).mockImplementation(() => {
+            throw new Error('something else broke');
+        });
+        expect(() => loadCredentialRefs()).toThrow('something else broke');
+    });
+});

package/dist/utils/env_loader.js

@@ -7,11 +7,10 @@ import { existsSync } from 'node:fs';
 import { resolve } from 'node:path';
 import * as dotenv from 'dotenv';
 import debugFactory from 'debug';
-import { config } from '#config.js';
 const debug = debugFactory('output-cli:env-loader');
 export function loadEnvironment() {
     const cwd = process.cwd();
-    const envFile = config.envFile;
+    const envFile = process.env.OUTPUT_CLI_ENV || '.env';
     const envPath = resolve(cwd, envFile);
     if (!existsSync(envPath)) {
         debug(`Warning: Env file not found: ${envPath}`);