@jterrats/smart-deployment 1.0.3

package/lib/deployment/cycle-source-editor.js

@@ -0,0 +1,121 @@
+import { createHash } from 'node:crypto';
+import { access, readFile, unlink, writeFile } from 'node:fs/promises';
+import { constants as fsConstants } from 'node:fs';
+function createBackupPath(filePath) {
+    return `${filePath}.cycle-remediation.bak`;
+}
+function hashContent(content) {
+    return createHash('sha256').update(content, 'utf8').digest('hex');
+}
+function countOccurrences(content, snippet) {
+    if (snippet.length === 0) {
+        return 0;
+    }
+    let count = 0;
+    let index = 0;
+    while (index <= content.length - snippet.length) {
+        const nextIndex = content.indexOf(snippet, index);
+        if (nextIndex === -1) {
+            break;
+        }
+        count += 1;
+        index = nextIndex + snippet.length;
+    }
+    return count;
+}
+function createReplacementSnippet(request) {
+    const header = `// cycle-remediation: comment-reference ${request.targetDependency}` + ` | ${request.targetDescription}`;
+    const commentedSnippet = request.sourceSnippet
+        .split('\n')
+        .map((line) => (line.length === 0 ? '//' : `// ${line}`))
+        .join('\n');
+    return `${header}\n${commentedSnippet}\n// cycle-remediation: end`;
+}
+async function fileExists(filePath) {
+    try {
+        await access(filePath, fsConstants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export class CycleSourceEditor {
+    async createBackup(filePath) {
+        const originalContent = await readFile(filePath, 'utf8');
+        const originalHash = hashContent(originalContent);
+        const backupPath = createBackupPath(filePath);
+        if (!(await fileExists(backupPath))) {
+            await writeFile(backupPath, originalContent, 'utf8');
+            return {
+                filePath,
+                backupPath,
+                originalHash,
+                created: true,
+            };
+        }
+        const backupContent = await readFile(backupPath, 'utf8');
+        const backupHash = hashContent(backupContent);
+        if (backupHash !== originalHash) {
+            throw new Error(`Backup mismatch for ${filePath}; refusing to overwrite ${backupPath} with different source content.`);
+        }
+        return {
+            filePath,
+            backupPath,
+            originalHash,
+            created: false,
+        };
+    }
+    async applyEdit(request) {
+        if (request.sourceSnippet.trim().length === 0) {
+            throw new Error(`Cycle remediation edit for ${request.filePath} requires a non-empty sourceSnippet.`);
+        }
+        const originalContent = await readFile(request.filePath, 'utf8');
+        const matchCount = countOccurrences(originalContent, request.sourceSnippet);
+        if (matchCount !== 1) {
+            throw new Error(`Cycle remediation edit for ${request.filePath} requires exactly one sourceSnippet match; found ${matchCount}.`);
+        }
+        const backupRecord = await this.createBackup(request.filePath);
+        const replacementSnippet = createReplacementSnippet(request);
+        const editedContent = originalContent.replace(request.sourceSnippet, replacementSnippet);
+        const editedHash = hashContent(editedContent);
+        await writeFile(request.filePath, editedContent, 'utf8');
+        return {
+            operation: 'comment-reference',
+            filePath: request.filePath,
+            backupPath: backupRecord.backupPath,
+            targetDescription: request.targetDescription,
+            targetDependency: request.targetDependency,
+            sourceSnippet: request.sourceSnippet,
+            replacementSnippet,
+            originalHash: backupRecord.originalHash,
+            editedHash,
+        };
+    }
+    async restoreEdit(record) {
+        if (!(await fileExists(record.backupPath))) {
+            return {
+                restored: false,
+                reason: 'backup-missing',
+            };
+        }
+        const currentContent = await readFile(record.filePath, 'utf8');
+        const currentHash = hashContent(currentContent);
+        if (currentHash !== record.editedHash) {
+            return {
+                restored: false,
+                reason: 'hash-mismatch',
+                currentHash,
+            };
+        }
+        const backupContent = await readFile(record.backupPath, 'utf8');
+        const restoredHash = hashContent(backupContent);
+        await writeFile(record.filePath, backupContent, 'utf8');
+        await unlink(record.backupPath);
+        return {
+            restored: true,
+            restoredHash,
+        };
+    }
+}
+//# sourceMappingURL=cycle-source-editor.js.map

package/lib/deployment/cycle-source-editor.js.map

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

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

@@ -0,0 +1,38 @@
+/**
+ * Deployment Error Handler - US-074
+ * Enhanced deployment error recovery
+ *
+ * @ac US-074-AC-1: Catch deployment errors
+ * @ac US-074-AC-2: Save deployment state
+ * @ac US-074-AC-3: Enable resume from failure
+ * @ac US-074-AC-4: Retry with different strategies
+ * @ac US-074-AC-5: Report error details
+ * @ac US-074-AC-6: Suggest fixes
+ * @issue #74
+ */
+export type DeploymentErrorContext = {
+    wave: number;
+    components: string[];
+    strategy: 'standard' | 'quick' | 'validate-only';
+    retryCount: number;
+};
+export declare class DeploymentErrorHandler {
+    private readonly stateManager;
+    constructor();
+    /**
+     * @ac US-074-AC-1: Catch deployment errors
+     * @ac US-074-AC-2: Save deployment state
+     * Handle deployment error with state persistence
+     */
+    handleError(error: Error, context: DeploymentErrorContext): Promise<void>;
+    /**
+     * @ac US-074-AC-6: Suggest fixes
+     * Get error fix suggestions
+     */
+    private getSuggestions;
+    /**
+     * @ac US-074-AC-3: Enable resume from failure
+     * Check if can resume
+     */
+    canResume(): Promise<boolean>;
+}

package/lib/deployment/deployment-error-handler.js

@@ -0,0 +1,79 @@
+/**
+ * Deployment Error Handler - US-074
+ * Enhanced deployment error recovery
+ *
+ * @ac US-074-AC-1: Catch deployment errors
+ * @ac US-074-AC-2: Save deployment state
+ * @ac US-074-AC-3: Enable resume from failure
+ * @ac US-074-AC-4: Retry with different strategies
+ * @ac US-074-AC-5: Report error details
+ * @ac US-074-AC-6: Suggest fixes
+ * @issue #74
+ */
+import { getLogger } from '../utils/logger.js';
+import { StateManager } from './state-manager.js';
+const logger = getLogger('DeploymentErrorHandler');
+export class DeploymentErrorHandler {
+    stateManager;
+    constructor() {
+        this.stateManager = new StateManager();
+    }
+    /**
+     * @ac US-074-AC-1: Catch deployment errors
+     * @ac US-074-AC-2: Save deployment state
+     * Handle deployment error with state persistence
+     */
+    async handleError(error, context) {
+        logger.error('Deployment error occurred', {
+            wave: context.wave,
+            components: context.components.length,
+            error: error.message,
+        });
+        // Save state for resume
+        await this.stateManager.saveState({
+            deploymentId: `deploy-${Date.now()}`,
+            targetOrg: 'unknown',
+            timestamp: new Date().toISOString(),
+            totalWaves: context.wave + 1,
+            completedWaves: [],
+            currentWave: context.wave,
+            failedWave: {
+                waveNumber: context.wave,
+                error: error.message,
+                timestamp: new Date().toISOString(),
+            },
+        });
+        // Suggest fixes
+        const suggestions = this.getSuggestions(error);
+        logger.info('Suggested fixes', { suggestions });
+    }
+    /**
+     * @ac US-074-AC-6: Suggest fixes
+     * Get error fix suggestions
+     */
+    getSuggestions(error) {
+        const suggestions = [];
+        if (error.message.includes('UNABLE_TO_LOCK_ROW')) {
+            suggestions.push('Retry deployment - this is usually temporary');
+            suggestions.push('Check for concurrent deployments');
+        }
+        else if (error.message.includes('INVALID_CROSS_REFERENCE_KEY')) {
+            suggestions.push('Check dependency order');
+            suggestions.push('Ensure all referenced components are included');
+        }
+        else if (error.message.includes('FIELD_INTEGRITY_EXCEPTION')) {
+            suggestions.push('Check required fields');
+            suggestions.push('Verify picklist values');
+        }
+        return suggestions;
+    }
+    /**
+     * @ac US-074-AC-3: Enable resume from failure
+     * Check if can resume
+     */
+    async canResume() {
+        const state = await this.stateManager.loadState();
+        return state !== null;
+    }
+}
+//# sourceMappingURL=deployment-error-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-error-handler.js","sourceRoot":"","sources":["../../src/deployment/deployment-error-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,MAAM,GAAG,SAAS,CAAC,wBAAwB,CAAC,CAAC;AASnD,MAAM,OAAO,sBAAsB;IAChB,YAAY,CAAe;IAE5C;QACE,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;IACzC,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,WAAW,CAAC,KAAY,EAAE,OAA+B;QACpE,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE;YACxC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM;YACrC,KAAK,EAAE,KAAK,CAAC,OAAO;SACrB,CAAC,CAAC;QAEH,wBAAwB;QACxB,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC;YAChC,YAAY,EAAE,UAAU,IAAI,CAAC,GAAG,EAAE,EAAE;YACpC,SAAS,EAAE,SAAS;YACpB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,UAAU,EAAE,OAAO,CAAC,IAAI,GAAG,CAAC;YAC5B,cAAc,EAAE,EAAE;YAClB,WAAW,EAAE,OAAO,CAAC,IAAI;YACzB,UAAU,EAAE;gBACV,UAAU,EAAE,OAAO,CAAC,IAAI;gBACxB,KAAK,EAAE,KAAK,CAAC,OAAO;gBACpB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF,CAAC,CAAC;QAEH,gBAAgB;QAChB,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;IAClD,CAAC;IAED;;;OAGG;IACK,cAAc,CAAC,KAAY;QACjC,MAAM,WAAW,GAAa,EAAE,CAAC;QAEjC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC;YACjD,WAAW,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;YACjE,WAAW,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QACvD,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAC,EAAE,CAAC;YACjE,WAAW,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;YAC3C,WAAW,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;QACpE,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAC,EAAE,CAAC;YAC/D,WAAW,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;YAC1C,WAAW,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,SAAS;QACpB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC;QAClD,OAAO,KAAK,KAAK,IAAI,CAAC;IACxB,CAAC;CACF"}

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

@@ -0,0 +1,63 @@
+/**
+ * Deployment Reporting - US-090
+ * Generates comprehensive deployment reports
+ *
+ * @ac US-090-AC-1: Generate deployment summary
+ * @ac US-090-AC-2: Include wave-by-wave breakdown
+ * @ac US-090-AC-3: Include test results
+ * @ac US-090-AC-4: Include timing information
+ * @ac US-090-AC-5: Include error details
+ * @ac US-090-AC-6: Export as JSON
+ * @ac US-090-AC-7: Export as HTML
+ * @ac US-090-AC-8: Save to file
+ * @issue #90
+ */
+export type WaveReport = {
+    waveNumber: number;
+    components: number;
+    startTime: string;
+    endTime: string;
+    duration: number;
+    success: boolean;
+    testsRun?: number;
+    testFailures?: number;
+    error?: string;
+};
+export type DeploymentReport = {
+    deploymentId: string;
+    targetOrg: string;
+    startTime: string;
+    endTime: string;
+    totalDuration: number;
+    success: boolean;
+    totalWaves: number;
+    completedWaves: number;
+    totalComponents: number;
+    totalTests: number;
+    waves: WaveReport[];
+    errors: string[];
+};
+/**
+ * @ac US-090-AC-1: Generate deployment summary
+ * @ac US-090-AC-2: Include wave-by-wave breakdown
+ */
+export declare class DeploymentReporter {
+    /**
+     * @ac US-090-AC-3: Include test results
+     * @ac US-090-AC-4: Include timing information
+     * @ac US-090-AC-5: Include error details
+     */
+    generateReport(report: DeploymentReport): string;
+    /**
+     * @ac US-090-AC-6: Export as JSON
+     */
+    toJSON(report: DeploymentReport): string;
+    /**
+     * @ac US-090-AC-7: Export as HTML
+     */
+    toHTML(report: DeploymentReport): string;
+    /**
+     * @ac US-090-AC-8: Save to file
+     */
+    saveReport(report: DeploymentReport, format: 'json' | 'html' | 'text'): Promise<string>;
+}

package/lib/deployment/deployment-reporter.js

@@ -0,0 +1,150 @@
+/**
+ * Deployment Reporting - US-090
+ * Generates comprehensive deployment reports
+ *
+ * @ac US-090-AC-1: Generate deployment summary
+ * @ac US-090-AC-2: Include wave-by-wave breakdown
+ * @ac US-090-AC-3: Include test results
+ * @ac US-090-AC-4: Include timing information
+ * @ac US-090-AC-5: Include error details
+ * @ac US-090-AC-6: Export as JSON
+ * @ac US-090-AC-7: Export as HTML
+ * @ac US-090-AC-8: Save to file
+ * @issue #90
+ */
+import * as fs from 'node:fs/promises';
+import { getLogger } from '../utils/logger.js';
+const logger = getLogger('DeploymentReporter');
+/**
+ * @ac US-090-AC-1: Generate deployment summary
+ * @ac US-090-AC-2: Include wave-by-wave breakdown
+ */
+export class DeploymentReporter {
+    /**
+     * @ac US-090-AC-3: Include test results
+     * @ac US-090-AC-4: Include timing information
+     * @ac US-090-AC-5: Include error details
+     */
+    generateReport(report) {
+        const lines = [
+            '═'.repeat(60),
+            '📊 DEPLOYMENT REPORT',
+            '═'.repeat(60),
+            '',
+            `Deployment ID: ${report.deploymentId}`,
+            `Target Org: ${report.targetOrg}`,
+            `Status: ${report.success ? '✅ SUCCESS' : '❌ FAILED'}`,
+            `Duration: ${report.totalDuration}s`,
+            '',
+            `Waves: ${report.completedWaves}/${report.totalWaves}`,
+            `Components: ${report.totalComponents}`,
+            `Tests: ${report.totalTests}`,
+            '',
+            '─'.repeat(60),
+            'Wave Breakdown:',
+            '─'.repeat(60),
+        ];
+        for (const wave of report.waves) {
+            lines.push('');
+            lines.push(`Wave ${wave.waveNumber}:`);
+            lines.push(`  Components: ${wave.components}`);
+            lines.push(`  Duration: ${wave.duration}s`);
+            lines.push(`  Status: ${wave.success ? '✅' : '❌'}`);
+            if (wave.testsRun !== undefined) {
+                lines.push(`  Tests: ${wave.testsRun} (${wave.testFailures ?? 0} failures)`);
+            }
+            if (wave.error) {
+                lines.push(`  Error: ${wave.error}`);
+            }
+        }
+        if (report.errors.length > 0) {
+            lines.push('');
+            lines.push('─'.repeat(60));
+            lines.push('Errors:');
+            lines.push('─'.repeat(60));
+            for (const error of report.errors) {
+                lines.push(`  • ${error}`);
+            }
+        }
+        lines.push('');
+        lines.push('═'.repeat(60));
+        return lines.join('\n');
+    }
+    /**
+     * @ac US-090-AC-6: Export as JSON
+     */
+    toJSON(report) {
+        return JSON.stringify(report, null, 2);
+    }
+    /**
+     * @ac US-090-AC-7: Export as HTML
+     */
+    toHTML(report) {
+        return `
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Deployment Report</title>
+  <style>
+    body { font-family: Arial, sans-serif; margin: 20px; }
+    .success { color: green; }
+    .failure { color: red; }
+    table { border-collapse: collapse; width: 100%; }
+    th, td { border: 1px solid #ddd; padding: 8px; text-align: left; }
+    th { background-color: #4CAF50; color: white; }
+  </style>
+</head>
+<body>
+  <h1>Deployment Report</h1>
+  <p><strong>Status:</strong> <span class="${report.success ? 'success' : 'failure'}">${report.success ? 'SUCCESS' : 'FAILED'}</span></p>
+  <p><strong>Target:</strong> ${report.targetOrg}</p>
+  <p><strong>Duration:</strong> ${report.totalDuration}s</p>
+
+  <h2>Wave Breakdown</h2>
+  <table>
+    <tr>
+      <th>Wave</th>
+      <th>Components</th>
+      <th>Duration</th>
+      <th>Tests</th>
+      <th>Status</th>
+    </tr>
+    ${report.waves
+            .map((w) => `
+    <tr>
+      <td>${w.waveNumber}</td>
+      <td>${w.components}</td>
+      <td>${w.duration}s</td>
+      <td>${w.testsRun ?? 0}</td>
+      <td class="${w.success ? 'success' : 'failure'}">${w.success ? '✅' : '❌'}</td>
+    </tr>
+    `)
+            .join('')}
+  </table>
+</body>
+</html>
+    `.trim();
+    }
+    /**
+     * @ac US-090-AC-8: Save to file
+     */
+    async saveReport(report, format) {
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const filename = `deployment-report-${timestamp}.${format}`;
+        let content;
+        switch (format) {
+            case 'json':
+                content = this.toJSON(report);
+                break;
+            case 'html':
+                content = this.toHTML(report);
+                break;
+            default:
+                content = this.generateReport(report);
+        }
+        await fs.writeFile(filename, content, 'utf-8');
+        logger.info('Report saved', { filename });
+        return filename;
+    }
+}
+//# sourceMappingURL=deployment-reporter.js.map

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

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

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

@@ -0,0 +1,38 @@
+import type { DeploymentState } from './state-manager.js';
+export type CycleRemediationStatusSummary = {
+    cycleId: string;
+    strategy: 'comment-reference' | 'manual';
+    activePhase: 1 | 2;
+    completedPhases: Array<1 | 2>;
+    startedAt: string;
+    editCount: number;
+    statusText: string;
+};
+export type DeploymentStatusSummary = {
+    deploymentId: string;
+    targetOrg: string;
+    status: 'Not Started' | 'In Progress' | 'Failed' | 'Completed';
+    currentWave: number;
+    totalWaves: number;
+    completedWaves: number[];
+    remainingWaves: number;
+    canResume: boolean;
+    etaSeconds: number;
+    testStatus: string;
+    lastUpdated: string;
+    failedWaveNumber?: number;
+    failureReason?: string;
+    cycleRemediation?: CycleRemediationStatusSummary;
+    ai?: {
+        provider?: string;
+        model?: string;
+        fallback?: boolean;
+        aiAdjustments?: number;
+        unknownTypes?: string[];
+        inferenceFallback?: boolean;
+        inferredDependencies?: number;
+    };
+};
+export declare function summarizeDeploymentState(state: DeploymentState, nowTimestamp?: number): DeploymentStatusSummary;
+export declare function createResumedState(state: DeploymentState, retryStrategy: 'standard' | 'quick' | 'validate-only', resumedAt?: string): DeploymentState;
+export declare function formatDeploymentStatus(summary: DeploymentStatusSummary): string[];