bdy 1.25.5-stage → 1.25.6-dev

package/distTs/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bdy",
   "preferGlobal": false,
-  "version": "1.25.5-stage",
+  "version": "1.25.6-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 {
@@ -35,8 +68,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 +89,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/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;

package/distTs/src/command/pipeline/run/status.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 commandPipelineRunStatus = (0, utils_1.newCommand)('status', texts_1.DESC_COMMAND_PIPELINE_RUN_STATUS, {
     requiredScopes: [utils_1.REST_API_SCOPE.PIPELINE_READ],
     examples: texts_1.EXAMPLE_PIPELINE_RUN_STATUS,
-    helpText: texts_1.HELP_PIPELINE_RUN_JSONL,
+    helpText: texts_1.HELP_PIPELINE_RUN_STATUS,
 });
 commandPipelineRunStatus.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandPipelineRunStatus.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);
 commandPipelineRunStatus.option('-n, --no-wait', texts_1.OPTION_PIPELINE_RUN_NO_WAIT);
 commandPipelineRunStatus.option('--no-follow', texts_1.OPTION_PIPELINE_RUN_NO_FOLLOW);
-commandPipelineRunStatus.option('--format <text|jsonl>', texts_1.OPTION_FORMAT_JSONL);
+commandPipelineRunStatus.option('--exit-code', texts_1.OPTION_EXEC_EXIT_CODE);
+commandPipelineRunStatus.option('--format <text|jsonl>', texts_1.OPTION_EXEC_FORMAT_JSONL);
 commandPipelineRunStatus.argument('<identifier>', texts_1.OPTION_PIPELINE_IDENTIFIER);
 commandPipelineRunStatus.argument('<run-id>', texts_1.OPTION_PIPELINE_RUN_ID);
 commandPipelineRunStatus.action(async (identifier, runId, options) => {
@@ -24,17 +25,8 @@ commandPipelineRunStatus.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);
-    }
+    const pipelineId = await (0, execution_1.resolvePipelineId)(client, workspace, project, identifier);
     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 = commandPipelineRunStatus;

package/distTs/src/command/sandbox/exec/command.js

@@ -18,7 +18,8 @@ commandSandboxExecCommand.option('--runtime <runtime>', texts_1.OPTION_SANDBOX_R
 commandSandboxExecCommand.option('--wait', texts_1.OPTION_SANDBOX_WAIT);
 commandSandboxExecCommand.argument('<identifier>', texts_1.OPTION_SANDBOX_IDENTIFIER);
 commandSandboxExecCommand.argument('<command>');
-commandSandboxExecCommand.option('--format <text|jsonl>', texts_1.OPTION_FORMAT_JSONL);
+commandSandboxExecCommand.option('--format <text|jsonl>', texts_1.OPTION_EXEC_FORMAT_JSONL);
+commandSandboxExecCommand.option('--exit-code', texts_1.OPTION_EXEC_EXIT_CODE);
 commandSandboxExecCommand.action(async (identifier, command, options) => {
     output_1.default.handleSignals();
     const workspace = input_1.default.restApiWorkspace(options.workspace);
@@ -35,13 +36,17 @@ commandSandboxExecCommand.action(async (identifier, command, options) => {
     else {
         output_1.default.gray((0, texts_1.TXT_SANDBOX_EXEC_ID)(cmdResult.id));
     }
+    if (options.exitCode)
+        (0, utils_1.executionExitCode)(cmdResult.status);
     if (!options.wait) {
+        if (options.exitCode)
+            (0, finishExec_1.finishSandboxCommand)(cmdResult, identifier, cmdResult.id, options.format === 'jsonl', true, true);
         if (options.format === 'jsonl')
             output_1.default.exitNormal();
         output_1.default.exitSuccess((0, texts_1.TXT_SANDBOX_EXEC_BACKGROUND)(identifier, cmdResult.id));
     }
     else {
-        await (0, finishExec_1.finishExec)(client, workspace, sandboxId, identifier, cmdResult.id, true, options.format === 'jsonl');
+        await (0, finishExec_1.finishExec)(client, workspace, sandboxId, identifier, cmdResult.id, true, options.format === 'jsonl', !!options.exitCode);
     }
 });
 exports.default = commandSandboxExecCommand;

package/distTs/src/command/sandbox/exec/logs.js

@@ -13,12 +13,13 @@ const commandSandboxExecLogs = (0, utils_1.newCommand)('logs', texts_1.DESC_COMM
 commandSandboxExecLogs.option('--wait', texts_1.OPTION_SANDBOX_WAIT);
 commandSandboxExecLogs.argument('<identifier>', texts_1.OPTION_SANDBOX_IDENTIFIER);
 commandSandboxExecLogs.argument('<command-id>', texts_1.OPTION_SANDBOX_COMMAND_ID);
-commandSandboxExecLogs.option('--format <text|jsonl>', texts_1.OPTION_FORMAT_JSONL);
+commandSandboxExecLogs.option('--format <text|jsonl>', texts_1.OPTION_EXEC_FORMAT_JSONL);
+commandSandboxExecLogs.option('--exit-code', texts_1.OPTION_EXEC_EXIT_CODE);
 commandSandboxExecLogs.action(async (identifier, commandId, options) => {
     output_1.default.handleSignals();
     const workspace = input_1.default.restApiWorkspace(options.workspace);
     const client = input_1.default.restApiTokenClient();
     const sandboxId = await input_1.default.sandboxId(client, workspace, options, identifier);
-    await (0, finishExec_1.finishExec)(client, workspace, sandboxId, identifier, commandId, !!options.wait, options.format === 'jsonl');
+    await (0, finishExec_1.finishExec)(client, workspace, sandboxId, identifier, commandId, !!options.wait, options.format === 'jsonl', !!options.exitCode);
 });
 exports.default = commandSandboxExecLogs;

package/distTs/src/command/sandbox/exec/status.js

@@ -7,16 +7,18 @@ const utils_1 = require("../../../utils");
 const texts_1 = require("../../../texts");
 const input_1 = __importDefault(require("../../../input"));
 const output_1 = __importDefault(require("../../../output"));
-const commandSandboxExecStatus = (0, utils_1.newCommand)('status', texts_1.DESC_COMMAND_SANDBOX_EXEC_STATUS, { examples: texts_1.EXAMPLE_SANDBOX_EXEC_STATUS });
+const commandSandboxExecStatus = (0, utils_1.newCommand)('status', texts_1.DESC_COMMAND_SANDBOX_EXEC_STATUS, { examples: texts_1.EXAMPLE_SANDBOX_EXEC_STATUS, helpText: texts_1.HELP_SANDBOX_EXEC_STATUS });
 (0, utils_1.sandboxScopeOptions)(commandSandboxExecStatus);
-commandSandboxExecStatus.option('--format <text|json>', texts_1.OPTION_FORMAT);
+commandSandboxExecStatus.option('--format <text|json>', texts_1.OPTION_EXEC_FORMAT_JSON);
 commandSandboxExecStatus.argument('<identifier>', texts_1.OPTION_SANDBOX_IDENTIFIER);
 commandSandboxExecStatus.argument('<command-id>', texts_1.OPTION_SANDBOX_COMMAND_ID);
+commandSandboxExecStatus.option('--exit-code', texts_1.OPTION_EXEC_EXIT_CODE);
 commandSandboxExecStatus.action(async (identifier, commandId, options) => {
     const workspace = input_1.default.restApiWorkspace(options.workspace);
     const client = input_1.default.restApiTokenClient();
     const sandboxId = await input_1.default.sandboxId(client, workspace, options, identifier);
     const cmd = await client.getSandboxCommand(workspace, sandboxId, commandId);
+    const code = options.exitCode ? (0, utils_1.executionExitCode)(cmd.status) : undefined;
     if (options.format === 'json') {
         output_1.default.json(cmd);
     }
@@ -34,6 +36,8 @@ commandSandboxExecStatus.action(async (identifier, commandId, options) => {
         ];
         output_1.default.table(data);
     }
+    if (code !== undefined)
+        output_1.default.exitCode(code);
     output_1.default.exitNormal();
 });
 exports.default = commandSandboxExecStatus;

package/distTs/src/command/sandbox/finishExec.js

@@ -4,31 +4,48 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.finishExec = finishExec;
+exports.finishSandboxCommand = finishSandboxCommand;
 const output_1 = __importDefault(require("../../output"));
 const utils_1 = require("../../utils");
 const texts_1 = require("../../texts");
-async function finishExec(client, workspace, sandboxId, identifier, commandId, follow, jsonl) {
+async function finishExec(client, workspace, sandboxId, identifier, commandId, follow, jsonl, semanticExitCode = false) {
     const body = await client.streamSandboxCommandLogs(workspace, sandboxId, commandId, follow);
     await output_1.default.streamCommandLogs(body, jsonl);
     const cmdExit = await client.getSandboxCommand(workspace, sandboxId, commandId);
+    finishSandboxCommand(cmdExit, identifier, commandId, jsonl, semanticExitCode);
+}
+/** Shared final record and process status, including commands started without --wait. */
+function finishSandboxCommand(cmdExit, identifier, commandId, jsonl, semanticExitCode, background = false) {
+    const code = semanticExitCode ? (0, utils_1.executionExitCode)(cmdExit.status) : undefined;
     if (jsonl) {
         output_1.default.json({
             type: 'exit',
             status: cmdExit.status,
             exit_code: cmdExit.exit_code ?? null,
+            ...(semanticExitCode ? { code } : {}),
         });
+        if (code !== undefined)
+            output_1.default.exitCode(code);
         if ([utils_1.SANDBOX_EXEC_STATUS.SUCCESSFUL, utils_1.SANDBOX_EXEC_STATUS.INPROGRESS].includes(cmdExit.status)) {
             output_1.default.exitNormal();
         }
         output_1.default.exitCode(1);
     }
+    if (background) {
+        output_1.default.normal(output_1.default.getGreenColor((0, texts_1.TXT_SANDBOX_EXEC_BACKGROUND)(identifier, commandId)));
+        output_1.default.exitCode(code ?? 0);
+    }
     if (cmdExit.status === utils_1.SANDBOX_EXEC_STATUS.SUCCESSFUL) {
         output_1.default.exitSuccess((0, texts_1.TXT_SANDBOX_EXEC_SUCCESS)(identifier, commandId));
     }
     else if (cmdExit.status === utils_1.SANDBOX_EXEC_STATUS.INPROGRESS) {
+        if (code !== undefined) {
+            output_1.default.normal((0, texts_1.TXT_SANDBOX_EXEC_INPROGRESS)(identifier, commandId));
+            output_1.default.exitCode(code);
+        }
         output_1.default.exitNormal((0, texts_1.TXT_SANDBOX_EXEC_INPROGRESS)(identifier, commandId));
     }
     else {
-        output_1.default.exitError((0, texts_1.TXT_SANDBOX_EXEC_FAILED)(identifier, commandId));
+        output_1.default.exitError((0, texts_1.TXT_SANDBOX_EXEC_FAILED)(identifier, commandId), 1);
     }
 }