@bloomreach/brxm-upgrade 0.1.1

package/dist/index.js

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { createRequire } from 'node:module';
+import { loadConfig } from './config/index.js';
+import { registerCommands } from './commands/index.js';
+import { createLogger } from './utils/logger.js';
+import { getParentConfig } from './utils/command-helpers.js';
+import { getSupportedProviders, isProviderSupported } from './ai/index.js';
+const require = createRequire(import.meta.url);
+const { version: VERSION } = require('../package.json');
+/**
+ * Extract typed options from Commander's OptionValues.
+ * Commander returns Record<string, any> so we need to extract with type guards.
+ */
+function getCliOptions(opts) {
+    return {
+        config: typeof opts['config'] === 'string' ? opts['config'] : undefined,
+        verbose: typeof opts['verbose'] === 'boolean' ? opts['verbose'] : undefined,
+        color: typeof opts['color'] === 'boolean' ? opts['color'] : undefined,
+        provider: typeof opts['provider'] === 'string' ? opts['provider'] : undefined,
+        model: typeof opts['model'] === 'string' ? opts['model'] : undefined,
+        _config: opts['_config'],
+    };
+}
+/**
+ * Main CLI application.
+ */
+async function main() {
+    const program = new Command();
+    program
+        .name('brxm-upgrade')
+        .description('AI-powered CLI tool for brXM version upgrades')
+        .version(VERSION, '-v, --version', 'Display version number')
+        .option('-c, --config <path>', 'Path to configuration file')
+        .option('--verbose', 'Enable verbose output')
+        .option('--no-color', 'Disable colored output')
+        .option('--provider <provider>', `AI provider to use (${getSupportedProviders().join(', ')})`)
+        .option('--model <model>', 'AI model to use')
+        .hook('preAction', async (thisCommand) => {
+        // Load configuration before any command runs
+        const opts = getCliOptions(thisCommand.opts());
+        try {
+            const config = await loadConfig(opts.config);
+            // Apply CLI overrides
+            if (opts.verbose !== undefined) {
+                config.output.verbose = opts.verbose;
+            }
+            if (opts.color !== undefined) {
+                config.output.color = opts.color;
+            }
+            if (opts.provider) {
+                if (!isProviderSupported(opts.provider)) {
+                    throw new Error(`Unsupported AI provider: ${opts.provider}. Supported: ${getSupportedProviders().join(', ')}`);
+                }
+                config.ai.provider = opts.provider;
+            }
+            if (opts.model) {
+                config.ai.model = opts.model;
+            }
+            // Store config on command for subcommands to access
+            thisCommand.setOptionValue('_config', config);
+        }
+        catch (error) {
+            const logger = createLogger({ color: opts.color ?? true });
+            logger.error(`Failed to load configuration: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            process.exit(1);
+        }
+    });
+    // Register all commands
+    registerCommands(program);
+    // Default action: launch the guided upgrade when no subcommand is given
+    program.action(async function () {
+        const opts = getCliOptions(this.opts());
+        const config = opts._config;
+        if (!config) {
+            const logger = createLogger({ color: opts.color ?? true });
+            logger.error('Configuration not loaded');
+            process.exit(1);
+        }
+        const { runGuide } = await import('./commands/guide.js');
+        await runGuide(config);
+    });
+    program
+        .command('info')
+        .description('Display tool information and configuration')
+        .action(function () {
+        const config = getParentConfig(this);
+        // eslint-disable-next-line no-console
+        console.log(chalk.bold('\nbrXM Upgrade Tool\n'));
+        // eslint-disable-next-line no-console
+        console.log(`Version: ${VERSION}`);
+        // eslint-disable-next-line no-console
+        console.log(`Supported AI Providers: ${getSupportedProviders().join(', ')}`);
+        if (config) {
+            // eslint-disable-next-line no-console
+            console.log('\nCurrent Configuration:');
+            // eslint-disable-next-line no-console
+            console.log(`  AI Provider: ${config.ai.provider}`);
+            // eslint-disable-next-line no-console
+            console.log(`  AI Model: ${config.ai.model}`);
+            // eslint-disable-next-line no-console
+            console.log(`  Manifest Source: ${config.upgrade.source}`);
+            // eslint-disable-next-line no-console
+            console.log(`  Verbose: ${String(config.output.verbose)}`);
+            // eslint-disable-next-line no-console
+            console.log(`  Color: ${String(config.output.color)}`);
+        }
+        // eslint-disable-next-line no-console
+        console.log('\nAvailable Commands:');
+        // eslint-disable-next-line no-console
+        console.log('  discover  - Analyze project structure');
+        // eslint-disable-next-line no-console
+        console.log('  plan      - Generate upgrade plan');
+        // eslint-disable-next-line no-console
+        console.log('  execute   - Execute upgrade steps');
+        // eslint-disable-next-line no-console
+        console.log('  log-change - Generate manifest entries from change docs');
+        // eslint-disable-next-line no-console
+        console.log('  finalize  - Promote unreleased entries to a release');
+        // eslint-disable-next-line no-console
+        console.log('  export    - Export plan as markdown for AI/manual use');
+        // eslint-disable-next-line no-console
+        console.log('  info      - Display this information');
+        // eslint-disable-next-line no-console
+        console.log('');
+    });
+    await program.parseAsync(process.argv);
+}
+main().catch((error) => {
+    // Ctrl+C during an inquirer prompt throws ExitPromptError — exit silently
+    if (error instanceof Error && error.name === 'ExitPromptError') {
+        process.exit(130);
+    }
+    console.error(chalk.red('Fatal error:'), error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/manifests/maven-settings.d.ts

@@ -0,0 +1,7 @@
+export interface NexusCredentialsResult {
+    found: boolean;
+    serverId?: string;
+    error?: string;
+}
+export declare function findNexusCredentials(): Promise<NexusCredentialsResult>;
+//# sourceMappingURL=maven-settings.d.ts.map

package/dist/manifests/maven-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maven-settings.d.ts","sourceRoot":"","sources":["../../src/manifests/maven-settings.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AASD,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAyB5E"}

package/dist/manifests/maven-settings.js

@@ -0,0 +1,33 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const KNOWN_SERVER_IDS = [
+    'bloomreach-nexus',
+    'bloomreach',
+    'maven.bloomreach.com',
+    'hippo-maven2',
+];
+export async function findNexusCredentials() {
+    const settingsPath = join(homedir(), '.m2', 'settings.xml');
+    let content;
+    try {
+        content = await readFile(settingsPath, 'utf-8');
+    }
+    catch {
+        return { found: false, error: `Maven settings not found at ${settingsPath}` };
+    }
+    // Lightweight regex — avoids XML parser dependency for a simple ID check
+    const serverIdPattern = /<server>\s*<id>([^<]+)<\/id>/g;
+    const serverIds = [];
+    let match;
+    while ((match = serverIdPattern.exec(content)) !== null) {
+        serverIds.push(match[1].trim());
+    }
+    for (const knownId of KNOWN_SERVER_IDS) {
+        if (serverIds.includes(knownId)) {
+            return { found: true, serverId: knownId };
+        }
+    }
+    return { found: false };
+}
+//# sourceMappingURL=maven-settings.js.map

package/dist/manifests/maven-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"maven-settings.js","sourceRoot":"","sources":["../../src/manifests/maven-settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAQlC,MAAM,gBAAgB,GAAG;IACvB,kBAAkB;IAClB,YAAY;IACZ,sBAAsB;IACtB,cAAc;CACf,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IAE5D,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,+BAA+B,YAAY,EAAE,EAAE,CAAC;IAChF,CAAC;IAED,yEAAyE;IACzE,MAAM,eAAe,GAAG,+BAA+B,CAAC;IACxD,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACxD,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,MAAM,OAAO,IAAI,gBAAgB,EAAE,CAAC;QACvC,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAChC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC"}

package/dist/manifests/parent-properties.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Extract `*.version` properties from the brXM community parent POM at a given git tag.
+ *
+ * Runs `git show <tag>:community/project/pom.xml` in `repoPath`, then scrapes all
+ * `<foo.version>…</foo.version>` elements. Returns an empty object if the tag or
+ * file is unreadable; the caller decides how to handle that.
+ *
+ * @param gitTag - Git tag (e.g., "brxm-16.6.6") to read the POM from
+ * @param repoPath - Working directory for git (usually the repo root)
+ */
+export declare function extractVersionProperties(gitTag: string, repoPath: string): Record<string, string>;
+//# sourceMappingURL=parent-properties.d.ts.map

package/dist/manifests/parent-properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parent-properties.d.ts","sourceRoot":"","sources":["../../src/manifests/parent-properties.ts"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgBjG"}

package/dist/manifests/parent-properties.js

@@ -0,0 +1,28 @@
+import { execFileSync } from 'node:child_process';
+const PARENT_POM_PATH = 'community/project/pom.xml';
+const VERSION_PROPERTY_PATTERN = /<([a-zA-Z0-9.-]+\.version)>([^<]+)<\/\1>/g;
+/**
+ * Extract `*.version` properties from the brXM community parent POM at a given git tag.
+ *
+ * Runs `git show <tag>:community/project/pom.xml` in `repoPath`, then scrapes all
+ * `<foo.version>…</foo.version>` elements. Returns an empty object if the tag or
+ * file is unreadable; the caller decides how to handle that.
+ *
+ * @param gitTag - Git tag (e.g., "brxm-16.6.6") to read the POM from
+ * @param repoPath - Working directory for git (usually the repo root)
+ */
+export function extractVersionProperties(gitTag, repoPath) {
+    VERSION_PROPERTY_PATTERN.lastIndex = 0;
+    const pomContent = execFileSync('git', ['show', `${gitTag}:${PARENT_POM_PATH}`], {
+        cwd: repoPath,
+        encoding: 'utf-8',
+        maxBuffer: 10 * 1024 * 1024,
+    });
+    const properties = {};
+    let match;
+    while ((match = VERSION_PROPERTY_PATTERN.exec(pomContent)) !== null) {
+        properties[match[1]] = match[2];
+    }
+    return properties;
+}
+//# sourceMappingURL=parent-properties.js.map

package/dist/manifests/parent-properties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parent-properties.js","sourceRoot":"","sources":["../../src/manifests/parent-properties.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,eAAe,GAAG,2BAA2B,CAAC;AACpD,MAAM,wBAAwB,GAAG,2CAA2C,CAAC;AAE7E;;;;;;;;;GASG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAc,EAAE,QAAgB;IACvE,wBAAwB,CAAC,SAAS,GAAG,CAAC,CAAC;IAEvC,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,GAAG,MAAM,IAAI,eAAe,EAAE,CAAC,EAAE;QAC/E,GAAG,EAAE,QAAQ;QACb,QAAQ,EAAE,OAAO;QACjB,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;KAC5B,CAAC,CAAC;IAEH,MAAM,UAAU,GAA2B,EAAE,CAAC;IAC9C,IAAI,KAAK,CAAC;IACV,OAAO,CAAC,KAAK,GAAG,wBAAwB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACpE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/manifests/schema.json

@@ -0,0 +1,198 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://bloomreach.com/brxm-upgrade/manifest-schema.json",
+  "title": "brXM Upgrade Manifest",
+  "description": "Schema for brXM version upgrade manifests",
+  "type": "object",
+  "required": ["schema_version", "version", "entries"],
+  "properties": {
+    "schema_version": {
+      "type": "string",
+      "description": "Schema version for the manifest format",
+      "pattern": "^\\d+\\.\\d+$"
+    },
+    "version": {
+      "type": "string",
+      "description": "brXM version this manifest is for",
+      "pattern": "^(unreleased|\\d+\\.\\d+\\.\\d+(-.*)?)$"
+    },
+    "release_date": {
+      "type": "string",
+      "description": "Release date in YYYY-MM-DD format",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+    },
+    "managed_properties": {
+      "type": "object",
+      "description": "Version properties managed by the brXM parent POM for this release. Keys are property names (e.g. spring.version), values are version strings.",
+      "additionalProperties": {
+        "type": "string"
+      }
+    },
+    "entries": {
+      "type": "array",
+      "description": "List of changes in this version",
+      "items": {
+        "$ref": "#/definitions/ManifestEntry"
+      }
+    }
+  },
+  "definitions": {
+    "ManifestEntry": {
+      "type": "object",
+      "required": ["id", "description", "type", "automatable"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique identifier for this change",
+          "pattern": "^[a-z0-9-]+$"
+        },
+        "description": {
+          "type": "string",
+          "description": "Human-readable description"
+        },
+        "type": {
+          "type": "string",
+          "enum": [
+            "namespace_migration",
+            "dependency_migration",
+            "maven_update",
+            "configuration_migration",
+            "api_migration",
+            "security_configuration",
+            "repository_migration",
+            "frontend_migration",
+            "verification_gate",
+            "version_bump",
+            "override_resolution"
+          ]
+        },
+        "automatable": {
+          "type": "string",
+          "enum": ["true", "partial", "false"]
+        },
+        "jira_ticket": {
+          "type": "string",
+          "pattern": "^[A-Z]+-\\d+$"
+        },
+        "patterns": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/TransformPattern"
+          }
+        },
+        "file_globs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "detection_patterns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "ai_guidance": {
+          "type": "string"
+        },
+        "manual_steps": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "doc_search_keywords": {
+          "type": "array",
+          "description": "Concise keywords for documentation search (1-8 terms)",
+          "items": {
+            "type": "string"
+          },
+          "minItems": 1,
+          "maxItems": 8
+        },
+        "documentation_url": {
+          "type": "string",
+          "pattern": "^https?://"
+        },
+        "changelog_entry": {
+          "type": "string"
+        },
+        "depends_on": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "risk_level": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 5
+        },
+        "informational": {
+          "type": "boolean",
+          "default": false,
+          "description": "When true, this entry describes an internal platform change requiring no project modifications. Excluded from the guided step flow; included in the post-upgrade Platform Changes Summary."
+        },
+        "changelog_summary": {
+          "type": "string",
+          "description": "One-line plain-language summary for the Platform Changes Summary. Required when informational is true."
+        },
+        "informational_category": {
+          "type": "string",
+          "enum": ["security", "performance", "ui_ux", "internal_cleanup", "configuration"],
+          "description": "Category for grouping in the Platform Changes Summary. Falls back to a mapping from the entry type when not set."
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": { "automatable": { "const": "true" } }
+          },
+          "then": {
+            "required": ["patterns", "file_globs"]
+          }
+        },
+        {
+          "if": {
+            "properties": { "automatable": { "const": "partial" } }
+          },
+          "then": {
+            "required": ["detection_patterns", "ai_guidance"]
+          }
+        },
+        {
+          "if": {
+            "properties": { "automatable": { "const": "false" } }
+          },
+          "then": {
+            "required": ["manual_steps"]
+          }
+        },
+        {
+          "if": {
+            "required": ["informational"],
+            "properties": { "informational": { "const": true } }
+          },
+          "then": {
+            "required": ["changelog_summary"]
+          }
+        }
+      ]
+    },
+    "TransformPattern": {
+      "type": "object",
+      "required": ["match", "replace"],
+      "properties": {
+        "match": {
+          "type": "string"
+        },
+        "replace": {
+          "type": "string"
+        },
+        "isRegex": {
+          "type": "boolean"
+        }
+      }
+    }
+  }
+}

package/dist/manifests/unreleased.yaml

@@ -0,0 +1,3 @@
+schema_version: "1.0"
+version: unreleased
+entries: []

package/dist/mcp/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":""}

package/dist/mcp/index.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from './server.js';
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    process.stderr.write(`brxm-upgrade-mcp: ${error}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,KAAK,IAAI,CAAC,CAAC;IACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/mcp/resources/index.d.ts

@@ -0,0 +1,32 @@
+import type { ProjectContext } from '../../discovery/types.js';
+import type { UpgradePlan, PlanStep } from '../../planning/types.js';
+/**
+ * Read the discovery result from the project's state directory.
+ */
+export declare function readDiscoveryResource(projectDir: string): Promise<ProjectContext | null>;
+/**
+ * Read the upgrade plan from the project's state directory.
+ */
+export declare function readPlanResource(projectDir: string): Promise<UpgradePlan | null>;
+/**
+ * Read a specific step from the upgrade plan by step number.
+ */
+export declare function readStepResource(projectDir: string, stepNumber: number): Promise<PlanStep | null>;
+export interface ProgressStep {
+    stepNumber: number;
+    description: string;
+    status: 'completed' | 'skipped' | 'pending';
+}
+export interface ProgressResource {
+    total: number;
+    completed: number;
+    skipped: number;
+    remaining: number;
+    steps: ProgressStep[];
+}
+/**
+ * Read execution progress, combining plan steps with execution state
+ * to produce a status for each step.
+ */
+export declare function readProgressResource(projectDir: string): Promise<ProgressResource | null>;
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/resources/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAErE;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAGhC;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAG7B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAK1B;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;CAC7C;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CA0BlC"}

package/dist/mcp/resources/index.js

@@ -0,0 +1,55 @@
+import { PhaseManager } from '../../core/phase-manager.js';
+/**
+ * Read the discovery result from the project's state directory.
+ */
+export async function readDiscoveryResource(projectDir) {
+    const pm = new PhaseManager(projectDir);
+    return pm.loadDiscovery();
+}
+/**
+ * Read the upgrade plan from the project's state directory.
+ */
+export async function readPlanResource(projectDir) {
+    const pm = new PhaseManager(projectDir);
+    return pm.loadPlan();
+}
+/**
+ * Read a specific step from the upgrade plan by step number.
+ */
+export async function readStepResource(projectDir, stepNumber) {
+    const pm = new PhaseManager(projectDir);
+    const plan = await pm.loadPlan();
+    if (!plan)
+        return null;
+    return plan.steps.find((s) => s.stepNumber === stepNumber) ?? null;
+}
+/**
+ * Read execution progress, combining plan steps with execution state
+ * to produce a status for each step.
+ */
+export async function readProgressResource(projectDir) {
+    const pm = new PhaseManager(projectDir);
+    const plan = await pm.loadPlan();
+    if (!plan)
+        return null;
+    const state = await pm.loadExecutionState();
+    const completedSet = new Set(state?.completedSteps ?? []);
+    const skippedSet = new Set(state?.skippedSteps ?? []);
+    const steps = plan.steps.map((s) => ({
+        stepNumber: s.stepNumber,
+        description: s.description,
+        status: completedSet.has(s.stepNumber)
+            ? 'completed'
+            : skippedSet.has(s.stepNumber)
+                ? 'skipped'
+                : 'pending',
+    }));
+    return {
+        total: plan.steps.length,
+        completed: completedSet.size,
+        skipped: skippedSet.size,
+        remaining: plan.steps.length - completedSet.size - skippedSet.size,
+        steps,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/mcp/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAI3D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,UAAkB;IAElB,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,UAAU,CAAC,CAAC;IACxC,OAAO,EAAE,CAAC,aAAa,EAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAAkB;IAElB,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,UAAU,CAAC,CAAC;IACxC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAAkB,EAClB,UAAkB;IAElB,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,UAAU,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC;IACjC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,IAAI,IAAI,CAAC;AACrE,CAAC;AAgBD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,UAAkB;IAElB,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,UAAU,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC;IACjC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,kBAAkB,EAAE,CAAC;IAC5C,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,KAAK,EAAE,cAAc,IAAI,EAAE,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,KAAK,EAAE,YAAY,IAAI,EAAE,CAAC,CAAC;IAEtD,MAAM,KAAK,GAAmB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnD,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC;YACpC,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC;gBAC5B,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,SAAS;KAChB,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;QACxB,SAAS,EAAE,YAAY,CAAC,IAAI;QAC5B,OAAO,EAAE,UAAU,CAAC,IAAI;QACxB,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI;QAClE,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,9 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.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 declare function createServer(projectDir?: string): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AActF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CA6M3D"}