@jterrats/smart-deployment 1.0.3

package/lib/deployment/deployment-state-summary.js

@@ -0,0 +1,209 @@
+function getMetadataNumber(metadata, key) {
+    const value = metadata[key];
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function getMetadataString(metadata, key) {
+    const value = metadata[key];
+    return typeof value === 'string' ? value : undefined;
+}
+function getMetadataBoolean(metadata, key) {
+    const value = metadata[key];
+    return typeof value === 'boolean' ? value : undefined;
+}
+function getMetadataStringArray(metadata, key) {
+    const value = metadata[key];
+    return Array.isArray(value) ? value.filter((item) => typeof item === 'string') : undefined;
+}
+function normalizeCompletedWaves(state) {
+    const rawCompleted = [...new Set(state.completedWaves)]
+        .filter((wave) => Number.isInteger(wave) && wave > 0 && wave <= state.totalWaves)
+        .sort((a, b) => a - b);
+    if (!state.failedWave) {
+        return rawCompleted;
+    }
+    const inferredCompleted = Array.from({ length: Math.max(0, state.failedWave.waveNumber - 1) }, (_, index) => index + 1);
+    const failedWaveNumber = state.failedWave.waveNumber;
+    return [...new Set([...rawCompleted.filter((wave) => wave < failedWaveNumber), ...inferredCompleted])].sort((a, b) => a - b);
+}
+function inferCurrentWave(state, completedWaves) {
+    if (state.failedWave) {
+        return state.failedWave.waveNumber;
+    }
+    if (state.currentWave && state.currentWave > 0) {
+        return state.currentWave;
+    }
+    const lastCompleted = completedWaves.at(-1) ?? 0;
+    return Math.min(lastCompleted + 1, Math.max(state.totalWaves, 1));
+}
+function describeCycleRemediationStatus(state) {
+    if (state.cycleRemediation === undefined) {
+        return undefined;
+    }
+    const { cycleId, strategy, activePhase, completedPhases, startedAt, editRecords } = state.cycleRemediation;
+    const normalizedCompletedPhases = [...new Set(completedPhases)].sort((a, b) => a - b);
+    let statusText;
+    if (strategy === 'manual') {
+        statusText = 'Manual remediation required before deployment can continue.';
+    }
+    else if (activePhase === 1) {
+        statusText = 'Phase 1 of 2: Deploy temporarily cycle-broken metadata.';
+    }
+    else {
+        statusText = 'Phase 2 of 2: Restore original references and redeploy the same components.';
+    }
+    return {
+        cycleId,
+        strategy,
+        activePhase,
+        completedPhases: normalizedCompletedPhases,
+        startedAt,
+        editCount: editRecords.length,
+        statusText,
+    };
+}
+function calculateEtaSeconds(metadata, state, remainingWaves, completedWaves, nowTimestamp) {
+    const explicitEta = getMetadataNumber(metadata, 'estimatedTimeRemainingSeconds');
+    const totalEstimatedTime = getMetadataNumber(metadata, 'totalEstimatedTimeSeconds');
+    const averageWaveDuration = getMetadataNumber(metadata, 'averageWaveDurationSeconds');
+    const startedAt = Date.parse(state.timestamp);
+    if (explicitEta !== undefined) {
+        return explicitEta;
+    }
+    if (remainingWaves === 0) {
+        return 0;
+    }
+    if (totalEstimatedTime !== undefined && state.totalWaves > 0) {
+        return Math.round((totalEstimatedTime / state.totalWaves) * remainingWaves);
+    }
+    if (!Number.isNaN(startedAt) && completedWaves.length > 0) {
+        const elapsedSeconds = Math.max(1, Math.round((nowTimestamp - startedAt) / 1000));
+        return Math.round((elapsedSeconds / completedWaves.length) * remainingWaves);
+    }
+    return Math.round((averageWaveDuration ?? 60) * remainingWaves);
+}
+function buildTestStatus(metadata) {
+    const testsRun = getMetadataNumber(metadata, 'testsRun');
+    const testFailures = getMetadataNumber(metadata, 'testFailures');
+    const configuredTestLevel = getMetadataString(metadata, 'testLevel');
+    const skipTests = metadata.skipTests === true || configuredTestLevel === 'NoTestRun';
+    return (getMetadataString(metadata, 'testStatus') ??
+        (skipTests
+            ? 'No tests run'
+            : testsRun !== undefined
+                ? `Tests run: ${testsRun}${testFailures !== undefined ? ` (${testFailures} failures)` : ''}`
+                : configuredTestLevel
+                    ? `Pending (${configuredTestLevel})`
+                    : 'Not started'));
+}
+function buildAIStatus(metadata) {
+    return {
+        provider: getMetadataString(metadata, 'aiProvider'),
+        model: getMetadataString(metadata, 'aiModel'),
+        fallback: getMetadataBoolean(metadata, 'aiFallback'),
+        aiAdjustments: getMetadataNumber(metadata, 'aiAdjustments'),
+        unknownTypes: getMetadataStringArray(metadata, 'aiUnknownTypes'),
+        inferenceFallback: getMetadataBoolean(metadata, 'aiInferenceFallback'),
+        inferredDependencies: getMetadataNumber(metadata, 'aiInferredDependencies'),
+    };
+}
+export function summarizeDeploymentState(state, nowTimestamp = Date.now()) {
+    const metadata = state.metadata ?? {};
+    const completedWaves = normalizeCompletedWaves(state);
+    const currentWave = inferCurrentWave(state, completedWaves);
+    const canResume = state.failedWave !== undefined;
+    let status = 'In Progress';
+    if (canResume) {
+        status = 'Failed';
+    }
+    else if (state.totalWaves > 0 && completedWaves.length >= state.totalWaves) {
+        status = 'Completed';
+    }
+    const remainingWaves = canResume
+        ? Math.max(0, state.totalWaves - currentWave + 1)
+        : Math.max(0, state.totalWaves - completedWaves.length);
+    const etaSeconds = calculateEtaSeconds(metadata, state, remainingWaves, completedWaves, nowTimestamp);
+    const testStatus = buildTestStatus(metadata);
+    const cycleRemediation = describeCycleRemediationStatus(state);
+    const ai = buildAIStatus(metadata);
+    const hasAIContext = ai !== undefined && Object.values(ai).some((value) => value !== undefined);
+    return {
+        deploymentId: state.deploymentId,
+        targetOrg: state.targetOrg,
+        status,
+        currentWave,
+        totalWaves: state.totalWaves,
+        completedWaves,
+        remainingWaves,
+        canResume,
+        etaSeconds,
+        testStatus,
+        lastUpdated: state.failedWave?.timestamp ?? state.timestamp,
+        failedWaveNumber: state.failedWave?.waveNumber,
+        failureReason: state.failedWave?.error,
+        cycleRemediation,
+        ai: hasAIContext ? ai : undefined,
+    };
+}
+export function createResumedState(state, retryStrategy, resumedAt = new Date().toISOString()) {
+    const metadata = { ...(state.metadata ?? {}) };
+    const completedWaves = normalizeCompletedWaves(state);
+    const resumeWave = state.failedWave?.waveNumber ?? inferCurrentWave(state, completedWaves);
+    const previousResumeCount = typeof metadata.resumeCount === 'number' ? metadata.resumeCount : 0;
+    return {
+        ...state,
+        timestamp: resumedAt,
+        currentWave: resumeWave,
+        completedWaves: completedWaves.filter((wave) => wave < resumeWave),
+        failedWave: undefined,
+        metadata: {
+            ...metadata,
+            lastKnownStatus: 'Resumed',
+            resumedAt,
+            retryStrategy,
+            resumeCount: previousResumeCount + 1,
+            resumedFromWave: resumeWave,
+        },
+    };
+}
+export function formatDeploymentStatus(summary) {
+    const lines = [
+        `Deployment ID: ${summary.deploymentId}`,
+        `Target Org: ${summary.targetOrg}`,
+        `Status: ${summary.status}`,
+        `Current Wave: ${summary.currentWave}/${summary.totalWaves}`,
+        `Completed Waves: ${summary.completedWaves.length > 0 ? summary.completedWaves.join(', ') : 'none'}`,
+        `Remaining Waves: ${summary.remainingWaves}`,
+        `Estimated Time Remaining: ${summary.etaSeconds}s`,
+        `Test Status: ${summary.testStatus}`,
+        `Last Updated: ${summary.lastUpdated}`,
+    ];
+    if (summary.failedWaveNumber !== undefined && summary.failureReason) {
+        lines.push(`Failure: Wave ${summary.failedWaveNumber} - ${summary.failureReason}`);
+    }
+    if (summary.cycleRemediation !== undefined) {
+        lines.push(`Cycle Remediation: ${summary.cycleRemediation.statusText}`);
+        lines.push(`Remediation Cycle: ${summary.cycleRemediation.cycleId}`);
+        lines.push(`Remediation Strategy: ${summary.cycleRemediation.strategy}`);
+        lines.push(`Remediation Completed Phases: ${summary.cycleRemediation.completedPhases.length > 0
+            ? summary.cycleRemediation.completedPhases.join(', ')
+            : 'none'}`);
+    }
+    if (summary.ai !== undefined) {
+        lines.push(`AI Provider: ${summary.ai.provider ?? 'unknown'}`);
+        lines.push(`AI Model: ${summary.ai.model ?? 'default'}`);
+        if (summary.ai.fallback !== undefined) {
+            lines.push(`AI Fallback: ${summary.ai.fallback ? 'YES' : 'NO'}`);
+        }
+        if (summary.ai.aiAdjustments !== undefined) {
+            lines.push(`AI Adjustments: ${summary.ai.aiAdjustments}`);
+        }
+        if (summary.ai.inferredDependencies !== undefined) {
+            lines.push(`AI Inferred Dependencies: ${summary.ai.inferredDependencies}`);
+        }
+        if (summary.ai.inferenceFallback !== undefined) {
+            lines.push(`AI Inference Fallback: ${summary.ai.inferenceFallback ? 'YES' : 'NO'}`);
+        }
+    }
+    return lines;
+}
+//# sourceMappingURL=deployment-state-summary.js.map

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

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

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

@@ -0,0 +1,36 @@
+import { StateManager } from './state-manager.js';
+export type DeploymentStatusSummary = {
+    hasState: boolean;
+    status: 'not-started' | 'in-progress' | 'failed' | 'completed';
+    deploymentId?: string;
+    targetOrg?: string;
+    currentWave: number;
+    totalWaves: number;
+    completedWaves: number[];
+    remainingWaves: number[];
+    failedWaveNumber?: number;
+    failedWaveError?: string;
+    resumable: boolean;
+    testStatus: 'unknown' | 'pending' | 'not-run';
+    timestamp?: string;
+    stateFilePath: string;
+};
+export type ResumeSummary = {
+    success: boolean;
+    reason?: string;
+    resumeWave?: number;
+    completedWaves: number[];
+    remainingWaves: number[];
+    targetOrg?: string;
+    deploymentId?: string;
+};
+export declare class DeploymentStatusService {
+    private readonly stateManager;
+    constructor(stateManager?: StateManager);
+    getStatus(): Promise<DeploymentStatusSummary>;
+    getResumeSummary(): Promise<ResumeSummary>;
+    formatStatus(summary: DeploymentStatusSummary): string;
+    private expandRemainingWaves;
+    private normalizeStatus;
+    private normalizeTestStatus;
+}

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

@@ -0,0 +1,128 @@
+import { getLogger } from '../utils/logger.js';
+import { summarizeDeploymentState } from './deployment-state-summary.js';
+import { StateManager } from './state-manager.js';
+const logger = getLogger('DeploymentStatusService');
+export class DeploymentStatusService {
+    stateManager;
+    constructor(stateManager = new StateManager()) {
+        this.stateManager = stateManager;
+    }
+    async getStatus() {
+        const state = await this.stateManager.loadState();
+        if (!state) {
+            return {
+                hasState: false,
+                status: 'not-started',
+                currentWave: 0,
+                totalWaves: 0,
+                completedWaves: [],
+                remainingWaves: [],
+                resumable: false,
+                testStatus: 'unknown',
+                stateFilePath: this.stateManager.getStateFilePath(),
+            };
+        }
+        const summary = summarizeDeploymentState(state);
+        logger.info('Deployment status loaded', {
+            deploymentId: summary.deploymentId,
+            status: summary.status,
+            currentWave: summary.currentWave,
+            totalWaves: summary.totalWaves,
+        });
+        return {
+            hasState: true,
+            status: this.normalizeStatus(summary.status),
+            deploymentId: summary.deploymentId,
+            targetOrg: summary.targetOrg,
+            currentWave: summary.currentWave,
+            totalWaves: summary.totalWaves,
+            completedWaves: summary.completedWaves,
+            remainingWaves: this.expandRemainingWaves(summary.currentWave, summary.remainingWaves, summary.totalWaves),
+            failedWaveNumber: summary.failedWaveNumber,
+            failedWaveError: summary.failureReason,
+            resumable: summary.canResume,
+            testStatus: this.normalizeTestStatus(summary.testStatus),
+            timestamp: summary.lastUpdated,
+            stateFilePath: this.stateManager.getStateFilePath(),
+        };
+    }
+    async getResumeSummary() {
+        const summary = await this.getStatus();
+        if (!summary.hasState) {
+            return {
+                success: false,
+                reason: 'No previous deployment state found.',
+                completedWaves: [],
+                remainingWaves: [],
+            };
+        }
+        if (!summary.resumable || summary.failedWaveNumber === undefined) {
+            return {
+                success: false,
+                reason: 'No failed deployment was found to resume.',
+                completedWaves: summary.completedWaves,
+                remainingWaves: summary.remainingWaves,
+                targetOrg: summary.targetOrg,
+                deploymentId: summary.deploymentId,
+            };
+        }
+        return {
+            success: true,
+            resumeWave: summary.failedWaveNumber,
+            completedWaves: summary.completedWaves,
+            remainingWaves: summary.remainingWaves,
+            targetOrg: summary.targetOrg,
+            deploymentId: summary.deploymentId,
+        };
+    }
+    formatStatus(summary) {
+        if (!summary.hasState) {
+            return ['No deployment state found.', `Expected state file: ${summary.stateFilePath}`].join('\n');
+        }
+        const lines = [
+            `Status: ${summary.status}`,
+            `Deployment ID: ${summary.deploymentId ?? 'unknown'}`,
+            `Target Org: ${summary.targetOrg ?? 'unknown'}`,
+            `Current Wave: ${summary.currentWave}/${summary.totalWaves}`,
+            `Completed Waves: ${summary.completedWaves.length > 0 ? summary.completedWaves.join(', ') : 'none'}`,
+            `Remaining Waves: ${summary.remainingWaves.length > 0 ? summary.remainingWaves.join(', ') : 'none'}`,
+            `Test Status: ${summary.testStatus}`,
+            `Updated: ${summary.timestamp ?? 'unknown'}`,
+        ];
+        if (summary.failedWaveNumber !== undefined) {
+            lines.push(`Failed Wave: ${summary.failedWaveNumber}`);
+        }
+        if (summary.failedWaveError) {
+            lines.push(`Failure: ${summary.failedWaveError}`);
+        }
+        return lines.join('\n');
+    }
+    expandRemainingWaves(currentWave, remainingCount, totalWaves) {
+        return Array.from({ length: remainingCount }, (_, index) => currentWave + index).filter((wave) => wave <= totalWaves);
+    }
+    normalizeStatus(status) {
+        switch (status) {
+            case 'Not Started':
+                return 'not-started';
+            case 'In Progress':
+                return 'in-progress';
+            case 'Failed':
+                return 'failed';
+            default:
+                return 'completed';
+        }
+    }
+    normalizeTestStatus(testStatus) {
+        if (testStatus === 'Not started') {
+            return 'unknown';
+        }
+        if (testStatus.toLowerCase().includes('no') && testStatus.toLowerCase().includes('test')) {
+            return 'not-run';
+        }
+        if (testStatus.toLowerCase().includes('pending') || testStatus.toLowerCase().includes('tests run')) {
+            return 'pending';
+        }
+        return 'pending';
+    }
+}
+//# sourceMappingURL=deployment-status-service.js.map

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

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

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

@@ -0,0 +1,42 @@
+/**
+ * Deployment Progress Tracker - US-086
+ * Tracks real-time deployment progress
+ *
+ * @ac US-086-AC-1: Track deployment ID
+ * @ac US-086-AC-2: Poll deployment status
+ * @ac US-086-AC-3: Show progress percentage
+ * @ac US-086-AC-4: Show current component deploying
+ * @ac US-086-AC-5: Show ETA
+ * @ac US-086-AC-6: Show wave progress
+ * @issue #86
+ */
+import type { DeploymentResult } from './sf-cli-integration.js';
+export type DeploymentProgress = {
+    deploymentId: string;
+    waveNumber: number;
+    totalWaves: number;
+    percentage: number;
+    currentComponent?: string;
+    eta?: number;
+    status: string;
+};
+/**
+ * @ac US-086-AC-1: Track deployment ID
+ * @ac US-086-AC-2: Poll deployment status
+ */
+export declare class DeploymentTracker {
+    private deployments;
+    private startTimes;
+    startTracking(deploymentId: string, waveNumber: number, totalWaves: number): void;
+    /**
+     * @ac US-086-AC-3: Show progress percentage
+     * @ac US-086-AC-4: Show current component deploying
+     * @ac US-086-AC-5: Show ETA
+     */
+    updateProgress(deploymentId: string, result: DeploymentResult): void;
+    /**
+     * @ac US-086-AC-6: Show wave progress
+     */
+    getProgress(deploymentId: string): DeploymentProgress | undefined;
+    formatProgress(deploymentId: string): string;
+}

package/lib/deployment/deployment-tracker.js

@@ -0,0 +1,79 @@
+/**
+ * Deployment Progress Tracker - US-086
+ * Tracks real-time deployment progress
+ *
+ * @ac US-086-AC-1: Track deployment ID
+ * @ac US-086-AC-2: Poll deployment status
+ * @ac US-086-AC-3: Show progress percentage
+ * @ac US-086-AC-4: Show current component deploying
+ * @ac US-086-AC-5: Show ETA
+ * @ac US-086-AC-6: Show wave progress
+ * @issue #86
+ */
+import { getLogger } from '../utils/logger.js';
+const logger = getLogger('DeploymentTracker');
+/**
+ * @ac US-086-AC-1: Track deployment ID
+ * @ac US-086-AC-2: Poll deployment status
+ */
+export class DeploymentTracker {
+    deployments = new Map();
+    startTimes = new Map();
+    startTracking(deploymentId, waveNumber, totalWaves) {
+        logger.info('Starting deployment tracking', { deploymentId, waveNumber });
+        this.startTimes.set(deploymentId, Date.now());
+        this.deployments.set(deploymentId, {
+            deploymentId,
+            waveNumber,
+            totalWaves,
+            percentage: 0,
+            status: 'In Progress',
+        });
+    }
+    /**
+     * @ac US-086-AC-3: Show progress percentage
+     * @ac US-086-AC-4: Show current component deploying
+     * @ac US-086-AC-5: Show ETA
+     */
+    updateProgress(deploymentId, result) {
+        const progress = this.deployments.get(deploymentId);
+        if (!progress) {
+            return;
+        }
+        const total = result.componentSuccesses + result.componentFailures;
+        if (total > 0) {
+            progress.percentage = Math.round((result.componentSuccesses / total) * 100);
+        }
+        progress.status = result.status;
+        // Calculate ETA based on elapsed time and progress
+        const startTime = this.startTimes.get(deploymentId);
+        if (startTime && progress.percentage > 0) {
+            const elapsed = Date.now() - startTime;
+            const totalEstimated = (elapsed / progress.percentage) * 100;
+            progress.eta = Math.round((totalEstimated - elapsed) / 1000); // seconds
+        }
+        logger.info('Progress updated', { deploymentId, progress });
+    }
+    /**
+     * @ac US-086-AC-6: Show wave progress
+     */
+    getProgress(deploymentId) {
+        return this.deployments.get(deploymentId);
+    }
+    formatProgress(deploymentId) {
+        const progress = this.deployments.get(deploymentId);
+        if (!progress) {
+            return 'No progress available';
+        }
+        const lines = [
+            `Wave ${progress.waveNumber}/${progress.totalWaves}`,
+            `Progress: ${progress.percentage}%`,
+            `Status: ${progress.status}`,
+        ];
+        if (progress.eta !== undefined) {
+            lines.push(`ETA: ${progress.eta}s`);
+        }
+        return lines.join(' | ');
+    }
+}
+//# sourceMappingURL=deployment-tracker.js.map

package/lib/deployment/deployment-tracker.js.map

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

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

@@ -0,0 +1,28 @@
+export type DeploymentValidationIssue = {
+    severity: 'error' | 'warning';
+    message: string;
+    filePath?: string;
+    waveNumber?: number;
+};
+export type DeploymentValidationSummary = {
+    valid: boolean;
+    components: number;
+    totalWaves: number;
+    estimatedTime: number;
+    xmlFilesValidated: number;
+    issues: DeploymentValidationIssue[];
+    aiAnalyzed?: boolean;
+    overallRisk?: 'low' | 'medium' | 'high' | 'critical';
+    aiProvider?: string;
+    aiModel?: string;
+    aiFallback?: boolean;
+};
+export declare class DeploymentValidationService {
+    private readonly scanner;
+    private readonly xmlValidator;
+    validateProject(sourcePath?: string, options?: {
+        useAI?: boolean;
+    }): Promise<DeploymentValidationSummary>;
+    formatSummary(summary: DeploymentValidationSummary): string;
+    private findXmlMetadataFiles;
+}