@jterrats/smart-deployment 1.2.6 → 1.3.1

package/lib/deployment/rollback-planning-service.js

@@ -0,0 +1,178 @@
+import { execFile } from 'node:child_process';
+import { mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import * as path from 'node:path';
+import { promisify } from 'node:util';
+import { DependencyGraphBuilder } from '../dependencies/dependency-graph-builder.js';
+const execFileAsync = promisify(execFile);
+export class RollbackPlanningService {
+    gitProvider;
+    constructor(dependencies = {}) {
+        this.gitProvider = dependencies.gitProvider ?? new CliRollbackGitProvider();
+    }
+    async buildExecutionPlan(options) {
+        const changes = await this.gitProvider.listChanges(options.projectRoot, options.fromRef, options.toRef);
+        const destructiveChanges = changes.filter((change) => change.status === 'added');
+        const restoreChanges = changes.filter((change) => change.status === 'modified' || change.status === 'deleted');
+        const destructiveContext = this.filterContextByChanges(options.currentContext, destructiveChanges);
+        const restoreWorkspace = restoreChanges.length > 0
+            ? await this.gitProvider.checkoutArchive(options.projectRoot, options.fromRef)
+            : undefined;
+        const restoreContext = restoreWorkspace
+            ? this.filterContextByChanges(await options.buildContext(restoreWorkspace.projectRoot), restoreChanges)
+            : undefined;
+        return {
+            summary: {
+                from: options.fromRef,
+                to: options.toRef,
+                changes,
+                destructiveComponents: collectContextNodeIds(destructiveContext),
+                restoreComponents: collectContextNodeIds(restoreContext),
+            },
+            destructiveContext: hasComponents(destructiveContext) ? destructiveContext : undefined,
+            restoreContext: hasComponents(restoreContext) ? restoreContext : undefined,
+            cleanup: async () => {
+                await restoreWorkspace?.cleanup();
+            },
+        };
+    }
+    filterContextByChanges(context, changes) {
+        const changedComponents = resolveChangedComponents(context.scanResult, changes);
+        const included = new Set(changedComponents.map((component) => toNodeId(component)));
+        const components = context.scanResult.components
+            .filter((component) => included.has(toNodeId(component)))
+            .map((component) => cloneComponent(component, included));
+        const graphBuilder = new DependencyGraphBuilder();
+        graphBuilder.addComponents(components);
+        const dependencyResult = graphBuilder.build();
+        return {
+            ...context,
+            scanResult: {
+                ...context.scanResult,
+                components,
+                dependencyResult,
+            },
+            orderedWaves: filterWaves(context.orderedWaves, included),
+        };
+    }
+}
+class CliRollbackGitProvider {
+    async listChanges(projectRoot, fromRef, toRef) {
+        const { stdout } = await execFileAsync('git', ['diff', '--name-status', '--no-renames', `${fromRef}..${toRef}`], {
+            cwd: projectRoot,
+        });
+        return parseNameStatus(stdout);
+    }
+    async checkoutArchive(projectRoot, ref) {
+        const workspaceRoot = await mkdtemp(path.join(tmpdir(), 'smart-deployment-rollback-'));
+        const archivePath = path.join(workspaceRoot, 'source.tar');
+        await execFileAsync('git', ['archive', '--format=tar', '--output', archivePath, ref], { cwd: projectRoot });
+        await execFileAsync('tar', ['-xf', archivePath, '-C', workspaceRoot]);
+        await rm(archivePath, { force: true });
+        return {
+            projectRoot: workspaceRoot,
+            cleanup: async () => {
+                await rm(workspaceRoot, { recursive: true, force: true });
+            },
+        };
+    }
+}
+function parseNameStatus(output) {
+    return output
+        .split('\n')
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .map((line) => {
+        const [statusCode, filePath] = line.split(/\t+/);
+        return {
+            status: toRollbackStatus(statusCode),
+            path: normalizePath(filePath),
+        };
+    })
+        .sort((left, right) => left.path.localeCompare(right.path));
+}
+function toRollbackStatus(statusCode) {
+    if (statusCode.includes('A')) {
+        return 'added';
+    }
+    if (statusCode.includes('D')) {
+        return 'deleted';
+    }
+    return 'modified';
+}
+function resolveChangedComponents(scanResult, changes) {
+    const components = new Map();
+    for (const change of changes) {
+        const component = scanResult.components.find((candidate) => isComponentPathMatch(scanResult.projectRoot, candidate, change.path));
+        if (component) {
+            components.set(toNodeId(component), component);
+        }
+    }
+    return [...components.values()].sort((left, right) => toNodeId(left).localeCompare(toNodeId(right)));
+}
+function filterWaves(waves, included) {
+    return waves
+        .map((wave) => ({
+        ...wave,
+        components: wave.components.filter((nodeId) => included.has(nodeId)),
+    }))
+        .filter((wave) => wave.components.length > 0)
+        .map((wave, index) => ({
+        ...wave,
+        number: index + 1,
+        metadata: {
+            ...wave.metadata,
+            componentCount: wave.components.length,
+        },
+    }));
+}
+function cloneComponent(component, included) {
+    return {
+        ...component,
+        dependencies: filterNodeSet(component.dependencies, included),
+        optionalDependencies: component.optionalDependencies
+            ? filterNodeSet(component.optionalDependencies, included)
+            : undefined,
+        dependencyDetails: component.dependencyDetails?.filter((dependency) => included.has(dependency.nodeId)),
+        dependents: filterNodeSet(component.dependents, included),
+    };
+}
+function filterNodeSet(values, included) {
+    return new Set([...values].filter((value) => included.has(value)));
+}
+function isComponentPathMatch(projectRoot, component, changedPath) {
+    const relativeComponentPath = path.isAbsolute(component.filePath)
+        ? path.relative(projectRoot, component.filePath)
+        : component.filePath;
+    const componentPath = normalizePath(relativeComponentPath);
+    if (changedPath === componentPath || changedPath === `${componentPath}-meta.xml`) {
+        return true;
+    }
+    const bundleTypes = new Set([
+        'LightningComponentBundle',
+        'AuraDefinitionBundle',
+        'DigitalExperienceBundle',
+        'AiAuthoringBundle',
+    ]);
+    if (!bundleTypes.has(component.type)) {
+        return false;
+    }
+    const componentDirectory = normalizePath(path.dirname(componentPath));
+    return changedPath.startsWith(`${componentDirectory}/`);
+}
+function collectContextNodeIds(context) {
+    return context?.scanResult.components.map((component) => toNodeId(component)).sort() ?? [];
+}
+function hasComponents(context) {
+    return (context?.scanResult.components.length ?? 0) > 0;
+}
+function normalizePath(filePath) {
+    return filePath.split(path.sep).join('/');
+}
+function toNodeId(component) {
+    return `${component.type}:${component.name}`;
+}
+export const rollbackPlanningInternals = {
+    parseNameStatus,
+};
+//# sourceMappingURL=rollback-planning-service.js.map

package/lib/deployment/rollback-planning-service.js.map

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

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

@@ -10,6 +10,7 @@
  * @ac US-085-AC-6: Parse deployment results
  * @issue #85
  */
+import { type DeploymentDiagnostic } from './deployment-error-diagnostics.js';
 export type TestLevel = 'NoTestRun' | 'RunSpecifiedTests' | 'RunLocalTests' | 'RunAllTestsInOrg';
 export type DeploymentOptions = {
     manifestPath: string;
@@ -18,6 +19,7 @@ export type DeploymentOptions = {
     testLevel?: TestLevel;
     tests?: string[];
     checkOnly?: boolean;
+    postDestructiveChangesPath?: string;
 };
 export type DeploymentResult = {
     success: boolean;
@@ -28,6 +30,7 @@ export type DeploymentResult = {
     testsRun?: number;
     testFailures?: number;
     output: string;
+    diagnostics?: DeploymentDiagnostic[];
 };
 /**
  * @ac US-085-AC-1: Execute sf project deploy start
@@ -40,4 +43,5 @@ export declare class SfCliIntegration {
     private buildDeployCommand;
     private parseDeploymentOutput;
     checkDeploymentStatus(deploymentId: string, targetOrg: string): Promise<DeploymentResult>;
+    resumeDeployment(deploymentId: string, targetOrg: string): Promise<DeploymentResult>;
 }

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

@@ -13,6 +13,7 @@
 import { exec } from 'node:child_process';
 import { promisify } from 'node:util';
 import { getLogger } from '../utils/logger.js';
+import { normalizeDeploymentDiagnostics } from './deployment-error-diagnostics.js';
 const execAsync = promisify(exec);
 const logger = getLogger('SfCliIntegration');
 /**
@@ -48,6 +49,9 @@ export class SfCliIntegration {
             '--json',
             '--wait 60',
         ];
+        if (options.postDestructiveChangesPath) {
+            parts.push(`--post-destructive-changes ${options.postDestructiveChangesPath}`);
+        }
         if (options.testLevel) {
             parts.push(`--test-level ${options.testLevel}`);
         }
@@ -65,8 +69,9 @@ export class SfCliIntegration {
             const jsonMatch = output.match(/\{[\s\S]*\}/);
             if (jsonMatch) {
                 const parsed = JSON.parse(jsonMatch[0]);
+                const success = !failed && (parsed.result?.status === 'Succeeded' || parsed.result?.status === 'Success');
                 return {
-                    success: !failed && (parsed.result?.status === 'Succeeded' || parsed.result?.status === 'Success'),
+                    success,
                     deploymentId: parsed.result?.id,
                     status: parsed.result?.status ?? 'Unknown',
                     componentSuccesses: parsed.result?.numberComponentsDeployed ?? 0,
@@ -74,6 +79,7 @@ export class SfCliIntegration {
                     testsRun: parsed.result?.numberTestsTotal,
                     testFailures: parsed.result?.numberTestErrors,
                     output,
+                    diagnostics: success ? undefined : normalizeDeploymentDiagnostics(output),
                 };
             }
         }
@@ -81,12 +87,14 @@ export class SfCliIntegration {
             logger.warn('Failed to parse deployment output', { parseError });
         }
         // Fallback for non-JSON output
+        const success = !failed;
         return {
-            success: !failed,
+            success,
             status: failed ? 'Failed' : 'Unknown',
             componentSuccesses: 0,
             componentFailures: failed ? 1 : 0,
             output,
+            diagnostics: success ? undefined : normalizeDeploymentDiagnostics(output),
         };
     }
     async checkDeploymentStatus(deploymentId, targetOrg) {
@@ -101,5 +109,17 @@ export class SfCliIntegration {
             return this.parseDeploymentOutput(output, true);
         }
     }
+    async resumeDeployment(deploymentId, targetOrg) {
+        const command = `sf project deploy resume --job-id ${deploymentId} --target-org ${targetOrg} --json`;
+        try {
+            const { stdout, stderr } = await execAsync(command);
+            return this.parseDeploymentOutput(stdout + stderr);
+        }
+        catch (error) {
+            logger.error('Failed to resume deployment', { error, deploymentId });
+            const output = error instanceof Error ? error.message : String(error);
+            return this.parseDeploymentOutput(output, true);
+        }
+    }
 }
 //# sourceMappingURL=sf-cli-integration.js.map

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

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

package/lib/deployment/start-execution-service.d.ts

@@ -11,6 +11,7 @@ export type StartExecutionOptions = {
     validateOnly: boolean;
     allowCycleRemediation: boolean;
     skipTests: boolean;
+    destructive?: boolean;
     targetOrg?: string;
     sourcePath?: string;
     deploymentContext: DeploymentContext;

package/lib/deployment/start-execution-service.js

@@ -37,12 +37,15 @@ export class StartExecutionService {
             return { kind: 'skipped', reason: 'validate-only' };
         }
         const { scanResult, orderedWaves, aiContext } = options.deploymentContext;
+        const destructive = options.destructive === true;
+        const executionWaves = destructive ? [...orderedWaves].reverse() : orderedWaves;
         const testExecutor = this.testPlanService.createExecutor(scanResult.components);
-        const planner = new CycleRemediationPlanner(scanResult.dependencyResult.graph, {
-            components: scanResult.dependencyResult.components,
-        });
-        const remediationPlan = planner.createPlan();
-        if (remediationPlan.cycles.length > 0) {
+        const remediationPlan = destructive
+            ? undefined
+            : new CycleRemediationPlanner(scanResult.dependencyResult.graph, {
+                components: scanResult.dependencyResult.components,
+            }).createPlan();
+        if (remediationPlan && remediationPlan.cycles.length > 0) {
             options.log(`♻️ Detected ${remediationPlan.cycles.length} circular dependency cycle(s).`);
             if (!options.allowCycleRemediation) {
                 throw new Error('Circular dependencies detected. Re-run with --allow-cycle-remediation for supported ApexClass cycles or resolve them manually.');
@@ -61,8 +64,10 @@ export class StartExecutionService {
         if (!options.targetOrg) {
             throw new Error('The --target-org flag is required for real deployments.');
         }
-        await this.assertDynamicQueryFieldsAreSafe(scanResult.dependencyResult, options.targetOrg);
-        if (remediationPlan.cycles.length > 0) {
+        if (!destructive) {
+            await this.assertDynamicQueryFieldsAreSafe(scanResult.dependencyResult, options.targetOrg);
+        }
+        if (remediationPlan && remediationPlan.cycles.length > 0) {
             await this.cycleRemediationRunner.execute({
                 deploymentId,
                 targetOrg: options.targetOrg,
@@ -82,7 +87,7 @@ export class StartExecutionService {
             deploymentId,
             targetOrg: options.targetOrg,
             sourcePath: options.sourcePath,
-            orderedWaves,
+            orderedWaves: executionWaves,
             dependencyGraph: scanResult.dependencyResult.graph,
             componentMap: scanResult.dependencyResult.components,
             apiVersion: scanResult.apiVersion,
@@ -92,6 +97,7 @@ export class StartExecutionService {
             stateManager,
             sfCli,
             aiContext,
+            mode: destructive ? 'destructive' : 'deploy',
             log: options.log,
         });
         return { kind: 'executed' };

package/lib/deployment/start-execution-service.js.map

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

package/lib/deployment/wave-manifest-service.d.ts

@@ -7,6 +7,14 @@ export type WaveManifestParams = {
     componentMap: ReadonlyMap<NodeId, MetadataComponent>;
     apiVersion?: string;
 };
+export type DestructiveWaveManifestResult = {
+    packagePath: string;
+    destructiveChangesPath: string;
+};
 export declare class WaveManifestService {
     generateManifest(params: WaveManifestParams): Promise<string>;
+    generateDestructiveManifest(params: WaveManifestParams): Promise<DestructiveWaveManifestResult>;
+    private ensureManifestDir;
+    private buildPackageXml;
+    private buildTypeBlocks;
 }

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"}