@hyperdrive.bot/bmad-workflow 1.0.22 → 1.0.24

package/dist/commands/eject.js

@@ -0,0 +1,232 @@
+/**
+ * Eject Command
+ *
+ * Copies bundled assets (agents, templates, config) into a local project directory
+ * for full customization. After eject, the CLI resolves assets from the local path
+ * instead of bundled defaults.
+ *
+ * @example
+ * ```bash
+ * bmad-workflow eject
+ * bmad-workflow eject --target ./my-assets
+ * bmad-workflow eject --agents-only
+ * bmad-workflow eject --templates-only
+ * bmad-workflow eject --force
+ * ```
+ */
+import { Command, Flags } from '@oclif/core';
+import fs from 'fs-extra';
+import { dump as yamlDump, load as yamlLoad } from 'js-yaml';
+import { dirname, join, relative, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { FileManager } from '../services/file-system/file-manager.js';
+import { ValidationError } from '../utils/errors.js';
+import { createLogger } from '../utils/logger.js';
+/**
+ * Resolve the bundled assets directory path.
+ *
+ * From dist/commands/eject.js → ../../assets
+ */
+export function getAssetsDir() {
+    const currentDir = dirname(fileURLToPath(import.meta.url));
+    return resolve(currentDir, '..', '..', 'assets');
+}
+/**
+ * Determine which subdirectories to eject based on flags
+ */
+export function getSubdirs(agentsOnly, templatesOnly) {
+    if (agentsOnly) {
+        return [{ name: 'agents' }];
+    }
+    if (templatesOnly) {
+        return [{ name: 'templates' }];
+    }
+    // Default: all three
+    return [
+        { name: 'agents' },
+        { name: 'templates' },
+        { name: 'config' },
+    ];
+}
+/**
+ * Copy assets from source to target with skip/force logic
+ */
+export async function copyAssets(assetsDir, targetPath, subdirs, force, fileManager) {
+    const summary = {
+        copied: new Map(),
+        skipped: [],
+        targetPath,
+    };
+    for (const subdir of subdirs) {
+        const sourceDir = join(assetsDir, subdir.name);
+        if (!fs.existsSync(sourceDir)) {
+            continue;
+        }
+        const files = fs.readdirSync(sourceDir).filter((f) => !f.startsWith('.'));
+        let copiedCount = 0;
+        for (const file of files) {
+            const sourcePath = join(sourceDir, file);
+            // Special case: config/default-config.yaml → core-config.yaml at target root
+            let destPath;
+            if (subdir.name === 'config' && file === 'default-config.yaml') {
+                destPath = join(targetPath, 'core-config.yaml');
+            }
+            else {
+                const targetSubdir = subdir.targetName || subdir.name;
+                destPath = join(targetPath, targetSubdir, file);
+            }
+            // Check if target exists
+            const exists = await fileManager.fileExists(destPath);
+            if (exists && !force) {
+                const relativePath = relative(process.cwd(), destPath);
+                summary.skipped.push(relativePath);
+                continue;
+            }
+            // Copy file
+            await fileManager.copyFile(sourcePath, destPath);
+            copiedCount++;
+        }
+        const label = subdir.targetName || subdir.name;
+        summary.copied.set(label, (summary.copied.get(label) || 0) + copiedCount);
+    }
+    return summary;
+}
+/**
+ * Create or update .bmad-workflow.yaml with bmad_path
+ */
+export function updateConfig(targetPath, projectRoot) {
+    const root = projectRoot || process.cwd();
+    const configPath = join(root, '.bmad-workflow.yaml');
+    const bmadPath = `./${relative(root, targetPath)}`;
+    let config = {};
+    if (fs.existsSync(configPath)) {
+        try {
+            const content = fs.readFileSync(configPath, 'utf8');
+            const parsed = yamlLoad(content);
+            if (parsed && typeof parsed === 'object') {
+                config = parsed;
+            }
+        }
+        catch {
+            // If existing file is invalid YAML, start fresh
+        }
+    }
+    // Set only bmad_path — preserve all other fields
+    config.bmad_path = bmadPath;
+    const header = '# bmad-workflow configuration\n# Generated by bmad-workflow eject\n\n';
+    const yamlContent = header + yamlDump(config, { lineWidth: -1 });
+    fs.writeFileSync(configPath, yamlContent, 'utf8');
+}
+/**
+ * Format summary output lines
+ */
+export function formatSummary(summary) {
+    const lines = [];
+    const totalCopied = [...summary.copied.values()].reduce((a, b) => a + b, 0);
+    if (totalCopied === 0 && summary.skipped.length > 0) {
+        lines.push('');
+        lines.push('⚠️ All files already exist. Use --force to overwrite.');
+        lines.push('');
+        lines.push('Skipped files:');
+        for (const file of summary.skipped) {
+            lines.push(`  - ${file}`);
+        }
+        return lines;
+    }
+    lines.push('');
+    lines.push(`✅ Ejected assets to ${summary.targetPath}/`);
+    lines.push('');
+    for (const [dir, count] of summary.copied.entries()) {
+        if (count > 0) {
+            if (dir === 'config') {
+                lines.push(`   core-config.yaml (${count} file)`);
+            }
+            else {
+                lines.push(`   ${dir}/ (${count} files)`);
+            }
+        }
+    }
+    if (summary.skipped.length > 0) {
+        lines.push('');
+        lines.push('Skipped (already exist):');
+        for (const file of summary.skipped) {
+            lines.push(`  - ${file}`);
+        }
+    }
+    lines.push('');
+    return lines;
+}
+/**
+ * Eject Command
+ *
+ * Copies bundled assets into a local project directory for customization.
+ */
+export default class EjectCommand extends Command {
+    static description = 'Eject bundled assets into your project for customization';
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %>',
+            description: 'Eject all assets to .bmad-core/',
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> --target ./my-assets',
+            description: 'Eject to custom directory',
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> --agents-only',
+            description: 'Eject only agent files',
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> --force',
+            description: 'Overwrite existing files',
+        },
+    ];
+    static flags = {
+        'agents-only': Flags.boolean({
+            default: false,
+            description: 'Eject only agent files (no templates or config)',
+            exclusive: ['templates-only'],
+        }),
+        force: Flags.boolean({
+            default: false,
+            description: 'Overwrite existing files without prompting',
+        }),
+        target: Flags.string({
+            default: '.bmad-core',
+            description: 'Target directory for ejected assets',
+        }),
+        'templates-only': Flags.boolean({
+            default: false,
+            description: 'Eject only template files (no agents or config)',
+            exclusive: ['agents-only'],
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(EjectCommand);
+        const logger = createLogger({ namespace: 'commands:eject' });
+        const fileManager = new FileManager(logger);
+        // Validate mutual exclusivity (oclif handles this via exclusive, but belt-and-suspenders)
+        if (flags['agents-only'] && flags['templates-only']) {
+            throw new ValidationError('Cannot use --agents-only and --templates-only together', { flags: ['agents-only', 'templates-only'] }, 'Use --agents-only OR --templates-only, not both');
+        }
+        // Resolve paths
+        const assetsDir = getAssetsDir();
+        const targetPath = resolve(process.cwd(), flags.target);
+        logger.info({ assetsDir, force: flags.force, targetPath }, 'Starting eject');
+        // Verify bundled assets exist
+        if (!fs.existsSync(assetsDir)) {
+            this.error('Bundled assets directory not found. Your CLI installation may be corrupted.', { exit: 1 });
+        }
+        // Determine which subdirectories to copy
+        const subdirs = getSubdirs(flags['agents-only'], flags['templates-only']);
+        // Copy files
+        const summary = await copyAssets(assetsDir, targetPath, subdirs, flags.force, fileManager);
+        // Update .bmad-workflow.yaml
+        updateConfig(targetPath);
+        // Print summary
+        const lines = formatSummary(summary);
+        for (const line of lines) {
+            this.log(line);
+        }
+    }
+}

package/dist/commands/init.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Init Command
+ *
+ * Generates .bmad-workflow.yaml config file with agent preferences,
+ * output paths, and personalization settings. Supports both interactive
+ * and non-interactive modes.
+ */
+import { Command } from '@oclif/core';
+export default class Init extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        dev: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        language: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'no-interactive': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        qa: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        sm: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    /**
+     * Build config object from CLI flags (non-interactive mode).
+     */
+    private buildConfigFromFlags;
+    /**
+     * Generate YAML string with comment header.
+     */
+    private generateYaml;
+    /**
+     * Run interactive prompts and collect config values.
+     */
+    private runInteractivePrompts;
+    /**
+     * Prompt user to select an agent for a role.
+     */
+    private promptAgentSelection;
+    /**
+     * Prompt for a custom agent file path and validate it exists.
+     */
+    private promptCustomAgentPath;
+    /**
+     * Validate an agent value — must be a built-in name or an existing file path.
+     */
+    private validateAgentValue;
+}

package/dist/commands/init.js

@@ -0,0 +1,265 @@
+/**
+ * Init Command
+ *
+ * Generates .bmad-workflow.yaml config file with agent preferences,
+ * output paths, and personalization settings. Supports both interactive
+ * and non-interactive modes.
+ */
+import { Command, Flags } from '@oclif/core';
+import { confirm, input, select } from '@inquirer/prompts';
+import { dump as yamlDump } from 'js-yaml';
+import fs from 'fs-extra';
+import { join, resolve } from 'node:path';
+import { AGENT_DESCRIPTIONS, BmadConfigSchema, BUILT_IN_AGENTS, } from '../models/bmad-config-schema.js';
+import { createLogger } from '../utils/logger.js';
+import * as colors from '../utils/colors.js';
+import { ValidationError } from '../utils/errors.js';
+const CONFIG_FILENAME = '.bmad-workflow.yaml';
+const YAML_HEADER = `# bmad-workflow configuration
+# Generated by: bmad-workflow init
+# Docs: https://github.com/AiREPO/bmad-workflow
+#
+# Agent selection — built-in names: pirlo, barry, lena, bob, quinn
+# Or: path to a custom agent .md file (relative to project root)
+`;
+/**
+ * All valid built-in agent names for validation
+ */
+const ALL_VALID_NAMES = new Set([
+    ...BUILT_IN_AGENTS.dev,
+    ...BUILT_IN_AGENTS.sm,
+    ...BUILT_IN_AGENTS.qa,
+]);
+export default class Init extends Command {
+    static description = 'Initialize bmad-workflow configuration';
+    static examples = [
+        '<%= config.bin %> init',
+        '<%= config.bin %> init --dev pirlo --sm lena --qa quinn --no-interactive',
+        '<%= config.bin %> init --dev ./my-agent.md --no-interactive',
+        '<%= config.bin %> init --force',
+    ];
+    static flags = {
+        dev: Flags.string({ description: 'Dev agent (pirlo, barry, or path)', helpGroup: 'Agent Selection' }),
+        force: Flags.boolean({ default: false, description: 'Overwrite existing config' }),
+        language: Flags.string({ default: 'English', description: 'Communication language' }),
+        name: Flags.string({ description: 'Your name' }),
+        'no-interactive': Flags.boolean({ description: 'Skip interactive prompts' }),
+        output: Flags.string({ default: './docs', description: 'Output folder for docs' }),
+        qa: Flags.string({ description: 'QA agent (quinn, none, or path)', helpGroup: 'Agent Selection' }),
+        sm: Flags.string({ description: 'SM agent (lena, bob, or path)', helpGroup: 'Agent Selection' }),
+    };
+    async run() {
+        const { flags } = await this.parse(Init);
+        const logger = createLogger({ namespace: 'commands:init' });
+        const configPath = join(process.cwd(), CONFIG_FILENAME);
+        const isNonInteractive = flags['no-interactive'] === true;
+        logger.info('Starting init command');
+        // --- Overwrite protection (Task 6) ---
+        if (fs.existsSync(configPath)) {
+            if (flags.force) {
+                this.log(colors.warning(`Overwriting existing ${CONFIG_FILENAME}`));
+            }
+            else if (isNonInteractive) {
+                this.error(`${CONFIG_FILENAME} already exists. Use --force to overwrite.`, { exit: 1 });
+            }
+            else {
+                const overwrite = await confirm({
+                    default: false,
+                    message: `${CONFIG_FILENAME} already exists. Overwrite?`,
+                });
+                if (!overwrite) {
+                    this.log('Aborted.');
+                    return;
+                }
+            }
+        }
+        let config;
+        if (isNonInteractive) {
+            // --- Non-interactive mode (Task 4) ---
+            config = this.buildConfigFromFlags(flags);
+        }
+        else {
+            // --- Interactive mode (Task 3) ---
+            config = await this.runInteractivePrompts(flags);
+        }
+        // --- Validate and write (Task 5) ---
+        const parsed = BmadConfigSchema.parse(config);
+        const yamlContent = this.generateYaml(parsed);
+        await fs.ensureDir(join(configPath, '..'));
+        await fs.writeFile(configPath, yamlContent, 'utf8');
+        this.log(colors.success(`Created ${CONFIG_FILENAME}`));
+        logger.info({ configPath }, 'Config file written');
+    }
+    /**
+     * Build config object from CLI flags (non-interactive mode).
+     */
+    buildConfigFromFlags(flags) {
+        const config = {};
+        if (flags.dev) {
+            config.dev_agent = this.validateAgentValue(flags.dev, 'dev');
+        }
+        if (flags.sm) {
+            config.sm_agent = this.validateAgentValue(flags.sm, 'sm');
+        }
+        if (flags.qa) {
+            const qaVal = flags.qa;
+            if (qaVal === 'none') {
+                config.qa_agent = 'quinn';
+                config.qa_enabled = false;
+            }
+            else {
+                config.qa_agent = this.validateAgentValue(qaVal, 'qa');
+            }
+        }
+        if (flags.output)
+            config.output_folder = flags.output;
+        if (flags.language)
+            config.communication_language = flags.language;
+        if (flags.name)
+            config.user_name = flags.name;
+        return config;
+    }
+    /**
+     * Generate YAML string with comment header.
+     */
+    generateYaml(config) {
+        // Build a clean object for YAML output, omitting optional undefined fields
+        const output = {
+            dev_agent: config.dev_agent,
+            sm_agent: config.sm_agent,
+            qa_agent: config.qa_agent,
+            qa_enabled: config.qa_enabled,
+            output_folder: config.output_folder,
+            story_location: config.story_location,
+            epic_location: config.epic_location,
+            qa_location: config.qa_location,
+            communication_language: config.communication_language,
+            document_output_language: config.document_output_language,
+            user_name: config.user_name,
+            parallel: config.parallel,
+            timeout: config.timeout,
+            provider: config.provider,
+        };
+        if (config.model)
+            output.model = config.model;
+        const yamlStr = yamlDump(output, { lineWidth: -1, quotingType: "'", forceQuotes: false });
+        // Add commented-out bmad_path if not set
+        let bmadPathLine = '';
+        if (!config.bmad_path) {
+            bmadPathLine = '\n# Optional: path to local BMAD assets (overrides bundled defaults)\n# bmad_path: ./_bmad-core\n';
+        }
+        return YAML_HEADER + '\n' + yamlStr + bmadPathLine;
+    }
+    /**
+     * Run interactive prompts and collect config values.
+     */
+    async runInteractivePrompts(flags) {
+        const config = {};
+        // Dev agent selection
+        config.dev_agent = flags.dev
+            ? this.validateAgentValue(flags.dev, 'dev')
+            : await this.promptAgentSelection('dev', BUILT_IN_AGENTS.dev, 'pirlo');
+        // SM agent selection
+        config.sm_agent = flags.sm
+            ? this.validateAgentValue(flags.sm, 'sm')
+            : await this.promptAgentSelection('sm', BUILT_IN_AGENTS.sm, 'lena');
+        // QA agent selection
+        if (flags.qa) {
+            const qaVal = flags.qa;
+            if (qaVal === 'none') {
+                config.qa_agent = 'quinn';
+                config.qa_enabled = false;
+            }
+            else {
+                config.qa_agent = this.validateAgentValue(qaVal, 'qa');
+            }
+        }
+        else {
+            const qaResult = await this.promptAgentSelection('qa', BUILT_IN_AGENTS.qa, 'quinn', true);
+            if (qaResult === '__none__') {
+                config.qa_enabled = false;
+            }
+            else {
+                config.qa_agent = qaResult;
+            }
+        }
+        // Output folder
+        config.output_folder = flags.output || await input({
+            default: './docs',
+            message: 'Output folder for docs:',
+        });
+        // BMAD assets path
+        const bmadPath = await input({
+            default: '',
+            message: 'Custom BMAD assets path (leave empty for none):',
+        });
+        if (bmadPath)
+            config.bmad_path = bmadPath;
+        // Communication language
+        config.communication_language = flags.language || await input({
+            default: 'English',
+            message: 'Communication language:',
+        });
+        // User name
+        config.user_name = flags.name ?? await input({
+            default: '',
+            message: 'Your name:',
+        });
+        return config;
+    }
+    /**
+     * Prompt user to select an agent for a role.
+     */
+    async promptAgentSelection(role, builtIns, defaultValue, includeNone = false) {
+        const choices = builtIns.map((name) => ({
+            description: AGENT_DESCRIPTIONS[name] || '',
+            name: `${name} — ${AGENT_DESCRIPTIONS[name] || ''}`,
+            value: name,
+        }));
+        if (includeNone) {
+            choices.push({ description: 'Skip this phase', name: 'none — Skip this phase', value: '__none__' });
+        }
+        choices.push({ description: 'Path to custom agent file', name: 'custom — Path to custom agent file', value: '__custom__' });
+        const selected = await select({
+            choices,
+            default: defaultValue,
+            message: `${role.toUpperCase()} agent:`,
+        });
+        if (selected === '__custom__') {
+            return this.promptCustomAgentPath();
+        }
+        return selected;
+    }
+    /**
+     * Prompt for a custom agent file path and validate it exists.
+     */
+    async promptCustomAgentPath() {
+        const customPath = await input({
+            message: 'Path to custom agent file (relative to project root):',
+        });
+        const resolved = resolve(customPath);
+        if (!fs.existsSync(resolved)) {
+            throw new ValidationError(`Agent file not found: ${customPath}`, { code: 'ERR_VALIDATION', path: customPath }, 'Provide a valid path to an existing .md file relative to the project root.');
+        }
+        return customPath;
+    }
+    /**
+     * Validate an agent value — must be a built-in name or an existing file path.
+     */
+    validateAgentValue(value, role) {
+        // Check built-in names
+        if (ALL_VALID_NAMES.has(value))
+            return value;
+        // Check file path
+        if (value.includes('/') || value.endsWith('.md')) {
+            const resolved = resolve(value);
+            if (fs.existsSync(resolved))
+                return value;
+            throw new ValidationError(`Agent file not found: ${value}`, { code: 'ERR_VALIDATION', path: value, role }, 'Provide a valid path to an existing .md file relative to the project root.');
+        }
+        // Invalid name
+        const roleAgents = BUILT_IN_AGENTS[role];
+        const validNames = roleAgents ? [...roleAgents] : [...ALL_VALID_NAMES];
+        throw new ValidationError(`Unknown agent "${value}". Valid names: ${validNames.join(', ')}`, { code: 'ERR_VALIDATION', role, value }, 'Use a built-in name or provide a path to a custom .md file.');
+    }
+}

package/dist/commands/stories/develop.js

@@ -308,6 +308,7 @@ export default class StoriesDevelopCommand extends Command {
             this.logger.info({ storyNumber }, 'Running Claude dev agent');
             const result = await runAgentWithRetry(this.agentRunner, prompt, {
                 agentType: 'dev',
+                cwd,
                 timeout: timeout ?? 2_700_000,
             }, {
                 backoffMs: retryBackoff,

package/dist/commands/stories/qa.d.ts

@@ -29,6 +29,7 @@ export default class StoriesQaCommand extends Command {
         description: string;
     }[];
     static flags: {
+        cwd: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'dev-prompt': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         interval: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         'max-retries': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/stories/qa.js

@@ -57,6 +57,10 @@ export default class StoriesQaCommand extends Command {
         },
     ];
     static flags = {
+        cwd: Flags.string({
+            description: 'Working directory path to pass to AI agents. Agents will operate in this directory.',
+            helpGroup: 'Agent Customization',
+        }),
         'dev-prompt': Flags.string({
             description: 'Custom prompt/instructions for dev fix-forward phase',
             helpGroup: 'Prompt Customization',
@@ -422,6 +426,7 @@ ${result.finalGate === 'PASS' ? '3. [x] Final QA Validation - PASSED' : result.f
             const qaPrompt = this.buildQaPrompt(storyPath, flags['qa-prompt'], flags.reference);
             const qaResult = await runAgentWithRetry(this.agentRunner, qaPrompt, {
                 agentType: 'tea',
+                cwd: flags.cwd,
                 timeout: agentTimeout,
             }, {
                 backoffMs: retryBackoff,
@@ -444,6 +449,7 @@ ${result.finalGate === 'PASS' ? '3. [x] Final QA Validation - PASSED' : result.f
                 // eslint-disable-next-line no-await-in-loop
                 const devResult = await runAgentWithRetry(this.agentRunner, devPrompt, {
                     agentType: 'dev',
+                    cwd: flags.cwd,
                     timeout: agentTimeout,
                 }, {
                     backoffMs: retryBackoff,
@@ -459,6 +465,7 @@ ${result.finalGate === 'PASS' ? '3. [x] Final QA Validation - PASSED' : result.f
                 // eslint-disable-next-line no-await-in-loop
                 const reQaResult = await runAgentWithRetry(this.agentRunner, qaPrompt, {
                     agentType: 'tea',
+                    cwd: flags.cwd,
                     timeout: agentTimeout,
                 }, {
                     backoffMs: retryBackoff,

package/dist/commands/workflow.d.ts

@@ -26,17 +26,20 @@ export default class Workflow extends Command {
     static flags: {
         'auto-fix': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         cwd: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        worktree: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'gut-entities': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'worktree-install': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'dev-agent': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'sm-agent': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'epic-interval': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
-        parallel: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        parallel: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
         pipeline: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'prd-interval': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         model: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         prefix: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         'session-prefix': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        provider: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        provider: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         mcp: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'mcp-phases': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'mcp-preset': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
@@ -52,7 +55,7 @@ export default class Workflow extends Command {
         'skip-epics': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'skip-stories': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'story-interval': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
-        timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        timeout: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'review-timeout': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'max-retries': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         'retry-backoff': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;