@outputai/cli 0.1.13-next.f537949.0 → 0.2.1-dev.82acd68.0

package/dist/config.js

@@ -1,47 +1,39 @@
-/**
- * CLI configuration
- */
+import { parsePort } from '#utils/validation.js';
+const DEFAULT_API_PORT = 3001;
+const DEFAULT_TEMPORAL_UI_PORT = 8080;
 export const config = {
-    /**
-     * Base URL for the Output.ai API server
-     * Can be overridden with OUTPUT_API_URL environment variable
-     */
-    apiUrl: process.env.OUTPUT_API_URL || 'http://localhost:3001',
-    /**
-     * API authentication token
-     * Set via OUTPUT_API_AUTH_TOKEN environment variable
-     */
-    apiToken: process.env.OUTPUT_API_AUTH_TOKEN,
-    /**
-     * Default timeout for API requests (in milliseconds)
-     */
+    get apiUrl() {
+        return process.env.OUTPUT_API_URL || `http://localhost:${this.ports.api}`;
+    },
+    get ports() {
+        return {
+            temporalUi: parsePort(process.env.OUTPUT_TEMPORAL_UI_HOST_PORT, DEFAULT_TEMPORAL_UI_PORT, 'OUTPUT_TEMPORAL_UI_HOST_PORT'),
+            api: parsePort(process.env.OUTPUT_API_HOST_PORT, DEFAULT_API_PORT, 'OUTPUT_API_HOST_PORT')
+        };
+    },
+    get temporalUiUrl() {
+        return `http://localhost:${this.ports.temporalUi}`;
+    },
+    get apiToken() {
+        return process.env.OUTPUT_API_AUTH_TOKEN;
+    },
     requestTimeout: 30000,
-    /**
-     * Docker Compose project name
-     * Can be overridden with DOCKER_SERVICE_NAME environment variable
-     */
-    dockerServiceName: process.env.DOCKER_SERVICE_NAME || 'output-sdk',
-    /**
-     * Set the debug mode
-     */
-    debugMode: process.env.OUTPUT_DEBUG === 'true',
-    /**
-     * Where the env vars are stored, defaults to `.env`
-     */
-    envFile: process.env.OUTPUT_CLI_ENV || '.env',
-    /**
-     * Agent configuration directory name
-     */
+    get dockerServiceName() {
+        return process.env.DOCKER_SERVICE_NAME || 'output-sdk';
+    },
+    get debugMode() {
+        return process.env.OUTPUT_DEBUG === 'true';
+    },
+    get envFile() {
+        return process.env.OUTPUT_CLI_ENV || '.env';
+    },
     agentConfigDir: '.outputai',
-    /**
-     * S3 configuration for remote trace storage
-     * Set via OUTPUT_TRACE_REMOTE_S3_BUCKET, OUTPUT_AWS_REGION,
-     * OUTPUT_AWS_ACCESS_KEY_ID, and OUTPUT_AWS_SECRET_ACCESS_KEY environment variables
-     */
-    s3: {
-        bucket: process.env.OUTPUT_TRACE_REMOTE_S3_BUCKET,
-        region: process.env.OUTPUT_AWS_REGION,
-        accessKeyId: process.env.OUTPUT_AWS_ACCESS_KEY_ID,
-        secretAccessKey: process.env.OUTPUT_AWS_SECRET_ACCESS_KEY
+    get s3() {
+        return {
+            bucket: process.env.OUTPUT_TRACE_REMOTE_S3_BUCKET,
+            region: process.env.OUTPUT_AWS_REGION,
+            accessKeyId: process.env.OUTPUT_AWS_ACCESS_KEY_ID,
+            secretAccessKey: process.env.OUTPUT_AWS_SECRET_ACCESS_KEY
+        };
     }
 };

package/dist/config.spec.d.ts

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

package/dist/config.spec.js

@@ -0,0 +1,129 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { config } from '#config.js';
+import { InvalidPortError } from '#utils/validation.js';
+describe('config', () => {
+    const envVars = [
+        'OUTPUT_API_URL',
+        'OUTPUT_API_HOST_PORT',
+        'OUTPUT_TEMPORAL_UI_HOST_PORT',
+        'OUTPUT_API_AUTH_TOKEN',
+        'DOCKER_SERVICE_NAME',
+        'OUTPUT_DEBUG',
+        'OUTPUT_CLI_ENV',
+        'OUTPUT_TRACE_REMOTE_S3_BUCKET',
+        'OUTPUT_AWS_REGION',
+        'OUTPUT_AWS_ACCESS_KEY_ID',
+        'OUTPUT_AWS_SECRET_ACCESS_KEY'
+    ];
+    const saved = {};
+    beforeEach(() => {
+        for (const key of envVars) {
+            saved[key] = process.env[key];
+        }
+    });
+    afterEach(() => {
+        for (const key of envVars) {
+            if (saved[key] === undefined) {
+                delete process.env[key];
+            }
+            else {
+                process.env[key] = saved[key];
+            }
+        }
+    });
+    it('reads env vars lazily, not at module evaluation time', () => {
+        process.env.OUTPUT_API_URL = 'https://lazy-test.example.com';
+        expect(config.apiUrl).toBe('https://lazy-test.example.com');
+        process.env.OUTPUT_API_URL = 'https://changed.example.com';
+        expect(config.apiUrl).toBe('https://changed.example.com');
+    });
+    it('falls back to defaults when env vars are unset', () => {
+        delete process.env.OUTPUT_API_URL;
+        delete process.env.OUTPUT_API_HOST_PORT;
+        delete process.env.OUTPUT_TEMPORAL_UI_HOST_PORT;
+        delete process.env.DOCKER_SERVICE_NAME;
+        delete process.env.OUTPUT_DEBUG;
+        delete process.env.OUTPUT_CLI_ENV;
+        expect(config.apiUrl).toBe('http://localhost:3001');
+        expect(config.ports).toEqual({ temporalUi: 8080, api: 3001 });
+        expect(config.temporalUiUrl).toBe('http://localhost:8080');
+        expect(config.dockerServiceName).toBe('output-sdk');
+        expect(config.debugMode).toBe(false);
+        expect(config.envFile).toBe('.env');
+    });
+    it('derives apiUrl from OUTPUT_API_HOST_PORT when OUTPUT_API_URL is unset', () => {
+        delete process.env.OUTPUT_API_URL;
+        process.env.OUTPUT_API_HOST_PORT = '3002';
+        expect(config.apiUrl).toBe('http://localhost:3002');
+    });
+    it('OUTPUT_API_URL takes precedence over OUTPUT_API_HOST_PORT', () => {
+        process.env.OUTPUT_API_URL = 'https://api.example.com';
+        process.env.OUTPUT_API_HOST_PORT = '3002';
+        expect(config.apiUrl).toBe('https://api.example.com');
+    });
+    it('empty-string OUTPUT_API_URL falls through to OUTPUT_API_HOST_PORT (|| not ??)', () => {
+        process.env.OUTPUT_API_URL = '';
+        process.env.OUTPUT_API_HOST_PORT = '3002';
+        expect(config.apiUrl).toBe('http://localhost:3002');
+    });
+    it('reads port overrides from env vars', () => {
+        process.env.OUTPUT_TEMPORAL_UI_HOST_PORT = '8081';
+        process.env.OUTPUT_API_HOST_PORT = '3002';
+        expect(config.ports).toEqual({ temporalUi: 8081, api: 3002 });
+        expect(config.temporalUiUrl).toBe('http://localhost:8081');
+    });
+    it('treats empty-string port env vars as unset (matches Compose semantics)', () => {
+        delete process.env.OUTPUT_API_URL;
+        process.env.OUTPUT_API_HOST_PORT = '';
+        process.env.OUTPUT_TEMPORAL_UI_HOST_PORT = '';
+        expect(config.apiUrl).toBe('http://localhost:3001');
+        expect(config.ports).toEqual({ temporalUi: 8080, api: 3001 });
+        expect(config.temporalUiUrl).toBe('http://localhost:8080');
+    });
+    it('throws InvalidPortError on non-numeric port values', () => {
+        delete process.env.OUTPUT_API_URL;
+        process.env.OUTPUT_API_HOST_PORT = 'abc';
+        expect(() => config.ports).toThrow(InvalidPortError);
+        expect(() => config.apiUrl).toThrow(InvalidPortError);
+    });
+    it('throws InvalidPortError on out-of-range port values', () => {
+        process.env.OUTPUT_API_HOST_PORT = '99999';
+        expect(() => config.ports).toThrow(InvalidPortError);
+    });
+    it('throws InvalidPortError on trailing-junk port values', () => {
+        process.env.OUTPUT_TEMPORAL_UI_HOST_PORT = '8080abc';
+        expect(() => config.ports).toThrow(InvalidPortError);
+    });
+    it('throws InvalidPortError on port 0 (Compose treats 0 as ephemeral - prevents CLI/Docker desync)', () => {
+        process.env.OUTPUT_API_HOST_PORT = '0';
+        expect(() => config.ports).toThrow(InvalidPortError);
+    });
+    it('reads apiToken from env', () => {
+        process.env.OUTPUT_API_AUTH_TOKEN = 'test-token-123';
+        expect(config.apiToken).toBe('test-token-123');
+        delete process.env.OUTPUT_API_AUTH_TOKEN;
+        expect(config.apiToken).toBeUndefined();
+    });
+    it('reads debugMode as boolean', () => {
+        process.env.OUTPUT_DEBUG = 'true';
+        expect(config.debugMode).toBe(true);
+        process.env.OUTPUT_DEBUG = 'false';
+        expect(config.debugMode).toBe(false);
+    });
+    it('reads s3 config lazily', () => {
+        process.env.OUTPUT_TRACE_REMOTE_S3_BUCKET = 'my-bucket';
+        process.env.OUTPUT_AWS_REGION = 'us-west-2';
+        process.env.OUTPUT_AWS_ACCESS_KEY_ID = 'AKIA123';
+        process.env.OUTPUT_AWS_SECRET_ACCESS_KEY = 'secret123';
+        expect(config.s3).toEqual({
+            bucket: 'my-bucket',
+            region: 'us-west-2',
+            accessKeyId: 'AKIA123',
+            secretAccessKey: 'secret123'
+        });
+    });
+    it('has static properties that are not env-derived', () => {
+        expect(config.requestTimeout).toBe(30000);
+        expect(config.agentConfigDir).toBe('.outputai');
+    });
+});

package/dist/generated/framework_version.json

@@ -1,3 +1,3 @@
 {
-    "framework": "0.1.13-next.f537949.0"
+    "framework": "0.2.1-dev.82acd68.0"
 }

package/dist/hooks/init.d.ts

@@ -1,3 +1,7 @@
 import { Hook } from '@oclif/core';
+export declare const INTERACTIVE_FLAGS: string[];
+export declare const GLOBAL_FLAGS: Set<string>;
+export declare const hasInteractiveFlag: (argv: string[]) => boolean;
+export declare const stripGlobalFlags: (argv: string[]) => void;
 declare const hook: Hook<'init'>;
 export default hook;

package/dist/hooks/init.js

@@ -1,6 +1,22 @@
 import { ux } from '@oclif/core';
 import { checkForUpdate } from '#services/version_check.js';
-const hook = async function () {
+import { setNonInteractive } from '#utils/interactive.js';
+export const INTERACTIVE_FLAGS = ['--yes', '--non-interactive'];
+export const GLOBAL_FLAGS = new Set(INTERACTIVE_FLAGS);
+export const hasInteractiveFlag = (argv) => argv.some(arg => INTERACTIVE_FLAGS.includes(arg));
+export const stripGlobalFlags = (argv) => {
+    const kept = argv.filter(arg => !GLOBAL_FLAGS.has(arg));
+    if (kept.length !== argv.length) {
+        argv.splice(0, argv.length, ...kept);
+    }
+};
+const hook = async function (opts) {
+    const interactive = hasInteractiveFlag(opts.argv) || hasInteractiveFlag(process.argv);
+    stripGlobalFlags(opts.argv);
+    stripGlobalFlags(process.argv);
+    if (interactive) {
+        setNonInteractive(true);
+    }
     try {
         const result = await checkForUpdate(this.config.version, this.config.cacheDir);
         if (!result.updateAvailable) {

package/dist/hooks/init.spec.js

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

package/dist/services/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/coding_agents.js

@@ -7,7 +7,8 @@ import { access } from 'node:fs/promises';
 import path from 'node:path';
 import { join } from 'node:path';
 import { ux } from '@oclif/core';
-import { confirm } from '@inquirer/prompts';
+import { confirm } from '#utils/prompt.js';
+import { isInteractive } from '#utils/interactive.js';
 import debugFactory from 'debug';
 import { getTemplateDir } from '#utils/paths.js';
 import { executeClaudeCommand } from '#utils/claude.js';
@@ -142,6 +143,9 @@ async function handlePluginError(error, commandName, silent = false) {
         debug('Plugin error: %s', pluginError.message);
         throw error;
     }
+    if (!isInteractive()) {
+        throw pluginError;
+    }
     ux.warn(pluginError.message);
     try {
         const shouldProceed = await confirm({

package/dist/services/coding_agents.spec.js

@@ -19,9 +19,12 @@ vi.mock('@oclif/core', () => ({
         colorize: vi.fn().mockImplementation((_color, text) => text)
     }
 }));
-vi.mock('@inquirer/prompts', () => ({
+vi.mock('#utils/prompt.js', () => ({
     confirm: vi.fn()
 }));
+vi.mock('#utils/interactive.js', () => ({
+    isInteractive: vi.fn(() => true)
+}));
 describe('coding_agents service', () => {
     beforeEach(() => {
         vi.clearAllMocks();
@@ -157,7 +160,7 @@ describe('coding_agents service', () => {
         });
         it('should show error and prompt user when plugin commands fail', async () => {
             const { executeClaudeCommand } = await import('../utils/claude.js');
-            const { confirm } = await import('@inquirer/prompts');
+            const { confirm } = await import('#utils/prompt.js');
             vi.mocked(executeClaudeCommand)
                 .mockResolvedValueOnce(undefined) // marketplace add
                 .mockRejectedValueOnce(new Error('Plugin update failed')); // marketplace update
@@ -169,7 +172,7 @@ describe('coding_agents service', () => {
         });
         it('should allow user to proceed without plugin setup if they confirm', async () => {
             const { executeClaudeCommand } = await import('../utils/claude.js');
-            const { confirm } = await import('@inquirer/prompts');
+            const { confirm } = await import('#utils/prompt.js');
             vi.mocked(executeClaudeCommand)
                 .mockRejectedValue(new Error('All plugin commands fail'));
             vi.mocked(confirm).mockResolvedValue(true);
@@ -219,7 +222,7 @@ describe('coding_agents service', () => {
         });
         it('should show error and prompt user when registerPluginMarketplace fails', async () => {
             const { executeClaudeCommand } = await import('../utils/claude.js');
-            const { confirm } = await import('@inquirer/prompts');
+            const { confirm } = await import('#utils/prompt.js');
             vi.mocked(executeClaudeCommand)
                 .mockResolvedValueOnce(undefined) // marketplace add
                 .mockRejectedValueOnce(new Error('Plugin update failed')); // marketplace update
@@ -231,7 +234,7 @@ describe('coding_agents service', () => {
         });
         it('should show error and prompt user when installOutputAIPlugin fails', async () => {
             const { executeClaudeCommand } = await import('../utils/claude.js');
-            const { confirm } = await import('@inquirer/prompts');
+            const { confirm } = await import('#utils/prompt.js');
             vi.mocked(executeClaudeCommand)
                 .mockResolvedValueOnce(undefined) // marketplace add
                 .mockResolvedValueOnce(undefined) // marketplace update
@@ -244,7 +247,7 @@ describe('coding_agents service', () => {
         });
         it('should allow user to proceed without plugin setup if they confirm', async () => {
             const { executeClaudeCommand } = await import('../utils/claude.js');
-            const { confirm } = await import('@inquirer/prompts');
+            const { confirm } = await import('#utils/prompt.js');
             vi.mocked(executeClaudeCommand)
                 .mockRejectedValue(new Error('All plugin commands fail'));
             vi.mocked(confirm).mockResolvedValue(true);
@@ -252,5 +255,15 @@ describe('coding_agents service', () => {
             // File operations should still complete
             expect(fs.mkdir).toHaveBeenCalled();
         });
+        it('should rethrow plugin error in non-interactive mode without prompting', async () => {
+            const { executeClaudeCommand } = await import('../utils/claude.js');
+            const { confirm } = await import('#utils/prompt.js');
+            const { isInteractive } = await import('#utils/interactive.js');
+            vi.mocked(isInteractive).mockReturnValueOnce(false);
+            vi.mocked(executeClaudeCommand)
+                .mockRejectedValueOnce(new Error('Plugin marketplace add failed'));
+            await expect(initializeAgentConfig({ projectRoot: '/test/project', force: true })).rejects.toThrow(/plugin marketplace add/i);
+            expect(confirm).not.toHaveBeenCalled();
+        });
     });
 });

package/dist/services/credentials_configurator.js

@@ -1,4 +1,4 @@
-import { password, confirm } from '@inquirer/prompts';
+import { password, confirm } from '#utils/prompt.js';
 import fs from 'node:fs';
 import path from 'node:path';
 import { ux } from '@oclif/core';