@bloomreach/brxm-upgrade 0.1.1

package/dist/mcp/server.js

@@ -0,0 +1,162 @@
+import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { handleGetUpgradeStatus } from './tools/get-upgrade-status.js';
+import { handleDiscoverProject } from './tools/discover-project.js';
+import { handleCreateUpgradePlan } from './tools/create-upgrade-plan.js';
+import { handleGetNextStep } from './tools/get-next-step.js';
+import { handleCompleteStep } from './tools/complete-step.js';
+import { readDiscoveryResource, readPlanResource, readStepResource, readProgressResource, } from './resources/index.js';
+/**
+ * Create and configure the brxm-upgrade MCP server with all registered tools.
+ *
+ * @param projectDir - The root directory of the project to upgrade.
+ *   Defaults to the current working directory.
+ */
+export function createServer(projectDir) {
+    const server = new McpServer({
+        name: 'brxm-upgrade',
+        version: '0.1.0',
+    });
+    const cwd = projectDir ?? process.cwd();
+    server.tool('get_upgrade_status', 'Get the current upgrade phase and what to do next. Call this first.', {}, async () => {
+        const result = await handleGetUpgradeStatus(cwd);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    server.tool('discover_project', 'Analyze the project structure, detect the current brXM version from pom.xml, and report the supported upgrade target versions. Run this before creating an upgrade plan.', { targetVersion: z.string().optional().describe('Optional target brXM version. Must be one of the supported newer versions reported by discovery.') }, async ({ targetVersion }) => {
+        try {
+            const result = await handleDiscoverProject(cwd, targetVersion);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [{ type: 'text', text: JSON.stringify({
+                            error: error instanceof Error ? error.message : 'Discovery failed',
+                            nextAction: 'Check that the project directory contains a valid pom.xml',
+                        }) }],
+            };
+        }
+    });
+    server.tool('create_upgrade_plan', 'Generate an upgrade plan based on project discovery. Requires discover_project to be run first. If targetVersion is omitted, the latest supported newer version is used. If no newer supported version exists, this returns that no plan is needed.', {
+        targetVersion: z.string().optional().describe('Optional target brXM version. Must be one of the supported newer versions reported by discovery.'),
+    }, async ({ targetVersion }) => {
+        try {
+            const result = await handleCreateUpgradePlan(cwd, targetVersion);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [{ type: 'text', text: JSON.stringify({
+                            error: error instanceof Error ? error.message : 'Plan generation failed',
+                            nextAction: 'Run discover_project first, then try again',
+                        }) }],
+            };
+        }
+    });
+    server.tool('get_next_step', 'Get detailed instructions for the next pending upgrade step. Returns null when all steps are complete.', {}, async () => {
+        try {
+            const result = await handleGetNextStep(cwd);
+            if (!result) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({
+                                message: 'All upgrade steps are complete.',
+                                nextAction: 'Review your changes and run your build.',
+                            }, null, 2) }],
+                };
+            }
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [{ type: 'text', text: JSON.stringify({
+                            error: error instanceof Error ? error.message : 'Failed to get next step',
+                            nextAction: 'Check upgrade status with get_upgrade_status',
+                        }) }],
+            };
+        }
+    });
+    server.tool('complete_step', 'Mark the current upgrade step as completed or skipped.', {
+        stepId: z.number().describe('Step number to complete'),
+        status: z.enum(['completed', 'skipped']).describe('Whether step was completed or skipped'),
+    }, async (params) => {
+        try {
+            const result = await handleCompleteStep(cwd, params);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [{ type: 'text', text: JSON.stringify({
+                            error: error instanceof Error ? error.message : 'Failed to complete step',
+                            nextAction: 'Check the upgrade status with get_upgrade_status',
+                        }) }],
+            };
+        }
+    });
+    // --- Resources ---
+    server.resource('upgrade-status', 'upgrade://status', { description: 'Current upgrade phase, versions, progress, and next action' }, async () => {
+        const data = await handleGetUpgradeStatus(cwd);
+        return {
+            contents: [{
+                    uri: 'upgrade://status',
+                    text: JSON.stringify(data, null, 2),
+                    mimeType: 'application/json',
+                }],
+        };
+    });
+    server.resource('upgrade-discovery', 'upgrade://discovery', { description: 'Full project context from discovery phase' }, async () => {
+        const data = await readDiscoveryResource(cwd);
+        return {
+            contents: [{
+                    uri: 'upgrade://discovery',
+                    text: data ? JSON.stringify(data, null, 2) : 'No discovery data. Run discover_project first.',
+                    mimeType: 'application/json',
+                }],
+        };
+    });
+    server.resource('upgrade-plan', 'upgrade://plan', { description: 'Complete upgrade plan with all steps' }, async () => {
+        const data = await readPlanResource(cwd);
+        return {
+            contents: [{
+                    uri: 'upgrade://plan',
+                    text: data ? JSON.stringify(data, null, 2) : 'No plan. Run create_upgrade_plan first.',
+                    mimeType: 'application/json',
+                }],
+        };
+    });
+    server.resource('upgrade-progress', 'upgrade://progress', { description: 'Execution progress with step statuses' }, async () => {
+        const data = await readProgressResource(cwd);
+        return {
+            contents: [{
+                    uri: 'upgrade://progress',
+                    text: data ? JSON.stringify(data, null, 2) : 'No progress data.',
+                    mimeType: 'application/json',
+                }],
+        };
+    });
+    server.resource('upgrade-step', new ResourceTemplate('upgrade://plan/steps/{stepId}', { list: undefined }), { description: 'Detailed information about a specific upgrade step' }, async (uri, variables) => {
+        const stepId = parseInt(String(variables.stepId), 10);
+        const data = await readStepResource(cwd, stepId);
+        return {
+            contents: [{
+                    uri: uri.href,
+                    text: data ? JSON.stringify(data, null, 2) : `Step ${stepId} not found.`,
+                    mimeType: 'application/json',
+                }],
+        };
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/tools/complete-step.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Parameters accepted by the complete_step tool.
+ */
+export interface CompleteStepParams {
+    stepId: number;
+    status: 'completed' | 'skipped';
+}
+/**
+ * Result returned after marking a step as completed or skipped.
+ */
+export interface CompleteStepResult {
+    acknowledged: boolean;
+    nextAction: string;
+}
+/**
+ * Mark an upgrade step as completed or skipped.
+ *
+ * Loads (or creates) the execution state, records the step outcome, checks
+ * whether all plan steps are now done, and persists the updated state.
+ *
+ * @param projectDir - Root directory of the project being upgraded.
+ * @param params - Step identifier and completion status.
+ * @throws When no upgrade plan exists.
+ */
+export declare function handleCompleteStep(projectDir: string, params: CompleteStepParams): Promise<CompleteStepResult>;
+//# sourceMappingURL=complete-step.d.ts.map

package/dist/mcp/tools/complete-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complete-step.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/complete-step.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,kBAAkB,CAAC,CAwE7B"}

package/dist/mcp/tools/complete-step.js

@@ -0,0 +1,73 @@
+import { writeTextFile, ensureDir, getOutputDir, joinPaths, } from '../../utils/fs.js';
+import { PhaseManager } from '../../core/phase-manager.js';
+/**
+ * Mark an upgrade step as completed or skipped.
+ *
+ * Loads (or creates) the execution state, records the step outcome, checks
+ * whether all plan steps are now done, and persists the updated state.
+ *
+ * @param projectDir - Root directory of the project being upgraded.
+ * @param params - Step identifier and completion status.
+ * @throws When no upgrade plan exists.
+ */
+export async function handleCompleteStep(projectDir, params) {
+    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 stateDir = getOutputDir(projectDir);
+    const statePath = joinPaths(stateDir, 'execution-state.json');
+    // Validate step exists in plan
+    const stepExists = plan.steps.some((s) => s.stepNumber === params.stepId);
+    if (!stepExists) {
+        throw new Error(`Step ${params.stepId} not found in plan. Valid steps: ${plan.steps.map((s) => s.stepNumber).join(', ')}`);
+    }
+    // Load or create execution state
+    let state;
+    const existingState = await pm.loadExecutionState();
+    if (existingState) {
+        state = existingState;
+    }
+    else {
+        state = {
+            planFile: 'plan.json',
+            planGeneratedAt: plan.generatedAt,
+            currentStep: 1,
+            completedSteps: [],
+            skippedSteps: [],
+            failedSteps: [],
+            startedAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+            isComplete: false,
+        };
+    }
+    // Enforce ordering: can only complete the next pending step
+    const done = new Set([...state.completedSteps, ...state.skippedSteps]);
+    if (done.has(params.stepId)) {
+        throw new Error(`Step ${params.stepId} has already been ${state.completedSteps.includes(params.stepId) ? 'completed' : 'skipped'}.`);
+    }
+    const nextPending = plan.steps.find((s) => !done.has(s.stepNumber));
+    if (nextPending && nextPending.stepNumber !== params.stepId) {
+        throw new Error(`Cannot complete step ${params.stepId} out of order. Next pending step is ${nextPending.stepNumber}. Call get_next_step to see what's next.`);
+    }
+    // Update state based on step outcome
+    if (params.status === 'completed') {
+        state.completedSteps.push(params.stepId);
+    }
+    else {
+        state.skippedSteps.push(params.stepId);
+    }
+    // Check if all steps are done
+    const allDone = new Set([...state.completedSteps, ...state.skippedSteps]);
+    state.isComplete = plan.steps.every((s) => allDone.has(s.stepNumber));
+    state.currentStep = params.stepId + 1;
+    state.updatedAt = new Date().toISOString();
+    // Persist
+    await ensureDir(stateDir);
+    await writeTextFile(statePath, JSON.stringify(state, null, 2));
+    const phase = state.isComplete ? 'completed' : 'executing';
+    const nextAction = pm.getNextAction(phase);
+    return { acknowledged: true, nextAction };
+}
+//# sourceMappingURL=complete-step.js.map

package/dist/mcp/tools/complete-step.js.map

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

package/dist/mcp/tools/create-upgrade-plan.d.ts

@@ -0,0 +1,36 @@
+import type { ManifestLoadOptions } from '../../planning/types.js';
+import { type UpgradeTargetSelectionMode } from './upgrade-targets.js';
+export interface CreatePlanResult {
+    totalSteps: number;
+    breakdown: {
+        automated: number;
+        aiAssisted: number;
+        manual: number;
+    };
+    estimatedRisk: string;
+    summary: string;
+    fromVersion: string;
+    toVersion: string;
+    supportedTargetVersions: string[];
+    latestSupportedVersion?: string;
+    recommendedTargetVersion?: string;
+    targetSelectionMode: UpgradeTargetSelectionMode;
+    planRequired: boolean;
+    informationalCount: number;
+    nextAction: string;
+}
+/**
+ * Generate an upgrade plan based on project discovery data.
+ *
+ * Loads manifests for the detected version range, matches them against the
+ * discovered project structure, generates a step-by-step plan, and persists
+ * the result to `plan.json` in the project's `.brxm-upgrade` directory.
+ *
+ * @param projectDir - Root directory of the project to upgrade.
+ * @param manifestOptions - Options controlling how manifests are loaded.
+ *   Defaults to bundled manifests.
+ * @returns A summary of the generated upgrade plan.
+ * @throws When no discovery data is found (discover_project must run first).
+ */
+export declare function handleCreateUpgradePlan(projectDir: string, targetVersion?: string, manifestOptions?: ManifestLoadOptions): Promise<CreatePlanResult>;
+//# sourceMappingURL=create-upgrade-plan.d.ts.map

package/dist/mcp/tools/create-upgrade-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-upgrade-plan.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/create-upgrade-plan.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAMnE,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB,EAAE,MAAM,EAAE,CAAC;IAClC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,mBAAmB,EAAE,0BAA0B,CAAC;IAChD,YAAY,EAAE,OAAO,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,EACtB,eAAe,CAAC,EAAE,mBAAmB,GACpC,OAAO,CAAC,gBAAgB,CAAC,CAoK3B"}

package/dist/mcp/tools/create-upgrade-plan.js

@@ -0,0 +1,143 @@
+import { rm } from 'node:fs/promises';
+import { pathExists, readTextFile, writeTextFile, ensureDir, getOutputDir, joinPaths, } from '../../utils/fs.js';
+import { loadManifestsForUpgrade } from '../../planning/manifest-loader.js';
+import { matchManifestsToProject } from '../../planning/project-matcher.js';
+import { generatePlan } from '../../planning/plan-generator.js';
+import { analyzeEntriesWithAI } from '../../planning/ai-analyzer.js';
+import { loadConfig, getApiKey } from '../../config/index.js';
+import { createAIClient } from '../../ai/index.js';
+import { DocsClient } from '../../docs/index.js';
+import { loadUpgradeState, saveUpgradeState } from '../../core/upgrade-state.js';
+import { resolvePlanningTargetVersion, } from './upgrade-targets.js';
+/**
+ * Generate an upgrade plan based on project discovery data.
+ *
+ * Loads manifests for the detected version range, matches them against the
+ * discovered project structure, generates a step-by-step plan, and persists
+ * the result to `plan.json` in the project's `.brxm-upgrade` directory.
+ *
+ * @param projectDir - Root directory of the project to upgrade.
+ * @param manifestOptions - Options controlling how manifests are loaded.
+ *   Defaults to bundled manifests.
+ * @returns A summary of the generated upgrade plan.
+ * @throws When no discovery data is found (discover_project must run first).
+ */
+export async function handleCreateUpgradePlan(projectDir, targetVersion, manifestOptions) {
+    let docsClient;
+    try {
+        // Load discovery
+        const stateDir = getOutputDir(projectDir);
+        const discoveryPath = joinPaths(stateDir, 'discovery.json');
+        if (!(await pathExists(discoveryPath))) {
+            throw new Error('No discovery data found. Call discover_project first.');
+        }
+        const discovery = JSON.parse(await readTextFile(discoveryPath));
+        const fromVersion = discovery.build.brxmVersion;
+        // Resolve target version
+        const config = await loadConfig(projectDir);
+        const options = manifestOptions ?? {
+            source: config.upgrade.source,
+            url: config.upgrade.url,
+            localPath: config.upgrade.localPath,
+        };
+        const upgradeState = await loadUpgradeState(projectDir);
+        const targetResolution = await resolvePlanningTargetVersion(projectDir, fromVersion, {
+            requestedTargetVersion: targetVersion,
+            persistedTargetVersion: upgradeState?.targetVersion,
+            manifestOptions: options,
+        });
+        const toVersion = targetResolution.selectedTargetVersion ?? fromVersion;
+        if (!targetResolution.planRequired) {
+            await saveUpgradeState(projectDir, {
+                currentVersion: fromVersion,
+                targetVersion: toVersion,
+            });
+            return {
+                totalSteps: 0,
+                breakdown: {
+                    automated: 0,
+                    aiAssisted: 0,
+                    manual: 0,
+                },
+                estimatedRisk: 'None',
+                summary: `No upgrade plan needed. Project is already on the latest supported upgrade target ${fromVersion}.`,
+                fromVersion,
+                toVersion,
+                supportedTargetVersions: targetResolution.supportedTargetVersions,
+                latestSupportedVersion: targetResolution.latestSupportedVersion,
+                recommendedTargetVersion: targetResolution.recommendedTargetVersion,
+                targetSelectionMode: targetResolution.selectionMode,
+                planRequired: false,
+                informationalCount: 0,
+                nextAction: 'No upgrade plan is needed. Review the discovery results or continue with your usual validation steps.',
+            };
+        }
+        // Load manifests and match to project
+        const manifests = await loadManifestsForUpgrade(fromVersion, toVersion, options);
+        const matches = await matchManifestsToProject(manifests, discovery, {
+            projectRoot: projectDir,
+        });
+        const applicableMatches = matches.filter((match) => match.applies);
+        let aiAnalysisEnabled = false;
+        const partialEntries = applicableMatches.filter((match) => match.entry.automatable === 'partial');
+        if (partialEntries.length > 0) {
+            const apiKey = getApiKey(config.ai.provider, config.ai.apiKeyEnv);
+            if (apiKey) {
+                const aiClient = createAIClient(config.ai.provider, config.ai.model, apiKey, config.ai.baseUrl);
+                docsClient = new DocsClient();
+                const analyses = await analyzeEntriesWithAI(partialEntries.map((match) => ({
+                    entry: match.entry,
+                    affectedFiles: match.affectedFiles,
+                })), discovery, aiClient, undefined, docsClient);
+                for (const match of applicableMatches) {
+                    const analysis = analyses.get(match.entry.id);
+                    if (analysis) {
+                        match.aiAnalysis = analysis;
+                    }
+                }
+                aiAnalysisEnabled = true;
+            }
+        }
+        // Generate plan
+        const plan = generatePlan(applicableMatches, fromVersion, toVersion, manifests.map((manifest) => manifest.version), '.brxm-upgrade/discovery.json');
+        plan.aiAnalysisEnabled = aiAnalysisEnabled;
+        // Persist plan and clear stale execution state from any prior run
+        await ensureDir(stateDir);
+        await writeTextFile(joinPaths(stateDir, 'plan.json'), JSON.stringify(plan, null, 2));
+        await rm(joinPaths(stateDir, 'execution-state.json'), { force: true });
+        await saveUpgradeState(projectDir, {
+            currentVersion: fromVersion,
+            targetVersion: toVersion,
+        });
+        const { summary } = plan;
+        const avgRisk = summary.averageRiskLevel;
+        const riskLabel = avgRisk <= 2 ? 'Low' : avgRisk <= 3.5 ? 'Medium' : 'High';
+        const infoCount = plan.informationalEntries?.length ?? 0;
+        const infoSuffix = infoCount > 0
+            ? ` and ${infoCount} platform change note${infoCount === 1 ? '' : 's'}`
+            : '';
+        return {
+            totalSteps: summary.totalSteps,
+            breakdown: {
+                automated: summary.automatedSteps,
+                aiAssisted: summary.aiAssistedSteps,
+                manual: summary.manualSteps,
+            },
+            estimatedRisk: `${riskLabel} (avg ${avgRisk.toFixed(1)}/5)`,
+            summary: `Upgrade from ${fromVersion} to ${toVersion}: ${summary.totalSteps} steps affecting ${summary.totalFilesAffected} files.`,
+            fromVersion,
+            toVersion,
+            supportedTargetVersions: targetResolution.supportedTargetVersions,
+            latestSupportedVersion: targetResolution.latestSupportedVersion,
+            recommendedTargetVersion: targetResolution.recommendedTargetVersion,
+            targetSelectionMode: targetResolution.selectionMode,
+            planRequired: true,
+            informationalCount: infoCount,
+            nextAction: `Call get_next_step to begin applying ${summary.totalSteps} upgrade step${summary.totalSteps === 1 ? '' : 's'}${infoSuffix}.`,
+        };
+    }
+    finally {
+        await docsClient?.disconnect();
+    }
+}
+//# sourceMappingURL=create-upgrade-plan.js.map

package/dist/mcp/tools/create-upgrade-plan.js.map

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

package/dist/mcp/tools/discover-project.d.ts

@@ -0,0 +1,33 @@
+import { type UpgradeTargetSelectionMode } from './upgrade-targets.js';
+export interface DiscoverProjectResult {
+    currentVersion: string;
+    targetVersion?: string;
+    supportedTargetVersions: string[];
+    latestSupportedVersion?: string;
+    recommendedTargetVersion?: string;
+    targetSelectionMode: UpgradeTargetSelectionMode;
+    modules: Array<{
+        name: string;
+        artifactId: string;
+        javaFiles?: number;
+    }>;
+    javaFileCount: number;
+    highlights: string[];
+    isUpgradeReady: boolean;
+    planRequired: boolean;
+    nextAction: string;
+    versionSource: 'pom.xml';
+}
+/**
+ * Handle the discover_project MCP tool call.
+ *
+ * Runs the full discovery pipeline against the given project directory,
+ * persists the result to `.brxm-upgrade/discovery.json`, and returns
+ * a structured summary for the AI agent.
+ *
+ * @param projectDir - Absolute path to the project root directory
+ * @param targetVersion - Optional target brXM version to upgrade to
+ * @returns Structured discovery result with version, modules, and highlights
+ */
+export declare function handleDiscoverProject(projectDir: string, targetVersion?: string): Promise<DiscoverProjectResult>;
+//# sourceMappingURL=discover-project.d.ts.map

package/dist/mcp/tools/discover-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-project.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/discover-project.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uBAAuB,EAAE,MAAM,EAAE,CAAC;IAClC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,mBAAmB,EAAE,0BAA0B,CAAC;IAChD,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,SAAS,CAAC;CAC1B;AAiDD;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,qBAAqB,CAAC,CA0DhC"}

package/dist/mcp/tools/discover-project.js

@@ -0,0 +1,96 @@
+import { DiscoveryOrchestrator } from '../../discovery/orchestrator.js';
+import { rm } from 'node:fs/promises';
+import { ensureDir, writeTextFile, getOutputDir, joinPaths } from '../../utils/fs.js';
+import { saveUpgradeState } from '../../core/upgrade-state.js';
+import { resolveDiscoveryTargetVersion, } from './upgrade-targets.js';
+function buildHighlights(context) {
+    const highlights = [];
+    highlights.push(`${context.build.moduleCount} Maven modules detected`);
+    highlights.push(`${context.build.totalJavaFiles} Java source files`);
+    if (context.repo.groovyScripts.length > 0) {
+        highlights.push(`${context.repo.groovyScripts.length} Groovy updater scripts found`);
+    }
+    if (context.config.cvReports.length > 0) {
+        highlights.push('Configuration Verifier report present');
+    }
+    if (context.build.overrides.length > 0) {
+        highlights.push(`${context.build.overrides.length} version override(s) detected — will be analyzed during planning`);
+    }
+    if (context.repo.hasBootstrap) {
+        highlights.push(`${context.repo.bootstrapPaths.length} bootstrap configurations`);
+    }
+    if (context.validations.length > 0) {
+        const errors = context.validations.filter((v) => v.severity === 'error').length;
+        const warnings = context.validations.filter((v) => v.severity === 'warning').length;
+        if (errors > 0)
+            highlights.push(`${errors} validation errors`);
+        if (warnings > 0)
+            highlights.push(`${warnings} validation warnings`);
+    }
+    return highlights;
+}
+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':
+            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.';
+    }
+}
+/**
+ * Handle the discover_project MCP tool call.
+ *
+ * Runs the full discovery pipeline against the given project directory,
+ * persists the result to `.brxm-upgrade/discovery.json`, and returns
+ * a structured summary for the AI agent.
+ *
+ * @param projectDir - Absolute path to the project root directory
+ * @param targetVersion - Optional target brXM version to upgrade to
+ * @returns Structured discovery result with version, modules, and highlights
+ */
+export async function handleDiscoverProject(projectDir, targetVersion) {
+    const orchestrator = new DiscoveryOrchestrator();
+    const discoveryResult = await orchestrator.discover(projectDir);
+    if (!discoveryResult.success || !discoveryResult.context) {
+        throw new Error(`Discovery failed: ${discoveryResult.error ?? 'Unknown error'}`);
+    }
+    const context = discoveryResult.context;
+    const targetResolution = await resolveDiscoveryTargetVersion(projectDir, context.build.brxmVersion, targetVersion);
+    // Persist discovery result to state directory
+    const stateDir = getOutputDir(projectDir);
+    await ensureDir(stateDir);
+    await writeTextFile(joinPaths(stateDir, 'discovery.json'), JSON.stringify(context, null, 2));
+    await saveUpgradeState(projectDir, {
+        currentVersion: context.build.brxmVersion,
+        targetVersion: targetResolution.selectedTargetVersion,
+    });
+    // Clear stale plan and execution state from any prior discovery run
+    await rm(joinPaths(stateDir, 'plan.json'), { force: true });
+    await rm(joinPaths(stateDir, 'execution-state.json'), { force: true });
+    return {
+        currentVersion: context.build.brxmVersion,
+        targetVersion: targetResolution.selectedTargetVersion,
+        supportedTargetVersions: targetResolution.supportedTargetVersions,
+        latestSupportedVersion: targetResolution.latestSupportedVersion,
+        recommendedTargetVersion: targetResolution.recommendedTargetVersion,
+        targetSelectionMode: targetResolution.selectionMode,
+        modules: context.build.modules.map((m) => ({
+            name: m.name,
+            artifactId: m.artifactId,
+            javaFiles: m.javaFileCount,
+        })),
+        javaFileCount: context.build.totalJavaFiles,
+        highlights: buildHighlights(context),
+        isUpgradeReady: context.isUpgradeReady,
+        planRequired: targetResolution.planRequired,
+        nextAction: buildNextAction(targetResolution.selectionMode, context.build.brxmVersion, targetResolution.selectedTargetVersion, targetResolution.supportedTargetVersions, targetResolution.recommendedTargetVersion),
+        versionSource: 'pom.xml',
+    };
+}
+//# sourceMappingURL=discover-project.js.map

package/dist/mcp/tools/discover-project.js.map

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