@bloomreach/brxm-upgrade 0.1.1

package/dist/commands/plan.js

@@ -0,0 +1,162 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { createSpinner } from '../utils/spinner.js';
+import { createLogger } from '../utils/logger.js';
+import { pathExists, resolvePath } from '../utils/fs.js';
+import { getApiKey } from '../config/index.js';
+import { createAIClient } from '../ai/index.js';
+import { loadManifestsForUpgrade, matchManifestsToProject, generatePlan, analyzeEntriesWithAI, } from '../planning/index.js';
+import { DocsClient } from '../docs/index.js';
+import { getCommandConfig } from '../utils/command-helpers.js';
+/**
+ * Format an upgrade plan for CLI display.
+ *
+ * @param plan - The upgrade plan to format
+ * @returns Formatted string for terminal output
+ */
+function formatPlanForDisplay(plan) {
+    const lines = [];
+    lines.push('');
+    lines.push(chalk.bold('='.repeat(65)));
+    lines.push(chalk.bold(` Upgrade Plan: ${plan.fromVersion} -> ${plan.toVersion}`));
+    lines.push(chalk.bold('='.repeat(65)));
+    const { summary } = plan;
+    lines.push(` Automated (${summary.automatedSteps})    ` +
+        `AI-Assisted (${summary.aiAssistedSteps})    ` +
+        `Manual (${summary.manualSteps})`);
+    lines.push(chalk.bold('='.repeat(65)));
+    lines.push('');
+    for (const step of plan.steps) {
+        const automationIcon = step.automatable === 'true'
+            ? chalk.green('[AUTO]')
+            : step.automatable === 'partial'
+                ? chalk.yellow('[AI]')
+                : chalk.blue('[MANUAL]');
+        const fileInfo = step.affectedFileCount > 0
+            ? chalk.gray(` (${step.affectedFileCount} files)`)
+            : '';
+        lines.push(`Step ${step.stepNumber}/${plan.steps.length}: ${automationIcon} ${step.entryId}${fileInfo}`);
+        lines.push(chalk.gray(`           ${step.description}`));
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Create the plan command for generating an upgrade plan.
+ *
+ * The plan command loads project discovery, matches upgrade manifests
+ * against the project, optionally runs AI analysis, and produces an
+ * ordered upgrade plan saved to disk.
+ *
+ * @returns Configured Commander command instance
+ */
+export function createPlanCommand() {
+    const command = new Command('plan')
+        .description('Generate an upgrade plan by matching manifests to your project')
+        .requiredOption('--to <version>', 'Target brXM version to upgrade to')
+        .option('--discovery <path>', 'Path to discovery.json', '.brxm-upgrade/discovery.json')
+        .option('--output <path>', 'Output path for plan.json', '.brxm-upgrade/plan.json')
+        .option('--no-ai', 'Disable AI analysis for partial entries')
+        .option('--include-all', 'Include non-applicable entries in plan')
+        .action(async (options) => {
+        const logger = createLogger();
+        const spinner = createSpinner();
+        let docsClient;
+        try {
+            const config = await getCommandConfig(command);
+            const discoveryPath = resolvePath(options.discovery);
+            const outputPath = resolvePath(options.output);
+            const targetVersion = options.to;
+            // Verify discovery file exists
+            if (!(await pathExists(discoveryPath))) {
+                logger.error(`Discovery file not found: ${discoveryPath}`);
+                logger.info('Run "brxm-upgrade discover" first to analyze your project.');
+                process.exit(1);
+            }
+            // Load project discovery
+            spinner.start('Loading project discovery...');
+            const discoveryContent = await readFile(discoveryPath, 'utf-8');
+            const projectContext = JSON.parse(discoveryContent);
+            spinner.succeed(`Loaded discovery from ${discoveryPath}`);
+            const fromVersion = projectContext.build.brxmVersion;
+            logger.info(`Planning upgrade: ${fromVersion} -> ${targetVersion}`);
+            // Load upgrade manifests
+            const manifestOptions = {
+                source: config.upgrade.source,
+                url: config.upgrade.url,
+                localPath: config.upgrade.localPath,
+            };
+            spinner.start('Loading upgrade manifests...');
+            const manifests = await loadManifestsForUpgrade(fromVersion, targetVersion, manifestOptions);
+            if (manifests.length === 0) {
+                spinner.info('No upgrade needed - already at target version.');
+                return;
+            }
+            const upgradePathVersions = manifests.map((m) => m.version);
+            const totalEntries = manifests.reduce((sum, m) => sum + m.entries.length, 0);
+            spinner.succeed(`Loaded ${manifests.length} manifests (${totalEntries} entries)`);
+            // Match manifest entries to project
+            spinner.start('Matching entries to your project...');
+            const matches = await matchManifestsToProject(manifests, projectContext, { projectRoot: projectContext.projectRoot });
+            const applicableMatches = matches.filter((m) => m.applies);
+            spinner.succeed(`Found ${applicableMatches.length} applicable changes`);
+            // Optional AI analysis for partial entries
+            let aiAnalysisEnabled = false;
+            if (options.ai !== false) {
+                const partialEntries = applicableMatches.filter((m) => m.entry.automatable === 'partial');
+                if (partialEntries.length > 0) {
+                    const apiKey = getApiKey(config.ai.provider, config.ai.apiKeyEnv);
+                    if (apiKey) {
+                        spinner.start(`AI analyzing ${partialEntries.length} partial entries...`);
+                        const aiClient = createAIClient(config.ai.provider, config.ai.model, apiKey, config.ai.baseUrl);
+                        docsClient = new DocsClient({}, config.output.verbose);
+                        const analyses = await analyzeEntriesWithAI(partialEntries.map((m) => ({
+                            entry: m.entry,
+                            affectedFiles: m.affectedFiles,
+                        })), projectContext, aiClient, (completed, total) => {
+                            spinner.text(`AI analyzing entry ${completed}/${total}...`);
+                        }, docsClient);
+                        for (const match of applicableMatches) {
+                            const analysis = analyses.get(match.entry.id);
+                            if (analysis) {
+                                match.aiAnalysis = analysis;
+                            }
+                        }
+                        aiAnalysisEnabled = true;
+                        spinner.succeed('AI analysis complete');
+                    }
+                    else {
+                        logger.warn(`AI analysis skipped - set ${config.ai.apiKeyEnv} to enable it`);
+                    }
+                }
+            }
+            // Generate the upgrade plan
+            spinner.start('Generating upgrade plan...');
+            const plan = generatePlan(options.includeAll ? matches : applicableMatches, fromVersion, targetVersion, upgradePathVersions, options.discovery, { includeNonApplicable: options.includeAll });
+            plan.aiAnalysisEnabled = aiAnalysisEnabled;
+            // Write plan to disk
+            const outputDir = dirname(outputPath);
+            if (!(await pathExists(outputDir))) {
+                await mkdir(outputDir, { recursive: true });
+            }
+            await writeFile(outputPath, JSON.stringify(plan, null, 2), 'utf-8');
+            spinner.succeed(`Plan saved to ${outputPath}`);
+            // Display formatted plan
+            // eslint-disable-next-line no-console
+            console.log(formatPlanForDisplay(plan));
+            logger.success('Ready to execute? Run: brxm-upgrade execute');
+        }
+        catch (error) {
+            spinner.fail('Planning failed');
+            logger.error(error instanceof Error ? error.message : 'Unknown error');
+            process.exit(1);
+        }
+        finally {
+            await docsClient?.disconnect();
+        }
+    });
+    return command;
+}
+//# sourceMappingURL=plan.js.map

package/dist/commands/plan.js.map

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

package/dist/commands/review-manifest.d.ts

@@ -0,0 +1,39 @@
+import { Command } from 'commander';
+import type { AIClient } from '../ai/types.js';
+import type { ManifestEntry, UpgradeManifest } from '../planning/types.js';
+import type { QARecord } from '../capture/critique-types.js';
+/**
+ * Result of running the QA pipeline against a released manifest.
+ */
+export interface ReviewResult {
+    /** Markdown quality report */
+    report: string;
+    /** All final manifest entries after QA processing (may include split entries) */
+    patchedEntries: ManifestEntry[];
+    /** QA tracking records for each original entry */
+    qaRecords: QARecord[];
+    /** Original manifest metadata preserved for writing patched output */
+    originalManifest: UpgradeManifest;
+}
+/**
+ * Runs the QA pipeline (critique + optional regeneration + heuristic fixes) on a
+ * released manifest YAML file. This enables retroactive quality improvement of
+ * already-published manifests.
+ *
+ * For each entry, the original change document is not available, so
+ * `entry.description` is used as a stand-in change doc content for the critique.
+ *
+ * @param version - The manifest version to review (e.g. "16.7.0")
+ * @param aiClient - AI client to use for critique and regeneration
+ * @param manifestDir - Optional directory override; defaults to src/manifests/released/
+ * @returns ReviewResult with the quality report, patched entries, and QA records
+ */
+export declare function reviewManifest(version: string, aiClient: AIClient, manifestDir?: string): Promise<ReviewResult>;
+/**
+ * Create the review-manifest command for running the QA pipeline against a
+ * released manifest.
+ *
+ * @returns Configured Commander command instance
+ */
+export declare function createReviewManifestCommand(): Command;
+//# sourceMappingURL=review-manifest.d.ts.map

package/dist/commands/review-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-manifest.d.ts","sourceRoot":"","sources":["../../src/commands/review-manifest.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAK3E,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,8BAA8B,CAAC;AAW7E;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,kDAAkD;IAClD,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,sEAAsE;IACtE,gBAAgB,EAAE,eAAe,CAAC;CACnC;AASD;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,CAAC,CAyFvB;AAID;;;;;GAKG;AACH,wBAAgB,2BAA2B,IAAI,OAAO,CAmErD"}

package/dist/commands/review-manifest.js

@@ -0,0 +1,178 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { dirname } from 'node:path';
+import * as yaml from 'js-yaml';
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { critiqueEntry } from '../capture/entry-critique.js';
+import { regenerateEntry } from '../capture/entry-regeneration.js';
+import { applyHeuristicFixes } from '../capture/heuristics.js';
+import { generateQualityReport } from '../capture/quality-report.js';
+import { createLogger } from '../utils/logger.js';
+import { createSpinner } from '../utils/spinner.js';
+import { writeTextFile } from '../utils/fs.js';
+import { getApiKey } from '../config/index.js';
+import { createAIClient } from '../ai/index.js';
+import { getCommandConfig } from '../utils/command-helpers.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Resolves the default released manifests directory relative to this module.
+ */
+function getDefaultManifestDir() {
+    return join(__dirname, '..', 'manifests', 'released');
+}
+/**
+ * Runs the QA pipeline (critique + optional regeneration + heuristic fixes) on a
+ * released manifest YAML file. This enables retroactive quality improvement of
+ * already-published manifests.
+ *
+ * For each entry, the original change document is not available, so
+ * `entry.description` is used as a stand-in change doc content for the critique.
+ *
+ * @param version - The manifest version to review (e.g. "16.7.0")
+ * @param aiClient - AI client to use for critique and regeneration
+ * @param manifestDir - Optional directory override; defaults to src/manifests/released/
+ * @returns ReviewResult with the quality report, patched entries, and QA records
+ */
+export async function reviewManifest(version, aiClient, manifestDir) {
+    const logger = createLogger({ prefix: 'review-manifest' });
+    const dir = manifestDir ?? getDefaultManifestDir();
+    const manifestPath = join(dir, `${version}.yaml`);
+    logger.info(`Loading manifest: ${manifestPath}`);
+    const rawContent = await readFile(manifestPath, 'utf-8');
+    const manifest = yaml.load(rawContent);
+    if (!manifest ||
+        typeof manifest !== 'object' ||
+        !Array.isArray(manifest.entries)) {
+        throw new Error(`Invalid manifest structure in ${manifestPath} — expected an object with an "entries" array`);
+    }
+    const typedManifest = manifest;
+    const entries = typedManifest.entries ?? [];
+    logger.info(`Processing ${entries.length} entries from manifest ${version}`);
+    const qaRecords = [];
+    const patchedEntries = [];
+    for (const entry of entries) {
+        logger.info(`  Critiquing entry: ${entry.id}`);
+        // Use the entry description as change doc content since originals are unavailable
+        const changeDocContent = entry.description;
+        // Step 1: AI self-critique
+        const critique = await critiqueEntry(entry, changeDocContent, aiClient);
+        // Step 2: Optionally regenerate
+        const needsRegeneration = critique.overallQuality === 'regenerate' || critique.shouldSplit;
+        let finalEntries;
+        let regenerated = false;
+        if (needsRegeneration) {
+            logger.info(`    Regenerating entry: ${entry.id} (quality=${critique.overallQuality}, split=${critique.shouldSplit})`);
+            finalEntries = await regenerateEntry(entry, changeDocContent, critique, aiClient);
+            regenerated = true;
+        }
+        else {
+            finalEntries = [entry];
+        }
+        // Step 3: Heuristic fixes on every final entry
+        const allHeuristicFixes = [];
+        for (const finalEntry of finalEntries) {
+            const fixes = applyHeuristicFixes(finalEntry);
+            for (const fix of fixes) {
+                allHeuristicFixes.push(fix.description);
+            }
+        }
+        // Step 4: Determine final quality
+        const hasHeuristicFixes = allHeuristicFixes.length > 0;
+        let finalQuality;
+        if (critique.overallQuality === 'good' && !hasHeuristicFixes && !regenerated) {
+            finalQuality = 'good';
+        }
+        else {
+            finalQuality = 'needs_improvement';
+        }
+        // Determine split metadata
+        const split = critique.shouldSplit && finalEntries.length > 1;
+        const splitCount = split ? finalEntries.length : undefined;
+        const qaRecord = {
+            entryId: entry.id,
+            originalEntry: entry,
+            critique,
+            regenerated,
+            split,
+            ...(splitCount !== undefined ? { splitCount } : {}),
+            heuristicFixes: allHeuristicFixes,
+            finalQuality,
+        };
+        qaRecords.push(qaRecord);
+        patchedEntries.push(...finalEntries);
+    }
+    // Step 5: Generate quality report
+    const report = generateQualityReport(version, qaRecords);
+    logger.success(`Review complete: ${qaRecords.length} entries processed`);
+    return { report, patchedEntries, qaRecords, originalManifest: typedManifest };
+}
+/* eslint-disable no-console */
+/**
+ * Create the review-manifest command for running the QA pipeline against a
+ * released manifest.
+ *
+ * @returns Configured Commander command instance
+ */
+export function createReviewManifestCommand() {
+    const command = new Command('review-manifest')
+        .description('Review a released manifest for quality issues using the AI QA pipeline')
+        .argument('<version>', 'Manifest version to review (e.g. 15.1.0)')
+        .option('--output <path>', 'Write patched manifest YAML to this path')
+        .action(async (version, options) => {
+        const spinner = createSpinner();
+        try {
+            // Load configuration
+            spinner.start('Loading configuration...');
+            const config = await getCommandConfig(command);
+            spinner.succeed('Configuration loaded');
+            // Initialise AI client
+            spinner.start('Initializing AI provider...');
+            const apiKey = getApiKey(config.ai.provider, config.ai.apiKeyEnv);
+            if (!apiKey) {
+                spinner.fail(`No API key found for ${config.ai.provider}.`);
+                console.log('AI is required for review-manifest. Set your API key and try again.');
+                process.exit(1);
+            }
+            const aiClient = createAIClient(config.ai.provider, config.ai.model, apiKey, config.ai.baseUrl);
+            spinner.succeed(`AI provider: ${config.ai.provider} (${config.ai.model})`);
+            // Run the QA pipeline
+            spinner.start(`Reviewing manifest ${version}...`);
+            const result = await reviewManifest(version, aiClient);
+            spinner.succeed(`Review complete: ${result.qaRecords.length} entries processed`);
+            // Print the report
+            console.log('');
+            console.log(result.report);
+            // Optionally write patched YAML
+            if (options.output) {
+                spinner.start(`Writing patched manifest to ${options.output}...`);
+                const patchedManifest = {
+                    schema_version: result.originalManifest.schema_version,
+                    version,
+                    ...(result.originalManifest.release_date !== undefined
+                        ? { release_date: result.originalManifest.release_date }
+                        : {}),
+                    ...(result.originalManifest.managed_properties !== undefined
+                        ? { managed_properties: result.originalManifest.managed_properties }
+                        : {}),
+                    entries: result.patchedEntries,
+                };
+                const yamlContent = yaml.dump(patchedManifest, { lineWidth: 120 });
+                await writeTextFile(options.output, yamlContent);
+                spinner.succeed(`Patched manifest written to ${options.output}`);
+                console.log('');
+                console.log(chalk.green('Patched manifest saved.'));
+            }
+        }
+        catch (error) {
+            spinner.fail('review-manifest failed');
+            console.error(error instanceof Error ? error.message : 'Unknown error');
+            process.exit(1);
+        }
+    });
+    return command;
+}
+/* eslint-enable no-console */
+//# sourceMappingURL=review-manifest.js.map

package/dist/commands/review-manifest.js.map

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

package/dist/commands/setup-manifests.d.ts

@@ -0,0 +1,12 @@
+import { Command } from 'commander';
+/**
+ * Create the setup-manifests command for downloading and configuring brXM upgrade manifests.
+ *
+ * The command downloads the manifest ZIP from Bloomreach Nexus via Maven,
+ * extracts it to a local directory, and updates the .brxmrc configuration.
+ * If Maven or credentials are unavailable, it prints manual fallback instructions.
+ *
+ * @returns Configured Commander command instance
+ */
+export declare function createSetupManifestsCommand(): Command;
+//# sourceMappingURL=setup-manifests.d.ts.map

package/dist/commands/setup-manifests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-manifests.d.ts","sourceRoot":"","sources":["../../src/commands/setup-manifests.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoIpC;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,IAAI,OAAO,CAyGrD"}

package/dist/commands/setup-manifests.js

@@ -0,0 +1,229 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import * as yaml from 'js-yaml';
+import { execSync } from 'node:child_process';
+import { readdirSync } from 'node:fs';
+import { mkdtemp, readFile, writeFile } from 'node:fs/promises';
+import { tmpdir, homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { createSpinner } from '../utils/spinner.js';
+import { pathExists, ensureDir } from '../utils/fs.js';
+import { findNexusCredentials } from '../manifests/maven-settings.js';
+/* eslint-disable no-console */
+const MAVEN_GROUP_ID = 'com.bloomreach.xm';
+const MAVEN_ARTIFACT_ID = 'brxm-upgrade-manifests';
+function getManualDownloadInstructions(outputDir) {
+    return `
+${chalk.bold('Manual setup:')}
+
+  ${chalk.dim('# Download the manifest artifact from Nexus')}
+  mvn dependency:copy \\
+    -Dartifact=${MAVEN_GROUP_ID}:${MAVEN_ARTIFACT_ID}:RELEASE:zip \\
+    -DoutputDirectory=.brxm-upgrade/ \\
+    -Dtransitive=false -q
+
+  ${chalk.dim('# Extract to your manifests directory')}
+  unzip .brxm-upgrade/${MAVEN_ARTIFACT_ID}-*.zip \\
+    -d ${outputDir}
+
+  ${chalk.dim('# Configure the tool to use local manifests')}
+  ${chalk.dim('# Add to .brxmrc:')}
+  ${chalk.gray('upgrade:')}
+  ${chalk.gray('  source: local')}
+  ${chalk.gray(`  localPath: ${outputDir}`)}
+`;
+}
+const MAVEN_CREDENTIALS_INSTRUCTIONS = `
+${chalk.yellow('Maven credentials not found.')}
+
+To configure Nexus credentials, add a server entry to ${chalk.cyan(`${homedir()}/.m2/settings.xml`)}:
+
+  ${chalk.gray('<settings>')}
+  ${chalk.gray('  <servers>')}
+  ${chalk.gray('    <server>')}
+  ${chalk.gray('      <id>bloomreach-nexus</id>')}
+  ${chalk.gray('      <username>YOUR_USERNAME</username>')}
+  ${chalk.gray('      <password>YOUR_PASSWORD</password>')}
+  ${chalk.gray('    </server>')}
+  ${chalk.gray('  </servers>')}
+  ${chalk.gray('</settings>')}
+`;
+/**
+ * Check if mvn is available on PATH.
+ */
+function isMavenAvailable() {
+    try {
+        execSync('mvn --version', { stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Run a Maven dependency:copy to download the manifests ZIP.
+ *
+ * @param outputDir - Directory to place the downloaded ZIP
+ * @param serverId - Maven server ID for authentication
+ */
+function downloadManifestZip(outputDir, serverId) {
+    const artifact = `${MAVEN_GROUP_ID}:${MAVEN_ARTIFACT_ID}:RELEASE:zip`;
+    const serverArg = serverId ? `-Drepository.id=${serverId}` : '';
+    const cmd = [
+        'mvn',
+        'dependency:copy',
+        `-Dartifact=${artifact}`,
+        `-DoutputDirectory=${outputDir}`,
+        '-Dtransitive=false',
+        '-q',
+        serverArg,
+    ].filter(Boolean).join(' ');
+    execSync(cmd, { stdio: 'pipe' });
+    // Maven resolves RELEASE to an actual version — find the downloaded zip dynamically
+    const files = readdirSync(outputDir);
+    const zipFile = files.find((f) => f.endsWith('.zip'));
+    if (!zipFile) {
+        throw new Error('Maven download succeeded but no zip file found in output directory');
+    }
+    return join(outputDir, zipFile);
+}
+/**
+ * Extract a ZIP file to the target directory using the system unzip command.
+ */
+function extractZip(zipPath, targetDir) {
+    execSync(`unzip -o ${zipPath} -d ${targetDir}`, { stdio: 'pipe' });
+}
+/**
+ * Update (or create) the .brxmrc file with the local manifest path.
+ *
+ * @param outputDir - Absolute path to the extracted manifests directory
+ */
+async function updateBrxmrc(outputDir) {
+    const rcPath = resolve(process.cwd(), '.brxmrc');
+    let existing = {};
+    if (await pathExists(rcPath)) {
+        const content = await readFile(rcPath, 'utf-8');
+        const parsed = yaml.load(content);
+        if (parsed != null && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            existing = parsed;
+        }
+    }
+    // Deep-merge the upgrade section
+    const upgrade = existing['upgrade'] ?? {};
+    existing['upgrade'] = {
+        ...upgrade,
+        source: 'local',
+        localPath: outputDir,
+    };
+    await writeFile(rcPath, yaml.dump(existing), 'utf-8');
+}
+/**
+ * Create the setup-manifests command for downloading and configuring brXM upgrade manifests.
+ *
+ * The command downloads the manifest ZIP from Bloomreach Nexus via Maven,
+ * extracts it to a local directory, and updates the .brxmrc configuration.
+ * If Maven or credentials are unavailable, it prints manual fallback instructions.
+ *
+ * @returns Configured Commander command instance
+ */
+export function createSetupManifestsCommand() {
+    const command = new Command('setup-manifests')
+        .description('Download and configure brXM upgrade manifests from Bloomreach Nexus')
+        .option('--output-dir <path>', 'Directory to extract manifests into', '.brxm-manifests')
+        .option('--skip-download', 'Print manual download instructions and exit', false)
+        .action(async (options) => {
+        console.log('');
+        console.log(chalk.bold('brXM Upgrade \u2014 Manifest Setup'));
+        console.log(chalk.gray('\u2501'.repeat(50)));
+        console.log('');
+        // --skip-download: print manual instructions and exit
+        if (options.skipDownload) {
+            console.log(getManualDownloadInstructions(options.outputDir));
+            return;
+        }
+        const spinner = createSpinner();
+        // Check Maven availability
+        spinner.start('Checking Maven availability...');
+        if (!isMavenAvailable()) {
+            spinner.warn('Maven (mvn) not found on PATH');
+            console.log('');
+            console.log(chalk.yellow('Cannot download manifests automatically — Maven is required.'));
+            console.log(getManualDownloadInstructions(options.outputDir));
+            return;
+        }
+        spinner.succeed('Maven is available');
+        // Check Nexus credentials
+        spinner.start('Looking for Nexus credentials in ~/.m2/settings.xml...');
+        const credentialsResult = await findNexusCredentials();
+        if (!credentialsResult.found) {
+            spinner.warn('Nexus credentials not found');
+            console.log(MAVEN_CREDENTIALS_INSTRUCTIONS);
+            console.log(getManualDownloadInstructions(options.outputDir));
+            return;
+        }
+        spinner.succeed(`Found Nexus credentials (server: ${credentialsResult.serverId})`);
+        // Prepare output directory
+        const outputDir = resolve(process.cwd(), options.outputDir);
+        // Download ZIP to a temporary directory
+        let tmpDir;
+        try {
+            tmpDir = await mkdtemp(join(tmpdir(), 'brxm-manifests-'));
+        }
+        catch (error) {
+            spinner.fail('Failed to create temporary directory');
+            console.error(error instanceof Error ? error.message : String(error));
+            process.exit(1);
+        }
+        let zipPath;
+        try {
+            spinner.start(`Downloading ${MAVEN_GROUP_ID}:${MAVEN_ARTIFACT_ID}...`);
+            zipPath = downloadManifestZip(tmpDir, credentialsResult.serverId);
+            spinner.succeed('Download complete');
+        }
+        catch (error) {
+            spinner.fail('Download failed');
+            const msg = error instanceof Error ? error.message : String(error);
+            console.log('');
+            console.log(chalk.red(`Maven error: ${msg}`));
+            console.log(getManualDownloadInstructions(options.outputDir));
+            return;
+        }
+        // Extract ZIP
+        try {
+            spinner.start(`Extracting manifests to ${outputDir}...`);
+            await ensureDir(outputDir);
+            extractZip(zipPath, outputDir);
+            spinner.succeed(`Extracted to ${outputDir}`);
+        }
+        catch (error) {
+            spinner.fail('Extraction failed');
+            const msg = error instanceof Error ? error.message : String(error);
+            console.log(chalk.red(`Extraction error: ${msg}`));
+            process.exit(1);
+        }
+        // Update .brxmrc
+        try {
+            spinner.start('Updating .brxmrc...');
+            await updateBrxmrc(outputDir);
+            spinner.succeed('.brxmrc updated');
+        }
+        catch (error) {
+            spinner.fail('Failed to update .brxmrc');
+            const msg = error instanceof Error ? error.message : String(error);
+            console.log(chalk.red(`Config error: ${msg}`));
+            process.exit(1);
+        }
+        // Success summary
+        console.log('');
+        console.log(chalk.green.bold('Manifests configured successfully!'));
+        console.log('');
+        console.log(`  Location:  ${chalk.cyan(outputDir)}`);
+        console.log(`  Config:    ${chalk.cyan('.brxmrc')} (upgrade.source = local)`);
+        console.log('');
+        console.log(chalk.gray(`Next step: run ${chalk.cyan('brxm-upgrade discover')} to analyze your project.`));
+        console.log('');
+    });
+    return command;
+}
+/* eslint-enable no-console */
+//# sourceMappingURL=setup-manifests.js.map