@outputai/cli 0.1.13-next.04243eb.0 → 0.1.13-next.0fd573d.0

package/dist/api/generated/api.js

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v8.6.2 🍺
+ * Generated by orval v8.8.0 🍺
  * Do not edit manually.
  * Output.ai API
  * API for managing and executing Output.ai workflows
@@ -24,11 +24,7 @@ export const WorkflowRunInfoStatus = {
     timed_out: 'timed_out',
     continued: 'continued',
 };
-export const PostWorkflowRun200Status = {
-    completed: 'completed',
-    failed: 'failed',
-};
-export const GetWorkflowIdStatus200Status = {
+export const WorkflowStatusResponseStatus = {
     canceled: 'canceled',
     completed: 'completed',
     continued_as_new: 'continued_as_new',
@@ -38,7 +34,7 @@ export const GetWorkflowIdStatus200Status = {
     timed_out: 'timed_out',
     unspecified: 'unspecified',
 };
-export const GetWorkflowIdResult200Status = {
+export const WorkflowResultResponseStatus = {
     completed: 'completed',
     failed: 'failed',
     canceled: 'canceled',
@@ -46,6 +42,10 @@ export const GetWorkflowIdResult200Status = {
     timed_out: 'timed_out',
     continued: 'continued',
 };
+export const PostWorkflowRun200Status = {
+    completed: 'completed',
+    failed: 'failed',
+};
 ;
 export const getGetHealthUrl = () => {
     return `/health`;
@@ -87,6 +87,24 @@ export const getWorkflowIdStatus = async (id, options) => {
         method: 'GET'
     });
 };
+export const getGetWorkflowIdRunsRidStatusUrl = (id, rid) => {
+    return `/workflow/${id}/runs/${rid}/status`;
+};
+export const getWorkflowIdRunsRidStatus = async (id, rid, options) => {
+    return customFetchInstance(getGetWorkflowIdRunsRidStatusUrl(id, rid), {
+        ...options,
+        method: 'GET'
+    });
+};
+export const getPatchWorkflowIdRunsRidStopUrl = (id, rid) => {
+    return `/workflow/${id}/runs/${rid}/stop`;
+};
+export const patchWorkflowIdRunsRidStop = async (id, rid, options) => {
+    return customFetchInstance(getPatchWorkflowIdRunsRidStopUrl(id, rid), {
+        ...options,
+        method: 'PATCH'
+    });
+};
 export const getPatchWorkflowIdStopUrl = (id) => {
     return `/workflow/${id}/stop`;
 };
@@ -96,6 +114,17 @@ export const patchWorkflowIdStop = async (id, options) => {
         method: 'PATCH'
     });
 };
+export const getPostWorkflowIdRunsRidTerminateUrl = (id, rid) => {
+    return `/workflow/${id}/runs/${rid}/terminate`;
+};
+export const postWorkflowIdRunsRidTerminate = async (id, rid, postWorkflowIdRunsRidTerminateBody, options) => {
+    return customFetchInstance(getPostWorkflowIdRunsRidTerminateUrl(id, rid), {
+        ...options,
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', ...options?.headers },
+        body: JSON.stringify(postWorkflowIdRunsRidTerminateBody)
+    });
+};
 export const getPostWorkflowIdTerminateUrl = (id) => {
     return `/workflow/${id}/terminate`;
 };
@@ -107,15 +136,26 @@ export const postWorkflowIdTerminate = async (id, postWorkflowIdTerminateBody, o
         body: JSON.stringify(postWorkflowIdTerminateBody)
     });
 };
+export const getPostWorkflowIdRunsRidResetUrl = (id, rid) => {
+    return `/workflow/${id}/runs/${rid}/reset`;
+};
+export const postWorkflowIdRunsRidReset = async (id, rid, resetWorkflowRequest, options) => {
+    return customFetchInstance(getPostWorkflowIdRunsRidResetUrl(id, rid), {
+        ...options,
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', ...options?.headers },
+        body: JSON.stringify(resetWorkflowRequest)
+    });
+};
 export const getPostWorkflowIdResetUrl = (id) => {
     return `/workflow/${id}/reset`;
 };
-export const postWorkflowIdReset = async (id, postWorkflowIdResetBody, options) => {
+export const postWorkflowIdReset = async (id, resetWorkflowRequest, options) => {
     return customFetchInstance(getPostWorkflowIdResetUrl(id), {
         ...options,
         method: 'POST',
         headers: { 'Content-Type': 'application/json', ...options?.headers },
-        body: JSON.stringify(postWorkflowIdResetBody)
+        body: JSON.stringify(resetWorkflowRequest)
     });
 };
 export const getGetWorkflowIdResultUrl = (id) => {
@@ -127,6 +167,15 @@ export const getWorkflowIdResult = async (id, options) => {
         method: 'GET'
     });
 };
+export const getGetWorkflowIdRunsRidResultUrl = (id, rid) => {
+    return `/workflow/${id}/runs/${rid}/result`;
+};
+export const getWorkflowIdRunsRidResult = async (id, rid, options) => {
+    return customFetchInstance(getGetWorkflowIdRunsRidResultUrl(id, rid), {
+        ...options,
+        method: 'GET'
+    });
+};
 export const getGetWorkflowIdTraceLogUrl = (id) => {
     return `/workflow/${id}/trace-log`;
 };
@@ -136,6 +185,15 @@ export const getWorkflowIdTraceLog = async (id, options) => {
         method: 'GET'
     });
 };
+export const getGetWorkflowIdRunsRidTraceLogUrl = (id, rid) => {
+    return `/workflow/${id}/runs/${rid}/trace-log`;
+};
+export const getWorkflowIdRunsRidTraceLog = async (id, rid, options) => {
+    return customFetchInstance(getGetWorkflowIdRunsRidTraceLogUrl(id, rid), {
+        ...options,
+        method: 'GET'
+    });
+};
 export const getGetWorkflowCatalogIdUrl = (id) => {
     return `/workflow/catalog/${id}`;
 };

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

@@ -81,7 +81,7 @@ services:
         condition: service_healthy
       worker:
         condition: service_healthy
-    image: outputai/api:${OUTPUT_API_VERSION:-0.1.13-next.04243eb.0}
+    image: outputai/api:${OUTPUT_API_VERSION:-0.1.13-next.0fd573d.0}
     init: true
     networks:
       - main

package/dist/commands/migrate.d.ts

@@ -0,0 +1,11 @@
+import { Command } from '@oclif/core';
+export default class Migrate extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        from: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        to: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        notes: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/migrate.js

@@ -0,0 +1,40 @@
+import { Command, Flags } from '@oclif/core';
+import { ensureOutputAISystem } from '#services/coding_agents.js';
+import { invokeMigrate } from '#services/claude_client.js';
+export default class Migrate extends Command {
+    static description = 'Upgrade a project between versions of the Output framework. ' +
+        'Fetches the matching migration guide from docs.output.ai and applies it.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --to 0.2.0',
+        '<%= config.bin %> <%= command.id %> --from 0.1.12 --to 0.2.0',
+        '<%= config.bin %> <%= command.id %> --to 0.2.0 --notes "skip the http changes, we don\'t use that package"'
+    ];
+    static flags = {
+        from: Flags.string({
+            description: 'Version to migrate from. Defaults to the framework version in your package.json.',
+            required: false
+        }),
+        to: Flags.string({
+            description: 'Version to migrate to. Defaults to the latest published version.',
+            required: false
+        }),
+        notes: Flags.string({
+            char: 'n',
+            description: 'Extra guidance passed through to the migration agent.',
+            required: false
+        })
+    };
+    async run() {
+        const { flags } = await this.parse(Migrate);
+        const projectRoot = process.cwd();
+        this.log('Checking .outputai directory structure...');
+        await ensureOutputAISystem(projectRoot);
+        this.log('\nInvoking the /output-migrate skill...');
+        this.log('This may take a moment...\n');
+        const summary = await invokeMigrate(flags.from ?? '', flags.to ?? '', flags.notes);
+        this.log('\n=========');
+        this.log(summary);
+        this.log('=========\n');
+    }
+}

package/dist/commands/workflow/generate.js

@@ -4,6 +4,7 @@ import { buildWorkflow, buildWorkflowInteractiveLoop } from '#services/workflow_
 import { ensureOutputAISystem } from '#services/coding_agents.js';
 import { getWorkflowGenerateSuccessMessage } from '#services/messages.js';
 import { DEFAULT_OUTPUT_DIRS } from '#utils/paths.js';
+import { parseWorkflowDir } from '#utils/workflow_dir_parser.js';
 import path from 'node:path';
 import * as fsSync from 'node:fs';
 import { getErrorMessage } from '#utils/error_utils.js';
@@ -83,7 +84,8 @@ export default class Generate extends Command {
         this.displaySuccess(result);
     }
     displaySuccess(result) {
-        const message = getWorkflowGenerateSuccessMessage(result.workflowName, result.targetDir, result.filesCreated);
+        const dirInfo = parseWorkflowDir(result.targetDir);
+        const message = getWorkflowGenerateSuccessMessage(result.workflowName, dirInfo.workflowId ?? result.workflowName, dirInfo.scenarioNames[0], result.targetDir, result.filesCreated);
         this.log(message);
     }
 }

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

@@ -2,10 +2,13 @@
 import { describe, it, expect, beforeEach, vi } from 'vitest';
 import Generate from './generate.js';
 import { generateWorkflow } from '#services/workflow_generator.js';
+import { parseWorkflowDir } from '#utils/workflow_dir_parser.js';
 import { InvalidNameError, WorkflowExistsError } from '#types/errors.js';
 vi.mock('../../services/workflow_generator.js');
+vi.mock('../../utils/workflow_dir_parser.js');
 describe('Generate Command', () => {
     let mockGenerateWorkflow;
+    let mockParseWorkflowDir;
     let logSpy;
     const createCommand = () => {
         const cmd = new Generate([], {});
@@ -20,6 +23,7 @@ describe('Generate Command', () => {
     beforeEach(() => {
         vi.clearAllMocks();
         mockGenerateWorkflow = vi.mocked(generateWorkflow);
+        mockParseWorkflowDir = vi.mocked(parseWorkflowDir);
     });
     describe('successful workflow generation', () => {
         it('should generate workflow with skeleton flag', async () => {
@@ -38,6 +42,10 @@ describe('Generate Command', () => {
                 targetDir: '/tmp/test-workflow',
                 filesCreated: ['index.ts', 'steps.ts', 'types.ts']
             });
+            mockParseWorkflowDir.mockReturnValue({
+                workflowId: 'testWorkflow',
+                scenarioNames: ['test_input']
+            });
             await cmd.run();
             expect(mockGenerateWorkflow).toHaveBeenCalledWith({
                 name: 'test-workflow',
@@ -105,6 +113,10 @@ describe('Generate Command', () => {
                 targetDir: '/custom/path/my-workflow',
                 filesCreated: ['index.ts', 'steps.ts', 'types.ts']
             });
+            mockParseWorkflowDir.mockReturnValue({
+                workflowId: 'myWorkflow',
+                scenarioNames: ['test_input']
+            });
             await cmd.run();
             expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('SUCCESS!'));
             expect(logSpy).toHaveBeenCalledWith(expect.stringContaining('my-workflow'));

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

@@ -6,6 +6,7 @@ interface WorkflowDisplay {
     inputs: string;
     outputs: string;
     scenarios: string;
+    aliases: string;
 }
 export declare function parseWorkflowForDisplay(workflow: Workflow): WorkflowDisplay;
 export default class WorkflowList extends Command {

package/dist/commands/workflow/list.js

@@ -17,7 +17,8 @@ export function parseWorkflowForDisplay(workflow) {
         description: parsed.description || 'No description',
         inputs: formatParameters(parsed.inputs),
         outputs: formatParameters(parsed.outputs),
-        scenarios: scenarioNames.length > 0 ? scenarioNames.join(', ') : 'none'
+        scenarios: scenarioNames.length > 0 ? scenarioNames.join(', ') : 'none',
+        aliases: workflow.aliases?.length ? workflow.aliases.join(', ') : 'none'
     };
 }
 function caseInsensitiveIncludes(str, filter) {
@@ -26,7 +27,10 @@ function caseInsensitiveIncludes(str, filter) {
 function matchName(filterString) {
     return workflow => {
         const name = workflow.name || '';
-        return caseInsensitiveIncludes(name, filterString);
+        if (caseInsensitiveIncludes(name, filterString)) {
+            return true;
+        }
+        return (workflow.aliases ?? []).some(alias => caseInsensitiveIncludes(alias, filterString));
     };
 }
 function sortWorkflowsByName(workflows) {
@@ -38,8 +42,8 @@ function sortWorkflowsByName(workflows) {
 }
 function createWorkflowTable(workflows, detailed) {
     const table = new Table({
-        head: ['Name', 'Description', 'Inputs', 'Outputs', 'Scenarios'],
-        colWidths: detailed ? [30, 42, 42, 42, 60] : [24, 30, 24, 24, 48],
+        head: ['Name', 'Description', 'Aliases', 'Inputs', 'Outputs', 'Scenarios'],
+        colWidths: detailed ? [28, 36, 36, 36, 36, 48] : [22, 26, 26, 22, 22, 36],
         wordWrap: true,
         style: {
             head: ['cyan']
@@ -49,13 +53,14 @@ function createWorkflowTable(workflows, detailed) {
     sortedWorkflows.forEach(workflow => {
         const display = parseWorkflowForDisplay(workflow);
         if (detailed) {
+            const aliases = workflow.aliases?.length ? workflow.aliases.join('\n') : 'none';
             const inputs = display.inputs.split(', ').join('\n');
             const outputs = display.outputs.split(', ').join('\n');
             const scenarios = display.scenarios.split(', ').join('\n');
-            table.push([display.name, display.description, inputs, outputs, scenarios]);
+            table.push([display.name, display.description, aliases, inputs, outputs, scenarios]);
         }
         else {
-            table.push([display.name, display.description, display.inputs, display.outputs, display.scenarios]);
+            table.push([display.name, display.description, display.aliases, display.inputs, display.outputs, display.scenarios]);
         }
     });
     return table.toString();
@@ -72,6 +77,7 @@ function formatWorkflowsAsJson(workflows) {
             return {
                 name: display.name,
                 description: display.description,
+                aliases: w.aliases ?? [],
                 inputs: display.inputs.split(', '),
                 outputs: display.outputs.split(', '),
                 scenarios: display.scenarios === 'none' ? [] : display.scenarios.split(', '),

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

@@ -64,6 +64,27 @@ describe('workflow list parsing', () => {
         expect(parsed.inputs).toBe('none');
         expect(parsed.outputs).toBe('none');
         expect(parsed.scenarios).toBe('none');
+        expect(parsed.aliases).toBe('none');
+    });
+    it('should include aliases when present', async () => {
+        const { parseWorkflowForDisplay } = await import('./list.js');
+        const mockWorkflow = {
+            name: 'aliased-workflow',
+            description: 'Has aliases',
+            aliases: ['old_name', 'legacy_name']
+        };
+        const parsed = parseWorkflowForDisplay(mockWorkflow);
+        expect(parsed.aliases).toBe('old_name, legacy_name');
+    });
+    it('should show none when aliases array is empty', async () => {
+        const { parseWorkflowForDisplay } = await import('./list.js');
+        const mockWorkflow = {
+            name: 'no-aliases',
+            description: 'Empty aliases',
+            aliases: []
+        };
+        const parsed = parseWorkflowForDisplay(mockWorkflow);
+        expect(parsed.aliases).toBe('none');
     });
     it('should include scenario names when scenarios exist', async () => {
         mockListScenarios.mockReturnValueOnce(['basic', 'advanced', 'stress_test']);

package/dist/commands/workflow/run.js

@@ -55,7 +55,8 @@ export default class WorkflowRun extends Command {
         }),
         'task-queue': Flags.string({
             char: 'q',
-            description: 'Task queue name for workflow execution'
+            description: 'Task queue name for workflow execution (defaults to OUTPUT_CATALOG_ID)',
+            env: 'OUTPUT_CATALOG_ID'
         }),
         format: Flags.string({
             char: 'f',

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

@@ -13,6 +13,7 @@ vi.mock('#utils/sleep.js', () => ({
 describe('workflow run command', () => {
     beforeEach(async () => {
         vi.clearAllMocks();
+        delete process.env.OUTPUT_CATALOG_ID;
         const { resolveInput } = await import('#utils/resolve_input.js');
         const { sleep } = await import('#utils/sleep.js');
         vi.mocked(resolveInput).mockResolvedValue({});

package/dist/commands/workflow/start.js

@@ -28,7 +28,8 @@ export default class WorkflowStart extends Command {
         }),
         'task-queue': Flags.string({
             char: 'q',
-            description: 'Task queue name for workflow execution'
+            description: 'Task queue name for workflow execution (defaults to OUTPUT_CATALOG_ID)',
+            env: 'OUTPUT_CATALOG_ID'
         })
     };
     async run() {

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

@@ -5,6 +5,7 @@ vi.mock('../../api/generated/api.js', () => ({
 describe('workflow start command', () => {
     beforeEach(() => {
         vi.clearAllMocks();
+        delete process.env.OUTPUT_CATALOG_ID;
     });
     describe('command definition', () => {
         it('should export a valid OCLIF command', async () => {

package/dist/commands/workflow/test_eval.js

@@ -114,7 +114,7 @@ export default class WorkflowTest extends Command {
                 }
             };
             if (save) {
-                const filePath = join(dir, `${dataset.name}.yml`);
+                const filePath = dataset._source ?? join(dir, `${dataset.name}.yml`);
                 await writeDataset(updated, filePath);
                 this.log(`    Saved output to ${filePath}`);
             }
@@ -137,7 +137,7 @@ export default class WorkflowTest extends Command {
                     date: now
                 }
             };
-            const filePath = join(dir, `${dataset.name}.yml`);
+            const filePath = dataset._source ?? join(dir, `${dataset.name}.yml`);
             await writeDataset(updated, filePath);
             this.log(`  Saved eval result to ${filePath}`);
         }

package/dist/components/command_footer.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+export interface CommandHint {
+    key: string;
+    label: string;
+}
+export declare const CommandFooter: React.FC<{
+    hints: CommandHint[];
+}>;

package/dist/components/command_footer.js

@@ -0,0 +1,4 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+import { Box, Text } from 'ink';
+export const CommandFooter = ({ hints }) => (_jsx(Box, { marginTop: 1, children: hints.map((hint, i) => (_jsxs(React.Fragment, { children: [i > 0 && _jsx(Text, { dimColor: true, children: ' | ' }), _jsx(Text, { dimColor: true, children: '(' }), _jsx(Text, { dimColor: true, bold: true, children: hint.key }), _jsx(Text, { dimColor: true, children: ')' }), _jsx(Text, { dimColor: true, children: ` ${hint.label}` })] }, hint.key))) }));

package/dist/components/status_icon.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+interface StatusDisplay {
+    icon: string;
+    color: string;
+}
+export declare const resolveStatus: (status: string) => StatusDisplay;
+export declare const statusColor: (status: string) => string;
+export declare const StatusIcon: React.FC<{
+    status: string;
+}>;
+export {};

package/dist/components/status_icon.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Text } from 'ink';
+const STATUS_MAP = {
+    // Docker service health
+    healthy: { icon: '●', color: 'green' },
+    unhealthy: { icon: '○', color: 'red' },
+    starting: { icon: '◐', color: 'yellow' },
+    none: { icon: '●', color: 'blue' },
+    exited: { icon: '✗', color: 'red' },
+    // Workflow run status
+    running: { icon: '●', color: 'blue' },
+    completed: { icon: '●', color: 'green' },
+    failed: { icon: '✗', color: 'red' },
+    canceled: { icon: '○', color: 'gray' },
+    terminated: { icon: '✗', color: 'red' },
+    timed_out: { icon: '✗', color: 'red' },
+    continued: { icon: '↻', color: 'blue' }
+};
+const DEFAULT_DISPLAY = { icon: '?', color: 'white' };
+export const resolveStatus = (status) => STATUS_MAP[status] ?? DEFAULT_DISPLAY;
+export const statusColor = (status) => resolveStatus(status).color;
+export const StatusIcon = ({ status }) => {
+    const { icon, color } = resolveStatus(status);
+    return _jsx(Text, { color: color, children: icon });
+};

package/dist/components/workflow_summary.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+export interface WorkflowSummary {
+    running: number;
+    completed: number;
+    failed: number;
+    total: number;
+}
+export declare const WorkflowSummarySection: React.FC<{
+    summary: WorkflowSummary;
+}>;

package/dist/components/workflow_summary.js

@@ -0,0 +1,4 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import { statusColor } from '#components/status_icon.js';
+export const WorkflowSummarySection = ({ summary }) => (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { bold: true, children: "\uD83D\uDCCB Workflows" }), _jsxs(Box, { marginTop: 1, children: [_jsxs(Text, { color: statusColor('running'), children: [summary.running, " running"] }), _jsx(Text, { children: ", " }), _jsxs(Text, { color: statusColor('failed'), children: [summary.failed, " failed"] }), _jsx(Text, { children: ", " }), _jsxs(Text, { color: statusColor('completed'), children: [summary.completed, " complete"] })] })] }));

package/dist/generated/framework_version.json

@@ -1,3 +1,3 @@
 {
-    "framework": "0.1.13-next.04243eb.0"
+    "framework": "0.1.13-next.0fd573d.0"
 }

package/dist/services/claude_client.d.ts

@@ -5,6 +5,7 @@ import { Options } from '@anthropic-ai/claude-agent-sdk';
 export declare const ADDITIONAL_INSTRUCTIONS: {
     readonly PLAN: "\n! IMPORTANT !\n1. Use TodoWrite to track your progress through plan creation.\n\n2. Please respond with only the final version of the plan content.\n\n3. Respond in a markdown format with these metadata headers:\n\n---\ntitle: <plan-title>\ndescription: <plan-description>\ndate: <plan-date>\n---\n\n<plan-content>\n\n4. After you mark all todos as complete, you must respond with the final version of the plan.\n\n5. DO NOT write the plan to disk — the CLI will handle saving the file to the plans directory.\n\n6. DO NOT suggest any next steps, follow-up commands, or instructions for the user — the CLI will inform the user of next steps after saving.\n";
     readonly BUILD: "\n! IMPORTANT !\n1. Use TodoWrite to track your progress through workflow implementation.\n\n2. Follow the implementation plan exactly as specified in the plan file.\n\n3. Implement all workflow files following Output.ai patterns and best practices.\n\n4. After you mark all todos as complete, provide a summary of what was implemented.\n";
+    readonly MIGRATE: "\n! IMPORTANT !\n1. Use TodoWrite to track your progress through the migration.\n\n2. Fetch the migration guide from https://docs.output.ai/migrations — do not invent migration steps from memory.\n\n3. If the specific guide URL 404s, fall back to the /migrations index and chain the guides that cover the version range.\n\n4. Confirm the planned changes with the user before editing files.\n\n5. After you mark all todos as complete, provide a summary of which files changed and whether the type check passed.\n";
 };
 export declare const PLAN_COMMAND_OPTIONS: Options;
 interface ReplyToClaudeOptions {
@@ -12,6 +13,7 @@ interface ReplyToClaudeOptions {
     applyAdditionalInstructions?: string;
 }
 export declare const BUILD_COMMAND_OPTIONS: Options;
+export declare const MIGRATE_COMMAND_OPTIONS: Options;
 export declare class ClaudeInvocationError extends Error {
     cause?: Error | undefined;
     constructor(message: string, cause?: Error | undefined);
@@ -36,4 +38,14 @@ export declare function invokePlanWorkflow(description: string): Promise<string>
  * @returns Implementation output from claude-code
  */
 export declare function invokeBuildWorkflow(planFilePath: string, workflowDir: string, workflowName: string, additionalInstructions?: string): Promise<string>;
+/**
+ * Invoke claude-code with /output-migrate slash command (registered via the output-migrate skill).
+ * The slash command fetches migration instructions from docs.output.ai —
+ * this CLI wrapper just passes through the version arguments.
+ * @param fromVersion - Current framework version (empty string = auto-detect)
+ * @param toVersion - Target version (empty string = use npm "latest")
+ * @param additionalInstructions - Optional user-supplied guidance
+ * @returns Migration summary from claude-code
+ */
+export declare function invokeMigrate(fromVersion: string, toVersion: string, additionalInstructions?: string): Promise<string>;
 export {};

package/dist/services/claude_client.js

@@ -38,10 +38,26 @@ date: <plan-date>
 3. Implement all workflow files following Output.ai patterns and best practices.
 
 4. After you mark all todos as complete, provide a summary of what was implemented.
+`,
+    MIGRATE: `
+! IMPORTANT !
+1. Use TodoWrite to track your progress through the migration.
+
+2. Fetch the migration guide from https://docs.output.ai/migrations — do not invent migration steps from memory.
+
+3. If the specific guide URL 404s, fall back to the /migrations index and chain the guides that cover the version range.
+
+4. Confirm the planned changes with the user before editing files.
+
+5. After you mark all todos as complete, provide a summary of which files changed and whether the type check passed.
 `
 };
+// Slash-command naming convention used by the outputai plugin:
+// - `outputai:<name>` — plugin commands under coding_assistants/.../commands/
+// - `output-<kebab-name>` — skills under coding_assistants/.../skills/, which surface as top-level slash commands without the plugin prefix.
 const PLAN_COMMAND = 'outputai:plan_workflow';
 const BUILD_COMMAND = 'outputai:build_workflow';
+const MIGRATE_COMMAND = 'output-migrate';
 const GLOBAL_CLAUDE_OPTIONS = {
     settingSources: ['user', 'project', 'local']
 };
@@ -51,6 +67,9 @@ export const PLAN_COMMAND_OPTIONS = {
 export const BUILD_COMMAND_OPTIONS = {
     permissionMode: 'bypassPermissions'
 };
+export const MIGRATE_COMMAND_OPTIONS = {
+    permissionMode: 'bypassPermissions'
+};
 export class ClaudeInvocationError extends Error {
     cause;
     constructor(message, cause) {
@@ -77,7 +96,7 @@ function validateEnvironment() {
     }
 }
 function validateSystem(systemMessage) {
-    const requiredCommands = [PLAN_COMMAND, BUILD_COMMAND];
+    const requiredCommands = [PLAN_COMMAND, BUILD_COMMAND, MIGRATE_COMMAND];
     const availableCommands = systemMessage.slash_commands;
     const missingCommands = requiredCommands.filter(command => !availableCommands.includes(command));
     return {
@@ -105,7 +124,10 @@ function getTodoWriteMessage(message) {
     if (message.type !== 'assistant') {
         return null;
     }
-    const todoWriteMessage = message.message.content.find((c) => c.type === 'tool_use' && c.name === 'TodoWrite');
+    const todoWriteMessage = message.message.content.find((c) => {
+        const block = c;
+        return block.type === 'tool_use' && block.name === 'TodoWrite';
+    });
     return todoWriteMessage ?? null;
 }
 function applyInstructions(message, instructions) {
@@ -216,3 +238,18 @@ export async function invokeBuildWorkflow(planFilePath, workflowDir, workflowNam
         `/${BUILD_COMMAND} ${commandArgs}`;
     return singleQuery(applyInstructions(fullCommand, ADDITIONAL_INSTRUCTIONS.BUILD), BUILD_COMMAND_OPTIONS);
 }
+/**
+ * Invoke claude-code with /output-migrate slash command (registered via the output-migrate skill).
+ * The slash command fetches migration instructions from docs.output.ai —
+ * this CLI wrapper just passes through the version arguments.
+ * @param fromVersion - Current framework version (empty string = auto-detect)
+ * @param toVersion - Target version (empty string = use npm "latest")
+ * @param additionalInstructions - Optional user-supplied guidance
+ * @returns Migration summary from claude-code
+ */
+export async function invokeMigrate(fromVersion, toVersion, additionalInstructions) {
+    const from = fromVersion || 'auto';
+    const to = toVersion || 'latest';
+    const commandArgs = [from, to, additionalInstructions].filter(Boolean).join(' ');
+    return singleQuery(applyInstructions(`/${MIGRATE_COMMAND} ${commandArgs}`, ADDITIONAL_INSTRUCTIONS.MIGRATE), MIGRATE_COMMAND_OPTIONS);
+}

package/dist/services/datasets.d.ts

@@ -8,7 +8,7 @@ export interface DatasetInfo {
 }
 export declare function resolveDatasetsDir(workflowName: string, basePath?: string): string | null;
 export declare function resolveDefaultDatasetsDir(workflowName: string, basePath?: string): string;
-export declare function readDataset(filePath: string): Promise<Dataset>;
+export declare function readDatasetFile(filePath: string): Promise<Dataset[]>;
 export declare function readAllDatasets(workflowName: string, filterNames?: string[], basePath?: string): Promise<{
     datasets: Dataset[];
     dir: string;