@bloomreach/brxm-upgrade 0.1.1

package/dist/commands/discover.js

@@ -0,0 +1,147 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { DiscoveryOrchestrator } from '../discovery/index.js';
+import { createLogger } from '../utils/logger.js';
+import { createSpinner } from '../utils/spinner.js';
+import { writeTextFile, getOutputDir, joinPaths } from '../utils/fs.js';
+import { getParentConfig } from '../utils/command-helpers.js';
+/**
+ * Format a validation issue for display.
+ */
+function formatIssue(issue) {
+    const icons = {
+        error: 'x',
+        warning: '!',
+        info: 'i',
+    };
+    const colors = {
+        error: chalk.red,
+        warning: chalk.yellow,
+        info: chalk.blue,
+    };
+    const icon = icons[issue.severity];
+    const color = colors[issue.severity];
+    const file = issue.file ? chalk.gray(` (${issue.file})`) : '';
+    return `${icon} ${color(issue.message)}${file}`;
+}
+/**
+ * Display discovery results in a formatted way.
+ */
+/* eslint-disable no-console */
+function displayResults(context) {
+    console.log('\n' + chalk.bold('Discovery Summary'));
+    console.log('-'.repeat(50));
+    // Version info
+    console.log(`\n${chalk.cyan('brXM Version:')} ${context.build.brxmVersion}`);
+    console.log(`${chalk.cyan('Parent POM:')} ${context.build.parentGroupId}:${context.build.parentArtifactId}`);
+    // Modules
+    console.log(`\n${chalk.cyan('Maven Modules:')} ${context.build.moduleCount}`);
+    for (const module of context.build.modules.slice(0, 5)) {
+        console.log(`  - ${module.name} (${module.packaging})`);
+    }
+    if (context.build.modules.length > 5) {
+        console.log(chalk.gray(`  ... and ${context.build.modules.length - 5} more`));
+    }
+    // Code stats
+    console.log(`\n${chalk.cyan('Custom Code:')} ${context.build.totalJavaFiles} Java files`);
+    // Repository info
+    if (context.repo.groovyScripts.length > 0) {
+        console.log(`${chalk.cyan('Groovy Scripts:')} ${context.repo.groovyScripts.length}`);
+    }
+    if (context.repo.hasBootstrap) {
+        console.log(`${chalk.cyan('Bootstrap:')} ${context.repo.bootstrapPaths.length} HCM files`);
+    }
+    // Config artifacts
+    if (context.config.cvReports.length > 0) {
+        console.log(`${chalk.cyan('CV Reports:')} ${context.config.cvReports.length}`);
+    }
+    // Validation issues
+    if (context.validations.length > 0) {
+        console.log('\n' + chalk.bold('Validation Results'));
+        console.log('-'.repeat(50));
+        const errors = context.validations.filter((v) => v.severity === 'error');
+        const warnings = context.validations.filter((v) => v.severity === 'warning');
+        const infos = context.validations.filter((v) => v.severity === 'info');
+        if (errors.length > 0) {
+            console.log(`\n${chalk.red.bold('Errors')} (${errors.length}):`);
+            errors.forEach((e) => console.log('  ' + formatIssue(e)));
+        }
+        if (warnings.length > 0) {
+            console.log(`\n${chalk.yellow.bold('Warnings')} (${warnings.length}):`);
+            warnings.forEach((w) => console.log('  ' + formatIssue(w)));
+        }
+        if (infos.length > 0) {
+            console.log(`\n${chalk.blue.bold('Info')} (${infos.length}):`);
+            infos.forEach((i) => console.log('  ' + formatIssue(i)));
+        }
+    }
+    // Upgrade readiness
+    console.log('\n' + '-'.repeat(50));
+    if (context.isUpgradeReady) {
+        console.log(chalk.green.bold('Project is ready for upgrade'));
+    }
+    else {
+        console.log(chalk.red.bold('Project has blocking issues - resolve before upgrading'));
+    }
+}
+/* eslint-enable no-console */
+/**
+ * Create the discover command.
+ */
+export function createDiscoverCommand() {
+    const command = new Command('discover')
+        .description('Analyze project structure and detect brXM version')
+        .option('-o, --output <path>', 'Output directory for discovery report')
+        .option('--skip-validation', 'Skip validation checks')
+        .option('--json', 'Output raw JSON instead of formatted display')
+        .action(async (options) => {
+        const config = getParentConfig(command);
+        const logger = createLogger({
+            verbose: config?.output?.verbose ?? false,
+            color: config?.output?.color ?? true,
+        });
+        const projectRoot = process.cwd();
+        const outputDir = options.output ?? getOutputDir();
+        const spinner = createSpinner({ text: 'Analyzing project...' });
+        try {
+            spinner.start();
+            const orchestrator = new DiscoveryOrchestrator();
+            const result = await orchestrator.discover(projectRoot, {
+                skipValidation: options.skipValidation,
+                verbose: config?.output?.verbose,
+            });
+            spinner.stop();
+            if (!result.success || !result.context) {
+                logger.error(`Discovery failed: ${result.error}`);
+                process.exit(1);
+            }
+            if (result.warnings && result.warnings.length > 0) {
+                for (const warning of result.warnings) {
+                    logger.warn(warning);
+                }
+            }
+            if (options.json) {
+                // eslint-disable-next-line no-console
+                console.log(JSON.stringify(result.context, null, 2));
+            }
+            else {
+                displayResults(result.context);
+            }
+            const outputPath = joinPaths(outputDir, 'discovery.json');
+            await writeTextFile(outputPath, JSON.stringify(result.context, null, 2));
+            if (!options.json) {
+                // eslint-disable-next-line no-console
+                console.log(`\n${chalk.green('Saved:')} ${chalk.cyan(outputPath)}`);
+                // eslint-disable-next-line no-console
+                console.log(`\n${chalk.gray('Next step:')} Run ${chalk.cyan('brxm-upgrade plan --to <version>')} to generate an upgrade plan.`);
+            }
+        }
+        catch (error) {
+            spinner.fail('Discovery failed');
+            logger.error(error instanceof Error ? error.message : 'Unknown error');
+            process.exit(1);
+        }
+    });
+    return command;
+}
+//# sourceMappingURL=discover.js.map

package/dist/commands/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../../src/commands/discover.ts"],"names":[],"mappings":"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"}

package/dist/commands/execute.d.ts

@@ -0,0 +1,12 @@
+import { Command } from 'commander';
+/**
+ * Create the execute command for running the upgrade plan step by step.
+ *
+ * The execute command loads a previously generated plan, initializes the
+ * AI provider (if available), and orchestrates the StepExecutor to
+ * process each upgrade step interactively or in batch mode.
+ *
+ * @returns Configured Commander command instance
+ */
+export declare function createExecuteCommand(): Command;
+//# sourceMappingURL=execute.d.ts.map

package/dist/commands/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/commands/execute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAmH9C"}

package/dist/commands/execute.js

@@ -0,0 +1,113 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { createSpinner } from '../utils/spinner.js';
+import { createLogger } from '../utils/logger.js';
+import { resolvePath } from '../utils/fs.js';
+import { getApiKey } from '../config/index.js';
+import { createAIClient } from '../ai/index.js';
+import { StepExecutor } from '../execution/step-executor.js';
+import { getCommandConfig } from '../utils/command-helpers.js';
+/* eslint-disable no-console */
+/**
+ * Create the execute command for running the upgrade plan step by step.
+ *
+ * The execute command loads a previously generated plan, initializes the
+ * AI provider (if available), and orchestrates the StepExecutor to
+ * process each upgrade step interactively or in batch mode.
+ *
+ * @returns Configured Commander command instance
+ */
+export function createExecuteCommand() {
+    const command = new Command('execute')
+        .description('Execute the upgrade plan step by step')
+        .option('--plan <path>', 'Path to plan.json', '.brxm-upgrade/plan.json')
+        .option('--dry-run', 'Show what would be changed without applying', false)
+        .option('--resume <step>', 'Resume from a specific step number', parseInt)
+        .option('--non-interactive', 'Run without prompts (auto-skip non-automated steps)', false)
+        .option('--auto-accept', 'Auto-accept all automated steps', false)
+        .option('--skip-ai', 'Skip AI analysis for partial steps', false)
+        .option('-v, --verbose', 'Enable verbose output', false)
+        .action(async (options) => {
+        const logger = createLogger({ verbose: options.verbose });
+        const spinner = createSpinner();
+        try {
+            // Load configuration
+            spinner.start('Loading configuration...');
+            const config = await getCommandConfig(command);
+            spinner.succeed('Configuration loaded');
+            spinner.start('Initializing AI provider...');
+            const apiKey = getApiKey(config.ai.provider, config.ai.apiKeyEnv);
+            if (!apiKey) {
+                spinner.warn(`No API key found for ${config.ai.provider}. AI features disabled.`);
+            }
+            const aiClient = apiKey
+                ? createAIClient(config.ai.provider, config.ai.model, apiKey, config.ai.baseUrl)
+                : createAIClient(config.ai.provider, config.ai.model, '', config.ai.baseUrl);
+            spinner.succeed(`AI provider: ${config.ai.provider}`);
+            const projectRoot = process.cwd();
+            const executor = new StepExecutor(projectRoot, aiClient);
+            const executeOptions = {
+                planPath: resolvePath(options.plan),
+                dryRun: options.dryRun,
+                resumeFromStep: options.resume,
+                nonInteractive: options.nonInteractive,
+                autoAcceptAutomated: options.autoAccept,
+                skipAI: options.skipAi,
+                verbose: options.verbose,
+            };
+            // Progress callback
+            const onProgress = (progress) => {
+                if (options.verbose) {
+                    logger.debug(`Step ${progress.currentStep}/${progress.totalSteps}: ${progress.phase} - ${progress.currentDescription}`);
+                }
+            };
+            // Show execution mode
+            if (options.dryRun) {
+                console.log('');
+                console.log(chalk.yellow('DRY RUN MODE - No changes will be applied'));
+                console.log('');
+            }
+            if (options.nonInteractive) {
+                console.log(chalk.yellow('Running in non-interactive mode'));
+            }
+            // Execute
+            console.log('');
+            console.log(chalk.bold('Starting upgrade execution...'));
+            console.log('');
+            const results = await executor.execute(executeOptions, onProgress);
+            // Summary
+            console.log('');
+            console.log(chalk.bold('='.repeat(70)));
+            console.log(chalk.bold(' Execution Summary'));
+            console.log(chalk.bold('='.repeat(70)));
+            console.log('');
+            const completed = results.filter((r) => r.decision === 'accept').length;
+            const skipped = results.filter((r) => r.decision === 'skip').length;
+            const failed = results.filter((r) => !r.success).length;
+            console.log(`${chalk.green('Completed:')} ${completed}`);
+            console.log(`${chalk.yellow('Skipped:')} ${skipped}`);
+            console.log(`${chalk.red('Failed:')} ${failed}`);
+            console.log('');
+            if (failed > 0) {
+                console.log(chalk.red('Some steps failed. Review the errors above.'));
+                console.log('You can resume with: brxm-upgrade execute --resume <step>');
+                process.exit(1);
+            }
+            if (completed === results.length) {
+                console.log(chalk.green('Upgrade completed successfully!'));
+            }
+            else {
+                console.log(chalk.yellow('Upgrade partially completed.'));
+                console.log('Run again to continue with skipped steps.');
+            }
+        }
+        catch (error) {
+            spinner.fail('Execution failed');
+            logger.error(error instanceof Error ? error.message : 'Unknown error');
+            process.exit(1);
+        }
+    });
+    return command;
+}
+/* eslint-enable no-console */
+//# sourceMappingURL=execute.js.map

package/dist/commands/execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../src/commands/execute.ts"],"names":[],"mappings":"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"}

package/dist/commands/export.d.ts

@@ -0,0 +1,26 @@
+import { Command } from 'commander';
+import type { UpgradePlan } from '../planning/types.js';
+import type { ProjectContext } from '../discovery/types.js';
+/**
+ * Generate a markdown document from an upgrade plan and project context.
+ *
+ * The output is optimized for consumption by AI coding agents: it is
+ * self-contained, sequentially ordered, and uses clear labels for
+ * automation levels so the agent knows what action to take per step.
+ *
+ * @param plan - The upgrade plan to render
+ * @param discovery - The project context from discovery
+ * @returns Formatted markdown string
+ */
+export declare function generateExportMarkdown(plan: UpgradePlan, discovery: ProjectContext): string;
+/**
+ * Create the export command for rendering the upgrade plan as markdown.
+ *
+ * The export command loads a previously generated plan and its associated
+ * discovery context, then renders them into a markdown document optimized
+ * for AI coding agents.
+ *
+ * @returns Configured Commander command instance
+ */
+export declare function createExportCommand(): Command;
+//# sourceMappingURL=export.d.ts.map

package/dist/commands/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,OAAO,KAAK,EAAE,WAAW,EAAY,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAgM5D;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,GAAG,MAAM,CAiD3F;AAyBD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAqD7C"}

package/dist/commands/export.js

@@ -0,0 +1,291 @@
+import { dirname } from 'node:path';
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { createSpinner } from '../utils/spinner.js';
+import { resolvePath, writeTextFile, pathExists, joinPaths, parseJsonFile, } from '../utils/fs.js';
+import { getCommandConfig } from '../utils/command-helpers.js';
+/* eslint-disable no-console */
+/**
+ * Map automation level to a human-readable label.
+ */
+function automationLabel(automatable) {
+    switch (automatable) {
+        case 'true':
+            return 'AUTOMATED';
+        case 'partial':
+            return 'AI-ASSISTED';
+        case 'false':
+            return 'MANUAL';
+    }
+}
+/**
+ * Render an AUTOMATED step body.
+ */
+function renderAutomatedStep(step) {
+    const lines = [];
+    lines.push('This step is handled by the upgrade tool. Run:');
+    lines.push('');
+    lines.push('```');
+    lines.push(`brxm-upgrade execute --resume ${step.stepNumber}`);
+    lines.push('```');
+    if (step.type === 'version_bump') {
+        lines.push('');
+        lines.push('**Manual fallback:** Update the parent POM version property');
+        lines.push(`from \`${step.fromVersion}\` to \`${step.toVersion ?? 'target'}\` in your root \`pom.xml\`.`);
+    }
+    return lines.join('\n');
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object';
+}
+function isPlanStep(value) {
+    return isRecord(value)
+        && typeof value.stepNumber === 'number'
+        && typeof value.entryId === 'string'
+        && typeof value.description === 'string'
+        && typeof value.type === 'string'
+        && typeof value.automatable === 'string'
+        && typeof value.riskLevel === 'number'
+        && Array.isArray(value.affectedFiles)
+        && value.affectedFiles.every((file) => typeof file === 'string')
+        && typeof value.affectedFileCount === 'number';
+}
+function isUpgradePlanSummary(value) {
+    return isRecord(value)
+        && typeof value.totalSteps === 'number'
+        && typeof value.automatedSteps === 'number'
+        && typeof value.aiAssistedSteps === 'number'
+        && typeof value.manualSteps === 'number'
+        && typeof value.totalFilesAffected === 'number'
+        && typeof value.averageRiskLevel === 'number';
+}
+function isUpgradePlan(value) {
+    return isRecord(value)
+        && typeof value.generatedAt === 'string'
+        && typeof value.fromVersion === 'string'
+        && typeof value.toVersion === 'string'
+        && Array.isArray(value.upgradePathVersions)
+        && value.upgradePathVersions.every((version) => typeof version === 'string')
+        && Array.isArray(value.steps)
+        && value.steps.every(isPlanStep)
+        && isUpgradePlanSummary(value.summary)
+        && typeof value.aiAnalysisEnabled === 'boolean'
+        && typeof value.discoveryFile === 'string';
+}
+function isProjectContext(value) {
+    if (!isRecord(value) || !isRecord(value.build) || !isRecord(value.repo)) {
+        return false;
+    }
+    return typeof value.projectRoot === 'string'
+        && typeof value.build.brxmVersion === 'string'
+        && typeof value.build.moduleCount === 'number'
+        && typeof value.build.totalJavaFiles === 'number'
+        && Array.isArray(value.build.modules)
+        && value.build.modules.every((module) => isRecord(module) && typeof module.name === 'string')
+        && Array.isArray(value.repo.bootstrapPaths)
+        && value.repo.bootstrapPaths.every((path) => typeof path === 'string');
+}
+/**
+ * Render an AI-ASSISTED step body.
+ */
+function renderAiAssistedStep(step) {
+    const lines = [];
+    if (step.manualSteps && step.manualSteps.length > 0) {
+        lines.push('### What to do');
+        for (const item of step.manualSteps) {
+            lines.push(`- ${item}`);
+        }
+    }
+    if (step.analysis && step.analysis.trim().length > 0) {
+        if (lines.length > 0)
+            lines.push('');
+        lines.push('### Migration guidance');
+        lines.push(step.analysis);
+    }
+    if (step.documentationUrl) {
+        if (lines.length > 0)
+            lines.push('');
+        lines.push('### Documentation');
+        lines.push(`- ${step.documentationUrl}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Render a MANUAL step body.
+ */
+function renderManualStep(step) {
+    const lines = [];
+    if (step.manualSteps && step.manualSteps.length > 0) {
+        lines.push('### What to do');
+        for (const item of step.manualSteps) {
+            lines.push(`- ${item}`);
+        }
+    }
+    if (step.documentationUrl) {
+        if (lines.length > 0)
+            lines.push('');
+        lines.push('### Documentation');
+        lines.push(`- ${step.documentationUrl}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Render the body of a step based on its automation level.
+ */
+function renderStepBody(step) {
+    switch (step.automatable) {
+        case 'true':
+            return renderAutomatedStep(step);
+        case 'partial':
+            return renderAiAssistedStep(step);
+        case 'false':
+            return renderManualStep(step);
+    }
+}
+/**
+ * Render a single step to markdown.
+ */
+function renderStep(step, total) {
+    const label = automationLabel(step.automatable);
+    const lines = [];
+    lines.push(`## Step ${step.stepNumber} of ${total}: ${step.description} [${label}]`);
+    lines.push('');
+    lines.push(`**Entry:** \`${step.entryId}\` | **Type:** ${step.type} | **Risk:** ${step.riskLevel}/5`);
+    lines.push('');
+    const body = renderStepBody(step);
+    if (body.length > 0) {
+        lines.push(body);
+    }
+    lines.push('');
+    lines.push('### Affected files');
+    if (step.affectedFiles.length > 0) {
+        for (const file of step.affectedFiles) {
+            lines.push(`- \`${file}\``);
+        }
+    }
+    else {
+        lines.push('_None — verification only_');
+    }
+    return lines.join('\n');
+}
+/**
+ * Generate a markdown document from an upgrade plan and project context.
+ *
+ * The output is optimized for consumption by AI coding agents: it is
+ * self-contained, sequentially ordered, and uses clear labels for
+ * automation levels so the agent knows what action to take per step.
+ *
+ * @param plan - The upgrade plan to render
+ * @param discovery - The project context from discovery
+ * @returns Formatted markdown string
+ */
+export function generateExportMarkdown(plan, discovery) {
+    const { summary } = plan;
+    const moduleNames = discovery.build.modules.map((m) => m.name).join(', ');
+    const sections = [];
+    // Header
+    sections.push(`# brXM Upgrade Plan: ${plan.fromVersion} \u2192 ${plan.toVersion}`);
+    sections.push('');
+    sections.push(`Generated: ${plan.generatedAt.split('T')[0]} | Steps: ${summary.totalSteps} (${summary.automatedSteps} automated, ${summary.aiAssistedSteps} AI-assisted, ${summary.manualSteps} manual)`);
+    // Project Context
+    sections.push('');
+    sections.push('## Project Context');
+    sections.push(`- **Project root**: ${discovery.projectRoot}`);
+    sections.push(`- **Current version**: ${discovery.build.brxmVersion}`);
+    sections.push(`- **Target version**: ${plan.toVersion}`);
+    sections.push(`- **Detected modules**: ${moduleNames} (${discovery.build.moduleCount} total)`);
+    sections.push(`- **Java files**: ${discovery.build.totalJavaFiles}`);
+    sections.push(`- **Bootstrap configs**: ${discovery.repo.bootstrapPaths.length}`);
+    // Instructions
+    sections.push('');
+    sections.push('## Instructions');
+    sections.push(`Work through each step in order. Steps marked AUTOMATED are handled
+by the upgrade tool \u2014 verify the result but no manual work needed.
+Steps marked AI-ASSISTED need you to implement the migration using
+the guidance provided. Steps marked MANUAL require human judgment.`);
+    sections.push('');
+    sections.push(`Do not skip steps unless explicitly marked as not applicable to
+this project.`);
+    // Steps
+    for (const step of plan.steps) {
+        sections.push('');
+        sections.push('---');
+        sections.push('');
+        sections.push(renderStep(step, summary.totalSteps));
+    }
+    // Trailing newline
+    sections.push('');
+    return sections.join('\n');
+}
+/**
+ * Resolve the path to discovery.json from a plan file, falling back to the
+ * default location if the plan's discoveryFile reference is not found.
+ */
+async function resolveDiscoveryPath(plan, planPath) {
+    // Try the path recorded in the plan relative to plan directory
+    const planDir = dirname(planPath);
+    const fromPlan = resolvePath(planDir, plan.discoveryFile);
+    if (await pathExists(fromPlan)) {
+        return fromPlan;
+    }
+    // Fall back to discovery.json in the same directory as the plan file
+    const fallback = resolvePath(planDir, 'discovery.json');
+    if (await pathExists(fallback)) {
+        return fallback;
+    }
+    throw new Error(`Cannot find discovery.json. Tried:\n  - ${fromPlan}\n  - ${fallback}\nRun \`brxm-upgrade discover\` first.`);
+}
+/**
+ * Create the export command for rendering the upgrade plan as markdown.
+ *
+ * The export command loads a previously generated plan and its associated
+ * discovery context, then renders them into a markdown document optimized
+ * for AI coding agents.
+ *
+ * @returns Configured Commander command instance
+ */
+export function createExportCommand() {
+    const command = new Command('export')
+        .description('Export the upgrade plan as a markdown document for AI agents')
+        .option('--plan <path>', 'Path to plan.json', '.brxm-upgrade/plan.json')
+        .option('--output <path>', 'Path to write the markdown file')
+        .action(async (options) => {
+        const spinner = createSpinner();
+        try {
+            const config = await getCommandConfig(command);
+            // Load plan
+            spinner.start('Loading upgrade plan...');
+            const planPath = resolvePath(options.plan);
+            if (!(await pathExists(planPath))) {
+                throw new Error(`Plan file not found: ${planPath}\nRun \`brxm-upgrade discover\` and \`brxm-upgrade plan\` first.`);
+            }
+            const plan = parseJsonFile(planPath, isUpgradePlan);
+            spinner.succeed(`Loaded plan: ${plan.fromVersion} \u2192 ${plan.toVersion} (${plan.summary.totalSteps} steps)`);
+            // Load discovery
+            spinner.start('Loading project context...');
+            const discoveryPath = await resolveDiscoveryPath(plan, planPath);
+            const discovery = parseJsonFile(discoveryPath, isProjectContext);
+            spinner.succeed(`Loaded project context for ${discovery.build.brxmVersion}`);
+            // Generate markdown
+            spinner.start('Generating markdown...');
+            const markdown = generateExportMarkdown(plan, discovery);
+            spinner.succeed('Markdown generated');
+            // Write output
+            const outputPath = resolvePath(options.output ?? joinPaths(config.output.exportPath, 'upgrade-plan.md'));
+            spinner.start(`Writing ${outputPath}...`);
+            await writeTextFile(outputPath, markdown);
+            spinner.succeed(`Written to ${outputPath}`);
+            console.log('');
+            console.log(chalk.green('Export complete.'));
+            console.log(`Open ${chalk.bold(outputPath)} or feed it to your AI coding agent.`);
+        }
+        catch (error) {
+            spinner.fail('Export failed');
+            console.error(error instanceof Error ? error.message : 'Unknown error');
+            process.exit(1);
+        }
+    });
+    return command;
+}
+/* eslint-enable no-console */
+//# sourceMappingURL=export.js.map

package/dist/commands/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"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"}

package/dist/commands/finalize.d.ts

@@ -0,0 +1,12 @@
+import { Command } from 'commander';
+/**
+ * Create the finalize command for promoting unreleased manifest entries to a released version.
+ *
+ * The finalize command loads the unreleased manifest, optionally generates missing
+ * changelog entries using AI, and writes a new versioned manifest file in the
+ * released directory. It then resets the unreleased manifest to empty.
+ *
+ * @returns Configured Commander command instance
+ */
+export declare function createFinalizeCommand(): Command;
+//# sourceMappingURL=finalize.d.ts.map