@jterrats/smart-deployment 1.0.3 → 1.0.4

package/lib/dependencies/heuristic-patterns.js

@@ -0,0 +1,247 @@
+export function calculateConfidence(pattern, existingDeps, nameSimilarity) {
+    let score = 50;
+    const patternScores = {
+        'test-suffix': 45,
+        'test-prefix': 45,
+        'trigger-handler': 40,
+        'handler-service': 35,
+        'controller-service': 35,
+        'batch-service': 25,
+        'queueable-service': 25,
+        'selector-service': 20,
+        'integration-service': 15,
+    };
+    score += patternScores[pattern] ?? 0;
+    score += Math.floor(nameSimilarity * 10);
+    score -= Math.min(existingDeps * 2, 10);
+    score = Math.max(0, Math.min(100, score));
+    if (score >= 80) {
+        return { confidence: 'high', score };
+    }
+    if (score >= 65) {
+        return { confidence: 'medium', score };
+    }
+    return { confidence: 'low', score };
+}
+export function inferTestClassDependencies(component, components) {
+    if (component.type !== 'ApexClass') {
+        return [];
+    }
+    const inferred = [];
+    const className = component.name;
+    if (className.endsWith('Test')) {
+        const productionClassName = className.slice(0, -4);
+        const prodNodeId = `ApexClass:${productionClassName}`;
+        if (components.has(prodNodeId)) {
+            inferred.push({
+                from: `ApexClass:${className}`,
+                to: prodNodeId,
+                reason: 'Test class typically tests production class',
+                confidence: 'high',
+                pattern: 'test-suffix',
+                score: 95,
+            });
+        }
+    }
+    if (className.startsWith('Test_')) {
+        const productionClassName = className.slice(5);
+        const prodNodeId = `ApexClass:${productionClassName}`;
+        if (components.has(prodNodeId)) {
+            inferred.push({
+                from: `ApexClass:${className}`,
+                to: prodNodeId,
+                reason: 'Test class typically tests production class',
+                confidence: 'high',
+                pattern: 'test-prefix',
+                score: 95,
+            });
+        }
+    }
+    if (className.endsWith('_Test')) {
+        const productionClassName = className.slice(0, -5);
+        const prodNodeId = `ApexClass:${productionClassName}`;
+        if (components.has(prodNodeId)) {
+            inferred.push({
+                from: `ApexClass:${className}`,
+                to: prodNodeId,
+                reason: 'Test class typically tests production class',
+                confidence: 'high',
+                pattern: 'test-suffix-underscore',
+                score: 95,
+            });
+        }
+    }
+    return inferred;
+}
+export function inferHandlerServicePattern(component, components) {
+    if (component.type !== 'ApexClass') {
+        return [];
+    }
+    const inferred = [];
+    const className = component.name;
+    if (className.endsWith('Handler')) {
+        const baseName = className.slice(0, -7);
+        const serviceNames = [`${baseName}Service`, `${baseName}_Service`, `${baseName}Svc`];
+        for (const serviceName of serviceNames) {
+            const serviceNodeId = `ApexClass:${serviceName}`;
+            if (components.has(serviceNodeId)) {
+                inferred.push({
+                    from: `ApexClass:${className}`,
+                    to: serviceNodeId,
+                    reason: 'Handler typically calls service layer',
+                    confidence: 'high',
+                    pattern: 'handler-service',
+                    score: 85,
+                });
+            }
+        }
+    }
+    if (className.includes('Handler')) {
+        const baseName = className.replace(/Handler$/, '').replace(/_Handler$/, '');
+        const serviceNames = [`${baseName}Service`, `${baseName}_Service`];
+        for (const serviceName of serviceNames) {
+            const serviceNodeId = `ApexClass:${serviceName}`;
+            if (components.has(serviceNodeId) && !inferred.some((dependency) => dependency.to === serviceNodeId)) {
+                inferred.push({
+                    from: `ApexClass:${className}`,
+                    to: serviceNodeId,
+                    reason: 'Handler typically calls service layer',
+                    confidence: 'medium',
+                    pattern: 'handler-service-variant',
+                    score: 75,
+                });
+            }
+        }
+    }
+    return inferred;
+}
+export function inferTriggerHandlerPattern(component, components) {
+    if (component.type !== 'ApexTrigger') {
+        return [];
+    }
+    const inferred = [];
+    const triggerName = component.name;
+    const handlerNames = [
+        `${triggerName}Handler`,
+        triggerName.replace(/Trigger$/, 'TriggerHandler'),
+        triggerName.replace(/Trigger$/, 'Handler'),
+    ];
+    for (const handlerName of handlerNames) {
+        const handlerNodeId = `ApexClass:${handlerName}`;
+        if (components.has(handlerNodeId)) {
+            inferred.push({
+                from: `ApexTrigger:${triggerName}`,
+                to: handlerNodeId,
+                reason: 'Trigger typically delegates to handler class',
+                confidence: 'high',
+                pattern: 'trigger-handler',
+                score: 90,
+            });
+            break;
+        }
+    }
+    return inferred;
+}
+export function inferControllerServicePattern(component, components) {
+    if (component.type !== 'ApexClass') {
+        return [];
+    }
+    const inferred = [];
+    const className = component.name;
+    if (className.endsWith('Controller') || className.includes('Controller')) {
+        const baseName = className
+            .replace(/Controller$/, '')
+            .replace(/_Controller$/, '')
+            .replace(/^LWC_/, '')
+            .replace(/^VF_/, '');
+        const serviceNames = [`${baseName}Service`, `${baseName}_Service`, `${baseName}Svc`];
+        for (const serviceName of serviceNames) {
+            const serviceNodeId = `ApexClass:${serviceName}`;
+            if (components.has(serviceNodeId)) {
+                inferred.push({
+                    from: `ApexClass:${className}`,
+                    to: serviceNodeId,
+                    reason: 'Controller typically calls service layer',
+                    confidence: 'high',
+                    pattern: 'controller-service',
+                    score: 85,
+                });
+            }
+        }
+    }
+    return inferred;
+}
+export function inferFromNamingConventions(component, components) {
+    if (component.type !== 'ApexClass') {
+        return [];
+    }
+    const inferred = [];
+    const className = component.name;
+    if (className.endsWith('Selector')) {
+        const baseName = className.slice(0, -8);
+        const serviceNodeId = `ApexClass:${baseName}Service`;
+        if (components.has(serviceNodeId)) {
+            inferred.push({
+                from: `ApexClass:${className}`,
+                to: serviceNodeId,
+                reason: 'Selector may be used by service layer',
+                confidence: 'medium',
+                pattern: 'selector-service',
+                score: 70,
+            });
+        }
+    }
+    if (className.endsWith('Batch')) {
+        const baseName = className.slice(0, -5);
+        const serviceNames = [`${baseName}Service`, `${baseName}`];
+        for (const serviceName of serviceNames) {
+            const serviceNodeId = `ApexClass:${serviceName}`;
+            if (components.has(serviceNodeId)) {
+                inferred.push({
+                    from: `ApexClass:${className}`,
+                    to: serviceNodeId,
+                    reason: 'Batch class typically uses service layer',
+                    confidence: 'medium',
+                    pattern: 'batch-service',
+                    score: 75,
+                });
+                break;
+            }
+        }
+    }
+    if (className.endsWith('Queueable') || className.includes('Queueable')) {
+        const baseName = className.replace(/Queueable$/, '').replace(/_Queueable/, '');
+        const serviceNodeId = `ApexClass:${baseName}Service`;
+        if (components.has(serviceNodeId)) {
+            inferred.push({
+                from: `ApexClass:${className}`,
+                to: serviceNodeId,
+                reason: 'Queueable typically uses service layer',
+                confidence: 'medium',
+                pattern: 'queueable-service',
+                score: 75,
+            });
+        }
+    }
+    if (className.includes('Integration')) {
+        const baseName = className
+            .replace(/Integration$/, '')
+            .replace(/_Integration/, '')
+            .replace(/^Integration/, '');
+        if (baseName) {
+            const serviceNodeId = `ApexClass:${baseName}Service`;
+            if (components.has(serviceNodeId)) {
+                inferred.push({
+                    from: `ApexClass:${className}`,
+                    to: serviceNodeId,
+                    reason: 'Integration class may use service layer',
+                    confidence: 'low',
+                    pattern: 'integration-service',
+                    score: 65,
+                });
+            }
+        }
+    }
+    return inferred;
+}
+//# sourceMappingURL=heuristic-patterns.js.map

package/lib/dependencies/heuristic-patterns.js.map

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

package/lib/deployment/cycle-remediation-runner.d.ts

@@ -0,0 +1,36 @@
+import type { CycleRemediationPlanner } from '../dependencies/cycle-remediation-planner.js';
+import type { NodeId } from '../types/dependency.js';
+import type { MetadataComponent } from '../types/metadata.js';
+import { StateManager } from './state-manager.js';
+import { DeploymentTracker } from './deployment-tracker.js';
+import { SfCliIntegration } from './sf-cli-integration.js';
+import { TestPlanService } from './test-plan-service.js';
+import { WaveManifestService } from './wave-manifest-service.js';
+export type CycleRemediationRunnerParams = {
+    deploymentId: string;
+    targetOrg: string;
+    sourcePath?: string;
+    stateManager: StateManager;
+    tracker: DeploymentTracker;
+    plan: ReturnType<CycleRemediationPlanner['createPlan']>;
+    sfCli: SfCliIntegration;
+    skipTests: boolean;
+    componentMap: ReadonlyMap<NodeId, MetadataComponent>;
+    log: (message: string) => void;
+};
+type CycleRemediationRunnerDependencies = {
+    testPlanService?: TestPlanService;
+    waveManifestService?: WaveManifestService;
+};
+export declare class CycleRemediationRunner {
+    private readonly testPlanService;
+    private readonly waveManifestService;
+    constructor(dependencies?: CycleRemediationRunnerDependencies);
+    execute(params: CycleRemediationRunnerParams): Promise<void>;
+    private createCycleEditRequest;
+    private restoreCycleEdits;
+    private buildSyntheticWave;
+    private collectWaveTypes;
+    private forEachSequentially;
+}
+export {};

package/lib/deployment/cycle-remediation-runner.js

@@ -0,0 +1,262 @@
+import { readFile } from 'node:fs/promises';
+import { CycleSourceEditor } from './cycle-source-editor.js';
+import { TestPlanService } from './test-plan-service.js';
+import { WaveManifestService } from './wave-manifest-service.js';
+export class CycleRemediationRunner {
+    testPlanService;
+    waveManifestService;
+    constructor(dependencies = {}) {
+        this.testPlanService = dependencies.testPlanService ?? new TestPlanService();
+        this.waveManifestService = dependencies.waveManifestService ?? new WaveManifestService();
+    }
+    async execute(params) {
+        const { deploymentId, targetOrg, sourcePath, stateManager, tracker, plan, sfCli, skipTests, componentMap, log } = params;
+        const editor = new CycleSourceEditor();
+        const startedAt = new Date().toISOString();
+        const editRecords = [];
+        const testExecutor = this.testPlanService.createExecutor([...componentMap.values()]);
+        const cycleId = plan.cycles.map((cycle) => cycle.id).join('||');
+        const phaseOneComponents = [
+            ...new Set(plan.cycles.flatMap((cycle) => cycle.deployPhases.find((phase) => phase.phase === 1)?.components ?? [])),
+        ];
+        const phaseTwoComponents = [
+            ...new Set(plan.cycles.flatMap((cycle) => cycle.deployPhases.find((phase) => phase.phase === 2)?.components ?? [])),
+        ];
+        let editsRestored = false;
+        let failureStateSaved = false;
+        try {
+            log('🩹 Applying conservative cycle remediation edits...');
+            await this.forEachSequentially(plan.cycles, async (cycle) => {
+                await this.forEachSequentially(cycle.edits, async (edit) => {
+                    const request = await this.createCycleEditRequest(edit);
+                    editRecords.push(await editor.applyEdit(request));
+                });
+            });
+            await stateManager.saveState({
+                deploymentId,
+                targetOrg,
+                timestamp: startedAt,
+                totalWaves: 2,
+                completedWaves: [],
+                currentWave: 1,
+                cycleRemediation: {
+                    cycleId,
+                    strategy: 'comment-reference',
+                    activePhase: 1,
+                    startedAt,
+                    completedPhases: [],
+                    editRecords,
+                },
+            });
+            tracker.startTracking(deploymentId, 1, 2);
+            log('♻️ Phase 1/2: deploying temporarily cycle-broken metadata...');
+            const phaseOneManifestPath = await this.waveManifestService.generateManifest({
+                baseDir: sourcePath ?? process.cwd(),
+                waveNumber: 1,
+                components: phaseOneComponents,
+                componentMap,
+            });
+            const phaseOneTestPlan = this.testPlanService.resolveTestPlan(this.buildSyntheticWave(1, phaseOneComponents, componentMap), skipTests, testExecutor);
+            const phaseOneResult = await sfCli.deploy({
+                manifestPath: phaseOneManifestPath,
+                targetOrg,
+                testLevel: phaseOneTestPlan.testLevel,
+                tests: phaseOneTestPlan.testLevel === 'RunSpecifiedTests' ? phaseOneTestPlan.tests : undefined,
+            });
+            if (!phaseOneResult.success) {
+                await stateManager.saveState({
+                    deploymentId,
+                    targetOrg,
+                    timestamp: new Date().toISOString(),
+                    totalWaves: 2,
+                    completedWaves: [],
+                    currentWave: 1,
+                    failedWave: {
+                        waveNumber: 1,
+                        error: phaseOneResult.output,
+                        timestamp: new Date().toISOString(),
+                    },
+                    cycleRemediation: {
+                        cycleId,
+                        strategy: 'comment-reference',
+                        activePhase: 1,
+                        startedAt,
+                        completedPhases: [],
+                        editRecords,
+                    },
+                    metadata: {
+                        lastKnownStatus: phaseOneResult.status,
+                        testsRun: phaseOneResult.testsRun,
+                        testFailures: phaseOneResult.testFailures,
+                        testLevel: phaseOneTestPlan.testLevel,
+                    },
+                });
+                failureStateSaved = true;
+                throw new Error(`Cycle remediation phase 1 failed: ${phaseOneResult.output}`);
+            }
+            await stateManager.saveState({
+                deploymentId,
+                targetOrg,
+                timestamp: new Date().toISOString(),
+                totalWaves: 2,
+                completedWaves: [1],
+                currentWave: 2,
+                cycleRemediation: {
+                    cycleId,
+                    strategy: 'comment-reference',
+                    activePhase: 2,
+                    startedAt,
+                    completedPhases: [1],
+                    editRecords,
+                },
+                metadata: {
+                    lastKnownStatus: phaseOneResult.status,
+                    testsRun: phaseOneResult.testsRun,
+                    testFailures: phaseOneResult.testFailures,
+                    testLevel: phaseOneTestPlan.testLevel,
+                },
+            });
+            log('♻️ Restoring original references before phase 2...');
+            await this.restoreCycleEdits(editor, editRecords);
+            editsRestored = true;
+            tracker.startTracking(deploymentId, 2, 2);
+            log('♻️ Phase 2/2: redeploying restored metadata...');
+            const phaseTwoManifestPath = await this.waveManifestService.generateManifest({
+                baseDir: sourcePath ?? process.cwd(),
+                waveNumber: 2,
+                components: phaseTwoComponents,
+                componentMap,
+            });
+            const phaseTwoTestPlan = this.testPlanService.resolveTestPlan(this.buildSyntheticWave(2, phaseTwoComponents, componentMap), skipTests, testExecutor);
+            const phaseTwoResult = await sfCli.deploy({
+                manifestPath: phaseTwoManifestPath,
+                targetOrg,
+                testLevel: phaseTwoTestPlan.testLevel,
+                tests: phaseTwoTestPlan.testLevel === 'RunSpecifiedTests' ? phaseTwoTestPlan.tests : undefined,
+            });
+            if (!phaseTwoResult.success) {
+                await stateManager.saveState({
+                    deploymentId,
+                    targetOrg,
+                    timestamp: new Date().toISOString(),
+                    totalWaves: 2,
+                    completedWaves: [1],
+                    currentWave: 2,
+                    failedWave: {
+                        waveNumber: 2,
+                        error: phaseTwoResult.output,
+                        timestamp: new Date().toISOString(),
+                    },
+                    cycleRemediation: {
+                        cycleId,
+                        strategy: 'comment-reference',
+                        activePhase: 2,
+                        startedAt,
+                        completedPhases: [1],
+                        editRecords,
+                    },
+                    metadata: {
+                        lastKnownStatus: phaseTwoResult.status,
+                        testsRun: phaseTwoResult.testsRun,
+                        testFailures: phaseTwoResult.testFailures,
+                        testLevel: phaseTwoTestPlan.testLevel,
+                    },
+                });
+                failureStateSaved = true;
+                throw new Error(`Cycle remediation phase 2 failed: ${phaseTwoResult.output}`);
+            }
+            await stateManager.clearState();
+            log('\n✅ Cycle remediation deployment completed successfully!');
+        }
+        catch (error) {
+            if (!editsRestored) {
+                await this.restoreCycleEdits(editor, editRecords, true);
+            }
+            if (!failureStateSaved) {
+                await stateManager.saveState({
+                    deploymentId,
+                    targetOrg,
+                    timestamp: new Date().toISOString(),
+                    totalWaves: 2,
+                    completedWaves: [],
+                    currentWave: 1,
+                    failedWave: {
+                        waveNumber: 1,
+                        error: error instanceof Error ? error.message : String(error),
+                        timestamp: new Date().toISOString(),
+                    },
+                    cycleRemediation: {
+                        cycleId,
+                        strategy: 'comment-reference',
+                        activePhase: 1,
+                        startedAt,
+                        completedPhases: [],
+                        editRecords,
+                    },
+                });
+            }
+            throw error;
+        }
+    }
+    async createCycleEditRequest(edit) {
+        if (edit.filePath === undefined) {
+            throw new Error(`Cycle remediation edit for ${edit.nodeId} is missing a file path.`);
+        }
+        const content = await readFile(edit.filePath, 'utf8');
+        const dependencyName = edit.targetDependency.includes(':')
+            ? edit.targetDependency.split(':').pop() ?? edit.targetDependency
+            : edit.targetDependency;
+        const candidateLines = content.split('\n').filter((line) => {
+            const trimmed = line.trim();
+            return trimmed.length > 0 && !trimmed.startsWith('//') && line.includes(dependencyName);
+        });
+        if (candidateLines.length !== 1) {
+            throw new Error(`Cycle remediation for ${edit.nodeId} requires exactly one candidate source line containing ${dependencyName}; found ${candidateLines.length}.`);
+        }
+        return {
+            filePath: edit.filePath,
+            targetDescription: edit.targetDescription,
+            targetDependency: edit.targetDependency,
+            sourceSnippet: candidateLines[0],
+        };
+    }
+    async restoreCycleEdits(editor, editRecords, bestEffort = false) {
+        await this.forEachSequentially([...editRecords].reverse(), async (record) => {
+            const result = await editor.restoreEdit(record);
+            if (!result.restored && result.reason !== 'backup-missing' && !bestEffort) {
+                throw new Error(`Failed to restore cycle remediation edit for ${record.filePath}: ${result.reason ?? 'unknown'}.`);
+            }
+        });
+    }
+    buildSyntheticWave(waveNumber, components, componentMap) {
+        return {
+            number: waveNumber,
+            components,
+            metadata: {
+                componentCount: components.length,
+                types: this.collectWaveTypes(components, componentMap),
+                maxDepth: 0,
+                hasCircularDeps: false,
+                estimatedTime: 0,
+            },
+        };
+    }
+    collectWaveTypes(components, componentMap) {
+        const types = new Set();
+        for (const componentId of components) {
+            const component = componentMap.get(componentId);
+            if (component) {
+                types.add(component.type);
+            }
+        }
+        return Array.from(types);
+    }
+    async forEachSequentially(items, callback) {
+        let chain = Promise.resolve();
+        items.forEach((item, index) => {
+            chain = chain.then(async () => callback(item, index));
+        });
+        await chain;
+    }
+}
+//# sourceMappingURL=cycle-remediation-runner.js.map

package/lib/deployment/cycle-remediation-runner.js.map

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

package/lib/deployment/deployment-context-service.d.ts

@@ -0,0 +1,24 @@
+import { ProjectAnalysisService, type ProjectAnalysisAIContext, type ProjectAnalysisMessages } from '../analysis/project-analysis-service.js';
+import type { ScanResult } from '../services/metadata-scanner-service.js';
+import type { Wave } from '../waves/wave-builder.js';
+export type DeploymentAIContext = ProjectAnalysisAIContext;
+export type DeploymentContextMessages = ProjectAnalysisMessages;
+export type DeploymentContext = {
+    scanResult: ScanResult;
+    orderedWaves: Wave[];
+    aiContext?: DeploymentAIContext;
+    messages: DeploymentContextMessages;
+};
+export type DeploymentContextBuildOptions = {
+    sourcePath?: string;
+    useAI?: boolean;
+    orgType?: string;
+    industry?: string;
+};
+type DeploymentContextServiceDependencies = ConstructorParameters<typeof ProjectAnalysisService>[0];
+export declare class DeploymentContextService {
+    private readonly projectAnalysisService;
+    constructor(dependencies?: DeploymentContextServiceDependencies);
+    buildContext(options?: DeploymentContextBuildOptions): Promise<DeploymentContext>;
+}
+export {};

package/lib/deployment/deployment-context-service.js

@@ -0,0 +1,17 @@
+import { ProjectAnalysisService, } from '../analysis/project-analysis-service.js';
+export class DeploymentContextService {
+    projectAnalysisService;
+    constructor(dependencies = {}) {
+        this.projectAnalysisService = new ProjectAnalysisService(dependencies);
+    }
+    async buildContext(options = {}) {
+        const analysis = await this.projectAnalysisService.buildAnalysis(options);
+        return {
+            scanResult: analysis.scanResult,
+            orderedWaves: analysis.orderedWaves,
+            aiContext: analysis.aiContext,
+            messages: analysis.messages,
+        };
+    }
+}
+//# sourceMappingURL=deployment-context-service.js.map

package/lib/deployment/deployment-context-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-context-service.js","sourceRoot":"","sources":["../../src/deployment/deployment-context-service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,GAGvB,MAAM,yCAAyC,CAAC;AAwBjD,MAAM,OAAO,wBAAwB;IAClB,sBAAsB,CAAyB;IAEhE,YAAmB,eAAqD,EAAE;QACxE,IAAI,CAAC,sBAAsB,GAAG,IAAI,sBAAsB,CAAC,YAAY,CAAC,CAAC;IACzE,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,UAAyC,EAAE;QACnE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC1E,OAAO;YACL,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;SAC5B,CAAC;IACJ,CAAC;CACF"}

package/lib/deployment/deployment-runner.d.ts

@@ -0,0 +1,37 @@
+import type { NodeId } from '../types/dependency.js';
+import type { MetadataComponent } from '../types/metadata.js';
+import type { Wave } from '../waves/wave-builder.js';
+import { DeploymentTracker } from './deployment-tracker.js';
+import { SfCliIntegration } from './sf-cli-integration.js';
+import { StateManager } from './state-manager.js';
+import { TestPlanService } from './test-plan-service.js';
+import { WaveManifestService } from './wave-manifest-service.js';
+import type { TestExecutor } from './test-executor.js';
+import type { DeploymentAIContext } from './deployment-context-service.js';
+export type DeploymentRunnerParams = {
+    deploymentId: string;
+    targetOrg: string;
+    sourcePath?: string;
+    orderedWaves: Wave[];
+    componentMap: ReadonlyMap<NodeId, MetadataComponent>;
+    skipTests: boolean;
+    testExecutor: TestExecutor;
+    tracker: DeploymentTracker;
+    stateManager: StateManager;
+    sfCli: SfCliIntegration;
+    aiContext?: DeploymentAIContext;
+    log: (message: string) => void;
+};
+type DeploymentRunnerDependencies = {
+    testPlanService?: TestPlanService;
+    waveManifestService?: WaveManifestService;
+};
+export declare class DeploymentRunner {
+    private readonly testPlanService;
+    private readonly waveManifestService;
+    constructor(dependencies?: DeploymentRunnerDependencies);
+    execute(params: DeploymentRunnerParams): Promise<void>;
+    private buildAIMetadata;
+    private forEachSequentially;
+}
+export {};