bdy 1.25.6-dev → 1.25.8-dev

package/distTs/package.json

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

package/distTs/src/cliCommand.js

@@ -52,11 +52,17 @@ class CliCommand extends commander_1.Command {
     hideVersionUpdate;
     agentPort;
     skipPre = false;
+    usesDefaultContext = false;
     defaultErrorFormat = 'text';
     metadata;
     constructor(name, metadata = {}) {
         super(name);
         this.metadata = metadata;
+        // Route options after a subcommand name to that subcommand, including
+        // --examples and its format, instead of consuming them in a parent group.
+        this.enablePositionalOptions();
+        this.option('--context <name>', texts_1.OPTION_CONTEXT);
+        this.option('--examples', texts_1.OPTION_EXAMPLES);
     }
     addOption(option) {
         if (option.long === '--format' && !option.argChoices) {
@@ -69,6 +75,43 @@ class CliCommand extends commander_1.Command {
     parseOptions(args) {
         output_1.default.errorFormat = this.defaultErrorFormat;
         output_1.default.errorExitCode = 1;
+        const delimiter = args.indexOf('--');
+        const optionArgs = delimiter < 0 ? args : args.slice(0, delimiter);
+        const examplesIndex = optionArgs.indexOf('--examples');
+        let subcommandBeforeExamples = false;
+        for (let i = 0; i < examplesIndex; i += 1) {
+            const arg = optionArgs[i];
+            const option = this.options.find((item) => item.long === arg || item.short === arg);
+            if (option?.required || option?.optional) {
+                i += 1;
+            }
+            else if (this.commands.some((child) => child.name() === arg || child.aliases().includes(arg))) {
+                subcommandBeforeExamples = true;
+                break;
+            }
+        }
+        if (examplesIndex >= 0 &&
+            !optionArgs.includes('--help') &&
+            !optionArgs.includes('-h') &&
+            !subcommandBeforeExamples) {
+            const formats = optionArgs.flatMap((arg, index) => arg === '--format'
+                ? [optionArgs[index + 1]]
+                : arg.startsWith('--format=')
+                    ? [arg.slice('--format='.length)]
+                    : []);
+            const format = formats.length ? formats.at(-1) : 'text';
+            if (typeof format !== 'string' || !['text', 'json', 'jsonl'].includes(format)) {
+                this.error(`Invalid examples format '${format}'. Choose text, json or jsonl.`);
+            }
+            const path = [this.name()];
+            let parent = this.parent;
+            while (parent) {
+                path.unshift(parent.name());
+                parent = parent.parent;
+            }
+            output_1.default.examples(path.join(' '), this.examples, format);
+            output_1.default.exitNormal();
+        }
         const formatOption = this.options.find((option) => option.long === '--format');
         const exitCodeOption = this.options.some((option) => option.long === '--exit-code');
         if ((formatOption && this.defaultErrorFormat === 'text') ||

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/agent/uninstall.js

@@ -16,7 +16,7 @@ commandAgentUninstall.action(async (options) => {
     if (!hasRights) {
         output_1.default.exitError(texts_1.ERR_AGENT_ADMIN_RIGHTS);
     }
-    const confirmed = options.force || (await output_1.default.confirm(texts_1.TXY_AGENT_CONFIRM_DELETE));
+    const confirmed = await output_1.default.confirmDestructive(options.force, texts_1.TXY_AGENT_CONFIRM_DELETE);
     if (!confirmed)
         output_1.default.exitNormal();
     try {

package/distTs/src/command/artifact/delete.js

@@ -30,8 +30,7 @@ commandArtifactDelete.action(async (identifier, options) => {
     if (!data.artifact_id) {
         output_1.default.exitError(texts_1.ERR_ARTIFACT_NOT_FOUND);
     }
-    const confirmed = options.force ||
-        (await output_1.default.confirm((0, texts_1.TXT_ARTIFACT_DELETE_CONFIRM)(identifier)));
+    const confirmed = await output_1.default.confirmDestructive(options.force, (0, texts_1.TXT_ARTIFACT_DELETE_CONFIRM)(identifier));
     if (confirmed) {
         await client.deleteArtifact(workspace, data.artifact_id);
         output_1.default.exitSuccess(texts_1.TXT_ARTIFACT_DELETED);

package/distTs/src/command/artifact/version/delete.js

@@ -34,8 +34,7 @@ commandArtifactVersionDelete.action(async (identifier, version, options) => {
     if (!data || !data.artifact_version_id) {
         output_1.default.exitError(texts_1.ERR_ARTIFACT_VERSION_NOT_FOUND);
     }
-    const confirmed = options.force ||
-        (await output_1.default.confirm((0, texts_1.TXT_ARTIFACT_VERSION_DELETE_CONFIRM)(identifier, version)));
+    const confirmed = await output_1.default.confirmDestructive(options.force, (0, texts_1.TXT_ARTIFACT_VERSION_DELETE_CONFIRM)(identifier, version));
     if (!confirmed)
         output_1.default.exitNormal();
     await client.deleteArtifactVersion(workspace, data.artifact_id, data.artifact_version_id);

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,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 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 = await output_1.default.confirmDestructive(options.force, (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/distro/delete.js

@@ -30,8 +30,7 @@ commandDistroDelete.action(async (identifier, options) => {
     if (!data || !data.distribution_id) {
         output_1.default.exitError(texts_1.ERR_COMMAND_DISTRO_NOT_FOUND);
     }
-    const confirmed = options.force ||
-        (await output_1.default.confirm((0, texts_1.TXT_COMMAND_DISTRO_DELETE_CONFIRM)(identifier)));
+    const confirmed = await output_1.default.confirmDestructive(options.force, (0, texts_1.TXT_COMMAND_DISTRO_DELETE_CONFIRM)(identifier));
     if (confirmed) {
         await client.deleteDistribution(workspace, scope === distro_1.SCOPE.PROJECT ? project : null, data.distribution_id);
         output_1.default.exitSuccess(texts_1.TXT_COMMAND_DISTRO_DELETED);

package/distTs/src/command/distro/route/delete.js

@@ -31,8 +31,7 @@ commandDistroRouteDelete.action(async (identifier, routeId, options) => {
     if (!data?.distribution_id) {
         output_1.default.exitError(texts_1.ERR_COMMAND_DISTRO_NOT_FOUND);
     }
-    const confirmed = options.force ||
-        (await output_1.default.confirm((0, texts_1.TXT_COMMAND_ROUTE_DELETE_CONFIRM)(identifier, routeId)));
+    const confirmed = await output_1.default.confirmDestructive(options.force, (0, texts_1.TXT_COMMAND_ROUTE_DELETE_CONFIRM)(identifier, routeId));
     if (confirmed) {
         await client.deleteRoute(workspace, scope === distro_1.SCOPE.PROJECT ? project : null, data.distribution_id, routeId);
         output_1.default.exitSuccess(texts_1.TXT_COMMAND_ROUTE_DELETED);

package/distTs/src/command/environment/delete.js

@@ -18,8 +18,7 @@ commandEnvironmentDelete.action(async (identifier, options) => {
     const client = input_1.default.restApiTokenClient();
     const environment_id = await input_1.default.environmentId(client, workspace, identifier, options, 
     /* strictProject */ true);
-    const confirmed = options.force ||
-        (await output_1.default.confirm((0, texts_1.TXT_ENVIRONMENT_DELETE_CONFIRM)(identifier)));
+    const confirmed = await output_1.default.confirmDestructive(options.force, (0, texts_1.TXT_ENVIRONMENT_DELETE_CONFIRM)(identifier));
     if (!confirmed)
         output_1.default.exitNormal();
     await client.deleteEnvironment(workspace, environment_id);

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/delete.js

@@ -30,8 +30,7 @@ commandPipelineDelete.action(async (identifier, options) => {
     if (!data.pipeline_id) {
         output_1.default.exitError(texts_1.ERR_PIPELINE_NOT_FOUND);
     }
-    const confirmed = options.force ||
-        (await output_1.default.confirm((0, texts_1.TXT_PIPELINE_DELETE_CONFIRM)(identifier)));
+    const confirmed = await output_1.default.confirmDestructive(options.force, (0, texts_1.TXT_PIPELINE_DELETE_CONFIRM)(identifier));
     if (confirmed) {
         await client.deletePipeline(workspace, project, data.pipeline_id);
         output_1.default.exitSuccess(texts_1.TXT_PIPELINE_DELETED);

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

@@ -12,13 +12,14 @@ 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_STATUS,
+    helpText: texts_1.HELP_PIPELINE_RUN_STATUS + texts_1.HELP_PIPELINE_RUN_FAILED_LOGS,
 });
 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('--exit-code', texts_1.OPTION_EXEC_EXIT_CODE);
+commandPipelineRunApprove.option('--failed-logs', texts_1.OPTION_PIPELINE_RUN_FAILED_LOGS);
 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);
@@ -55,6 +56,6 @@ commandPipelineRunApprove.action(async (identifier, runId, runActionId, options)
     };
     await client.pipelineRunApply(workspace, project, pipelineId, rid, body);
     const OutputPipeline = require('../../../output/pipeline').default;
-    await OutputPipeline.runStatus(client, workspace, project, identifier, pipelineId, rid, !options.wait, !options.follow, options.format === 'jsonl', !!options.exitCode);
+    await OutputPipeline.runStatus(client, workspace, project, identifier, pipelineId, rid, !options.wait, !options.follow, options.format === 'jsonl', !!options.exitCode, !!options.failedLogs);
 });
 exports.default = commandPipelineRunApprove;

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

@@ -10,13 +10,14 @@ 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_STATUS,
+    helpText: texts_1.HELP_PIPELINE_RUN_STATUS + texts_1.HELP_PIPELINE_RUN_FAILED_LOGS,
 });
 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('--exit-code', texts_1.OPTION_EXEC_EXIT_CODE);
+commandPipelineRunCancel.option('--failed-logs', texts_1.OPTION_PIPELINE_RUN_FAILED_LOGS);
 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);
@@ -28,6 +29,6 @@ commandPipelineRunCancel.action(async (identifier, runId, options) => {
     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, pipelineId, rid, !options.wait, !options.follow, options.format === 'jsonl', !!options.exitCode);
+    await OutputPipeline.runStatus(client, workspace, project, identifier, pipelineId, rid, !options.wait, !options.follow, options.format === 'jsonl', !!options.exitCode, !!options.failedLogs);
 });
 exports.default = commandPipelineRunCancel;

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

@@ -0,0 +1,87 @@
+"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 execution_1 = require("./execution");
+const findFilters_1 = require("./findFilters");
+const texts_1 = require("../../../texts");
+const command = (0, utils_1.newCommand)('find', texts_1.DESC_COMMAND_PIPELINE_RUN_FIND, {
+    requiredScopes: [utils_1.REST_API_SCOPE.PIPELINE_READ],
+    examples: texts_1.EXAMPLE_PIPELINE_RUN_FIND,
+    helpText: texts_1.HELP_PIPELINE_RUN_FIND,
+});
+command.argument('<identifier>', texts_1.OPTION_PIPELINE_IDENTIFIER);
+command.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
+command.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);
+command.option('--last <number>', texts_1.OPTION_PIPELINE_RUN_FIND_LAST, '100');
+for (const { flag, argument, description } of findFilters_1.pipelineRunFindFilters) {
+    command.option(`${flag} ${argument}`, description);
+}
+command.option('--format <text|json>', texts_1.OPTION_FORMAT);
+command.action(async (identifier, options) => {
+    const { last, filters } = input_1.default.pipelineRunFind(options);
+    const workspace = input_1.default.restApiWorkspace(options.workspace);
+    const project = input_1.default.restApiProject(options.project);
+    const client = input_1.default.restApiTokenClient();
+    const pipelineId = await (0, execution_1.resolvePipelineId)(client, workspace, project, identifier);
+    const executions = [];
+    // Keep page size fixed: changing it on the last request changes page offsets.
+    const perPage = Math.min(last, 100);
+    const seen = new Set();
+    let scanned = 0;
+    let fetched = 0;
+    let hasMore = false;
+    for (let page = 1; scanned < last; page += 1) {
+        const result = await client.getPipelineRuns(workspace, project, pipelineId, page, perPage);
+        const batch = result.executions;
+        fetched += batch.length;
+        let hasMoreInBatch = false;
+        for (const run of batch) {
+            // New runs shift page offsets; repeated IDs must not consume the window.
+            if (seen.has(run.id))
+                continue;
+            if (scanned === last) {
+                hasMoreInBatch = true;
+                break;
+            }
+            seen.add(run.id);
+            scanned += 1;
+            if (findFilters_1.pipelineRunFindFilters.every(({ key, pick }) => {
+                const value = filters[key];
+                return value === undefined || pick(run).includes(value);
+            }))
+                executions.push(run);
+        }
+        if (!batch.length) {
+            hasMore = false;
+            break;
+        }
+        // Compare pagination progress (including duplicates) with the current total.
+        // total_page_count may be absent or based on an uncapped size.
+        const total = result.total_element_count;
+        const hasTotal = typeof total === 'number' && Number.isInteger(total) && total >= 0;
+        hasMore = hasMoreInBatch || !hasTotal || fetched < total;
+        if (!hasMore)
+            break;
+        if (scanned === last && !hasTotal && !hasMoreInBatch) {
+            // Without a total, probe for existence only. These runs are not searched
+            // or included in scanned; even a short page does not prove exhaustion.
+            const next = await client.getPipelineRuns(workspace, project, pipelineId, page + 1, perPage);
+            hasMore = next.executions.some((run) => !seen.has(run.id));
+        }
+    }
+    executions.sort((a, b) => b.id - a.id);
+    const result = { last, scanned, has_more: hasMore, executions };
+    if (options.format === 'json')
+        output_1.default.json(result);
+    else {
+        const OutputPipeline = require('../../../output/pipeline').default;
+        OutputPipeline.findRuns(result);
+    }
+    output_1.default.exitNormal();
+});
+exports.default = command;

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

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pipelineRunFindFilters = void 0;
+const texts_1 = require("../../../texts");
+/** One source for CLI options, validation names, filter types and matching. */
+exports.pipelineRunFindFilters = [
+    {
+        key: 'branch',
+        flag: '--branch',
+        argument: '<name>',
+        description: texts_1.OPTION_PIPELINE_RUN_FIND_BRANCH,
+        pick: (run) => [run.branch?.name],
+    },
+    {
+        key: 'tag',
+        flag: '--tag',
+        argument: '<name>',
+        description: texts_1.OPTION_PIPELINE_RUN_FIND_TAG,
+        pick: (run) => [run.tag?.name],
+    },
+    {
+        key: 'pr',
+        flag: '--pr',
+        argument: '<number>',
+        description: texts_1.OPTION_PIPELINE_RUN_FIND_PR,
+        pick: (run) => [run.pull_request?.name],
+    },
+    {
+        key: 'revision',
+        flag: '--revision',
+        argument: '<revision>',
+        description: texts_1.OPTION_PIPELINE_RUN_FIND_REVISION,
+        pick: (run) => [run.to_revision?.revision],
+    },
+    {
+        key: 'fromRevision',
+        flag: '--from-revision',
+        argument: '<revision>',
+        description: texts_1.OPTION_PIPELINE_RUN_FIND_FROM_REVISION,
+        pick: (run) => [run.from_revision?.revision],
+    },
+    {
+        key: 'environment',
+        flag: '--environment',
+        argument: '<identifier>',
+        description: texts_1.OPTION_PIPELINE_RUN_FIND_ENVIRONMENT,
+        pick: (run) => [run.environment?.identifier],
+    },
+    {
+        key: 'artifact',
+        flag: '--artifact',
+        argument: '<identifier[:version]>',
+        description: texts_1.OPTION_PIPELINE_RUN_FIND_ARTIFACT,
+        pick: (run) => [
+            run.artifact?.identifier,
+            run.artifact?.identifier && run.artifact_version?.version
+                ? `${run.artifact.identifier}:${run.artifact_version.version}`
+                : undefined,
+        ],
+    },
+    {
+        key: 'status',
+        flag: '--status',
+        argument: '<status>',
+        description: texts_1.OPTION_PIPELINE_RUN_FIND_STATUS,
+        pick: (run) => [run.status],
+    },
+];

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

@@ -10,13 +10,16 @@ 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_STATUS,
+    helpText: texts_1.HELP_PIPELINE_RUN_STATUS +
+        texts_1.HELP_PIPELINE_RUN_FAILED_LOGS +
+        texts_1.HELP_PIPELINE_RUN_RETRY,
 });
 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('--exit-code', texts_1.OPTION_EXEC_EXIT_CODE);
+commandPipelineRunRetry.option('--failed-logs', texts_1.OPTION_PIPELINE_RUN_FAILED_LOGS);
 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);
@@ -28,6 +31,6 @@ commandPipelineRunRetry.action(async (identifier, runId, options) => {
     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, pipelineId, rid, !options.wait, !options.follow, options.format === 'jsonl', !!options.exitCode);
+    await OutputPipeline.runStatus(client, workspace, project, identifier, pipelineId, rid, !options.wait, !options.follow, options.format === 'jsonl', !!options.exitCode, !!options.failedLogs);
 });
 exports.default = commandPipelineRunRetry;