@jterrats/smart-deployment 1.2.5 → 1.3.1

package/lib/deployment/wave-manifest-service.js

@@ -2,11 +2,43 @@ import { mkdir, writeFile } from 'node:fs/promises';
 import * as path from 'node:path';
 export class WaveManifestService {
     async generateManifest(params) {
-        const manifestDir = path.join(params.baseDir, '.smart-deployment', 'manifests');
+        const manifestDir = await this.ensureManifestDir(params.baseDir);
+        const manifestPath = path.join(manifestDir, `wave-${String(params.waveNumber).padStart(3, '0')}.xml`);
+        await writeFile(manifestPath, this.buildPackageXml(params), 'utf8');
+        return manifestPath;
+    }
+    async generateDestructiveManifest(params) {
+        const manifestDir = await this.ensureManifestDir(params.baseDir);
+        const waveName = `wave-${String(params.waveNumber).padStart(3, '0')}`;
+        const packagePath = path.join(manifestDir, `${waveName}-package.xml`);
+        const destructiveChangesPath = path.join(manifestDir, `${waveName}-destructiveChanges.xml`);
+        await Promise.all([
+            writeFile(packagePath, this.buildPackageXml({ ...params, components: [] }), 'utf8'),
+            writeFile(destructiveChangesPath, this.buildPackageXml(params), 'utf8'),
+        ]);
+        return { packagePath, destructiveChangesPath };
+    }
+    async ensureManifestDir(baseDir) {
+        const manifestDir = path.join(baseDir, '.smart-deployment', 'manifests');
         await mkdir(manifestDir, { recursive: true });
+        return manifestDir;
+    }
+    buildPackageXml(params) {
+        const typeBlocks = this.buildTypeBlocks(params.components, params.componentMap);
+        const lines = [
+            '<?xml version="1.0" encoding="UTF-8"?>',
+            '<Package xmlns="http://soap.sforce.com/2006/04/metadata">',
+            ...typeBlocks,
+            `    <version>${params.apiVersion ?? '66.0'}</version>`,
+            '</Package>',
+            '',
+        ];
+        return lines.join('\n');
+    }
+    buildTypeBlocks(components, componentMap) {
         const grouped = new Map();
-        for (const nodeId of params.components) {
-            const component = params.componentMap.get(nodeId);
+        for (const nodeId of components) {
+            const component = componentMap.get(nodeId);
             if (!component) {
                 continue;
             }
@@ -15,27 +47,14 @@ export class WaveManifestService {
             }
             grouped.get(component.type).add(component.name);
         }
-        const typeBlocks = [...grouped.entries()]
+        return [...grouped.entries()]
             .sort((a, b) => a[0].localeCompare(b[0]))
             .map(([type, members]) => {
             const memberLines = [...members]
                 .sort((left, right) => left.localeCompare(right))
-                .map((member) => `        <members>${member}</members>`)
-                .join('\n');
-            return ['    <types>', memberLines, `        <name>${type}</name>`, '    </types>'].join('\n');
-        })
-            .join('\n');
-        const content = [
-            '<?xml version="1.0" encoding="UTF-8"?>',
-            '<Package xmlns="http://soap.sforce.com/2006/04/metadata">',
-            typeBlocks,
-            `    <version>${params.apiVersion ?? '66.0'}</version>`,
-            '</Package>',
-            '',
-        ].join('\n');
-        const manifestPath = path.join(manifestDir, `wave-${String(params.waveNumber).padStart(3, '0')}.xml`);
-        await writeFile(manifestPath, content, 'utf8');
-        return manifestPath;
+                .map((member) => `        <members>${member}</members>`);
+            return ['    <types>', ...memberLines, `        <name>${type}</name>`, '    </types>'].join('\n');
+        });
     }
 }
 //# sourceMappingURL=wave-manifest-service.js.map

package/lib/deployment/wave-manifest-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"wave-manifest-service.js","sourceRoot":"","sources":["../../src/deployment/wave-manifest-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAYlC,MAAM,OAAO,mBAAmB;IACvB,KAAK,CAAC,gBAAgB,CAAC,MAA0B;QACtD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,mBAAmB,EAAE,WAAW,CAAC,CAAC;QAChF,MAAM,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE9C,MAAM,OAAO,GAAG,IAAI,GAAG,EAA6B,CAAC;QACrD,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACvC,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAClD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,SAAS;YACX,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;YACzC,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAE,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,UAAU,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;aACtC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;aACxC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE;YACvB,MAAM,WAAW,GAAG,CAAC,GAAG,OAAO,CAAC;iBAC7B,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;iBAChD,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,oBAAoB,MAAM,YAAY,CAAC;iBACvD,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,OAAO,CAAC,aAAa,EAAE,WAAW,EAAE,iBAAiB,IAAI,SAAS,EAAE,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjG,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,MAAM,OAAO,GAAG;YACd,wCAAwC;YACxC,2DAA2D;YAC3D,UAAU;YACV,gBAAgB,MAAM,CAAC,UAAU,IAAI,MAAM,YAAY;YACvD,YAAY;YACZ,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACtG,MAAM,SAAS,CAAC,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC/C,OAAO,YAAY,CAAC;IACtB,CAAC;CACF"}
+{"version":3,"file":"wave-manifest-service.js","sourceRoot":"","sources":["../../src/deployment/wave-manifest-service.ts"],"names":[],"mappings":"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"}

package/lib/presentation/plan-explain-presenter.d.ts

@@ -0,0 +1,9 @@
+import type { PlanExplainResult } from '../deployment/plan-explain-service.js';
+export type PlanExplainPresenterIO = {
+    log: (message: string) => void;
+    warn: (message: string) => void;
+};
+export declare class PlanExplainPresenter {
+    report(io: PlanExplainPresenterIO, result: PlanExplainResult): void;
+    formatSummary(result: PlanExplainResult): string;
+}

package/lib/presentation/plan-explain-presenter.js

@@ -0,0 +1,40 @@
+export class PlanExplainPresenter {
+    report(io, result) {
+        io.log(this.formatSummary(result));
+        if (result.unresolvedReferences.length > 0) {
+            io.warn(`Plan contains ${result.unresolvedReferences.length} unresolved reference(s).`);
+        }
+    }
+    formatSummary(result) {
+        const lines = [
+            'Plan Explain:',
+            `Components: ${result.summary.componentCount}`,
+            `Dependencies: ${result.summary.dependencyCount}`,
+            `Unresolved References: ${result.summary.unresolvedReferenceCount}`,
+            `Provider Decisions: ${result.summary.providerDecisionCount}`,
+            `Waves: ${result.summary.waves}`,
+        ];
+        if (result.ai?.enabled) {
+            lines.push(`AI Provider: ${result.ai.provider ?? 'unknown'}`);
+            if (result.ai.model) {
+                lines.push(`AI Model: ${result.ai.model}`);
+            }
+        }
+        if (result.components.length > 0) {
+            lines.push('');
+            lines.push('Wave Placement:');
+            for (const component of result.components) {
+                lines.push(`- ${component.nodeId}: ${component.placement.rationale}`);
+            }
+        }
+        if (result.providerDecisions.length > 0) {
+            lines.push('');
+            lines.push('Provider Decisions:');
+            for (const decision of result.providerDecisions) {
+                lines.push(`- ${decision.kind}: ${decision.decision} (${decision.reason || 'No action required.'})`);
+            }
+        }
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=plan-explain-presenter.js.map

package/lib/presentation/plan-explain-presenter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-explain-presenter.js","sourceRoot":"","sources":["../../src/presentation/plan-explain-presenter.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,oBAAoB;IACxB,MAAM,CAAC,EAA0B,EAAE,MAAyB;QACjE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;QAEnC,IAAI,MAAM,CAAC,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3C,EAAE,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,oBAAoB,CAAC,MAAM,2BAA2B,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IAEM,aAAa,CAAC,MAAyB;QAC5C,MAAM,KAAK,GAAG;YACZ,eAAe;YACf,eAAe,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE;YAC9C,iBAAiB,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE;YACjD,0BAA0B,MAAM,CAAC,OAAO,CAAC,wBAAwB,EAAE;YACnE,uBAAuB,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE;YAC7D,UAAU,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE;SACjC,CAAC;QAEF,IAAI,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,EAAE,CAAC,QAAQ,IAAI,SAAS,EAAE,CAAC,CAAC;YAC9D,IAAI,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;gBACpB,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAC9B,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBAC1C,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC;YACxE,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;YAClC,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;gBAChD,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,QAAQ,KAAK,QAAQ,CAAC,MAAM,IAAI,qBAAqB,GAAG,CAAC,CAAC;YACvG,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/lib/presentation/start-command-presenter.d.ts

@@ -12,4 +12,8 @@ export declare class StartCommandPresenter {
         aiEnabled: boolean;
     }): void;
     reportDeploymentReport(io: Pick<StartPresenterIO, 'log'>, waves: number): void;
+    reportPlanReportsSaved(io: Pick<StartPresenterIO, 'log'>, paths: {
+        jsonPath: string;
+        htmlPath: string;
+    }): void;
 }

package/lib/presentation/start-command-presenter.js

@@ -25,5 +25,9 @@ export class StartCommandPresenter {
         io.log(`   - Waves: ${waves}`);
         io.log('   - Status: Success');
     }
+    reportPlanReportsSaved(io, paths) {
+        io.log(`   - JSON report: ${paths.jsonPath}`);
+        io.log(`   - HTML report: ${paths.htmlPath}`);
+    }
 }
 //# sourceMappingURL=start-command-presenter.js.map

package/lib/presentation/start-command-presenter.js.map

@@ -1 +1 @@
-{"version":3,"file":"start-command-presenter.js","sourceRoot":"","sources":["../../src/presentation/start-command-presenter.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,qBAAqB;IACzB,oBAAoB,CAAC,EAAiC;QAC3D,EAAE,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IACvC,CAAC;IAEM,sBAAsB,CAAC,EAAiC,EAAE,MAAmC;QAClG,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,EAAE,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;YACtD,OAAO;QACT,CAAC;QAED,EAAE,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;IAC9D,CAAC;IAEM,2BAA2B,CAAC,EAAiC;QAClE,EAAE,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;IAC/C,CAAC;IAEM,qBAAqB,CAC1B,EAAiC,EACjC,OAIC;QAED,EAAE,CAAC,GAAG,CAAC,WAAW,OAAO,CAAC,aAAa,sBAAsB,CAAC,CAAC;QAC/D,EAAE,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QAC5C,EAAE,CAAC,GAAG,CAAC,eAAe,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;QAE7C,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,EAAE,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAEM,sBAAsB,CAAC,EAAiC,EAAE,KAAa;QAC5E,EAAE,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QAClC,EAAE,CAAC,GAAG,CAAC,eAAe,KAAK,EAAE,CAAC,CAAC;QAC/B,EAAE,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IACjC,CAAC;CACF"}
+{"version":3,"file":"start-command-presenter.js","sourceRoot":"","sources":["../../src/presentation/start-command-presenter.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,qBAAqB;IACzB,oBAAoB,CAAC,EAAiC;QAC3D,EAAE,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IACvC,CAAC;IAEM,sBAAsB,CAAC,EAAiC,EAAE,MAAmC;QAClG,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,EAAE,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;YACtD,OAAO;QACT,CAAC;QAED,EAAE,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;IAC9D,CAAC;IAEM,2BAA2B,CAAC,EAAiC;QAClE,EAAE,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;IAC/C,CAAC;IAEM,qBAAqB,CAC1B,EAAiC,EACjC,OAIC;QAED,EAAE,CAAC,GAAG,CAAC,WAAW,OAAO,CAAC,aAAa,sBAAsB,CAAC,CAAC;QAC/D,EAAE,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QAC5C,EAAE,CAAC,GAAG,CAAC,eAAe,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;QAE7C,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,EAAE,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAEM,sBAAsB,CAAC,EAAiC,EAAE,KAAa;QAC5E,EAAE,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QAClC,EAAE,CAAC,GAAG,CAAC,eAAe,KAAK,EAAE,CAAC,CAAC;QAC/B,EAAE,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IACjC,CAAC;IAEM,sBAAsB,CAAC,EAAiC,EAAE,KAA6C;QAC5G,EAAE,CAAC,GAAG,CAAC,qBAAqB,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC9C,EAAE,CAAC,GAAG,CAAC,qBAAqB,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IAChD,CAAC;CACF"}

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":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAqElC,MAAM,kBAAkB,GAAG,yCAAyC,CAAC;AACrE,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAChD,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAEhD,MAAM,OAAO,2BAA2B;IAC/B,KAAK,CAAC,QAAQ,CACnB,OAA0B,EAC1B,OAAoC;QAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;QACrG,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAEnD,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,SAAS,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC;YACnE,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;SACjD,CAAC,CAAC;QAEH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACxC,CAAC;IAEM,YAAY,CAAC,OAA0B,EAAE,OAAoC;QAClF,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC;QAE/C,OAAO;YACL,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACrC,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,WAAW;YAC3C,OAAO,EAAE;gBACP,IAAI;gBACJ,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,WAAW,EAAE,OAAO,CAAC,WAAW,KAAK,IAAI;gBACzC,SAAS,EAAE,OAAO,CAAC,SAAS;aAC7B;YACD,OAAO,EAAE;gBACP,MAAM,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;gBACpF,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM;gBAChD,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,MAAM;gBAClC,QAAQ,EAAE,QAAQ,CAAC,MAAM;gBACzB,QAAQ,EAAE,QAAQ,CAAC,MAAM;gBACzB,oBAAoB,EAAE,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;aAC3G;YACD,iBAAiB,EAAE;gBACjB,MAAM,EAAE,gBAAgB;gBACxB,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,QAAQ,EAAE,QAAQ,CAAC,MAAM;gBACzB,oBAAoB,EAAE,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,oBAAoB,CAAC,MAAM;gBACrF,kBAAkB,EAAE,IAAI,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC,MAAM;aACnE;YACD,cAAc,EAAE,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,IAAI,EAAE,gBAAgB,CAAC;YAC1E,QAAQ;YACR,QAAQ;YACR,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;SACvE,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,MAA4B;QACxC,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAAC;QAChF,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAAC;QAChF,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc;aACpC,GAAG,CACF,CAAC,KAAK,EAAE,EAAE,CAAC;;cAEL,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;cACtB,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC;cAC1B,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;cACxB,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;YAC1B,CACL;aACA,IAAI,CAAC,EAAE,CAAC,CAAC;QACZ,MAAM,QAAQ,GACZ,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;YACrB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3D,CAAC,CAAC,8DAA8D,CAAC;QAErE,OAAO;;;;;;;;;;;;;;;;;;;oBAmBS,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC;2BACvB,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC;;;mDAGN,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;uDAC7B,MAAM,CAAC,OAAO,CAAC,UAAU;kDAC9B,MAAM,CAAC,OAAO,CAAC,KAAK;qDACjB,MAAM,CAAC,OAAO,CAAC,QAAQ;qDACvB,MAAM,CAAC,OAAO,CAAC,QAAQ;2DACjB,MAAM,CAAC,OAAO,CAAC,oBAAoB;;;;uBAIvE,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;uBAC9C,MAAM,CAAC,iBAAiB,CAAC,MAAM;yBAC7B,MAAM,CAAC,iBAAiB,CAAC,QAAQ;sCACpB,MAAM,CAAC,iBAAiB,CAAC,oBAAoB;oCAC/C,MAAM,CAAC,iBAAiB,CAAC,kBAAkB;;;;;;;aAOlE,SAAS;;;;QAId,YAAY;;;QAGZ,YAAY;;;;;;;;;;;;;;aAcP,QAAQ;;;;KAIhB,CAAC,IAAI,EAAE,CAAC;IACX,CAAC;IAEO,WAAW,CAAC,OAAoC;QACtD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5D,CAAC;IAEO,eAAe,CAAC,OAA0B;QAChD,OAAO;YACL,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM;YAC5B,GAAG,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,oBAAoB;iBACxD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC;iBAC7C,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;YAChC,GAAG,IAAI,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,uBAAuB,SAAS,EAAE,CAAC;SAClG,CAAC;IACJ,CAAC;IAEO,eAAe,CAAC,OAA0B;QAChD,OAAO;YACL,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ;YAC9B,GAAG,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,oBAAoB;iBACxD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC;iBAC/C,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;SACjC,CAAC;IACJ,CAAC;IAEO,yBAAyB,CAAC,OAA0B;QAC1D,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAChF,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;aAC9D,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;aAC7C,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IACtD,CAAC;IAEO,oBAAoB,CAC1B,OAA0B,EAC1B,IAA6C,EAC7C,gBAAyB;QAEzB,OAAO;YACL;gBACE,IAAI,EAAE,eAAe;gBACrB,QAAQ,EAAE,eAAe;gBACzB,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW;gBACtE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,uBAAuB;aACvE;YACD;gBACE,IAAI,EAAE,iBAAiB;gBACvB,QAAQ,EAAE,cAAc;gBACxB,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;gBAClD,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,kBAAkB;aACzD;YACD;gBACE,IAAI,EAAE,sBAAsB;gBAC5B,QAAQ,EAAE,QAAQ;gBAClB,MAAM,EAAE,IAAI,KAAK,SAAS,IAAI,gBAAgB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;gBACzG,MAAM,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,yCAAyC,CAAC,CAAC,CAAC,iBAAiB,IAAI,EAAE;aACjG;SACF,CAAC;IACJ,CAAC;IAEO,gBAAgB,CAAC,IAAU;QACjC,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,cAAc;YAC5C,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAC/B,oBAAoB,EAAE,IAAI,CAAC,QAAQ,CAAC,aAAa;YACjD,uBAAuB,EAAE,IAAI,CAAC,QAAQ,CAAC,eAAe;YACtD,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE;gBAC5C,MAAM,CAAC,IAAI,EAAE,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAClD,OAAO;oBACL,EAAE,EAAE,SAAS;oBACb,IAAI;oBACJ,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;iBAC1B,CAAC;YACJ,CAAC,CAAC;SACH,CAAC;IACJ,CAAC;IAEO,WAAW,CAAC,MAAgB,EAAE,YAAoB;QACxD,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC;YACtB,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YACjE,CAAC,CAAC,OAAO,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC;IAC7C,CAAC;IAEO,SAAS,CAAC,IAA2C;QAC3D,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/G,OAAO;;cAEG,IAAI,CAAC,MAAM;cACX,IAAI,CAAC,cAAc;cACnB,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;cAC9C,IAAI,CAAC,oBAAoB;cACzB,IAAI,CAAC,uBAAuB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;cAC3C,UAAU;YACZ,CAAC;IACX,CAAC;CACF;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,KAAK;SACT,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;SACxB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC;SACzB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAC9B,CAAC"}

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;
+}