@bloomreach/brxm-upgrade 0.1.1

package/dist/planning/types.d.ts

@@ -0,0 +1,237 @@
+/**
+ * Automation level for a manifest entry.
+ */
+export type AutomationLevel = 'true' | 'partial' | 'false';
+/**
+ * Types of changes that can be in a manifest.
+ */
+export type ManifestEntryType = 'namespace_migration' | 'dependency_migration' | 'maven_update' | 'configuration_migration' | 'api_migration' | 'security_configuration' | 'repository_migration' | 'frontend_migration' | 'version_bump' | 'verification_gate' | 'override_resolution';
+/**
+ * A pattern for automated find/replace transformations.
+ */
+export interface TransformPattern {
+    /** Pattern to match */
+    match: string;
+    /** Replacement string */
+    replace: string;
+    /** Whether this is a regex pattern */
+    isRegex?: boolean;
+}
+/**
+ * A single entry in an upgrade manifest.
+ */
+export interface ManifestEntry {
+    /** Unique identifier for this change */
+    id: string;
+    /** Human-readable description */
+    description: string;
+    /** Type of change */
+    type: ManifestEntryType;
+    /** Automation level: true (fully auto), partial (AI-assisted), false (manual) */
+    automatable: AutomationLevel;
+    /** JIRA ticket reference */
+    jira_ticket?: string;
+    /** Patterns for automated transformation */
+    patterns?: TransformPattern[];
+    /** File globs to apply patterns to */
+    file_globs?: string[];
+    /** Patterns to detect if this change applies */
+    detection_patterns?: string[];
+    /** Guidance for AI to assist with migration */
+    ai_guidance?: string;
+    /** Step-by-step manual instructions */
+    manual_steps?: string[];
+    /** Concise keywords for documentation search (generated during manifest creation) */
+    doc_search_keywords?: string[];
+    /** Link to documentation */
+    documentation_url?: string;
+    /** Entry for changelog generation */
+    changelog_entry?: string;
+    /** Dependencies on other manifest entries */
+    depends_on?: string[];
+    /** Risk level (1-5, higher = more risky) */
+    risk_level?: number;
+    /** When true, entry is informational — excluded from step flow, shown in Platform Changes Summary */
+    informational?: boolean;
+    /** One-line summary for the Platform Changes Summary (required when informational is true) */
+    changelog_summary?: string;
+    /** Category for grouping in the Platform Changes Summary */
+    informational_category?: 'security' | 'performance' | 'ui_ux' | 'internal_cleanup' | 'configuration';
+}
+/**
+ * A version-specific upgrade manifest.
+ */
+export interface UpgradeManifest {
+    /** Schema version for the manifest format */
+    schema_version: string;
+    /** brXM version this manifest is for */
+    version: string;
+    /** Release date (YYYY-MM-DD) */
+    release_date?: string;
+    /** Version properties managed by the brXM parent POM for this release */
+    managed_properties?: Record<string, string>;
+    /** List of changes in this version */
+    entries: ManifestEntry[];
+}
+/**
+ * Classification of a customer version override against a target version's managed properties.
+ */
+export interface OverrideClassification {
+    /** The override property name */
+    property: string;
+    /** The customer's overridden value */
+    customerVersion: string;
+    /** The value managed by the target brXM version (undefined if not managed) */
+    managedVersion?: string;
+    /** The POM file where the override was found */
+    file: string;
+    /** Classification result */
+    category: 'conflict' | 'redundant' | 'unmanaged';
+    /** Human-readable action recommendation */
+    action: string;
+}
+/**
+ * Result of matching a manifest entry to a project.
+ */
+export interface EntryMatch {
+    /** The manifest entry */
+    entry: ManifestEntry;
+    /** Version this entry is from */
+    fromVersion: string;
+    /** Whether this entry applies to the project */
+    applies: boolean;
+    /** Files affected by this entry */
+    affectedFiles: string[];
+    /** Count of affected files */
+    affectedFileCount: number;
+    /** Reason for applying or not applying */
+    reason?: string;
+    /** AI analysis for partial/manual entries */
+    aiAnalysis?: string;
+}
+/**
+ * Status of a planned step.
+ */
+export type PlanStepStatus = 'pending' | 'in_progress' | 'completed' | 'skipped' | 'failed';
+/**
+ * A single step in the upgrade plan.
+ */
+export interface PlanStep {
+    /** Step number (1-indexed) */
+    stepNumber: number;
+    /** Manifest entry ID */
+    entryId: string;
+    /** Source version */
+    fromVersion: string;
+    /** Target version (only set for version_bump steps) */
+    toVersion?: string;
+    /** Entry description */
+    description: string;
+    /** Entry type */
+    type: ManifestEntryType;
+    /** Automation level */
+    automatable: AutomationLevel;
+    /** Files affected */
+    affectedFiles: string[];
+    /** Count of affected files */
+    affectedFileCount: number;
+    /** Execution status */
+    status: PlanStepStatus;
+    /** AI analysis or guidance */
+    analysis?: string;
+    /** Documentation URL */
+    documentationUrl?: string;
+    /** Manual steps (for automatable: false) */
+    manualSteps?: string[];
+    /** Risk level */
+    riskLevel: number;
+    /** Transformation patterns for automated execution */
+    patterns?: TransformPattern[];
+    /** File globs to apply patterns to */
+    fileGlobs?: string[];
+    /** Concise keywords for documentation search */
+    docSearchKeywords?: string[];
+    /** Patterns used by AI executor to detect candidate files by content */
+    detectionPatterns?: string[];
+    /** Additional AI-generated guidance from the manifest */
+    aiGuidance?: string;
+}
+/**
+ * Summary statistics for the upgrade plan.
+ */
+export interface PlanSummary {
+    /** Total number of steps */
+    totalSteps: number;
+    /** Steps that are fully automated */
+    automatedSteps: number;
+    /** Steps that need AI assistance */
+    aiAssistedSteps: number;
+    /** Steps that are manual only */
+    manualSteps: number;
+    /** Total files affected */
+    totalFilesAffected: number;
+    /** Estimated risk level (average) */
+    averageRiskLevel: number;
+}
+/**
+ * The complete upgrade plan.
+ */
+export interface UpgradePlan {
+    /** Plan generation timestamp */
+    generatedAt: string;
+    /** Source brXM version */
+    fromVersion: string;
+    /** Target brXM version */
+    toVersion: string;
+    /** Versions included in upgrade path */
+    upgradePathVersions: string[];
+    /** Summary statistics */
+    summary: PlanSummary;
+    /** Ordered list of steps */
+    steps: PlanStep[];
+    /** Whether AI analysis was used */
+    aiAnalysisEnabled: boolean;
+    /** Discovery context reference */
+    discoveryFile: string;
+    /** Informational entries excluded from the step flow */
+    informationalEntries?: ManifestEntry[];
+}
+/**
+ * Options for generating an upgrade plan.
+ */
+export interface PlanOptions {
+    /** Target version to upgrade to */
+    targetVersion: string;
+    /** Path to discovery.json (defaults to .brxm-upgrade/discovery.json) */
+    discoveryPath?: string;
+    /** Enable AI analysis for partial/manual entries */
+    enableAI?: boolean;
+    /** Skip entries that don't apply */
+    skipNonApplicable?: boolean;
+    /** Output path for plan.json */
+    outputPath?: string;
+    /** Enable verbose output */
+    verbose?: boolean;
+}
+/**
+ * Source for loading manifests.
+ */
+export type ManifestSourceType = 'bundled' | 'url' | 'local';
+/**
+ * Options for loading manifests.
+ */
+export interface ManifestLoadOptions {
+    /** Source type */
+    source: ManifestSourceType;
+    /** URL for remote manifests (when source is 'url') */
+    url?: string;
+    /** Local path for manifests (when source is 'local') */
+    localPath?: string;
+    /** Authentication for remote manifest sources */
+    auth?: {
+        tokenEnv: string;
+    };
+    /** Cache manifests locally */
+    cache?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/planning/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/planning/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/planning/types.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Supported AI providers for the upgrade tool.
+ */
+export type AIProvider = 'anthropic' | 'openai' | 'google';
+/**
+ * Configuration for AI provider connection.
+ */
+export interface AIConfig {
+    /** AI provider to use */
+    provider: AIProvider;
+    /** Model identifier (provider-specific) */
+    model: string;
+    /** Environment variable name for provider credentials (API key or base URL for local providers) */
+    apiKeyEnv: string;
+    /** Optional base URL for self-hosted providers */
+    baseUrl?: string;
+}
+/**
+ * Source for upgrade manifests.
+ */
+export type ManifestSource = 'bundled' | 'url' | 'local';
+/**
+ * Authentication for remote manifest sources.
+ */
+export interface ManifestAuth {
+    /** Environment variable name holding the bearer token */
+    tokenEnv: string;
+}
+/**
+ * Configuration for manifest loading.
+ */
+export interface ManifestConfig {
+    /** Where to load manifests from */
+    source: ManifestSource;
+    /** URL for remote manifests (when source is 'url') */
+    url?: string;
+    /** Local path for manifests (when source is 'local') */
+    localPath?: string;
+    /** Authentication for remote manifest sources */
+    auth?: ManifestAuth;
+}
+/**
+ * Output configuration for the CLI.
+ */
+export interface OutputConfig {
+    /** Enable verbose output */
+    verbose: boolean;
+    /** Enable colored output */
+    color: boolean;
+    /** Path for exported files */
+    exportPath: string;
+}
+/**
+ * Complete configuration for brxm-upgrade tool.
+ */
+export interface BrxmUpgradeConfig {
+    /** AI provider configuration */
+    ai: AIConfig;
+    /** Manifest loading configuration */
+    upgrade: ManifestConfig;
+    /** Output preferences */
+    output: OutputConfig;
+}
+/**
+ * Configuration for the brXM documentation MCP server connection.
+ */
+export interface DocsServerConfig {
+    /** MCP server URL */
+    url: string;
+    /** Whether the docs server integration is enabled */
+    enabled: boolean;
+    /** Whether to perform dynamic documentation search during analysis */
+    dynamicSearch: boolean;
+}
+/**
+ * Log levels for the logger.
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Result of a CLI command execution.
+ */
+export interface CommandResult {
+    /** Whether the command succeeded */
+    success: boolean;
+    /** Optional message for the user */
+    message?: string;
+    /** Optional data returned by the command */
+    data?: unknown;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,yBAAyB;IACzB,QAAQ,EAAE,UAAU,CAAC;IACrB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,mGAAmG;IACnG,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,MAAM,EAAE,cAAc,CAAC;IACvB,sDAAsD;IACtD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,4BAA4B;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,EAAE,EAAE,QAAQ,CAAC;IACb,qCAAqC;IACrC,OAAO,EAAE,cAAc,CAAC;IACxB,yBAAyB;IACzB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,sEAAsE;IACtE,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/dist/utils/command-helpers.d.ts

@@ -0,0 +1,14 @@
+import type { Command } from 'commander';
+import type { BrxmUpgradeConfig } from '../types/index.js';
+/**
+ * Retrieve the typed BrxmUpgradeConfig from a Commander command's parent options.
+ * Returns undefined if the parent or config is not set.
+ */
+export declare function getParentConfig(command: Command): BrxmUpgradeConfig | undefined;
+/**
+ * Resolve command configuration, preferring the preloaded parent config populated
+ * by the root CLI hook and falling back to on-demand config loading for tests or
+ * direct command invocation.
+ */
+export declare function getCommandConfig(command: Command): Promise<BrxmUpgradeConfig>;
+//# sourceMappingURL=command-helpers.d.ts.map

package/dist/utils/command-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/command-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAK3D;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAE/E;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAEnF"}

package/dist/utils/command-helpers.js

@@ -0,0 +1,18 @@
+import { loadConfig } from '../config/index.js';
+const CONFIG_KEY = '_config';
+/**
+ * Retrieve the typed BrxmUpgradeConfig from a Commander command's parent options.
+ * Returns undefined if the parent or config is not set.
+ */
+export function getParentConfig(command) {
+    return command.parent?.opts()[CONFIG_KEY];
+}
+/**
+ * Resolve command configuration, preferring the preloaded parent config populated
+ * by the root CLI hook and falling back to on-demand config loading for tests or
+ * direct command invocation.
+ */
+export async function getCommandConfig(command) {
+    return getParentConfig(command) ?? loadConfig();
+}
+//# sourceMappingURL=command-helpers.js.map

package/dist/utils/command-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-helpers.js","sourceRoot":"","sources":["../../src/utils/command-helpers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,UAAU,GAAG,SAAS,CAAC;AAE7B;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,OAAO,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,UAAU,CAAkC,CAAC;AAC7E,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAgB;IACrD,OAAO,eAAe,CAAC,OAAO,CAAC,IAAI,UAAU,EAAE,CAAC;AAClD,CAAC"}

package/dist/utils/diff.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Result of generating a diff between two strings.
+ */
+export interface DiffResult {
+    /** Name of the file being diffed */
+    fileName: string;
+    /** Whether the original and modified content differ */
+    hasChanges: boolean;
+    /** Number of added lines */
+    additions: number;
+    /** Number of deleted lines */
+    deletions: number;
+    /** Unified diff patch string */
+    patch: string;
+}
+/**
+ * Generates a unified diff between original and modified content.
+ *
+ * @param original - The original file content
+ * @param modified - The modified file content
+ * @param fileName - The file name to display in the diff header
+ * @returns A DiffResult with patch, change counts, and metadata
+ */
+export declare function generateDiff(original: string, modified: string, fileName: string): DiffResult;
+/**
+ * Formats a diff result with ANSI color codes for terminal display.
+ *
+ * Uses green for additions, red for deletions, cyan for hunk headers,
+ * and bold for file headers.
+ *
+ * @param diff - The DiffResult to format
+ * @returns Colorized string suitable for terminal output, or empty string if no changes
+ */
+export declare function formatDiffForTerminal(diff: DiffResult): string;
+/**
+ * Produces a one-line summary of multiple diff results.
+ *
+ * @param diffs - Array of DiffResult objects to summarize
+ * @returns Summary string like "2 files changed, 5 additions(+), 3 deletions(-)"
+ */
+export declare function summarizeDiffs(diffs: DiffResult[]): string;
+//# sourceMappingURL=diff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/utils/diff.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,UAAU,EAAE,OAAO,CAAC;IACpB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CA2B7F;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAuB9D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,CAM1D"}

package/dist/utils/diff.js

@@ -0,0 +1,80 @@
+import { createTwoFilesPatch, structuredPatch } from 'diff';
+import chalk from 'chalk';
+/**
+ * Generates a unified diff between original and modified content.
+ *
+ * @param original - The original file content
+ * @param modified - The modified file content
+ * @param fileName - The file name to display in the diff header
+ * @returns A DiffResult with patch, change counts, and metadata
+ */
+export function generateDiff(original, modified, fileName) {
+    const structured = structuredPatch(fileName, fileName, original, modified);
+    const hasChanges = structured.hunks.length > 0;
+    let additions = 0;
+    let deletions = 0;
+    for (const hunk of structured.hunks) {
+        for (const line of hunk.lines) {
+            if (line.startsWith('+')) {
+                additions++;
+            }
+            else if (line.startsWith('-')) {
+                deletions++;
+            }
+        }
+    }
+    const patch = hasChanges
+        ? createTwoFilesPatch(fileName, fileName, original, modified)
+        : '';
+    return {
+        fileName,
+        hasChanges,
+        additions,
+        deletions,
+        patch,
+    };
+}
+/**
+ * Formats a diff result with ANSI color codes for terminal display.
+ *
+ * Uses green for additions, red for deletions, cyan for hunk headers,
+ * and bold for file headers.
+ *
+ * @param diff - The DiffResult to format
+ * @returns Colorized string suitable for terminal output, or empty string if no changes
+ */
+export function formatDiffForTerminal(diff) {
+    if (!diff.hasChanges || !diff.patch) {
+        return '';
+    }
+    const lines = diff.patch.split('\n');
+    const colorized = lines.map((line) => {
+        if (line.startsWith('+++') || line.startsWith('---')) {
+            return chalk.bold(line);
+        }
+        if (line.startsWith('@@')) {
+            return chalk.cyan(line);
+        }
+        if (line.startsWith('+')) {
+            return chalk.green(line);
+        }
+        if (line.startsWith('-')) {
+            return chalk.red(line);
+        }
+        return line;
+    });
+    return colorized.join('\n');
+}
+/**
+ * Produces a one-line summary of multiple diff results.
+ *
+ * @param diffs - Array of DiffResult objects to summarize
+ * @returns Summary string like "2 files changed, 5 additions(+), 3 deletions(-)"
+ */
+export function summarizeDiffs(diffs) {
+    const changed = diffs.filter((d) => d.hasChanges);
+    const totalAdditions = changed.reduce((sum, d) => sum + d.additions, 0);
+    const totalDeletions = changed.reduce((sum, d) => sum + d.deletions, 0);
+    return `${changed.length} file(s) changed, ${totalAdditions} addition(s)(+), ${totalDeletions} deletion(s)(-)`;
+}
+//# sourceMappingURL=diff.js.map

package/dist/utils/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/utils/diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAC5D,OAAO,KAAK,MAAM,OAAO,CAAC;AAkB1B;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,QAAgB,EAAE,QAAgB;IAC/E,MAAM,UAAU,GAAG,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC3E,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAE/C,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QACpC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzB,SAAS,EAAE,CAAC;YACd,CAAC;iBAAM,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAChC,SAAS,EAAE,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,UAAU;QACtB,CAAC,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;QAC7D,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;QACL,QAAQ;QACR,UAAU;QACV,SAAS;QACT,SAAS;QACT,KAAK;KACN,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAgB;IACpD,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACpC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACnC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACrD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAmB;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAClD,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IACxE,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAExE,OAAO,GAAG,OAAO,CAAC,MAAM,qBAAqB,cAAc,oBAAoB,cAAc,iBAAiB,CAAC;AACjH,CAAC"}

package/dist/utils/error.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Sanitise an error message by redacting potential API keys.
+ */
+export declare function sanitizeError(error: unknown): string;
+//# sourceMappingURL=error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/utils/error.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGpD"}

package/dist/utils/error.js

@@ -0,0 +1,8 @@
+/**
+ * Sanitise an error message by redacting potential API keys.
+ */
+export function sanitizeError(error) {
+    const msg = error instanceof Error ? error.message : String(error);
+    return msg.replace(/\b(sk-|key-|AIza)[A-Za-z0-9_-]{20,}\b/g, '[REDACTED]');
+}
+//# sourceMappingURL=error.js.map

package/dist/utils/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/utils/error.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnE,OAAO,GAAG,CAAC,OAAO,CAAC,wCAAwC,EAAE,YAAY,CAAC,CAAC;AAC7E,CAAC"}

package/dist/utils/fs.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Check if a file or directory exists.
+ */
+export declare function pathExists(path: string): Promise<boolean>;
+/**
+ * Read a file as UTF-8 text.
+ */
+export declare function readTextFile(path: string): Promise<string>;
+/**
+ * Write text content to a file, creating parent directories if needed.
+ */
+export declare function writeTextFile(path: string, content: string): Promise<void>;
+/**
+ * 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 declare function findFiles(pattern: string, cwd?: string, ignore?: string[]): Promise<string[]>;
+/**
+ * Resolve a path relative to the current working directory.
+ */
+export declare function resolvePath(...paths: string[]): string;
+/**
+ * Join path segments.
+ */
+export declare function joinPaths(...paths: string[]): string;
+/**
+ * Get the output directory for brxm-upgrade files.
+ */
+export declare function getOutputDir(basePath?: string): string;
+/**
+ * Ensure a directory exists, creating it and parents if needed.
+ */
+export declare function ensureDir(dirPath: string): Promise<void>;
+/**
+ * Copy a file from source to destination.
+ */
+export declare function copyFile(src: string, dest: string): Promise<void>;
+/**
+ * Remove a file or directory recursively.
+ */
+export declare function removeDir(path: string): Promise<void>;
+/**
+ * Parse a JSON file with runtime validation.
+ * Provides descriptive errors for malformed JSON and invalid data shapes.
+ */
+export declare function parseJsonFile<T>(filePath: string, validate: (data: unknown) => data is T): T;
+//# sourceMappingURL=fs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEhE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMhF;AAgBD;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,MAAM,EAAE,CAAC,CAOnB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAItD;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,CAY5F"}