@jterrats/smart-deployment 1.2.6 → 1.3.1

package/lib/reports/deployment-plan-report-service.d.ts

@@ -0,0 +1,76 @@
+import type { DeploymentContext } from '../deployment/deployment-context-service.js';
+import type { NodeId } from '../types/dependency.js';
+import type { MetadataType } from '../types/metadata.js';
+export type DeploymentPlanReportOptions = {
+    reportDir?: string;
+    targetOrg?: string;
+    sourcePath?: string;
+    dryRun: boolean;
+    validateOnly: boolean;
+    destructive?: boolean;
+    skipTests: boolean;
+};
+export type DeploymentPlanReportResult = {
+    report: DeploymentPlanReport;
+    jsonPath: string;
+    htmlPath: string;
+};
+export type DeploymentPlanReport = {
+    generatedAt: string;
+    projectRoot: string;
+    command: {
+        mode: 'dry-run' | 'validate-only' | 'execute';
+        targetOrg?: string;
+        sourcePath?: string;
+        destructive: boolean;
+        skipTests: boolean;
+    };
+    summary: {
+        status: 'passed' | 'warning' | 'blocked';
+        components: number;
+        waves: number;
+        blockers: number;
+        warnings: number;
+        estimatedTimeSeconds: number;
+    };
+    validationSummary: {
+        passed: boolean;
+        errors: number;
+        warnings: number;
+        circularDependencies: number;
+        unplacedComponents: number;
+    };
+    providerPhases: Array<{
+        name: string;
+        provider: string;
+        status: 'completed' | 'skipped' | 'blocked';
+        detail: string;
+    }>;
+    blockers: string[];
+    warnings: string[];
+    waves: Array<{
+        number: number;
+        componentCount: number;
+        types: MetadataType[];
+        estimatedTimeSeconds: number;
+        hasCircularDependencies: boolean;
+        components: Array<{
+            id: NodeId;
+            type: string;
+            name: string;
+        }>;
+    }>;
+};
+export declare class DeploymentPlanReportService {
+    generate(context: DeploymentContext, options: DeploymentPlanReportOptions): Promise<DeploymentPlanReportResult>;
+    createReport(context: DeploymentContext, options: DeploymentPlanReportOptions): DeploymentPlanReport;
+    toHTML(report: DeploymentPlanReport): string;
+    private resolveMode;
+    private collectBlockers;
+    private collectWarnings;
+    private collectUnplacedComponents;
+    private createProviderPhases;
+    private createWaveReport;
+    private toListItems;
+    private toWaveRow;
+}

package/lib/reports/deployment-plan-report-service.js

@@ -0,0 +1,234 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import * as path from 'node:path';
+const DEFAULT_REPORT_DIR = '.smart-deployment/reports/start-dry-run';
+const JSON_REPORT_NAME = 'deployment-plan.json';
+const HTML_REPORT_NAME = 'deployment-plan.html';
+export class DeploymentPlanReportService {
+    async generate(context, options) {
+        const reportDir = options.reportDir ?? path.join(context.scanResult.projectRoot, DEFAULT_REPORT_DIR);
+        const jsonPath = path.join(reportDir, JSON_REPORT_NAME);
+        const htmlPath = path.join(reportDir, HTML_REPORT_NAME);
+        const report = this.createReport(context, options);
+        await mkdir(reportDir, { recursive: true });
+        await Promise.all([
+            writeFile(jsonPath, `${JSON.stringify(report, null, 2)}\n`, 'utf8'),
+            writeFile(htmlPath, this.toHTML(report), 'utf8'),
+        ]);
+        return { report, jsonPath, htmlPath };
+    }
+    createReport(context, options) {
+        const blockers = this.collectBlockers(context);
+        const warnings = this.collectWarnings(context);
+        const mode = this.resolveMode(options);
+        const validationPassed = blockers.length === 0;
+        return {
+            generatedAt: new Date().toISOString(),
+            projectRoot: context.scanResult.projectRoot,
+            command: {
+                mode,
+                targetOrg: options.targetOrg,
+                sourcePath: options.sourcePath,
+                destructive: options.destructive === true,
+                skipTests: options.skipTests,
+            },
+            summary: {
+                status: blockers.length > 0 ? 'blocked' : warnings.length > 0 ? 'warning' : 'passed',
+                components: context.scanResult.components.length,
+                waves: context.orderedWaves.length,
+                blockers: blockers.length,
+                warnings: warnings.length,
+                estimatedTimeSeconds: context.orderedWaves.reduce((total, wave) => total + wave.metadata.estimatedTime, 0),
+            },
+            validationSummary: {
+                passed: validationPassed,
+                errors: blockers.length,
+                warnings: warnings.length,
+                circularDependencies: context.scanResult.dependencyResult.circularDependencies.length,
+                unplacedComponents: this.collectUnplacedComponents(context).length,
+            },
+            providerPhases: this.createProviderPhases(context, mode, validationPassed),
+            blockers,
+            warnings,
+            waves: context.orderedWaves.map((wave) => this.createWaveReport(wave)),
+        };
+    }
+    toHTML(report) {
+        const blockerItems = this.toListItems(report.blockers, 'No blockers detected.');
+        const warningItems = this.toListItems(report.warnings, 'No warnings detected.');
+        const phaseRows = report.providerPhases
+            .map((phase) => `
+      <tr>
+        <td>${escapeHtml(phase.name)}</td>
+        <td>${escapeHtml(phase.provider)}</td>
+        <td>${escapeHtml(phase.status)}</td>
+        <td>${escapeHtml(phase.detail)}</td>
+      </tr>`)
+            .join('');
+        const waveRows = report.waves.length > 0
+            ? report.waves.map((wave) => this.toWaveRow(wave)).join('')
+            : '<tr><td colspan="6">No deployment waves generated.</td></tr>';
+        return `
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <title>Deployment Plan Report</title>
+  <style>
+    body { font-family: Arial, sans-serif; margin: 24px; color: #1f2937; }
+    h1, h2 { margin-bottom: 0.5rem; }
+    table { border-collapse: collapse; width: 100%; margin-top: 1rem; }
+    th, td { border: 1px solid #d1d5db; padding: 8px; text-align: left; vertical-align: top; }
+    th { background: #f3f4f6; }
+    code { white-space: nowrap; }
+    .summary { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 12px; }
+    .card { border: 1px solid #d1d5db; border-radius: 8px; padding: 12px; background: #fff; }
+  </style>
+</head>
+<body>
+  <h1>Deployment Plan Report</h1>
+  <p>Generated at ${escapeHtml(report.generatedAt)}</p>
+  <p>Project root: <code>${escapeHtml(report.projectRoot)}</code></p>
+
+  <div class="summary">
+    <div class="card"><strong>Status</strong><br>${escapeHtml(report.summary.status)}</div>
+    <div class="card"><strong>Components</strong><br>${report.summary.components}</div>
+    <div class="card"><strong>Waves</strong><br>${report.summary.waves}</div>
+    <div class="card"><strong>Blockers</strong><br>${report.summary.blockers}</div>
+    <div class="card"><strong>Warnings</strong><br>${report.summary.warnings}</div>
+    <div class="card"><strong>Estimated Time</strong><br>${report.summary.estimatedTimeSeconds}s</div>
+  </div>
+
+  <h2>Validation Summary</h2>
+  <p>Passed: <strong>${report.validationSummary.passed ? 'Yes' : 'No'}</strong></p>
+  <p>Errors: <strong>${report.validationSummary.errors}</strong></p>
+  <p>Warnings: <strong>${report.validationSummary.warnings}</strong></p>
+  <p>Circular dependencies: <strong>${report.validationSummary.circularDependencies}</strong></p>
+  <p>Unplaced components: <strong>${report.validationSummary.unplacedComponents}</strong></p>
+
+  <h2>Provider Phases</h2>
+  <table>
+    <thead>
+      <tr><th>Phase</th><th>Provider</th><th>Status</th><th>Detail</th></tr>
+    </thead>
+    <tbody>${phaseRows}</tbody>
+  </table>
+
+  <h2>Blockers</h2>
+  <ul>${blockerItems}</ul>
+
+  <h2>Warnings</h2>
+  <ul>${warningItems}</ul>
+
+  <h2>Waves</h2>
+  <table>
+    <thead>
+      <tr>
+        <th>Wave</th>
+        <th>Components</th>
+        <th>Types</th>
+        <th>Estimated Time</th>
+        <th>Circular</th>
+        <th>Component List</th>
+      </tr>
+    </thead>
+    <tbody>${waveRows}</tbody>
+  </table>
+</body>
+</html>
+    `.trim();
+    }
+    resolveMode(options) {
+        if (options.dryRun) {
+            return 'dry-run';
+        }
+        return options.validateOnly ? 'validate-only' : 'execute';
+    }
+    collectBlockers(context) {
+        return [
+            ...context.scanResult.errors,
+            ...context.scanResult.dependencyResult.circularDependencies
+                .filter((cycle) => cycle.severity === 'error')
+                .map((cycle) => cycle.message),
+            ...this.collectUnplacedComponents(context).map((component) => `Unplaced component: ${component}`),
+        ];
+    }
+    collectWarnings(context) {
+        return [
+            ...context.scanResult.warnings,
+            ...context.scanResult.dependencyResult.circularDependencies
+                .filter((cycle) => cycle.severity === 'warning')
+                .map((cycle) => cycle.message),
+        ];
+    }
+    collectUnplacedComponents(context) {
+        const placed = new Set(context.orderedWaves.flatMap((wave) => wave.components));
+        return [...context.scanResult.dependencyResult.components.keys()]
+            .filter((component) => !placed.has(component))
+            .sort((left, right) => left.localeCompare(right));
+    }
+    createProviderPhases(context, mode, validationPassed) {
+        return [
+            {
+                name: 'metadata-scan',
+                provider: 'local-scanner',
+                status: context.scanResult.errors.length > 0 ? 'blocked' : 'completed',
+                detail: `${context.scanResult.components.length} component(s) scanned`,
+            },
+            {
+                name: 'wave-generation',
+                provider: 'wave-builder',
+                status: validationPassed ? 'completed' : 'blocked',
+                detail: `${context.orderedWaves.length} wave(s) planned`,
+            },
+            {
+                name: 'deployment-execution',
+                provider: 'sf-cli',
+                status: mode === 'execute' && validationPassed ? 'completed' : mode === 'execute' ? 'blocked' : 'skipped',
+                detail: mode === 'dry-run' ? 'Skipped because --dry-run was requested' : `Command mode: ${mode}`,
+            },
+        ];
+    }
+    createWaveReport(wave) {
+        return {
+            number: wave.number,
+            componentCount: wave.metadata.componentCount,
+            types: [...wave.metadata.types],
+            estimatedTimeSeconds: wave.metadata.estimatedTime,
+            hasCircularDependencies: wave.metadata.hasCircularDeps,
+            components: wave.components.map((component) => {
+                const [type, ...nameParts] = component.split(':');
+                return {
+                    id: component,
+                    type,
+                    name: nameParts.join(':'),
+                };
+            }),
+        };
+    }
+    toListItems(values, emptyMessage) {
+        return values.length > 0
+            ? values.map((value) => `<li>${escapeHtml(value)}</li>`).join('')
+            : `<li>${escapeHtml(emptyMessage)}</li>`;
+    }
+    toWaveRow(wave) {
+        const components = wave.components.map((component) => `<code>${escapeHtml(component.id)}</code>`).join('<br>');
+        return `
+      <tr>
+        <td>${wave.number}</td>
+        <td>${wave.componentCount}</td>
+        <td>${escapeHtml(wave.types.join(', ') || 'Unknown')}</td>
+        <td>${wave.estimatedTimeSeconds}s</td>
+        <td>${wave.hasCircularDependencies ? 'Yes' : 'No'}</td>
+        <td>${components}</td>
+      </tr>`;
+    }
+}
+function escapeHtml(value) {
+    return value
+        .replaceAll('&', '&amp;')
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;')
+        .replaceAll('"', '&quot;')
+        .replaceAll("'", '&#39;');
+}
+//# sourceMappingURL=deployment-plan-report-service.js.map

package/lib/reports/deployment-plan-report-service.js.map

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

package/lib/reports/graph-export-service.d.ts

@@ -0,0 +1,85 @@
+import type { DeploymentContext } from '../deployment/deployment-context-service.js';
+import type { CircularDependency, DependencyEdge, NodeId } from '../types/dependency.js';
+export type GraphExportFormat = 'mermaid' | 'dot' | 'json' | 'html';
+export type GraphExportOptions = {
+    format: GraphExportFormat;
+    outputPath?: string;
+    reportDir?: string;
+};
+export type GraphExportResult = {
+    success: boolean;
+    format: GraphExportFormat;
+    path: string;
+    report: GraphExportReport;
+};
+export type GraphExportReport = {
+    generatedAt: string;
+    projectRoot: string;
+    summary: {
+        components: number;
+        dependencyEdges: number;
+        waves: number;
+        cycles: number;
+        isolatedComponents: number;
+    };
+    components: GraphExportComponent[];
+    edges: GraphExportEdge[];
+    waves: GraphExportWave[];
+    cycles: GraphExportCycle[];
+};
+export type GraphExportComponent = {
+    id: NodeId;
+    type: string;
+    name: string;
+    filePath?: string;
+    dependencies: NodeId[];
+    dependents: NodeId[];
+    wave?: number;
+    inCycle: boolean;
+    isolated: boolean;
+};
+export type GraphExportEdge = {
+    from: NodeId;
+    to: NodeId;
+    type: DependencyEdge['type'];
+    source?: DependencyEdge['source'];
+    reason?: string;
+    confidence?: number;
+    fromWave?: number;
+    toWave?: number;
+    crossesWave: boolean;
+    inCycle: boolean;
+};
+export type GraphExportWave = {
+    number: number;
+    componentCount: number;
+    types: string[];
+    maxDepth: number;
+    estimatedTimeSeconds: number;
+    hasCircularDependencies: boolean;
+    components: NodeId[];
+};
+export type GraphExportCycle = {
+    cycle: NodeId[];
+    severity: CircularDependency['severity'];
+    message: string;
+};
+export declare class GraphExportService {
+    generate(context: DeploymentContext, options: GraphExportOptions): Promise<GraphExportResult>;
+    createReport(context: DeploymentContext): GraphExportReport;
+    render(report: GraphExportReport, format: GraphExportFormat): string;
+    toMermaid(report: GraphExportReport): string;
+    toDot(report: GraphExportReport): string;
+    toHtml(report: GraphExportReport): string;
+    private resolveOutputPath;
+    private createComponents;
+    private createEdges;
+    private createWave;
+    private createWaveIndex;
+    private createCycleEdgeSet;
+    private toMermaidNode;
+    private toMermaidId;
+    private componentLabel;
+    private toComponentRow;
+    private toEdgeRow;
+}