bdy 1.25.5-stage → 1.25.7-dev

package/distTs/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bdy",
   "preferGlobal": false,
-  "version": "1.25.5-stage",
+  "version": "1.25.7-dev",
   "type": "commonjs",
   "license": "MIT",
   "homepage": "https://buddy.works/docs/cli",

package/distTs/src/api/client.js

@@ -1282,7 +1282,7 @@ class ApiClient {
         // answering for a different scope than asked (TARGET_API_REQUIREMENTS.md
         // p6). project_identifier is present whenever the project exists.
         if (params.project && !resolved.project_identifier) {
-            throw new Error(texts_1.ERR_PROJECT_NOT_FOUND);
+            throw new cliError_1.default('not_found', texts_1.ERR_PROJECT_NOT_FOUND);
         }
         return resolved;
     }

package/distTs/src/cliCommand.js

@@ -1,11 +1,44 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const output_1 = __importDefault(require("./output"));
-const cliError_1 = __importDefault(require("./cliError"));
+const cliError_1 = __importStar(require("./cliError"));
 const texts_1 = require("./texts");
 /** Command documentation shared by terminal help and machine discovery. */
 class CliCommand extends commander_1.Command {
@@ -19,11 +52,13 @@ class CliCommand extends commander_1.Command {
     hideVersionUpdate;
     agentPort;
     skipPre = false;
+    usesDefaultContext = false;
     defaultErrorFormat = 'text';
     metadata;
     constructor(name, metadata = {}) {
         super(name);
         this.metadata = metadata;
+        this.option('--context <name>', texts_1.OPTION_CONTEXT);
     }
     addOption(option) {
         if (option.long === '--format' && !option.argChoices) {
@@ -35,8 +70,11 @@ class CliCommand extends commander_1.Command {
     }
     parseOptions(args) {
         output_1.default.errorFormat = this.defaultErrorFormat;
+        output_1.default.errorExitCode = 1;
         const formatOption = this.options.find((option) => option.long === '--format');
-        if (formatOption && this.defaultErrorFormat === 'text') {
+        const exitCodeOption = this.options.some((option) => option.long === '--exit-code');
+        if ((formatOption && this.defaultErrorFormat === 'text') ||
+            exitCodeOption) {
             // Let Commander handle option syntax without running our parsers, hooks
             // or actions. Even if a required value is missing, earlier format values
             // are available before the real parser reports the error.
@@ -53,16 +91,21 @@ class CliCommand extends commander_1.Command {
                     throw err;
             }
             const format = probe.opts().format;
-            if (formatOption.argChoices?.includes(format) &&
+            if (formatOption?.argChoices?.includes(format) &&
                 (format === 'json' || format === 'jsonl'))
                 output_1.default.errorFormat = format;
+            if (exitCodeOption && probe.opts().exitCode)
+                output_1.default.errorExitCode = cliError_1.SemanticExitCode.ERROR;
         }
         this.showSuggestionAfterError(output_1.default.errorFormat === 'text');
         return super.parseOptions(args);
     }
     error(message, options) {
         if (output_1.default.errorFormat === 'text')
-            return super.error(message, options);
+            return super.error(message, {
+                ...options,
+                exitCode: output_1.default.errorExitCode,
+            });
         const path = [this.name()];
         for (let command = this.parent; command; command = command.parent)
             path.unshift(command.name());

package/distTs/src/cliError.js

@@ -1,5 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.SemanticExitCode = void 0;
+/** Process codes used by commands opting into --exit-code. */
+var SemanticExitCode;
+(function (SemanticExitCode) {
+    SemanticExitCode[SemanticExitCode["SUCCESS"] = 0] = "SUCCESS";
+    SemanticExitCode[SemanticExitCode["FAILURE"] = 1] = "FAILURE";
+    SemanticExitCode[SemanticExitCode["ERROR"] = 2] = "ERROR";
+    SemanticExitCode[SemanticExitCode["NOT_FOUND"] = 3] = "NOT_FOUND";
+    SemanticExitCode[SemanticExitCode["PENDING"] = 8] = "PENDING";
+})(SemanticExitCode || (exports.SemanticExitCode = SemanticExitCode = {}));
 class CliError extends Error {
     code;
     hint;

package/distTs/src/cliIndex.js

@@ -30,10 +30,19 @@ const environment_1 = __importDefault(require("./command/environment"));
 const register_1 = __importDefault(require("./command/register"));
 const mcp_1 = __importDefault(require("./command/mcp"));
 const discover_1 = __importDefault(require("./command/discover"));
+const context_1 = __importDefault(require("./command/context"));
+const input_1 = __importDefault(require("./input"));
 const cliError_1 = __importDefault(require("./cliError"));
+const cliCommand_1 = __importDefault(require("./cliCommand"));
 const texts_2 = require("./texts");
 function cliIndex() {
     const program = (0, utils_1.newCommand)('bdy', texts_1.DESC_PROGRAM);
+    program.hook('preAction', (_, command) => {
+        const options = command.optsWithGlobals();
+        input_1.default.configureContext(command instanceof cliCommand_1.default && command.usesDefaultContext
+            ? { ...options, context: 'default' }
+            : options);
+    });
     program.hook('preAction', pre_1.default);
     program.configureHelp({
         formatHelp: utils_1.formatHelp,
@@ -65,6 +74,7 @@ function cliIndex() {
     program.addCommand(api_1.default);
     program.addCommand(mcp_1.default);
     program.addCommand(discover_1.default);
+    program.addCommand(context_1.default);
     program.action((_, cmd) => {
         if (cmd.args.length > 0) {
             output_1.default.exitError(new cliError_1.default('unknown_command', (0, texts_1.ERR_COMMAND_NOT_FOUND)(cmd.args[0]), (0, texts_2.TXT_CLI_USAGE_HINT)('bdy')));

package/distTs/src/command/context/add.js

@@ -0,0 +1,38 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../../utils");
+const input_1 = __importDefault(require("../../input"));
+const output_1 = __importDefault(require("../../output"));
+const cfg_1 = __importDefault(require("../../tunnel/cfg"));
+const cliError_1 = __importDefault(require("../../cliError"));
+const texts_1 = require("../../texts");
+const command = (0, utils_1.newCommand)('add', texts_1.DESC_CONTEXT_ADD, {
+    requiredScopes: [],
+    examples: texts_1.EXAMPLE_CONTEXT_ADD,
+    helpText: texts_1.HELP_CONTEXT_ADD,
+});
+command.skipPre = true;
+command.argument('<name>', texts_1.OPTION_CONTEXT_NAME);
+command.option('--format <text|json>', texts_1.OPTION_FORMAT);
+command.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
+command.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);
+command.option('--token <token>', texts_1.OPTION_CONTEXT_TOKEN);
+command.option('--api <endpoint>', texts_1.OPTION_CONTEXT_API);
+command.option('--from-link', texts_1.OPTION_CONTEXT_LINK);
+command.option('--from-git', texts_1.OPTION_CONTEXT_GIT);
+command.option('--remote <name>', texts_1.OPTION_CONTEXT_REMOTE);
+command.action((name, options) => {
+    input_1.default.contextEditableName(name);
+    if (Object.hasOwn(cfg_1.default.getContexts(), name))
+        throw new cliError_1.default('usage_error', (0, texts_1.ERR_CONTEXT_EXISTS)(name));
+    const context = input_1.default.contextDefinition(options);
+    cfg_1.default.setContext(name, context);
+    if (options.format === 'json')
+        output_1.default.json({ name, source: context.source });
+    else
+        output_1.default.normal((0, texts_1.TXT_CONTEXT_SAVED)(name));
+});
+exports.default = command;

package/distTs/src/command/context/list.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../../utils");
+const output_1 = __importDefault(require("../../output"));
+const cfg_1 = __importDefault(require("../../tunnel/cfg"));
+const texts_1 = require("../../texts");
+const command = (0, utils_1.newCommand)('list', texts_1.DESC_CONTEXT_LIST, {
+    requiredScopes: [],
+    examples: texts_1.EXAMPLE_CONTEXT_LIST,
+    helpText: texts_1.HELP_CONTEXT_LIST,
+});
+command.skipPre = true;
+command.alias('ls');
+command.option('--format <text|json>', texts_1.OPTION_FORMAT);
+command.action((options) => {
+    const builtins = ['default', 'git', 'link'];
+    const active = cfg_1.default.getActiveContext();
+    const values = [...builtins, ...Object.keys(cfg_1.default.getContexts()).sort()].map((name) => ({
+        name,
+        active: name === active,
+        builtin: builtins.includes(name),
+        source: cfg_1.default.getContext(name)?.source || 'default',
+    }));
+    if (options.format === 'json')
+        output_1.default.json(values);
+    else
+        for (const item of values)
+            output_1.default.normal(`${item.active ? '*' : ' '} ${item.name}`);
+});
+exports.default = command;

package/distTs/src/command/context/remove.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../../utils");
+const input_1 = __importDefault(require("../../input"));
+const output_1 = __importDefault(require("../../output"));
+const cfg_1 = __importDefault(require("../../tunnel/cfg"));
+const texts_1 = require("../../texts");
+const command = (0, utils_1.newCommand)('remove', texts_1.DESC_CONTEXT_REMOVE, {
+    requiredScopes: [],
+    examples: texts_1.EXAMPLE_CONTEXT_REMOVE,
+    helpText: texts_1.HELP_CONTEXT_REMOVE,
+});
+command.skipPre = true;
+command.alias('rm');
+command.argument('<name>', texts_1.OPTION_CONTEXT_NAME);
+command.option('--format <text|json>', texts_1.OPTION_FORMAT);
+command.option('-f, --force', texts_1.OPTION_CONFIRM_FORCE);
+command.action(async (name, options) => {
+    input_1.default.contextEditableName(name);
+    cfg_1.default.getContext(name);
+    const confirmed = options.force ||
+        (await output_1.default.confirm((0, texts_1.TXT_CONTEXT_REMOVE_CONFIRM)(name), options.format === 'json'));
+    if (confirmed)
+        cfg_1.default.removeContext(name);
+    if (options.format === 'json')
+        output_1.default.json({
+            removed: confirmed ? name : null,
+            active: cfg_1.default.getActiveContext(),
+        });
+    else if (confirmed)
+        output_1.default.normal((0, texts_1.TXT_CONTEXT_REMOVED)(name));
+});
+exports.default = command;

package/distTs/src/command/context/show.js

@@ -0,0 +1,35 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../../utils");
+const input_1 = __importDefault(require("../../input"));
+const output_1 = __importDefault(require("../../output"));
+const texts_1 = require("../../texts");
+const command = (0, utils_1.newCommand)('show', texts_1.DESC_CONTEXT_SHOW, {
+    requiredScopes: [],
+    examples: texts_1.EXAMPLE_CONTEXT_SHOW,
+    helpText: texts_1.HELP_CONTEXT_SHOW,
+});
+command.skipPre = true;
+command.argument('[name]', texts_1.OPTION_CONTEXT_NAME);
+command.option('--format <text|json>', texts_1.OPTION_FORMAT);
+command.action((name, options, cmd) => {
+    if (name)
+        input_1.default.configureContext({ ...cmd.optsWithGlobals(), context: name });
+    const result = input_1.default.showContext();
+    if (options.format === 'json')
+        output_1.default.json(result);
+    else
+        output_1.default.object({
+            [texts_1.TXT_CONTEXT_LABEL]: result.name,
+            [texts_1.TXT_CONTEXT_SOURCE_LABEL]: result.source,
+            [texts_1.TXT_CONTEXT_WORKSPACE_LABEL]: `${result.workspace || '-'} (${result.sources.workspace || '-'})`,
+            [texts_1.TXT_CONTEXT_PROJECT_LABEL]: `${result.project || '-'} (${result.sources.project || '-'})`,
+            [texts_1.TXT_CONTEXT_API_LABEL]: `${result.api} (${result.sources.api})`,
+            [texts_1.TXT_CONTEXT_REMOTE_LABEL]: result.remote || '-',
+            [texts_1.TXT_CONTEXT_TOKEN_LABEL]: `${result.token.available ? texts_1.TXT_CONTEXT_TOKEN_AVAILABLE : texts_1.TXT_CONTEXT_TOKEN_MISSING} (${result.token.source || '-'})`,
+        });
+});
+exports.default = command;

package/distTs/src/command/context/use.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../../utils");
+const output_1 = __importDefault(require("../../output"));
+const cfg_1 = __importDefault(require("../../tunnel/cfg"));
+const texts_1 = require("../../texts");
+const command = (0, utils_1.newCommand)('use', texts_1.DESC_CONTEXT_USE, {
+    requiredScopes: [],
+    examples: texts_1.EXAMPLE_CONTEXT_USE,
+    helpText: texts_1.HELP_CONTEXT_USE,
+});
+command.skipPre = true;
+command.argument('<name>', texts_1.OPTION_CONTEXT_NAME);
+command.option('--format <text|json>', texts_1.OPTION_FORMAT);
+command.action((name, options) => {
+    cfg_1.default.setActiveContext(name);
+    if (options.format === 'json')
+        output_1.default.json({ active: name });
+    else
+        output_1.default.normal((0, texts_1.TXT_CONTEXT_ACTIVE)(name));
+});
+exports.default = command;

package/distTs/src/command/context.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../utils");
+const texts_1 = require("../texts");
+const add_1 = __importDefault(require("./context/add"));
+const list_1 = __importDefault(require("./context/list"));
+const show_1 = __importDefault(require("./context/show"));
+const use_1 = __importDefault(require("./context/use"));
+const remove_1 = __importDefault(require("./context/remove"));
+const commandContext = (0, utils_1.newCommand)('context', texts_1.DESC_CONTEXT, {
+    requiredScopes: [],
+    helpText: texts_1.HELP_CONTEXT,
+});
+commandContext.addCommand(add_1.default);
+commandContext.addCommand(list_1.default);
+commandContext.addCommand(show_1.default);
+commandContext.addCommand(use_1.default);
+commandContext.addCommand(remove_1.default);
+exports.default = commandContext;

package/distTs/src/command/login.js

@@ -293,6 +293,7 @@ async function authorize(options, forceRegisterEmail, forceRegisterName) {
     }
 }
 const commandLogin = (0, utils_1.newCommand)('login', texts_1.DESC_COMMAND_LOGIN);
+commandLogin.usesDefaultContext = true;
 commandLogin.alias('sign-in');
 commandLogin.option('--token <token>', texts_1.OPTION_REST_API_TOKEN);
 commandLogin.option('--api <url>', texts_1.OPTION_REST_API_ENDPOINT);

package/distTs/src/command/logout.js

@@ -9,6 +9,7 @@ const texts_1 = require("../texts");
 const utils_1 = require("../utils");
 const input_1 = __importDefault(require("../input"));
 const commandLogout = (0, utils_1.newCommand)('logout', texts_1.DESC_COMMAND_LOGOUT);
+commandLogout.usesDefaultContext = true;
 const tryRemovingApp = async () => {
     try {
         const clientId = cfg_1.default.getApiClientId();

package/distTs/src/command/pipeline/run/approve.js

@@ -7,17 +7,19 @@ const utils_1 = require("../../../utils");
 const texts_1 = require("../../../texts");
 const input_1 = __importDefault(require("../../../input"));
 const output_1 = __importDefault(require("../../../output"));
+const execution_1 = require("./execution");
 const pipeline_1 = require("../../../types/pipeline");
 const commandPipelineRunApprove = (0, utils_1.newCommand)('approve', texts_1.DESC_COMMAND_PIPELINE_RUN_APPLY, {
     requiredScopes: [utils_1.REST_API_SCOPE.PIPELINE_RUN],
     examples: texts_1.EXAMPLE_PIPELINE_RUN_APPLY,
-    helpText: texts_1.HELP_PIPELINE_RUN_JSONL,
+    helpText: texts_1.HELP_PIPELINE_RUN_STATUS,
 });
 commandPipelineRunApprove.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandPipelineRunApprove.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);
 commandPipelineRunApprove.option('-n, --no-wait', texts_1.OPTION_PIPELINE_RUN_NO_WAIT);
 commandPipelineRunApprove.option('--no-follow', texts_1.OPTION_PIPELINE_RUN_NO_FOLLOW);
-commandPipelineRunApprove.option('--format <text|jsonl>', texts_1.OPTION_FORMAT_JSONL);
+commandPipelineRunApprove.option('--exit-code', texts_1.OPTION_EXEC_EXIT_CODE);
+commandPipelineRunApprove.option('--format <text|jsonl>', texts_1.OPTION_EXEC_FORMAT_JSONL);
 commandPipelineRunApprove.argument('<identifier>', texts_1.OPTION_PIPELINE_IDENTIFIER);
 commandPipelineRunApprove.argument('<run-id>', texts_1.OPTION_PIPELINE_RUN_ID);
 commandPipelineRunApprove.argument('<action-run-id>', texts_1.OPTION_PIPELINE_RUN_ACTION_ID);
@@ -28,17 +30,8 @@ commandPipelineRunApprove.action(async (identifier, runId, runActionId, options)
     const rid = input_1.default.pipelineRunId(runId);
     const variables = input_1.default.runVariable(options.variable || [], false);
     const client = input_1.default.restApiTokenClient();
-    const data = await client.getPipelineByIdentifier(workspace, project, identifier);
-    if (!data || !data.domain) {
-        output_1.default.exitError(texts_1.ERR_WORKSPACE_NOT_FOUND);
-    }
-    if (!data.project_identifier) {
-        output_1.default.exitError(texts_1.ERR_PROJECT_NOT_FOUND);
-    }
-    if (!data.pipeline_id) {
-        output_1.default.exitError(texts_1.ERR_PIPELINE_NOT_FOUND);
-    }
-    const a = await client.getPipelineRunActionExecution(workspace, project, data.pipeline_id, rid, runActionId);
+    const pipelineId = await (0, execution_1.resolvePipelineId)(client, workspace, project, identifier);
+    const a = await client.getPipelineRunActionExecution(workspace, project, pipelineId, rid, runActionId);
     let type;
     if (a.status === pipeline_1.PIPELINE_RUN_STATUS.WAITING_FOR_APPLY) {
         type = 'APPLY';
@@ -60,8 +53,8 @@ commandPipelineRunApprove.action(async (identifier, runId, runActionId, options)
         approve_action_id: runActionId,
         variables,
     };
-    await client.pipelineRunApply(workspace, project, data.pipeline_id, rid, body);
+    await client.pipelineRunApply(workspace, project, pipelineId, rid, body);
     const OutputPipeline = require('../../../output/pipeline').default;
-    await OutputPipeline.runStatus(client, workspace, project, identifier, data.pipeline_id, rid, !options.wait, !options.follow, options.format === 'jsonl');
+    await OutputPipeline.runStatus(client, workspace, project, identifier, pipelineId, rid, !options.wait, !options.follow, options.format === 'jsonl', !!options.exitCode);
 });
 exports.default = commandPipelineRunApprove;

package/distTs/src/command/pipeline/run/cancel.js

@@ -6,17 +6,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const utils_1 = require("../../../utils");
 const texts_1 = require("../../../texts");
 const input_1 = __importDefault(require("../../../input"));
-const output_1 = __importDefault(require("../../../output"));
+const execution_1 = require("./execution");
 const commandPipelineRunCancel = (0, utils_1.newCommand)('cancel', texts_1.DESC_COMMAND_PIPELINE_RUN_CANCEL, {
     requiredScopes: [utils_1.REST_API_SCOPE.PIPELINE_RUN],
     examples: texts_1.EXAMPLE_PIPELINE_RUN_CANCEL,
-    helpText: texts_1.HELP_PIPELINE_RUN_JSONL,
+    helpText: texts_1.HELP_PIPELINE_RUN_STATUS,
 });
 commandPipelineRunCancel.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandPipelineRunCancel.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);
 commandPipelineRunCancel.option('-n, --no-wait', texts_1.OPTION_PIPELINE_RUN_NO_WAIT);
 commandPipelineRunCancel.option('--no-follow', texts_1.OPTION_PIPELINE_RUN_NO_FOLLOW);
-commandPipelineRunCancel.option('--format <text|jsonl>', texts_1.OPTION_FORMAT_JSONL);
+commandPipelineRunCancel.option('--exit-code', texts_1.OPTION_EXEC_EXIT_CODE);
+commandPipelineRunCancel.option('--format <text|jsonl>', texts_1.OPTION_EXEC_FORMAT_JSONL);
 commandPipelineRunCancel.argument('<identifier>', texts_1.OPTION_PIPELINE_IDENTIFIER);
 commandPipelineRunCancel.argument('<run-id>', texts_1.OPTION_PIPELINE_RUN_ID);
 commandPipelineRunCancel.action(async (identifier, runId, options) => {
@@ -24,18 +25,9 @@ commandPipelineRunCancel.action(async (identifier, runId, options) => {
     const project = input_1.default.restApiProject(options.project);
     const client = input_1.default.restApiTokenClient();
     const rid = input_1.default.pipelineRunId(runId);
-    const data = await client.getPipelineByIdentifier(workspace, project, identifier);
-    if (!data || !data.domain) {
-        output_1.default.exitError(texts_1.ERR_WORKSPACE_NOT_FOUND);
-    }
-    if (!data.project_identifier) {
-        output_1.default.exitError(texts_1.ERR_PROJECT_NOT_FOUND);
-    }
-    if (!data.pipeline_id) {
-        output_1.default.exitError(texts_1.ERR_PIPELINE_NOT_FOUND);
-    }
-    await client.pipelineRunCancel(workspace, project, data.pipeline_id, rid);
+    const pipelineId = await (0, execution_1.resolvePipelineId)(client, workspace, project, identifier);
+    await client.pipelineRunCancel(workspace, project, pipelineId, rid);
     const OutputPipeline = require('../../../output/pipeline').default;
-    await OutputPipeline.runStatus(client, workspace, project, identifier, data.pipeline_id, rid, !options.wait, !options.follow, options.format === 'jsonl');
+    await OutputPipeline.runStatus(client, workspace, project, identifier, pipelineId, rid, !options.wait, !options.follow, options.format === 'jsonl', !!options.exitCode);
 });
 exports.default = commandPipelineRunCancel;

package/distTs/src/command/pipeline/run/execution.js

@@ -0,0 +1,20 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePipelineId = resolvePipelineId;
+const cliError_1 = __importDefault(require("../../../cliError"));
+const texts_1 = require("../../../texts");
+/** Resolve and validate the execution's parent resources. */
+async function resolvePipelineId(client, workspace, project, identifier) {
+    const data = await client.getPipelineByIdentifier(workspace, project, identifier);
+    if (!data || !data.domain)
+        throw new cliError_1.default('not_found', texts_1.ERR_WORKSPACE_NOT_FOUND);
+    if (!data.project_identifier)
+        throw new cliError_1.default('not_found', texts_1.ERR_PROJECT_NOT_FOUND);
+    if (!data.pipeline_id) {
+        throw new cliError_1.default('not_found', texts_1.ERR_PIPELINE_NOT_FOUND);
+    }
+    return data.pipeline_id;
+}

package/distTs/src/command/pipeline/run/logs.js

@@ -6,16 +6,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const utils_1 = require("../../../utils");
 const texts_1 = require("../../../texts");
 const input_1 = __importDefault(require("../../../input"));
-const output_1 = __importDefault(require("../../../output"));
+const execution_1 = require("./execution");
 const commandPipelineRunLogs = (0, utils_1.newCommand)('logs', texts_1.DESC_COMMAND_PIPELINE_RUN_LOGS, {
     requiredScopes: [utils_1.REST_API_SCOPE.PIPELINE_READ],
     examples: texts_1.EXAMPLE_PIPELINE_RUN_LOGS,
-    helpText: texts_1.HELP_PIPELINE_RUN_JSONL,
+    helpText: texts_1.HELP_PIPELINE_RUN_LOGS,
 });
 commandPipelineRunLogs.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandPipelineRunLogs.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);
 commandPipelineRunLogs.option('-n, --no-wait', texts_1.OPTION_PIPELINE_RUN_NO_WAIT);
-commandPipelineRunLogs.option('--format <text|jsonl>', texts_1.OPTION_FORMAT_JSONL);
+commandPipelineRunLogs.option('--exit-code', texts_1.OPTION_EXEC_EXIT_CODE);
+commandPipelineRunLogs.option('--format <text|jsonl>', texts_1.OPTION_EXEC_FORMAT_JSONL);
 commandPipelineRunLogs.argument('<identifier>', texts_1.OPTION_PIPELINE_IDENTIFIER);
 commandPipelineRunLogs.argument('<run-id>', texts_1.OPTION_PIPELINE_RUN_ID);
 commandPipelineRunLogs.argument('<action-run-id>', texts_1.OPTION_PIPELINE_RUN_ACTION_ID);
@@ -25,17 +26,8 @@ commandPipelineRunLogs.action(async (identifier, runId, runActionId, options) =>
     const client = input_1.default.restApiTokenClient();
     const rid = input_1.default.pipelineRunId(runId);
     const raid = input_1.default.pipelineRunActionId(runActionId);
-    const data = await client.getPipelineByIdentifier(workspace, project, identifier);
-    if (!data || !data.domain) {
-        output_1.default.exitError(texts_1.ERR_WORKSPACE_NOT_FOUND);
-    }
-    if (!data.project_identifier) {
-        output_1.default.exitError(texts_1.ERR_PROJECT_NOT_FOUND);
-    }
-    if (!data.pipeline_id) {
-        output_1.default.exitError(texts_1.ERR_PIPELINE_NOT_FOUND);
-    }
+    const pipelineId = await (0, execution_1.resolvePipelineId)(client, workspace, project, identifier);
     const OutputPipeline = require('../../../output/pipeline').default;
-    await OutputPipeline.runLogs(client, workspace, project, identifier, data.pipeline_id, rid, raid, !options.wait, options.format === 'jsonl');
+    await OutputPipeline.runLogs(client, workspace, project, identifier, pipelineId, rid, raid, !options.wait, options.format === 'jsonl', !!options.exitCode);
 });
 exports.default = commandPipelineRunLogs;

package/distTs/src/command/pipeline/run/retry.js

@@ -6,17 +6,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const utils_1 = require("../../../utils");
 const texts_1 = require("../../../texts");
 const input_1 = __importDefault(require("../../../input"));
-const output_1 = __importDefault(require("../../../output"));
+const execution_1 = require("./execution");
 const commandPipelineRunRetry = (0, utils_1.newCommand)('retry', texts_1.DESC_COMMAND_PIPELINE_RUN_RETRY, {
     requiredScopes: [utils_1.REST_API_SCOPE.PIPELINE_RUN],
     examples: texts_1.EXAMPLE_PIPELINE_RUN_RETRY,
-    helpText: texts_1.HELP_PIPELINE_RUN_JSONL,
+    helpText: texts_1.HELP_PIPELINE_RUN_STATUS,
 });
 commandPipelineRunRetry.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandPipelineRunRetry.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);
 commandPipelineRunRetry.option('-n, --no-wait', texts_1.OPTION_PIPELINE_RUN_NO_WAIT);
 commandPipelineRunRetry.option('--no-follow', texts_1.OPTION_PIPELINE_RUN_NO_FOLLOW);
-commandPipelineRunRetry.option('--format <text|jsonl>', texts_1.OPTION_FORMAT_JSONL);
+commandPipelineRunRetry.option('--exit-code', texts_1.OPTION_EXEC_EXIT_CODE);
+commandPipelineRunRetry.option('--format <text|jsonl>', texts_1.OPTION_EXEC_FORMAT_JSONL);
 commandPipelineRunRetry.argument('<identifier>', texts_1.OPTION_PIPELINE_IDENTIFIER);
 commandPipelineRunRetry.argument('<run-id>', texts_1.OPTION_PIPELINE_RUN_ID);
 commandPipelineRunRetry.action(async (identifier, runId, options) => {
@@ -24,18 +25,9 @@ commandPipelineRunRetry.action(async (identifier, runId, options) => {
     const project = input_1.default.restApiProject(options.project);
     const client = input_1.default.restApiTokenClient();
     const rid = input_1.default.pipelineRunId(runId);
-    const data = await client.getPipelineByIdentifier(workspace, project, identifier);
-    if (!data || !data.domain) {
-        output_1.default.exitError(texts_1.ERR_WORKSPACE_NOT_FOUND);
-    }
-    if (!data.project_identifier) {
-        output_1.default.exitError(texts_1.ERR_PROJECT_NOT_FOUND);
-    }
-    if (!data.pipeline_id) {
-        output_1.default.exitError(texts_1.ERR_PIPELINE_NOT_FOUND);
-    }
-    await client.pipelineRunRetry(workspace, project, data.pipeline_id, rid);
+    const pipelineId = await (0, execution_1.resolvePipelineId)(client, workspace, project, identifier);
+    await client.pipelineRunRetry(workspace, project, pipelineId, rid);
     const OutputPipeline = require('../../../output/pipeline').default;
-    await OutputPipeline.runStatus(client, workspace, project, identifier, data.pipeline_id, rid, !options.wait, !options.follow, options.format === 'jsonl');
+    await OutputPipeline.runStatus(client, workspace, project, identifier, pipelineId, rid, !options.wait, !options.follow, options.format === 'jsonl', !!options.exitCode);
 });
 exports.default = commandPipelineRunRetry;

package/distTs/src/command/pipeline/run/start.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const utils_1 = require("../../../utils");
 const texts_1 = require("../../../texts");
 const output_1 = __importDefault(require("../../../output"));
+const execution_1 = require("./execution");
 const input_1 = __importDefault(require("../../../input"));
 const node_fs_1 = __importDefault(require("node:fs"));
 const path_1 = require("path");
@@ -13,7 +14,7 @@ const client_1 = require("../../../api/client");
 const commandPipelineRunStart = (0, utils_1.newCommand)('start', texts_1.DESC_COMMAND_PIPELINE_RUN_START, {
     requiredScopes: [utils_1.REST_API_SCOPE.PIPELINE_RUN],
     examples: texts_1.EXAMPLE_PIPELINE_RUN_START,
-    helpText: texts_1.HELP_PIPELINE_RUN_JSONL,
+    helpText: texts_1.HELP_PIPELINE_RUN_STATUS,
 });
 commandPipelineRunStart.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandPipelineRunStart.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);
@@ -38,7 +39,8 @@ commandPipelineRunStart.option('--schedule <date>', texts_1.OPTION_PIPELINE_RUN_
 commandPipelineRunStart.option('--action <actions...>', texts_1.OPTION_PIPELINE_RUN_ACTION);
 commandPipelineRunStart.option('-n,--no-wait', texts_1.OPTION_PIPELINE_RUN_NO_WAIT);
 commandPipelineRunStart.option('--no-follow', texts_1.OPTION_PIPELINE_RUN_NO_FOLLOW);
-commandPipelineRunStart.option('--format <text|jsonl>', texts_1.OPTION_FORMAT_JSONL);
+commandPipelineRunStart.option('--exit-code', texts_1.OPTION_EXEC_EXIT_CODE);
+commandPipelineRunStart.option('--format <text|jsonl>', texts_1.OPTION_EXEC_FORMAT_JSONL);
 commandPipelineRunStart.argument('<identifier>', texts_1.OPTION_PIPELINE_IDENTIFIER);
 commandPipelineRunStart.usage('<identifier> [options]');
 /**
@@ -135,16 +137,7 @@ commandPipelineRunStart.action(async (identifier, options) => {
     const workspace = input_1.default.restApiWorkspace(options.workspace);
     const project = input_1.default.restApiProject(options.project);
     const client = input_1.default.restApiTokenClient();
-    const data = await client.getPipelineByIdentifier(workspace, project, identifier);
-    if (!data || !data.domain) {
-        output_1.default.exitError(texts_1.ERR_WORKSPACE_NOT_FOUND);
-    }
-    if (!data.project_identifier) {
-        output_1.default.exitError(texts_1.ERR_PROJECT_NOT_FOUND);
-    }
-    if (!data.pipeline_id) {
-        output_1.default.exitError(texts_1.ERR_PIPELINE_NOT_FOUND);
-    }
+    const pipelineId = await (0, execution_1.resolvePipelineId)(client, workspace, project, identifier);
     const body = {};
     if (options.branch) {
         body.branch = {
@@ -194,9 +187,9 @@ commandPipelineRunStart.action(async (identifier, options) => {
     if (actions) {
         body.actions_to_run = actions;
     }
-    body.payload_files = await uploadPayloadFiles(client, workspace, project, data.pipeline_id, options.payload);
-    const result = await client.pipelineRun(workspace, project, data.pipeline_id, body);
+    body.payload_files = await uploadPayloadFiles(client, workspace, project, pipelineId, options.payload);
+    const result = await client.pipelineRun(workspace, project, pipelineId, body);
     const OutputPipeline = require('../../../output/pipeline').default;
-    await OutputPipeline.runStatus(client, workspace, project, identifier, data.pipeline_id, result.id, !options.wait, !options.follow, options.format === 'jsonl');
+    await OutputPipeline.runStatus(client, workspace, project, identifier, pipelineId, result.id, !options.wait, !options.follow, options.format === 'jsonl', !!options.exitCode);
 });
 exports.default = commandPipelineRunStart;