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

package/dist/commands/cicd/function/result/log/get.js

@@ -0,0 +1,41 @@
+import { Args, Flags } from '@oclif/core';
+import { AgentiaCommand } from '../../../../../lib/agentia-command.js';
+import { CicdGateway } from '../../../../../lib/cicd-gateway.js';
+import { functionResultLogEndpoint } from '../../../../../lib/function-types.js';
+export default class FunctionResultLogGet extends AgentiaCommand {
+    static args = {
+        'result-id': Args.string({
+            description: 'Function result Id',
+            required: true,
+        }),
+    };
+    static description = 'Get log output for a Copado Function result';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> <result-id>',
+        '<%= config.bin %> <%= command.id %> <result-id> --type stdout',
+        '<%= config.bin %> <%= command.id %> <result-id> --json',
+    ];
+    static flags = {
+        type: Flags.string({
+            description: 'Optional log file type filter',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(FunctionResultLogGet);
+        const log = await this.withSpinner('Fetching function result log', () => CicdGateway.call({
+            endpoint: functionResultLogEndpoint(args['result-id'], flags.type),
+            method: 'GET',
+            responseType: 'text',
+        }));
+        const result = {
+            log,
+            resultId: args['result-id'],
+            ...(flags.type === undefined ? {} : { type: flags.type }),
+        };
+        this.display(() => {
+            process.stdout.write(log);
+        });
+        return result;
+    }
+}
+//# sourceMappingURL=get.js.map

package/dist/commands/cicd/function/result/log/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../../../../src/commands/cicd/function/result/log/get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAE,KAAK,EAAC,MAAM,aAAa,CAAA;AAEvC,OAAO,EAAC,cAAc,EAAC,MAAM,uCAAuC,CAAA;AACpE,OAAO,EAAC,WAAW,EAAC,MAAM,oCAAoC,CAAA;AAC9D,OAAO,EAAC,yBAAyB,EAAC,MAAM,sCAAsC,CAAA;AAQ9E,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,cAAc;IAC9D,MAAM,CAAU,IAAI,GAAG;QACrB,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC;YACvB,WAAW,EAAE,oBAAoB;YACjC,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAA;IACD,MAAM,CAAU,WAAW,GAAG,6CAA6C,CAAA;IAC3E,MAAM,CAAU,QAAQ,GAAG;QACzB,iDAAiD;QACjD,+DAA+D;QAC/D,wDAAwD;KACzD,CAAA;IACD,MAAM,CAAU,KAAK,GAAG;QACtB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;YACjB,WAAW,EAAE,+BAA+B;SAC7C,CAAC;KACH,CAAA;IAEM,KAAK,CAAC,GAAG;QACd,MAAM,EAAC,IAAI,EAAE,KAAK,EAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAA;QAC5D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,8BAA8B,EAAE,GAAG,EAAE,CACtE,WAAW,CAAC,IAAI,CAAS;YACvB,QAAQ,EAAE,yBAAyB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC;YAClE,MAAM,EAAE,KAAK;YACb,YAAY,EAAE,MAAM;SACrB,CAAC,CACH,CAAA;QAED,MAAM,MAAM,GAA4B;YACtC,GAAG;YACH,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC;YAC3B,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAC,CAAC;SACxD,CAAA;QAED,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;YAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC3B,CAAC,CAAC,CAAA;QAEF,OAAO,MAAM,CAAA;IACf,CAAC"}

package/dist/commands/cicd/function/run-local.d.ts

@@ -0,0 +1,17 @@
+import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { type LocalFunctionRunResult } from '../../../lib/function-local-run.js';
+export default class FunctionRunLocal extends AgentiaCommand {
+    static args: {
+        script: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        cwd: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        image: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        parameter: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        platform: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        runtime: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<LocalFunctionRunResult>;
+}

package/dist/commands/cicd/function/run-local.js

@@ -0,0 +1,64 @@
+import { Args, Flags } from '@oclif/core';
+import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { DEFAULT_FUNCTION_LOCAL_IMAGE, executeLocalFunctionRun, formatLocalFunctionRunResult, } from '../../../lib/function-local-run.js';
+import { FUNCTION_RUNTIMES } from '../../../lib/function-types.js';
+export default class FunctionRunLocal extends AgentiaCommand {
+    static args = {
+        script: Args.string({
+            description: 'Path to the local function script (.sh, .js, or .py)',
+            required: true,
+        }),
+    };
+    static description = 'Run a Copado Function script locally in Docker (no CICD gateway). Override --image when the Copado registry is unavailable.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> copado/functions/myFunction.sh',
+        '<%= config.bin %> <%= command.id %> ./myFunction.js --cwd . --image my-registry/function-core:v1 --parameter ENV=dev --json',
+        '<%= config.bin %> <%= command.id %> ./myFunction.py --runtime python --platform linux/amd64',
+    ];
+    static flags = {
+        cwd: Flags.string({
+            description: 'Host directory bind-mounted at /app inside the container (defaults to the current working directory)',
+        }),
+        image: Flags.string({
+            char: 'i',
+            default: DEFAULT_FUNCTION_LOCAL_IMAGE,
+            description: 'Docker image used to run the function. Override when the Copado image registry is unavailable (e.g. for partners).',
+        }),
+        parameter: Flags.string({
+            description: 'Environment variable for the script as key=value (repeatable)',
+            multiple: true,
+        }),
+        platform: Flags.string({
+            description: 'Docker --platform value (e.g. linux/amd64 on Apple Silicon)',
+        }),
+        runtime: Flags.string({
+            description: 'Override runtime detection from the script extension',
+            options: [...FUNCTION_RUNTIMES],
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(FunctionRunLocal);
+        let result;
+        try {
+            result = await this.withSpinner('Running function locally in Docker', () => executeLocalFunctionRun({
+                cwd: flags.cwd,
+                image: flags.image,
+                parameter: flags.parameter,
+                platform: flags.platform,
+                runtime: flags.runtime,
+                script: args.script,
+            }));
+        }
+        catch (error) {
+            this.error(error instanceof Error ? error.message : String(error), { exit: 2 });
+        }
+        this.display(() => {
+            this.log(formatLocalFunctionRunResult(result));
+        });
+        if (!this.jsonEnabled() && (result.exitCode ?? 1) !== 0) {
+            this.exit(result.exitCode ?? 1);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=run-local.js.map

package/dist/commands/cicd/function/run-local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-local.js","sourceRoot":"","sources":["../../../../src/commands/cicd/function/run-local.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAE,KAAK,EAAC,MAAM,aAAa,CAAA;AAEvC,OAAO,EAAC,cAAc,EAAC,MAAM,iCAAiC,CAAA;AAC9D,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,EACvB,4BAA4B,GAE7B,MAAM,oCAAoC,CAAA;AAC3C,OAAO,EAAC,iBAAiB,EAAC,MAAM,gCAAgC,CAAA;AAEhE,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,cAAc;IAC1D,MAAM,CAAU,IAAI,GAAG;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;YAClB,WAAW,EAAE,sDAAsD;YACnE,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAA;IACD,MAAM,CAAU,WAAW,GACzB,6HAA6H,CAAA;IAC/H,MAAM,CAAU,QAAQ,GAAG;QACzB,oEAAoE;QACpE,6HAA6H;QAC7H,6FAA6F;KAC9F,CAAA;IACD,MAAM,CAAU,KAAK,GAAG;QACtB,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC;YAChB,WAAW,EACT,sGAAsG;SACzG,CAAC;QACF,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC;YAClB,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,4BAA4B;YACrC,WAAW,EACT,oHAAoH;SACvH,CAAC;QACF,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC;YACtB,WAAW,EAAE,+DAA+D;YAC5E,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC;YACrB,WAAW,EAAE,6DAA6D;SAC3E,CAAC;QACF,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC;YACpB,WAAW,EAAE,sDAAsD;YACnE,OAAO,EAAE,CAAC,GAAG,iBAAiB,CAAC;SAChC,CAAC;KACH,CAAA;IAEM,KAAK,CAAC,GAAG;QACd,MAAM,EAAC,IAAI,EAAE,KAAK,EAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAA;QAExD,IAAI,MAA8B,CAAA;QAClC,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,oCAAoC,EAAE,GAAG,EAAE,CACzE,uBAAuB,CAAC;gBACtB,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CACH,CAAA;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAC,IAAI,EAAE,CAAC,EAAC,CAAC,CAAA;QAC/E,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;YAChB,IAAI,CAAC,GAAG,CAAC,4BAA4B,CAAC,MAAM,CAAC,CAAC,CAAA;QAChD,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YACxD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAA;QACjC,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC"}

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

@@ -0,0 +1,16 @@
+import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { type FunctionRunResult } from '../../../lib/function-types.js';
+export default class FunctionRun extends AgentiaCommand {
+    static args: {
+        'api-name': import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        readonly 'context-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly 'deploy-first': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        readonly parameter: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly 'show-validation-errors': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<FunctionRunResult>;
+}

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

@@ -0,0 +1,42 @@
+import { Args } from '@oclif/core';
+import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdGateway } from '../../../lib/cicd-gateway.js';
+import { buildFunctionRunPayload, functionRunFlags } from '../../../lib/function-flags.js';
+import { formatFunctionRunResult, functionRunEndpoint, normalizeFunctionRunResult, } from '../../../lib/function-types.js';
+export default class FunctionRun extends AgentiaCommand {
+    static args = {
+        'api-name': Args.string({
+            description: 'Function API name',
+            required: true,
+        }),
+    };
+    static description = 'Run a Copado Function and return the result Id';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> myFunction',
+        '<%= config.bin %> <%= command.id %> myFunction --parameter env=dev --json',
+        '<%= config.bin %> <%= command.id %> myFunction --context-id a00... --deploy-first --json',
+    ];
+    static flags = functionRunFlags;
+    async run() {
+        const { args, flags } = await this.parse(FunctionRun);
+        const built = buildFunctionRunPayload(flags);
+        if (built.error !== undefined) {
+            this.error(built.error, { exit: 2 });
+        }
+        const response = await this.withSpinner('Running function', () => CicdGateway.call({
+            body: built.payload,
+            endpoint: functionRunEndpoint(args['api-name']),
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            method: 'POST',
+        }));
+        const result = normalizeFunctionRunResult(response);
+        this.display(() => {
+            this.log('Function run started');
+            this.log(formatFunctionRunResult(result));
+        });
+        return result;
+    }
+}
+//# sourceMappingURL=run.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../../src/commands/cicd/function/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,aAAa,CAAA;AAEhC,OAAO,EAAC,cAAc,EAAC,MAAM,iCAAiC,CAAA;AAC9D,OAAO,EAAC,WAAW,EAAC,MAAM,8BAA8B,CAAA;AACxD,OAAO,EAAC,uBAAuB,EAAE,gBAAgB,EAAC,MAAM,gCAAgC,CAAA;AACxF,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EAGnB,0BAA0B,GAC3B,MAAM,gCAAgC,CAAA;AAEvC,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,cAAc;IACrD,MAAM,CAAU,IAAI,GAAG;QACrB,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;YACtB,WAAW,EAAE,mBAAmB;YAChC,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAA;IACD,MAAM,CAAU,WAAW,GAAG,gDAAgD,CAAA;IAC9E,MAAM,CAAU,QAAQ,GAAG;QACzB,gDAAgD;QAChD,2EAA2E;QAC3E,0FAA0F;KAC3F,CAAA;IACD,MAAM,CAAU,KAAK,GAAG,gBAAgB,CAAA;IAEjC,KAAK,CAAC,GAAG;QACd,MAAM,EAAC,IAAI,EAAE,KAAK,EAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;QACnD,MAAM,KAAK,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAA;QAC5C,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,EAAC,IAAI,EAAE,CAAC,EAAC,CAAC,CAAA;QACpC,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAC/D,WAAW,CAAC,IAAI,CAAsB;YACpC,IAAI,EAAE,KAAK,CAAC,OAAO;YACnB,QAAQ,EAAE,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/C,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,MAAM,EAAE,MAAM;SACf,CAAC,CACH,CAAA;QACD,MAAM,MAAM,GAAG,0BAA0B,CAAC,QAAQ,CAAC,CAAA;QAEnD,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;YAChB,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAA;YAChC,IAAI,CAAC,GAAG,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAA;QAC3C,CAAC,CAAC,CAAA;QAEF,OAAO,MAAM,CAAA;IACf,CAAC"}

package/dist/commands/cicd/function/upsert.d.ts

@@ -0,0 +1,27 @@
+import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { type CopadoFunction } from '../../../lib/function-types.js';
+export default class FunctionUpsert extends AgentiaCommand {
+    static args: {
+        'api-name': import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        readonly 'apex-class': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly callback: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly 'flow-handler': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly 'image-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly 'parameters-file': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly runtime: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly script: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly 'script-file': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly size: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly timeout: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly type: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        readonly version: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<CopadoFunction>;
+}

package/dist/commands/cicd/function/upsert.js

@@ -0,0 +1,45 @@
+import { Args } from '@oclif/core';
+import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdGateway } from '../../../lib/cicd-gateway.js';
+import { buildFunctionUpsertPayload, functionUpsertFlags } from '../../../lib/function-flags.js';
+import { formatFunctionDetail, functionEndpoint, normalizeFunction, } from '../../../lib/function-types.js';
+export default class FunctionUpsert extends AgentiaCommand {
+    static args = {
+        'api-name': Args.string({
+            description: 'Function API name',
+            required: true,
+        }),
+    };
+    static description = 'Create or update a Copado Function by API name';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> myFunction --name "My Function" --script "echo hello"',
+        '<%= config.bin %> <%= command.id %> myFunction --script-file ./run.sh --runtime bash --json',
+        '<%= config.bin %> <%= command.id %> myFunction --file ./function.json --json',
+    ];
+    static flags = functionUpsertFlags;
+    async run() {
+        const { args, flags } = await this.parse(FunctionUpsert);
+        let payload;
+        try {
+            payload = await buildFunctionUpsertPayload(args['api-name'], flags);
+        }
+        catch (error) {
+            this.error(error instanceof Error ? error.message : String(error), { exit: 2 });
+        }
+        const response = await this.withSpinner('Upserting function', () => CicdGateway.call({
+            body: payload,
+            endpoint: functionEndpoint(args['api-name']),
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            method: 'PUT',
+        }));
+        const fn = normalizeFunction(response);
+        this.display(() => {
+            this.log(`Upserted function ${fn.apiName ?? args['api-name']} (ID: ${fn.id ?? 'unknown id'}).`);
+            this.log(formatFunctionDetail(fn));
+        });
+        return fn;
+    }
+}
+//# sourceMappingURL=upsert.js.map

package/dist/commands/cicd/function/upsert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upsert.js","sourceRoot":"","sources":["../../../../src/commands/cicd/function/upsert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,aAAa,CAAA;AAEhC,OAAO,EAAC,cAAc,EAAC,MAAM,iCAAiC,CAAA;AAC9D,OAAO,EAAC,WAAW,EAAC,MAAM,8BAA8B,CAAA;AACxD,OAAO,EAAC,0BAA0B,EAAE,mBAAmB,EAAC,MAAM,gCAAgC,CAAA;AAC9F,OAAO,EAEL,oBAAoB,EACpB,gBAAgB,EAEhB,iBAAiB,GAClB,MAAM,gCAAgC,CAAA;AAEvC,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,cAAc;IACxD,MAAM,CAAU,IAAI,GAAG;QACrB,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;YACtB,WAAW,EAAE,mBAAmB;YAChC,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAA;IACD,MAAM,CAAU,WAAW,GAAG,gDAAgD,CAAA;IAC9E,MAAM,CAAU,QAAQ,GAAG;QACzB,2FAA2F;QAC3F,6FAA6F;QAC7F,8EAA8E;KAC/E,CAAA;IACD,MAAM,CAAU,KAAK,GAAG,mBAAmB,CAAA;IAEpC,KAAK,CAAC,GAAG;QACd,MAAM,EAAC,IAAI,EAAE,KAAK,EAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;QAEtD,IAAI,OAAO,CAAA;QACX,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,0BAA0B,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAA;QACrE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAC,IAAI,EAAE,CAAC,EAAC,CAAC,CAAA;QAC/E,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,oBAAoB,EAAE,GAAG,EAAE,CACjE,WAAW,CAAC,IAAI,CAAmB;YACjC,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC5C,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,MAAM,EAAE,KAAK;SACd,CAAC,CACH,CAAA;QACD,MAAM,EAAE,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAA;QAEtC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;YAChB,IAAI,CAAC,GAAG,CAAC,qBAAqB,EAAE,CAAC,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC,EAAE,IAAI,YAAY,IAAI,CAAC,CAAA;YAC/F,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC,CAAA;QACpC,CAAC,CAAC,CAAA;QAEF,OAAO,EAAE,CAAA;IACX,CAAC"}

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/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

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

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