@jterrats/smart-deployment 1.2.6 → 1.3.1

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

package/lib/deployment/retrieve-forceignore-service.js

@@ -0,0 +1,139 @@
+import { execFile } from 'node:child_process';
+import { readFile, rm, writeFile } from 'node:fs/promises';
+import * as path from 'node:path';
+import { promisify } from 'node:util';
+import { glob } from 'glob';
+import { ForceIgnoreParser } from '../scanner/forceignore-parser.js';
+const execFileAsync = promisify(execFile);
+export class RetrieveForceIgnoreService {
+    sfRetrieveRunner;
+    gitProvider;
+    constructor(dependencies = {}) {
+        this.sfRetrieveRunner = dependencies.sfRetrieveRunner ?? new SfRetrieveRunner();
+        this.gitProvider = dependencies.gitProvider ?? new GitWorkspaceProvider();
+    }
+    async retrieve(options = {}) {
+        const projectRoot = path.resolve(options.projectRoot ?? process.cwd());
+        const retrieveOutput = await this.sfRetrieveRunner.retrieve(projectRoot, options);
+        const normalizedPaths = options.normalizeMeta === true ? await normalizeDigitalExperienceMeta(projectRoot) : [];
+        const parser = new ForceIgnoreParser();
+        const loadResult = await parser.load(projectRoot);
+        const changedEntries = await this.gitProvider.listChangedPaths(projectRoot);
+        const changedPaths = changedEntries.map((entry) => entry.path).sort();
+        const protectedEntries = loadResult.found
+            ? changedEntries.filter((entry) => parser.isIgnored(path.join(projectRoot, entry.path)))
+            : [];
+        const protectedPaths = protectedEntries.map((entry) => entry.path).sort();
+        const restoredPaths = protectedPaths.length > 0 ? await this.gitProvider.restorePaths(projectRoot, protectedEntries) : [];
+        const strictViolation = options.strictIgnore === true && protectedPaths.length > 0;
+        return {
+            success: !strictViolation,
+            projectRoot,
+            retrieveOutput,
+            changedPaths,
+            protectedPaths,
+            restoredPaths,
+            normalizedPaths,
+            strictViolation,
+            architecturalConcerns: {
+                inherited: [
+                    'Salesforce CLI may retrieve composite bundle sub-paths even when .forceignore excludes leaf paths.',
+                ],
+                selfImposed: [
+                    'Adds a retrieve wrapper that enforces .forceignore after the Salesforce CLI writes files because the underlying CLI does not expose reliable leaf-level bundle filtering.',
+                ],
+            },
+        };
+    }
+}
+export class SfRetrieveRunner {
+    async retrieve(projectRoot, options) {
+        const args = ['project', 'retrieve', 'start', '--json'];
+        for (const metadata of options.metadata ?? []) {
+            args.push('--metadata', metadata);
+        }
+        if (options.manifest) {
+            args.push('--manifest', options.manifest);
+        }
+        if (options.targetOrg) {
+            args.push('--target-org', options.targetOrg);
+        }
+        if (options.wait !== undefined) {
+            args.push('--wait', String(options.wait));
+        }
+        const { stdout, stderr } = await execFileAsync('sf', args, { cwd: projectRoot });
+        return stdout + stderr;
+    }
+}
+export class GitWorkspaceProvider {
+    async listChangedPaths(projectRoot) {
+        const { stdout } = await execFileAsync('git', ['status', '--porcelain', '--untracked-files=all'], {
+            cwd: projectRoot,
+        });
+        return parseGitStatus(stdout);
+    }
+    async restorePaths(projectRoot, entries) {
+        const restored = await entries.reduce(async (previous, entry) => {
+            const restoredPaths = await previous;
+            await restoreGitStatusEntry(projectRoot, entry);
+            return [...restoredPaths, entry.path];
+        }, Promise.resolve([]));
+        return restored.sort();
+    }
+}
+async function restoreGitStatusEntry(projectRoot, entry) {
+    const absolutePath = path.join(projectRoot, entry.path);
+    if (entry.untracked) {
+        await rm(absolutePath, { recursive: true, force: true });
+        return;
+    }
+    await execFileAsync('git', ['checkout', 'HEAD', '--', entry.path], { cwd: projectRoot });
+}
+function parseGitStatus(output) {
+    return output
+        .split('\n')
+        .filter(Boolean)
+        .map((line) => {
+        const indexStatus = line[0] ?? ' ';
+        const workingTreeStatus = line[1] ?? ' ';
+        const rawPath = line.slice(3);
+        const filePath = rawPath.includes(' -> ') ? rawPath.split(' -> ').at(-1) : rawPath;
+        return {
+            path: normalizeGitPath(filePath),
+            indexStatus,
+            workingTreeStatus,
+            untracked: indexStatus === '?' && workingTreeStatus === '?',
+        };
+    });
+}
+async function normalizeDigitalExperienceMeta(projectRoot) {
+    const files = await glob('**/digitalExperiences/**/*_meta.json', {
+        cwd: projectRoot,
+        absolute: true,
+        nodir: true,
+        dot: true,
+        ignore: ['**/node_modules/**', '**/.git/**'],
+    });
+    const normalizedPaths = await Promise.all(files.map(async (file) => {
+        const raw = await readFile(file, 'utf8');
+        const normalized = JSON.stringify(JSON.parse(raw), null, 2) + '\n';
+        if (raw === normalized) {
+            return undefined;
+        }
+        await writeFile(file, normalized, 'utf8');
+        return normalizeRelativePath(projectRoot, file);
+    }));
+    return normalizedPaths.filter((filePath) => filePath !== undefined).sort();
+}
+function normalizeGitPath(filePath) {
+    const unquoted = filePath.startsWith('"') && filePath.endsWith('"') ? JSON.parse(filePath) : filePath;
+    return unquoted.split(path.sep).join('/');
+}
+function normalizeRelativePath(projectRoot, filePath) {
+    const relativePath = path.relative(projectRoot, filePath);
+    return relativePath.split(path.sep).join('/');
+}
+export const retrieveForceIgnoreInternals = {
+    parseGitStatus,
+};
+//# sourceMappingURL=retrieve-forceignore-service.js.map

package/lib/deployment/retrieve-forceignore-service.js.map

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

package/lib/deployment/rollback-planning-service.d.ts

@@ -0,0 +1,49 @@
+import type { NodeId } from '../types/dependency.js';
+import type { DeploymentContext } from './deployment-context-service.js';
+export type RollbackChangeStatus = 'added' | 'modified' | 'deleted';
+export type RollbackGitChange = {
+    status: RollbackChangeStatus;
+    path: string;
+};
+export type RollbackSummary = {
+    from: string;
+    to: string;
+    changes: RollbackGitChange[];
+    destructiveComponents: NodeId[];
+    restoreComponents: NodeId[];
+};
+export type RollbackExecutionPlan = {
+    summary: RollbackSummary;
+    destructiveContext?: DeploymentContext;
+    restoreContext?: DeploymentContext;
+    cleanup: () => Promise<void>;
+};
+type RollbackPlanningServiceDependencies = {
+    gitProvider?: RollbackGitProvider;
+};
+type BuildContext = (sourcePath: string) => Promise<DeploymentContext>;
+export type RollbackGitProvider = {
+    listChanges(projectRoot: string, fromRef: string, toRef: string): Promise<RollbackGitChange[]>;
+    checkoutArchive(projectRoot: string, ref: string): Promise<RollbackWorkspace>;
+};
+export type RollbackWorkspace = {
+    projectRoot: string;
+    cleanup: () => Promise<void>;
+};
+export declare class RollbackPlanningService {
+    private readonly gitProvider;
+    constructor(dependencies?: RollbackPlanningServiceDependencies);
+    buildExecutionPlan(options: {
+        projectRoot: string;
+        fromRef: string;
+        toRef: string;
+        currentContext: DeploymentContext;
+        buildContext: BuildContext;
+    }): Promise<RollbackExecutionPlan>;
+    filterContextByChanges(context: DeploymentContext, changes: RollbackGitChange[]): DeploymentContext;
+}
+declare function parseNameStatus(output: string): RollbackGitChange[];
+export declare const rollbackPlanningInternals: {
+    parseNameStatus: typeof parseNameStatus;
+};
+export {};