@bloomreach/brxm-upgrade 0.1.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"finalize.d.ts","sourceRoot":"","sources":["../../src/commands/finalize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+DpC;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CA8L/C"}

package/dist/commands/finalize.js

@@ -0,0 +1,225 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import semver from 'semver';
+import inquirer from 'inquirer';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { createSpinner } from '../utils/spinner.js';
+import { createLogger } from '../utils/logger.js';
+import { pathExists } from '../utils/fs.js';
+import { getApiKey } from '../config/index.js';
+import { createAIClient } from '../ai/index.js';
+import { loadUnreleasedManifest, saveManifest } from '../planning/manifest-loader.js';
+import { extractVersionProperties } from '../manifests/parent-properties.js';
+import { getCommandConfig } from '../utils/command-helpers.js';
+/* eslint-disable no-console */
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Get the project root directory for brxm-upgrade (where package.json lives).
+ */
+function getProjectRoot() {
+    return join(__dirname, '..', '..');
+}
+function getDefaultUnreleasedPath() {
+    return join(getProjectRoot(), 'src', 'manifests', 'unreleased.yaml');
+}
+/**
+ * Get the default directory for released manifests.
+ */
+function getDefaultReleasedDir() {
+    return join(getProjectRoot(), 'src', 'manifests', 'released');
+}
+/**
+ * Generate a changelog entry for a manifest entry using an AI client.
+ *
+ * @param entry - The manifest entry to generate a changelog for
+ * @param aiClient - The AI client to use for generation
+ * @returns A concise, one-sentence changelog entry
+ */
+async function generateChangelogEntry(entry, aiClient) {
+    const result = await aiClient.generate(`Write a concise, one-sentence changelog entry for this upgrade step:\n\n` +
+        `ID: ${entry.id}\n` +
+        `Type: ${entry.type}\n` +
+        `Description: ${entry.description}\n` +
+        `Automatable: ${entry.automatable}\n\n` +
+        `Respond with ONLY the changelog text, no quotes or prefixes.`, { maxTokens: 200, temperature: 0.3 });
+    return result.text.trim();
+}
+/**
+ * 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 function createFinalizeCommand() {
+    const command = new Command('finalize')
+        .description('Promote unreleased manifest entries to a released version')
+        .argument('<version>', 'Version to finalize (e.g., 16.3.0)')
+        .option('--unreleased <path>', 'Path to unreleased.yaml')
+        .option('--released-dir <path>', 'Path to released manifests directory')
+        .option('--repo-path <path>', 'Path to the brXM monorepo root (for extracting managed_properties)')
+        .option('--force', 'Skip confirmation prompt', false)
+        .option('-v, --verbose', 'Enable verbose output', false)
+        .action(async (version, options) => {
+        const logger = createLogger({ verbose: options.verbose });
+        const spinner = createSpinner();
+        try {
+            // Validate version
+            if (!semver.valid(version)) {
+                console.log(chalk.red(`Invalid version: "${version}". Must be a valid semver (e.g., 16.3.0).`));
+                process.exit(1);
+            }
+            // Resolve paths
+            const unreleasedPath = options.unreleased ?? getDefaultUnreleasedPath();
+            const releasedDir = options.releasedDir ?? getDefaultReleasedDir();
+            const releasedPath = join(releasedDir, `${version}.yaml`);
+            // Check for version collision
+            if (await pathExists(releasedPath)) {
+                console.log(chalk.red(`Released manifest already exists: ${releasedPath}`));
+                console.log('Remove it manually if you want to re-finalize.');
+                process.exit(1);
+            }
+            // Load unreleased manifest
+            spinner.start('Loading unreleased manifest...');
+            const unreleased = await loadUnreleasedManifest(unreleasedPath);
+            if (unreleased.entries.length === 0) {
+                spinner.succeed('No unreleased entries — creating empty release manifest');
+            }
+            else {
+                spinner.succeed(`Loaded ${unreleased.entries.length} unreleased entries`);
+            }
+            // Quality gate: check for missing changelog entries
+            const missingChangelog = unreleased.entries.filter(e => !e.changelog_entry);
+            if (missingChangelog.length > 0) {
+                console.log('');
+                console.log(chalk.yellow(`${missingChangelog.length} entries missing changelog_entry:`));
+                for (const entry of missingChangelog) {
+                    console.log(chalk.yellow(`  - ${entry.id}`));
+                }
+                const config = await getCommandConfig(command);
+                const apiKey = getApiKey(config.ai.provider, config.ai.apiKeyEnv);
+                if (apiKey) {
+                    const backfill = options.force || (await inquirer.prompt([{
+                            type: 'confirm',
+                            name: 'backfill',
+                            message: 'Generate missing changelog entries with AI?',
+                            default: true,
+                        }])).backfill;
+                    if (backfill) {
+                        const aiClient = createAIClient(config.ai.provider, config.ai.model, apiKey, config.ai.baseUrl);
+                        const skippedEntries = [];
+                        for (const entry of missingChangelog) {
+                            spinner.start(`Generating changelog for ${entry.id}...`);
+                            try {
+                                entry.changelog_entry = await generateChangelogEntry(entry, aiClient);
+                                spinner.succeed(`${entry.id}: ${entry.changelog_entry}`);
+                            }
+                            catch (error) {
+                                const msg = error instanceof Error ? error.message : String(error);
+                                spinner.warn(`Failed to generate changelog for ${entry.id}: ${msg}`);
+                                skippedEntries.push(entry.id);
+                            }
+                        }
+                        if (skippedEntries.length > 0) {
+                            console.log(chalk.yellow(`\nSkipped changelog generation for: ${skippedEntries.join(', ')}`));
+                        }
+                    }
+                }
+                else {
+                    console.log(chalk.yellow('No AI provider configured. Cannot auto-generate changelog entries.'));
+                    console.log('Add them manually or configure AI and try again.');
+                }
+            }
+            // Confirmation
+            if (!options.force) {
+                console.log('');
+                const { confirmed } = await inquirer.prompt([{
+                        type: 'confirm',
+                        name: 'confirmed',
+                        message: `Finalize ${unreleased.entries.length} entries as ${version}?`,
+                        default: true,
+                    }]);
+                if (!confirmed) {
+                    console.log('Cancelled.');
+                    return;
+                }
+            }
+            const today = new Date().toISOString().split('T')[0];
+            // Extract managed version properties from the community parent POM at brxm-<version>.
+            // Non-fatal: if the tag isn't available (e.g., finalize run before tagging) or the POM
+            // has no *.version properties, we log and continue with an empty object.
+            let managedProperties = {};
+            const repoPath = options.repoPath ?? process.cwd();
+            const gitTag = `brxm-${version}`;
+            spinner.start(`Extracting managed properties from ${gitTag}...`);
+            try {
+                managedProperties = extractVersionProperties(gitTag, repoPath);
+                const propCount = Object.keys(managedProperties).length;
+                if (propCount === 0) {
+                    spinner.warn(`No *.version properties found at ${gitTag} — managed_properties will be empty.`);
+                }
+                else {
+                    spinner.succeed(`Extracted ${propCount} managed properties from ${gitTag}`);
+                }
+            }
+            catch (error) {
+                const msg = error instanceof Error ? error.message : String(error);
+                spinner.warn(`Could not read POM at ${gitTag} (${msg}) — skipping managed_properties.`);
+            }
+            const released = {
+                schema_version: unreleased.schema_version,
+                version,
+                release_date: today,
+                ...(Object.keys(managedProperties).length > 0 ? { managed_properties: managedProperties } : {}),
+                entries: unreleased.entries,
+            };
+            // Write released manifest
+            spinner.start(`Writing released manifest: ${version}.yaml...`);
+            await saveManifest(releasedPath, released);
+            spinner.succeed(`Released: ${releasedPath}`);
+            // Reset unreleased
+            spinner.start('Resetting unreleased.yaml...');
+            const emptyManifest = {
+                schema_version: '1.0',
+                version: 'unreleased',
+                entries: [],
+            };
+            await saveManifest(unreleasedPath, emptyManifest);
+            spinner.succeed('Unreleased manifest reset');
+            // Summary
+            console.log('');
+            console.log(chalk.bold('\u2501'.repeat(60)));
+            console.log(chalk.bold(` Finalized: ${version}`));
+            console.log(chalk.bold('\u2501'.repeat(60)));
+            console.log(`  Total entries: ${released.entries.length}`);
+            const byType = new Map();
+            const byAutomation = new Map();
+            for (const entry of released.entries) {
+                byType.set(entry.type, (byType.get(entry.type) ?? 0) + 1);
+                byAutomation.set(entry.automatable, (byAutomation.get(entry.automatable) ?? 0) + 1);
+            }
+            console.log('  By type:');
+            for (const [type, count] of byType.entries()) {
+                console.log(`    ${type}: ${count}`);
+            }
+            console.log('  By automation:');
+            for (const [level, count] of byAutomation.entries()) {
+                const label = level === 'true' ? 'Automated' : level === 'partial' ? 'AI-assisted' : 'Manual';
+                console.log(`    ${label}: ${count}`);
+            }
+            console.log('');
+        }
+        catch (error) {
+            spinner.fail('Finalize failed');
+            logger.error(error instanceof Error ? error.message : 'Unknown error');
+            process.exit(1);
+        }
+    });
+    return command;
+}
+/* eslint-enable no-console */
+//# sourceMappingURL=finalize.js.map

package/dist/commands/finalize.js.map

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

package/dist/commands/guide.d.ts

@@ -0,0 +1,12 @@
+import type { BrxmUpgradeConfig } from '../config/index.js';
+/**
+ * Launch the guided upgrade experience.
+ *
+ * Creates an AI client (when an API key is available) and starts
+ * the interactive GuideRunner that walks the user through discovery,
+ * planning, execution, and summary phases.
+ *
+ * @param config - Resolved CLI configuration
+ */
+export declare function runGuide(config: BrxmUpgradeConfig): Promise<void>;
+//# sourceMappingURL=guide.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"guide.d.ts","sourceRoot":"","sources":["../../src/commands/guide.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAI5D;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAevE"}

package/dist/commands/guide.js

@@ -0,0 +1,28 @@
+import { GuideRunner } from '../guide/GuideRunner.js';
+import { createAIClient } from '../ai/index.js';
+import { getApiKey } from '../config/index.js';
+import { DocsClient } from '../docs/index.js';
+/**
+ * Launch the guided upgrade experience.
+ *
+ * Creates an AI client (when an API key is available) and starts
+ * the interactive GuideRunner that walks the user through discovery,
+ * planning, execution, and summary phases.
+ *
+ * @param config - Resolved CLI configuration
+ */
+export async function runGuide(config) {
+    const apiKey = getApiKey(config.ai.provider, config.ai.apiKeyEnv);
+    const ai = apiKey
+        ? createAIClient(config.ai.provider, config.ai.model, apiKey, config.ai.baseUrl)
+        : undefined;
+    const docsClient = ai ? new DocsClient({}, config.output.verbose) : undefined;
+    const manifestOptions = {
+        source: config.upgrade.source,
+        url: config.upgrade.url,
+        localPath: config.upgrade.localPath,
+    };
+    const runner = new GuideRunner(process.cwd(), config, manifestOptions, ai, docsClient);
+    await runner.run();
+}
+//# sourceMappingURL=guide.js.map

package/dist/commands/guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide.js","sourceRoot":"","sources":["../../src/commands/guide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAAyB;IACtD,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;IAClE,MAAM,EAAE,GAAG,MAAM;QACf,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC;QAChF,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,UAAU,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE9E,MAAM,eAAe,GAAwB;QAC3C,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;QAC7B,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG;QACvB,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS;KACpC,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC;IACvF,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;AACrB,CAAC"}

package/dist/commands/index.d.ts

@@ -0,0 +1,6 @@
+import type { Command } from 'commander';
+/**
+ * Register all commands with the CLI program.
+ */
+export declare function registerCommands(program: Command): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CASvD"}

package/dist/commands/index.js

@@ -0,0 +1,22 @@
+import { createDiscoverCommand } from './discover.js';
+import { createPlanCommand } from './plan.js';
+import { createExecuteCommand } from './execute.js';
+import { createFinalizeCommand } from './finalize.js';
+import { createLogChangeCommand } from './log-change.js';
+import { createExportCommand } from './export.js';
+import { createReviewManifestCommand } from './review-manifest.js';
+import { createSetupManifestsCommand } from './setup-manifests.js';
+/**
+ * Register all commands with the CLI program.
+ */
+export function registerCommands(program) {
+    program.addCommand(createDiscoverCommand());
+    program.addCommand(createPlanCommand());
+    program.addCommand(createExecuteCommand());
+    program.addCommand(createLogChangeCommand());
+    program.addCommand(createFinalizeCommand());
+    program.addCommand(createExportCommand());
+    program.addCommand(createReviewManifestCommand());
+    program.addCommand(createSetupManifestsCommand());
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAEnE;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,2BAA2B,EAAE,CAAC,CAAC;IAClD,OAAO,CAAC,UAAU,CAAC,2BAA2B,EAAE,CAAC,CAAC;AACpD,CAAC"}

package/dist/commands/log-change.d.ts

@@ -0,0 +1,14 @@
+import { Command } from 'commander';
+/**
+ * Create the log-change command for scanning change documents and generating
+ * manifest entries via AI.
+ *
+ * The command scans a directory for Markdown change documents, uses AI to
+ * generate structured manifest entries from each document, checks for
+ * conflicts with existing entries, and supports interactive review or
+ * auto-accept mode.
+ *
+ * @returns Configured Commander command instance
+ */
+export declare function createLogChangeCommand(): Command;
+//# sourceMappingURL=log-change.d.ts.map

package/dist/commands/log-change.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-change.d.ts","sourceRoot":"","sources":["../../src/commands/log-change.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqCpC;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAoOhD"}

package/dist/commands/log-change.js

@@ -0,0 +1,243 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+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 { loadUnreleasedManifest, saveManifest } from '../planning/manifest-loader.js';
+import { scanChangeDocuments } from '../capture/change-scanner.js';
+import { generateAndReviewEntry } from '../capture/entry-qa.js';
+import { checkConflict, resolveConflict } from '../capture/conflict-resolver.js';
+import { ReviewFlow } from '../capture/review-flow.js';
+import { getCommandConfig } from '../utils/command-helpers.js';
+/* eslint-disable no-console */
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Get the project root directory for brxm-upgrade (where package.json lives).
+ */
+function getProjectRoot() {
+    return join(__dirname, '..', '..');
+}
+/**
+ * Get the default path to the unreleased manifest.
+ */
+function getDefaultUnreleasedPath() {
+    return join(getProjectRoot(), 'src', 'manifests', 'unreleased.yaml');
+}
+/**
+ * Create the log-change command for scanning change documents and generating
+ * manifest entries via AI.
+ *
+ * The command scans a directory for Markdown change documents, uses AI to
+ * generate structured manifest entries from each document, checks for
+ * conflicts with existing entries, and supports interactive review or
+ * auto-accept mode.
+ *
+ * @returns Configured Commander command instance
+ */
+export function createLogChangeCommand() {
+    const command = new Command('log-change')
+        .description('Scan change documents and generate manifest entries via AI')
+        .option('--changes-dir <path>', 'Path to change documents directory', 'docs/changes')
+        .option('--unreleased <path>', 'Path to unreleased.yaml')
+        .option('--auto-accept', 'Auto-accept all AI-generated entries', 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.fail(`No API key found for ${config.ai.provider}.`);
+                console.log('AI is required for log-change. 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})`);
+            // Resolve paths
+            const changesDir = resolvePath(options.changesDir);
+            const unreleasedPath = options.unreleased ?? getDefaultUnreleasedPath();
+            // Scan change documents
+            spinner.start('Scanning change documents...');
+            const docs = await scanChangeDocuments(changesDir);
+            if (docs.length === 0) {
+                spinner.warn('No change documents found.');
+                console.log(`Looked in: ${changesDir}`);
+                return;
+            }
+            spinner.succeed(`Found ${docs.length} change document(s)`);
+            // Load unreleased manifest
+            spinner.start('Loading unreleased manifest...');
+            let manifest = await loadUnreleasedManifest(unreleasedPath);
+            spinner.succeed(`Unreleased manifest: ${manifest.entries.length} existing entries`);
+            // Process each document through the full QA pipeline
+            const reviewFlow = new ReviewFlow();
+            const summary = {
+                totalScanned: docs.length,
+                accepted: 0,
+                skipped: 0,
+                failed: 0,
+                replaced: 0,
+                addedSeparate: 0,
+            };
+            const failedDocs = [];
+            const qaRecords = [];
+            for (const doc of docs) {
+                console.log('');
+                spinner.start(`Processing ${doc.filename} (generate → critique → validate)...`);
+                try {
+                    const { entries, qaRecord } = await generateAndReviewEntry(doc, aiClient);
+                    qaRecords.push(qaRecord);
+                    const qualityNote = qaRecord.regenerated
+                        ? chalk.cyan(` [regenerated${qaRecord.split ? `, split→${entries.length}` : ''}]`)
+                        : qaRecord.heuristicFixes.length > 0
+                            ? chalk.cyan(` [${qaRecord.heuristicFixes.length} heuristic fix(es)]`)
+                            : '';
+                    spinner.succeed(`${entries.length} entry(ies) generated [quality: ${qaRecord.finalQuality}]${qualityNote}`);
+                    // Check conflict once per doc (before adding any entries from this doc)
+                    const conflict = checkConflict(doc.metadata.jiraTicket, manifest);
+                    if (options.autoAccept) {
+                        if (conflict.hasConflict && doc.metadata.jiraTicket) {
+                            // Remove all old entries for this JIRA, then add all new entries
+                            manifest = {
+                                ...manifest,
+                                entries: [
+                                    ...manifest.entries.filter((e) => e.jira_ticket !== doc.metadata.jiraTicket),
+                                    ...entries,
+                                ],
+                            };
+                            summary.replaced++;
+                            console.log(chalk.green(`  ✓ Auto-replaced with ${entries.length} entry(ies): ${entries.map((e) => e.id).join(', ')}`));
+                        }
+                        else if (conflict.hasConflict && !doc.metadata.jiraTicket) {
+                            console.log(chalk.yellow(`  ⚠ Cannot auto-replace: missing jiraTicket`));
+                            summary.skipped++;
+                        }
+                        else {
+                            manifest = { ...manifest, entries: [...manifest.entries, ...entries] };
+                            summary.accepted += entries.length;
+                            for (const entry of entries) {
+                                console.log(chalk.green(`  ✓ Auto-accepted: ${entry.id}`));
+                            }
+                        }
+                    }
+                    else {
+                        // Interactive: review each entry. First entry gets conflict info;
+                        // subsequent entries from the same doc are treated as new (the first
+                        // entry's replace decision already removed old entries).
+                        for (let i = 0; i < entries.length; i++) {
+                            const entry = entries[i];
+                            const entryConflict = i === 0 ? conflict : { hasConflict: false, existingEntries: [] };
+                            const result = await reviewFlow.reviewEntry(entry, doc, entryConflict);
+                            switch (result.decision) {
+                                case 'accept':
+                                    manifest = { ...manifest, entries: [...manifest.entries, result.entry] };
+                                    summary.accepted++;
+                                    break;
+                                case 'replace':
+                                    if (doc.metadata.jiraTicket) {
+                                        manifest = resolveConflict(manifest, result.entry, doc.metadata.jiraTicket, 'replace');
+                                        summary.replaced++;
+                                    }
+                                    else {
+                                        console.log(chalk.yellow('  ⚠ Cannot replace: missing jiraTicket'));
+                                        summary.skipped++;
+                                    }
+                                    break;
+                                case 'add_separate':
+                                    if (doc.metadata.jiraTicket) {
+                                        manifest = resolveConflict(manifest, result.entry, doc.metadata.jiraTicket, 'add_separate');
+                                        summary.addedSeparate++;
+                                    }
+                                    else {
+                                        console.log(chalk.yellow('  ⚠ Cannot add separate: missing jiraTicket'));
+                                        summary.skipped++;
+                                    }
+                                    break;
+                                case 'skip':
+                                    summary.skipped++;
+                                    break;
+                                case 'edit':
+                                    // edit resolves to accept/replace/add_separate/skip in reviewEntry
+                                    break;
+                            }
+                        }
+                    }
+                }
+                catch (error) {
+                    spinner.fail(`Failed to process ${doc.filename}`);
+                    logger.error(error instanceof Error ? error.message : 'Unknown error');
+                    summary.failed++;
+                    failedDocs.push(doc.filename);
+                }
+            }
+            // Summary
+            const qaRegenerated = qaRecords.filter((r) => r.regenerated).length;
+            const qaSplit = qaRecords.filter((r) => r.split).length;
+            const qaHeuristicFixes = qaRecords.reduce((sum, r) => sum + r.heuristicFixes.length, 0);
+            const qaGood = qaRecords.filter((r) => r.finalQuality === 'good').length;
+            console.log('');
+            console.log(chalk.bold('\u2501'.repeat(60)));
+            console.log(chalk.bold(' Log-Change Summary'));
+            console.log(chalk.bold('\u2501'.repeat(60)));
+            console.log(`  Scanned:         ${summary.totalScanned}`);
+            console.log(`  ${chalk.green('Accepted:')}        ${summary.accepted}`);
+            console.log(`  ${chalk.blue('Replaced:')}        ${summary.replaced}`);
+            console.log(`  ${chalk.blue('Added separate:')}   ${summary.addedSeparate}`);
+            console.log(`  ${chalk.yellow('Skipped:')}         ${summary.skipped}`);
+            const failedColor = summary.failed > 0 ? chalk.red : chalk.gray;
+            console.log(`  ${failedColor('Failed:')}          ${summary.failed}`);
+            console.log('');
+            console.log(chalk.bold(' QA Pipeline'));
+            console.log(chalk.bold('\u2501'.repeat(60)));
+            console.log(`  Critiqued:       ${qaRecords.length}`);
+            console.log(`  ${chalk.green('Passed (good):')}   ${qaGood}`);
+            console.log(`  ${chalk.cyan('Regenerated:')}     ${qaRegenerated}`);
+            console.log(`  ${chalk.cyan('Split:')}           ${qaSplit}`);
+            console.log(`  ${chalk.cyan('Heuristic fixes:')} ${qaHeuristicFixes}`);
+            console.log('');
+            // Save if any changes
+            const totalChanges = summary.accepted + summary.replaced + summary.addedSeparate;
+            if (totalChanges > 0) {
+                spinner.start('Saving unreleased manifest...');
+                await saveManifest(unreleasedPath, manifest);
+                spinner.succeed(`Saved ${manifest.entries.length} entries to unreleased.yaml`);
+            }
+            else {
+                console.log(chalk.yellow('No changes to save.'));
+            }
+            // Hard-fail when any change document failed to produce a manifest
+            // entry. The caller (CI bash wrapper) treats this as a pipeline
+            // failure rather than letting tickets silently disappear from the
+            // manifest. Successful entries are still persisted above so the
+            // operator can inspect partial progress; a re-run after fixing
+            // the prompt or shape can pick them up via idempotence.
+            if (summary.failed > 0) {
+                console.log('');
+                console.log(chalk.red(`ERROR: ${summary.failed} change document(s) failed to produce a manifest entry:`));
+                for (const filename of failedDocs) {
+                    console.log(chalk.red(`  - ${filename}`));
+                }
+                console.log(chalk.red('See the per-doc error messages above for the underlying validation failures.'));
+                process.exit(1);
+            }
+        }
+        catch (error) {
+            spinner.fail('log-change failed');
+            logger.error(error instanceof Error ? error.message : 'Unknown error');
+            process.exit(1);
+        }
+    });
+    return command;
+}
+/* eslint-enable no-console */
+//# sourceMappingURL=log-change.js.map

package/dist/commands/log-change.js.map

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

package/dist/commands/plan.d.ts

@@ -0,0 +1,12 @@
+import { Command } from 'commander';
+/**
+ * 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 declare function createPlanCommand(): Command;
+//# sourceMappingURL=plan.d.ts.map

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

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