@jterrats/smart-deployment 1.2.5 → 1.3.1

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

@@ -1,15 +1,19 @@
 import { getLogger } from '../utils/logger.js';
 import { formatDeploymentStatus, summarizeDeploymentState, } from './deployment-state-summary.js';
 import { StateManager } from './state-manager.js';
+import { SfCliIntegration } from './sf-cli-integration.js';
 import { buildWaveGraphFromState } from './wave-graph-state.js';
 const logger = getLogger('DeploymentStatusService');
 export class DeploymentStatusService {
     stateManager;
-    constructor(stateManager = new StateManager()) {
+    sfCli;
+    constructor(stateManager = new StateManager(), sfCli = new SfCliIntegration()) {
         this.stateManager = stateManager;
+        this.sfCli = sfCli;
     }
-    async getStatus() {
-        const state = await this.stateManager.loadState();
+    async getStatus(options = {}) {
+        const loadedState = await this.stateManager.loadState();
+        const state = loadedState && options.targetOrg ? await this.refreshRemoteState(loadedState, options.targetOrg) : loadedState;
         if (!state) {
             return {
                 hasState: false,
@@ -101,6 +105,55 @@ export class DeploymentStatusService {
             cycleRemediation: summary.cycleRemediation,
         }).join('\n');
     }
+    async refreshRemoteState(state, targetOrg) {
+        const remoteResult = await this.sfCli.checkDeploymentStatus(state.deploymentId, targetOrg);
+        const updatedState = this.applyRemoteResult(state, targetOrg, remoteResult);
+        await this.stateManager.saveState(updatedState);
+        return updatedState;
+    }
+    applyRemoteResult(state, targetOrg, result) {
+        const metadata = {
+            ...(state.metadata ?? {}),
+            lastKnownStatus: result.status,
+            remoteStatus: result.status,
+            remoteStatusCheckedAt: new Date().toISOString(),
+            remoteComponentSuccesses: result.componentSuccesses,
+            remoteComponentFailures: result.componentFailures,
+            remoteTestsRun: result.testsRun,
+            remoteTestFailures: result.testFailures,
+        };
+        if (result.status === 'Succeeded' || result.status === 'Success') {
+            return {
+                ...state,
+                targetOrg,
+                completedWaves: Array.from({ length: state.totalWaves }, (_, index) => index + 1),
+                currentWave: state.totalWaves,
+                failedWave: undefined,
+                metadata,
+            };
+        }
+        if (this.isFailedRemoteStatus(result.status)) {
+            return {
+                ...state,
+                targetOrg,
+                failedWave: state.failedWave ?? {
+                    waveNumber: state.currentWave ?? 1,
+                    error: result.output,
+                    timestamp: new Date().toISOString(),
+                },
+                metadata,
+            };
+        }
+        return {
+            ...state,
+            targetOrg,
+            failedWave: undefined,
+            metadata,
+        };
+    }
+    isFailedRemoteStatus(status) {
+        return ['Failed', 'Canceled', 'Error'].includes(status);
+    }
     expandRemainingWaves(currentWave, remainingCount, totalWaves) {
         return Array.from({ length: remainingCount }, (_, index) => currentWave + index).filter((wave) => wave <= totalWaves);
     }

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

@@ -1 +1 @@
-{"version":3,"file":"deployment-status-service.js","sourceRoot":"","sources":["../../src/deployment/deployment-status-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,EAEL,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,MAAM,MAAM,GAAG,SAAS,CAAC,yBAAyB,CAAC,CAAC;AAgCpD,MAAM,OAAO,uBAAuB;IACE;IAApC,YAAoC,eAA6B,IAAI,YAAY,EAAE;QAA/C,iBAAY,GAAZ,YAAY,CAAmC;IAAG,CAAC;IAEhF,KAAK,CAAC,SAAS;QACpB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC;QAElD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,MAAM,EAAE,aAAa;gBACrB,WAAW,EAAE,CAAC;gBACd,UAAU,EAAE,CAAC;gBACb,cAAc,EAAE,EAAE;gBAClB,cAAc,EAAE,EAAE;gBAClB,SAAS,EAAE,KAAK;gBAChB,UAAU,EAAE,SAAS;gBACrB,cAAc,EAAE,aAAa;gBAC7B,aAAa,EAAE,IAAI,CAAC,YAAY,CAAC,gBAAgB,EAAE;aACpD,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE;YACtC,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC,CAAC;QAEH,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC;YAC5C,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,cAAc,EAAE,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,UAAU,CAAC;YAC1G,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;YAC1C,eAAe,EAAE,OAAO,CAAC,aAAa;YACtC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,UAAU,EAAE,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,UAAU,CAAC;YACxD,cAAc,EAAE,OAAO,CAAC,UAAU;YAClC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;YAC1C,SAAS,EAAE,uBAAuB,CAAC,KAAK,CAAC;YACzC,SAAS,EAAE,OAAO,CAAC,WAAW;YAC9B,aAAa,EAAE,IAAI,CAAC,YAAY,CAAC,gBAAgB,EAAE;SACpD,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,gBAAgB;QAC3B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QAEvC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACtB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,qCAAqC;gBAC7C,cAAc,EAAE,EAAE;gBAClB,cAAc,EAAE,EAAE;aACnB,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACjE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,2CAA2C;gBACnD,cAAc,EAAE,OAAO,CAAC,cAAc;gBACtC,cAAc,EAAE,OAAO,CAAC,cAAc;gBACtC,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,YAAY,EAAE,OAAO,CAAC,YAAY;aACnC,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,OAAO,CAAC,gBAAgB;YACpC,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC,CAAC;IACJ,CAAC;IAEM,YAAY,CAAC,OAAgC;QAClD,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACtB,OAAO,CAAC,4BAA4B,EAAE,wBAAwB,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpG,CAAC;QAED,OAAO,sBAAsB,CAAC;YAC5B,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,SAAS;YAC/C,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,SAAS;YACzC,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC;YAC5C,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,cAAc,EAAE,OAAO,CAAC,cAAc,CAAC,MAAM;YAC7C,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,UAAU,EAAE,IAAI,CAAC,4BAA4B,CAAC,OAAO,CAAC;YACtD,UAAU,EAAE,OAAO,CAAC,cAAc;YAClC,WAAW,EAAE,OAAO,CAAC,SAAS,IAAI,SAAS;YAC3C,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;YAC1C,aAAa,EAAE,OAAO,CAAC,eAAe;YACtC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;SAC3C,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IAEO,oBAAoB,CAAC,WAAmB,EAAE,cAAsB,EAAE,UAAkB;QAC1F,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,WAAW,GAAG,KAAK,CAAC,CAAC,MAAM,CACrF,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,UAAU,CAC7B,CAAC;IACJ,CAAC;IAEO,eAAe,CACrB,MAA8D;QAE9D,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,aAAa;gBAChB,OAAO,aAAa,CAAC;YACvB,KAAK,aAAa;gBAChB,OAAO,aAAa,CAAC;YACvB,KAAK,QAAQ;gBACX,OAAO,QAAQ,CAAC;YAClB;gBACE,OAAO,WAAW,CAAC;QACvB,CAAC;IACH,CAAC;IAEO,mBAAmB,CAAC,UAAkB;QAC5C,IAAI,UAAU,KAAK,aAAa,EAAE,CAAC;YACjC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACzF,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YACnG,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,eAAe,CACrB,MAAyC;QAEzC,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,aAAa;gBAChB,OAAO,aAAa,CAAC;YACvB,KAAK,aAAa;gBAChB,OAAO,aAAa,CAAC;YACvB,KAAK,QAAQ;gBACX,OAAO,QAAQ,CAAC;YAClB;gBACE,OAAO,WAAW,CAAC;QACvB,CAAC;IACH,CAAC;IAEO,4BAA4B,CAAC,OAAgC;QACnE,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC;QACrD,IAAI,cAAc,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,CAAC;QACX,CAAC;QAED,OAAO,cAAc,GAAG,EAAE,CAAC;IAC7B,CAAC;CACF"}
+{"version":3,"file":"deployment-status-service.js","sourceRoot":"","sources":["../../src/deployment/deployment-status-service.ts"],"names":[],"mappings":"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"}

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

@@ -1,4 +1,5 @@
 import type { MetadataDependencyKind } from '../types/metadata.js';
+import type { CommitScopeOptions, CommitScopeSummary } from './commit-scope-service.js';
 export type DeploymentValidationIssue = {
     severity: 'error' | 'warning';
     message: string;
@@ -19,12 +20,14 @@ export type DeploymentValidationSummary = {
     aiProvider?: string;
     aiModel?: string;
     aiFallback?: boolean;
+    commitScope?: CommitScopeSummary;
 };
 export declare class DeploymentValidationService {
     private readonly projectAnalysisService;
     private readonly xmlValidator;
     validateProject(sourcePath?: string, options?: {
         useAI?: boolean;
+        commitScope?: CommitScopeOptions;
     }): Promise<DeploymentValidationSummary>;
     private createWaveDependencyRiskIssues;
     private findXmlMetadataFiles;

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

@@ -10,7 +10,11 @@ export class DeploymentValidationService {
     projectAnalysisService = new ProjectAnalysisService();
     xmlValidator = new XmlMetadataValidator();
     async validateProject(sourcePath, options = {}) {
-        const analysis = await this.projectAnalysisService.buildAnalysis({ sourcePath });
+        const analysis = await this.projectAnalysisService.buildAnalysis({
+            sourcePath,
+            useAI: options.useAI,
+            commitScope: options.commitScope,
+        });
         const { scanResult, waveResult } = analysis;
         const issues = [];
         const dependencyBreakdown = scanResult.dependencyResult.edges.reduce((accumulator, edge) => ({
@@ -41,7 +45,7 @@ export class DeploymentValidationService {
             });
         }
         issues.push(...this.createWaveDependencyRiskIssues(scanResult.dependencyResult.edges, waveResult.waves));
-        const xmlFiles = await this.findXmlMetadataFiles(scanResult.projectRoot);
+        const xmlFiles = await this.findXmlMetadataFiles(scanResult.projectRoot, analysis.commitScope?.enabled ? scanResult.components : undefined);
         const xmlResults = await this.xmlValidator.validateFiles(xmlFiles);
         for (const result of xmlResults) {
             for (const error of result.errors) {
@@ -112,6 +116,7 @@ export class DeploymentValidationService {
             aiProvider,
             aiModel,
             aiFallback,
+            commitScope: analysis.commitScope,
         };
     }
     createWaveDependencyRiskIssues(edges, waves) {
@@ -149,16 +154,39 @@ export class DeploymentValidationService {
             ];
         });
     }
-    async findXmlMetadataFiles(projectRoot) {
+    async findXmlMetadataFiles(projectRoot, scopedComponents) {
         const files = await globAsync('**/*-meta.xml', {
             cwd: projectRoot,
             absolute: true,
             ignore: ['**/node_modules/**', '**/.git/**'],
         });
+        const scopedPaths = scopedComponents ? createScopedXmlPathMatcher(projectRoot, scopedComponents) : undefined;
         return files.filter((filePath) => {
             const normalized = filePath.split(path.sep).join('/');
-            return !normalized.includes('/node_modules/') && !normalized.includes('/.git/');
+            return (!normalized.includes('/node_modules/') &&
+                !normalized.includes('/.git/') &&
+                (!scopedPaths || scopedPaths(filePath)));
         });
     }
 }
+function createScopedXmlPathMatcher(projectRoot, components) {
+    const exactPaths = new Set();
+    const directoryPrefixes = [];
+    for (const component of components) {
+        const relativePath = normalizeRelativePath(projectRoot, component.filePath);
+        exactPaths.add(relativePath);
+        exactPaths.add(`${relativePath}-meta.xml`);
+        if (component.type === 'LightningComponentBundle' || component.type === 'AuraDefinitionBundle') {
+            directoryPrefixes.push(`${relativePath}/`);
+        }
+    }
+    return (filePath) => {
+        const relativePath = normalizeRelativePath(projectRoot, filePath);
+        return exactPaths.has(relativePath) || directoryPrefixes.some((prefix) => relativePath.startsWith(prefix));
+    };
+}
+function normalizeRelativePath(projectRoot, filePath) {
+    const relativePath = path.isAbsolute(filePath) ? path.relative(projectRoot, filePath) : filePath;
+    return relativePath.split(path.sep).join('/');
+}
 //# sourceMappingURL=deployment-validation-service.js.map

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

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

package/lib/deployment/plan-explain-service.d.ts

@@ -0,0 +1,88 @@
+import type { DependencyEdge, NodeId } from '../types/dependency.js';
+import type { MetadataComponent } from '../types/metadata.js';
+import { DeploymentContextService, type DeploymentContextBuildOptions } from './deployment-context-service.js';
+import { SpecialDeploymentPlanService } from './special-deployment-plan.js';
+export type PlanExplainOptions = DeploymentContextBuildOptions & {
+    targetOrg?: string;
+    since?: string;
+    autoActivate?: boolean;
+};
+export type PlanExplainDependency = {
+    from: NodeId;
+    to: NodeId;
+    type: DependencyEdge['type'];
+    source: NonNullable<DependencyEdge['source']> | 'unknown';
+    reason: string;
+    confidence: number;
+    resolved: boolean;
+    fromWave?: number;
+    toWave?: number;
+};
+export type PlanExplainComponent = {
+    nodeId: NodeId;
+    type: MetadataComponent['type'];
+    name: string;
+    filePath: string;
+    wave: number;
+    placement: {
+        rationale: string;
+        confidence: number;
+        directDependencies: NodeId[];
+        transitiveBlockers: NodeId[];
+        unresolvedReferences: NodeId[];
+    };
+};
+export type PlanExplainProviderDecision = {
+    kind: string;
+    label: string;
+    decision: 'included' | 'skipped' | 'blocked';
+    components: string[];
+    excludedTypes: string[];
+    commands: Array<{
+        tool: string;
+        args: string[];
+        reason: string;
+    }>;
+    reason: string;
+    warnings: string[];
+    errors: string[];
+};
+export type PlanExplainResult = {
+    success: boolean;
+    projectRoot: string;
+    apiVersion: string;
+    components: PlanExplainComponent[];
+    dependencies: PlanExplainDependency[];
+    unresolvedReferences: PlanExplainDependency[];
+    providerDecisions: PlanExplainProviderDecision[];
+    summary: {
+        componentCount: number;
+        dependencyCount: number;
+        unresolvedReferenceCount: number;
+        providerDecisionCount: number;
+        waves: number;
+    };
+    ai?: {
+        enabled: boolean;
+        provider?: string;
+        model?: string;
+        fallback?: boolean;
+        inferredDependencies?: number;
+        inferenceFallback?: boolean;
+    };
+    architecturalConcerns: {
+        inherited: string[];
+        selfImposed: string[];
+    };
+};
+type PlanExplainServiceDependencies = {
+    deploymentContextService?: Pick<DeploymentContextService, 'buildContext'>;
+    specialDeploymentPlanService?: Pick<SpecialDeploymentPlanService, 'buildPlan'>;
+};
+export declare class PlanExplainService {
+    private readonly deploymentContextService;
+    private readonly specialDeploymentPlanService;
+    constructor(dependencies?: PlanExplainServiceDependencies);
+    explain(options?: PlanExplainOptions): Promise<PlanExplainResult>;
+}
+export {};

package/lib/deployment/plan-explain-service.js

@@ -0,0 +1,171 @@
+import { DeploymentContextService } from './deployment-context-service.js';
+import { SpecialDeploymentPlanService } from './special-deployment-plan.js';
+export class PlanExplainService {
+    deploymentContextService;
+    specialDeploymentPlanService;
+    constructor(dependencies = {}) {
+        this.deploymentContextService = dependencies.deploymentContextService ?? new DeploymentContextService();
+        this.specialDeploymentPlanService = dependencies.specialDeploymentPlanService ?? new SpecialDeploymentPlanService();
+    }
+    async explain(options = {}) {
+        const context = await this.deploymentContextService.buildContext(options);
+        const providerPlan = await this.specialDeploymentPlanService.buildPlan({
+            sourcePath: options.sourcePath,
+            targetOrg: options.targetOrg,
+            since: options.since,
+            dryRun: true,
+            autoActivate: options.autoActivate ?? false,
+        });
+        const waveByNodeId = buildWaveIndex(context.orderedWaves);
+        const dependencyResult = context.scanResult.dependencyResult;
+        const dependencies = dependencyResult.edges.map((edge) => explainDependency(edge, dependencyResult, waveByNodeId));
+        const unresolvedReferences = dependencies.filter((dependency) => !dependency.resolved);
+        return {
+            success: context.scanResult.errors.length === 0 && providerPlan.success,
+            projectRoot: context.scanResult.projectRoot,
+            apiVersion: context.scanResult.apiVersion,
+            components: context.scanResult.components
+                .map((component) => explainComponent(component, dependencyResult, waveByNodeId))
+                .sort((left, right) => left.nodeId.localeCompare(right.nodeId)),
+            dependencies: dependencies.sort(compareDependency),
+            unresolvedReferences: unresolvedReferences.sort(compareDependency),
+            providerDecisions: explainProviderDecisions(providerPlan),
+            summary: {
+                componentCount: context.scanResult.components.length,
+                dependencyCount: dependencies.length,
+                unresolvedReferenceCount: unresolvedReferences.length,
+                providerDecisionCount: providerPlan.phases.length,
+                waves: context.orderedWaves.length,
+            },
+            ai: context.aiContext
+                ? {
+                    enabled: context.aiContext.enabled,
+                    provider: context.aiContext.provider,
+                    model: context.aiContext.model,
+                    fallback: context.aiContext.fallback,
+                    inferredDependencies: context.aiContext.inferredDependencies,
+                    inferenceFallback: context.aiContext.inferenceFallback,
+                }
+                : undefined,
+            architecturalConcerns: {
+                inherited: [],
+                selfImposed: [
+                    'Introduces a stable JSON explanation contract over existing deployment analysis outputs without changing wave generation.',
+                ],
+            },
+        };
+    }
+}
+function explainComponent(component, dependencyResult, waveByNodeId) {
+    const nodeId = toNodeId(component);
+    const directDependencies = [...(dependencyResult.graph.get(nodeId) ?? [])].sort();
+    const unresolvedReferences = directDependencies
+        .filter((dependency) => !dependencyResult.components.has(dependency))
+        .sort();
+    const transitiveBlockers = collectTransitiveBlockers(nodeId, dependencyResult.graph, dependencyResult.components);
+    const wave = waveByNodeId.get(nodeId) ?? 0;
+    return {
+        nodeId,
+        type: component.type,
+        name: component.name,
+        filePath: component.filePath,
+        wave,
+        placement: {
+            rationale: formatPlacementRationale(wave, directDependencies, transitiveBlockers, unresolvedReferences),
+            confidence: calculatePlacementConfidence(directDependencies, unresolvedReferences, transitiveBlockers),
+            directDependencies,
+            transitiveBlockers,
+            unresolvedReferences,
+        },
+    };
+}
+function explainDependency(edge, dependencyResult, waveByNodeId) {
+    return {
+        from: edge.from,
+        to: edge.to,
+        type: edge.type,
+        source: edge.source ?? 'unknown',
+        reason: edge.reason ?? `${edge.from} depends on ${edge.to}`,
+        confidence: edge.confidence ?? (edge.type === 'inferred' ? 0.7 : 1),
+        resolved: dependencyResult.components.has(edge.to),
+        fromWave: waveByNodeId.get(edge.from),
+        toWave: waveByNodeId.get(edge.to),
+    };
+}
+function explainProviderDecisions(plan) {
+    return plan.phases.map((phase) => ({
+        kind: phase.kind,
+        label: phase.label,
+        decision: (phase.errors?.length ?? 0) > 0 ? 'blocked' : phase.skipped ? 'skipped' : 'included',
+        components: [...phase.components].sort(),
+        excludedTypes: [...(phase.excludedTypes ?? [])].sort(),
+        commands: phase.commands.map((command) => ({
+            tool: command.tool,
+            args: [...command.args],
+            reason: command.reason,
+        })),
+        reason: phase.skipReason ?? phase.commands.map((command) => command.reason).join(' '),
+        warnings: [...(phase.warnings ?? [])],
+        errors: [...(phase.errors ?? [])],
+    }));
+}
+function buildWaveIndex(waves) {
+    const waveByNodeId = new Map();
+    for (const wave of waves) {
+        for (const nodeId of wave.components) {
+            waveByNodeId.set(nodeId, wave.number);
+        }
+    }
+    return waveByNodeId;
+}
+function collectTransitiveBlockers(nodeId, graph, components) {
+    const direct = graph.get(nodeId) ?? new Set();
+    const blockers = new Set();
+    const visited = new Set([nodeId]);
+    const stack = [...direct];
+    while (stack.length > 0) {
+        const dependency = stack.pop();
+        if (visited.has(dependency)) {
+            continue;
+        }
+        visited.add(dependency);
+        if (!direct.has(dependency) && components.has(dependency)) {
+            blockers.add(dependency);
+        }
+        for (const next of graph.get(dependency) ?? []) {
+            stack.push(next);
+        }
+    }
+    return [...blockers].sort();
+}
+function formatPlacementRationale(wave, directDependencies, transitiveBlockers, unresolvedReferences) {
+    if (wave === 0) {
+        return 'Component was not assigned to a deployment wave.';
+    }
+    if (unresolvedReferences.length > 0) {
+        return `Placed in wave ${wave} with unresolved references requiring target-org or pre-existing metadata checks.`;
+    }
+    if (directDependencies.length === 0) {
+        return `Placed in wave ${wave} because it has no deployment dependencies.`;
+    }
+    if (transitiveBlockers.length > 0) {
+        return `Placed in wave ${wave} after direct dependencies and ${transitiveBlockers.length} transitive blocker(s).`;
+    }
+    return `Placed in wave ${wave} after its direct dependencies are available.`;
+}
+function calculatePlacementConfidence(directDependencies, unresolvedReferences, transitiveBlockers) {
+    if (unresolvedReferences.length > 0) {
+        return 0.55;
+    }
+    if (directDependencies.length === 0) {
+        return 1;
+    }
+    return transitiveBlockers.length > 0 ? 0.9 : 0.95;
+}
+function toNodeId(component) {
+    return `${component.type}:${component.name}`;
+}
+function compareDependency(left, right) {
+    return left.from.localeCompare(right.from) || left.to.localeCompare(right.to);
+}
+//# sourceMappingURL=plan-explain-service.js.map

package/lib/deployment/plan-explain-service.js.map

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

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

@@ -1,4 +1,5 @@
 import { StateManager } from './state-manager.js';
+import { SfCliIntegration } from './sf-cli-integration.js';
 export type ResumeRetryStrategy = 'standard' | 'quick' | 'validate-only';
 export type ResumePreparation = {
     deploymentId: string;
@@ -9,6 +10,9 @@ export type ResumePreparation = {
 };
 export declare class ResumeDeploymentService {
     private readonly stateManager;
-    constructor(stateManager?: StateManager);
-    prepareResume(retryStrategy: ResumeRetryStrategy): Promise<ResumePreparation>;
+    private readonly sfCli;
+    constructor(stateManager?: StateManager, sfCli?: Pick<SfCliIntegration, 'resumeDeployment'>);
+    prepareResume(retryStrategy: ResumeRetryStrategy, options?: {
+        targetOrg?: string;
+    }): Promise<ResumePreparation>;
 }

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

@@ -1,17 +1,41 @@
 import { createResumedState, summarizeDeploymentState } from './deployment-state-summary.js';
 import { StateManager } from './state-manager.js';
+import { SfCliIntegration } from './sf-cli-integration.js';
 export class ResumeDeploymentService {
     stateManager;
-    constructor(stateManager = new StateManager()) {
+    sfCli;
+    constructor(stateManager = new StateManager(), sfCli = new SfCliIntegration()) {
         this.stateManager = stateManager;
+        this.sfCli = sfCli;
     }
-    async prepareResume(retryStrategy) {
+    async prepareResume(retryStrategy, options = {}) {
         const state = await this.stateManager.loadState();
         if (!state?.failedWave) {
             throw new Error('No failed deployment state found to resume');
         }
         const summary = summarizeDeploymentState(state);
-        const resumedState = createResumedState(state, retryStrategy);
+        const remoteResult = options.targetOrg
+            ? await this.sfCli.resumeDeployment(state.deploymentId, options.targetOrg)
+            : undefined;
+        if (remoteResult?.success === false) {
+            throw new Error(`Remote resume failed: ${remoteResult.output}`);
+        }
+        const resumedState = createResumedState(remoteResult
+            ? {
+                ...state,
+                targetOrg: options.targetOrg ?? state.targetOrg,
+                metadata: {
+                    ...(state.metadata ?? {}),
+                    lastKnownStatus: remoteResult.status,
+                    remoteResumeStatus: remoteResult.status,
+                    remoteResumeCheckedAt: new Date().toISOString(),
+                    remoteComponentSuccesses: remoteResult.componentSuccesses,
+                    remoteComponentFailures: remoteResult.componentFailures,
+                    remoteTestsRun: remoteResult.testsRun,
+                    remoteTestFailures: remoteResult.testFailures,
+                },
+            }
+            : state, retryStrategy);
         await this.stateManager.saveState(resumedState);
         return {
             deploymentId: summary.deploymentId,

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

@@ -1 +1 @@
-{"version":3,"file":"resume-deployment-service.js","sourceRoot":"","sources":["../../src/deployment/resume-deployment-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAC7F,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAYlD,MAAM,OAAO,uBAAuB;IACE;IAApC,YAAoC,eAA6B,IAAI,YAAY,EAAE;QAA/C,iBAAY,GAAZ,YAAY,CAAmC;IAAG,CAAC;IAEhF,KAAK,CAAC,aAAa,CAAC,aAAkC;QAC3D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC;QAElD,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,OAAO,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,YAAY,GAAG,kBAAkB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QAE9D,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAEhD,OAAO;YACL,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,aAAa,EAAE,OAAO,CAAC,aAAa;SACrC,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"resume-deployment-service.js","sourceRoot":"","sources":["../../src/deployment/resume-deployment-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAC7F,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAY3D,MAAM,OAAO,uBAAuB;IAEf;IACA;IAFnB,YACmB,eAA6B,IAAI,YAAY,EAAE,EAC/C,QAAoD,IAAI,gBAAgB,EAAE;QAD1E,iBAAY,GAAZ,YAAY,CAAmC;QAC/C,UAAK,GAAL,KAAK,CAAqE;IAC1F,CAAC;IAEG,KAAK,CAAC,aAAa,CACxB,aAAkC,EAClC,UAAkC,EAAE;QAEpC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC;QAElD,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,OAAO,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS;YACpC,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,SAAS,CAAC;YAC1E,CAAC,CAAC,SAAS,CAAC;QAEd,IAAI,YAAY,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,yBAAyB,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,MAAM,YAAY,GAAG,kBAAkB,CACrC,YAAY;YACV,CAAC,CAAC;gBACE,GAAG,KAAK;gBACR,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS;gBAC/C,QAAQ,EAAE;oBACR,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;oBACzB,eAAe,EAAE,YAAY,CAAC,MAAM;oBACpC,kBAAkB,EAAE,YAAY,CAAC,MAAM;oBACvC,qBAAqB,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBAC/C,wBAAwB,EAAE,YAAY,CAAC,kBAAkB;oBACzD,uBAAuB,EAAE,YAAY,CAAC,iBAAiB;oBACvD,cAAc,EAAE,YAAY,CAAC,QAAQ;oBACrC,kBAAkB,EAAE,YAAY,CAAC,YAAY;iBAC9C;aACF;YACH,CAAC,CAAC,KAAK,EACT,aAAa,CACd,CAAC;QAEF,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAEhD,OAAO;YACL,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,aAAa,EAAE,OAAO,CAAC,aAAa;SACrC,CAAC;IACJ,CAAC;CACF"}

package/lib/deployment/retrieve-forceignore-service.d.ts

@@ -0,0 +1,51 @@
+export type RetrieveForceIgnoreOptions = {
+    projectRoot?: string;
+    targetOrg?: string;
+    metadata?: string[];
+    manifest?: string;
+    wait?: number;
+    strictIgnore?: boolean;
+    normalizeMeta?: boolean;
+};
+export type RetrieveForceIgnoreResult = {
+    success: boolean;
+    projectRoot: string;
+    retrieveOutput: string;
+    changedPaths: string[];
+    protectedPaths: string[];
+    restoredPaths: string[];
+    normalizedPaths: string[];
+    strictViolation: boolean;
+    architecturalConcerns: {
+        inherited: string[];
+        selfImposed: string[];
+    };
+};
+export type GitStatusEntry = {
+    path: string;
+    indexStatus: string;
+    workingTreeStatus: string;
+    untracked: boolean;
+};
+type RetrieveForceIgnoreServiceDependencies = {
+    sfRetrieveRunner?: Pick<SfRetrieveRunner, 'retrieve'>;
+    gitProvider?: Pick<GitWorkspaceProvider, 'listChangedPaths' | 'restorePaths'>;
+};
+export declare class RetrieveForceIgnoreService {
+    private readonly sfRetrieveRunner;
+    private readonly gitProvider;
+    constructor(dependencies?: RetrieveForceIgnoreServiceDependencies);
+    retrieve(options?: RetrieveForceIgnoreOptions): Promise<RetrieveForceIgnoreResult>;
+}
+export declare class SfRetrieveRunner {
+    retrieve(projectRoot: string, options: RetrieveForceIgnoreOptions): Promise<string>;
+}
+export declare class GitWorkspaceProvider {
+    listChangedPaths(projectRoot: string): Promise<GitStatusEntry[]>;
+    restorePaths(projectRoot: string, entries: GitStatusEntry[]): Promise<string[]>;
+}
+declare function parseGitStatus(output: string): GitStatusEntry[];
+export declare const retrieveForceIgnoreInternals: {
+    parseGitStatus: typeof parseGitStatus;
+};
+export {};