@bloomreach/brxm-upgrade 0.1.1

package/dist/execution/executors/ai-assisted.js

@@ -0,0 +1,226 @@
+import { isAbsolute, join } from 'node:path';
+import { applyFileChanges } from '../file-transformer.js';
+import { readTextFile, findFiles } from '../../utils/fs.js';
+const MAX_CANDIDATE_FILES = 5;
+const MAX_PROJECT_FILES_TO_SCAN = 500;
+const MAX_CONTENT = 6000;
+/**
+ * Executor for AI-assisted steps (automatable === 'partial').
+ *
+ * Uses the AI client to propose concrete file edits against a bounded set of
+ * candidate files. The user can review the diff, ask the AI to revise the
+ * proposal, and then decide whether to apply it.
+ */
+export class AIAssistedExecutor {
+    automationLevel = 'partial';
+    aiClient;
+    constructor(aiClient) {
+        this.aiClient = aiClient;
+    }
+    async prepare(step, projectRoot) {
+        return this.proposeChanges(step, projectRoot);
+    }
+    async revise(step, projectRoot, previousProposal, revisionRequest) {
+        return this.proposeChanges(step, projectRoot, {
+            previousProposal,
+            revisionRequest,
+        });
+    }
+    async apply(prepared, _projectRoot) {
+        if (prepared.changes.length === 0) {
+            return Promise.reject(new Error('No proposed file changes are available for this AI-assisted step. Ask AI to revise or complete it manually.'));
+        }
+        await applyFileChanges(prepared.changes);
+        return prepared.changes;
+    }
+    async proposeChanges(step, projectRoot, options) {
+        const candidateFiles = await this.resolveCandidateFiles(step, projectRoot);
+        if (candidateFiles.length === 0) {
+            return {
+                step,
+                changes: [],
+                totalFiles: 0,
+                aiAnalysis: 'No candidate files could be identified for this AI-assisted step. Review the guidance manually or regenerate the plan with the latest metadata.',
+                isValid: true,
+            };
+        }
+        try {
+            const prompt = this.buildProposalPrompt(step, candidateFiles, options?.previousProposal, options?.revisionRequest);
+            const response = await this.aiClient.generate(prompt, {
+                maxTokens: 4000,
+                temperature: 0.1,
+            });
+            const parsed = this.parseProposalResponse(response.text);
+            const originalByPath = new Map(candidateFiles.map((file) => [file.path, file.content]));
+            const changes = (parsed.changes ?? [])
+                .filter((change) => originalByPath.has(change.filePath))
+                .map((change) => {
+                const originalContent = originalByPath.get(change.filePath);
+                return {
+                    filePath: change.filePath,
+                    originalContent,
+                    modifiedContent: change.modifiedContent,
+                    isNew: false,
+                };
+            })
+                .filter((change) => change.modifiedContent !== change.originalContent);
+            return {
+                step,
+                changes,
+                totalFiles: changes.length,
+                aiAnalysis: parsed.summary ?? 'AI proposal ready for review.',
+                isValid: true,
+            };
+        }
+        catch (error) {
+            return {
+                step,
+                changes: [],
+                totalFiles: 0,
+                aiAnalysis: `AI proposal unavailable: ${error instanceof Error ? error.message : 'Unknown error'}. Review the step manually.`,
+                isValid: true,
+            };
+        }
+    }
+    async resolveCandidateFiles(step, projectRoot) {
+        const directFiles = this.resolveDirectFiles(step, projectRoot);
+        if (directFiles.length > 0) {
+            return this.readCandidateFiles(directFiles);
+        }
+        if (!step.detectionPatterns || step.detectionPatterns.length === 0) {
+            return [];
+        }
+        const projectFiles = (await findFiles('**/*', projectRoot)).sort();
+        const matchingFiles = [];
+        for (const filePath of projectFiles.slice(0, MAX_PROJECT_FILES_TO_SCAN)) {
+            if (matchingFiles.length >= MAX_CANDIDATE_FILES)
+                break;
+            try {
+                const content = await readTextFile(filePath);
+                if (step.detectionPatterns.some((pattern) => this.matchesPattern(content, pattern))) {
+                    matchingFiles.push(filePath);
+                }
+            }
+            catch {
+                // Skip unreadable files.
+            }
+        }
+        return this.readCandidateFiles(matchingFiles);
+    }
+    resolveDirectFiles(step, projectRoot) {
+        const resolved = new Set();
+        for (const filePath of step.affectedFiles) {
+            resolved.add(isAbsolute(filePath) ? filePath : join(projectRoot, filePath));
+            if (resolved.size >= MAX_CANDIDATE_FILES) {
+                break;
+            }
+        }
+        return Array.from(resolved);
+    }
+    async readCandidateFiles(filePaths) {
+        const candidates = [];
+        for (const filePath of filePaths.slice(0, MAX_CANDIDATE_FILES)) {
+            try {
+                const content = await readTextFile(filePath);
+                candidates.push({
+                    path: filePath,
+                    content,
+                });
+            }
+            catch {
+                // Skip unreadable files.
+            }
+        }
+        return candidates;
+    }
+    truncateContent(content) {
+        let snippet = content.slice(0, MAX_CONTENT);
+        if (content.length > MAX_CONTENT) {
+            snippet += `\n... [truncated, ${content.length - MAX_CONTENT} chars omitted]`;
+        }
+        return snippet;
+    }
+    matchesPattern(content, pattern) {
+        if (pattern.startsWith('/') && pattern.endsWith('/') && pattern.length > 2) {
+            try {
+                return new RegExp(pattern.slice(1, -1)).test(content);
+            }
+            catch {
+                return false;
+            }
+        }
+        try {
+            return new RegExp(pattern, 'm').test(content);
+        }
+        catch {
+            return content.includes(pattern);
+        }
+    }
+    buildProposalPrompt(step, candidateFiles, previousProposal, revisionRequest) {
+        const fileContext = candidateFiles
+            .map((file) => `=== ${file.path} ===\n${this.truncateContent(file.content)}`)
+            .join('\n\n');
+        const previousProposalSection = previousProposal && previousProposal.changes.length > 0
+            ? `\n## Previous Proposal\n${previousProposal.changes
+                .map((change) => `- ${change.filePath}`)
+                .join('\n')}\n\nPrevious summary:\n${previousProposal.aiAnalysis ?? 'No previous summary provided.'}`
+            : '';
+        const revisionSection = revisionRequest
+            ? `\n## Revision Request\n${revisionRequest}`
+            : '';
+        return `You are helping with a brXM upgrade migration by proposing concrete file edits.
+
+## Step Details
+- Entry ID: ${step.entryId}
+- Description: ${step.description}
+- Type: ${step.type}
+- Risk Level: ${step.riskLevel}/5
+- Candidate Files: ${candidateFiles.length}
+
+## Manifest Guidance
+${step.aiGuidance ?? 'No manifest guidance provided.'}
+
+## Existing Analysis
+${step.analysis ?? 'No additional analysis provided.'}
+
+## Candidate File Contents
+${fileContext}
+${previousProposalSection}
+${revisionSection}
+
+## Your Task
+Return JSON only, with this shape:
+{
+  "summary": "Short explanation of the proposed change and any follow-up validation.",
+  "changes": [
+    {
+      "filePath": "exact candidate file path from the provided list",
+      "modifiedContent": "full new file contents",
+      "reason": "brief reason for this edit"
+    }
+  ]
+}
+
+Rules:
+- Only modify files from the provided candidate file list.
+- Preserve formatting and unrelated code.
+- Return full file contents for each changed file, not patches.
+- If no safe automated proposal can be made, return an empty changes array and explain why in summary.
+- Do not include markdown fences or any text outside the JSON object.`;
+    }
+    parseProposalResponse(text) {
+        const trimmed = text.trim();
+        const fencedMatch = trimmed.match(/```(?:json)?\s*([\s\S]*?)```/i);
+        const jsonText = fencedMatch?.[1]?.trim() ?? this.extractJsonObject(trimmed);
+        return JSON.parse(jsonText);
+    }
+    extractJsonObject(text) {
+        const firstBrace = text.indexOf('{');
+        const lastBrace = text.lastIndexOf('}');
+        if (firstBrace === -1 || lastBrace === -1 || lastBrace <= firstBrace) {
+            throw new Error('AI response did not contain valid JSON');
+        }
+        return text.slice(firstBrace, lastBrace + 1);
+    }
+}
+//# sourceMappingURL=ai-assisted.js.map

package/dist/execution/executors/ai-assisted.js.map

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

package/dist/execution/executors/automated.d.ts

@@ -0,0 +1,15 @@
+import type { PlanStep, AutomationLevel } from '../../planning/types.js';
+import type { IStepExecutor, PreparedChanges, FileChange } from '../types.js';
+/**
+ * Executor for fully automated steps (automatable === 'true').
+ *
+ * Applies pattern-based transformations from manifest entries to matching files.
+ * When patterns are not available on the step, returns a fallback so the caller
+ * can present the step as a manual action.
+ */
+export declare class AutomatedExecutor implements IStepExecutor {
+    readonly automationLevel: AutomationLevel;
+    prepare(step: PlanStep, projectRoot: string): Promise<PreparedChanges>;
+    apply(prepared: PreparedChanges, _projectRoot: string): Promise<FileChange[]>;
+}
+//# sourceMappingURL=automated.d.ts.map

package/dist/execution/executors/automated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"automated.d.ts","sourceRoot":"","sources":["../../../src/execution/executors/automated.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9E;;;;;;GAMG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACrD,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAU;IAE7C,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAwBtE,KAAK,CAAC,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;CAIpF"}

package/dist/execution/executors/automated.js

@@ -0,0 +1,37 @@
+import { applyPatterns, applyFileChanges } from '../file-transformer.js';
+/**
+ * Executor for fully automated steps (automatable === 'true').
+ *
+ * Applies pattern-based transformations from manifest entries to matching files.
+ * When patterns are not available on the step, returns a fallback so the caller
+ * can present the step as a manual action.
+ */
+export class AutomatedExecutor {
+    automationLevel = 'true';
+    async prepare(step, projectRoot) {
+        const patterns = step.patterns ?? [];
+        const fileGlobs = step.fileGlobs ?? step.affectedFiles ?? [];
+        if (!patterns.length) {
+            return {
+                step,
+                changes: [],
+                totalFiles: 0,
+                isValid: true,
+                message: 'No transformation patterns defined for this step — showing as manual step.',
+                fallbackToManual: true,
+            };
+        }
+        const changes = await applyPatterns(projectRoot, patterns, fileGlobs);
+        return {
+            step,
+            changes,
+            totalFiles: changes.length,
+            isValid: true,
+        };
+    }
+    async apply(prepared, _projectRoot) {
+        await applyFileChanges(prepared.changes);
+        return prepared.changes;
+    }
+}
+//# sourceMappingURL=automated.js.map

package/dist/execution/executors/automated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"automated.js","sourceRoot":"","sources":["../../../src/execution/executors/automated.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAEzE;;;;;;GAMG;AACH,MAAM,OAAO,iBAAiB;IACnB,eAAe,GAAoB,MAAM,CAAC;IAEnD,KAAK,CAAC,OAAO,CAAC,IAAc,EAAE,WAAmB;QAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;QACrC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC;QAE7D,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACrB,OAAO;gBACL,IAAI;gBACJ,OAAO,EAAE,EAAE;gBACX,UAAU,EAAE,CAAC;gBACb,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,4EAA4E;gBACrF,gBAAgB,EAAE,IAAI;aACvB,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QACtE,OAAO;YACL,IAAI;YACJ,OAAO;YACP,UAAU,EAAE,OAAO,CAAC,MAAM;YAC1B,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,QAAyB,EAAE,YAAoB;QACzD,MAAM,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACzC,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;CACF"}

package/dist/execution/executors/cv-gate.d.ts

@@ -0,0 +1,23 @@
+import type { PlanStep, AutomationLevel } from '../../planning/types.js';
+import type { IStepExecutor, PreparedChanges, FileChange } from '../types.js';
+import type { CVScanResult } from '../../discovery/scanners/cv-scanner.js';
+/**
+ * Executor for Configuration Verifier gate steps (verification_gate type).
+ *
+ * Does not make automated changes. Provides instructions for running the CV
+ * manually and offers scan summary / comparison formatting for the CLI layer.
+ */
+export declare class CVGateExecutor implements IStepExecutor {
+    readonly automationLevel: AutomationLevel;
+    prepare(step: PlanStep, _projectRoot: string): Promise<PreparedChanges>;
+    apply(_prepared: PreparedChanges, _projectRoot: string): Promise<FileChange[]>;
+    /**
+     * Format a human-readable summary of a CV scan result.
+     */
+    formatScanSummary(result: CVScanResult): string;
+    /**
+     * Format a before/after comparison of two CV scan results.
+     */
+    formatComparison(preResult: CVScanResult, postResult: CVScanResult): string;
+}
+//# sourceMappingURL=cv-gate.d.ts.map

package/dist/execution/executors/cv-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cv-gate.d.ts","sourceRoot":"","sources":["../../../src/execution/executors/cv-gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAI3E;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,aAAa;IAClD,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAW;IAEpD,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAqBvE,KAAK,CAAC,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAI9E;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM;IAgB/C;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,GAAG,MAAM;CAc5E"}

package/dist/execution/executors/cv-gate.js

@@ -0,0 +1,63 @@
+const CV_COMMAND = 'mvn -P cargo.run,verify-configuration -Drepo.path=./storage';
+/**
+ * Executor for Configuration Verifier gate steps (verification_gate type).
+ *
+ * Does not make automated changes. Provides instructions for running the CV
+ * manually and offers scan summary / comparison formatting for the CLI layer.
+ */
+export class CVGateExecutor {
+    automationLevel = 'false';
+    prepare(step, _projectRoot) {
+        const isPreCheck = step.entryId === 'cv-pre-check';
+        const message = isPreCheck
+            ? `Run the Configuration Verifier to establish a pre-upgrade baseline.\n\n` +
+                `  ${CV_COMMAND}\n\n` +
+                `This starts the CMS and compares bootstrap config against the repository.\n` +
+                `Output will be written to configuration-verifier-output/.`
+            : `Run the Configuration Verifier again to validate the upgrade.\n\n` +
+                `  ${CV_COMMAND}\n\n` +
+                `Compare against the pre-upgrade baseline to verify no new drift was introduced.`;
+        return Promise.resolve({
+            step,
+            changes: [],
+            totalFiles: 0,
+            isValid: true,
+            message,
+        });
+    }
+    apply(_prepared, _projectRoot) {
+        return Promise.resolve([]);
+    }
+    /**
+     * Format a human-readable summary of a CV scan result.
+     */
+    formatScanSummary(result) {
+        if (!result.found) {
+            return 'No Configuration Verifier output found in ' + result.outputPath;
+        }
+        const lines = [
+            `Found ${result.totalDeltas} delta(s) across ${result.sourceFiles.length} file(s):`,
+        ];
+        for (const [type, count] of Object.entries(result.deltaCounts)) {
+            lines.push(`  ${type}: ${count}`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Format a before/after comparison of two CV scan results.
+     */
+    formatComparison(preResult, postResult) {
+        const diff = preResult.totalDeltas - postResult.totalDeltas;
+        const lines = [
+            `Before: ${preResult.totalDeltas} delta(s)  —  After: ${postResult.totalDeltas} delta(s)`,
+        ];
+        if (diff > 0) {
+            lines.push(`${diff} resolved by upgrade`);
+        }
+        else if (diff < 0) {
+            lines.push(`${Math.abs(diff)} new delta(s) introduced — review required`);
+        }
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=cv-gate.js.map

package/dist/execution/executors/cv-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cv-gate.js","sourceRoot":"","sources":["../../../src/execution/executors/cv-gate.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,GAAG,6DAA6D,CAAC;AAEjF;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IAChB,eAAe,GAAoB,OAAO,CAAC;IAEpD,OAAO,CAAC,IAAc,EAAE,YAAoB;QAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,KAAK,cAAc,CAAC;QAEnD,MAAM,OAAO,GAAG,UAAU;YACxB,CAAC,CAAC,yEAAyE;gBACzE,KAAK,UAAU,MAAM;gBACrB,6EAA6E;gBAC7E,2DAA2D;YAC7D,CAAC,CAAC,mEAAmE;gBACnE,KAAK,UAAU,MAAM;gBACrB,iFAAiF,CAAC;QAEtF,OAAO,OAAO,CAAC,OAAO,CAAC;YACrB,IAAI;YACJ,OAAO,EAAE,EAAE;YACX,UAAU,EAAE,CAAC;YACb,OAAO,EAAE,IAAI;YACb,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,SAA0B,EAAE,YAAoB;QACpD,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,MAAoB;QACpC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,OAAO,4CAA4C,GAAG,MAAM,CAAC,UAAU,CAAC;QAC1E,CAAC;QAED,MAAM,KAAK,GAAa;YACtB,SAAS,MAAM,CAAC,WAAW,oBAAoB,MAAM,CAAC,WAAW,CAAC,MAAM,WAAW;SACpF,CAAC;QAEF,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;YAC/D,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC;QACpC,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,SAAuB,EAAE,UAAwB;QAChE,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;QAC5D,MAAM,KAAK,GAAa;YACtB,WAAW,SAAS,CAAC,WAAW,wBAAwB,UAAU,CAAC,WAAW,WAAW;SAC1F,CAAC;QAEF,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACb,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,sBAAsB,CAAC,CAAC;QAC5C,CAAC;aAAM,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;QAC5E,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/execution/executors/index.d.ts

@@ -0,0 +1,7 @@
+export { AutomatedExecutor } from './automated.js';
+export { AIAssistedExecutor } from './ai-assisted.js';
+export { ManualExecutor } from './manual.js';
+export { VersionBumpExecutor } from './version-bump.js';
+export { CVGateExecutor } from './cv-gate.js';
+export { OverrideResolutionExecutor } from './override-resolution.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/execution/executors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/execution/executors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/execution/executors/index.js

@@ -0,0 +1,7 @@
+export { AutomatedExecutor } from './automated.js';
+export { AIAssistedExecutor } from './ai-assisted.js';
+export { ManualExecutor } from './manual.js';
+export { VersionBumpExecutor } from './version-bump.js';
+export { CVGateExecutor } from './cv-gate.js';
+export { OverrideResolutionExecutor } from './override-resolution.js';
+//# sourceMappingURL=index.js.map

package/dist/execution/executors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/execution/executors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/execution/executors/manual.d.ts

@@ -0,0 +1,18 @@
+import type { PlanStep, AutomationLevel } from '../../planning/types.js';
+import type { IStepExecutor, PreparedChanges, FileChange } from '../types.js';
+/**
+ * Executor for manual steps (automatable === 'false').
+ *
+ * Does not make automated changes but validates that manual steps are
+ * available and provides guidance to the user.
+ */
+export declare class ManualExecutor implements IStepExecutor {
+    readonly automationLevel: AutomationLevel;
+    prepare(step: PlanStep, _projectRoot: string): Promise<PreparedChanges>;
+    apply(_prepared: PreparedChanges, _projectRoot: string): Promise<FileChange[]>;
+    generateChecklist(step: PlanStep): {
+        step: string;
+        completed: boolean;
+    }[];
+}
+//# sourceMappingURL=manual.d.ts.map

package/dist/execution/executors/manual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual.d.ts","sourceRoot":"","sources":["../../../src/execution/executors/manual.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9E;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,aAAa;IAClD,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAW;IAEpD,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAkBvE,KAAK,CAAC,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAI9E,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,EAAE;CAI1E"}

package/dist/execution/executors/manual.js

@@ -0,0 +1,31 @@
+/**
+ * Executor for manual steps (automatable === 'false').
+ *
+ * Does not make automated changes but validates that manual steps are
+ * available and provides guidance to the user.
+ */
+export class ManualExecutor {
+    automationLevel = 'false';
+    prepare(step, _projectRoot) {
+        const validationErrors = [];
+        if (!step.manualSteps || step.manualSteps.length === 0) {
+            validationErrors.push('No manual steps provided for this entry. Please check the manifest.');
+        }
+        return Promise.resolve({
+            step,
+            changes: [],
+            totalFiles: step.affectedFileCount,
+            isValid: validationErrors.length === 0,
+            validationErrors: validationErrors.length > 0 ? validationErrors : undefined,
+        });
+    }
+    apply(_prepared, _projectRoot) {
+        return Promise.resolve([]);
+    }
+    generateChecklist(step) {
+        if (!step.manualSteps)
+            return [];
+        return step.manualSteps.map((s) => ({ step: s, completed: false }));
+    }
+}
+//# sourceMappingURL=manual.js.map

package/dist/execution/executors/manual.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual.js","sourceRoot":"","sources":["../../../src/execution/executors/manual.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IAChB,eAAe,GAAoB,OAAO,CAAC;IAEpD,OAAO,CAAC,IAAc,EAAE,YAAoB;QAC1C,MAAM,gBAAgB,GAAa,EAAE,CAAC;QAEtC,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvD,gBAAgB,CAAC,IAAI,CACnB,qEAAqE,CACtE,CAAC;QACJ,CAAC;QAED,OAAO,OAAO,CAAC,OAAO,CAAC;YACrB,IAAI;YACJ,OAAO,EAAE,EAAE;YACX,UAAU,EAAE,IAAI,CAAC,iBAAiB;YAClC,OAAO,EAAE,gBAAgB,CAAC,MAAM,KAAK,CAAC;YACtC,gBAAgB,EAAE,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS;SAC7E,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,SAA0B,EAAE,YAAoB;QACpD,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,iBAAiB,CAAC,IAAc;QAC9B,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,OAAO,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACtE,CAAC;CACF"}

package/dist/execution/executors/override-resolution.d.ts

@@ -0,0 +1,27 @@
+import type { PlanStep, AutomationLevel } from '../../planning/types.js';
+import type { IStepExecutor, PreparedChanges, FileChange } from '../types.js';
+/**
+ * Executor that removes conflicting and redundant version override properties from POM files.
+ *
+ * Reads the `manualSteps` on the step to determine which properties to remove.
+ * Each manual step has the format `<property.name>: <action description>`, where
+ * the action description starts with "Remove" for overrides that should be deleted.
+ */
+export declare class OverrideResolutionExecutor implements IStepExecutor {
+    readonly automationLevel: AutomationLevel;
+    prepare(step: PlanStep, projectRoot: string): Promise<PreparedChanges>;
+    apply(prepared: PreparedChanges, _projectRoot: string): Promise<FileChange[]>;
+    /**
+     * Extract property names from the step's manualSteps entries.
+     *
+     * Each entry is expected to have the format `<property.name>: <action>`.
+     * Only entries whose action starts with "Remove" are included, as those
+     * are the properties that should be deleted from the POM.
+     *
+     * Example entries:
+     *   `spring.version: Remove — conflicts with brXM 16.7.0 managed value 5.3.31`
+     *   `essentials.version: Remove — redundant, brXM 16.7.0 manages the same value`
+     */
+    private extractPropertyNames;
+}
+//# sourceMappingURL=override-resolution.d.ts.map

package/dist/execution/executors/override-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"override-resolution.d.ts","sourceRoot":"","sources":["../../../src/execution/executors/override-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9E;;;;;;GAMG;AACH,qBAAa,0BAA2B,YAAW,aAAa;IAC9D,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAU;IAE7C,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA6CtE,KAAK,CAAC,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAOnF;;;;;;;;;;OAUG;IACH,OAAO,CAAC,oBAAoB;CAW7B"}

package/dist/execution/executors/override-resolution.js

@@ -0,0 +1,79 @@
+import { readTextFile, writeTextFile, joinPaths } from '../../utils/fs.js';
+/**
+ * Executor that removes conflicting and redundant version override properties from POM files.
+ *
+ * Reads the `manualSteps` on the step to determine which properties to remove.
+ * Each manual step has the format `<property.name>: <action description>`, where
+ * the action description starts with "Remove" for overrides that should be deleted.
+ */
+export class OverrideResolutionExecutor {
+    automationLevel = 'true';
+    async prepare(step, projectRoot) {
+        const propertyNames = this.extractPropertyNames(step.manualSteps ?? []);
+        if (propertyNames.length === 0) {
+            return {
+                step,
+                changes: [],
+                totalFiles: 0,
+                isValid: true,
+                message: 'No properties to remove.',
+                fallbackToManual: true,
+            };
+        }
+        const changes = [];
+        for (const pomRelPath of step.affectedFiles) {
+            const pomPath = joinPaths(projectRoot, pomRelPath);
+            const originalContent = await readTextFile(pomPath);
+            let modifiedContent = originalContent;
+            for (const prop of propertyNames) {
+                // Remove the property element and its leading whitespace/newline
+                const escapedProp = prop.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+                const pattern = new RegExp(`\\n\\s*<${escapedProp}>[^<]*</${escapedProp}>`, 'g');
+                modifiedContent = modifiedContent.replace(pattern, '');
+            }
+            if (modifiedContent !== originalContent) {
+                changes.push({
+                    filePath: pomPath,
+                    originalContent,
+                    modifiedContent,
+                    isNew: false,
+                });
+            }
+        }
+        return {
+            step,
+            changes,
+            totalFiles: changes.length,
+            isValid: true,
+        };
+    }
+    async apply(prepared, _projectRoot) {
+        for (const change of prepared.changes) {
+            await writeTextFile(change.filePath, change.modifiedContent);
+        }
+        return prepared.changes;
+    }
+    /**
+     * Extract property names from the step's manualSteps entries.
+     *
+     * Each entry is expected to have the format `<property.name>: <action>`.
+     * Only entries whose action starts with "Remove" are included, as those
+     * are the properties that should be deleted from the POM.
+     *
+     * Example entries:
+     *   `spring.version: Remove — conflicts with brXM 16.7.0 managed value 5.3.31`
+     *   `essentials.version: Remove — redundant, brXM 16.7.0 manages the same value`
+     */
+    extractPropertyNames(manualSteps) {
+        const names = [];
+        for (const step of manualSteps) {
+            // Match "property.name: Remove ..." — the colon separates name from action
+            const match = /^([a-zA-Z0-9._-]+):\s*Remove\b/.exec(step);
+            if (match) {
+                names.push(match[1]);
+            }
+        }
+        return names;
+    }
+}
+//# sourceMappingURL=override-resolution.js.map

package/dist/execution/executors/override-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"override-resolution.js","sourceRoot":"","sources":["../../../src/execution/executors/override-resolution.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE3E;;;;;;GAMG;AACH,MAAM,OAAO,0BAA0B;IAC5B,eAAe,GAAoB,MAAM,CAAC;IAEnD,KAAK,CAAC,OAAO,CAAC,IAAc,EAAE,WAAmB;QAC/C,MAAM,aAAa,GAAG,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QAExE,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO;gBACL,IAAI;gBACJ,OAAO,EAAE,EAAE;gBACX,UAAU,EAAE,CAAC;gBACb,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,0BAA0B;gBACnC,gBAAgB,EAAE,IAAI;aACvB,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAiB,EAAE,CAAC;QACjC,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YAC5C,MAAM,OAAO,GAAG,SAAS,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;YACnD,MAAM,eAAe,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;YACpD,IAAI,eAAe,GAAG,eAAe,CAAC;YAEtC,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;gBACjC,iEAAiE;gBACjE,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;gBAChE,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,WAAW,WAAW,WAAW,WAAW,GAAG,EAAE,GAAG,CAAC,CAAC;gBACjF,eAAe,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACzD,CAAC;YAED,IAAI,eAAe,KAAK,eAAe,EAAE,CAAC;gBACxC,OAAO,CAAC,IAAI,CAAC;oBACX,QAAQ,EAAE,OAAO;oBACjB,eAAe;oBACf,eAAe;oBACf,KAAK,EAAE,KAAK;iBACb,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO;YACL,IAAI;YACJ,OAAO;YACP,UAAU,EAAE,OAAO,CAAC,MAAM;YAC1B,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,QAAyB,EAAE,YAAoB;QACzD,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtC,MAAM,aAAa,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IAED;;;;;;;;;;OAUG;IACK,oBAAoB,CAAC,WAAqB;QAChD,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,2EAA2E;YAC3E,MAAM,KAAK,GAAG,gCAAgC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1D,IAAI,KAAK,EAAE,CAAC;gBACV,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/execution/executors/version-bump.d.ts

@@ -0,0 +1,20 @@
+import type { PlanStep, AutomationLevel } from '../../planning/types.js';
+import type { IStepExecutor, PreparedChanges, FileChange } from '../types.js';
+/**
+ * Well-known Maven properties in brXM projects whose value tracks the
+ * brXM parent version.  When the parent version is bumped these properties
+ * must be updated to match.
+ */
+export declare const KNOWN_VERSION_PROPERTIES: readonly string[];
+/**
+ * Executor for the synthetic version-bump step.
+ *
+ * Replaces the brXM parent version inside the root pom.xml's <parent> block
+ * and updates any well-known Maven properties that track the parent version.
+ */
+export declare class VersionBumpExecutor implements IStepExecutor {
+    readonly automationLevel: AutomationLevel;
+    prepare(step: PlanStep, projectRoot: string): Promise<PreparedChanges>;
+    apply(prepared: PreparedChanges, _projectRoot: string): Promise<FileChange[]>;
+}
+//# sourceMappingURL=version-bump.d.ts.map

package/dist/execution/executors/version-bump.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-bump.d.ts","sourceRoot":"","sources":["../../../src/execution/executors/version-bump.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9E;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EAErD,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IACvD,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAU;IAE7C,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAoDtE,KAAK,CAAC,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;CAMpF"}