@output.ai/cli 0.0.9 → 0.2.4

package/README.md

@@ -14,6 +14,54 @@ npx @output.ai/cli
 
 ## Usage
 
+### Initialize a New Project
+
+```bash
+# Create a new Output SDK project
+output init my-project
+```
+
+#### What It Does
+
+Creates a complete Output SDK project structure with:
+- Example workflows demonstrating SDK features
+- TypeScript project configuration
+- Agent configuration files
+
+### Start Development Services
+
+```bash
+# Start with automatic file watching (default)
+output dev
+
+# Start without file watching
+output dev --no-watch
+```
+
+#### What It Does
+
+The `dev` command orchestrates your entire development environment:
+1. Starts Docker services (Temporal, Redis, PostgreSQL)
+2. Launches the API server for workflow execution
+3. Starts the worker to process workflows
+4. Opens Temporal UI for workflow monitoring
+5. Automatically restarts the worker when source files change
+6. Provides a unified log view of all services
+
+This is the primary command for local development - it handles all the complexity of running multiple services and keeps them synchronized.
+
+#### Automatic File Watching
+
+By default, the worker container automatically restarts when you modify files in:
+- `src/` - Your workflow source files and implementations
+- `package.json` - When dependencies change
+
+This feature uses Docker Compose's native watch functionality (requires Docker Compose v2.22+).
+
+#### Command Options
+
+- `--no-watch` - Disable automatic container restart on file changes
+
 ### List Workflows
 
 ```bash

package/bin/copyassets.sh

@@ -0,0 +1,8 @@
+#!/bin/bash
+set -e
+
+copyfiles -u 1 --all './src/**/*.template' dist
+copyfiles -u 1 './src/**/*.prompt' dist
+copyfiles -u 1 './src/assets/**/*' dist
+
+echo "✅ Assets copied to dist/"

package/bin/run.js

@@ -1,5 +1,9 @@
 #!/usr/bin/env node
 
 import { execute } from '@oclif/core';
+import { loadEnvironment } from '../dist/utils/env_loader.js';
+
+// Load environment variables from .env files before executing CLI
+loadEnvironment();
 
 await execute( { dir: import.meta.url } );

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

@@ -1,3 +1,11 @@
+/**
+ * Generated by orval v7.13.2 🍺
+ * Do not edit manually.
+ * Output.ai SDK API
+ * API for managing and executing Temporal workflows through Output SDK
+ * OpenAPI spec version: 1.0.0
+ */
+import { type ApiRequestOptions } from '../http_client.js';
 export type JSONSchemaProperties = {
     [key: string]: JSONSchema;
 };
@@ -29,20 +37,32 @@ export type PostWorkflowRunBody = {
     workflowName: string;
     /** The payload to send to the workflow */
     input: unknown;
+    /** (Optional) The workflowId to use. Must be unique */
+    workflowId?: string;
     /** The name of the task queue to send the workflow to */
     taskQueue?: string;
 };
+/**
+ * An object with information about the trace generated by the execution
+ */
+export type PostWorkflowRun200Trace = {
+    [key: string]: unknown;
+};
 export type PostWorkflowRun200 = {
     /** The workflow execution id */
     workflowId?: string;
     /** The output of the workflow */
     output?: unknown;
+    /** An object with information about the trace generated by the execution */
+    trace?: PostWorkflowRun200Trace;
 };
 export type PostWorkflowStartBody = {
     /** The name of the workflow to execute */
     workflowName: string;
     /** The payload to send to the workflow */
     input: unknown;
+    /** (Optional) The workflowId to use. Must be unique */
+    workflowId?: string;
     /** The name of the task queue to send the workflow to */
     taskQueue?: string;
 };
@@ -75,16 +95,18 @@ export type GetWorkflowIdStatus200 = {
     completedAt?: number;
 };
 /**
- * The output of workflow
+ * An object with information about the trace generated by the execution
  */
-export type GetWorkflowIdOutput200Output = {
+export type GetWorkflowIdOutput200Trace = {
     [key: string]: unknown;
 };
 export type GetWorkflowIdOutput200 = {
     /** The workflow execution id */
     workflowId?: string;
     /** The output of workflow */
-    output?: GetWorkflowIdOutput200Output;
+    output?: unknown;
+    /** An object with information about the trace generated by the execution */
+    trace?: GetWorkflowIdOutput200Trace;
 };
 export type GetWorkflowCatalogId200 = {
     /** Each workflow available in this catalog */
@@ -110,7 +132,7 @@ export type getHealthResponseSuccess = (getHealthResponse200) & {
 };
 export type getHealthResponse = (getHealthResponseSuccess);
 export declare const getGetHealthUrl: () => string;
-export declare const getHealth: (options?: RequestInit) => Promise<getHealthResponse>;
+export declare const getHealth: (options?: ApiRequestOptions) => Promise<getHealthResponse>;
 /**
  * Executes a workflow and waits for it to complete before returning the result
  * @summary Execute a workflow synchronously
@@ -124,7 +146,7 @@ export type postWorkflowRunResponseSuccess = (postWorkflowRunResponse200) & {
 };
 export type postWorkflowRunResponse = (postWorkflowRunResponseSuccess);
 export declare const getPostWorkflowRunUrl: () => string;
-export declare const postWorkflowRun: (postWorkflowRunBody: PostWorkflowRunBody, options?: RequestInit) => Promise<postWorkflowRunResponse>;
+export declare const postWorkflowRun: (postWorkflowRunBody: PostWorkflowRunBody, options?: ApiRequestOptions) => Promise<postWorkflowRunResponse>;
 /**
  * @summary Start a workflow asynchronously
  */
@@ -137,7 +159,7 @@ export type postWorkflowStartResponseSuccess = (postWorkflowStartResponse200) &
 };
 export type postWorkflowStartResponse = (postWorkflowStartResponseSuccess);
 export declare const getPostWorkflowStartUrl: () => string;
-export declare const postWorkflowStart: (postWorkflowStartBody: PostWorkflowStartBody, options?: RequestInit) => Promise<postWorkflowStartResponse>;
+export declare const postWorkflowStart: (postWorkflowStartBody: PostWorkflowStartBody, options?: ApiRequestOptions) => Promise<postWorkflowStartResponse>;
 /**
  * @summary Get workflow execution status
  */
@@ -157,7 +179,7 @@ export type getWorkflowIdStatusResponseError = (getWorkflowIdStatusResponse404)
 };
 export type getWorkflowIdStatusResponse = (getWorkflowIdStatusResponseSuccess | getWorkflowIdStatusResponseError);
 export declare const getGetWorkflowIdStatusUrl: (id: string) => string;
-export declare const getWorkflowIdStatus: (id: string, options?: RequestInit) => Promise<getWorkflowIdStatusResponse>;
+export declare const getWorkflowIdStatus: (id: string, options?: ApiRequestOptions) => Promise<getWorkflowIdStatusResponse>;
 /**
  * @summary Stop a workflow execution
  */
@@ -177,7 +199,7 @@ export type patchWorkflowIdStopResponseError = (patchWorkflowIdStopResponse404)
 };
 export type patchWorkflowIdStopResponse = (patchWorkflowIdStopResponseSuccess | patchWorkflowIdStopResponseError);
 export declare const getPatchWorkflowIdStopUrl: (id: string) => string;
-export declare const patchWorkflowIdStop: (id: string, options?: RequestInit) => Promise<patchWorkflowIdStopResponse>;
+export declare const patchWorkflowIdStop: (id: string, options?: ApiRequestOptions) => Promise<patchWorkflowIdStopResponse>;
 /**
  * @summary Return the output of a workflow
  */
@@ -197,7 +219,7 @@ export type getWorkflowIdOutputResponseError = (getWorkflowIdOutputResponse404)
 };
 export type getWorkflowIdOutputResponse = (getWorkflowIdOutputResponseSuccess | getWorkflowIdOutputResponseError);
 export declare const getGetWorkflowIdOutputUrl: (id: string) => string;
-export declare const getWorkflowIdOutput: (id: string, options?: RequestInit) => Promise<getWorkflowIdOutputResponse>;
+export declare const getWorkflowIdOutput: (id: string, options?: ApiRequestOptions) => Promise<getWorkflowIdOutputResponse>;
 /**
  * @summary Get a specific workflow catalog by ID
  */
@@ -210,7 +232,7 @@ export type getWorkflowCatalogIdResponseSuccess = (getWorkflowCatalogIdResponse2
 };
 export type getWorkflowCatalogIdResponse = (getWorkflowCatalogIdResponseSuccess);
 export declare const getGetWorkflowCatalogIdUrl: (id: string) => string;
-export declare const getWorkflowCatalogId: (id: string, options?: RequestInit) => Promise<getWorkflowCatalogIdResponse>;
+export declare const getWorkflowCatalogId: (id: string, options?: ApiRequestOptions) => Promise<getWorkflowCatalogIdResponse>;
 /**
  * @summary Get the default workflow catalog
  */
@@ -223,7 +245,7 @@ export type getWorkflowCatalogResponseSuccess = (getWorkflowCatalogResponse200)
 };
 export type getWorkflowCatalogResponse = (getWorkflowCatalogResponseSuccess);
 export declare const getGetWorkflowCatalogUrl: () => string;
-export declare const getWorkflowCatalog: (options?: RequestInit) => Promise<getWorkflowCatalogResponse>;
+export declare const getWorkflowCatalog: (options?: ApiRequestOptions) => Promise<getWorkflowCatalogResponse>;
 /**
  * @summary Send feedback to a payload
  */
@@ -236,7 +258,7 @@ export type postWorkflowIdFeedbackResponseSuccess = (postWorkflowIdFeedbackRespo
 };
 export type postWorkflowIdFeedbackResponse = (postWorkflowIdFeedbackResponseSuccess);
 export declare const getPostWorkflowIdFeedbackUrl: (id: string) => string;
-export declare const postWorkflowIdFeedback: (id: string, postWorkflowIdFeedbackBody: PostWorkflowIdFeedbackBody, options?: RequestInit) => Promise<postWorkflowIdFeedbackResponse>;
+export declare const postWorkflowIdFeedback: (id: string, postWorkflowIdFeedbackBody: PostWorkflowIdFeedbackBody, options?: ApiRequestOptions) => Promise<postWorkflowIdFeedbackResponse>;
 /**
  * @summary A dummy post endpoint for test only
  */
@@ -249,4 +271,4 @@ export type postHeartbeatResponseSuccess = (postHeartbeatResponse204) & {
 };
 export type postHeartbeatResponse = (postHeartbeatResponseSuccess);
 export declare const getPostHeartbeatUrl: () => string;
-export declare const postHeartbeat: (options?: RequestInit) => Promise<postHeartbeatResponse>;
+export declare const postHeartbeat: (options?: ApiRequestOptions) => Promise<postHeartbeatResponse>;

package/dist/api/http_client.d.ts

@@ -1,6 +1,12 @@
 /**
  * Custom ky-based HTTP client for Orval-generated API
  */
-export declare const customFetchInstance: <T>(url: string, options: RequestInit & {
+import type { Options as KyOptions } from 'ky';
+/**
+ * Custom API request options that extend RequestInit with additional config
+ */
+export type ApiRequestOptions = RequestInit & {
     params?: Record<string, unknown>;
-}) => Promise<T>;
+    config?: KyOptions;
+};
+export declare const customFetchInstance: <T>(url: string, options: ApiRequestOptions) => Promise<T>;

package/dist/api/http_client.js

@@ -23,12 +23,20 @@ const api = ky.create({
     }
 });
 const stripLeadingSlash = (url) => url.startsWith('/') ? url.slice(1) : url;
-const buildKyOptions = (options) => ({
-    method: options.method,
-    headers: options.headers,
-    searchParams: options.params,
-    body: options.body && options.method !== 'GET' ? options.body : undefined
-});
+const buildKyOptions = (options) => {
+    // Extract params, config, and body for special handling
+    const { params, config: customConfig, body, ...restOptions } = options;
+    return {
+        // Pass through standard RequestInit options
+        ...restOptions,
+        // Convert params to searchParams for ky (if not already in config)
+        searchParams: customConfig?.searchParams || params,
+        // Only include body for non-GET requests
+        ...(body && options.method !== 'GET' ? { body } : {}),
+        // Spread any ky-specific config options
+        ...customConfig
+    };
+};
 const wrapResponse = (response, data) => ({
     data,
     status: response.status,

package/dist/api/orval_post_process.d.ts

@@ -1,5 +1,6 @@
 /**
- * Orval post-generation hook to fix ES module imports by adding .js extensions.
+ * Orval post-generation hook to fix ES module imports by adding .js extensions
+ * and update RequestInit types to use our custom ApiRequestOptions.
  * This is necessary because the SDK uses "type": "module" in package.json,
  * which requires all relative imports to have explicit .js extensions.
  */

package/dist/api/orval_post_process.js

@@ -1,15 +1,28 @@
 import { readFileSync, writeFileSync } from 'fs';
 import { execSync } from 'child_process';
 /**
- * Orval post-generation hook to fix ES module imports by adding .js extensions.
+ * Orval post-generation hook to fix ES module imports by adding .js extensions
+ * and update RequestInit types to use our custom ApiRequestOptions.
  * This is necessary because the SDK uses "type": "module" in package.json,
  * which requires all relative imports to have explicit .js extensions.
  */
 export async function fixEsmImports(outputPath) {
-    const content = readFileSync(outputPath, 'utf8');
-    const fixedContent = content.replace(/from '\.\.\/http_client'/g, 'from \'../http_client.js\'');
-    writeFileSync(outputPath, fixedContent, 'utf8');
-    console.log('✅ Fixed ESM imports in Orval generated file');
+    const originalContent = readFileSync(outputPath, 'utf8');
+    // Apply all transformations in sequence
+    const transformedContent = originalContent
+        // Fix ESM imports
+        .replace(/from '\.\.\/http_client'/g, 'from \'../http_client.js\'')
+        // Import ApiRequestOptions type from http_client
+        .replace(/import { customFetchInstance } from '\.\.\/http_client\.js';/, match => {
+        if (!originalContent.includes('ApiRequestOptions')) {
+            return 'import { customFetchInstance, type ApiRequestOptions } from \'../http_client.js\';';
+        }
+        return match;
+    })
+        // Replace RequestInit with ApiRequestOptions in function signatures
+        .replace(/options\?: RequestInit/g, 'options?: ApiRequestOptions');
+    writeFileSync(outputPath, transformedContent, 'utf8');
+    console.log('✅ Fixed ESM imports and updated types in Orval generated file');
 }
 /**
  * Run ESLint fix on generated files to ensure they follow project standards

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

@@ -0,0 +1,130 @@
+name: ${DOCKER_SERVICE_NAME:-output-sdk}
+services:
+  redis:
+    image: redis:8-alpine
+    networks:
+      - main
+    ports:
+      - '6379:6379'
+    volumes:
+      - redis:/data
+    healthcheck:
+      test: ['CMD', 'redis-cli', 'ping']
+      interval: 2s
+      timeout: 2s
+      retries: 5
+      start_period: 3s
+
+  postgresql:
+    environment:
+      POSTGRES_PASSWORD: temporal
+      POSTGRES_USER: temporal
+    image: postgres:17.5
+    networks:
+      - main
+    expose:
+      - 5432
+    volumes:
+      - postgres:/var/lib/postgresql/data
+    healthcheck:
+      test: ['CMD-SHELL', 'pg_isready -U temporal -d temporal']
+      interval: 2s
+      timeout: 2s
+      retries: 5
+      start_period: 3s
+
+  temporal:
+    depends_on:
+      postgresql:
+        condition: service_healthy
+      redis:
+        condition: service_healthy
+    environment:
+      - DB=postgres12
+      - DB_PORT=5432
+      - POSTGRES_USER=temporal
+      - POSTGRES_PWD=temporal
+      - POSTGRES_SEEDS=postgresql
+    image: temporalio/auto-setup:latest
+    networks:
+      - main
+    ports:
+      - '7233:7233'
+    healthcheck:
+      test:
+        [
+          'CMD',
+          'sh',
+          '-c',
+          'tctl --address temporal:7233 cluster health 2>&1 | grep -q "temporal.api.workflowservice.v1.WorkflowService: SERVING"'
+        ]
+      interval: 3s
+      timeout: 5s
+      retries: 20
+      start_period: 10s
+
+  temporal-ui:
+    depends_on:
+      - temporal
+    environment:
+      - TEMPORAL_ADDRESS=temporal:7233
+      - TEMPORAL_CORS_ORIGINS=http://localhost:3000
+    image: temporalio/ui:latest
+    networks:
+      - main
+    ports:
+      - '8080:8080'
+
+  api:
+    depends_on:
+      temporal:
+        condition: service_healthy
+    image: growthxteam/output-api:latest
+    networks:
+      - main
+    environment:
+      - PORT=3001
+      - CATALOG_ID=main
+      - TEMPORAL_ADDRESS=temporal:7233
+      - NODE_ENV=development
+    ports:
+      - '3001:3001'
+
+  worker:
+    depends_on:
+      temporal:
+        condition: service_healthy
+    image: node:24.3-slim
+    networks:
+      - main
+    env_file: './.env'
+    environment:
+      - CATALOG_ID=main
+      - LOG_HTTP_VERBOSE=true
+      - REDIS_URL=redis://redis:6379
+      - TEMPORAL_ADDRESS=temporal:7233
+      - TRACE_LOCAL_ON=true
+    command: npm run start-worker
+    working_dir: /app
+    volumes:
+      - ./:/app
+    develop:
+      watch:
+        - path: ./src
+          target: /app/src
+          action: restart
+          ignore:
+            - node_modules/
+            - '**/*.test.ts'
+            - '**/*.spec.ts'
+        - path: ./package.json
+          target: /app/package.json
+          action: restart
+
+volumes:
+  postgres:
+  redis:
+
+networks:
+  main:
+    driver: bridge

package/dist/commands/agents/init.js

@@ -1,6 +1,7 @@
 import { Command, Flags } from '@oclif/core';
 import { AGENT_CONFIG_DIR } from '#config.js';
 import { initializeAgentConfig, AGENT_CONFIGS } from '#services/coding_agents.js';
+import { getErrorMessage, getErrorCode } from '#utils/error_utils.js';
 export default class Init extends Command {
     static description = 'Initialize agent configuration files for AI assistant integration';
     static examples = [
@@ -39,10 +40,11 @@ export default class Init extends Command {
             this.log('Claude Code will automatically detect and use these configurations.');
         }
         catch (error) {
-            if (error.code === 'EACCES') {
+            if (getErrorCode(error) === 'EACCES') {
                 this.error('Permission denied. Please check file permissions and try again.');
+                return;
             }
-            this.error(`Failed to initialize agent configuration: ${error.message}`);
+            this.error(`Failed to initialize agent configuration: ${getErrorMessage(error)}`);
         }
     }
 }

package/dist/commands/dev/eject.d.ts

@@ -0,0 +1,11 @@
+import { Command } from '@oclif/core';
+export default class DevEject extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {};
+    static flags: {
+        output: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        force: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/dev/eject.js

@@ -0,0 +1,58 @@
+import { Command, Flags } from '@oclif/core';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { getDefaultDockerComposePath } from '#services/docker.js';
+import { getErrorMessage } from '#utils/error_utils.js';
+import { getEjectSuccessMessage } from '#services/messages.js';
+export default class DevEject extends Command {
+    static description = 'Eject the Docker Compose configuration to your project root for customization';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --output ./custom-compose.yml'
+    ];
+    static args = {};
+    static flags = {
+        output: Flags.string({
+            description: 'Output path for the docker-compose file',
+            required: false,
+            char: 'o',
+            default: 'docker-compose.yml'
+        }),
+        force: Flags.boolean({
+            description: 'Overwrite existing file without prompting',
+            required: false,
+            char: 'f',
+            default: false
+        })
+    };
+    async run() {
+        const { flags } = await this.parse(DevEject);
+        // Source docker-compose file from assets
+        const sourcePath = getDefaultDockerComposePath();
+        // Destination path (relative to current working directory)
+        const destPath = path.resolve(process.cwd(), flags.output);
+        try {
+            // Check if source file exists
+            await fs.access(sourcePath);
+        }
+        catch {
+            this.error(`Docker Compose template not found at: ${sourcePath}`, { exit: 1 });
+        }
+        // Check if destination file already exists
+        const fileExists = await fs.access(destPath).then(() => true).catch(() => false);
+        if (fileExists && !flags.force) {
+            this.error(`File already exists at ${destPath}. Use --force to overwrite or specify a different output path with --output`, { exit: 1 });
+        }
+        try {
+            // Read the source file
+            const dockerComposeContent = await fs.readFile(sourcePath, 'utf-8');
+            // Write to destination
+            await fs.writeFile(destPath, dockerComposeContent, 'utf-8');
+            // Display the styled success message
+            this.log(getEjectSuccessMessage(destPath, flags.output, this.config.bin));
+        }
+        catch (error) {
+            this.error(`Failed to eject docker-compose configuration: ${getErrorMessage(error)}`, { exit: 1 });
+        }
+    }
+}

package/dist/commands/dev/eject.spec.d.ts

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

package/dist/commands/dev/eject.spec.js

@@ -0,0 +1,109 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import fs from 'node:fs/promises';
+import DevEject from './eject.js';
+vi.mock('node:fs/promises');
+describe('dev eject command', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    describe('command structure', () => {
+        it('should have correct description', () => {
+            expect(DevEject.description).toBeDefined();
+            expect(DevEject.description).toContain('Eject');
+            expect(DevEject.description).toContain('Docker Compose');
+        });
+        it('should have examples', () => {
+            expect(DevEject.examples).toBeDefined();
+            expect(Array.isArray(DevEject.examples)).toBe(true);
+            expect(DevEject.examples.length).toBeGreaterThan(0);
+        });
+        it('should have no required arguments', () => {
+            expect(DevEject.args).toBeDefined();
+            expect(Object.keys(DevEject.args)).toHaveLength(0);
+        });
+        it('should have output and force flags defined', () => {
+            expect(DevEject.flags).toBeDefined();
+            expect(DevEject.flags.output).toBeDefined();
+            expect(DevEject.flags.output.description).toContain('Output path');
+            expect(DevEject.flags.output.required).toBe(false);
+            expect(DevEject.flags.output.char).toBe('o');
+            expect(DevEject.flags.output.default).toBe('docker-compose.yml');
+            expect(DevEject.flags.force).toBeDefined();
+            expect(DevEject.flags.force.description).toContain('Overwrite');
+            expect(DevEject.flags.force.required).toBe(false);
+            expect(DevEject.flags.force.char).toBe('f');
+            expect(DevEject.flags.force.default).toBe(false);
+        });
+    });
+    describe('command instantiation', () => {
+        it('should be instantiable', () => {
+            const cmd = new DevEject([], {});
+            expect(cmd).toBeInstanceOf(DevEject);
+        });
+        it('should have a run method', () => {
+            const cmd = new DevEject([], {});
+            expect(cmd.run).toBeDefined();
+            expect(typeof cmd.run).toBe('function');
+        });
+    });
+    describe('file ejection', () => {
+        it('should eject docker-compose file to default location', async () => {
+            const config = {
+                runHook: vi.fn().mockResolvedValue({ failures: [], successes: [] })
+            };
+            const cmd = new DevEject([], config);
+            cmd.log = vi.fn();
+            cmd.error = vi.fn();
+            const mockDockerComposeContent = 'name: output-sdk\nservices:\n  redis:\n    image: redis:8-alpine';
+            // Mock source file exists and can be read
+            vi.mocked(fs.access).mockImplementation(path => {
+                if (path.toString().includes('assets/docker/docker-compose-dev.yml')) {
+                    return Promise.resolve();
+                }
+                // Destination file doesn't exist
+                return Promise.reject(new Error('File not found'));
+            });
+            vi.mocked(fs.readFile).mockResolvedValue(mockDockerComposeContent);
+            vi.mocked(fs.writeFile).mockResolvedValue();
+            await cmd.run();
+            expect(fs.readFile).toHaveBeenCalled();
+            expect(fs.writeFile).toHaveBeenCalledWith(expect.stringContaining('docker-compose.yml'), mockDockerComposeContent, 'utf-8');
+            expect(cmd.log).toHaveBeenCalledWith(expect.stringContaining('SUCCESS!'));
+        });
+        it('should error if destination file exists and force flag is not set', async () => {
+            const config = {
+                runHook: vi.fn().mockResolvedValue({ failures: [], successes: [] })
+            };
+            const cmd = new DevEject([], config);
+            cmd.log = vi.fn();
+            cmd.error = vi.fn().mockImplementation(msg => {
+                throw new Error(msg);
+            });
+            // Mock both source and destination files exist
+            vi.mocked(fs.access).mockResolvedValue();
+            await expect(cmd.run()).rejects.toThrow('File already exists');
+            expect(cmd.error).toHaveBeenCalledWith(expect.stringContaining('File already exists'), { exit: 1 });
+        });
+        it('should overwrite file if force flag is set', async () => {
+            const config = {
+                runHook: vi.fn().mockResolvedValue({ failures: [], successes: [] })
+            };
+            const cmd = new DevEject(['--force'], config);
+            cmd.log = vi.fn();
+            cmd.error = vi.fn();
+            const mockDockerComposeContent = 'name: output-sdk\nservices:\n  redis:\n    image: redis:8-alpine';
+            // Mock both source and destination files exist
+            vi.mocked(fs.access).mockResolvedValue();
+            vi.mocked(fs.readFile).mockResolvedValue(mockDockerComposeContent);
+            vi.mocked(fs.writeFile).mockResolvedValue();
+            await cmd.run();
+            expect(fs.readFile).toHaveBeenCalled();
+            expect(fs.writeFile).toHaveBeenCalledWith(expect.stringContaining('docker-compose.yml'), mockDockerComposeContent, 'utf-8');
+            expect(cmd.log).toHaveBeenCalledWith(expect.stringContaining('SUCCESS!'));
+        });
+    });
+});

package/dist/commands/dev/index.d.ts

@@ -0,0 +1,11 @@
+import { Command } from '@oclif/core';
+export default class Dev extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {};
+    static flags: {
+        'compose-file': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'no-watch': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}