bdy 1.25.2-stage → 1.25.4-dev

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

@@ -8,14 +8,16 @@ const texts_1 = require("../../texts");
 const input_1 = __importDefault(require("../../input"));
 const output_1 = __importDefault(require("../../output"));
 const distro_1 = require("../../types/distro");
-const commandArtifactDelete = (0, utils_1.newCommand)('delete', texts_1.DESC_COMMAND_ARTIFACT_DELETE);
+const commandArtifactDelete = (0, utils_1.newCommand)('delete', texts_1.DESC_COMMAND_ARTIFACT_DELETE, {
+    requiredScopes: [utils_1.REST_API_SCOPE.ARTIFACT_MANAGE],
+    examples: texts_1.EXAMPLE_ARTIFACT_DELETE,
+});
 commandArtifactDelete.alias('rm');
 commandArtifactDelete.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandArtifactDelete.option('--scope <scope>', texts_1.OPT_COMMAND_SCOPE);
 commandArtifactDelete.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);
 commandArtifactDelete.option('-f, --force', texts_1.OPTION_CONFIRM_FORCE);
 commandArtifactDelete.argument('<identifier>', texts_1.OPT_COMMAND_ARTIFACT_IDENTIFIER);
-commandArtifactDelete.addHelpText('after', texts_1.EXAMPLE_ARTIFACT_DELETE);
 commandArtifactDelete.action(async (identifier, options) => {
     const workspace = input_1.default.restApiWorkspace(options.workspace);
     const project = input_1.default.restApiProject(options.project, true);

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

@@ -6,6 +6,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const utils_1 = require("../../utils");
 const texts_1 = require("../../texts");
 const login_1 = __importDefault(require("./docker/login"));
-const commandArtifactDocker = (0, utils_1.newCommand)('docker', texts_1.DESC_COMMAND_ARTIFACT_DOCKER_LOGIN);
+const commandArtifactDocker = (0, utils_1.newCommand)('docker', texts_1.DESC_COMMAND_ARTIFACT_DOCKER);
 commandArtifactDocker.addCommand(login_1.default);
 exports.default = commandArtifactDocker;

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

@@ -12,7 +12,10 @@ const path_1 = require("path");
 const fs_1 = __importDefault(require("fs"));
 const promises_1 = __importDefault(require("node:stream/promises"));
 const distro_1 = require("../../types/distro");
-const commandArtifactDownload = (0, utils_1.newCommand)('download', texts_1.DESC_COMMAND_ARTIFACT_DOWNLOAD);
+const commandArtifactDownload = (0, utils_1.newCommand)('download', texts_1.DESC_COMMAND_ARTIFACT_DOWNLOAD, {
+    requiredScopes: [utils_1.REST_API_SCOPE.ARTIFACT_READ],
+    examples: texts_1.EXAMPLE_ARTIFACT_DOWNLOAD,
+});
 commandArtifactDownload.alias('dd');
 commandArtifactDownload.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandArtifactDownload.option('--scope <scope>', texts_1.OPT_COMMAND_SCOPE);
@@ -21,7 +24,6 @@ commandArtifactDownload.option('-m, --merge', texts_1.OPTION_ARTIFACT_DOWNLOAD_M
 commandArtifactDownload.option('-r, --replace', texts_1.OPTION_ARTIFACT_DOWNLOAD_REPLACE);
 commandArtifactDownload.argument('<identifier>', texts_1.OPTION_ARTIFACT_ID);
 commandArtifactDownload.argument('<directory>', texts_1.OPTION_ARTIFACT_DOWNLOAD_PATH);
-commandArtifactDownload.addHelpText('after', texts_1.EXAMPLE_ARTIFACT_DOWNLOAD);
 commandArtifactDownload.action(async (id, path, options) => {
     const { v4 } = require('uuid');
     const ArchiverExtract = require('../../unzipper').default;

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

@@ -8,7 +8,9 @@ const texts_1 = require("../../texts");
 const input_1 = __importDefault(require("../../input"));
 const output_1 = __importDefault(require("../../output"));
 const distro_1 = require("../../types/distro");
-const commandArtifactGet = (0, utils_1.newCommand)('get', texts_1.DESC_COMMAND_ARTIFACT_GET);
+const commandArtifactGet = (0, utils_1.newCommand)('get', texts_1.DESC_COMMAND_ARTIFACT_GET, {
+    requiredScopes: [utils_1.REST_API_SCOPE.ARTIFACT_READ],
+});
 commandArtifactGet.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandArtifactGet.option('--scope <scope>', texts_1.OPT_COMMAND_SCOPE);
 commandArtifactGet.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);

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

@@ -8,7 +8,9 @@ const texts_1 = require("../../texts");
 const utils_1 = require("../../utils");
 const input_1 = __importDefault(require("../../input"));
 const distro_1 = require("../../types/distro");
-const commandArtifactList = (0, utils_1.newCommand)('list', texts_1.DESC_COMMAND_ARTIFACT_LIST);
+const commandArtifactList = (0, utils_1.newCommand)('list', texts_1.DESC_COMMAND_ARTIFACT_LIST, {
+    requiredScopes: [utils_1.REST_API_SCOPE.ARTIFACT_READ],
+});
 commandArtifactList.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandArtifactList.option('--scope <scope>', texts_1.OPT_COMMAND_SCOPE);
 commandArtifactList.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);

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

@@ -11,7 +11,10 @@ const logger_1 = __importDefault(require("../../logger"));
 const fs_1 = __importDefault(require("fs"));
 const path_1 = require("path");
 const distro_1 = require("../../types/distro");
-const commandArtifactPublish = (0, utils_1.newCommand)('publish', texts_1.DESC_COMMAND_ARTIFACT_PUBLISH);
+const commandArtifactPublish = (0, utils_1.newCommand)('publish', texts_1.DESC_COMMAND_ARTIFACT_PUBLISH, {
+    requiredScopes: [utils_1.REST_API_SCOPE.ARTIFACT_WRITE],
+    examples: texts_1.EXAMPLE_ARTIFACT_PUBLISH,
+});
 commandArtifactPublish.alias('pub');
 commandArtifactPublish.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandArtifactPublish.option('--scope <scope>', texts_1.OPT_COMMAND_SCOPE);
@@ -22,9 +25,10 @@ commandArtifactPublish.option('--agent-note <note>', texts_1.OPTION_ARTIFACT_VER
 commandArtifactPublish.option('-f, --force', texts_1.OPTION_ARTIFACT_PUBLISH_OVERWRITE_VERSION);
 commandArtifactPublish.argument('<identifier>', texts_1.OPTION_ARTIFACT_ID);
 commandArtifactPublish.argument('<directory>', texts_1.OPTION_ARTIFACT_PUBLISH_PATH);
-commandArtifactPublish.addHelpText('after', texts_1.EXAMPLE_ARTIFACT_PUBLISH);
+commandArtifactPublish.option('--format <text|json>', texts_1.OPTION_FORMAT);
 commandArtifactPublish.action(async (id, path, options) => {
     const { v4 } = require('uuid');
+    const say = output_1.default.progress(options.format === 'json');
     let dirPath = input_1.default.resolvePath(path);
     const workspace = input_1.default.restApiWorkspace(options.workspace);
     const project = input_1.default.restApiProject(options.project, true);
@@ -64,20 +68,15 @@ commandArtifactPublish.action(async (id, path, options) => {
         }
     }
     let artifactVersionId = data.artifact_version_id;
-    let url;
     if (artifactVersionId && !options.force) {
         output_1.default.exitError(texts_1.ERR_ARTIFACT_VERSION_EXISTS);
     }
-    if (!artifactVersionId) {
-        const d = await client.createArtifactVersion(workspace, artifactId, version, options.note, options.agentNote);
-        url = d.version_url;
-        artifactVersionId = d.id;
-    }
-    else {
-        const d = await client.getArtifactVersion(workspace, artifactId, artifactVersionId);
-        url = d.version_url;
-    }
-    output_1.default.normal(texts_1.TXT_ARTIFACT_SCANNING_DIR, false);
+    const artifactVersion = !artifactVersionId
+        ? await client.createArtifactVersion(workspace, artifactId, version, options.note, options.agentNote)
+        : await client.getArtifactVersion(workspace, artifactId, artifactVersionId);
+    const url = artifactVersion.version_url;
+    artifactVersionId = artifactVersion.id;
+    say(texts_1.TXT_ARTIFACT_SCANNING_DIR, false);
     const stat = fs_1.default.statSync(dirPath);
     let entries;
     if (stat.isDirectory()) {
@@ -104,6 +103,10 @@ commandArtifactPublish.action(async (id, path, options) => {
         dirPath = parentPath;
     }
     const outputSuccess = () => {
+        if (options.format === 'json') {
+            output_1.default.json(artifactVersion);
+            output_1.default.exitNormal();
+        }
         output_1.default.object({
             Version: `${identifier}:${version}`,
             URL: url || '-',
@@ -112,16 +115,16 @@ commandArtifactPublish.action(async (id, path, options) => {
         output_1.default.exitNormal();
     };
     if (!entries.length) {
-        output_1.default.normal(texts_1.TXT_ARTIFACT_NO_ENTRIES_FOUND);
+        say(texts_1.TXT_ARTIFACT_NO_ENTRIES_FOUND);
         outputSuccess();
     }
     else if (entries.length === 1) {
-        output_1.default.normal(texts_1.TXT_ARTIFACT_ONE_ENTRY_FOUND);
+        say(texts_1.TXT_ARTIFACT_ONE_ENTRY_FOUND);
     }
     else {
-        output_1.default.normal((0, texts_1.TXT_ARTIFACT_ENTRIES_FOUND)(entries.length));
+        say((0, texts_1.TXT_ARTIFACT_ENTRIES_FOUND)(entries.length));
     }
-    output_1.default.normal((0, texts_1.TXT_ARTIFACT_ZIP_ENTRIES)(0));
+    say((0, texts_1.TXT_ARTIFACT_ZIP_ENTRIES)(0));
     const zipPath = (0, path_1.join)((0, utils_1.getHomeDirectory)(), `${v4()}.zip`);
     const clearZip = () => {
         try {
@@ -136,11 +139,9 @@ commandArtifactPublish.action(async (id, path, options) => {
         let proc = 0;
         await (0, utils_1.createZip)(dirPath, zipPath, entries, () => {
             proc += 1;
-            output_1.default.clearPreviousLine();
-            output_1.default.normal((0, texts_1.TXT_ARTIFACT_ZIP_ENTRIES)(proc));
+            say((0, texts_1.TXT_ARTIFACT_ZIP_ENTRIES)(proc), true, true);
         });
-        output_1.default.clearPreviousLine();
-        output_1.default.normal(texts_1.TXT_ARTIFACT_ZIPPED);
+        say(texts_1.TXT_ARTIFACT_ZIPPED, true, true);
         blob = await fs_1.default.openAsBlob(zipPath);
     }
     catch (err) {
@@ -149,10 +150,9 @@ commandArtifactPublish.action(async (id, path, options) => {
         output_1.default.exitError(texts_1.ERR_SWW);
     }
     try {
-        output_1.default.normal(texts_1.TXT_ARTIFACT_UPLOADING);
+        say(texts_1.TXT_ARTIFACT_UPLOADING);
         await client.createArtifactVersionZip(workspace, artifactId, artifactVersionId, blob);
-        output_1.default.clearPreviousLine();
-        output_1.default.normal(texts_1.TXT_ARTIFACT_UPLOADED);
+        say(texts_1.TXT_ARTIFACT_UPLOADED, true, true);
         clearZip();
         outputSuccess();
     }

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

@@ -8,7 +8,10 @@ const texts_1 = require("../../../texts");
 const input_1 = __importDefault(require("../../../input"));
 const distro_1 = require("../../../types/distro");
 const output_1 = __importDefault(require("../../../output"));
-const commandArtifactVersionCreate = (0, utils_1.newCommand)('create', texts_1.DESC_COMMAND_ARTIFACT_VERSION_CREATE);
+const commandArtifactVersionCreate = (0, utils_1.newCommand)('create', texts_1.DESC_COMMAND_ARTIFACT_VERSION_CREATE, {
+    requiredScopes: [utils_1.REST_API_SCOPE.ARTIFACT_WRITE],
+    examples: texts_1.EXAMPLE_ARTIFACT_VERSION_CREATE,
+});
 commandArtifactVersionCreate.alias('add');
 commandArtifactVersionCreate.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandArtifactVersionCreate.option('--scope <scope>', texts_1.OPT_COMMAND_SCOPE);
@@ -18,7 +21,7 @@ commandArtifactVersionCreate.option('--note <note>', texts_1.OPTION_ARTIFACT_VER
 commandArtifactVersionCreate.option('--agent-note <note>', texts_1.OPTION_ARTIFACT_VERSION_AGENT_NOTE);
 commandArtifactVersionCreate.option('--from <version>', texts_1.OPTION_ARTIFACT_VERSION_FROM);
 commandArtifactVersionCreate.argument('<identifier>', texts_1.OPTION_ARTIFACT_ID);
-commandArtifactVersionCreate.addHelpText('after', texts_1.EXAMPLE_ARTIFACT_VERSION_CREATE);
+commandArtifactVersionCreate.option('--format <text|json>', texts_1.OPTION_FORMAT);
 commandArtifactVersionCreate.action(async (id, options) => {
     const workspace = input_1.default.restApiWorkspace(options.workspace);
     const project = input_1.default.restApiProject(options.project, true);
@@ -62,6 +65,10 @@ commandArtifactVersionCreate.action(async (id, options) => {
         output_1.default.exitError(texts_1.ERR_ARTIFACT_VERSION_EXISTS_NO_FORCE);
     }
     const d = await client.createArtifactVersion(workspace, artifactId, version, options.note, options.agentNote, options.from);
+    if (options.format === 'json') {
+        output_1.default.json(d);
+        output_1.default.exitNormal();
+    }
     const url = d.version_url;
     output_1.default.object({
         Version: `${identifier}:${version}`,

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

@@ -8,7 +8,10 @@ const texts_1 = require("../../../texts");
 const input_1 = __importDefault(require("../../../input"));
 const output_1 = __importDefault(require("../../../output"));
 const distro_1 = require("../../../types/distro");
-const commandArtifactVersionDelete = (0, utils_1.newCommand)('delete', texts_1.DESC_COMMAND_ARTIFACT_VERSION_DELETE);
+const commandArtifactVersionDelete = (0, utils_1.newCommand)('delete', texts_1.DESC_COMMAND_ARTIFACT_VERSION_DELETE, {
+    requiredScopes: [utils_1.REST_API_SCOPE.ARTIFACT_MANAGE],
+    examples: texts_1.EXAMPLE_ARTIFACT_VERSION_DELETE,
+});
 commandArtifactVersionDelete.alias('rm');
 commandArtifactVersionDelete.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandArtifactVersionDelete.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);
@@ -16,7 +19,6 @@ commandArtifactVersionDelete.argument('<identifier>', texts_1.OPT_COMMAND_ARTIFA
 commandArtifactVersionDelete.option('--scope <scope>', texts_1.OPT_COMMAND_SCOPE);
 commandArtifactVersionDelete.option('-f, --force', texts_1.OPTION_CONFIRM_FORCE);
 commandArtifactVersionDelete.argument('<version>', texts_1.OPT_COMMAND_ARTIFACT_VERSION);
-commandArtifactVersionDelete.addHelpText('after', texts_1.EXAMPLE_ARTIFACT_VERSION_DELETE);
 commandArtifactVersionDelete.action(async (identifier, version, options) => {
     const workspace = input_1.default.restApiWorkspace(options.workspace);
     const project = input_1.default.restApiProject(options.project, true);

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

@@ -8,14 +8,16 @@ const texts_1 = require("../../../texts");
 const input_1 = __importDefault(require("../../../input"));
 const output_1 = __importDefault(require("../../../output"));
 const distro_1 = require("../../../types/distro");
-const commandArtifactVersionGet = (0, utils_1.newCommand)('get', texts_1.DESC_COMMAND_ARTIFACT_VERSION_GET);
+const commandArtifactVersionGet = (0, utils_1.newCommand)('get', texts_1.DESC_COMMAND_ARTIFACT_VERSION_GET, {
+    requiredScopes: [utils_1.REST_API_SCOPE.ARTIFACT_READ],
+    examples: texts_1.EXAMPLE_ARTIFACT_VERSION_GET,
+});
 commandArtifactVersionGet.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandArtifactVersionGet.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);
 commandArtifactVersionGet.option('--format <text|json>', texts_1.OPTION_FORMAT);
 commandArtifactVersionGet.argument('<identifier>', texts_1.OPT_COMMAND_ARTIFACT_IDENTIFIER);
 commandArtifactVersionGet.option('--scope <scope>', texts_1.OPT_COMMAND_SCOPE);
 commandArtifactVersionGet.argument('<version>', texts_1.OPT_COMMAND_ARTIFACT_VERSION);
-commandArtifactVersionGet.addHelpText('after', texts_1.EXAMPLE_ARTIFACT_VERSION_GET);
 commandArtifactVersionGet.action(async (identifier, version, options) => {
     const workspace = input_1.default.restApiWorkspace(options.workspace);
     const project = input_1.default.restApiProject(options.project, true);

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

@@ -8,7 +8,10 @@ const texts_1 = require("../../../texts");
 const input_1 = __importDefault(require("../../../input"));
 const output_1 = __importDefault(require("../../../output"));
 const distro_1 = require("../../../types/distro");
-const commandArtifactVersionList = (0, utils_1.newCommand)('list', texts_1.DESC_COMMAND_ARTIFACT_VERSION_LIST);
+const commandArtifactVersionList = (0, utils_1.newCommand)('list', texts_1.DESC_COMMAND_ARTIFACT_VERSION_LIST, {
+    requiredScopes: [utils_1.REST_API_SCOPE.ARTIFACT_READ],
+    examples: texts_1.EXAMPLE_ARTIFACT_VERSION_LIST,
+});
 commandArtifactVersionList.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandArtifactVersionList.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);
 commandArtifactVersionList.option('--page <number>', texts_1.OPTION_REST_API_PAGE, '1');
@@ -17,7 +20,6 @@ commandArtifactVersionList.option('--format <text|json>', texts_1.OPTION_FORMAT)
 commandArtifactVersionList.alias('ls');
 commandArtifactVersionList.argument('<identifier>', texts_1.OPT_COMMAND_ARTIFACT_IDENTIFIER);
 commandArtifactVersionList.option('--scope <scope>', texts_1.OPT_COMMAND_SCOPE);
-commandArtifactVersionList.addHelpText('after', texts_1.EXAMPLE_ARTIFACT_VERSION_LIST);
 commandArtifactVersionList.action(async (identifier, options) => {
     const page = input_1.default.restApiPage(options.page);
     const perPage = input_1.default.restApiPerPage(options.perPage);

package/distTs/src/command/config/get/tunnel.js

@@ -7,13 +7,18 @@ const cfg_1 = __importDefault(require("../../../tunnel/cfg"));
 const output_1 = __importDefault(require("../../../output"));
 const texts_1 = require("../../../texts");
 const utils_1 = require("../../../utils");
-const commandConfigGetTunnel = (0, utils_1.newCommand)('tunnel', texts_1.DESC_COMMAND_CONFIG_GET_TUNNEL);
+const commandConfigGetTunnel = (0, utils_1.newCommand)('tunnel', texts_1.DESC_COMMAND_CONFIG_GET_TUNNEL, { examples: texts_1.EXAMPLE_CONFIG_GET_TUNNEL });
 commandConfigGetTunnel.argument('<name>', texts_1.OPTION_NAME);
-commandConfigGetTunnel.action((name) => {
+commandConfigGetTunnel.option('--format <text|json>', texts_1.OPTION_FORMAT);
+commandConfigGetTunnel.action((name, options) => {
     if (!cfg_1.default.hasTunnel(name)) {
         output_1.default.exitError((0, texts_1.ERR_TUNNEL_NOT_FOUND)(name));
     }
-    output_1.default.configTunnel(cfg_1.default.getTunnel(name));
+    if (options.format === 'json') {
+        output_1.default.json(cfg_1.default.getTunnel(name));
+    }
+    else
+        output_1.default.configTunnel(cfg_1.default.getTunnel(name));
     output_1.default.exitNormal();
 });
 exports.default = commandConfigGetTunnel;

package/distTs/src/command/config/get/tunnels.js

@@ -7,9 +7,14 @@ const cfg_1 = __importDefault(require("../../../tunnel/cfg"));
 const output_1 = __importDefault(require("../../../output"));
 const texts_1 = require("../../../texts");
 const utils_1 = require("../../../utils");
-const commandConfigGetTunnels = (0, utils_1.newCommand)('tunnels', texts_1.DESC_COMMAND_CONFIG_GET_TUNNELS);
-commandConfigGetTunnels.action(() => {
-    output_1.default.configTunnels(cfg_1.default.getTunnels());
+const commandConfigGetTunnels = (0, utils_1.newCommand)('tunnels', texts_1.DESC_COMMAND_CONFIG_GET_TUNNELS, { examples: texts_1.EXAMPLE_CONFIG_GET_TUNNELS });
+commandConfigGetTunnels.option('--format <text|json>', texts_1.OPTION_FORMAT);
+commandConfigGetTunnels.action((options) => {
+    if (options.format === 'json') {
+        output_1.default.json(cfg_1.default.getTunnels());
+    }
+    else
+        output_1.default.configTunnels(cfg_1.default.getTunnels());
     output_1.default.exitNormal();
 });
 exports.default = commandConfigGetTunnels;

package/distTs/src/command/crawl/link.js

@@ -6,7 +6,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const utils_1 = require("../../utils");
 const texts_1 = require("../../texts");
 const output_1 = __importDefault(require("../../output"));
-const commandCrawlLink = (0, utils_1.newCommand)('link', texts_1.DESC_COMMAND_CRAWL_LINK);
+const commandCrawlLink = (0, utils_1.newCommand)('link', texts_1.DESC_COMMAND_CRAWL_LINK, {
+    examples: texts_1.EXAMPLE_CRAWL_LINK,
+});
 commandCrawlLink.option('-w, --workspace <workspace>', texts_1.OPTION_REST_API_WORKSPACE);
 commandCrawlLink.option('-p, --project <project>', texts_1.OPTION_REST_API_PROJECT);
 commandCrawlLink.option('-s, --suite <suite>', texts_1.OPTION_SUITE_IDENTIFIER);
@@ -58,5 +60,4 @@ commandCrawlLink.action(async (options) => {
     output_1.default.okSign();
     output_1.default.exitSuccess(texts_1.TXT_COMMAND_CRAWL_LINK_SUCCESS);
 });
-commandCrawlLink.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_CRAWL_LINK}`);
 exports.default = commandCrawlLink;

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

@@ -12,7 +12,9 @@ const promises_1 = require("node:stream/promises");
 const node_fs_1 = require("node:fs");
 const node_path_1 = __importDefault(require("node:path"));
 const promises_2 = require("node:fs/promises");
-const commandCrawlRun = (0, utils_1.newCommand)('run', texts_1.DESC_COMMAND_CRAWL_RUN);
+const commandCrawlRun = (0, utils_1.newCommand)('run', texts_1.DESC_COMMAND_CRAWL_RUN, {
+    examples: texts_1.EXAMPLE_CRAWL_RUN,
+});
 commandCrawlRun.argument('[url]', texts_1.OPTION_CRAWL_URL);
 commandCrawlRun.option('--follow', texts_1.OPTION_CRAWL_FOLLOW, false);
 commandCrawlRun.option('--respectRobots', texts_1.OPTION_COMPARE_RESPECT_ROBOTS, false);
@@ -144,5 +146,4 @@ async function watchSessionStatus(ctx, buildId) {
         });
     });
 }
-commandCrawlRun.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_CRAWL_RUN}`);
 exports.default = commandCrawlRun;

package/distTs/src/command/crawl.js

@@ -7,10 +7,9 @@ const utils_1 = require("../utils");
 const texts_1 = require("../texts");
 const run_1 = __importDefault(require("./crawl/run"));
 const link_1 = __importDefault(require("./crawl/link"));
-const commandCrawl = (0, utils_1.newCommand)('crawl', texts_1.DESC_COMMAND_CRAWL);
+const commandCrawl = (0, utils_1.newCommand)('crawl', texts_1.DESC_COMMAND_CRAWL, {
+    examples: [...texts_1.EXAMPLE_CRAWL_RUN, ...texts_1.EXAMPLE_CRAWL_LINK],
+});
 commandCrawl.addCommand(run_1.default);
 commandCrawl.addCommand(link_1.default);
-commandCrawl.addHelpText('after', `
-EXAMPLES:${texts_1.EXAMPLE_CRAWL_RUN}
-${texts_1.EXAMPLE_CRAWL_LINK}`);
 exports.default = commandCrawl;

package/distTs/src/command/discover.js

@@ -0,0 +1,34 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const discovery_1 = require("../discovery");
+const output_1 = __importDefault(require("../output"));
+const texts_1 = require("../texts");
+const utils_1 = require("../utils");
+const commandDiscover = (0, utils_1.newCommand)('discover', texts_1.DESC_COMMAND_DISCOVER, {
+    requiredScopes: [],
+    examples: texts_1.EXAMPLE_DISCOVER,
+    helpText: texts_1.HELP_COMMAND_DISCOVER,
+});
+commandDiscover.skipPre = true;
+commandDiscover.showSuggestionAfterError(false);
+commandDiscover.configureOutput({
+    outputError: (message) => output_1.default.json({
+        error: {
+            code: 'usage_error',
+            message: message.trim(),
+            hint: texts_1.TXT_DISCOVER_USAGE_HINT,
+        },
+    }),
+});
+commandDiscover.argument('[command...]', texts_1.OPTION_DISCOVER_COMMAND);
+commandDiscover.option('--full', texts_1.OPTION_DISCOVER_FULL);
+commandDiscover.action((path, options, command) => {
+    const result = (0, discovery_1.discoverCommands)(command.parent, path, (0, utils_1.getVersion)(), options.full);
+    output_1.default.json(result);
+    if ('error' in result)
+        process.exitCode = 1;
+});
+exports.default = commandDiscover;

package/distTs/src/command/distro/create.js

@@ -8,7 +8,10 @@ const texts_1 = require("../../texts");
 const input_1 = __importDefault(require("../../input"));
 const output_1 = __importDefault(require("../../output"));
 const distro_1 = require("../../types/distro");
-const commandDistroCreate = (0, utils_1.newCommand)('create', texts_1.DESC_COMMAND_DISTRO_CREATE);
+const commandDistroCreate = (0, utils_1.newCommand)('create', texts_1.DESC_COMMAND_DISTRO_CREATE, {
+    requiredScopes: [utils_1.REST_API_SCOPE.DISTRIBUTION_WRITE],
+    examples: texts_1.EXAMPLE_DISTRO_CREATE,
+});
 commandDistroCreate.alias('add');
 commandDistroCreate.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandDistroCreate.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);
@@ -17,7 +20,7 @@ commandDistroCreate.option('-i, --identifier <identifier>', texts_1.OPT_COMMAND_
 commandDistroCreate.option('-n, --name <name>', texts_1.OPT_COMMAND_DISTRO_NAME);
 commandDistroCreate.option('--note <note>', texts_1.OPT_COMMAND_DISTRO_NOTE);
 commandDistroCreate.option('--agent-note <note>', texts_1.OPT_COMMAND_DISTRO_AGENT_NOTE);
-commandDistroCreate.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_DISTRO_CREATE}`);
+commandDistroCreate.option('--format <text|json>', texts_1.OPTION_FORMAT);
 commandDistroCreate.action(async (options) => {
     const humanId = require('human-id').default;
     const workspace = input_1.default.restApiWorkspace(options.workspace);
@@ -41,6 +44,10 @@ commandDistroCreate.action(async (options) => {
     if (project && scope === distro_1.SCOPE.PROJECT)
         body.project_name = project;
     const result = await client.createDistro(workspace, body);
+    if (options.format === 'json') {
+        output_1.default.json(result);
+        output_1.default.exitNormal();
+    }
     output_1.default.identifier(result.identifier);
     output_1.default.cyan(result.html_url);
     output_1.default.green(texts_1.TXT_COMMAND_DISTRO_CREATED);

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

@@ -8,14 +8,16 @@ const texts_1 = require("../../texts");
 const input_1 = __importDefault(require("../../input"));
 const output_1 = __importDefault(require("../../output"));
 const distro_1 = require("../../types/distro");
-const commandDistroDelete = (0, utils_1.newCommand)('delete', texts_1.DESC_COMMAND_DISTRO_DELETE);
+const commandDistroDelete = (0, utils_1.newCommand)('delete', texts_1.DESC_COMMAND_DISTRO_DELETE, {
+    requiredScopes: [utils_1.REST_API_SCOPE.DISTRIBUTION_MANAGE],
+    examples: texts_1.EXAMPLE_DISTRO_DELETE,
+});
 commandDistroDelete.alias('rm');
 commandDistroDelete.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandDistroDelete.option('--scope <scope>', texts_1.OPT_COMMAND_SCOPE);
 commandDistroDelete.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);
 commandDistroDelete.option('-f, --force', texts_1.OPTION_CONFIRM_FORCE);
 commandDistroDelete.argument('<identifier>', texts_1.OPT_COMMAND_DISTRO_IDENTIFIER);
-commandDistroDelete.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_DISTRO_DELETE}`);
 commandDistroDelete.action(async (identifier, options) => {
     const workspace = input_1.default.restApiWorkspace(options.workspace);
     const project = input_1.default.restApiProject(options.project, true);

package/distTs/src/command/distro/get.js

@@ -8,13 +8,15 @@ const texts_1 = require("../../texts");
 const input_1 = __importDefault(require("../../input"));
 const output_1 = __importDefault(require("../../output"));
 const distro_1 = require("../../types/distro");
-const commandDistroGet = (0, utils_1.newCommand)('get', texts_1.DESC_COMMAND_DISTRO_GET);
+const commandDistroGet = (0, utils_1.newCommand)('get', texts_1.DESC_COMMAND_DISTRO_GET, {
+    requiredScopes: [utils_1.REST_API_SCOPE.DISTRIBUTION_READ],
+    examples: texts_1.EXAMPLE_DISTRO_GET,
+});
 commandDistroGet.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandDistroGet.option('--scope <scope>', texts_1.OPT_COMMAND_SCOPE);
 commandDistroGet.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);
 commandDistroGet.option('--format <text|json>', texts_1.OPTION_FORMAT);
 commandDistroGet.argument('<identifier>', texts_1.OPT_COMMAND_DISTRO_IDENTIFIER);
-commandDistroGet.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_DISTRO_GET}`);
 commandDistroGet.action(async (identifier, options) => {
     const workspace = input_1.default.restApiWorkspace(options.workspace);
     const project = input_1.default.restApiProject(options.project, true);

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

@@ -8,12 +8,14 @@ const texts_1 = require("../../texts");
 const input_1 = __importDefault(require("../../input"));
 const output_1 = __importDefault(require("../../output"));
 const distro_1 = require("../../types/distro");
-const commandDistroList = (0, utils_1.newCommand)('list', texts_1.DESC_COMMAND_DISTRO_LIST);
+const commandDistroList = (0, utils_1.newCommand)('list', texts_1.DESC_COMMAND_DISTRO_LIST, {
+    requiredScopes: [utils_1.REST_API_SCOPE.DISTRIBUTION_READ],
+    examples: texts_1.EXAMPLE_DISTRO_LIST,
+});
 commandDistroList.alias('ls');
 commandDistroList.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandDistroList.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);
 commandDistroList.option('--format <text|json>', texts_1.OPTION_FORMAT);
-commandDistroList.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_DISTRO_LIST}`);
 commandDistroList.option('--scope <scope>', texts_1.OPT_COMMAND_SCOPE);
 commandDistroList.action(async (options) => {
     const workspace = input_1.default.restApiWorkspace(options.workspace);

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

@@ -8,7 +8,10 @@ const texts_1 = require("../../../texts");
 const input_1 = __importDefault(require("../../../input"));
 const output_1 = __importDefault(require("../../../output"));
 const distro_1 = require("../../../types/distro");
-const commandDistroRouteCreate = (0, utils_1.newCommand)('create', texts_1.DESC_COMMAND_ROUTE_CREATE);
+const commandDistroRouteCreate = (0, utils_1.newCommand)('create', texts_1.DESC_COMMAND_ROUTE_CREATE, {
+    requiredScopes: [utils_1.REST_API_SCOPE.DISTRIBUTION_WRITE],
+    examples: texts_1.EXAMPLE_ROUTE_CREATE,
+});
 commandDistroRouteCreate.alias('add');
 commandDistroRouteCreate.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandDistroRouteCreate.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);
@@ -21,7 +24,7 @@ commandDistroRouteCreate.option('--note <note>', texts_1.OPT_COMMAND_ROUTE_NOTE)
 commandDistroRouteCreate.option('--agent-note <note>', texts_1.OPT_COMMAND_ROUTE_AGENT_NOTE);
 commandDistroRouteCreate.option('--target <targets...>', texts_1.OPT_COMMAND_ROUTE_TARGET);
 commandDistroRouteCreate.argument('<identifier>', texts_1.OPT_COMMAND_DISTRO_IDENTIFIER);
-commandDistroRouteCreate.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_ROUTE_CREATE}`);
+commandDistroRouteCreate.option('--format <text|json>', texts_1.OPTION_FORMAT);
 commandDistroRouteCreate.action(async (identifier, options) => {
     const workspace = input_1.default.restApiWorkspace(options.workspace);
     const project = input_1.default.restApiProject(options.project, true);
@@ -51,6 +54,10 @@ commandDistroRouteCreate.action(async (identifier, options) => {
     }
     body.targets = await input_1.default.routeTarget(client, workspace, scope === distro_1.SCOPE.PROJECT ? project : null, options.target);
     const result = await client.createRoute(workspace, scope === distro_1.SCOPE.PROJECT ? project : null, data.distribution_id, body);
+    if (options.format === 'json') {
+        output_1.default.json(result);
+        output_1.default.exitNormal();
+    }
     output_1.default.id(result.id);
     output_1.default.cyan(result.html_url);
     output_1.default.green(texts_1.TXT_COMMAND_ROUTE_CREATED);

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

@@ -8,7 +8,10 @@ const texts_1 = require("../../../texts");
 const input_1 = __importDefault(require("../../../input"));
 const output_1 = __importDefault(require("../../../output"));
 const distro_1 = require("../../../types/distro");
-const commandDistroRouteDelete = (0, utils_1.newCommand)('delete', texts_1.DESC_COMMAND_ROUTE_DELETE);
+const commandDistroRouteDelete = (0, utils_1.newCommand)('delete', texts_1.DESC_COMMAND_ROUTE_DELETE, {
+    requiredScopes: [utils_1.REST_API_SCOPE.DISTRIBUTION_MANAGE],
+    examples: texts_1.EXAMPLE_ROUTE_DELETE,
+});
 commandDistroRouteDelete.alias('rm');
 commandDistroRouteDelete.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandDistroRouteDelete.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);
@@ -16,7 +19,6 @@ commandDistroRouteDelete.option('--scope <scope>', texts_1.OPT_COMMAND_SCOPE);
 commandDistroRouteDelete.option('-f, --force', texts_1.OPTION_CONFIRM_FORCE);
 commandDistroRouteDelete.argument('<identifier>', texts_1.OPT_COMMAND_DISTRO_IDENTIFIER);
 commandDistroRouteDelete.argument('<route-id>', texts_1.OPT_COMMAND_ROUTE_ID);
-commandDistroRouteDelete.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_ROUTE_DELETE}`);
 commandDistroRouteDelete.action(async (identifier, routeId, options) => {
     const workspace = input_1.default.restApiWorkspace(options.workspace);
     const project = input_1.default.restApiProject(options.project, true);

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

@@ -17,14 +17,16 @@ const targetText = (target) => {
     }
     return target.external_url || '-';
 };
-const commandDistroRouteGet = (0, utils_1.newCommand)('get', texts_1.DESC_COMMAND_ROUTE_GET);
+const commandDistroRouteGet = (0, utils_1.newCommand)('get', texts_1.DESC_COMMAND_ROUTE_GET, {
+    requiredScopes: [utils_1.REST_API_SCOPE.DISTRIBUTION_READ],
+    examples: texts_1.EXAMPLE_ROUTE_GET,
+});
 commandDistroRouteGet.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandDistroRouteGet.option('--scope <scope>', texts_1.OPT_COMMAND_SCOPE);
 commandDistroRouteGet.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);
 commandDistroRouteGet.option('--format <text|json>', texts_1.OPTION_FORMAT);
 commandDistroRouteGet.argument('<identifier>', texts_1.OPT_COMMAND_DISTRO_IDENTIFIER);
 commandDistroRouteGet.argument('<route-id>', texts_1.OPT_COMMAND_ROUTE_ID);
-commandDistroRouteGet.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_ROUTE_GET}`);
 commandDistroRouteGet.action(async (identifier, routeId, options) => {
     const workspace = input_1.default.restApiWorkspace(options.workspace);
     const project = input_1.default.restApiProject(options.project, true);

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

@@ -8,14 +8,16 @@ const texts_1 = require("../../../texts");
 const input_1 = __importDefault(require("../../../input"));
 const output_1 = __importDefault(require("../../../output"));
 const distro_1 = require("../../../types/distro");
-const commandDistroRouteList = (0, utils_1.newCommand)('list', texts_1.DESC_COMMAND_ROUTE_LIST);
+const commandDistroRouteList = (0, utils_1.newCommand)('list', texts_1.DESC_COMMAND_ROUTE_LIST, {
+    requiredScopes: [utils_1.REST_API_SCOPE.DISTRIBUTION_READ],
+    examples: texts_1.EXAMPLE_ROUTE_LIST,
+});
 commandDistroRouteList.alias('ls');
 commandDistroRouteList.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandDistroRouteList.option('--scope <scope>', texts_1.OPT_COMMAND_SCOPE);
 commandDistroRouteList.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);
 commandDistroRouteList.option('--format <text|json>', texts_1.OPTION_FORMAT);
 commandDistroRouteList.argument('<identifier>', texts_1.OPT_COMMAND_DISTRO_IDENTIFIER);
-commandDistroRouteList.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_ROUTE_LIST}`);
 commandDistroRouteList.action(async (identifier, options) => {
     const workspace = input_1.default.restApiWorkspace(options.workspace);
     const project = input_1.default.restApiProject(options.project, true);

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

@@ -8,7 +8,10 @@ const texts_1 = require("../../../texts");
 const input_1 = __importDefault(require("../../../input"));
 const output_1 = __importDefault(require("../../../output"));
 const distro_1 = require("../../../types/distro");
-const commandDistroRouteUpdate = (0, utils_1.newCommand)('update', texts_1.DESC_COMMAND_ROUTE_UPDATE);
+const commandDistroRouteUpdate = (0, utils_1.newCommand)('update', texts_1.DESC_COMMAND_ROUTE_UPDATE, {
+    requiredScopes: [utils_1.REST_API_SCOPE.DISTRIBUTION_WRITE],
+    examples: texts_1.EXAMPLE_ROUTE_UPDATE,
+});
 commandDistroRouteUpdate.alias('edit');
 commandDistroRouteUpdate.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandDistroRouteUpdate.option('--scope <scope>', texts_1.OPT_COMMAND_SCOPE);
@@ -22,7 +25,7 @@ commandDistroRouteUpdate.option('--agent-note <note>', texts_1.OPT_COMMAND_ROUTE
 commandDistroRouteUpdate.option('--target <targets...>', texts_1.OPT_COMMAND_ROUTE_TARGET);
 commandDistroRouteUpdate.argument('<identifier>', texts_1.OPT_COMMAND_DISTRO_IDENTIFIER);
 commandDistroRouteUpdate.argument('<route-id>', texts_1.OPT_COMMAND_ROUTE_ID);
-commandDistroRouteUpdate.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_ROUTE_UPDATE}`);
+commandDistroRouteUpdate.option('--format <text|json>', texts_1.OPTION_FORMAT);
 commandDistroRouteUpdate.action(async (identifier, routeId, options) => {
     const workspace = input_1.default.restApiWorkspace(options.workspace);
     const project = input_1.default.restApiProject(options.project, true);
@@ -80,6 +83,10 @@ commandDistroRouteUpdate.action(async (identifier, routeId, options) => {
         output_1.default.exitError(texts_1.ERR_COMMAND_NO_UPDATE);
     }
     const result = await client.updateRoute(workspace, scope === distro_1.SCOPE.PROJECT ? project : null, data.distribution_id, routeId, body);
+    if (options.format === 'json') {
+        output_1.default.json(result);
+        output_1.default.exitNormal();
+    }
     output_1.default.id(result.id);
     output_1.default.cyan(result.html_url);
     output_1.default.green(texts_1.TXT_COMMAND_ROUTE_UPDATED);