@jterrats/smart-deployment 1.0.3

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

@@ -0,0 +1,161 @@
+import * as path from 'node:path';
+import { glob as globAsync } from 'glob';
+import { MetadataScannerService } from '../services/metadata-scanner-service.js';
+import { getLogger } from '../utils/logger.js';
+import { XmlMetadataValidator } from '../validators/xml-metadata-validator.js';
+import { WaveValidationService } from '../ai/wave-validation-service.js';
+import { WaveBuilder } from '../waves/wave-builder.js';
+import { validateWaveOrder } from '../waves/wave-executor.js';
+const logger = getLogger('DeploymentValidationService');
+export class DeploymentValidationService {
+    scanner = new MetadataScannerService();
+    xmlValidator = new XmlMetadataValidator();
+    async validateProject(sourcePath, options = {}) {
+        const scanResult = await this.scanner.scan({ sourcePath });
+        const waveBuilder = new WaveBuilder({
+            maxComponentsPerWave: 10_000,
+            respectTypeOrder: true,
+            handleCircularDeps: true,
+        });
+        const waveResult = waveBuilder.generateWaves(scanResult.dependencyResult.graph);
+        const issues = [];
+        issues.push(...scanResult.errors.map((message) => ({ severity: 'error', message })), ...scanResult.warnings.map((message) => ({ severity: 'warning', message })));
+        if (!validateWaveOrder(waveResult.waves)) {
+            issues.push({
+                severity: 'error',
+                message: 'Generated waves are not in strict numerical order.',
+            });
+        }
+        if (waveResult.circularDependencies.length > 0) {
+            issues.push({
+                severity: 'error',
+                message: `${waveResult.circularDependencies.length} circular dependency cycle(s) detected.`,
+            });
+        }
+        if (waveResult.unplacedComponents.length > 0) {
+            issues.push({
+                severity: 'warning',
+                message: `${waveResult.unplacedComponents.length} component(s) required manual placement.`,
+            });
+        }
+        const xmlFiles = await this.findXmlMetadataFiles(scanResult.projectRoot);
+        const xmlResults = await this.xmlValidator.validateFiles(xmlFiles);
+        for (const result of xmlResults) {
+            for (const error of result.errors) {
+                issues.push({
+                    severity: error.severity,
+                    message: error.message,
+                    filePath: result.filePath,
+                });
+            }
+            for (const warning of result.warnings) {
+                issues.push({
+                    severity: 'warning',
+                    message: warning.message,
+                    filePath: result.filePath,
+                });
+            }
+        }
+        let aiAnalyzed = false;
+        let overallRisk;
+        let aiProvider;
+        let aiModel;
+        let aiFallback;
+        if (options.useAI) {
+            const aiValidationService = new WaveValidationService({ baseDir: scanResult.projectRoot });
+            const aiValidation = await aiValidationService.validateWaves(waveResult.waves);
+            const providerConfig = aiValidationService.getProviderConfig();
+            aiAnalyzed = aiValidation.aiAnalyzed;
+            overallRisk = aiValidation.overallRisk;
+            aiProvider = providerConfig.provider;
+            aiModel = providerConfig.model;
+            aiFallback = !aiValidation.aiAnalyzed;
+            for (const issue of aiValidation.issues) {
+                issues.push({
+                    severity: issue.severity === 'high' || issue.severity === 'critical' ? 'error' : 'warning',
+                    message: `[AI ${issue.category}] ${issue.message}`,
+                    waveNumber: issue.waveNumber,
+                });
+            }
+            for (const assessment of aiValidation.riskAssessments) {
+                if (assessment.riskLevel === 'high' || assessment.riskLevel === 'critical') {
+                    issues.push({
+                        severity: assessment.riskLevel === 'critical' ? 'error' : 'warning',
+                        message: `[AI risk] Wave ${assessment.waveNumber} assessed as ${assessment.riskLevel}. ${assessment.riskFactors.join(', ') || 'No specific factors reported.'}`,
+                        waveNumber: assessment.waveNumber,
+                    });
+                }
+            }
+        }
+        const valid = issues.every((issue) => issue.severity !== 'error');
+        logger.info('Deployment validation completed', {
+            components: scanResult.components.length,
+            totalWaves: waveResult.waves.length,
+            xmlFilesValidated: xmlFiles.length,
+            valid,
+            issues: issues.length,
+        });
+        return {
+            valid,
+            components: scanResult.components.length,
+            totalWaves: waveResult.waves.length,
+            estimatedTime: waveResult.stats.totalEstimatedTime,
+            xmlFilesValidated: xmlFiles.length,
+            issues,
+            aiAnalyzed,
+            overallRisk,
+            aiProvider,
+            aiModel,
+            aiFallback,
+        };
+    }
+    formatSummary(summary) {
+        const lines = [
+            `Validation: ${summary.valid ? 'PASSED' : 'FAILED'}`,
+            `Components: ${summary.components}`,
+            `Waves: ${summary.totalWaves}`,
+            `Estimated Time: ${summary.estimatedTime}s`,
+            `XML Files Validated: ${summary.xmlFilesValidated}`,
+        ];
+        if (summary.aiAnalyzed !== undefined) {
+            lines.push(`AI Validation: ${summary.aiAnalyzed ? 'ENABLED' : 'UNAVAILABLE'}`);
+        }
+        if (summary.aiProvider) {
+            lines.push(`AI Provider: ${summary.aiProvider}`);
+        }
+        if (summary.aiModel) {
+            lines.push(`AI Model: ${summary.aiModel}`);
+        }
+        if (summary.aiFallback !== undefined) {
+            lines.push(`AI Fallback: ${summary.aiFallback ? 'YES' : 'NO'}`);
+        }
+        if (summary.overallRisk) {
+            lines.push(`AI Overall Risk: ${summary.overallRisk.toUpperCase()}`);
+        }
+        if (summary.issues.length > 0) {
+            lines.push('');
+            lines.push('Issues:');
+            for (const issue of summary.issues) {
+                const location = issue.filePath
+                    ? ` (${issue.filePath})`
+                    : issue.waveNumber !== undefined
+                        ? ` (wave ${issue.waveNumber})`
+                        : '';
+                lines.push(`- [${issue.severity}] ${issue.message}${location}`);
+            }
+        }
+        return lines.join('\n');
+    }
+    async findXmlMetadataFiles(projectRoot) {
+        const files = await globAsync('**/*-meta.xml', {
+            cwd: projectRoot,
+            absolute: true,
+            ignore: ['**/node_modules/**', '**/.git/**'],
+        });
+        return files.filter((filePath) => {
+            const normalized = filePath.split(path.sep).join('/');
+            return !normalized.includes('/node_modules/') && !normalized.includes('/.git/');
+        });
+    }
+}
+//# sourceMappingURL=deployment-validation-service.js.map

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

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

package/lib/deployment/retry-handler.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Deployment Retry Logic - US-088
+ * Handles automatic retry on transient failures
+ *
+ * @ac US-088-AC-1: Detect retryable errors
+ * @ac US-088-AC-2: Retry up to 3 times
+ * @ac US-088-AC-3: Exponential backoff
+ * @ac US-088-AC-4: Retry without tests (sandbox)
+ * @ac US-088-AC-5: Report retry attempts
+ * @ac US-088-AC-6: Fail after max retries
+ * @issue #88
+ */
+export type RetryConfig = {
+    maxRetries: number;
+    initialDelay: number;
+    maxDelay: number;
+};
+/**
+ * @ac US-088-AC-1: Detect retryable errors
+ */
+export declare class RetryHandler {
+    private readonly config;
+    constructor(config?: Partial<RetryConfig>);
+    isRetryable(error: string): boolean;
+    /**
+     * @ac US-088-AC-2: Retry up to 3 times
+     * @ac US-088-AC-3: Exponential backoff
+     * @ac US-088-AC-5: Report retry attempts
+     * @ac US-088-AC-6: Fail after max retries
+     */
+    executeWithRetry<T>(fn: () => Promise<T>, context: string): Promise<T>;
+    /**
+     * @ac US-088-AC-3: Exponential backoff
+     */
+    private calculateDelay;
+    private sleep;
+}

package/lib/deployment/retry-handler.js

@@ -0,0 +1,86 @@
+/**
+ * Deployment Retry Logic - US-088
+ * Handles automatic retry on transient failures
+ *
+ * @ac US-088-AC-1: Detect retryable errors
+ * @ac US-088-AC-2: Retry up to 3 times
+ * @ac US-088-AC-3: Exponential backoff
+ * @ac US-088-AC-4: Retry without tests (sandbox)
+ * @ac US-088-AC-5: Report retry attempts
+ * @ac US-088-AC-6: Fail after max retries
+ * @issue #88
+ */
+import { getLogger } from '../utils/logger.js';
+const logger = getLogger('RetryHandler');
+const RETRYABLE_ERRORS = [
+    'UNABLE_TO_LOCK_ROW',
+    'REQUEST_LIMIT_EXCEEDED',
+    'STORAGE_LIMIT_EXCEEDED',
+    'CONNECTION_ERROR',
+    'TIMEOUT',
+];
+/**
+ * @ac US-088-AC-1: Detect retryable errors
+ */
+export class RetryHandler {
+    config;
+    constructor(config = {}) {
+        this.config = {
+            maxRetries: config.maxRetries ?? 3,
+            initialDelay: config.initialDelay ?? 1000,
+            maxDelay: config.maxDelay ?? 30_000,
+        };
+    }
+    isRetryable(error) {
+        return RETRYABLE_ERRORS.some((pattern) => error.includes(pattern));
+    }
+    /**
+     * @ac US-088-AC-2: Retry up to 3 times
+     * @ac US-088-AC-3: Exponential backoff
+     * @ac US-088-AC-5: Report retry attempts
+     * @ac US-088-AC-6: Fail after max retries
+     */
+    async executeWithRetry(fn, context) {
+        let lastError;
+        const attemptExecution = async (attempt) => {
+            try {
+                if (attempt > 0) {
+                    const delay = this.calculateDelay(attempt);
+                    logger.info('Retrying operation', { context, attempt, delay });
+                    await this.sleep(delay);
+                }
+                return await fn();
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                if (!this.isRetryable(lastError.message)) {
+                    logger.warn('Non-retryable error encountered', { context, error: lastError.message });
+                    throw lastError;
+                }
+                if (attempt === this.config.maxRetries) {
+                    logger.error('Max retries exceeded', { context, attempt, error: lastError.message });
+                    throw new Error(`Max retries (${this.config.maxRetries}) exceeded: ${lastError.message}`);
+                }
+                logger.warn('Retryable error, will retry', { context, attempt, error: lastError.message });
+                return attemptExecution(attempt + 1);
+            }
+        };
+        return attemptExecution(0).catch((error) => {
+            if (error instanceof Error) {
+                throw error;
+            }
+            throw lastError ?? new Error('Retry failed');
+        });
+    }
+    /**
+     * @ac US-088-AC-3: Exponential backoff
+     */
+    calculateDelay(attempt) {
+        const delay = this.config.initialDelay * Math.pow(2, attempt - 1);
+        return Math.min(delay, this.config.maxDelay);
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=retry-handler.js.map

package/lib/deployment/retry-handler.js.map

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

package/lib/deployment/sf-cli-integration.d.ts

@@ -0,0 +1,42 @@
+/**
+ * SF CLI Integration - US-085
+ * Executes deployments via official Salesforce CLI
+ *
+ * @ac US-085-AC-1: Execute sf project deploy start
+ * @ac US-085-AC-2: Pass manifest file
+ * @ac US-085-AC-3: Pass test level
+ * @ac US-085-AC-4: Pass target org
+ * @ac US-085-AC-5: Capture output
+ * @ac US-085-AC-6: Parse deployment results
+ * @issue #85
+ */
+export type TestLevel = 'NoTestRun' | 'RunSpecifiedTests' | 'RunLocalTests' | 'RunAllTestsInOrg';
+export type DeploymentOptions = {
+    manifestPath: string;
+    targetOrg: string;
+    testLevel?: TestLevel;
+    tests?: string[];
+    checkOnly?: boolean;
+};
+export type DeploymentResult = {
+    success: boolean;
+    deploymentId?: string;
+    status: string;
+    componentSuccesses: number;
+    componentFailures: number;
+    testsRun?: number;
+    testFailures?: number;
+    output: string;
+};
+/**
+ * @ac US-085-AC-1: Execute sf project deploy start
+ * @ac US-085-AC-2: Pass manifest file
+ * @ac US-085-AC-3: Pass test level
+ * @ac US-085-AC-4: Pass target org
+ */
+export declare class SfCliIntegration {
+    deploy(options: DeploymentOptions): Promise<DeploymentResult>;
+    private buildDeployCommand;
+    private parseDeploymentOutput;
+    checkDeploymentStatus(deploymentId: string, targetOrg: string): Promise<DeploymentResult>;
+}

package/lib/deployment/sf-cli-integration.js

@@ -0,0 +1,105 @@
+/**
+ * SF CLI Integration - US-085
+ * Executes deployments via official Salesforce CLI
+ *
+ * @ac US-085-AC-1: Execute sf project deploy start
+ * @ac US-085-AC-2: Pass manifest file
+ * @ac US-085-AC-3: Pass test level
+ * @ac US-085-AC-4: Pass target org
+ * @ac US-085-AC-5: Capture output
+ * @ac US-085-AC-6: Parse deployment results
+ * @issue #85
+ */
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+import { getLogger } from '../utils/logger.js';
+const execAsync = promisify(exec);
+const logger = getLogger('SfCliIntegration');
+/**
+ * @ac US-085-AC-1: Execute sf project deploy start
+ * @ac US-085-AC-2: Pass manifest file
+ * @ac US-085-AC-3: Pass test level
+ * @ac US-085-AC-4: Pass target org
+ */
+export class SfCliIntegration {
+    async deploy(options) {
+        logger.info('Starting deployment', { options });
+        const command = this.buildDeployCommand(options);
+        try {
+            // AC-5: Capture output
+            const { stdout, stderr } = await execAsync(command);
+            const output = stdout + stderr;
+            // AC-6: Parse deployment results
+            const result = this.parseDeploymentOutput(output);
+            logger.info('Deployment completed', { result });
+            return result;
+        }
+        catch (error) {
+            logger.error('Deployment failed', { error });
+            const output = error instanceof Error ? error.message : String(error);
+            return this.parseDeploymentOutput(output, true);
+        }
+    }
+    buildDeployCommand(options) {
+        const parts = [
+            'sf project deploy start',
+            `--manifest ${options.manifestPath}`,
+            `--target-org ${options.targetOrg}`,
+            '--json',
+            '--wait 60',
+        ];
+        if (options.testLevel) {
+            parts.push(`--test-level ${options.testLevel}`);
+        }
+        if (options.tests && options.tests.length > 0) {
+            parts.push(`--tests ${options.tests.join(' ')}`);
+        }
+        if (options.checkOnly) {
+            parts.push('--dry-run');
+        }
+        return parts.join(' ');
+    }
+    parseDeploymentOutput(output, failed = false) {
+        try {
+            // Try to parse JSON output
+            const jsonMatch = output.match(/\{[\s\S]*\}/);
+            if (jsonMatch) {
+                const parsed = JSON.parse(jsonMatch[0]);
+                return {
+                    success: !failed && (parsed.result?.status === 'Succeeded' || parsed.result?.status === 'Success'),
+                    deploymentId: parsed.result?.id,
+                    status: parsed.result?.status ?? 'Unknown',
+                    componentSuccesses: parsed.result?.numberComponentsDeployed ?? 0,
+                    componentFailures: parsed.result?.numberComponentErrors ?? 0,
+                    testsRun: parsed.result?.numberTestsTotal,
+                    testFailures: parsed.result?.numberTestErrors,
+                    output,
+                };
+            }
+        }
+        catch (parseError) {
+            logger.warn('Failed to parse deployment output', { parseError });
+        }
+        // Fallback for non-JSON output
+        return {
+            success: !failed,
+            status: failed ? 'Failed' : 'Unknown',
+            componentSuccesses: 0,
+            componentFailures: failed ? 1 : 0,
+            output,
+        };
+    }
+    async checkDeploymentStatus(deploymentId, targetOrg) {
+        const command = `sf project deploy report --job-id ${deploymentId} --target-org ${targetOrg} --json`;
+        try {
+            const { stdout } = await execAsync(command);
+            return this.parseDeploymentOutput(stdout);
+        }
+        catch (error) {
+            logger.error('Failed to check deployment status', { error, deploymentId });
+            const output = error instanceof Error ? error.message : String(error);
+            return this.parseDeploymentOutput(output, true);
+        }
+    }
+}
+//# sourceMappingURL=sf-cli-integration.js.map

package/lib/deployment/sf-cli-integration.js.map

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

package/lib/deployment/state-manager.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Deployment State Persistence - US-089
+ * Saves deployment state for resume capability
+ *
+ * @ac US-089-AC-1: Save state after each wave
+ * @ac US-089-AC-2: Include completed waves
+ * @ac US-089-AC-3: Include failed wave details
+ * @ac US-089-AC-4: Support resume from failure
+ * @ac US-089-AC-5: Clean up state on success
+ * @ac US-089-AC-6: Include deployment metadata
+ * @issue #89
+ */
+import type { CycleSourceEditRecord } from './cycle-source-editor.js';
+export type CycleRemediationState = {
+    cycleId: string;
+    strategy: 'comment-reference' | 'manual';
+    activePhase: 1 | 2;
+    startedAt: string;
+    completedPhases: Array<1 | 2>;
+    editRecords: CycleSourceEditRecord[];
+};
+export type DeploymentState = {
+    deploymentId: string;
+    targetOrg: string;
+    timestamp: string;
+    totalWaves: number;
+    completedWaves: number[];
+    currentWave?: number;
+    failedWave?: {
+        waveNumber: number;
+        error: string;
+        timestamp: string;
+    };
+    cycleRemediation?: CycleRemediationState;
+    metadata?: Record<string, unknown>;
+};
+export type StateManagerOptions = {
+    baseDir?: string;
+};
+/**
+ * @ac US-089-AC-1: Save state after each wave
+ * @ac US-089-AC-2: Include completed waves
+ * @ac US-089-AC-3: Include failed wave details
+ */
+export declare class StateManager {
+    private readonly stateDir;
+    private readonly stateFile;
+    constructor(options?: StateManagerOptions);
+    saveState(state: DeploymentState): Promise<void>;
+    /**
+     * @ac US-089-AC-4: Support resume from failure
+     */
+    loadState(): Promise<DeploymentState | null>;
+    /**
+     * @ac US-089-AC-5: Clean up state on success
+     */
+    clearState(): Promise<void>;
+    hasFailedDeployment(): Promise<boolean>;
+    getStateFilePath(): string;
+    private normalizeState;
+}

package/lib/deployment/state-manager.js

@@ -0,0 +1,83 @@
+/**
+ * Deployment State Persistence - US-089
+ * Saves deployment state for resume capability
+ *
+ * @ac US-089-AC-1: Save state after each wave
+ * @ac US-089-AC-2: Include completed waves
+ * @ac US-089-AC-3: Include failed wave details
+ * @ac US-089-AC-4: Support resume from failure
+ * @ac US-089-AC-5: Clean up state on success
+ * @ac US-089-AC-6: Include deployment metadata
+ * @issue #89
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { getLogger } from '../utils/logger.js';
+const logger = getLogger('StateManager');
+/**
+ * @ac US-089-AC-1: Save state after each wave
+ * @ac US-089-AC-2: Include completed waves
+ * @ac US-089-AC-3: Include failed wave details
+ */
+export class StateManager {
+    stateDir;
+    stateFile;
+    constructor(options = {}) {
+        const baseDir = options.baseDir ?? process.cwd();
+        this.stateDir = path.join(baseDir, '.smart-deployment');
+        this.stateFile = path.join(this.stateDir, 'deployment-state.json');
+    }
+    async saveState(state) {
+        logger.info('Saving deployment state', { state });
+        await fs.mkdir(this.stateDir, { recursive: true });
+        await fs.writeFile(this.stateFile, JSON.stringify(state, null, 2), 'utf-8');
+    }
+    /**
+     * @ac US-089-AC-4: Support resume from failure
+     */
+    async loadState() {
+        try {
+            const content = await fs.readFile(this.stateFile, 'utf-8');
+            const state = JSON.parse(content);
+            logger.info('Loaded deployment state', { state });
+            return this.normalizeState(state);
+        }
+        catch {
+            logger.info('No previous deployment state found');
+            return null;
+        }
+    }
+    /**
+     * @ac US-089-AC-5: Clean up state on success
+     */
+    async clearState() {
+        try {
+            await fs.unlink(this.stateFile);
+            logger.info('Cleared deployment state');
+        }
+        catch {
+            // File doesn't exist, nothing to clear
+        }
+    }
+    async hasFailedDeployment() {
+        const state = await this.loadState();
+        return state?.failedWave !== undefined;
+    }
+    getStateFilePath() {
+        return this.stateFile;
+    }
+    normalizeState(state) {
+        if (state.cycleRemediation === undefined) {
+            return state;
+        }
+        return {
+            ...state,
+            cycleRemediation: {
+                ...state.cycleRemediation,
+                completedPhases: [...state.cycleRemediation.completedPhases],
+                editRecords: [...state.cycleRemediation.editRecords],
+            },
+        };
+    }
+}
+//# sourceMappingURL=state-manager.js.map

package/lib/deployment/state-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-manager.js","sourceRoot":"","sources":["../../src/deployment/state-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,MAAM,MAAM,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC;AA+BzC;;;;GAIG;AACH,MAAM,OAAO,YAAY;IACN,QAAQ,CAAS;IACjB,SAAS,CAAS;IAEnC,YAAmB,UAA+B,EAAE;QAClD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACjD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;QACxD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAAC;IACrE,CAAC;IAEM,KAAK,CAAC,SAAS,CAAC,KAAsB;QAC3C,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAElD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,SAAS;QACpB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAoB,CAAC;YACrD,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAClD,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;YAClD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,UAAU;QACrB,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAChC,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,mBAAmB;QAC9B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACrC,OAAO,KAAK,EAAE,UAAU,KAAK,SAAS,CAAC;IACzC,CAAC;IAEM,gBAAgB;QACrB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEO,cAAc,CAAC,KAAsB;QAC3C,IAAI,KAAK,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACzC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO;YACL,GAAG,KAAK;YACR,gBAAgB,EAAE;gBAChB,GAAG,KAAK,CAAC,gBAAgB;gBACzB,eAAe,EAAE,CAAC,GAAG,KAAK,CAAC,gBAAgB,CAAC,eAAe,CAAC;gBAC5D,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC,gBAAgB,CAAC,WAAW,CAAC;aACrD;SACF,CAAC;IACJ,CAAC;CACF"}

package/lib/deployment/test-executor.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Test Execution Management - US-087
+ * Manages intelligent test execution per wave
+ *
+ * @ac US-087-AC-1: Run tests only in Apex waves
+ * @ac US-087-AC-2: Support RunLocalTests
+ * @ac US-087-AC-3: Support RunSpecifiedTests
+ * @ac US-087-AC-4: Support NoTestRun (sandbox)
+ * @ac US-087-AC-5: Track test results
+ * @ac US-087-AC-6: Report coverage
+ * @issue #87
+ */
+import type { Wave } from '../waves/wave-builder.js';
+import type { TestLevel } from './sf-cli-integration.js';
+export type TestExecutionPlan = {
+    testLevel: TestLevel;
+    tests: string[];
+    reason: string;
+};
+export type TestResults = {
+    testsRun: number;
+    testFailures: number;
+    coverage?: number;
+    failedTests: string[];
+};
+/**
+ * @ac US-087-AC-1: Run tests only in Apex waves
+ * @ac US-087-AC-2: Support RunLocalTests
+ * @ac US-087-AC-3: Support RunSpecifiedTests
+ * @ac US-087-AC-4: Support NoTestRun (sandbox)
+ */
+export declare class TestExecutor {
+    determineTestLevel(wave: Wave, isSandbox: boolean): TestExecutionPlan;
+    private findRelatedTests;
+    /**
+     * @ac US-087-AC-5: Track test results
+     * @ac US-087-AC-6: Report coverage
+     */
+    analyzeTestResults(testsRun: number, testFailures: number, coverage?: number): TestResults;
+    formatTestResults(results: TestResults): string;
+}