@outputai/cli 0.1.13-next.f537949.0 → 0.2.1-next.af8a069.0

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.f537949.0}
+    image: outputai/api:${OUTPUT_API_VERSION:-0.2.1-next.af8a069.0}
     init: true
     networks:
       - main
@@ -103,7 +103,7 @@ services:
     depends_on:
       temporal:
         condition: service_healthy
-    image: node:24.13.0-slim
+    image: node:24.15.0-slim
     healthcheck:
       test: [ 'CMD-SHELL', 'npx output-healthcheck' ]
       interval: 3s

package/dist/commands/credentials/set.d.ts

@@ -0,0 +1,16 @@
+import { Command } from '@oclif/core';
+export default class CredentialsSet extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        path: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        value: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        environment: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        workflow: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    private confirmOverwrite;
+    run(): Promise<void>;
+}

package/dist/commands/credentials/set.js

@@ -0,0 +1,125 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { confirm } from '@inquirer/prompts';
+import { load as parseYaml, dump as stringifyYaml } from 'js-yaml';
+import { getErrorMessage } from '#utils/error_utils.js';
+import { decryptCredentials, credentialsExist, writeEncrypted, resolveCredentialsPath } from '#services/credentials_service.js';
+const isPlainObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const detectPathConflict = (obj, dotPath) => {
+    const parts = dotPath.split('.');
+    const intermediateKeys = parts.slice(0, -1);
+    const leafKey = parts[parts.length - 1];
+    const walked = intermediateKeys.reduce((state, key, i) => {
+        if (state.done) {
+            return state;
+        }
+        const next = state.cursor[key];
+        if (next === undefined) {
+            return { done: true, conflict: null };
+        }
+        if (!isPlainObject(next)) {
+            return {
+                done: true,
+                conflict: {
+                    kind: 'primitive_to_object',
+                    atPath: parts.slice(0, i + 1).join('.'),
+                    existingValue: next
+                }
+            };
+        }
+        return { done: false, cursor: next };
+    }, { done: false, cursor: obj });
+    if (walked.done) {
+        return walked.conflict;
+    }
+    const leaf = walked.cursor[leafKey];
+    if (leaf !== undefined && (isPlainObject(leaf) || Array.isArray(leaf))) {
+        return { kind: 'object_to_primitive', atPath: dotPath, existingValue: leaf };
+    }
+    return null;
+};
+const setNestedValue = (obj, dotPath, value) => {
+    const parts = dotPath.split('.');
+    const parent = parts.slice(0, -1).reduce((current, key) => {
+        if (!isPlainObject(current[key])) {
+            current[key] = {};
+        }
+        return current[key];
+    }, obj);
+    parent[parts[parts.length - 1]] = value;
+};
+export default class CredentialsSet extends Command {
+    static description = 'Set a credential value by dot-notation path';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> anthropic.api_key sk-ant-...',
+        '<%= config.bin %> <%= command.id %> openai.api_key sk-... --environment production',
+        '<%= config.bin %> <%= command.id %> stripe.key sk_live_... --workflow my_workflow'
+    ];
+    static args = {
+        path: Args.string({
+            description: 'Dot-notation path to the credential (e.g. anthropic.api_key)',
+            required: true
+        }),
+        value: Args.string({
+            description: 'Value to set',
+            required: true
+        })
+    };
+    static flags = {
+        environment: Flags.string({
+            char: 'e',
+            description: 'Target environment (e.g. production, development)'
+        }),
+        workflow: Flags.string({
+            char: 'w',
+            description: 'Target a specific workflow directory'
+        }),
+        yes: Flags.boolean({
+            char: 'y',
+            description: 'Skip confirmation prompts when overwriting a value of a different shape',
+            default: false
+        })
+    };
+    async confirmOverwrite(conflict, newPath) {
+        if (conflict.kind === 'primitive_to_object') {
+            this.warn(`Writing to "${newPath}" will convert "${conflict.atPath}" from a value into an object, ` +
+                `discarding its current value (${JSON.stringify(conflict.existingValue)}).`);
+        }
+        else {
+            this.warn(`Writing to "${newPath}" will replace the existing object at that path ` +
+                `(${JSON.stringify(conflict.existingValue)}) with a string value.`);
+        }
+        return confirm({ message: 'Continue?', default: false });
+    }
+    async run() {
+        const { args, flags } = await this.parse(CredentialsSet);
+        const environment = flags.environment;
+        const workflow = flags.workflow;
+        if (environment && workflow) {
+            this.error('Cannot specify both --environment and --workflow.');
+        }
+        if (!credentialsExist(environment, workflow)) {
+            this.error(`No credentials file found at ${resolveCredentialsPath(environment, workflow)}. Run "output credentials init" first.`);
+        }
+        try {
+            const plaintext = decryptCredentials(environment, workflow);
+            const data = (parseYaml(plaintext) || {});
+            const conflict = detectPathConflict(data, args.path);
+            if (conflict && !flags.yes) {
+                const shouldContinue = await this.confirmOverwrite(conflict, args.path);
+                if (!shouldContinue) {
+                    this.log('Aborted.');
+                    return;
+                }
+            }
+            setNestedValue(data, args.path, args.value);
+            writeEncrypted(environment, stringifyYaml(data), workflow);
+        }
+        catch (error) {
+            if (error instanceof Error && error.constructor.name === 'ExitPromptError') {
+                return;
+            }
+            this.error(`Failed to update credentials: ${getErrorMessage(error)}`);
+        }
+        this.log(`Set ${args.path}`);
+    }
+}

package/dist/commands/credentials/set.spec.d.ts

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

package/dist/commands/credentials/set.spec.js

@@ -0,0 +1,160 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { confirm } from '@inquirer/prompts';
+import * as credentialsService from '#services/credentials_service.js';
+import CredentialsSet from './set.js';
+vi.mock('#services/credentials_service.js');
+vi.mock('@inquirer/prompts', () => ({
+    confirm: vi.fn()
+}));
+vi.mock('js-yaml', () => ({
+    load: vi.fn((yaml) => {
+        if (yaml.includes('__PRIMITIVE_AT_X_Y__')) {
+            return { x: { y: 'FOO' } };
+        }
+        if (yaml.includes('__OBJECT_AT_X_Y__')) {
+            return { x: { y: { z: 'FOO' } } };
+        }
+        if (yaml.includes('sk-existing')) {
+            return { anthropic: { api_key: 'sk-existing' } };
+        }
+        return {};
+    }),
+    dump: vi.fn((obj) => JSON.stringify(obj))
+}));
+describe('credentials set command', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        vi.mocked(credentialsService.credentialsExist).mockReturnValue(true);
+        vi.mocked(credentialsService.decryptCredentials).mockReturnValue('anthropic:\n  api_key: sk-existing\n');
+        vi.mocked(credentialsService.writeEncrypted).mockImplementation(() => { });
+        vi.mocked(confirm).mockResolvedValue(true);
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    const createTestCommand = (parsedArgs = {}, flags = {}) => {
+        const cmd = new CredentialsSet([], {});
+        cmd.log = vi.fn();
+        cmd.warn = vi.fn();
+        cmd.error = vi.fn((msg) => {
+            throw new Error(msg);
+        });
+        Object.defineProperty(cmd, 'parse', {
+            value: vi.fn().mockResolvedValue({
+                args: { path: 'anthropic.api_key', value: 'sk-new-key', ...parsedArgs },
+                flags: { environment: undefined, workflow: undefined, yes: false, ...flags }
+            }),
+            configurable: true
+        });
+        return cmd;
+    };
+    describe('command structure', () => {
+        it('should have correct description', () => {
+            expect(CredentialsSet.description).toContain('credential value');
+        });
+        it('should have required path and value arguments', () => {
+            expect(CredentialsSet.args.path).toBeDefined();
+            expect(CredentialsSet.args.path.required).toBe(true);
+            expect(CredentialsSet.args.value).toBeDefined();
+            expect(CredentialsSet.args.value.required).toBe(true);
+        });
+        it('should have environment, workflow, and yes flags', () => {
+            expect(CredentialsSet.flags.environment).toBeDefined();
+            expect(CredentialsSet.flags.workflow).toBeDefined();
+            expect(CredentialsSet.flags.yes).toBeDefined();
+        });
+    });
+    describe('command execution', () => {
+        it('should decrypt, update, and re-encrypt credentials', async () => {
+            const cmd = createTestCommand();
+            await cmd.run();
+            expect(credentialsService.decryptCredentials).toHaveBeenCalledWith(undefined, undefined);
+            expect(credentialsService.writeEncrypted).toHaveBeenCalledWith(undefined, expect.any(String), undefined);
+            expect(confirm).not.toHaveBeenCalled();
+            expect(cmd.log).toHaveBeenCalledWith('Set anthropic.api_key');
+        });
+        it('should create nested keys that do not exist', async () => {
+            vi.mocked(credentialsService.decryptCredentials).mockReturnValue('');
+            const cmd = createTestCommand({ path: 'new.nested.key', value: 'my-value' });
+            await cmd.run();
+            expect(credentialsService.writeEncrypted).toHaveBeenCalledTimes(1);
+            expect(confirm).not.toHaveBeenCalled();
+            expect(cmd.log).toHaveBeenCalledWith('Set new.nested.key');
+        });
+        it('should pass environment flag to service functions', async () => {
+            const cmd = createTestCommand({}, { environment: 'production' });
+            await cmd.run();
+            expect(credentialsService.credentialsExist).toHaveBeenCalledWith('production', undefined);
+            expect(credentialsService.decryptCredentials).toHaveBeenCalledWith('production', undefined);
+            expect(credentialsService.writeEncrypted).toHaveBeenCalledWith('production', expect.any(String), undefined);
+        });
+        it('should pass workflow flag to service functions', async () => {
+            const cmd = createTestCommand({}, { workflow: 'my_workflow' });
+            await cmd.run();
+            expect(credentialsService.credentialsExist).toHaveBeenCalledWith(undefined, 'my_workflow');
+            expect(credentialsService.decryptCredentials).toHaveBeenCalledWith(undefined, 'my_workflow');
+            expect(credentialsService.writeEncrypted).toHaveBeenCalledWith(undefined, expect.any(String), 'my_workflow');
+        });
+        it('should error when both environment and workflow are specified', async () => {
+            const cmd = createTestCommand({}, { environment: 'production', workflow: 'my_workflow' });
+            await expect(cmd.run()).rejects.toThrow('Cannot specify both');
+        });
+        it('should error when credentials file does not exist', async () => {
+            vi.mocked(credentialsService.credentialsExist).mockReturnValue(false);
+            vi.mocked(credentialsService.resolveCredentialsPath).mockReturnValue('/project/config/credentials.yml.enc');
+            const cmd = createTestCommand();
+            await expect(cmd.run()).rejects.toThrow('No credentials file found');
+        });
+        it('should surface a friendly error when decryption fails', async () => {
+            vi.mocked(credentialsService.decryptCredentials).mockImplementation(() => {
+                throw new Error('Invalid key');
+            });
+            const cmd = createTestCommand();
+            await expect(cmd.run()).rejects.toThrow('Failed to update credentials: Invalid key');
+        });
+        it('should surface a friendly error when encryption fails', async () => {
+            vi.mocked(credentialsService.writeEncrypted).mockImplementation(() => {
+                throw new Error('Permission denied');
+            });
+            const cmd = createTestCommand();
+            await expect(cmd.run()).rejects.toThrow('Failed to update credentials: Permission denied');
+        });
+    });
+    describe('shape-change confirmation', () => {
+        it('should prompt before converting a primitive value into an object', async () => {
+            vi.mocked(credentialsService.decryptCredentials).mockReturnValue('__PRIMITIVE_AT_X_Y__');
+            const cmd = createTestCommand({ path: 'x.y.z', value: 'BAR' });
+            await cmd.run();
+            expect(cmd.warn).toHaveBeenCalledWith(expect.stringContaining('convert "x.y" from a value into an object'));
+            expect(confirm).toHaveBeenCalledTimes(1);
+            expect(credentialsService.writeEncrypted).toHaveBeenCalledTimes(1);
+            expect(cmd.log).toHaveBeenCalledWith('Set x.y.z');
+        });
+        it('should prompt before replacing an object with a primitive value', async () => {
+            vi.mocked(credentialsService.decryptCredentials).mockReturnValue('__OBJECT_AT_X_Y__');
+            const cmd = createTestCommand({ path: 'x.y', value: 'BAR' });
+            await cmd.run();
+            expect(cmd.warn).toHaveBeenCalledWith(expect.stringContaining('replace the existing object'));
+            expect(confirm).toHaveBeenCalledTimes(1);
+            expect(credentialsService.writeEncrypted).toHaveBeenCalledTimes(1);
+        });
+        it('should abort without writing when the user declines the prompt', async () => {
+            vi.mocked(credentialsService.decryptCredentials).mockReturnValue('__PRIMITIVE_AT_X_Y__');
+            vi.mocked(confirm).mockResolvedValue(false);
+            const cmd = createTestCommand({ path: 'x.y.z', value: 'BAR' });
+            await cmd.run();
+            expect(credentialsService.writeEncrypted).not.toHaveBeenCalled();
+            expect(cmd.log).toHaveBeenCalledWith('Aborted.');
+            expect(cmd.log).not.toHaveBeenCalledWith('Set x.y.z');
+        });
+        it('should skip the prompt when --yes is passed', async () => {
+            vi.mocked(credentialsService.decryptCredentials).mockReturnValue('__PRIMITIVE_AT_X_Y__');
+            const cmd = createTestCommand({ path: 'x.y.z', value: 'BAR' }, { yes: true });
+            await cmd.run();
+            expect(confirm).not.toHaveBeenCalled();
+            expect(credentialsService.writeEncrypted).toHaveBeenCalledTimes(1);
+            expect(cmd.log).toHaveBeenCalledWith('Set x.y.z');
+        });
+    });
+});

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/plan.js

@@ -56,7 +56,7 @@ export default class WorkflowPlan extends Command {
         return this.planModificationLoop(modifiedPlanContent);
     }
     async planGenerationLoop(promptDescription, planName, projectRoot) {
-        this.log('\nInvoking the /outputai:plan_workflow command...');
+        this.log('\nInvoking the /output-plan-workflow command...');
         this.log('This may take a moment...\n');
         const planContent = await invokePlanWorkflow(promptDescription);
         const modifiedPlanContent = await this.planModificationLoop(planContent);

package/dist/generated/framework_version.json

@@ -1,3 +1,3 @@
 {
-    "framework": "0.1.13-next.f537949.0"
+    "framework": "0.2.1-next.af8a069.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,13 +13,14 @@ 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);
 }
 export declare function replyToClaude(message: string, { anthropicOpts, applyAdditionalInstructions }?: ReplyToClaudeOptions): Promise<string>;
 /**
- * Invoke claude-code with /outputai:plan_workflow slash command
+ * Invoke claude-code with /output-plan-workflow slash command
  * The SDK loads custom commands from .claude/commands/ when settingSources includes 'project'.
  * ensureOutputAISystem() scaffolds the command files to that location.
  * @param description - Workflow description
@@ -26,7 +28,7 @@ export declare function replyToClaude(message: string, { anthropicOpts, applyAdd
  */
 export declare function invokePlanWorkflow(description: string): Promise<string>;
 /**
- * Invoke claude-code with /outputai:build_workflow slash command
+ * Invoke claude-code with /output-build-workflow slash command
  * The SDK loads custom commands from .claude/commands/ when settingSources includes 'project'.
  * ensureOutputAISystem() scaffolds the command files to that location.
  * @param planFilePath - Absolute path to the plan file
@@ -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.integration.test.js

@@ -15,7 +15,7 @@ describe('invokePlanWorkflow - Integration Tests', () => {
         const messages = [];
         try {
             for await (const message of query({
-                prompt: `/outputai:plan_workflow ${description}`,
+                prompt: `/output-plan-workflow ${description}`,
                 options: { maxTurns: 1 }
             })) {
                 console.log('\nReceived message:', JSON.stringify(message, null, 2));
@@ -31,7 +31,7 @@ describe('invokePlanWorkflow - Integration Tests', () => {
         // This test is just for debugging - we expect messages
         expect(messages.length).toBeGreaterThan(0);
     }, 60000); // 60 second timeout
-    it('should successfully invoke /outputai:plan_workflow slash command and return content', async () => {
+    it('should successfully invoke /output-plan-workflow slash command and return content', async () => {
         const description = 'Simple workflow that takes a number and doubles it';
         const result = await invokePlanWorkflow(description);
         console.log('\n===== PLAN RESULT =====');

package/dist/services/claude_client.js

@@ -38,10 +38,25 @@ 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.
 `
 };
-const PLAN_COMMAND = 'outputai:plan_workflow';
-const BUILD_COMMAND = 'outputai:build_workflow';
+// Slash-command naming convention used by the outputai plugin:
+// `outputai:<kebab-name>` — skills under coding_assistants/.../skills/, which surface as top-level slash commands without the plugin prefix.
+const PLAN_COMMAND = 'outputai:output-plan-workflow';
+const BUILD_COMMAND = 'outputai:output-build-workflow';
+const MIGRATE_COMMAND = 'outputai:output-migrate';
 const GLOBAL_CLAUDE_OPTIONS = {
     settingSources: ['user', 'project', 'local']
 };
@@ -51,6 +66,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 +95,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 {
@@ -193,7 +211,7 @@ export async function replyToClaude(message, { anthropicOpts, applyAdditionalIns
     return singleQuery(applyInstructions(message, applyAdditionalInstructions), { continue: true, ...anthropicOpts });
 }
 /**
- * Invoke claude-code with /outputai:plan_workflow slash command
+ * Invoke claude-code with /output-plan-workflow slash command
  * The SDK loads custom commands from .claude/commands/ when settingSources includes 'project'.
  * ensureOutputAISystem() scaffolds the command files to that location.
  * @param description - Workflow description
@@ -203,7 +221,7 @@ export async function invokePlanWorkflow(description) {
     return singleQuery(applyInstructions(`/${PLAN_COMMAND} ${description}`, ADDITIONAL_INSTRUCTIONS.PLAN), PLAN_COMMAND_OPTIONS);
 }
 /**
- * Invoke claude-code with /outputai:build_workflow slash command
+ * Invoke claude-code with /output-build-workflow slash command
  * The SDK loads custom commands from .claude/commands/ when settingSources includes 'project'.
  * ensureOutputAISystem() scaffolds the command files to that location.
  * @param planFilePath - Absolute path to the plan file
@@ -219,3 +237,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/claude_client.spec.js

@@ -13,7 +13,7 @@ describe('invokePlanWorkflow', () => {
         // Clean up environment variables
         delete process.env.ANTHROPIC_API_KEY;
     });
-    it('should invoke /outputai:plan_workflow slash command with settingSources', async () => {
+    it('should invoke /outputai:output-plan-workflow slash command with settingSources', async () => {
         const { query } = await import('@anthropic-ai/claude-agent-sdk');
         process.env.ANTHROPIC_API_KEY = 'test-key';
         async function* mockIterator() {
@@ -22,7 +22,7 @@ describe('invokePlanWorkflow', () => {
         vi.mocked(query).mockReturnValue(mockIterator());
         await invokePlanWorkflow('Test workflow');
         const calls = vi.mocked(query).mock.calls;
-        expect(calls[0]?.[0]?.prompt).toContain('/outputai:plan_workflow Test workflow');
+        expect(calls[0]?.[0]?.prompt).toContain('/outputai:output-plan-workflow Test workflow');
         expect(calls[0]?.[0]?.options?.settingSources).toEqual(['user', 'project', 'local']);
         expect(calls[0]?.[0]?.options?.allowedTools).toEqual(['Read', 'Grep', 'WebSearch', 'WebFetch', 'TodoWrite']);
     });
@@ -36,7 +36,7 @@ describe('invokePlanWorkflow', () => {
         const description = 'Build a user authentication system';
         await invokePlanWorkflow(description);
         const calls = vi.mocked(query).mock.calls;
-        expect(calls[0]?.[0]?.prompt).toContain(`/outputai:plan_workflow ${description}`);
+        expect(calls[0]?.[0]?.prompt).toContain(`/outputai:output-plan-workflow ${description}`);
         expect(calls[0]?.[0]?.options?.settingSources).toEqual(['user', 'project', 'local']);
     });
     it('should return plan output from claude-code', async () => {

package/dist/services/workflow_builder.d.ts

@@ -1,5 +1,5 @@
 /**
- * Build a workflow from a plan file using the /outputai:build_workflow slash command
+ * Build a workflow from a plan file using the /output-build-workflow slash command
  * @param planFilePath - Absolute path to the plan file
  * @param workflowDir - Absolute path to the workflow directory
  * @param workflowName - Name of the workflow

package/dist/services/workflow_builder.js

@@ -31,7 +31,7 @@ function isEmpty(modification) {
     return modification.trim() === '';
 }
 /**
- * Build a workflow from a plan file using the /outputai:build_workflow slash command
+ * Build a workflow from a plan file using the /output-build-workflow slash command
  * @param planFilePath - Absolute path to the plan file
  * @param workflowDir - Absolute path to the workflow directory
  * @param workflowName - Name of the workflow

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@outputai/cli",
-  "version": "0.1.13-next.f537949.0",
+  "version": "0.2.1-next.af8a069.0",
   "description": "CLI for Output.ai workflow generation",
   "type": "module",
   "main": "dist/index.js",
@@ -35,9 +35,9 @@
     "react": "19.2.5",
     "semver": "7.7.4",
     "yaml": "^2.8.3",
-    "@outputai/credentials": "0.1.13-next.f537949.0",
-    "@outputai/evals": "0.1.13-next.f537949.0",
-    "@outputai/llm": "0.1.13-next.f537949.0"
+    "@outputai/credentials": "0.2.1-next.af8a069.0",
+    "@outputai/evals": "0.2.1-next.af8a069.0",
+    "@outputai/llm": "0.2.1-next.af8a069.0"
   },
   "devDependencies": {
     "@types/cli-progress": "3.11.6",