bdy 1.25.7-dev → 1.25.8-dev

package/distTs/package.json

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

package/distTs/src/cliCommand.js

@@ -58,7 +58,11 @@ class CliCommand extends commander_1.Command {
     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) {
@@ -71,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/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/remove.js

@@ -21,8 +21,7 @@ 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'));
+    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')

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

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

@@ -14,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_STATUS,
+    helpText: texts_1.HELP_PIPELINE_RUN_STATUS + texts_1.HELP_PIPELINE_RUN_FAILED_LOGS,
 });
 commandPipelineRunStart.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandPipelineRunStart.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);
@@ -40,6 +40,7 @@ commandPipelineRunStart.option('--action <actions...>', texts_1.OPTION_PIPELINE_
 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('--exit-code', texts_1.OPTION_EXEC_EXIT_CODE);
+commandPipelineRunStart.option('--failed-logs', texts_1.OPTION_PIPELINE_RUN_FAILED_LOGS);
 commandPipelineRunStart.option('--format <text|jsonl>', texts_1.OPTION_EXEC_FORMAT_JSONL);
 commandPipelineRunStart.argument('<identifier>', texts_1.OPTION_PIPELINE_IDENTIFIER);
 commandPipelineRunStart.usage('<identifier> [options]');
@@ -190,6 +191,6 @@ commandPipelineRunStart.action(async (identifier, options) => {
     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, pipelineId, result.id, !options.wait, !options.follow, options.format === 'jsonl', !!options.exitCode);
+    await OutputPipeline.runStatus(client, workspace, project, identifier, pipelineId, result.id, !options.wait, !options.follow, options.format === 'jsonl', !!options.exitCode, !!options.failedLogs);
 });
 exports.default = commandPipelineRunStart;

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

@@ -10,13 +10,14 @@ 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_STATUS,
+    helpText: texts_1.HELP_PIPELINE_RUN_STATUS + texts_1.HELP_PIPELINE_RUN_FAILED_LOGS,
 });
 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('--exit-code', texts_1.OPTION_EXEC_EXIT_CODE);
+commandPipelineRunStatus.option('--failed-logs', texts_1.OPTION_PIPELINE_RUN_FAILED_LOGS);
 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);
@@ -27,6 +28,6 @@ commandPipelineRunStatus.action(async (identifier, runId, options) => {
     const rid = input_1.default.pipelineRunId(runId);
     const pipelineId = await (0, execution_1.resolvePipelineId)(client, workspace, project, identifier);
     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 = commandPipelineRunStatus;

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

@@ -11,6 +11,7 @@ const logs_1 = __importDefault(require("./run/logs"));
 const cancel_1 = __importDefault(require("./run/cancel"));
 const retry_1 = __importDefault(require("./run/retry"));
 const list_1 = __importDefault(require("./run/list"));
+const find_1 = __importDefault(require("./run/find"));
 const approve_1 = __importDefault(require("./run/approve"));
 const commandPipelineRun = (0, utils_1.newCommand)('run', texts_1.DESC_COMMAND_PIPELINE_RUN, {
     examples: [
@@ -21,6 +22,7 @@ const commandPipelineRun = (0, utils_1.newCommand)('run', texts_1.DESC_COMMAND_P
         ...texts_1.EXAMPLE_PIPELINE_RUN_RETRY,
         ...texts_1.EXAMPLE_PIPELINE_RUN_APPLY,
         ...texts_1.EXAMPLE_PIPELINE_RUN_LIST,
+        ...texts_1.EXAMPLE_PIPELINE_RUN_FIND,
     ],
 });
 commandPipelineRun.addCommand(start_1.default);
@@ -30,4 +32,5 @@ commandPipelineRun.addCommand(cancel_1.default);
 commandPipelineRun.addCommand(retry_1.default);
 commandPipelineRun.addCommand(approve_1.default);
 commandPipelineRun.addCommand(list_1.default);
+commandPipelineRun.addCommand(find_1.default);
 exports.default = commandPipelineRun;

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

@@ -16,8 +16,7 @@ commandSandboxDestroy.action(async (identifier, 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 confirmed = options.force ||
-        (await output_1.default.confirm((0, texts_1.TXT_SANDBOX_DESTROY_CONFIRM)(identifier)));
+    const confirmed = await output_1.default.confirmDestructive(options.force, (0, texts_1.TXT_SANDBOX_DESTROY_CONFIRM)(identifier));
     if (!confirmed)
         output_1.default.exitNormal();
     await client.deleteSandbox(workspace, sandboxId);

package/distTs/src/command/sandbox/endpoint/delete.js

@@ -24,8 +24,7 @@ commandSandboxEndpointDelete.action(async (identifier, endpointName, options) =>
         output_1.default.exitError(texts_1.ERR_SANDBOX_ENDPOINT_NOT_FOUND);
     }
     const updatedEndpoints = endpoints.filter((ep) => ep.name !== endpointName);
-    const confirmed = options.force ||
-        (await output_1.default.confirm((0, texts_1.TXT_SANDBOX_ENDPOINT_DELETE_CONFIRM)(identifier, endpointName)));
+    const confirmed = await output_1.default.confirmDestructive(options.force, (0, texts_1.TXT_SANDBOX_ENDPOINT_DELETE_CONFIRM)(identifier, endpointName));
     if (!confirmed)
         output_1.default.exitNormal();
     await client.updateSandbox(workspace, sandboxId, {

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

@@ -16,8 +16,7 @@ commandSandboxExecKill.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 confirmed = options.force ||
-        (await output_1.default.confirm((0, texts_1.OPTION_SANDBOX_COMMAND_KILL_CONFIRM)(identifier, commandId)));
+    const confirmed = await output_1.default.confirmDestructive(options.force, (0, texts_1.OPTION_SANDBOX_COMMAND_KILL_CONFIRM)(identifier, commandId));
     if (!confirmed)
         output_1.default.exitNormal();
     await client.terminateSandboxCommand(workspace, sandboxId, commandId);

package/distTs/src/command/sandbox/snapshot/delete.js

@@ -23,8 +23,7 @@ commandSandboxSnapshotDelete.action(async (identifier, snapshotName, options) =>
     if (!foundSnapshot) {
         output_1.default.exitError(texts_1.ERR_SANDBOX_SNAPSHOT_NOT_FOUND);
     }
-    const confirmed = options.force ||
-        (await output_1.default.confirm((0, texts_1.TXT_SANDBOX_SNAPSHOT_DELETE_CONFIRM)(identifier, snapshotName)));
+    const confirmed = await output_1.default.confirmDestructive(options.force, (0, texts_1.TXT_SANDBOX_SNAPSHOT_DELETE_CONFIRM)(identifier, snapshotName));
     if (!confirmed)
         output_1.default.exitNormal();
     await client.deleteSandboxSnapshot(workspace, sandboxId, foundSnapshot.id);

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

@@ -23,7 +23,7 @@ commandTargetDelete.action(async (identifier, options) => {
     const client = input_1.default.restApiTokenClient();
     const target_id = await (0, scope_1.resolveTargetId)(client, workspace, identifier, options, 
     /* strictLine */ true);
-    const confirmed = options.force || (await output_1.default.confirm((0, texts_1.TXT_TARGET_DELETE_CONFIRM)(identifier)));
+    const confirmed = await output_1.default.confirmDestructive(options.force, (0, texts_1.TXT_TARGET_DELETE_CONFIRM)(identifier));
     if (!confirmed)
         output_1.default.exitNormal();
     await client.deleteTarget(workspace, target_id);

package/distTs/src/command/target/exec/kill.js

@@ -16,12 +16,11 @@ commandTargetExecKill.action(async (execId, options) => {
     const client = input_1.default.restApiTokenClient();
     // Resolve the exec before the prompt so a bad id fails the same way
     // (Resource not found, exit 1) with and without --force - otherwise the
-    // auto-declined prompt exits 0 without ever checking the id. With --force
+    // confirmation error would hide the invalid id. With --force
     // the DELETE itself surfaces the 404, so the extra request is skipped.
     if (!options.force)
         await client.getTargetExec(workspace, execId);
-    const confirmed = options.force ||
-        (await output_1.default.confirm((0, texts_1.TXT_TARGET_EXEC_KILL_CONFIRM)(execId)));
+    const confirmed = await output_1.default.confirmDestructive(options.force, (0, texts_1.TXT_TARGET_EXEC_KILL_CONFIRM)(execId));
     if (!confirmed)
         output_1.default.exitNormal();
     await client.cancelTargetExec(workspace, execId);

package/distTs/src/input.js

@@ -36,6 +36,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+const pipeline_1 = require("./types/pipeline");
 const cfg_1 = __importDefault(require("./project/cfg"));
 const context_1 = require("./project/context");
 const cliError_1 = __importDefault(require("./cliError"));
@@ -569,6 +570,41 @@ class Input {
         }
         output_1.default.exitError(texts_1.ERR_COMMAND_ARTIFACT_TYPE);
     }
+    static pipelineRunFind(options) {
+        const rawLast = options.last;
+        const last = Number(rawLast);
+        if (!/^\d+$/.test(rawLast) || last < 1 || last > 1000) {
+            throw new cliError_1.default('usage_error', texts_1.ERR_PIPELINE_RUN_FIND_LAST);
+        }
+        const { pipelineRunFindFilters } = require('./command/pipeline/run/findFilters');
+        const filters = {};
+        for (const { key, flag } of pipelineRunFindFilters) {
+            const value = options[key];
+            if (value === undefined)
+                continue;
+            if (!value.trim())
+                throw new cliError_1.default('usage_error', (0, texts_1.ERR_PIPELINE_RUN_FIND_FILTER)(flag));
+            filters[key] = value;
+        }
+        if (filters.pr) {
+            if (!/^(?:pull\/)?[1-9]\d*$/.test(filters.pr))
+                throw new cliError_1.default('usage_error', (0, texts_1.ERR_PIPELINE_RUN_FIND_FILTER)('--pr'));
+            filters.pr = 'pull/' + filters.pr.replace(/^pull\//, '');
+        }
+        if (filters.status) {
+            filters.status = filters.status.toUpperCase();
+            if (!Object.values(pipeline_1.PIPELINE_RUN_STATUS).includes(filters.status))
+                throw new cliError_1.default('usage_error', (0, texts_1.ERR_PIPELINE_RUN_FIND_FILTER)('--status'));
+        }
+        if (filters.artifact?.includes(':')) {
+            const separator = filters.artifact.indexOf(':');
+            const version = filters.artifact.slice(separator + 1);
+            const identifier = filters.artifact.slice(0, separator);
+            if (!identifier.trim() || !version.trim())
+                throw new cliError_1.default('usage_error', (0, texts_1.ERR_PIPELINE_RUN_FIND_FILTER)('--artifact'));
+        }
+        return { last, filters };
+    }
     static pipelineRunId(runId) {
         const r = parseInt(runId, 10);
         if (!isNaN(r))