@copado/agentia-cli 0.54.0-alpha.0 → 0.57.0-alpha.0

package/dist/commands/cicd/promotion/run.d.ts

@@ -0,0 +1,23 @@
+import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { type PromotionRunResult } from '../../../lib/promotion-run.js';
+export default class PromotionRun extends AgentiaCommand {
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'deployment-step-id': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'ignored-metadata-json': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        operation: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'recreate-promotion-branch': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        resume: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        wait: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'wait-timeout': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<PromotionRunResult>;
+    protected toErrorJson(err: unknown): unknown;
+    private execute;
+    private hooks;
+}

package/dist/commands/cicd/promotion/run.js

@@ -0,0 +1,137 @@
+import { confirm } from '@inquirer/prompts';
+import { Args, Flags } from '@oclif/core';
+import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { formatPromotionRunResult, isPromotionRunExecutionError, parseIgnoredMetadataJson, performPromotionResume, performPromotionRun, PROMOTION_OPERATIONS, PROMOTION_RUN_DEFAULT_TIMEOUT_SECONDS, promotionRunErrorJson, PromotionRunValidationError, } from '../../../lib/promotion-run.js';
+export default class PromotionRun extends AgentiaCommand {
+    static args = {
+        id: Args.string({
+            description: '18-character Salesforce Promotion ID',
+            required: true,
+        }),
+    };
+    static description = [
+        'Preflight, start, and optionally wait for a Copado promotion execution.',
+        'Use --resume to continue an existing failed or conflict-resolved execution without starting a duplicate promotion.',
+    ].join(' ');
+    static examples = [
+        '<%= config.bin %> <%= command.id %> a0BXXXXXXXXXXXXXXX --operation merge',
+        '<%= config.bin %> <%= command.id %> a0BXXXXXXXXXXXXXXX --operation merge_and_deploy --json',
+        '<%= config.bin %> <%= command.id %> a0BXXXXXXXXXXXXXXX --resume a4NXXXXXXXXXXXXXXX',
+    ];
+    static flags = {
+        'deployment-step-id': Flags.string({
+            description: 'Ordered deployment-step Salesforce ID. Can be provided multiple times.',
+            multiple: true,
+        }),
+        'ignored-metadata-json': Flags.string({
+            description: 'JSON array to persist through ignored-metadata before starting the promotion.',
+        }),
+        operation: Flags.string({
+            description: 'Promotion operation. Required unless --resume is used.',
+            options: [...PROMOTION_OPERATIONS],
+        }),
+        'recreate-promotion-branch': Flags.boolean({
+            description: 'Recreate the promotion branch before execution. Requires confirmation or --yes.',
+        }),
+        resume: Flags.string({
+            description: 'Resume this existing JobExecution ID instead of calling the promotion run endpoint.',
+        }),
+        wait: Flags.boolean({
+            allowNo: true,
+            default: true,
+            description: 'Poll promotion and deployment executions to terminal status.',
+        }),
+        'wait-timeout': Flags.integer({
+            default: PROMOTION_RUN_DEFAULT_TIMEOUT_SECONDS,
+            description: 'Maximum total seconds to wait for promotion and deployment executions.',
+        }),
+        yes: Flags.boolean({
+            char: 'y',
+            default: false,
+            description: 'Confirm promotion branch recreation without prompting.',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(PromotionRun);
+        const runFlags = flags;
+        if (!Number.isInteger(runFlags['wait-timeout']) || runFlags['wait-timeout'] <= 0) {
+            this.error('--wait-timeout must be a positive integer.', { exit: 2 });
+        }
+        if (runFlags.resume !== undefined && runFlags.operation !== undefined) {
+            this.error('Use --resume or --operation, not both.', { exit: 2 });
+        }
+        if (runFlags.resume === undefined && runFlags.operation === undefined) {
+            this.error('--operation is required unless --resume is used.', { exit: 2 });
+        }
+        if (runFlags.resume !== undefined) {
+            if (runFlags['deployment-step-id'] !== undefined ||
+                runFlags['ignored-metadata-json'] !== undefined ||
+                runFlags['recreate-promotion-branch'] === true) {
+                this.error('--resume cannot be combined with run request flags.', { exit: 2 });
+            }
+            return this.execute(() => performPromotionResume({
+                hooks: this.hooks(),
+                jobExecutionId: runFlags.resume,
+                promotionId: args.id,
+                timeoutSeconds: runFlags['wait-timeout'],
+                wait: runFlags.wait,
+            }));
+        }
+        if (runFlags['recreate-promotion-branch'] === true && !runFlags.yes) {
+            if (this.jsonEnabled() || !process.stdin.isTTY) {
+                this.error('Promotion branch recreation requires confirmation. Pass --yes for headless or JSON execution.', {
+                    exit: 2,
+                });
+            }
+            const confirmed = await confirm({
+                default: false,
+                message: `Recreate the promotion branch for ${args.id}? Existing promotion branch changes may be replaced.`,
+            });
+            if (!confirmed) {
+                this.error('Promotion canceled.', { exit: 1 });
+            }
+        }
+        return this.execute(() => performPromotionRun({
+            deploymentStepIds: runFlags['deployment-step-id'],
+            hooks: this.hooks(),
+            ignoredMetadata: parseIgnoredMetadataJson(runFlags['ignored-metadata-json']),
+            operation: runFlags.operation,
+            promotionId: args.id,
+            recreatePromotionBranch: runFlags['recreate-promotion-branch'],
+            timeoutSeconds: runFlags['wait-timeout'],
+            wait: runFlags.wait,
+        }));
+    }
+    toErrorJson(err) {
+        const base = super.toErrorJson(err);
+        return promotionRunErrorJson(base, err);
+    }
+    async execute(action) {
+        try {
+            const result = await action();
+            this.display(() => this.log(formatPromotionRunResult(result)));
+            return result;
+        }
+        catch (error) {
+            if (error instanceof PromotionRunValidationError) {
+                this.error(error.message, { exit: 2 });
+            }
+            if (isPromotionRunExecutionError(error)) {
+                this.display(() => {
+                    if (error.result !== undefined) {
+                        this.log(formatPromotionRunResult(error.result));
+                    }
+                });
+                error.oclif = { exit: 1 };
+            }
+            throw error;
+        }
+    }
+    hooks() {
+        return {
+            log: (message) => this.display(() => this.log(message)),
+            withSpinner: (message, action) => this.withSpinner(message, action),
+        };
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/cicd/promotion/run.js.map

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

package/dist/commands/cicd/work/commit.d.ts

@@ -0,0 +1,31 @@
+import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { type WorkCommitResult } from '../../../lib/work-commit.js';
+export default class WorkCommit extends AgentiaCommand {
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        action: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'base-branch': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        cloud: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'commit-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'execute-commit': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        message: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'metadata-category': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'metadata-message': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'metadata-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'metadata-raw-json': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'metadata-type': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'platform-experience': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'recreate-feature-branch': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        selection: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        stdin: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        wait: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'wait-timeout': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<WorkCommitResult>;
+    protected toErrorJson(err: unknown): unknown;
+}

package/dist/commands/cicd/work/commit.js

@@ -0,0 +1,254 @@
+import { Args, Flags } from '@oclif/core';
+import { readFileSync } from 'node:fs';
+import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { resolveWorkItemId, WorkActiveResolutionError } from '../../../lib/work-active.js';
+import { buildWorkCommitRequest, formatWorkCommitResult, normalizeWorkCommitInput, performWorkCommit, WORK_COMMIT_ACTIONS, WORK_COMMIT_DEFAULT_TIMEOUT_SECONDS, WORK_COMMIT_PLATFORM_EXPERIENCES, WorkCommitJobFailedError, WorkCommitTimeoutError, WorkCommitValidationError, } from '../../../lib/work-commit.js';
+function readStdin() {
+    if (process.stdin.isTTY) {
+        throw new WorkCommitValidationError('Cannot read --stdin from an interactive terminal. Pipe JSON input or use --file <path>.');
+    }
+    return new Promise((resolve, reject) => {
+        let data = '';
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('data', (chunk) => {
+            data += chunk;
+        });
+        process.stdin.on('end', () => resolve(data));
+        process.stdin.on('error', reject);
+    });
+}
+function readJsonFile(path) {
+    try {
+        return readFileSync(path, 'utf8');
+    }
+    catch (error) {
+        throw new WorkCommitValidationError(`Cannot read JSON request file ${path}: ${error.message}`);
+    }
+}
+function parseJsonValue(raw, label) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        throw new WorkCommitValidationError(`${label} must contain valid JSON: ${error.message}`);
+    }
+}
+function hasSimpleChangeFlags(flags) {
+    return (flags.action !== undefined ||
+        flags['metadata-category'] !== undefined ||
+        flags['metadata-message'] !== undefined ||
+        flags['metadata-name'] !== undefined ||
+        flags['metadata-raw-json'] !== undefined ||
+        flags['metadata-type'] !== undefined ||
+        flags.selection !== undefined);
+}
+function simpleInputFromFlags(flags) {
+    const rawJson = flags['metadata-raw-json'] === undefined
+        ? undefined
+        : parseJsonValue(flags['metadata-raw-json'], '--metadata-raw-json');
+    return {
+        baseBranch: flags['base-branch'] ?? null,
+        changes: [
+            {
+                ...(flags.action === undefined ? {} : { a: flags.action }),
+                ...(flags['metadata-category'] === undefined ? {} : { c: flags['metadata-category'] }),
+                ...(rawJson === undefined ? {} : { j: rawJson }),
+                ...(flags['metadata-message'] === undefined ? {} : { m: flags['metadata-message'] }),
+                n: flags['metadata-name'],
+                ...(flags.selection === undefined ? {} : { selections: flags.selection }),
+                t: flags['metadata-type'],
+            },
+        ],
+        commitId: flags['commit-id'],
+        executeCommit: flags['execute-commit'],
+        message: flags.message,
+        recreateFeatureBranch: flags['recreate-feature-branch'],
+    };
+}
+async function jsonInputFromFlags(flags) {
+    const raw = flags.file === undefined ? await readStdin() : readJsonFile(flags.file);
+    const input = normalizeWorkCommitInput(parseJsonValue(raw, flags.file === undefined ? 'stdin' : flags.file));
+    return {
+        ...input,
+        ...(flags['base-branch'] === undefined ? {} : { baseBranch: flags['base-branch'] }),
+        ...(flags['commit-id'] === undefined ? {} : { commitId: flags['commit-id'] }),
+        ...(flags['execute-commit'] ? {} : { executeCommit: false }),
+        ...(flags.message === undefined ? {} : { message: flags.message }),
+        ...(flags['recreate-feature-branch'] ? { recreateFeatureBranch: true } : {}),
+    };
+}
+async function commitInputFromFlags(flags) {
+    const jsonModes = [flags.file !== undefined, flags.stdin].filter(Boolean).length;
+    const simpleMode = hasSimpleChangeFlags(flags);
+    if (jsonModes > 1) {
+        throw new WorkCommitValidationError('Use only one JSON input mode: --file or --stdin.');
+    }
+    if (jsonModes > 0 && simpleMode) {
+        throw new WorkCommitValidationError('Use JSON input or simple metadata flags, not both.');
+    }
+    if (jsonModes > 0) {
+        return jsonInputFromFlags(flags);
+    }
+    if (!simpleMode) {
+        throw new WorkCommitValidationError('Requires simple metadata flags such as --metadata-name and --metadata-type, or JSON input with --file/--stdin.');
+    }
+    return simpleInputFromFlags(flags);
+}
+export default class WorkCommit extends AgentiaCommand {
+    static args = {
+        id: Args.string({
+            description: 'User story ID (defaults to the active work item from `work set`)',
+            required: false,
+        }),
+    };
+    static description = [
+        'Create and optionally wait for a Copado cloud commit job for a user story.',
+        'Preflights the story, submits POST /release/commit, and polls the job monitor by default.',
+    ].join(' ');
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --cloud --message "Commit AccountService" --metadata-name AccountService --metadata-type ApexClass --action Add',
+        '<%= config.bin %> <%= command.id %> a07XXXXXXXXXXXXXXX --cloud --message "Update Aura files" --metadata-name accountEditor --metadata-type AuraDefinitionBundle --action SelectiveCommit --selection accountEditor/accountEditor.cmp --selection accountEditor/accountEditorController.js',
+        'cat commit-request.json | <%= config.bin %> <%= command.id %> --cloud --stdin --json',
+    ];
+    static flags = {
+        action: Flags.string({
+            description: 'Metadata action for simple flag input. Defaults to Add.',
+            options: [...WORK_COMMIT_ACTIONS],
+        }),
+        'base-branch': Flags.string({
+            description: 'Optional base branch to include in the commit request.',
+        }),
+        cloud: Flags.boolean({
+            default: false,
+            description: 'Use the Copado cloud commit API. Required for this command.',
+        }),
+        'commit-id': Flags.string({
+            description: 'Existing local Git commit identifier to register when --no-execute-commit is used.',
+        }),
+        'execute-commit': Flags.boolean({
+            allowNo: true,
+            default: true,
+            description: 'Execute the Copado commit job. Use --no-execute-commit only with --commit-id.',
+        }),
+        file: Flags.string({
+            char: 'f',
+            description: 'Path to a JSON commit request body.',
+        }),
+        message: Flags.string({
+            char: 'm',
+            description: 'Commit message. Required unless provided by JSON input.',
+        }),
+        'metadata-category': Flags.string({
+            description: 'Optional metadata category for simple flag input, usually SFDX.',
+        }),
+        'metadata-message': Flags.string({
+            description: 'Optional per-change message for simple flag input.',
+        }),
+        'metadata-name': Flags.string({
+            description: 'Metadata full name for simple flag input.',
+        }),
+        'metadata-raw-json': Flags.string({
+            description: 'Optional raw metadata JSON value for simple flag input.',
+        }),
+        'metadata-type': Flags.string({
+            description: 'Metadata type for simple flag input, for example ApexClass.',
+        }),
+        'platform-experience': Flags.string({
+            default: 'sfdx',
+            description: 'Initial platform-experience header for preflight. The preflight response wins for commit.',
+            options: [...WORK_COMMIT_PLATFORM_EXPERIENCES],
+        }),
+        'recreate-feature-branch': Flags.boolean({
+            default: false,
+            description: 'Ask Copado to recreate the feature branch before committing.',
+        }),
+        selection: Flags.string({
+            description: 'Selected file inside a bundle for SelectiveCommit. Can be provided multiple times.',
+            multiple: true,
+        }),
+        stdin: Flags.boolean({
+            default: false,
+            description: 'Read a JSON commit request body from stdin.',
+        }),
+        wait: Flags.boolean({
+            allowNo: true,
+            default: true,
+            description: 'Poll the commit job to a terminal status when a jobExecution Id is returned.',
+        }),
+        'wait-timeout': Flags.integer({
+            default: WORK_COMMIT_DEFAULT_TIMEOUT_SECONDS,
+            description: 'Maximum seconds to wait for the commit job.',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(WorkCommit);
+        const commitFlags = flags;
+        if (!commitFlags.cloud) {
+            this.error('Only cloud commit is supported for now. Pass --cloud to use POST /release/commit.', { exit: 2 });
+        }
+        if (!Number.isInteger(commitFlags['wait-timeout']) || commitFlags['wait-timeout'] <= 0) {
+            this.error('--wait-timeout must be a positive integer.', { exit: 2 });
+        }
+        let workItemId;
+        try {
+            workItemId = await resolveWorkItemId(args.id);
+        }
+        catch (error) {
+            if (error instanceof WorkActiveResolutionError) {
+                this.error(error.message, {
+                    exit: 1,
+                    suggestions: [`${this.config.bin} cicd work set <id>`],
+                });
+            }
+            throw error;
+        }
+        try {
+            const input = await commitInputFromFlags(commitFlags);
+            const request = buildWorkCommitRequest(input, { message: commitFlags.message, userStoryId: workItemId });
+            const result = await performWorkCommit({
+                hooks: {
+                    log: (message) => this.display(() => this.log(message)),
+                    withSpinner: (message, action) => this.withSpinner(message, action),
+                },
+                initialPlatformExperience: commitFlags['platform-experience'],
+                request,
+                timeoutSeconds: commitFlags['wait-timeout'],
+                wait: commitFlags.wait,
+            });
+            this.display(() => {
+                this.log(formatWorkCommitResult(result));
+            });
+            return result;
+        }
+        catch (error) {
+            if (error instanceof WorkCommitValidationError) {
+                this.error(error.message, { exit: 2 });
+            }
+            if (error instanceof WorkCommitJobFailedError || error instanceof WorkCommitTimeoutError) {
+                this.display(() => {
+                    if (error.result !== undefined) {
+                        this.log(formatWorkCommitResult(error.result));
+                    }
+                });
+                error.oclif = { exit: 1 };
+                throw error;
+            }
+            throw error;
+        }
+    }
+    toErrorJson(err) {
+        const base = super.toErrorJson(err);
+        if (err instanceof WorkCommitJobFailedError || err instanceof WorkCommitTimeoutError) {
+            return {
+                ...base,
+                error: {
+                    ...(base.error && typeof base.error === 'object' ? base.error : {}),
+                    ...(err.jobMonitor === undefined ? {} : { jobMonitor: err.jobMonitor }),
+                    ...(err.result === undefined ? {} : { result: err.result }),
+                },
+            };
+        }
+        return base;
+    }
+}
+//# sourceMappingURL=commit.js.map

package/dist/commands/cicd/work/commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit.js","sourceRoot":"","sources":["../../../../src/commands/cicd/work/commit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAE,KAAK,EAAC,MAAM,aAAa,CAAA;AACvC,OAAO,EAAC,YAAY,EAAC,MAAM,SAAS,CAAA;AAEpC,OAAO,EAAC,cAAc,EAAC,MAAM,iCAAiC,CAAA;AAC9D,OAAO,EAAC,iBAAiB,EAAE,yBAAyB,EAAC,MAAM,6BAA6B,CAAA;AACxF,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,EACnB,mCAAmC,EACnC,gCAAgC,EAGhC,wBAAwB,EAGxB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,6BAA6B,CAAA;AAuBpC,SAAS,SAAS;IAChB,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACxB,MAAM,IAAI,yBAAyB,CAAC,yFAAyF,CAAC,CAAA;IAChI,CAAC;IAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,IAAI,GAAG,EAAE,CAAA;QACb,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;QACjC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,IAAI,IAAI,KAAK,CAAA;QACf,CAAC,CAAC,CAAA;QACF,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;QAC5C,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IACnC,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,yBAAyB,CAAC,iCAAiC,IAAI,KAAM,KAAe,CAAC,OAAO,EAAE,CAAC,CAAA;IAC3G,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,GAAW,EAAE,KAAa;IAChD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAA;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,yBAAyB,CAAC,GAAG,KAAK,6BAA8B,KAAe,CAAC,OAAO,EAAE,CAAC,CAAA;IACtG,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAsB;IAClD,OAAO,CACL,KAAK,CAAC,MAAM,KAAK,SAAS;QAC1B,KAAK,CAAC,mBAAmB,CAAC,KAAK,SAAS;QACxC,KAAK,CAAC,kBAAkB,CAAC,KAAK,SAAS;QACvC,KAAK,CAAC,eAAe,CAAC,KAAK,SAAS;QACpC,KAAK,CAAC,mBAAmB,CAAC,KAAK,SAAS;QACxC,KAAK,CAAC,eAAe,CAAC,KAAK,SAAS;QACpC,KAAK,CAAC,SAAS,KAAK,SAAS,CAC9B,CAAA;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAsB;IAClD,MAAM,OAAO,GACX,KAAK,CAAC,mBAAmB,CAAC,KAAK,SAAS;QACtC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,mBAAmB,CAAC,EAAE,qBAAqB,CAAC,CAAA;IAEvE,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,aAAa,CAAC,IAAI,IAAI;QACxC,OAAO,EAAE;YACP;gBACE,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,CAAC,EAAE,KAAK,CAAC,MAAM,EAAC,CAAC;gBACxD,GAAG,CAAC,KAAK,CAAC,mBAAmB,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,CAAC,EAAE,KAAK,CAAC,mBAAmB,CAAC,EAAC,CAAC;gBACpF,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,CAAC,EAAE,OAAO,EAAC,CAAC;gBAC9C,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,CAAC,EAAE,KAAK,CAAC,kBAAkB,CAAC,EAAC,CAAC;gBAClF,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC;gBACzB,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,UAAU,EAAE,KAAK,CAAC,SAAS,EAAC,CAAC;gBACvE,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC;aAC1B;SACF;QACD,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC;QAC5B,aAAa,EAAE,KAAK,CAAC,gBAAgB,CAAC;QACtC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,qBAAqB,EAAE,KAAK,CAAC,yBAAyB,CAAC;KACxD,CAAA;AACH,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,KAAsB;IACtD,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,SAAS,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACnF,MAAM,KAAK,GAAG,wBAAwB,CAAC,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;IAE5G,OAAO;QACL,GAAG,KAAK;QACR,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,UAAU,EAAE,KAAK,CAAC,aAAa,CAAC,EAAC,CAAC;QACjF,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,EAAC,CAAC;QAC3E,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,aAAa,EAAE,KAAK,EAAC,CAAC;QAC1D,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAC,CAAC;QAChE,GAAG,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,EAAC,qBAAqB,EAAE,IAAI,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3E,CAAA;AACH,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,KAAsB;IACxD,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAA;IAChF,MAAM,UAAU,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAA;IAE9C,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,MAAM,IAAI,yBAAyB,CAAC,kDAAkD,CAAC,CAAA;IACzF,CAAC;IAED,IAAI,SAAS,GAAG,CAAC,IAAI,UAAU,EAAE,CAAC;QAChC,MAAM,IAAI,yBAAyB,CAAC,oDAAoD,CAAC,CAAA;IAC3F,CAAC;IAED,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAA;IAClC,CAAC;IAED,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,yBAAyB,CACjC,gHAAgH,CACjH,CAAA;IACH,CAAC;IAED,OAAO,oBAAoB,CAAC,KAAK,CAAC,CAAA;AACpC,CAAC;AAED,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,cAAc;IACpD,MAAM,CAAU,IAAI,GAAG;QACrB,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC;YACd,WAAW,EAAE,kEAAkE;YAC/E,QAAQ,EAAE,KAAK;SAChB,CAAC;KACH,CAAA;IACD,MAAM,CAAU,WAAW,GAAG;QAC5B,4EAA4E;QAC5E,2FAA2F;KAC5F,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACX,MAAM,CAAU,QAAQ,GAAG;QACzB,qJAAqJ;QACrJ,2RAA2R;QAC3R,sFAAsF;KACvF,CAAA;IACD,MAAM,CAAU,KAAK,GAAG;QACtB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;YACnB,WAAW,EAAE,yDAAyD;YACtE,OAAO,EAAE,CAAC,GAAG,mBAAmB,CAAC;SAClC,CAAC;QACF,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC;YAC1B,WAAW,EAAE,wDAAwD;SACtE,CAAC;QACF,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;YACnB,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,6DAA6D;SAC3E,CAAC;QACF,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC;YACxB,WAAW,EAAE,oFAAoF;SAClG,CAAC;QACF,gBAAgB,EAAE,KAAK,CAAC,OAAO,CAAC;YAC9B,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,+EAA+E;SAC7F,CAAC;QACF,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;YACjB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,qCAAqC;SACnD,CAAC;QACF,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC;YACpB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,yDAAyD;SACvE,CAAC;QACF,mBAAmB,EAAE,KAAK,CAAC,MAAM,CAAC;YAChC,WAAW,EAAE,iEAAiE;SAC/E,CAAC;QACF,kBAAkB,EAAE,KAAK,CAAC,MAAM,CAAC;YAC/B,WAAW,EAAE,oDAAoD;SAClE,CAAC;QACF,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC;YAC5B,WAAW,EAAE,2CAA2C;SACzD,CAAC;QACF,mBAAmB,EAAE,KAAK,CAAC,MAAM,CAAC;YAChC,WAAW,EAAE,yDAAyD;SACvE,CAAC;QACF,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC;YAC5B,WAAW,EAAE,6DAA6D;SAC3E,CAAC;QACF,qBAAqB,EAAE,KAAK,CAAC,MAAM,CAAC;YAClC,OAAO,EAAE,MAAM;YACf,WAAW,EAAE,2FAA2F;YACxG,OAAO,EAAE,CAAC,GAAG,gCAAgC,CAAC;SAC/C,CAAC;QACF,yBAAyB,EAAE,KAAK,CAAC,OAAO,CAAC;YACvC,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,8DAA8D;SAC5E,CAAC;QACF,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC;YACtB,WAAW,EAAE,oFAAoF;YACjG,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;YACnB,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,6CAA6C;SAC3D,CAAC;QACF,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC;YAClB,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,8EAA8E;SAC5F,CAAC;QACF,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC;YAC5B,OAAO,EAAE,mCAAmC;YAC5C,WAAW,EAAE,6CAA6C;SAC3D,CAAC;KACH,CAAA;IAEM,KAAK,CAAC,GAAG;QACd,MAAM,EAAC,IAAI,EAAE,KAAK,EAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;QAClD,MAAM,WAAW,GAAG,KAAwB,CAAA;QAE5C,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,mFAAmF,EAAE,EAAC,IAAI,EAAE,CAAC,EAAC,CAAC,CAAA;QAC5G,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,IAAI,WAAW,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;YACvF,IAAI,CAAC,KAAK,CAAC,4CAA4C,EAAE,EAAC,IAAI,EAAE,CAAC,EAAC,CAAC,CAAA;QACrE,CAAC;QAED,IAAI,UAAkB,CAAA;QACtB,IAAI,CAAC;YACH,UAAU,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAC/C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,yBAAyB,EAAE,CAAC;gBAC/C,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE;oBACxB,IAAI,EAAE,CAAC;oBACP,WAAW,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,qBAAqB,CAAC;iBACvD,CAAC,CAAA;YACJ,CAAC;YAED,MAAM,KAAK,CAAA;QACb,CAAC;QAED,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,WAAW,CAAC,CAAA;YACrD,MAAM,OAAO,GAAG,sBAAsB,CAAC,KAAK,EAAE,EAAC,OAAO,EAAE,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAC,CAAC,CAAA;YACtG,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC;gBACrC,KAAK,EAAE;oBACL,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;oBACvD,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC;iBACpE;gBACD,yBAAyB,EAAE,WAAW,CAAC,qBAAqB,CAAC;gBAC7D,OAAO;gBACP,cAAc,EAAE,WAAW,CAAC,cAAc,CAAC;gBAC3C,IAAI,EAAE,WAAW,CAAC,IAAI;aACvB,CAAC,CAAA;YAEF,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;gBAChB,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAA;YAC1C,CAAC,CAAC,CAAA;YAEF,OAAO,MAAM,CAAA;QACf,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,yBAAyB,EAAE,CAAC;gBAC/C,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,EAAC,IAAI,EAAE,CAAC,EAAC,CAAC,CAAA;YACtC,CAAC;YAED,IAAI,KAAK,YAAY,wBAAwB,IAAI,KAAK,YAAY,sBAAsB,EAAE,CAAC;gBACzF,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;oBAChB,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;wBAC/B,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;oBAChD,CAAC;gBACH,CAAC,CAAC,CACD;gBAAC,KAA0C,CAAC,KAAK,GAAG,EAAC,IAAI,EAAE,CAAC,EAAC,CAAA;gBAC9D,MAAM,KAAK,CAAA;YACb,CAAC;YAED,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAEkB,WAAW,CAAC,GAAY;QACzC,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAA4B,CAAA;QAC9D,IAAI,GAAG,YAAY,wBAAwB,IAAI,GAAG,YAAY,sBAAsB,EAAE,CAAC;YACrF,OAAO;gBACL,GAAG,IAAI;gBACP,KAAK,EAAE;oBACL,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAI,CAAC,KAAiC,CAAC,CAAC,CAAC,EAAE,CAAC;oBAChG,GAAG,CAAC,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,UAAU,EAAE,GAAG,CAAC,UAAU,EAAC,CAAC;oBACrE,GAAG,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAC,CAAC;iBAC1D;aACF,CAAA;QACH,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC"}

package/dist/commands/cicd/work/promote.d.ts

@@ -0,0 +1,25 @@
+import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { type PromotionRunResult } from '../../../lib/promotion-run.js';
+export type WorkPromoteResult = PromotionRunResult & {
+    workItemId: string;
+};
+export default class WorkPromote extends AgentiaCommand {
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        cloud: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        deploy: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'deployment-step-id': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'ignored-metadata-json': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'promotion-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'recreate-promotion-branch': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        wait: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'wait-timeout': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<WorkPromoteResult>;
+    protected toErrorJson(err: unknown): unknown;
+}

package/dist/commands/cicd/work/promote.js

@@ -0,0 +1,141 @@
+import { confirm } from '@inquirer/prompts';
+import { Args, Flags } from '@oclif/core';
+import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { formatPromotionRunResult, isPromotionRunExecutionError, parseIgnoredMetadataJson, performPromotionRun, PROMOTION_RUN_DEFAULT_TIMEOUT_SECONDS, promotionRunErrorJson, PromotionRunValidationError, resolvePromotionIdForWorkItem, } from '../../../lib/promotion-run.js';
+import { resolveWorkItemId, WorkActiveResolutionError } from '../../../lib/work-active.js';
+export default class WorkPromote extends AgentiaCommand {
+    static args = {
+        id: Args.string({
+            description: 'User Story ID (defaults to the active work item from `work set`)',
+            required: false,
+        }),
+    };
+    static description = [
+        'Promote the explicit or active User Story through its Copado Promotion.',
+        'Requires --cloud and selects promote-only unless --deploy is passed.',
+    ].join(' ');
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --cloud',
+        '<%= config.bin %> <%= command.id %> a07XXXXXXXXXXXXXXX --cloud --promotion-id a0BXXXXXXXXXXXXXXX',
+        '<%= config.bin %> <%= command.id %> --cloud --deploy --json',
+    ];
+    static flags = {
+        cloud: Flags.boolean({
+            default: false,
+            description: 'Use the Copado cloud promotion API. Required for this command.',
+        }),
+        deploy: Flags.boolean({
+            default: false,
+            description: 'Use merge_and_deploy instead of promote-only merge.',
+        }),
+        'deployment-step-id': Flags.string({
+            description: 'Ordered deployment-step Salesforce ID. Can be provided multiple times with --deploy.',
+            multiple: true,
+        }),
+        'ignored-metadata-json': Flags.string({
+            description: 'JSON array to persist through ignored-metadata before starting the promotion.',
+        }),
+        'promotion-id': Flags.string({
+            description: 'Explicit 18-character Promotion ID when the User Story belongs to multiple promotions.',
+        }),
+        'recreate-promotion-branch': Flags.boolean({
+            description: 'Recreate the promotion branch before execution. Requires confirmation or --yes.',
+        }),
+        wait: Flags.boolean({
+            allowNo: true,
+            default: true,
+            description: 'Poll promotion and deployment executions to terminal status.',
+        }),
+        'wait-timeout': Flags.integer({
+            default: PROMOTION_RUN_DEFAULT_TIMEOUT_SECONDS,
+            description: 'Maximum total seconds to wait for promotion and deployment executions.',
+        }),
+        yes: Flags.boolean({
+            char: 'y',
+            default: false,
+            description: 'Confirm promotion branch recreation without prompting.',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(WorkPromote);
+        const promoteFlags = flags;
+        if (!promoteFlags.cloud) {
+            this.error('Only cloud promotion is supported for this command. Pass --cloud.', { exit: 2 });
+        }
+        if (!Number.isInteger(promoteFlags['wait-timeout']) || promoteFlags['wait-timeout'] <= 0) {
+            this.error('--wait-timeout must be a positive integer.', { exit: 2 });
+        }
+        if (!promoteFlags.deploy && promoteFlags['deployment-step-id'] !== undefined) {
+            this.error('--deployment-step-id requires --deploy.', { exit: 2 });
+        }
+        let workItemId;
+        try {
+            workItemId = await resolveWorkItemId(args.id);
+        }
+        catch (error) {
+            if (error instanceof WorkActiveResolutionError) {
+                this.error(error.message, {
+                    exit: 1,
+                    suggestions: [`${this.config.bin} cicd work set <id>`],
+                });
+            }
+            throw error;
+        }
+        try {
+            const promotionId = await this.withSpinner('Resolving User Story promotion', () => resolvePromotionIdForWorkItem(workItemId, promoteFlags['promotion-id']));
+            if (promoteFlags['recreate-promotion-branch'] === true && !promoteFlags.yes) {
+                if (this.jsonEnabled() || !process.stdin.isTTY) {
+                    this.error('Promotion branch recreation requires confirmation. Pass --yes for headless or JSON execution.', {
+                        exit: 2,
+                    });
+                }
+                const confirmed = await confirm({
+                    default: false,
+                    message: `Recreate the promotion branch for ${promotionId}? Existing promotion branch changes may be replaced.`,
+                });
+                if (!confirmed) {
+                    this.error('Promotion canceled.', { exit: 1 });
+                }
+            }
+            const result = await performPromotionRun({
+                deploymentStepIds: promoteFlags['deployment-step-id'],
+                hooks: {
+                    log: (message) => this.display(() => this.log(message)),
+                    withSpinner: (message, action) => this.withSpinner(message, action),
+                },
+                ignoredMetadata: parseIgnoredMetadataJson(promoteFlags['ignored-metadata-json']),
+                operation: promoteFlags.deploy ? 'merge_and_deploy' : 'merge',
+                promotionId,
+                recreatePromotionBranch: promoteFlags['recreate-promotion-branch'],
+                timeoutSeconds: promoteFlags['wait-timeout'],
+                wait: promoteFlags.wait,
+            });
+            const workResult = { ...result, workItemId };
+            this.display(() => {
+                this.log(`User Story: ${workItemId}`);
+                this.log(formatPromotionRunResult(result));
+            });
+            return workResult;
+        }
+        catch (error) {
+            if (error instanceof PromotionRunValidationError) {
+                this.error(error.message, { exit: 2 });
+            }
+            if (isPromotionRunExecutionError(error)) {
+                this.display(() => {
+                    if (error.result !== undefined) {
+                        this.log(`User Story: ${workItemId}`);
+                        this.log(formatPromotionRunResult(error.result));
+                    }
+                });
+                error.oclif = { exit: 1 };
+            }
+            throw error;
+        }
+    }
+    toErrorJson(err) {
+        const base = super.toErrorJson(err);
+        return promotionRunErrorJson(base, err);
+    }
+}
+//# sourceMappingURL=promote.js.map