@bloomreach/brxm-upgrade 0.1.1

package/dist/planning/manifest-loader.d.ts

@@ -0,0 +1,54 @@
+import type { UpgradeManifest, ManifestLoadOptions } from './types.js';
+/**
+ * Load a single manifest file from disk.
+ *
+ * @param filePath - Absolute path to the manifest file (YAML or JSON)
+ * @returns The parsed and validated upgrade manifest
+ * @throws Error if file doesn't exist, has an unsupported format, or fails validation
+ */
+export declare function loadManifest(filePath: string): Promise<UpgradeManifest>;
+/**
+ * Get list of available manifest versions from a source.
+ * Returns versions sorted in ascending semver order.
+ *
+ * @param options - Options specifying the manifest source (local, bundled, or url)
+ * @returns Array of available version strings in semver order
+ * @throws Error if required options are missing or source directory not found
+ */
+export declare function getAvailableVersions(options: ManifestLoadOptions): Promise<string[]>;
+/**
+ * Load all manifests needed for an upgrade from one version to another.
+ * Returns manifests in ascending version order (oldest first).
+ *
+ * @param fromVersion - The current version to upgrade from
+ * @param toVersion - The target version to upgrade to
+ * @param options - Manifest load options specifying the source
+ * @returns Array of upgrade manifests in version order
+ * @throws Error if versions are invalid, target not found, or downgrade attempted
+ */
+export declare function loadManifestsForUpgrade(fromVersion: string, toVersion: string, options: ManifestLoadOptions): Promise<UpgradeManifest[]>;
+/**
+ * Count total entries across all manifests.
+ *
+ * @param manifests - Array of upgrade manifests to count entries for
+ * @returns Total number of entries across all manifests
+ */
+export declare function countManifestEntries(manifests: UpgradeManifest[]): number;
+/**
+ * Load the unreleased manifest from a file path or the bundled default.
+ *
+ * @param filePath - Optional path to a custom unreleased manifest file.
+ *   If omitted, loads the bundled `unreleased.yaml` from the manifests directory.
+ * @returns The parsed unreleased manifest, or a default empty manifest if the file does not exist
+ */
+export declare function loadUnreleasedManifest(filePath?: string): Promise<UpgradeManifest>;
+/**
+ * Save an upgrade manifest to a YAML file.
+ *
+ * Creates parent directories if they do not exist.
+ *
+ * @param filePath - Absolute path where the manifest should be written
+ * @param manifest - The upgrade manifest to serialize
+ */
+export declare function saveManifest(filePath: string, manifest: UpgradeManifest): Promise<void>;
+//# sourceMappingURL=manifest-loader.d.ts.map

package/dist/planning/manifest-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-loader.d.ts","sourceRoot":"","sources":["../../src/planning/manifest-loader.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAevE;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAmB7E;AAsBD;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBnB;AA0CD;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,eAAe,EAAE,CAAC,CA0D5B;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,MAAM,CAEzE;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAQxF;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB7F"}

package/dist/planning/manifest-loader.js

@@ -0,0 +1,233 @@
+import { readFile, readdir, writeFile, mkdir } from 'node:fs/promises';
+import { join, basename, extname, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import yaml from 'js-yaml';
+import semver from 'semver';
+import { validateManifest } from './manifest-schema.js';
+import { pathExists } from '../utils/index.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Get the path to the bundled manifests directory.
+ * At runtime __dirname is dist/planning/, so we go up one level to dist/manifests/.
+ * The build step copies src/manifests/ into dist/manifests/.
+ */
+function getManifestsDir() {
+    return join(__dirname, '..', 'manifests');
+}
+/**
+ * Load a single manifest file from disk.
+ *
+ * @param filePath - Absolute path to the manifest file (YAML or JSON)
+ * @returns The parsed and validated upgrade manifest
+ * @throws Error if file doesn't exist, has an unsupported format, or fails validation
+ */
+export async function loadManifest(filePath) {
+    if (!(await pathExists(filePath))) {
+        throw new Error(`Manifest file not found: ${filePath}`);
+    }
+    const content = await readFile(filePath, 'utf-8');
+    const ext = extname(filePath).toLowerCase();
+    let manifest;
+    if (ext === '.yaml' || ext === '.yml') {
+        manifest = yaml.load(content);
+    }
+    else if (ext === '.json') {
+        manifest = JSON.parse(content);
+    }
+    else {
+        throw new Error(`Unsupported manifest format: ${ext}`);
+    }
+    validateManifest(manifest);
+    return manifest;
+}
+/**
+ * Extract valid semver version names from a list of filenames.
+ *
+ * @param files - Array of filenames to extract versions from
+ * @returns Array of valid semver version strings
+ */
+function extractVersionsFromFiles(files) {
+    const versions = [];
+    for (const file of files) {
+        const ext = extname(file).toLowerCase();
+        if (ext === '.yaml' || ext === '.yml' || ext === '.json') {
+            const name = basename(file, ext);
+            if (semver.valid(name)) {
+                versions.push(name);
+            }
+        }
+    }
+    return versions;
+}
+/**
+ * Get list of available manifest versions from a source.
+ * Returns versions sorted in ascending semver order.
+ *
+ * @param options - Options specifying the manifest source (local, bundled, or url)
+ * @returns Array of available version strings in semver order
+ * @throws Error if required options are missing or source directory not found
+ */
+export async function getAvailableVersions(options) {
+    let versions = [];
+    if (options.source === 'local') {
+        if (!options.localPath) {
+            throw new Error('localPath required for local manifest source');
+        }
+        if (!(await pathExists(options.localPath))) {
+            throw new Error(`Manifest directory not found: ${options.localPath}`);
+        }
+        const files = await readdir(options.localPath);
+        versions = extractVersionsFromFiles(files);
+    }
+    else if (options.source === 'bundled') {
+        const bundledPath = join(getManifestsDir(), 'released');
+        if (await pathExists(bundledPath)) {
+            const files = await readdir(bundledPath);
+            versions = extractVersionsFromFiles(files);
+        }
+    }
+    return versions.sort((a, b) => semver.compare(a, b));
+}
+/**
+ * Get the path to a manifest file for a specific version.
+ *
+ * @param version - The semver version string
+ * @param options - Manifest load options specifying the source
+ * @returns Absolute path to the manifest file
+ * @throws Error if required options are missing or source type is unsupported
+ */
+/**
+ * Supported manifest file extensions, checked in priority order.
+ */
+const MANIFEST_EXTENSIONS = ['.yaml', '.yml', '.json'];
+/**
+ * Find the manifest file for a version by probing supported extensions.
+ * Falls back to `.yaml` if no file is found (so the caller gets a clear "not found" error).
+ */
+async function resolveManifestFile(dir, version) {
+    for (const ext of MANIFEST_EXTENSIONS) {
+        const candidate = join(dir, `${version}${ext}`);
+        if (await pathExists(candidate)) {
+            return candidate;
+        }
+    }
+    return join(dir, `${version}.yaml`);
+}
+async function getManifestPath(version, options) {
+    if (options.source === 'local') {
+        if (!options.localPath) {
+            throw new Error('localPath required for local manifest source');
+        }
+        return resolveManifestFile(options.localPath, version);
+    }
+    else if (options.source === 'bundled') {
+        return resolveManifestFile(join(getManifestsDir(), 'released'), version);
+    }
+    else {
+        throw new Error(`Unsupported manifest source: ${String(options.source)}`);
+    }
+}
+/**
+ * Load all manifests needed for an upgrade from one version to another.
+ * Returns manifests in ascending version order (oldest first).
+ *
+ * @param fromVersion - The current version to upgrade from
+ * @param toVersion - The target version to upgrade to
+ * @param options - Manifest load options specifying the source
+ * @returns Array of upgrade manifests in version order
+ * @throws Error if versions are invalid, target not found, or downgrade attempted
+ */
+export async function loadManifestsForUpgrade(fromVersion, toVersion, options) {
+    if (!semver.valid(fromVersion)) {
+        throw new Error(`Invalid source version: ${fromVersion}`);
+    }
+    if (!semver.valid(toVersion)) {
+        throw new Error(`Invalid target version: ${toVersion}`);
+    }
+    if (semver.eq(fromVersion, toVersion)) {
+        return [];
+    }
+    if (semver.gt(fromVersion, toVersion)) {
+        throw new Error(`Cannot downgrade from ${fromVersion} to ${toVersion}. Downgrades are not supported.`);
+    }
+    const availableVersions = await getAvailableVersions(options);
+    const upgradePathVersions = availableVersions.filter((v) => semver.gt(v, fromVersion) && semver.lte(v, toVersion));
+    if (!upgradePathVersions.includes(toVersion)) {
+        const hasAnyManifests = availableVersions.length > 0;
+        if (!hasAnyManifests) {
+            throw new Error(`No upgrade manifests found.\n\n` +
+                `  Manifests are distributed separately. To set them up:\n\n` +
+                `    brxm-upgrade setup-manifests\n\n` +
+                `  Or manually:\n` +
+                `    mvn dependency:copy \\\n` +
+                `      -Dartifact=com.bloomreach.xm:brxm-upgrade-manifests:RELEASE:zip \\\n` +
+                `      -DoutputDirectory=.brxm-upgrade/ \\\n` +
+                `      -Dtransitive=false -q\n` +
+                `    unzip .brxm-upgrade/brxm-upgrade-manifests-*.zip \\\n` +
+                `      -d .brxm-upgrade/manifests/\n\n` +
+                `  Then add to .brxmrc:\n` +
+                `    upgrade:\n` +
+                `      source: local\n` +
+                `      localPath: .brxm-upgrade/manifests`);
+        }
+        throw new Error(`Target version ${toVersion} not found in available manifests. ` +
+            `Available versions: ${availableVersions.join(', ')}`);
+    }
+    const manifests = [];
+    for (const version of upgradePathVersions) {
+        const manifestPath = await getManifestPath(version, options);
+        const manifest = await loadManifest(manifestPath);
+        manifests.push(manifest);
+    }
+    return manifests;
+}
+/**
+ * Count total entries across all manifests.
+ *
+ * @param manifests - Array of upgrade manifests to count entries for
+ * @returns Total number of entries across all manifests
+ */
+export function countManifestEntries(manifests) {
+    return manifests.reduce((sum, m) => sum + m.entries.length, 0);
+}
+/**
+ * Load the unreleased manifest from a file path or the bundled default.
+ *
+ * @param filePath - Optional path to a custom unreleased manifest file.
+ *   If omitted, loads the bundled `unreleased.yaml` from the manifests directory.
+ * @returns The parsed unreleased manifest, or a default empty manifest if the file does not exist
+ */
+export async function loadUnreleasedManifest(filePath) {
+    const resolvedPath = filePath ?? join(getManifestsDir(), 'unreleased.yaml');
+    if (!(await pathExists(resolvedPath))) {
+        return { schema_version: '1.0', version: 'unreleased', entries: [] };
+    }
+    return loadManifest(resolvedPath);
+}
+/**
+ * Save an upgrade manifest to a YAML file.
+ *
+ * Creates parent directories if they do not exist.
+ *
+ * @param filePath - Absolute path where the manifest should be written
+ * @param manifest - The upgrade manifest to serialize
+ */
+export async function saveManifest(filePath, manifest) {
+    try {
+        validateManifest(manifest);
+    }
+    catch (error) {
+        throw new Error(`Cannot save invalid manifest: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const dir = dirname(filePath);
+    await mkdir(dir, { recursive: true });
+    const content = yaml.dump(manifest, {
+        lineWidth: 120,
+        noRefs: true,
+        quotingType: '"',
+        forceQuotes: false,
+    });
+    await writeFile(filePath, content, 'utf-8');
+}
+//# sourceMappingURL=manifest-loader.js.map

package/dist/planning/manifest-loader.js.map

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

package/dist/planning/manifest-schema.d.ts

@@ -0,0 +1,41 @@
+import { type ErrorObject } from 'ajv';
+import type { UpgradeManifest } from './types.js';
+/**
+ * Custom error class for manifest validation errors.
+ * Includes detailed error information from the JSON schema validation.
+ */
+export declare class ManifestValidationError extends Error {
+    readonly errors: ErrorObject[] | null | undefined;
+    /**
+     * Creates a new ManifestValidationError.
+     * @param message - Human-readable error message
+     * @param errors - Array of validation errors from Ajv
+     */
+    constructor(message: string, errors: ErrorObject[] | null | undefined);
+}
+/**
+ * Validates a manifest object against the schema.
+ * Uses JSON Schema validation to ensure all required fields are present
+ * and values conform to expected types and constraints.
+ *
+ * @param manifest - The manifest object to validate
+ * @throws ManifestValidationError if validation fails
+ */
+export declare function validateManifest(manifest: unknown): asserts manifest is UpgradeManifest;
+/**
+ * Checks if a value is a valid manifest object.
+ * Non-throwing version of validateManifest for conditional checks.
+ *
+ * @param manifest - The value to check
+ * @returns True if the value is a valid UpgradeManifest, false otherwise
+ */
+export declare function isValidManifest(manifest: unknown): manifest is UpgradeManifest;
+/**
+ * Get detailed validation errors for a manifest.
+ * Returns an empty array if the manifest is valid.
+ *
+ * @param manifest - The manifest object to validate
+ * @returns Array of error message strings, empty if valid
+ */
+export declare function getManifestValidationErrors(manifest: unknown): string[];
+//# sourceMappingURL=manifest-schema.d.ts.map

package/dist/planning/manifest-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-schema.d.ts","sourceRoot":"","sources":["../../src/planning/manifest-schema.ts"],"names":[],"mappings":"AAAA,OAAkB,EAAE,KAAK,WAAW,EAAyB,MAAM,KAAK,CAAC;AAEzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAYlD;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;aAQ9B,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,GAAG,SAAS;IAP1D;;;;OAIG;gBAED,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,GAAG,SAAS;CAK3D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,IAAI,eAAe,CAWvF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,eAAe,CAE9E;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,EAAE,CASvE"}

package/dist/planning/manifest-schema.js

@@ -0,0 +1,71 @@
+import AjvModule from 'ajv';
+import { createRequire } from 'node:module';
+// Handle both ESM default export and CommonJS compatibility
+const Ajv = AjvModule.default ?? AjvModule;
+// Load schema from bundled JSON file using createRequire for ESM compatibility
+const esmRequire = createRequire(import.meta.url);
+const manifestSchema = esmRequire('../manifests/schema.json');
+const ajv = new Ajv({ allErrors: true, verbose: true });
+const validate = ajv.compile(manifestSchema);
+/**
+ * Custom error class for manifest validation errors.
+ * Includes detailed error information from the JSON schema validation.
+ */
+export class ManifestValidationError extends Error {
+    errors;
+    /**
+     * Creates a new ManifestValidationError.
+     * @param message - Human-readable error message
+     * @param errors - Array of validation errors from Ajv
+     */
+    constructor(message, errors) {
+        super(message);
+        this.errors = errors;
+        this.name = 'ManifestValidationError';
+    }
+}
+/**
+ * Validates a manifest object against the schema.
+ * Uses JSON Schema validation to ensure all required fields are present
+ * and values conform to expected types and constraints.
+ *
+ * @param manifest - The manifest object to validate
+ * @throws ManifestValidationError if validation fails
+ */
+export function validateManifest(manifest) {
+    const valid = validate(manifest);
+    if (!valid) {
+        const errorMessages = validate.errors
+            ?.map((e) => `${e.instancePath || 'manifest'} ${e.message ?? 'validation failed'}`)
+            .join('; ');
+        throw new ManifestValidationError(`Invalid manifest: ${errorMessages}`, validate.errors);
+    }
+}
+/**
+ * Checks if a value is a valid manifest object.
+ * Non-throwing version of validateManifest for conditional checks.
+ *
+ * @param manifest - The value to check
+ * @returns True if the value is a valid UpgradeManifest, false otherwise
+ */
+export function isValidManifest(manifest) {
+    return validate(manifest);
+}
+/**
+ * Get detailed validation errors for a manifest.
+ * Returns an empty array if the manifest is valid.
+ *
+ * @param manifest - The manifest object to validate
+ * @returns Array of error message strings, empty if valid
+ */
+export function getManifestValidationErrors(manifest) {
+    validate(manifest);
+    if (!validate.errors) {
+        return [];
+    }
+    return validate.errors.map((e) => {
+        const path = e.instancePath || 'manifest';
+        return `${path}: ${e.message ?? 'validation failed'}`;
+    });
+}
+//# sourceMappingURL=manifest-schema.js.map

package/dist/planning/manifest-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-schema.js","sourceRoot":"","sources":["../../src/planning/manifest-schema.ts"],"names":[],"mappings":"AAAA,OAAO,SAAsD,MAAM,KAAK,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,4DAA4D;AAC5D,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC;AAE3C,+EAA+E;AAC/E,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,cAAc,GAAG,UAAU,CAAC,0BAA0B,CAA4B,CAAC;AAEzF,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AACxD,MAAM,QAAQ,GAAsC,GAAG,CAAC,OAAO,CAAkB,cAAc,CAAC,CAAC;AAEjG;;;GAGG;AACH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAQ9B;IAPlB;;;;OAIG;IACH,YACE,OAAe,EACC,MAAwC;QAExD,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,WAAM,GAAN,MAAM,CAAkC;QAGxD,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAiB;IAChD,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACjC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM;YACnC,EAAE,GAAG,CAAC,CAAC,CAAc,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,YAAY,IAAI,UAAU,IAAI,CAAC,CAAC,OAAO,IAAI,mBAAmB,EAAE,CAAC;aAC/F,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,uBAAuB,CAC/B,qBAAqB,aAAa,EAAE,EACpC,QAAQ,CAAC,MAAM,CAChB,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,QAAiB;IAC/C,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CAAC,QAAiB;IAC3D,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACnB,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAc,EAAE,EAAE;QAC5C,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,IAAI,UAAU,CAAC;QAC1C,OAAO,GAAG,IAAI,KAAK,CAAC,CAAC,OAAO,IAAI,mBAAmB,EAAE,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,12 @@
+import type { VersionOverride } from '../discovery/types.js';
+import type { OverrideClassification } from './types.js';
+/**
+ * Classify customer version overrides against the target version's managed properties.
+ *
+ * @param overrides - Version overrides detected in the customer's project
+ * @param managedProperties - Properties managed by the target brXM parent POM
+ * @param targetVersion - The target brXM version (for display in messages)
+ * @returns Classified overrides with category and recommended action
+ */
+export declare function classifyOverrides(overrides: VersionOverride[], managedProperties: Record<string, string>, targetVersion: string): OverrideClassification[];
+//# sourceMappingURL=override-analyzer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"override-analyzer.d.ts","sourceRoot":"","sources":["../../src/planning/override-analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,eAAe,EAAE,EAC5B,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,aAAa,EAAE,MAAM,GACpB,sBAAsB,EAAE,CAoC1B"}

package/dist/planning/override-analyzer.js

@@ -0,0 +1,42 @@
+/**
+ * Classify customer version overrides against the target version's managed properties.
+ *
+ * @param overrides - Version overrides detected in the customer's project
+ * @param managedProperties - Properties managed by the target brXM parent POM
+ * @param targetVersion - The target brXM version (for display in messages)
+ * @returns Classified overrides with category and recommended action
+ */
+export function classifyOverrides(overrides, managedProperties, targetVersion) {
+    return overrides.map((override) => {
+        const managedVersion = managedProperties[override.property];
+        if (managedVersion === undefined) {
+            return {
+                property: override.property,
+                customerVersion: override.version,
+                file: override.file,
+                category: 'unmanaged',
+                action: `Keep — not managed by brXM ${targetVersion}`,
+            };
+        }
+        if (override.version === managedVersion) {
+            return {
+                property: override.property,
+                customerVersion: override.version,
+                managedVersion,
+                file: override.file,
+                category: 'redundant',
+                action: `Remove — redundant, brXM ${targetVersion} manages the same value`,
+            };
+        }
+        return {
+            property: override.property,
+            customerVersion: override.version,
+            managedVersion,
+            file: override.file,
+            category: 'conflict',
+            action: `Remove — conflicts with brXM ${targetVersion} managed value ${managedVersion}. ` +
+                `If this override was added intentionally (e.g. as a hotfix), verify the fix is included in ${targetVersion} before removing.`,
+        };
+    });
+}
+//# sourceMappingURL=override-analyzer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"override-analyzer.js","sourceRoot":"","sources":["../../src/planning/override-analyzer.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAA4B,EAC5B,iBAAyC,EACzC,aAAqB;IAErB,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;QAChC,MAAM,cAAc,GAAG,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAE5D,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO;gBACL,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,eAAe,EAAE,QAAQ,CAAC,OAAO;gBACjC,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,QAAQ,EAAE,WAAoB;gBAC9B,MAAM,EAAE,8BAA8B,aAAa,EAAE;aACtD,CAAC;QACJ,CAAC;QAED,IAAI,QAAQ,CAAC,OAAO,KAAK,cAAc,EAAE,CAAC;YACxC,OAAO;gBACL,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,eAAe,EAAE,QAAQ,CAAC,OAAO;gBACjC,cAAc;gBACd,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,QAAQ,EAAE,WAAoB;gBAC9B,MAAM,EAAE,4BAA4B,aAAa,yBAAyB;aAC3E,CAAC;QACJ,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,eAAe,EAAE,QAAQ,CAAC,OAAO;YACjC,cAAc;YACd,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,QAAQ,EAAE,UAAmB;YAC7B,MAAM,EACJ,gCAAgC,aAAa,kBAAkB,cAAc,IAAI;gBACjF,8FAA8F,aAAa,mBAAmB;SACjI,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/planning/plan-generator.d.ts

@@ -0,0 +1,15 @@
+import type { EntryMatch, UpgradePlan, OverrideClassification } from './types.js';
+/**
+ * Topologically sort matches by their dependencies.
+ * Uses Kahn's algorithm for topological sorting.
+ * Deduplicates entries by ID before sorting.
+ */
+export declare function orderStepsByDependency(matches: EntryMatch[]): EntryMatch[];
+/**
+ * Generate a complete upgrade plan from matched entries.
+ */
+export declare function generatePlan(matches: EntryMatch[], fromVersion: string, toVersion: string, upgradePathVersions: string[], discoveryFile: string, options?: {
+    includeNonApplicable?: boolean;
+    overrideClassifications?: OverrideClassification[];
+}): UpgradePlan;
+//# sourceMappingURL=plan-generator.d.ts.map

package/dist/planning/plan-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-generator.d.ts","sourceRoot":"","sources":["../../src/planning/plan-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EAGV,WAAW,EACX,sBAAsB,EACvB,MAAM,YAAY,CAAC;AA6BpB;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAkF1E;AA0DD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,UAAU,EAAE,EACrB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,mBAAmB,EAAE,MAAM,EAAE,EAC7B,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;IAAE,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAAC,uBAAuB,CAAC,EAAE,sBAAsB,EAAE,CAAA;CAAE,GAC/F,WAAW,CA2Gb"}