@output.ai/cli 0.3.1-dev.pr156.0 → 0.4.0

package/README.md

@@ -103,15 +103,6 @@ output workflow debug <workflowId>
 
 # Display trace in JSON format
 output workflow debug <workflowId> --format json
-
-# Prefer remote (S3) trace over local
-output workflow debug <workflowId> --remote
-
-# Save trace to a custom directory
-output workflow debug <workflowId> --download-dir ./my-traces
-
-# Force re-download of remote traces (bypass cache)
-output workflow debug <workflowId> --remote --force-download
 ```
 
 #### What It Does
@@ -123,30 +114,13 @@ The `debug` command retrieves and displays detailed execution traces for debuggi
 - Error details and stack traces
 - Performance metrics and durations
 
-#### Trace Sources
-
-The command automatically handles both local and remote traces:
-- **Local traces**: Stored on your machine when `TRACE_LOCAL_ON=true`
-- **Remote traces**: Stored in S3 when `TRACE_REMOTE_ON=true` (requires AWS credentials)
-
-By default, it tries local traces first for faster access, then falls back to remote if needed.
-
 #### Command Options
 
 - `--format, -f` - Output format: `text` (default, human-readable) or `json` (raw trace data)
-- `--remote, -r` - Prefer remote S3 trace even if local exists
-- `--download-dir, -d` - Directory for saving downloaded traces (default: `.output/traces`)
-- `--open, -o` - Save trace to file for viewing in external JSON viewer
-- `--force-download` - Force re-download from S3, bypassing local cache
 
-#### AWS Configuration
+#### Environment Variables
 
-For remote traces, configure AWS credentials:
-```bash
-export AWS_ACCESS_KEY_ID=your-access-key
-export AWS_SECRET_ACCESS_KEY=your-secret-key
-export AWS_REGION=us-east-1  # or your region
-```
+- `HOST_TRACE_PATH` - When running in Docker, this maps the container's trace log path to the host filesystem path. Set this to your project's `logs` directory (e.g., `${PWD}/logs`). Required for trace files to be accessible from the CLI when workflows run in containers.
 
 ### Generate a Workflow
 

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

@@ -32,6 +32,28 @@ export interface Workflow {
     inputSchema?: JSONSchema;
     outputSchema?: JSONSchema;
 }
+/**
+ * File destinations for trace data
+ */
+export type TraceInfoDestinations = {
+    /**
+     * Absolute path to local trace file, or null if not saved locally
+     * @nullable
+     */
+    local: string | null;
+    /**
+     * Remote trace location (e.g., S3 URI), or null if not saved remotely
+     * @nullable
+     */
+    remote: string | null;
+};
+/**
+ * An object with information about the trace generated by the execution
+ */
+export interface TraceInfo {
+    /** File destinations for trace data */
+    destinations?: TraceInfoDestinations;
+}
 export type PostWorkflowRunBody = {
     /** The name of the workflow to execute */
     workflowName: string;
@@ -42,19 +64,12 @@ export type PostWorkflowRunBody = {
     /** 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;
+    trace?: TraceInfo;
 };
 export type PostWorkflowStartBody = {
     /** The name of the workflow to execute */
@@ -94,31 +109,12 @@ export type GetWorkflowIdStatus200 = {
     /** An epoch timestamp representing when the workflow ended */
     completedAt?: number;
 };
-/**
- * An object with information about the trace generated by the execution
- */
-export type GetWorkflowIdOutput200Trace = {
-    [key: string]: unknown;
-};
-export type GetWorkflowIdOutput200 = {
+export type GetWorkflowIdResult200 = {
     /** The workflow execution id */
     workflowId?: string;
-    /** The output of workflow */
+    /** The result of workflow */
     output?: unknown;
-    /** An object with information about the trace generated by the execution */
-    trace?: GetWorkflowIdOutput200Trace;
-};
-/**
- * The trace tree object containing execution details
- */
-export type GetWorkflowIdTraceLog200 = {
-    [key: string]: unknown;
-};
-export type GetWorkflowIdTraceLog404 = {
-    /** Error type */
-    error?: string;
-    /** Detailed error message */
-    message?: string;
+    trace?: TraceInfo;
 };
 export type GetWorkflowCatalogId200 = {
     /** Each workflow available in this catalog */
@@ -213,45 +209,25 @@ export type patchWorkflowIdStopResponse = (patchWorkflowIdStopResponseSuccess |
 export declare const getPatchWorkflowIdStopUrl: (id: string) => string;
 export declare const patchWorkflowIdStop: (id: string, options?: ApiRequestOptions) => Promise<patchWorkflowIdStopResponse>;
 /**
- * @summary Return the output of a workflow
+ * @summary Return the result of a workflow
  */
-export type getWorkflowIdOutputResponse200 = {
-    data: GetWorkflowIdOutput200;
+export type getWorkflowIdResultResponse200 = {
+    data: GetWorkflowIdResult200;
     status: 200;
 };
-export type getWorkflowIdOutputResponse404 = {
+export type getWorkflowIdResultResponse404 = {
     data: void;
     status: 404;
 };
-export type getWorkflowIdOutputResponseSuccess = (getWorkflowIdOutputResponse200) & {
-    headers: Headers;
-};
-export type getWorkflowIdOutputResponseError = (getWorkflowIdOutputResponse404) & {
-    headers: Headers;
-};
-export type getWorkflowIdOutputResponse = (getWorkflowIdOutputResponseSuccess | getWorkflowIdOutputResponseError);
-export declare const getGetWorkflowIdOutputUrl: (id: string) => string;
-export declare const getWorkflowIdOutput: (id: string, options?: ApiRequestOptions) => Promise<getWorkflowIdOutputResponse>;
-/**
- * @summary Get the trace log contents from a workflow execution
- */
-export type getWorkflowIdTraceLogResponse200 = {
-    data: GetWorkflowIdTraceLog200;
-    status: 200;
-};
-export type getWorkflowIdTraceLogResponse404 = {
-    data: GetWorkflowIdTraceLog404;
-    status: 404;
-};
-export type getWorkflowIdTraceLogResponseSuccess = (getWorkflowIdTraceLogResponse200) & {
+export type getWorkflowIdResultResponseSuccess = (getWorkflowIdResultResponse200) & {
     headers: Headers;
 };
-export type getWorkflowIdTraceLogResponseError = (getWorkflowIdTraceLogResponse404) & {
+export type getWorkflowIdResultResponseError = (getWorkflowIdResultResponse404) & {
     headers: Headers;
 };
-export type getWorkflowIdTraceLogResponse = (getWorkflowIdTraceLogResponseSuccess | getWorkflowIdTraceLogResponseError);
-export declare const getGetWorkflowIdTraceLogUrl: (id: string) => string;
-export declare const getWorkflowIdTraceLog: (id: string, options?: ApiRequestOptions) => Promise<getWorkflowIdTraceLogResponse>;
+export type getWorkflowIdResultResponse = (getWorkflowIdResultResponseSuccess | getWorkflowIdResultResponseError);
+export declare const getGetWorkflowIdResultUrl: (id: string) => string;
+export declare const getWorkflowIdResult: (id: string, options?: ApiRequestOptions) => Promise<getWorkflowIdResultResponse>;
 /**
  * @summary Get a specific workflow catalog by ID
  */

package/dist/api/generated/api.js

@@ -69,20 +69,11 @@ export const patchWorkflowIdStop = async (id, options) => {
         method: 'PATCH'
     });
 };
-export const getGetWorkflowIdOutputUrl = (id) => {
-    return `/workflow/${id}/output`;
+export const getGetWorkflowIdResultUrl = (id) => {
+    return `/workflow/${id}/result`;
 };
-export const getWorkflowIdOutput = async (id, options) => {
-    return customFetchInstance(getGetWorkflowIdOutputUrl(id), {
-        ...options,
-        method: 'GET'
-    });
-};
-export const getGetWorkflowIdTraceLogUrl = (id) => {
-    return `/workflow/${id}/trace_log`;
-};
-export const getWorkflowIdTraceLog = async (id, options) => {
-    return customFetchInstance(getGetWorkflowIdTraceLogUrl(id), {
+export const getWorkflowIdResult = async (id, options) => {
+    return customFetchInstance(getGetWorkflowIdResultUrl(id), {
         ...options,
         method: 'GET'
     });

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

@@ -80,6 +80,7 @@ services:
       temporal:
         condition: service_healthy
     image: growthxteam/output-api:latest
+    pull_policy: always
     networks:
       - main
     environment:
@@ -87,8 +88,6 @@ services:
       - CATALOG_ID=main
       - TEMPORAL_ADDRESS=temporal:7233
       - NODE_ENV=development
-    volumes:
-      - ./logs:/app/logs:ro
     ports:
       - '3001:3001'
 
@@ -106,6 +105,7 @@ services:
       - REDIS_URL=redis://redis:6379
       - TEMPORAL_ADDRESS=temporal:7233
       - TRACE_LOCAL_ON=true
+      - HOST_TRACE_PATH=${PWD}/logs
     command: npm run start-worker
     working_dir: /app
     volumes:

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

@@ -7,15 +7,9 @@ export default class WorkflowDebug extends Command {
     };
     static flags: {
         format: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        remote: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        'download-dir': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        open: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        'force-download': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
-    private getLocalTrace;
-    private getRemoteTrace;
-    private openInViewer;
-    private formatDuration;
+    private outputJson;
+    private displayTextTrace;
     catch(error: Error): Promise<void>;
 }

package/dist/commands/workflow/debug.js

@@ -1,21 +1,14 @@
 import { Args, Command, Flags } from '@oclif/core';
-import * as fs from 'node:fs/promises';
-import * as path from 'node:path';
-import { existsSync } from 'node:fs';
-import { getWorkflowIdOutput } from '#api/generated/api.js';
 import { OUTPUT_FORMAT } from '#utils/constants.js';
+import { displayDebugTree } from '#utils/trace_formatter.js';
+import { getTrace } from '#services/trace_reader.js';
 import { handleApiError } from '#utils/error_handler.js';
-import { s3Downloader } from '#utils/s3_downloader.js';
-import { traceFormatter } from '#utils/trace_formatter.js';
-// Note: 'open' dependency is optional for --open flag functionality
 export default class WorkflowDebug extends Command {
     static description = 'Get and display workflow execution trace for debugging';
     static examples = [
         '<%= config.bin %> <%= command.id %> wf-12345',
         '<%= config.bin %> <%= command.id %> wf-12345 --format json',
-        '<%= config.bin %> <%= command.id %> wf-12345 --remote',
-        '<%= config.bin %> <%= command.id %> wf-12345 --open',
-        '<%= config.bin %> <%= command.id %> wf-12345 --download-dir ./my-traces'
+        '<%= config.bin %> <%= command.id %> wf-12345 --format text'
     ];
     static args = {
         workflowId: Args.string({
@@ -29,169 +22,36 @@ export default class WorkflowDebug extends Command {
             description: 'Output format',
             options: [OUTPUT_FORMAT.JSON, OUTPUT_FORMAT.TEXT],
             default: OUTPUT_FORMAT.TEXT
-        }),
-        remote: Flags.boolean({
-            char: 'r',
-            description: 'Prefer remote (S3) trace over local',
-            default: false
-        }),
-        'download-dir': Flags.string({
-            char: 'd',
-            description: 'Directory to save downloaded remote traces',
-            default: path.join(process.cwd(), '.output', 'traces')
-        }),
-        open: Flags.boolean({
-            char: 'o',
-            description: 'Open trace file in default viewer/browser',
-            default: false
-        }),
-        'force-download': Flags.boolean({
-            description: 'Force re-download of remote traces (bypass cache)',
-            default: false
         })
     };
     async run() {
         const { args, flags } = await this.parse(WorkflowDebug);
-        this.log(`Fetching debug information for workflow: ${args.workflowId}...`);
-        // Get workflow output which includes trace destinations
-        const response = await getWorkflowIdOutput(args.workflowId);
-        if (!response || !response.data) {
-            this.error('API returned invalid response', { exit: 1 });
-        }
-        const { trace } = response.data;
-        const typedTrace = trace;
-        if (!typedTrace || !typedTrace.destinations) {
-            this.error('No trace information available for this workflow', { exit: 1 });
-        }
-        const { local: localPath, remote: remotePath } = typedTrace.destinations;
-        // Determine which trace to use based on flags and availability
-        // eslint-disable-next-line no-restricted-syntax
-        let traceContent = null;
-        // eslint-disable-next-line no-restricted-syntax
-        let traceSource = '';
-        if (flags.remote && remotePath) {
-            // User prefers remote trace
-            traceContent = await this.getRemoteTrace(remotePath, flags);
-            traceSource = 'remote';
-        }
-        else if (localPath) {
-            // Try local first
-            traceContent = await this.getLocalTrace(localPath);
-            traceSource = 'local';
-            // If local not found but remote available, try remote
-            if (!traceContent && remotePath && !flags.remote) {
-                this.log('Local trace not found, trying remote...');
-                traceContent = await this.getRemoteTrace(remotePath, flags);
-                traceSource = 'remote';
-            }
-        }
-        else if (remotePath) {
-            // Only remote available
-            traceContent = await this.getRemoteTrace(remotePath, flags);
-            traceSource = 'remote';
-        }
-        if (!traceContent) {
-            this.error('No trace file could be retrieved. The workflow may still be running or trace files may have been deleted.', { exit: 1 });
-        }
-        // Parse and validate trace JSON
-        // eslint-disable-next-line init-declarations, no-restricted-syntax, @typescript-eslint/no-explicit-any
-        let traceData;
-        try {
-            traceData = JSON.parse(traceContent);
-        }
-        catch {
-            this.error('Invalid trace file format: could not parse JSON', { exit: 1 });
-        }
-        // Get summary statistics
-        const summary = traceFormatter.getSummary(traceData);
-        // Display source information
-        this.log(`\nTrace source: ${traceSource}`);
-        this.log(`Total events: ${summary.totalEvents}`);
-        this.log(`Total steps: ${summary.totalSteps}`);
-        this.log(`Total activities: ${summary.totalActivities}`);
-        if (summary.totalDuration > 0) {
-            this.log(`Total duration: ${this.formatDuration(summary.totalDuration)}`);
-        }
-        if (summary.hasErrors) {
-            this.log('⚠️  Workflow contains errors');
-        }
-        this.log('');
-        // Format and display trace
-        const formattedOutput = traceFormatter.format(traceData, flags.format);
-        this.log(formattedOutput);
-        // Open in viewer if requested
-        if (flags.open) {
-            await this.openInViewer(traceContent, args.workflowId, flags['download-dir']);
-        }
+        const isJsonFormat = flags.format === OUTPUT_FORMAT.JSON;
+        if (!isJsonFormat) {
+            this.log(`Fetching debug information for workflow: ${args.workflowId}...`);
+        }
+        const traceData = await getTrace(args.workflowId);
+        // Output based on format
+        if (isJsonFormat) {
+            this.outputJson(traceData);
+            return;
+        }
+        // Display text format
+        this.displayTextTrace(traceData);
     }
-    async getLocalTrace(localPath) {
-        try {
-            // Check if file exists
-            if (!existsSync(localPath)) {
-                return null;
-            }
-            // Read file content
-            const content = await fs.readFile(localPath, 'utf-8');
-            return content;
-        }
-        catch (error) {
-            this.warn(`Failed to read local trace file: ${error instanceof Error ? error.message : 'Unknown error'}`);
-            return null;
-        }
-    }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    async getRemoteTrace(remotePath, flags) {
-        try {
-            // Check if S3 downloader is available
-            if (!s3Downloader.isAvailable()) {
-                this.error('AWS credentials not configured. Please set AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables to access remote traces.', { exit: 1 });
-            }
-            this.log('Downloading trace from S3...');
-            // Download with cache support
-            const content = await s3Downloader.download(remotePath, {
-                forceDownload: flags['force-download']
-            });
-            if (!flags['force-download']) {
-                this.log('(Using cached version if available)');
-            }
-            return content;
-        }
-        catch (error) {
-            this.warn(`Failed to download remote trace: ${error instanceof Error ? error.message : 'Unknown error'}`);
-            return null;
-        }
+    outputJson(data) {
+        this.log(JSON.stringify(data, null, 2));
     }
-    async openInViewer(content, workflowId, downloadDir) {
-        try {
-            // Save to temporary file
-            const tempDir = downloadDir;
-            await fs.mkdir(tempDir, { recursive: true });
-            const tempFile = path.join(tempDir, `${workflowId}_debug.json`);
-            await fs.writeFile(tempFile, content, 'utf-8');
-            this.log(`\nTrace file saved to: ${tempFile}`);
-            this.log('You can open this file in your preferred JSON viewer or text editor.');
-            // Note: To automatically open files, install the 'open' package and uncomment below:
-            // await open(tempFile);
-        }
-        catch (error) {
-            this.warn(`Failed to save file: ${error instanceof Error ? error.message : 'Unknown error'}`);
-        }
-    }
-    formatDuration(ms) {
-        if (ms < 1000) {
-            return `${ms}ms`;
-        }
-        if (ms < 60000) {
-            return `${(ms / 1000).toFixed(2)}s`;
-        }
-        const minutes = Math.floor(ms / 60000);
-        const seconds = ((ms % 60000) / 1000).toFixed(0);
-        return `${minutes}m ${seconds}s`;
+    displayTextTrace(traceData) {
+        this.log('\nTrace Log:');
+        this.log('─'.repeat(80));
+        this.log(displayDebugTree(traceData));
+        this.log('\n' + '─'.repeat(80));
+        this.log('Tip: Use --format json for the full untruncated trace');
     }
     async catch(error) {
         return handleApiError(error, (...args) => this.error(...args), {
-            404: 'Workflow not found. Check the workflow ID.',
-            500: 'Server error. The workflow may still be running or the trace may not be available yet.'
+            404: 'Workflow not found or trace not available. Check the workflow ID.'
         });
     }
 }

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

@@ -0,0 +1,36 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+// Mock the TraceReader service
+vi.mock('../../services/trace_reader.js', () => ({
+    findTraceFile: vi.fn(),
+    readTraceFile: vi.fn(),
+    getTrace: vi.fn()
+}));
+// Mock the utilities
+vi.mock('../../utils/trace_formatter.js', () => ({
+    displayDebugTree: vi.fn()
+}));
+describe('workflow debug command', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    describe('command definition', () => {
+        it('should export a valid OCLIF command', async () => {
+            const WorkflowDebug = (await import('./debug.js')).default;
+            expect(WorkflowDebug).toBeDefined();
+            expect(WorkflowDebug.description).toContain('Get and display workflow execution trace for debugging');
+            expect(WorkflowDebug.args).toHaveProperty('workflowId');
+            expect(WorkflowDebug.flags).toHaveProperty('format');
+        });
+        it('should have correct flag configuration', async () => {
+            const WorkflowDebug = (await import('./debug.js')).default;
+            // Format flag
+            expect(WorkflowDebug.flags.format.options).toEqual(['json', 'text']);
+            expect(WorkflowDebug.flags.format.default).toBe('text');
+        });
+        it('should have correct examples', async () => {
+            const WorkflowDebug = (await import('./debug.js')).default;
+            expect(WorkflowDebug.examples).toBeDefined();
+            expect(WorkflowDebug.examples.length).toBeGreaterThan(0);
+        });
+    });
+});

package/dist/commands/workflow/generate.js

@@ -2,6 +2,7 @@ import { Args, Command, Flags, ux } from '@oclif/core';
 import { generateWorkflow } from '#services/workflow_generator.js';
 import { buildWorkflow, buildWorkflowInteractiveLoop } from '#services/workflow_builder.js';
 import { ensureOutputAIStructure } from '#services/coding_agents.js';
+import { getWorkflowGenerateSuccessMessage } from '#services/messages.js';
 import { DEFAULT_OUTPUT_DIRS } from '#utils/paths.js';
 import path from 'node:path';
 export default class Generate extends Command {
@@ -78,15 +79,7 @@ export default class Generate extends Command {
         }
     }
     displaySuccess(result) {
-        this.log(`\n[SUCCESS] Workflow "${result.workflowName}" created successfully!`);
-        this.log(`\nLocation: ${result.targetDir}`);
-        this.log('\n-- Next steps --');
-        this.log(`   1. cd ${result.targetDir}`);
-        this.log('   2. Edit the workflow files to customize your implementation');
-        this.log('   3. If using @output.ai/llm, configure your .env file with LLM provider credentials:');
-        this.log('      - ANTHROPIC_API_KEY for Claude');
-        this.log('      - OPENAI_API_KEY for OpenAI');
-        this.log('   4. Build and run with the worker');
-        this.log('\nCheck the README.md for workflow-specific documentation.');
+        const message = getWorkflowGenerateSuccessMessage(result.workflowName, result.targetDir, result.filesCreated);
+        this.log(message);
     }
 }

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

@@ -46,7 +46,8 @@ describe('Generate Command', () => {
                 skeleton: true,
                 force: false
             });
-            expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('[SUCCESS] Workflow "test-workflow" created successfully!'));
+            expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('SUCCESS!'));
+            expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('test-workflow'));
         });
         it('should require skeleton flag and reject without it', async () => {
             const cmd = createCommand();
@@ -105,9 +106,10 @@ describe('Generate Command', () => {
                 filesCreated: ['index.ts', 'steps.ts', 'types.ts']
             });
             await cmd.run();
-            expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('[SUCCESS] Workflow "my-workflow" created successfully!'));
-            expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('Location: /custom/path/my-workflow'));
-            expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('-- Next steps --'));
+            expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('SUCCESS!'));
+            expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('my-workflow'));
+            expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('/custom/path/my-workflow'));
+            expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('NEXT STEPS'));
         });
     });
 });

package/dist/commands/workflow/{output.d.ts → result.d.ts}

@@ -1,5 +1,5 @@
 import { Command } from '@oclif/core';
-export default class WorkflowOutput extends Command {
+export default class WorkflowResult extends Command {
     static description: string;
     static examples: string[];
     static args: {

package/dist/commands/workflow/{output.js → result.js}

@@ -1,17 +1,17 @@
 import { Args, Command, Flags } from '@oclif/core';
-import { getWorkflowIdOutput } from '#api/generated/api.js';
+import { getWorkflowIdResult } from '#api/generated/api.js';
 import { OUTPUT_FORMAT } from '#utils/constants.js';
 import { formatOutput } from '#utils/output_formatter.js';
 import { handleApiError } from '#utils/error_handler.js';
-export default class WorkflowOutput extends Command {
-    static description = 'Get workflow execution output';
+export default class WorkflowResult extends Command {
+    static description = 'Get workflow execution result';
     static examples = [
         '<%= config.bin %> <%= command.id %> wf-12345',
         '<%= config.bin %> <%= command.id %> wf-12345 --format json'
     ];
     static args = {
         workflowId: Args.string({
-            description: 'The workflow ID to get output for',
+            description: 'The workflow ID to get result for',
             required: true
         })
     };
@@ -24,9 +24,9 @@ export default class WorkflowOutput extends Command {
         })
     };
     async run() {
-        const { args, flags } = await this.parse(WorkflowOutput);
-        this.log(`Fetching output for workflow: ${args.workflowId}...`);
-        const response = await getWorkflowIdOutput(args.workflowId);
+        const { args, flags } = await this.parse(WorkflowResult);
+        this.log(`Fetching result for workflow: ${args.workflowId}...`);
+        const response = await getWorkflowIdResult(args.workflowId);
         if (!response || !response.data) {
             this.error('API returned invalid response', { exit: 1 });
         }
@@ -34,7 +34,7 @@ export default class WorkflowOutput extends Command {
             const lines = [
                 `Workflow ID: ${result.workflowId || 'unknown'}`,
                 '',
-                'Output:',
+                'Result:',
                 JSON.stringify(result.output, null, 2)
             ];
             return lines.join('\n');

package/dist/commands/workflow/result.test.js

@@ -0,0 +1,23 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+vi.mock('../../api/generated/api.js', () => ({
+    getWorkflowIdResult: vi.fn()
+}));
+describe('workflow result command', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    describe('command definition', () => {
+        it('should export a valid OCLIF command', async () => {
+            const WorkflowResult = (await import('./result.js')).default;
+            expect(WorkflowResult).toBeDefined();
+            expect(WorkflowResult.description).toContain('Get workflow execution result');
+            expect(WorkflowResult.args).toHaveProperty('workflowId');
+            expect(WorkflowResult.flags).toHaveProperty('format');
+        });
+        it('should have correct flag configuration', async () => {
+            const WorkflowResult = (await import('./result.js')).default;
+            expect(WorkflowResult.flags.format.options).toEqual(['json', 'text']);
+            expect(WorkflowResult.flags.format.default).toBe('text');
+        });
+    });
+});

package/dist/commands/workflow/start.js

@@ -45,7 +45,7 @@ export default class WorkflowStart extends Command {
             `Workflow ID: ${result.workflowId || 'unknown'}`,
             '',
             `Use "workflow status ${result.workflowId || '<workflow-id>'}" to check the workflow status`,
-            `Use "workflow output ${result.workflowId || '<workflow-id>'}" to get the workflow output when complete`
+            `Use "workflow result ${result.workflowId || '<workflow-id>'}" to get the workflow result when complete`
         ].join('\n');
         this.log(`\n${output}`);
     }