@bloomreach/brxm-upgrade 0.1.1

package/dist/mcp/tools/get-next-step.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Result returned by the get_next_step tool describing the next upgrade step
+ * to be performed by the AI client.
+ */
+export interface NextStepResult {
+    stepNumber: number;
+    totalSteps: number;
+    entryId: string;
+    title: string;
+    type: 'automated' | 'ai_assisted' | 'manual';
+    risk: number;
+    instructions: string;
+    affectedFiles: string[];
+    codeChanges?: string;
+    guidance?: string;
+    documentation?: string;
+    verificationHint: string;
+    manualSteps?: string[];
+    docSearchKeywords?: string[];
+    nextAction: string;
+    completionActions: {
+        markCompleted: {
+            stepId: number;
+            status: 'completed';
+        };
+        markSkipped: {
+            stepId: number;
+            status: 'skipped';
+        };
+    };
+}
+export interface CompletionResult {
+    allStepsComplete: true;
+    platformChanges: Array<{
+        category: string;
+        entries: Array<{
+            id: string;
+            summary: string;
+        }>;
+    }>;
+    verificationCommand: string;
+    nextAction: string;
+}
+/**
+ * Get detailed instructions for the next pending upgrade step.
+ *
+ * Loads the upgrade plan and execution state, then returns the first step
+ * that has not been completed or skipped. Returns null when all steps are done.
+ *
+ * @param projectDir - Root directory of the project being upgraded.
+ * @throws When no upgrade plan exists.
+ */
+export declare function handleGetNextStep(projectDir: string): Promise<NextStepResult | CompletionResult | null>;
+//# sourceMappingURL=get-next-step.d.ts.map

package/dist/mcp/tools/get-next-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-next-step.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/get-next-step.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,GAAG,aAAa,GAAG,QAAQ,CAAC;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE;QACjB,aAAa,EAAE;YACb,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,EAAE,WAAW,CAAC;SACrB,CAAC;QACF,WAAW,EAAE;YACX,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,EAAE,SAAS,CAAC;SACnB,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,IAAI,CAAC;IACvB,eAAe,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IAC9F,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AA8CD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,GAAG,gBAAgB,GAAG,IAAI,CAAC,CAoEnD"}

package/dist/mcp/tools/get-next-step.js

@@ -0,0 +1,110 @@
+import { PhaseManager } from '../../core/phase-manager.js';
+import { buildPlatformChangesPayload } from '../../guide/rendering/platform-changes.js';
+function automationType(step) {
+    switch (step.automatable) {
+        case 'true': return 'automated';
+        case 'partial': return 'ai_assisted';
+        case 'false': return 'manual';
+    }
+}
+function buildInstructions(step) {
+    switch (step.automatable) {
+        case 'true':
+            return `This is an automated step. Apply the following transformation to the affected files: ${step.description}`;
+        case 'partial':
+            return step.analysis ?? step.description;
+        case 'false':
+            return step.manualSteps?.join('\n') ?? step.description;
+    }
+}
+function buildVerificationHint(step) {
+    if (step.type === 'version_bump') {
+        return `Verify the parent POM version is updated to ${step.toVersion ?? 'the target version'}.`;
+    }
+    if (step.type === 'verification_gate') {
+        return 'Run the verification command and confirm no errors.';
+    }
+    if (step.affectedFiles.length > 0) {
+        return `Verify changes in: ${step.affectedFiles.slice(0, 3).join(', ')}${step.affectedFiles.length > 3 ? ` and ${step.affectedFiles.length - 3} more` : ''}`;
+    }
+    return 'Review the changes and verify correctness.';
+}
+function buildNextAction(step) {
+    if (step.type === 'verification_gate' || step.automatable === 'false') {
+        return `Complete the manual instructions for step ${step.stepNumber}. When finished, call complete_step with { stepId: ${step.stepNumber}, status: 'completed' }. If you decide not to do it, call complete_step with { stepId: ${step.stepNumber}, status: 'skipped' }.`;
+    }
+    if (step.automatable === 'partial') {
+        return `Review the AI-assisted guidance for step ${step.stepNumber}, make any needed changes, then call complete_step with { stepId: ${step.stepNumber}, status: 'completed' }. If you want to skip it, call complete_step with { stepId: ${step.stepNumber}, status: 'skipped' }.`;
+    }
+    return `Apply the automated change for step ${step.stepNumber}, verify the result, then call complete_step with { stepId: ${step.stepNumber}, status: 'completed' }. If you want to skip it, call complete_step with { stepId: ${step.stepNumber}, status: 'skipped' }.`;
+}
+/**
+ * Get detailed instructions for the next pending upgrade step.
+ *
+ * Loads the upgrade plan and execution state, then returns the first step
+ * that has not been completed or skipped. Returns null when all steps are done.
+ *
+ * @param projectDir - Root directory of the project being upgraded.
+ * @throws When no upgrade plan exists.
+ */
+export async function handleGetNextStep(projectDir) {
+    const pm = new PhaseManager(projectDir);
+    const plan = await pm.loadPlan();
+    if (!plan) {
+        throw new Error('No upgrade plan found. Call create_upgrade_plan first.');
+    }
+    const state = await pm.loadExecutionState();
+    const done = new Set([
+        ...(state?.completedSteps ?? []),
+        ...(state?.skippedSteps ?? []),
+    ]);
+    const nextStep = plan.steps.find((s) => !done.has(s.stepNumber));
+    if (!nextStep) {
+        const informational = plan.informationalEntries ?? [];
+        if (informational.length > 0) {
+            return {
+                allStepsComplete: true,
+                platformChanges: buildPlatformChangesPayload(informational),
+                verificationCommand: 'mvn dependency:tree',
+                nextAction: 'All actionable steps are complete. Review the platform changes above with the user — these describe internal behavioral changes in the upgraded version. Then optionally run dependency verification.',
+            };
+        }
+        return null;
+    }
+    const result = {
+        stepNumber: nextStep.stepNumber,
+        totalSteps: plan.steps.length,
+        entryId: nextStep.entryId,
+        title: nextStep.description,
+        type: automationType(nextStep),
+        risk: nextStep.riskLevel,
+        instructions: buildInstructions(nextStep),
+        affectedFiles: nextStep.affectedFiles,
+        verificationHint: buildVerificationHint(nextStep),
+        nextAction: buildNextAction(nextStep),
+        completionActions: {
+            markCompleted: {
+                stepId: nextStep.stepNumber,
+                status: 'completed',
+            },
+            markSkipped: {
+                stepId: nextStep.stepNumber,
+                status: 'skipped',
+            },
+        },
+    };
+    if (nextStep.automatable === 'partial' && nextStep.analysis) {
+        result.guidance = nextStep.analysis;
+    }
+    if (nextStep.manualSteps && nextStep.manualSteps.length > 0) {
+        result.manualSteps = nextStep.manualSteps;
+    }
+    if (nextStep.documentationUrl) {
+        result.documentation = nextStep.documentationUrl;
+    }
+    if (nextStep.docSearchKeywords && nextStep.docSearchKeywords.length > 0) {
+        result.docSearchKeywords = nextStep.docSearchKeywords;
+    }
+    return result;
+}
+//# sourceMappingURL=get-next-step.js.map

package/dist/mcp/tools/get-next-step.js.map

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

package/dist/mcp/tools/get-upgrade-status.d.ts

@@ -0,0 +1,25 @@
+import { type UpgradePhase, type UpgradeProgress } from '../../core/phase-manager.js';
+import { type UpgradeTargetSelectionMode } from './upgrade-targets.js';
+export interface UpgradeStatusResult {
+    phase: UpgradePhase;
+    nextAction: string;
+    projectDir: string;
+    versions?: {
+        from: string;
+        to?: string;
+    };
+    progress?: UpgradeProgress;
+    supportedTargetVersions?: string[];
+    latestSupportedVersion?: string;
+    recommendedTargetVersion?: string;
+    targetSelectionMode?: UpgradeTargetSelectionMode;
+    planRequired?: boolean;
+    versionSource?: 'pom.xml';
+}
+/**
+ * Determine the current upgrade status by inspecting state files.
+ * Returns the phase, a suggested next action, and any available version
+ * and progress information.
+ */
+export declare function handleGetUpgradeStatus(projectDir: string): Promise<UpgradeStatusResult>;
+//# sourceMappingURL=get-upgrade-status.d.ts.map

package/dist/mcp/tools/get-upgrade-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-upgrade-status.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/get-upgrade-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,eAAe,EACrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,YAAY,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;IACnC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,mBAAmB,CAAC,EAAE,0BAA0B,CAAC;IACjD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,SAAS,CAAC;CAC3B;AAwBD;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,mBAAmB,CAAC,CAwE9B"}

package/dist/mcp/tools/get-upgrade-status.js

@@ -0,0 +1,79 @@
+import { PhaseManager, } from '../../core/phase-manager.js';
+import { resolveDiscoveryTargetVersion, } from './upgrade-targets.js';
+function buildNextAction(selectionMode, currentVersion, targetVersion, supportedTargetVersions, recommendedTargetVersion) {
+    switch (selectionMode) {
+        case 'none_supported':
+            return `No upgrade plan is needed. The project is already on the latest supported upgrade target ${currentVersion}.`;
+        case 'single_supported_target':
+            return `Only one supported upgrade target is available (${targetVersion}). Call create_upgrade_plan without specifying targetVersion.`;
+        case 'multiple_supported_targets':
+            return `Choose one of the supported target versions (${supportedTargetVersions.join(', ')}) and call create_upgrade_plan. If targetVersion is omitted there, it will default to ${recommendedTargetVersion}.`;
+        case 'explicit_target':
+        case 'persisted_target':
+            return `Call create_upgrade_plan to generate the upgrade plan for target version ${targetVersion}.`;
+        default:
+            return 'Call create_upgrade_plan to generate the upgrade plan.';
+    }
+}
+/**
+ * Determine the current upgrade status by inspecting state files.
+ * Returns the phase, a suggested next action, and any available version
+ * and progress information.
+ */
+export async function handleGetUpgradeStatus(projectDir) {
+    const pm = new PhaseManager(projectDir);
+    const phase = await pm.getPhase();
+    const nextAction = pm.getNextAction(phase);
+    const result = { phase, nextAction, projectDir };
+    // Add version info if discovery exists
+    const discovery = await pm.loadDiscovery();
+    if (discovery) {
+        result.versions = { from: discovery.build.brxmVersion };
+        result.versionSource = 'pom.xml';
+    }
+    const upgradeState = await pm.loadUpgradeState();
+    if (discovery) {
+        try {
+            const targetResolution = await resolveDiscoveryTargetVersion(projectDir, discovery.build.brxmVersion, upgradeState?.targetVersion);
+            result.supportedTargetVersions = targetResolution.supportedTargetVersions;
+            result.latestSupportedVersion = targetResolution.latestSupportedVersion;
+            result.recommendedTargetVersion =
+                targetResolution.recommendedTargetVersion;
+            result.targetSelectionMode = targetResolution.selectionMode;
+            result.planRequired = targetResolution.planRequired;
+            if (targetResolution.selectedTargetVersion && result.versions) {
+                result.versions = {
+                    ...result.versions,
+                    to: targetResolution.selectedTargetVersion,
+                };
+            }
+            if (phase === 'discovered') {
+                result.nextAction = buildNextAction(targetResolution.selectionMode, discovery.build.brxmVersion, targetResolution.selectedTargetVersion, targetResolution.supportedTargetVersions, targetResolution.recommendedTargetVersion);
+            }
+        }
+        catch (error) {
+            if (phase === 'discovered') {
+                result.nextAction =
+                    error instanceof Error
+                        ? error.message
+                        : 'Resolve the supported upgrade target versions before creating a plan.';
+            }
+        }
+    }
+    // Add target version if plan exists
+    const plan = await pm.loadPlan();
+    if (plan) {
+        result.versions = {
+            from: plan.fromVersion,
+            to: plan.toVersion,
+        };
+        result.planRequired = true;
+    }
+    // Add progress if executing
+    const progress = await pm.getProgress();
+    if (progress) {
+        result.progress = progress;
+    }
+    return result;
+}
+//# sourceMappingURL=get-upgrade-status.js.map

package/dist/mcp/tools/get-upgrade-status.js.map

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

package/dist/mcp/tools/upgrade-targets.d.ts

@@ -0,0 +1,19 @@
+import type { ManifestLoadOptions } from '../../planning/types.js';
+export type UpgradeTargetSelectionMode = 'none_supported' | 'single_supported_target' | 'multiple_supported_targets' | 'explicit_target' | 'persisted_target' | 'default_latest_supported';
+export interface UpgradeTargetResolution {
+    availableVersions: string[];
+    supportedTargetVersions: string[];
+    latestSupportedVersion?: string;
+    recommendedTargetVersion?: string;
+    selectedTargetVersion?: string;
+    selectionMode: UpgradeTargetSelectionMode;
+    planRequired: boolean;
+}
+export declare function getSupportedUpgradeTargets(projectDir: string, currentVersion: string, manifestOptions?: ManifestLoadOptions): Promise<Pick<UpgradeTargetResolution, 'availableVersions' | 'supportedTargetVersions' | 'latestSupportedVersion' | 'recommendedTargetVersion'>>;
+export declare function resolveDiscoveryTargetVersion(projectDir: string, currentVersion: string, requestedTargetVersion?: string, manifestOptions?: ManifestLoadOptions): Promise<UpgradeTargetResolution>;
+export declare function resolvePlanningTargetVersion(projectDir: string, currentVersion: string, options?: {
+    requestedTargetVersion?: string;
+    persistedTargetVersion?: string;
+    manifestOptions?: ManifestLoadOptions;
+}): Promise<UpgradeTargetResolution>;
+//# sourceMappingURL=upgrade-targets.d.ts.map

package/dist/mcp/tools/upgrade-targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-targets.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/upgrade-targets.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,MAAM,MAAM,0BAA0B,GAClC,gBAAgB,GAChB,yBAAyB,GACzB,4BAA4B,GAC5B,iBAAiB,GACjB,kBAAkB,GAClB,0BAA0B,CAAC;AAE/B,MAAM,WAAW,uBAAuB;IACtC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,uBAAuB,EAAE,MAAM,EAAE,CAAC;IAClC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,aAAa,EAAE,0BAA0B,CAAC;IAC1C,YAAY,EAAE,OAAO,CAAC;CACvB;AAkCD,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,eAAe,CAAC,EAAE,mBAAmB,GACpC,OAAO,CAAC,IAAI,CACb,uBAAuB,EACrB,mBAAmB,GACnB,yBAAyB,GACzB,wBAAwB,GACxB,0BAA0B,CAC7B,CAAC,CAqBD;AAED,wBAAsB,6BAA6B,CACjD,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,sBAAsB,CAAC,EAAE,MAAM,EAC/B,eAAe,CAAC,EAAE,mBAAmB,GACpC,OAAO,CAAC,uBAAuB,CAAC,CA0DlC;AAED,wBAAsB,4BAA4B,CAChD,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE;IACR,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,eAAe,CAAC,EAAE,mBAAmB,CAAC;CACvC,GACA,OAAO,CAAC,uBAAuB,CAAC,CAkElC"}

package/dist/mcp/tools/upgrade-targets.js

@@ -0,0 +1,132 @@
+import semver from 'semver';
+import { loadConfig } from '../../config/index.js';
+import { getAvailableVersions } from '../../planning/manifest-loader.js';
+async function resolveManifestOptions(projectDir, manifestOptions) {
+    if (manifestOptions) {
+        return manifestOptions;
+    }
+    const config = await loadConfig(projectDir);
+    return {
+        source: config.upgrade.source,
+        url: config.upgrade.url,
+        localPath: config.upgrade.localPath,
+    };
+}
+function buildUnsupportedTargetError(currentVersion, requestedTargetVersion, supportedTargetVersions) {
+    if (supportedTargetVersions.length === 0) {
+        return new Error(`Current version ${currentVersion} is already the latest supported upgrade target. No newer supported versions are available.`);
+    }
+    return new Error(`Version ${requestedTargetVersion} is not a supported upgrade target from ${currentVersion}. Supported target versions: ${supportedTargetVersions.join(', ')}`);
+}
+export async function getSupportedUpgradeTargets(projectDir, currentVersion, manifestOptions) {
+    const options = await resolveManifestOptions(projectDir, manifestOptions);
+    const availableVersions = await getAvailableVersions(options);
+    const supportedTargetVersions = availableVersions.filter((version) => semver.gt(version, currentVersion));
+    const latestSupportedVersion = availableVersions.length > 0
+        ? availableVersions[availableVersions.length - 1]
+        : undefined;
+    const recommendedTargetVersion = supportedTargetVersions.length > 0
+        ? supportedTargetVersions[supportedTargetVersions.length - 1]
+        : undefined;
+    return {
+        availableVersions,
+        supportedTargetVersions,
+        latestSupportedVersion,
+        recommendedTargetVersion,
+    };
+}
+export async function resolveDiscoveryTargetVersion(projectDir, currentVersion, requestedTargetVersion, manifestOptions) {
+    const base = await getSupportedUpgradeTargets(projectDir, currentVersion, manifestOptions);
+    if (requestedTargetVersion) {
+        if (requestedTargetVersion === currentVersion &&
+            base.supportedTargetVersions.length === 0) {
+            return {
+                ...base,
+                selectedTargetVersion: currentVersion,
+                selectionMode: 'none_supported',
+                planRequired: false,
+            };
+        }
+        if (!base.supportedTargetVersions.includes(requestedTargetVersion)) {
+            throw buildUnsupportedTargetError(currentVersion, requestedTargetVersion, base.supportedTargetVersions);
+        }
+        return {
+            ...base,
+            selectedTargetVersion: requestedTargetVersion,
+            selectionMode: 'explicit_target',
+            planRequired: true,
+        };
+    }
+    if (base.supportedTargetVersions.length === 0) {
+        return {
+            ...base,
+            selectedTargetVersion: currentVersion,
+            selectionMode: 'none_supported',
+            planRequired: false,
+        };
+    }
+    if (base.supportedTargetVersions.length === 1) {
+        return {
+            ...base,
+            selectedTargetVersion: base.supportedTargetVersions[0],
+            selectionMode: 'single_supported_target',
+            planRequired: true,
+        };
+    }
+    return {
+        ...base,
+        selectionMode: 'multiple_supported_targets',
+        planRequired: true,
+    };
+}
+export async function resolvePlanningTargetVersion(projectDir, currentVersion, options) {
+    const base = await getSupportedUpgradeTargets(projectDir, currentVersion, options?.manifestOptions);
+    const requestedTargetVersion = options?.requestedTargetVersion ?? options?.persistedTargetVersion;
+    if (requestedTargetVersion) {
+        if (requestedTargetVersion === currentVersion &&
+            base.supportedTargetVersions.length === 0) {
+            return {
+                ...base,
+                selectedTargetVersion: currentVersion,
+                selectionMode: options?.requestedTargetVersion
+                    ? 'explicit_target'
+                    : 'persisted_target',
+                planRequired: false,
+            };
+        }
+        if (!base.supportedTargetVersions.includes(requestedTargetVersion)) {
+            throw buildUnsupportedTargetError(currentVersion, requestedTargetVersion, base.supportedTargetVersions);
+        }
+        return {
+            ...base,
+            selectedTargetVersion: requestedTargetVersion,
+            selectionMode: options?.requestedTargetVersion
+                ? 'explicit_target'
+                : 'persisted_target',
+            planRequired: true,
+        };
+    }
+    if (base.supportedTargetVersions.length === 0) {
+        return {
+            ...base,
+            selectedTargetVersion: currentVersion,
+            selectionMode: 'none_supported',
+            planRequired: false,
+        };
+    }
+    if (base.supportedTargetVersions.length === 1) {
+        return {
+            ...base,
+            selectedTargetVersion: base.supportedTargetVersions[0],
+            selectionMode: 'single_supported_target',
+            planRequired: true,
+        };
+    }
+    return {
+        ...base,
+        selectedTargetVersion: base.recommendedTargetVersion,
+        selectionMode: 'default_latest_supported',
+        planRequired: true,
+    };
+}
+//# sourceMappingURL=upgrade-targets.js.map

package/dist/mcp/tools/upgrade-targets.js.map

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

package/dist/planning/ai-analyzer.d.ts

@@ -0,0 +1,20 @@
+import type { ManifestEntry } from './types.js';
+import type { ProjectContext } from '../discovery/types.js';
+import type { AIClient } from '../ai/types.js';
+import type { DocsClient } from '../docs/docs-client.js';
+/**
+ * Create an analysis prompt for a manifest entry.
+ */
+export declare function createAnalysisPrompt(entry: ManifestEntry, context: ProjectContext, affectedFiles: string[], docSnippets?: string[]): string;
+/**
+ * Analyze a manifest entry using AI.
+ */
+export declare function analyzeEntryWithAI(entry: ManifestEntry, context: ProjectContext, affectedFiles: string[], aiClient: AIClient, docsClient?: DocsClient): Promise<string | null>;
+/**
+ * Analyze multiple entries with AI.
+ */
+export declare function analyzeEntriesWithAI(entries: Array<{
+    entry: ManifestEntry;
+    affectedFiles: string[];
+}>, context: ProjectContext, aiClient: AIClient, onProgress?: (completed: number, total: number) => void, docsClient?: DocsClient): Promise<Map<string, string>>;
+//# sourceMappingURL=ai-analyzer.d.ts.map

package/dist/planning/ai-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-analyzer.d.ts","sourceRoot":"","sources":["../../src/planning/ai-analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAOzD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,cAAc,EACvB,aAAa,EAAE,MAAM,EAAE,EACvB,WAAW,CAAC,EAAE,MAAM,EAAE,GACrB,MAAM,CAmCR;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,cAAc,EACvB,aAAa,EAAE,MAAM,EAAE,EACvB,QAAQ,EAAE,QAAQ,EAClB,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgCxB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,aAAa,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,EACjE,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,QAAQ,EAClB,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,EACvD,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA4B9B"}

package/dist/planning/ai-analyzer.js

@@ -0,0 +1,97 @@
+import { DocsContext } from '../docs/docs-context.js';
+import { createLogger } from '../utils/logger.js';
+import { sanitizeError } from '../utils/error.js';
+const logger = createLogger({ prefix: 'ai-analyzer' });
+/**
+ * Create an analysis prompt for a manifest entry.
+ */
+export function createAnalysisPrompt(entry, context, affectedFiles, docSnippets) {
+    const filesSection = affectedFiles.length > 0
+        ? `\n## Affected Files\n${affectedFiles.slice(0, 20).map((f) => `- ${f}`).join('\n')}${affectedFiles.length > 20 ? `\n... and ${affectedFiles.length - 20} more` : ''}`
+        : '\n## Affected Files\nNo specific files detected.';
+    const docsSection = docSnippets && docSnippets.length > 0
+        ? `\n## Relevant Documentation\n${docSnippets.join('\n\n')}`
+        : '';
+    return `# brXM Upgrade Analysis Request
+
+## Change Information
+- **ID**: ${entry.id}
+- **Description**: ${entry.description}
+- **Type**: ${entry.type}
+- **Automation Level**: ${entry.automatable}
+
+## Project Context
+- **Current brXM Version**: ${context.build.brxmVersion}
+- **Total Java Files**: ${context.build.totalJavaFiles}
+- **Module Count**: ${context.build.moduleCount}
+${filesSection}
+
+## AI Guidance
+${entry.ai_guidance || 'No specific guidance provided.'}
+${docsSection}
+
+## Your Task
+Analyze this change in the context of this project and provide:
+1. **Impact Assessment**: What will this change affect in this specific project?
+2. **Recommended Approach**: How should this migration be performed?
+3. **Potential Risks**: What could go wrong and how to mitigate?
+4. **Validation Steps**: How to verify the migration was successful?
+
+Please be specific to this project's structure and provide actionable guidance.`;
+}
+/**
+ * Analyze a manifest entry using AI.
+ */
+export async function analyzeEntryWithAI(entry, context, affectedFiles, aiClient, docsClient) {
+    if (!aiClient.isConfigured()) {
+        return null;
+    }
+    let docSnippets;
+    if (docsClient?.isDynamicSearchEnabled) {
+        try {
+            const query = DocsContext.buildSearchQuery(entry);
+            const results = await docsClient.search(query);
+            docSnippets = results
+                .filter((r) => r.snippet)
+                .map((r) => `- [${r.title}](${r.url}): ${r.snippet}`);
+        }
+        catch {
+            logger.debug(`Doc search failed for ${entry.id}, continuing without docs`);
+        }
+    }
+    const prompt = createAnalysisPrompt(entry, context, affectedFiles, docSnippets);
+    try {
+        const result = await aiClient.generate(prompt, {
+            maxTokens: 2000,
+            temperature: 0.3,
+            system: `You are a brXM upgrade assistant. You help developers migrate their Bloomreach Experience Manager projects between versions. Be specific, actionable, and focus on the particular project context provided.`,
+        });
+        return result.text;
+    }
+    catch (error) {
+        logger.warn(`AI analysis failed for ${entry.id}: ${sanitizeError(error)}`);
+        return null;
+    }
+}
+/**
+ * Analyze multiple entries with AI.
+ */
+export async function analyzeEntriesWithAI(entries, context, aiClient, onProgress, docsClient) {
+    const results = new Map();
+    if (!aiClient.isConfigured()) {
+        return results;
+    }
+    for (let i = 0; i < entries.length; i++) {
+        const { entry, affectedFiles } = entries[i];
+        // Only analyze partial entries (they have ai_guidance)
+        if (entry.automatable === 'partial') {
+            const analysis = await analyzeEntryWithAI(entry, context, affectedFiles, aiClient, docsClient);
+            if (analysis) {
+                results.set(entry.id, analysis);
+            }
+        }
+        onProgress?.(i + 1, entries.length);
+    }
+    return results;
+}
+//# sourceMappingURL=ai-analyzer.js.map

package/dist/planning/ai-analyzer.js.map

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

package/dist/planning/index.d.ts

@@ -0,0 +1,8 @@
+export type { AutomationLevel, ManifestEntryType, TransformPattern, ManifestEntry, UpgradeManifest, EntryMatch, PlanStepStatus, PlanStep, PlanSummary, UpgradePlan, PlanOptions, ManifestSourceType, ManifestLoadOptions, OverrideClassification, } from './types.js';
+export { loadManifest, loadManifestsForUpgrade, getAvailableVersions, countManifestEntries, loadUnreleasedManifest, saveManifest, } from './manifest-loader.js';
+export { validateManifest, isValidManifest, getManifestValidationErrors, ManifestValidationError, } from './manifest-schema.js';
+export { matchEntryToProject, matchManifestToProject, matchManifestsToProject, type MatchOptions, } from './project-matcher.js';
+export { generatePlan, orderStepsByDependency, } from './plan-generator.js';
+export { classifyOverrides, } from './override-analyzer.js';
+export { analyzeEntryWithAI, analyzeEntriesWithAI, createAnalysisPrompt, } from './ai-analyzer.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/planning/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,UAAU,EACV,cAAc,EACd,QAAQ,EACR,WAAW,EACX,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,GACb,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,KAAK,YAAY,GAClB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,YAAY,EACZ,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC"}

package/dist/planning/index.js

@@ -0,0 +1,13 @@
+// Manifest loading
+export { loadManifest, loadManifestsForUpgrade, getAvailableVersions, countManifestEntries, loadUnreleasedManifest, saveManifest, } from './manifest-loader.js';
+// Manifest validation
+export { validateManifest, isValidManifest, getManifestValidationErrors, ManifestValidationError, } from './manifest-schema.js';
+// Project matching
+export { matchEntryToProject, matchManifestToProject, matchManifestsToProject, } from './project-matcher.js';
+// Plan generation
+export { generatePlan, orderStepsByDependency, } from './plan-generator.js';
+// Override analysis
+export { classifyOverrides, } from './override-analyzer.js';
+// AI analysis
+export { analyzeEntryWithAI, analyzeEntriesWithAI, createAnalysisPrompt, } from './ai-analyzer.js';
+//# sourceMappingURL=index.js.map

package/dist/planning/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/planning/index.ts"],"names":[],"mappings":"AAkBA,mBAAmB;AACnB,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,GACb,MAAM,sBAAsB,CAAC;AAE9B,sBAAsB;AACtB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAE9B,mBAAmB;AACnB,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,GAExB,MAAM,sBAAsB,CAAC;AAE9B,kBAAkB;AAClB,OAAO,EACL,YAAY,EACZ,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAE7B,oBAAoB;AACpB,OAAO,EACL,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC,cAAc;AACd,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC"}