@bloomreach/brxm-upgrade 0.1.1

package/dist/utils/fs.js

@@ -0,0 +1,117 @@
+import { readFile, writeFile, access, mkdir, copyFile as fsCopyFile, rm } from 'node:fs/promises';
+import { readFileSync } from 'node:fs';
+import { dirname, resolve, join } from 'node:path';
+import { glob } from 'glob';
+/**
+ * Check if a file or directory exists.
+ */
+export async function pathExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Read a file as UTF-8 text.
+ */
+export async function readTextFile(path) {
+    return readFile(path, 'utf-8');
+}
+/**
+ * Write text content to a file, creating parent directories if needed.
+ */
+export async function writeTextFile(path, content) {
+    const dir = dirname(path);
+    if (!(await pathExists(dir))) {
+        await mkdir(dir, { recursive: true });
+    }
+    await writeFile(path, content, 'utf-8');
+}
+/**
+ * Default directories excluded from file searches to avoid scanning
+ * build output, dependencies, and version control internals.
+ */
+const DEFAULT_IGNORE = [
+    '**/node_modules/**',
+    '**/target/**',
+    '**/.git/**',
+    '**/dist/**',
+    '**/build/**',
+    '**/.brxm-upgrade/**',
+    '**/configuration-verifier-output/**',
+];
+/**
+ * Find files matching a glob pattern.
+ *
+ * @param pattern - Glob pattern to match
+ * @param cwd - Base directory to search from
+ * @param ignore - Additional patterns to exclude (merged with defaults)
+ */
+export async function findFiles(pattern, cwd, ignore) {
+    return glob(pattern, {
+        cwd: cwd ?? process.cwd(),
+        absolute: true,
+        nodir: true,
+        ignore: ignore ? [...DEFAULT_IGNORE, ...ignore] : DEFAULT_IGNORE,
+    });
+}
+/**
+ * Resolve a path relative to the current working directory.
+ */
+export function resolvePath(...paths) {
+    return resolve(process.cwd(), ...paths);
+}
+/**
+ * Join path segments.
+ */
+export function joinPaths(...paths) {
+    return join(...paths);
+}
+/**
+ * Get the output directory for brxm-upgrade files.
+ */
+export function getOutputDir(basePath) {
+    return basePath
+        ? resolve(basePath, '.brxm-upgrade')
+        : resolvePath('.brxm-upgrade');
+}
+/**
+ * Ensure a directory exists, creating it and parents if needed.
+ */
+export async function ensureDir(dirPath) {
+    await mkdir(dirPath, { recursive: true });
+}
+/**
+ * Copy a file from source to destination.
+ */
+export async function copyFile(src, dest) {
+    await fsCopyFile(src, dest);
+}
+/**
+ * Remove a file or directory recursively.
+ */
+export async function removeDir(path) {
+    await rm(path, { recursive: true, force: true });
+}
+/**
+ * Parse a JSON file with runtime validation.
+ * Provides descriptive errors for malformed JSON and invalid data shapes.
+ */
+export function parseJsonFile(filePath, validate) {
+    const content = readFileSync(filePath, 'utf-8');
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch {
+        throw new Error(`Invalid JSON in ${filePath}`);
+    }
+    if (!validate(parsed)) {
+        throw new Error(`Invalid data structure in ${filePath}`);
+    }
+    return parsed;
+}
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,9 @@
+export { createLogger, logger, type Logger, type LoggerOptions } from './logger.js';
+export { createSpinner, type Spinner, type SpinnerOptions } from './spinner.js';
+export { pathExists, readTextFile, writeTextFile, findFiles, resolvePath, joinPaths, getOutputDir, ensureDir, copyFile, removeDir, parseJsonFile, } from './fs.js';
+export { parsePom, extractVersion, extractModules, extractProperties, extractDependencies, extractManagedDependencies, hasBrxmParent, type ParsedPom, type PomDependency, type PomVersionInfo, } from './pom-parser.js';
+export { generateDiff, formatDiffForTerminal, summarizeDiffs, type DiffResult, } from './diff.js';
+export { OutputWriter, type OutputWriterOptions } from './output-writer.js';
+export { getParentConfig } from './command-helpers.js';
+export { sanitizeError } from './error.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EACL,UAAU,EACV,YAAY,EACZ,aAAa,EACb,SAAS,EACT,WAAW,EACX,SAAS,EACT,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,SAAS,EACT,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,QAAQ,EACR,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,0BAA0B,EAC1B,aAAa,EACb,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,KAAK,UAAU,GAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,9 @@
+export { createLogger, logger } from './logger.js';
+export { createSpinner } from './spinner.js';
+export { pathExists, readTextFile, writeTextFile, findFiles, resolvePath, joinPaths, getOutputDir, ensureDir, copyFile, removeDir, parseJsonFile, } from './fs.js';
+export { parsePom, extractVersion, extractModules, extractProperties, extractDependencies, extractManagedDependencies, hasBrxmParent, } from './pom-parser.js';
+export { generateDiff, formatDiffForTerminal, summarizeDiffs, } from './diff.js';
+export { OutputWriter } from './output-writer.js';
+export { getParentConfig } from './command-helpers.js';
+export { sanitizeError } from './error.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,EAAmC,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,aAAa,EAAqC,MAAM,cAAc,CAAC;AAChF,OAAO,EACL,UAAU,EACV,YAAY,EACZ,aAAa,EACb,SAAS,EACT,WAAW,EACX,SAAS,EACT,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,SAAS,EACT,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,QAAQ,EACR,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,0BAA0B,EAC1B,aAAa,GAId,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,cAAc,GAEf,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAA4B,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Options for creating a logger instance.
+ */
+export interface LoggerOptions {
+    /** Enable verbose/debug output */
+    verbose?: boolean;
+    /** Enable colored output */
+    color?: boolean;
+    /** Prefix for all log messages */
+    prefix?: string;
+}
+/**
+ * Logger interface for consistent logging throughout the CLI.
+ */
+export interface Logger {
+    debug: (message: string, ...args: unknown[]) => void;
+    info: (message: string, ...args: unknown[]) => void;
+    warn: (message: string, ...args: unknown[]) => void;
+    error: (message: string, ...args: unknown[]) => void;
+    success: (message: string, ...args: unknown[]) => void;
+}
+/**
+ * Creates a new logger instance with the specified options.
+ *
+ * @param options - Configuration options for the logger
+ * @returns A Logger instance with debug, info, warn, error, and success methods
+ */
+export declare function createLogger(options?: LoggerOptions): Logger;
+/** Default logger instance */
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACrD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpD,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACrD,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACxD;AAUD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,CAgDhE;AAED,8BAA8B;AAC9B,eAAO,MAAM,MAAM,QAAiB,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,62 @@
+import chalk from 'chalk';
+const LOG_SYMBOLS = {
+    debug: '[DEBUG]',
+    info: '[INFO]',
+    warn: '[WARN]',
+    error: '[ERROR]',
+    success: '[OK]',
+};
+/**
+ * Creates a new logger instance with the specified options.
+ *
+ * @param options - Configuration options for the logger
+ * @returns A Logger instance with debug, info, warn, error, and success methods
+ */
+export function createLogger(options = {}) {
+    const { verbose = false, color = true, prefix = '' } = options;
+    const formatMessage = (level, message) => {
+        const symbol = LOG_SYMBOLS[level];
+        const prefixStr = prefix ? `[${prefix}] ` : '';
+        if (!color) {
+            return `${symbol} ${prefixStr}${message}`;
+        }
+        switch (level) {
+            case 'debug':
+                return chalk.gray(`${symbol} ${prefixStr}${message}`);
+            case 'info':
+                return chalk.blue(`${symbol} ${prefixStr}${message}`);
+            case 'warn':
+                return chalk.yellow(`${symbol} ${prefixStr}${message}`);
+            case 'error':
+                return chalk.red(`${symbol} ${prefixStr}${message}`);
+            case 'success':
+                return chalk.green(`${symbol} ${prefixStr}${message}`);
+            default:
+                return `${symbol} ${prefixStr}${message}`;
+        }
+    };
+    /* eslint-disable no-console */
+    return {
+        debug: (message, ...args) => {
+            if (verbose) {
+                console.debug(formatMessage('debug', message), ...args);
+            }
+        },
+        info: (message, ...args) => {
+            console.log(formatMessage('info', message), ...args);
+        },
+        warn: (message, ...args) => {
+            console.warn(formatMessage('warn', message), ...args);
+        },
+        error: (message, ...args) => {
+            console.error(formatMessage('error', message), ...args);
+        },
+        success: (message, ...args) => {
+            console.log(formatMessage('success', message), ...args);
+        },
+    };
+    /* eslint-enable no-console */
+}
+/** Default logger instance */
+export const logger = createLogger();
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AA0B1B,MAAM,WAAW,GAAG;IAClB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,MAAM;CACP,CAAC;AAEX;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,UAAyB,EAAE;IACtD,MAAM,EAAE,OAAO,GAAG,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAE/D,MAAM,aAAa,GAAG,CAAC,KAA2B,EAAE,OAAe,EAAU,EAAE;QAC7E,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAE/C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,GAAG,MAAM,IAAI,SAAS,GAAG,OAAO,EAAE,CAAC;QAC5C,CAAC;QAED,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,OAAO;gBACV,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,SAAS,GAAG,OAAO,EAAE,CAAC,CAAC;YACxD,KAAK,MAAM;gBACT,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,SAAS,GAAG,OAAO,EAAE,CAAC,CAAC;YACxD,KAAK,MAAM;gBACT,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,MAAM,IAAI,SAAS,GAAG,OAAO,EAAE,CAAC,CAAC;YAC1D,KAAK,OAAO;gBACV,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,SAAS,GAAG,OAAO,EAAE,CAAC,CAAC;YACvD,KAAK,SAAS;gBACZ,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,SAAS,GAAG,OAAO,EAAE,CAAC,CAAC;YACzD;gBACE,OAAO,GAAG,MAAM,IAAI,SAAS,GAAG,OAAO,EAAE,CAAC;QAC9C,CAAC;IACH,CAAC,CAAC;IAEF,+BAA+B;IAC/B,OAAO;QACL,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAQ,EAAE;YACnD,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;QACD,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAQ,EAAE;YAClD,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAQ,EAAE;YAClD,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QACxD,CAAC;QACD,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAQ,EAAE;YACnD,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAQ,EAAE;YACrD,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QAC1D,CAAC;KACF,CAAC;IACF,8BAA8B;AAChC,CAAC;AAED,8BAA8B;AAC9B,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC"}

package/dist/utils/output-writer.d.ts

@@ -0,0 +1,26 @@
+export interface OutputWriterOptions {
+    color: boolean;
+    verbose: boolean;
+}
+/**
+ * Structured output utility for CLI display.
+ * Centralises all console.log calls so they can be styled via the color flag.
+ */
+export declare class OutputWriter {
+    private readonly options;
+    constructor(options: OutputWriterOptions);
+    private c;
+    header(text: string): void;
+    section(title: string): void;
+    table(rows: Record<string, string>[]): void;
+    list(items: string[], bullet?: string): void;
+    keyValue(key: string, value: string): void;
+    blank(): void;
+    text(message: string): void;
+    success(message: string): void;
+    warning(message: string): void;
+    error(message: string): void;
+    separator(char?: string, length?: number): void;
+    dim(message: string): void;
+}
+//# sourceMappingURL=output-writer.d.ts.map

package/dist/utils/output-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-writer.d.ts","sourceRoot":"","sources":["../../src/utils/output-writer.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;gBAElC,OAAO,EAAE,mBAAmB;IAIxC,OAAO,CAAC,CAAC;IAIT,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI1B,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI5B,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,IAAI;IAa3C,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,SAAM,GAAG,IAAI;IAMzC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAI1C,KAAK,IAAI,IAAI;IAIb,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B,SAAS,CAAC,IAAI,SAAM,EAAE,MAAM,SAAK,GAAG,IAAI;IAIxC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAG3B"}

package/dist/utils/output-writer.js

@@ -0,0 +1,62 @@
+/* eslint-disable no-console */
+import chalk from 'chalk';
+/**
+ * Structured output utility for CLI display.
+ * Centralises all console.log calls so they can be styled via the color flag.
+ */
+export class OutputWriter {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    c(fn, text) {
+        return this.options.color ? fn(text) : text;
+    }
+    header(text) {
+        console.log(this.c(chalk.bold, text));
+    }
+    section(title) {
+        console.log(this.c(chalk.underline, title));
+    }
+    table(rows) {
+        if (rows.length === 0)
+            return;
+        const keys = Object.keys(rows[0]);
+        const widths = keys.map((k) => Math.max(k.length, ...rows.map((r) => (r[k] ?? '').length)));
+        const header = keys.map((k, i) => k.padEnd(widths[i])).join('  ');
+        console.log(this.c(chalk.bold, header));
+        for (const row of rows) {
+            console.log(keys.map((k, i) => (row[k] ?? '').padEnd(widths[i])).join('  '));
+        }
+    }
+    list(items, bullet = '-') {
+        for (const item of items) {
+            console.log(`  ${bullet} ${item}`);
+        }
+    }
+    keyValue(key, value) {
+        console.log(`${this.c(chalk.cyan, key + ':')} ${value}`);
+    }
+    blank() {
+        console.log('');
+    }
+    text(message) {
+        console.log(message);
+    }
+    success(message) {
+        console.log(this.c(chalk.green, `✓ ${message}`));
+    }
+    warning(message) {
+        console.log(this.c(chalk.yellow, `⚠ ${message}`));
+    }
+    error(message) {
+        console.log(this.c(chalk.red, `✗ ${message}`));
+    }
+    separator(char = '━', length = 60) {
+        console.log(this.c(chalk.bold, char.repeat(length)));
+    }
+    dim(message) {
+        console.log(this.c(chalk.dim, message));
+    }
+}
+//# sourceMappingURL=output-writer.js.map

package/dist/utils/output-writer.js.map

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

package/dist/utils/pom-parser.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Parsed POM structure.
+ */
+export interface ParsedPom {
+    project: {
+        modelVersion?: string;
+        groupId?: string;
+        artifactId?: string;
+        version?: string;
+        packaging?: string;
+        parent?: {
+            groupId?: string;
+            artifactId?: string;
+            version?: string;
+        };
+        properties?: Record<string, string>;
+        modules?: {
+            module?: string | string[];
+        };
+        profiles?: {
+            profile?: PomProfile | PomProfile[];
+        };
+        dependencies?: {
+            dependency?: PomDependency | PomDependency[];
+        };
+        dependencyManagement?: {
+            dependencies?: {
+                dependency?: PomDependency | PomDependency[];
+            };
+        };
+    };
+}
+/**
+ * A Maven build profile, which may declare additional modules.
+ */
+export interface PomProfile {
+    id?: string;
+    modules?: {
+        module?: string | string[];
+    };
+}
+/**
+ * Maven dependency definition.
+ */
+export interface PomDependency {
+    groupId: string;
+    artifactId: string;
+    version?: string;
+    scope?: string;
+    type?: string;
+}
+/**
+ * Extracted version information from a POM.
+ */
+export interface PomVersionInfo {
+    project?: string;
+    parent?: string;
+    parentGroupId?: string;
+    parentArtifactId?: string;
+}
+/**
+ * Parse a POM XML string into a structured object.
+ * @throws Error if XML is invalid
+ */
+export declare function parsePom(xml: string): ParsedPom;
+/**
+ * Extract version information from a parsed POM.
+ */
+export declare function extractVersion(pom: ParsedPom): PomVersionInfo;
+/**
+ * Extract module list from a parsed POM.
+ *
+ * Collects modules declared both at the top level and inside any
+ * {@code <profiles>} blocks (profile-gated modules). Duplicates are
+ * removed so each module path appears only once.
+ */
+export declare function extractModules(pom: ParsedPom): string[];
+/**
+ * Extract properties from a parsed POM.
+ */
+export declare function extractProperties(pom: ParsedPom): Record<string, string>;
+/**
+ * Extract dependencies from a parsed POM.
+ */
+export declare function extractDependencies(pom: ParsedPom): PomDependency[];
+/**
+ * Extract managed dependencies from a parsed POM.
+ */
+export declare function extractManagedDependencies(pom: ParsedPom): PomDependency[];
+/**
+ * Check if a POM has a brXM parent.
+ */
+export declare function hasBrxmParent(pom: ParsedPom): boolean;
+//# sourceMappingURL=pom-parser.d.ts.map

package/dist/utils/pom-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pom-parser.d.ts","sourceRoot":"","sources":["../../src/utils/pom-parser.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE;QACP,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE;YACP,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC;QACF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACpC,OAAO,CAAC,EAAE;YACR,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;SAC5B,CAAC;QACF,QAAQ,CAAC,EAAE;YACT,OAAO,CAAC,EAAE,UAAU,GAAG,UAAU,EAAE,CAAC;SACrC,CAAC;QACF,YAAY,CAAC,EAAE;YACb,UAAU,CAAC,EAAE,aAAa,GAAG,aAAa,EAAE,CAAC;SAC9C,CAAC;QACF,oBAAoB,CAAC,EAAE;YACrB,YAAY,CAAC,EAAE;gBACb,UAAU,CAAC,EAAE,aAAa,GAAG,aAAa,EAAE,CAAC;aAC9C,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;KAC5B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAWD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAY/C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,GAAG,cAAc,CAO7D;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,EAAE,CAoBvD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAcxE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,SAAS,GAAG,aAAa,EAAE,CAMnE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,SAAS,GAAG,aAAa,EAAE,CAM1E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAqBrD"}

package/dist/utils/pom-parser.js

@@ -0,0 +1,120 @@
+import { XMLParser } from 'fast-xml-parser';
+const parser = new XMLParser({
+    ignoreAttributes: false,
+    attributeNamePrefix: '@_',
+    isArray: (name) => {
+        // Force these elements to always be arrays for consistent handling
+        return ['module', 'dependency', 'profile'].includes(name);
+    },
+});
+/**
+ * Parse a POM XML string into a structured object.
+ * @throws Error if XML is invalid
+ */
+export function parsePom(xml) {
+    try {
+        const result = parser.parse(xml);
+        if (!result.project) {
+            throw new Error('Invalid POM: missing <project> element');
+        }
+        return result;
+    }
+    catch (error) {
+        throw new Error(`Failed to parse POM XML: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+/**
+ * Extract version information from a parsed POM.
+ */
+export function extractVersion(pom) {
+    return {
+        project: pom.project.version != null ? String(pom.project.version) : undefined,
+        parent: pom.project.parent?.version != null ? String(pom.project.parent.version) : undefined,
+        parentGroupId: pom.project.parent?.groupId,
+        parentArtifactId: pom.project.parent?.artifactId,
+    };
+}
+/**
+ * Extract module list from a parsed POM.
+ *
+ * Collects modules declared both at the top level and inside any
+ * {@code <profiles>} blocks (profile-gated modules). Duplicates are
+ * removed so each module path appears only once.
+ */
+export function extractModules(pom) {
+    const seen = new Set();
+    const add = (raw) => {
+        if (!raw)
+            return;
+        for (const m of Array.isArray(raw) ? raw : [raw]) {
+            seen.add(m);
+        }
+    };
+    add(pom.project.modules?.module);
+    const profiles = pom.project.profiles?.profile;
+    if (profiles) {
+        for (const profile of Array.isArray(profiles) ? profiles : [profiles]) {
+            add(profile.modules?.module);
+        }
+    }
+    return Array.from(seen);
+}
+/**
+ * Extract properties from a parsed POM.
+ */
+export function extractProperties(pom) {
+    const props = pom.project.properties;
+    if (!props) {
+        return {};
+    }
+    // Convert all values to strings since fast-xml-parser may parse numbers
+    const result = {};
+    for (const [key, value] of Object.entries(props)) {
+        if (value != null && typeof value !== 'object') {
+            result[key] = String(value);
+        }
+    }
+    return result;
+}
+/**
+ * Extract dependencies from a parsed POM.
+ */
+export function extractDependencies(pom) {
+    const deps = pom.project.dependencies?.dependency;
+    if (!deps) {
+        return [];
+    }
+    return Array.isArray(deps) ? deps : [deps];
+}
+/**
+ * Extract managed dependencies from a parsed POM.
+ */
+export function extractManagedDependencies(pom) {
+    const deps = pom.project.dependencyManagement?.dependencies?.dependency;
+    if (!deps) {
+        return [];
+    }
+    return Array.isArray(deps) ? deps : [deps];
+}
+/**
+ * Check if a POM has a brXM parent.
+ */
+export function hasBrxmParent(pom) {
+    const parentGroupId = pom.project.parent?.groupId;
+    const parentArtifactId = pom.project.parent?.artifactId;
+    if (!parentGroupId || !parentArtifactId) {
+        return false;
+    }
+    // Check for known brXM parent POMs (community and enterprise variants)
+    const brxmGroupIds = new Set([
+        'com.bloomreach.xm',
+        'com.onehippo.cms7',
+        'org.onehippo.cms7',
+    ]);
+    const brxmArtifactIds = new Set([
+        'hippo-cms7-release',
+        'hippo-cms7-enterprise-release',
+    ]);
+    return brxmGroupIds.has(parentGroupId) && brxmArtifactIds.has(parentArtifactId);
+}
+//# sourceMappingURL=pom-parser.js.map

package/dist/utils/pom-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pom-parser.js","sourceRoot":"","sources":["../../src/utils/pom-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAkE5C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,gBAAgB,EAAE,KAAK;IACvB,mBAAmB,EAAE,IAAI;IACzB,OAAO,EAAE,CAAC,IAAI,EAAW,EAAE;QACzB,mEAAmE;QACnE,OAAO,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;CACF,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAc,CAAC;QAC9C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,4BAA4B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CACvF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,GAAc;IAC3C,OAAO;QACL,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;QAC9E,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;QAC5F,aAAa,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO;QAC1C,gBAAgB,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU;KACjD,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,GAAc;IAC3C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,MAAM,GAAG,GAAG,CAAC,GAAkC,EAAQ,EAAE;QACvD,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACd,CAAC;IACH,CAAC,CAAC;IAEF,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAEjC,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC/C,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtE,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAc;IAC9C,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC;IACrC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,wEAAwE;IACxE,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC/C,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAc;IAChD,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,UAAU,CAAC;IAClD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,GAAc;IACvD,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,oBAAoB,EAAE,YAAY,EAAE,UAAU,CAAC;IACxE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAc;IAC1C,MAAM,aAAa,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;IAClD,MAAM,gBAAgB,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC;IAExD,IAAI,CAAC,aAAa,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,uEAAuE;IACvE,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;QAC3B,mBAAmB;QACnB,mBAAmB;QACnB,mBAAmB;KACpB,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;QAC9B,oBAAoB;QACpB,+BAA+B;KAChC,CAAC,CAAC;IAEH,OAAO,YAAY,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,eAAe,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAClF,CAAC"}

package/dist/utils/spinner.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Options for creating a spinner.
+ */
+export interface SpinnerOptions {
+    /** Text to display while spinning */
+    text?: string;
+    /** Spinner style */
+    spinner?: 'dots' | 'line' | 'arc';
+    /** Color of the spinner */
+    color?: 'blue' | 'green' | 'yellow' | 'red' | 'cyan';
+}
+/**
+ * Wrapper around ora spinner for consistent progress indication.
+ */
+export interface Spinner {
+    /** Start the spinner */
+    start: (text?: string) => Spinner;
+    /** Stop with success */
+    succeed: (text?: string) => Spinner;
+    /** Stop with failure */
+    fail: (text?: string) => Spinner;
+    /** Stop with warning */
+    warn: (text?: string) => Spinner;
+    /** Stop with info */
+    info: (text?: string) => Spinner;
+    /** Update spinner text */
+    text: (text: string) => Spinner;
+    /** Stop the spinner */
+    stop: () => Spinner;
+}
+/**
+ * Creates a new spinner instance.
+ */
+export declare function createSpinner(options?: SpinnerOptions): Spinner;
+//# sourceMappingURL=spinner.d.ts.map

package/dist/utils/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/utils/spinner.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;IAClC,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,wBAAwB;IACxB,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAClC,wBAAwB;IACxB,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACpC,wBAAwB;IACxB,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACjC,wBAAwB;IACxB,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACjC,qBAAqB;IACrB,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACjC,0BAA0B;IAC1B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAChC,uBAAuB;IACvB,IAAI,EAAE,MAAM,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CA0CnE"}