@copado/agentia-cli 0.56.0-alpha.0 → 0.58.0-alpha.0

package/dist/lib/promotion-run.d.ts

@@ -0,0 +1,105 @@
+import { type PromotionDetail } from './promotion-types.js';
+export declare const PROMOTION_OPERATIONS: readonly ["merge", "merge_and_deploy"];
+export declare const PROMOTION_RUN_DEFAULT_TIMEOUT_SECONDS = 900;
+export type PromotionOperation = (typeof PROMOTION_OPERATIONS)[number];
+export type PromotionStartedJobPhase = 'deployment' | 'promotion';
+export type PromotionRunRecord = {
+    id?: null | string;
+    link?: null | string;
+    name?: null | string;
+    status?: null | string;
+};
+export type PromotionRunResponse = {
+    [key: string]: unknown;
+    jobExecution?: null | PromotionRunRecord;
+    promotion?: null | PromotionRunRecord;
+    startedJobPhase?: null | PromotionStartedJobPhase;
+};
+export type PromotionJobMonitor = {
+    [key: string]: unknown;
+    executionSteps?: unknown[];
+    jobExecutionErrorMessage?: null | string;
+    jobExecutionId?: null | string;
+    jobExecutionStatus?: null | string;
+};
+export type PromotionDeploymentStep = {
+    [key: string]: unknown;
+    id: string;
+};
+export type PromotionRunRequest = {
+    deploymentStepIds?: string[];
+    operation: PromotionOperation;
+    recreatePromotionBranch?: boolean;
+};
+export type PromotionRunHooks = {
+    log: (message?: string) => void;
+    withSpinner: <T>(message: string, action: () => Promise<T>) => Promise<T>;
+};
+export type PromotionRunResult = {
+    context: Record<string, unknown>;
+    deploymentSteps: PromotionDeploymentStep[];
+    ignoredMetadata?: unknown[];
+    jobMonitors: PromotionJobMonitor[];
+    mode: 'resume' | 'run';
+    operation?: PromotionOperation;
+    promotionAfter?: PromotionDetail;
+    promotionBefore: PromotionDetail;
+    promotionId: string;
+    request?: PromotionRunRequest;
+    resultId: string;
+    run: PromotionRunResponse;
+    wait: boolean;
+};
+export declare class PromotionRunValidationError extends Error {
+    constructor(message: string);
+}
+export declare class PromotionRunJobFailedError extends Error {
+    readonly jobMonitor: PromotionJobMonitor;
+    readonly result?: PromotionRunResult;
+    constructor(jobMonitor: PromotionJobMonitor, result?: PromotionRunResult);
+}
+export declare class PromotionRunTimeoutError extends Error {
+    readonly jobMonitor?: PromotionJobMonitor;
+    readonly result?: PromotionRunResult;
+    constructor(timeoutSeconds: number, jobMonitor?: PromotionJobMonitor, result?: PromotionRunResult);
+}
+export declare class PromotionRunIncompleteResponseError extends Error {
+    readonly result?: PromotionRunResult;
+    constructor(message: string, result?: PromotionRunResult);
+}
+export type PromotionRunExecutionError = PromotionRunIncompleteResponseError | PromotionRunJobFailedError | PromotionRunTimeoutError;
+export declare function isPromotionRunExecutionError(error: unknown): error is PromotionRunExecutionError;
+export declare function promotionRunErrorJson(base: Record<string, unknown>, error: unknown): Record<string, unknown>;
+export type SleepFn = (ms: number) => Promise<void>;
+export declare function setPromotionRunSleepForTests(nextSleep: SleepFn): void;
+export declare function resetPromotionRunSleepForTests(): void;
+export declare function requirePromotionId(value: string): string;
+export declare function promotionRunDetailEndpoint(promotionId: string): string;
+export declare function promotionContextEndpoint(promotionId: string, operation: PromotionOperation): string;
+export declare function promotionDeploymentStepsEndpoint(promotionId: string): string;
+export declare function promotionIgnoredMetadataEndpoint(promotionId: string): string;
+export declare function promotionRunEndpoint(promotionId: string): string;
+export declare function promotionResumeEndpoint(promotionId: string, jobExecutionId: string): string;
+export declare function promotionValidateResolutionEndpoint(promotionId: string): string;
+export declare function promotionJobMonitorEndpoint(jobExecutionId: string, promotionId: string): string;
+export declare function parseIgnoredMetadataJson(value?: string): undefined | unknown[];
+export declare function resolvePromotionIdForWorkItem(userStoryId: string, explicitPromotionId?: string): Promise<string>;
+export declare function assertPromotionContextReady(context: Record<string, unknown>, operation: PromotionOperation): void;
+export declare function performPromotionRun(options: {
+    deploymentStepIds?: string[];
+    hooks: PromotionRunHooks;
+    ignoredMetadata?: unknown[];
+    operation: PromotionOperation;
+    promotionId: string;
+    recreatePromotionBranch?: boolean;
+    timeoutSeconds: number;
+    wait: boolean;
+}): Promise<PromotionRunResult>;
+export declare function performPromotionResume(options: {
+    hooks: PromotionRunHooks;
+    jobExecutionId: string;
+    promotionId: string;
+    timeoutSeconds: number;
+    wait: boolean;
+}): Promise<PromotionRunResult>;
+export declare function formatPromotionRunResult(result: PromotionRunResult): string;

package/dist/lib/promotion-run.js

@@ -0,0 +1,481 @@
+import { CicdGateway } from './cicd-gateway.js';
+import { cellValue } from './format.js';
+import { normalizePromotionDetail, normalizePromotionsListPage, promotionListEndpoint, } from './promotion-types.js';
+export const PROMOTION_OPERATIONS = ['merge', 'merge_and_deploy'];
+export const PROMOTION_RUN_DEFAULT_TIMEOUT_SECONDS = 900;
+const FAILED_JOB_STATUSES = new Set(['canceled', 'completed with errors', 'error', 'failed', 'skipped', 'validation failed']);
+const POLL_BACKOFF_SECONDS = [2, 3, 5, 10];
+const SUCCESSFUL_JOB_STATUSES = new Set(['completed', 'success', 'successful', 'validated']);
+const SALESFORCE_ID_18_PATTERN = /^[A-Za-z0-9]{18}$/;
+export class PromotionRunValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PromotionRunValidationError';
+    }
+}
+export class PromotionRunJobFailedError extends Error {
+    jobMonitor;
+    result;
+    constructor(jobMonitor, result) {
+        const status = jobMonitor.jobExecutionStatus ?? 'unknown';
+        const jobId = jobMonitor.jobExecutionId?.trim();
+        const detail = jobMonitor.jobExecutionErrorMessage?.trim();
+        const prefix = jobId && jobId.length > 0 ? `Promotion job ${jobId}` : 'Promotion job';
+        super(detail && detail.length > 0 ? `${prefix} finished with status ${status}: ${detail}` : `${prefix} finished with status ${status}.`);
+        this.jobMonitor = jobMonitor;
+        this.name = 'PromotionRunJobFailedError';
+        this.result = result;
+    }
+}
+export class PromotionRunTimeoutError extends Error {
+    jobMonitor;
+    result;
+    constructor(timeoutSeconds, jobMonitor, result) {
+        const jobId = jobMonitor?.jobExecutionId?.trim();
+        const suffix = jobId && jobId.length > 0 ? ` Last job execution ID: ${jobId}.` : '';
+        super(`Promotion execution did not finish within ${timeoutSeconds}s.${suffix}`);
+        this.jobMonitor = jobMonitor;
+        this.name = 'PromotionRunTimeoutError';
+        this.result = result;
+    }
+}
+export class PromotionRunIncompleteResponseError extends Error {
+    result;
+    constructor(message, result) {
+        super(message);
+        this.name = 'PromotionRunIncompleteResponseError';
+        this.result = result;
+    }
+}
+export function isPromotionRunExecutionError(error) {
+    return (error instanceof PromotionRunJobFailedError ||
+        error instanceof PromotionRunTimeoutError ||
+        error instanceof PromotionRunIncompleteResponseError);
+}
+export function promotionRunErrorJson(base, error) {
+    if (!isPromotionRunExecutionError(error)) {
+        return base;
+    }
+    return {
+        ...base,
+        error: {
+            ...(base.error && typeof base.error === 'object' ? base.error : {}),
+            ...(error instanceof PromotionRunJobFailedError || error instanceof PromotionRunTimeoutError
+                ? error.jobMonitor === undefined
+                    ? {}
+                    : { jobMonitor: error.jobMonitor }
+                : {}),
+            ...(error.result === undefined ? {} : { result: error.result }),
+        },
+    };
+}
+const defaultSleep = async (ms) => new Promise((resolve) => {
+    setTimeout(resolve, ms);
+});
+let sleepFn = defaultSleep;
+// Test-only hook
+export function setPromotionRunSleepForTests(nextSleep) {
+    sleepFn = nextSleep;
+}
+// Test-only hook
+export function resetPromotionRunSleepForTests() {
+    sleepFn = defaultSleep;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function normalizeStatus(status) {
+    return status?.trim().toLowerCase() ?? '';
+}
+function isTerminalJobStatus(status) {
+    const normalized = normalizeStatus(status);
+    return SUCCESSFUL_JOB_STATUSES.has(normalized) || FAILED_JOB_STATUSES.has(normalized);
+}
+function isFailedJobStatus(status) {
+    return FAILED_JOB_STATUSES.has(normalizeStatus(status));
+}
+export function requirePromotionId(value) {
+    const promotionId = value.trim();
+    if (!SALESFORCE_ID_18_PATTERN.test(promotionId)) {
+        throw new PromotionRunValidationError('Promotion ID must be an 18-character Salesforce ID, not a display name.');
+    }
+    return promotionId;
+}
+function requireExecutionId(value) {
+    const executionId = value.trim();
+    if (executionId.length === 0) {
+        throw new PromotionRunValidationError('Job execution ID is required.');
+    }
+    return executionId;
+}
+export function promotionRunDetailEndpoint(promotionId) {
+    return `/release/promotion/${requirePromotionId(promotionId)}`;
+}
+export function promotionContextEndpoint(promotionId, operation) {
+    const params = new URLSearchParams({ operation, view: 'steps' });
+    return `${promotionRunDetailEndpoint(promotionId)}/context?${params.toString()}`;
+}
+export function promotionDeploymentStepsEndpoint(promotionId) {
+    const params = new URLSearchParams({ operation: 'merge_and_deploy' });
+    return `${promotionRunDetailEndpoint(promotionId)}/deployment-steps?${params.toString()}`;
+}
+export function promotionIgnoredMetadataEndpoint(promotionId) {
+    return `${promotionRunDetailEndpoint(promotionId)}/ignored-metadata`;
+}
+export function promotionRunEndpoint(promotionId) {
+    return `${promotionRunDetailEndpoint(promotionId)}/run`;
+}
+export function promotionResumeEndpoint(promotionId, jobExecutionId) {
+    return `${promotionRunDetailEndpoint(promotionId)}/job-executions/${requireExecutionId(jobExecutionId)}/resume`;
+}
+export function promotionValidateResolutionEndpoint(promotionId) {
+    return `${promotionRunDetailEndpoint(promotionId)}/validate-resolution`;
+}
+export function promotionJobMonitorEndpoint(jobExecutionId, promotionId) {
+    const params = new URLSearchParams();
+    params.set('discover_sub_executions', 'true');
+    params.set('include_history', 'true');
+    params.set('promotion_id', requirePromotionId(promotionId));
+    return `/release/job-monitor/execution/${requireExecutionId(jobExecutionId)}?${params.toString()}`;
+}
+function normalizeDeploymentSteps(value) {
+    const candidate = isRecord(value) && Array.isArray(value.deploymentSteps)
+        ? value.deploymentSteps
+        : isRecord(value) && Array.isArray(value.data)
+            ? value.data
+            : value;
+    if (!Array.isArray(candidate)) {
+        return [];
+    }
+    return candidate.flatMap((step) => {
+        if (!isRecord(step) || typeof step.id !== 'string' || step.id.trim().length === 0) {
+            return [];
+        }
+        return [{ ...step, id: step.id.trim() }];
+    });
+}
+export function parseIgnoredMetadataJson(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch (error) {
+        throw new PromotionRunValidationError(`--ignored-metadata-json must contain valid JSON: ${error.message}`);
+    }
+    if (!Array.isArray(parsed)) {
+        throw new PromotionRunValidationError('--ignored-metadata-json must be a JSON array.');
+    }
+    return parsed;
+}
+export async function resolvePromotionIdForWorkItem(userStoryId, explicitPromotionId) {
+    if (explicitPromotionId !== undefined) {
+        return requirePromotionId(explicitPromotionId);
+    }
+    const response = await CicdGateway.call({
+        endpoint: promotionListEndpoint({ pageSize: 200, userStoryId }),
+        method: 'GET',
+    });
+    const promotions = normalizePromotionsListPage(response).data;
+    if (promotions.length === 0) {
+        throw new PromotionRunValidationError(`No promotion contains User Story ${userStoryId}.`);
+    }
+    if (promotions.length > 1) {
+        const matches = promotions.map((promotion) => `${promotion.name ?? 'unnamed'} (${promotion.id})`).join(', ');
+        throw new PromotionRunValidationError(`User Story ${userStoryId} belongs to multiple promotions: ${matches}. Pass --promotion-id to select one.`);
+    }
+    return requirePromotionId(promotions[0].id);
+}
+async function getPromotionDetail(promotionId) {
+    const response = await CicdGateway.call({
+        endpoint: promotionRunDetailEndpoint(promotionId),
+        method: 'GET',
+    });
+    return normalizePromotionDetail(response);
+}
+function assertRunnablePromotion(promotion) {
+    const status = normalizeStatus(promotion.status);
+    if (status === 'in progress' || status === 'scheduled') {
+        const executionId = promotion.lastPromotionExecutionId?.trim();
+        const suffix = executionId && executionId.length > 0 ? ` Existing execution: ${executionId}.` : '';
+        throw new PromotionRunValidationError(`Promotion ${promotion.id} is ${promotion.status}; refusing to start a duplicate run.${suffix}`);
+    }
+    if (status !== 'merge conflict') {
+        return;
+    }
+    const executionId = promotion.lastPromotionExecutionId?.trim();
+    const resume = executionId && executionId.length > 0 ? ` --resume ${executionId}` : ' --resume <job-execution-id>';
+    throw new PromotionRunValidationError(`Promotion ${promotion.id} is in Merge Conflict. Resolve every conflict, validate the resolution, then resume the original execution with \`agentia cicd promotion run ${promotion.id}${resume}\`. Do not start /run again.`);
+}
+function contextStepsPreview(context) {
+    return isRecord(context.stepsPreview) ? context.stepsPreview : context;
+}
+export function assertPromotionContextReady(context, operation) {
+    const preview = contextStepsPreview(context);
+    const status = typeof preview.promotionStatus === 'string' ? normalizeStatus(preview.promotionStatus) : '';
+    if (status === 'in progress' || status === 'scheduled') {
+        const promotionJob = isRecord(preview.promotionJob) ? preview.promotionJob : undefined;
+        const jobExecutionId = promotionJob && typeof promotionJob.jobExecutionId === 'string' ? promotionJob.jobExecutionId.trim() : '';
+        const suffix = jobExecutionId.length > 0 ? ` Existing execution: ${jobExecutionId}.` : '';
+        throw new PromotionRunValidationError(`Promotion context is ${preview.promotionStatus}; refusing to start a duplicate run.${suffix}`);
+    }
+    if (operation === 'merge') {
+        if (preview.executePromotion === false || preview.executeDeployment === true || preview.deploymentDryRun === true) {
+            throw new PromotionRunValidationError('Promotion context flags do not match the merge operation.');
+        }
+        const summary = isRecord(preview.includedMetadataSummary) ? preview.includedMetadataSummary : undefined;
+        if (summary?.changeCount === 0) {
+            throw new PromotionRunValidationError('Promote-only requires at least one metadata change.');
+        }
+    }
+    if (operation === 'merge_and_deploy' && preview.executeDeployment === false) {
+        throw new PromotionRunValidationError('Promotion context flags do not enable deployment for merge_and_deploy.');
+    }
+}
+async function waitForPromotionJob(options) {
+    const { deadline, hooks, jobExecutionId, promotionId, timeoutSeconds } = options;
+    let lastResult;
+    let pollCount = 0;
+    for (;;) {
+        // eslint-disable-next-line no-await-in-loop -- job polling must be sequential
+        const result = await CicdGateway.call({
+            endpoint: promotionJobMonitorEndpoint(jobExecutionId, promotionId),
+            method: 'GET',
+        });
+        lastResult = result;
+        hooks.log(`Promotion job ${jobExecutionId}: ${result.jobExecutionStatus ?? 'unknown'}`);
+        if (isTerminalJobStatus(result.jobExecutionStatus)) {
+            if (isFailedJobStatus(result.jobExecutionStatus)) {
+                throw new PromotionRunJobFailedError(result);
+            }
+            return result;
+        }
+        const remainingMs = deadline - Date.now();
+        if (remainingMs <= 0) {
+            throw new PromotionRunTimeoutError(timeoutSeconds, lastResult);
+        }
+        const delaySeconds = POLL_BACKOFF_SECONDS[Math.min(pollCount, POLL_BACKOFF_SECONDS.length - 1)];
+        // eslint-disable-next-line no-await-in-loop -- bounded polling backoff
+        await sleepFn(Math.min(delaySeconds * 1000, remainingMs));
+        pollCount += 1;
+    }
+}
+async function discoverDeploymentExecution(options) {
+    const { deadline, hooks, previousExecutionId, promotionId } = options;
+    let pollCount = 0;
+    for (;;) {
+        // eslint-disable-next-line no-await-in-loop -- deployment execution appears asynchronously
+        const promotion = await getPromotionDetail(promotionId);
+        const executionId = promotion.lastDeploymentExecutionId?.trim();
+        if (executionId && executionId.length > 0 && executionId !== previousExecutionId) {
+            return { executionId, promotion };
+        }
+        const remainingMs = deadline - Date.now();
+        if (remainingMs <= 0) {
+            return { promotion };
+        }
+        const delaySeconds = POLL_BACKOFF_SECONDS[Math.min(pollCount, POLL_BACKOFF_SECONDS.length - 1)];
+        hooks.log(`Waiting for deployment execution for promotion ${promotionId}.`);
+        // eslint-disable-next-line no-await-in-loop -- bounded deployment discovery
+        await sleepFn(Math.min(delaySeconds * 1000, remainingMs));
+        pollCount += 1;
+    }
+}
+function promotionRunResult(options) {
+    return { ...options, mode: 'run' };
+}
+// eslint-disable-next-line complexity -- orchestration intentionally mirrors the sequential promotion API lifecycle
+export async function performPromotionRun(options) {
+    const { deploymentStepIds, hooks, ignoredMetadata, operation, promotionId: rawPromotionId, recreatePromotionBranch, timeoutSeconds, wait, } = options;
+    const promotionId = requirePromotionId(rawPromotionId);
+    const promotionBefore = await hooks.withSpinner('Fetching promotion details', () => getPromotionDetail(promotionId));
+    assertRunnablePromotion(promotionBefore);
+    const context = await hooks.withSpinner('Checking promotion readiness', () => CicdGateway.call({
+        endpoint: promotionContextEndpoint(promotionId, operation),
+        method: 'GET',
+    }));
+    assertPromotionContextReady(context, operation);
+    const deploymentSteps = operation === 'merge_and_deploy'
+        ? await hooks.withSpinner('Fetching deployment steps', async () => normalizeDeploymentSteps(await CicdGateway.call({
+            endpoint: promotionDeploymentStepsEndpoint(promotionId),
+            method: 'GET',
+        })))
+        : [];
+    const orderedStepIds = deploymentStepIds ?? deploymentSteps.map((step) => step.id);
+    if (ignoredMetadata !== undefined) {
+        await hooks.withSpinner('Persisting ignored metadata', () => CicdGateway.call({
+            body: { ignoredMetadata },
+            endpoint: promotionIgnoredMetadataEndpoint(promotionId),
+            headers: { 'Content-Type': 'application/json' },
+            method: 'PUT',
+        }));
+    }
+    const request = {
+        ...(orderedStepIds.length === 0 ? {} : { deploymentStepIds: orderedStepIds }),
+        operation,
+        ...(recreatePromotionBranch === undefined ? {} : { recreatePromotionBranch }),
+    };
+    const run = await hooks.withSpinner('Starting promotion execution', () => CicdGateway.call({
+        body: request,
+        endpoint: promotionRunEndpoint(promotionId),
+        headers: { 'Content-Type': 'application/json' },
+        method: 'POST',
+    }));
+    const resultId = run.jobExecution?.id?.trim();
+    if (!resultId) {
+        throw new PromotionRunIncompleteResponseError(`Promotion execution started without jobExecution.id. Promotion link: ${run.promotion?.link ?? promotionId}`);
+    }
+    const baseResult = {
+        context,
+        deploymentSteps,
+        ...(ignoredMetadata === undefined ? {} : { ignoredMetadata }),
+        jobMonitors: [],
+        operation,
+        promotionBefore,
+        promotionId,
+        request,
+        resultId,
+        run,
+        wait,
+    };
+    if (operation === 'merge_and_deploy' &&
+        run.startedJobPhase !== 'promotion' &&
+        run.startedJobPhase !== 'deployment') {
+        throw new PromotionRunIncompleteResponseError('merge_and_deploy response did not include a recognized startedJobPhase.', promotionRunResult(baseResult));
+    }
+    if (!wait) {
+        return promotionRunResult(baseResult);
+    }
+    const deadline = Date.now() + timeoutSeconds * 1000;
+    let promotionAfter;
+    try {
+        const firstMonitor = await hooks.withSpinner('Waiting for promotion execution', () => waitForPromotionJob({ deadline, hooks, jobExecutionId: resultId, promotionId, timeoutSeconds }));
+        baseResult.jobMonitors.push(firstMonitor);
+        if (operation === 'merge_and_deploy' && run.startedJobPhase === 'promotion') {
+            const discovered = await discoverDeploymentExecution({
+                deadline,
+                hooks,
+                previousExecutionId: promotionBefore.lastDeploymentExecutionId,
+                promotionId,
+            });
+            promotionAfter = discovered.promotion;
+            const partial = promotionRunResult({ ...baseResult, promotionAfter });
+            if (discovered.executionId === undefined) {
+                throw new PromotionRunTimeoutError(timeoutSeconds, undefined, partial);
+            }
+            const deploymentMonitor = await hooks.withSpinner('Waiting for deployment execution', () => waitForPromotionJob({
+                deadline,
+                hooks,
+                jobExecutionId: discovered.executionId,
+                promotionId,
+                timeoutSeconds,
+            }));
+            baseResult.jobMonitors.push(deploymentMonitor);
+            return promotionRunResult({ ...baseResult, promotionAfter });
+        }
+        return promotionRunResult(baseResult);
+    }
+    catch (error) {
+        if (error instanceof PromotionRunJobFailedError || error instanceof PromotionRunTimeoutError) {
+            const monitor = error.jobMonitor;
+            const jobMonitors = monitor === undefined ? baseResult.jobMonitors : [...baseResult.jobMonitors, monitor];
+            const partial = promotionRunResult({
+                ...baseResult,
+                jobMonitors,
+                ...(promotionAfter === undefined ? {} : { promotionAfter }),
+            });
+            if (error instanceof PromotionRunJobFailedError) {
+                throw new PromotionRunJobFailedError(error.jobMonitor, partial);
+            }
+            throw new PromotionRunTimeoutError(timeoutSeconds, monitor, partial);
+        }
+        throw error;
+    }
+}
+export async function performPromotionResume(options) {
+    const { hooks, jobExecutionId: rawJobExecutionId, promotionId: rawPromotionId, timeoutSeconds, wait } = options;
+    const promotionId = requirePromotionId(rawPromotionId);
+    const jobExecutionId = requireExecutionId(rawJobExecutionId);
+    const promotionBefore = await hooks.withSpinner('Fetching promotion details', () => getPromotionDetail(promotionId));
+    if (normalizeStatus(promotionBefore.status) === 'merge conflict') {
+        throw new PromotionRunValidationError(`Promotion ${promotionId} still has unresolved merge conflicts. Resolve every conflict before resuming execution ${jobExecutionId}.`);
+    }
+    if (normalizeStatus(promotionBefore.status) === 'conflicts resolved') {
+        const validation = await hooks.withSpinner('Validating conflict resolution', () => CicdGateway.call({
+            endpoint: promotionValidateResolutionEndpoint(promotionId),
+            method: 'POST',
+        }));
+        if (validation.ok !== true) {
+            throw new PromotionRunValidationError(`Conflict resolution validation failed for promotion ${promotionId}.`);
+        }
+    }
+    const run = await hooks.withSpinner('Resuming promotion execution', () => CicdGateway.call({
+        endpoint: promotionResumeEndpoint(promotionId, jobExecutionId),
+        method: 'POST',
+    }));
+    const resultId = run.jobExecution?.id?.trim();
+    if (!resultId) {
+        throw new PromotionRunIncompleteResponseError(`Promotion resume returned no jobExecution.id. Promotion link: ${run.promotion?.link ?? promotionId}`);
+    }
+    const result = {
+        context: {},
+        deploymentSteps: [],
+        jobMonitors: [],
+        mode: 'resume',
+        promotionBefore,
+        promotionId,
+        resultId,
+        run,
+        wait,
+    };
+    if (!wait) {
+        return result;
+    }
+    const deadline = Date.now() + timeoutSeconds * 1000;
+    try {
+        const monitor = await hooks.withSpinner('Waiting for resumed promotion execution', () => waitForPromotionJob({ deadline, hooks, jobExecutionId: resultId, promotionId, timeoutSeconds }));
+        result.jobMonitors.push(monitor);
+        return result;
+    }
+    catch (error) {
+        if (error instanceof PromotionRunJobFailedError) {
+            throw new PromotionRunJobFailedError(error.jobMonitor, { ...result, jobMonitors: [error.jobMonitor] });
+        }
+        if (error instanceof PromotionRunTimeoutError) {
+            throw new PromotionRunTimeoutError(timeoutSeconds, error.jobMonitor, {
+                ...result,
+                ...(error.jobMonitor === undefined ? {} : { jobMonitors: [error.jobMonitor] }),
+            });
+        }
+        throw error;
+    }
+}
+function formatRunRecord(label, record) {
+    if (record === undefined || record === null) {
+        return [];
+    }
+    return [
+        `${label}: ${cellValue(record.name ?? record.id)}`,
+        `  ID: ${cellValue(record.id)}`,
+        `  Status: ${cellValue(record.status)}`,
+        `  Link: ${cellValue(record.link)}`,
+    ];
+}
+export function formatPromotionRunResult(result) {
+    const lines = [
+        `Promotion ID: ${result.promotionId}`,
+        `Mode: ${result.mode}`,
+        `Operation: ${cellValue(result.operation)}`,
+        `Started Job Phase: ${cellValue(result.run.startedJobPhase)}`,
+        `Result ID: ${result.resultId}`,
+        ...formatRunRecord('Promotion', result.run.promotion),
+        ...formatRunRecord('Job Execution', result.run.jobExecution),
+    ];
+    for (const monitor of result.jobMonitors) {
+        lines.push(`Execution ${cellValue(monitor.jobExecutionId)}: ${cellValue(monitor.jobExecutionStatus)}`, ...(monitor.jobExecutionErrorMessage ? [`  Error: ${monitor.jobExecutionErrorMessage}`] : []));
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=promotion-run.js.map

package/dist/lib/promotion-run.js.map

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

package/dist/lib/salesforce-id.d.ts

@@ -1 +1,10 @@
+/**
+ * Normalize Salesforce Ids to the 15-character form for comparisons and remote
+ * path segments where case-insensitive matching is desirable.
+ */
 export declare function normalizeSalesforceId(value: string): string;
+/**
+ * Convert valid Salesforce Ids to the case-safe 18-character form required by
+ * local gateway headers.
+ */
+export declare function preferSalesforceId(value: string): string;