bdy 1.25.2-stage → 1.25.3-dev

package/distTs/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bdy",
   "preferGlobal": false,
-  "version": "1.25.2-stage",
+  "version": "1.25.3-dev",
   "type": "commonjs",
   "license": "MIT",
   "homepage": "https://buddy.works/docs/cli",
@@ -13,24 +13,25 @@
     "lint:types": "tsc --skipLibCheck --noEmit --project tsconfig.json && tsc --skipLibCheck --project test/tsconfig.json && tsc --skipLibCheck --project e2e/tsconfig.json",
     "watch": "tsc --watch --project tsconfig.json & tsc --watch --project src/visualTest/utils/tsconfig.json",
     "buildTs": "(tsc --project tsconfig.json & tsc --project src/visualTest/utils/tsconfig.json & wait) && cp package.json distTs/package.json && cp detect-rules.json distTs/detect-rules.json && curl -fsSL https://raw.githubusercontent.com/buddy/cli/main/README.md -o README.md",
-    "e2e": "npm run buildTs && vitest run --config e2e/vitest.config.ts",
-    "e2e:version": "vitest run --config e2e/vitest.config.ts e2e/modules/version/",
-    "e2e:tunnel-config": "vitest run --config e2e/vitest.config.ts e2e/modules/tunnel-config/",
-    "e2e:auth": "vitest run --config e2e/vitest.config.ts e2e/modules/auth/",
-    "e2e:workspace": "vitest run --config e2e/vitest.config.ts e2e/modules/workspace/",
-    "e2e:project": "vitest run --config e2e/vitest.config.ts e2e/modules/project/",
-    "e2e:artifact": "vitest run --config e2e/vitest.config.ts e2e/modules/artifact/",
-    "e2e:sandbox": "vitest run --config e2e/vitest.config.ts e2e/modules/sandbox/",
-    "e2e:api": "vitest run --config e2e/vitest.config.ts e2e/modules/api/",
-    "e2e:mcp": "vitest run --config e2e/vitest.config.ts e2e/modules/mcp/",
-    "e2e:pipeline": "vitest run --config e2e/vitest.config.ts e2e/modules/pipeline/",
-    "e2e:tunnel": "vitest run --config e2e/vitest.config.ts e2e/modules/tunnel/",
-    "e2e:agent": "vitest run --config e2e/vitest.config.ts e2e/modules/agent/",
-    "e2e:distro": "vitest run --config e2e/vitest.config.ts e2e/modules/distro/",
-    "e2e:target": "vitest run --config e2e/vitest.config.ts e2e/modules/target/",
-    "e2e:environment": "vitest run --config e2e/vitest.config.ts e2e/modules/environment/",
-    "e2e:yaml": "vitest run --config e2e/vitest.config.ts e2e/modules/yaml/",
-    "unit": "vitest run --config vitest.config.ts"
+    "e2e": "npm run buildTs && vitest run --config e2e/vitest.config.mts",
+    "e2e:version": "vitest run --config e2e/vitest.config.mts e2e/modules/version/",
+    "e2e:discover": "vitest run --config e2e/vitest.discover.config.mts",
+    "e2e:tunnel-config": "vitest run --config e2e/vitest.config.mts e2e/modules/tunnel-config/",
+    "e2e:auth": "vitest run --config e2e/vitest.config.mts e2e/modules/auth/",
+    "e2e:workspace": "vitest run --config e2e/vitest.config.mts e2e/modules/workspace/",
+    "e2e:project": "vitest run --config e2e/vitest.config.mts e2e/modules/project/",
+    "e2e:artifact": "vitest run --config e2e/vitest.config.mts e2e/modules/artifact/",
+    "e2e:sandbox": "vitest run --config e2e/vitest.config.mts e2e/modules/sandbox/",
+    "e2e:api": "vitest run --config e2e/vitest.config.mts e2e/modules/api/",
+    "e2e:mcp": "vitest run --config e2e/vitest.config.mts e2e/modules/mcp/",
+    "e2e:pipeline": "vitest run --config e2e/vitest.config.mts e2e/modules/pipeline/",
+    "e2e:tunnel": "vitest run --config e2e/vitest.config.mts e2e/modules/tunnel/",
+    "e2e:agent": "vitest run --config e2e/vitest.config.mts e2e/modules/agent/",
+    "e2e:distro": "vitest run --config e2e/vitest.config.mts e2e/modules/distro/",
+    "e2e:target": "vitest run --config e2e/vitest.config.mts e2e/modules/target/",
+    "e2e:environment": "vitest run --config e2e/vitest.config.mts e2e/modules/environment/",
+    "e2e:yaml": "vitest run --config e2e/vitest.config.mts e2e/modules/yaml/",
+    "unit": "vitest run --config vitest.config.mts"
   },
   "files": [
     "distTs"

package/distTs/src/cliCommand.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+/** Command documentation shared by terminal help and machine discovery. */
+class CliCommand extends commander_1.Command {
+    agentStatus;
+    agentInstalled;
+    agentId;
+    agentStandalone;
+    currentVersion;
+    latestVersion;
+    env;
+    hideVersionUpdate;
+    agentPort;
+    skipPre = false;
+    metadata;
+    constructor(name, metadata = {}) {
+        super(name);
+        this.metadata = metadata;
+    }
+    get requiredScopes() {
+        return this.metadata.requiredScopes ?? null;
+    }
+    get examples() {
+        return this.metadata.examples ?? [];
+    }
+}
+exports.default = CliCommand;

package/distTs/src/cliIndex.js

@@ -29,8 +29,9 @@ const target_1 = __importDefault(require("./command/target"));
 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"));
 function cliIndex() {
-    const program = (0, utils_1.newCommand)('', texts_1.DESC_PROGRAM);
+    const program = (0, utils_1.newCommand)('bdy', texts_1.DESC_PROGRAM);
     program.hook('preAction', pre_1.default);
     program.configureHelp({
         formatHelp: utils_1.formatHelp,
@@ -61,6 +62,7 @@ function cliIndex() {
     program.addCommand(yaml_1.default);
     program.addCommand(api_1.default);
     program.addCommand(mcp_1.default);
+    program.addCommand(discover_1.default);
     program.action((_, cmd) => {
         if (cmd.args.length > 0) {
             output_1.default.exitError((0, texts_1.ERR_COMMAND_NOT_FOUND)(cmd.args[0]));

package/distTs/src/command/agent/tunnel/http.js

@@ -7,11 +7,12 @@ const utils_1 = require("../../../utils");
 const output_1 = __importDefault(require("../../../output"));
 const texts_1 = require("../../../texts");
 const tunnel_1 = require("../../../types/tunnel");
-const commandAgentTunnelHttp = (0, utils_1.getBasicCommandHttp)();
-commandAgentTunnelHttp.description(texts_1.DESC_COMMAND_HTTP);
+const commandAgentTunnelHttp = (0, utils_1.getBasicCommandHttp)({
+    examples: (0, texts_1.EXAMPLE_TUNNEL_HTTP)(true),
+});
+commandAgentTunnelHttp.description(texts_1.DESC_COMMAND_AGENT_TUNNEL_HTTP);
 commandAgentTunnelHttp.option('-f, --follow', texts_1.OPTION_FOLLOW);
 commandAgentTunnelHttp.argument('[protocol://host:port]', texts_1.OPTION_TARGET);
-commandAgentTunnelHttp.addHelpText('after', `\nEXAMPLES:${(0, texts_1.EXAMPLE_TUNNEL_HTTP)(true)}`);
 commandAgentTunnelHttp.action(async (target, options) => {
     const ApiAgent = require('../../../tunnel/api/agent').default;
     const AgentSocketTunnel = require('../../../agent/socket/tunnel').default;

package/distTs/src/command/agent/tunnel/list.js

@@ -6,9 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const output_1 = __importDefault(require("../../../output"));
 const texts_1 = require("../../../texts");
 const utils_1 = require("../../../utils");
-const commandAgentTunnelList = (0, utils_1.newCommand)('list', texts_1.DESC_COMMAND_AGENT_TUNNEL_LIST);
+const commandAgentTunnelList = (0, utils_1.newCommand)('list', texts_1.DESC_COMMAND_AGENT_TUNNEL_LIST, { examples: texts_1.EXAMPLE_AGENT_TUNNEL_LIST });
 commandAgentTunnelList.alias('ls');
-commandAgentTunnelList.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_AGENT_TUNNEL_LIST}`);
 commandAgentTunnelList.action(async () => {
     const ApiAgent = require('../../../tunnel/api/agent').default;
     if (!commandAgentTunnelList.agentInstalled) {

package/distTs/src/command/agent/tunnel/remove.js

@@ -6,8 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const output_1 = __importDefault(require("../../../output"));
 const texts_1 = require("../../../texts");
 const utils_1 = require("../../../utils");
-const commandAgentTunnelRemove = (0, utils_1.newCommand)('rm', texts_1.DESC_COMMAND_AGENT_TUNNEL_REMOVE);
-commandAgentTunnelRemove.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_AGENT_TUNNEL_REMOVE}`);
+const commandAgentTunnelRemove = (0, utils_1.newCommand)('rm', texts_1.DESC_COMMAND_AGENT_TUNNEL_REMOVE, { examples: texts_1.EXAMPLE_AGENT_TUNNEL_REMOVE });
 commandAgentTunnelRemove.argument('<id>', texts_1.OPTION_ID);
 commandAgentTunnelRemove.action(async (id) => {
     const ApiAgent = require('../../../tunnel/api/agent').default;

package/distTs/src/command/agent/tunnel/start.js

@@ -6,8 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const output_1 = __importDefault(require("../../../output"));
 const texts_1 = require("../../../texts");
 const utils_1 = require("../../../utils");
-const commandAgentTunnelStart = (0, utils_1.newCommand)('start', texts_1.DESC_COMMAND_START);
-commandAgentTunnelStart.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_AGENT_TUNNEL_START}`);
+const commandAgentTunnelStart = (0, utils_1.newCommand)('start', texts_1.DESC_COMMAND_AGENT_TUNNEL_START, { examples: texts_1.EXAMPLE_AGENT_TUNNEL_START });
 commandAgentTunnelStart.argument('<name>', texts_1.OPTION_NAME);
 commandAgentTunnelStart.action(async (name) => {
     const ApiAgent = require('../../../tunnel/api/agent').default;

package/distTs/src/command/agent/tunnel/status.js

@@ -6,8 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const texts_1 = require("../../../texts");
 const output_1 = __importDefault(require("../../../output"));
 const utils_1 = require("../../../utils");
-const commandAgentTunnelStatus = (0, utils_1.newCommand)('status', texts_1.DESC_COMMAND_AGENT_TUNNEL_STATUS);
-commandAgentTunnelStatus.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_AGENT_TUNNEL_STATUS}`);
+const commandAgentTunnelStatus = (0, utils_1.newCommand)('status', texts_1.DESC_COMMAND_AGENT_TUNNEL_STATUS, { examples: texts_1.EXAMPLE_AGENT_TUNNEL_STATUS });
 commandAgentTunnelStatus.argument('[id]', texts_1.OPTION_ID);
 commandAgentTunnelStatus.action(async (id) => {
     const ApiAgent = require('../../../tunnel/api/agent').default;

package/distTs/src/command/agent/tunnel/tcp.js

@@ -7,11 +7,12 @@ const utils_1 = require("../../../utils");
 const output_1 = __importDefault(require("../../../output"));
 const texts_1 = require("../../../texts");
 const tunnel_1 = require("../../../types/tunnel");
-const commandAgentTunnelTcp = (0, utils_1.getBasicCommandTcp)();
-commandAgentTunnelTcp.description(texts_1.DESC_COMMAND_TCP);
+const commandAgentTunnelTcp = (0, utils_1.getBasicCommandTcp)({
+    examples: (0, texts_1.EXAMPLE_TUNNEL_TCP)(true),
+});
+commandAgentTunnelTcp.description(texts_1.DESC_COMMAND_AGENT_TUNNEL_TCP);
 commandAgentTunnelTcp.option('-f, --follow', texts_1.OPTION_FOLLOW);
 commandAgentTunnelTcp.argument('[host:port]', texts_1.OPTION_TARGET);
-commandAgentTunnelTcp.addHelpText('after', `\nEXAMPLES:${(0, texts_1.EXAMPLE_TUNNEL_TCP)(true)}`);
 commandAgentTunnelTcp.action(async (target, options) => {
     const ApiAgent = require('../../../tunnel/api/agent').default;
     const AgentSocketTunnel = require('../../../agent/socket/tunnel').default;

package/distTs/src/command/agent/tunnel/tls.js

@@ -7,11 +7,12 @@ const utils_1 = require("../../../utils");
 const output_1 = __importDefault(require("../../../output"));
 const texts_1 = require("../../../texts");
 const tunnel_1 = require("../../../types/tunnel");
-const commandAgentTunnelTls = (0, utils_1.getBasicCommandTls)();
-commandAgentTunnelTls.description(texts_1.DESC_COMMAND_TLS);
+const commandAgentTunnelTls = (0, utils_1.getBasicCommandTls)({
+    examples: (0, texts_1.EXAMPLE_TUNNEL_TLS)(true),
+});
+commandAgentTunnelTls.description(texts_1.DESC_COMMAND_AGENT_TUNNEL_TLS);
 commandAgentTunnelTls.option('-f, --follow', texts_1.OPTION_FOLLOW);
 commandAgentTunnelTls.argument('[host:port]', texts_1.OPTION_TARGET);
-commandAgentTunnelTls.addHelpText('after', `\nEXAMPLES:${(0, texts_1.EXAMPLE_TUNNEL_TLS)(true)}`);
 commandAgentTunnelTls.action(async (target, options) => {
     const ApiAgent = require('../../../tunnel/api/agent').default;
     const AgentSocketTunnel = require('../../../agent/socket/tunnel').default;

package/distTs/src/command/agent/tunnel.js

@@ -14,7 +14,17 @@ const status_1 = __importDefault(require("./tunnel/status"));
 const utils_1 = require("../../utils");
 const enable_1 = __importDefault(require("./tunnel/enable"));
 const disable_1 = __importDefault(require("./tunnel/disable"));
-const commandAgentTunnel = (0, utils_1.newCommand)('tunnel', texts_1.DESC_COMMAND_AGENT_TUNNEL);
+const commandAgentTunnel = (0, utils_1.newCommand)('tunnel', texts_1.DESC_COMMAND_AGENT_TUNNEL, {
+    examples: [
+        ...(0, texts_1.EXAMPLE_TUNNEL_HTTP)(true),
+        ...(0, texts_1.EXAMPLE_TUNNEL_TLS)(true),
+        ...(0, texts_1.EXAMPLE_TUNNEL_TCP)(true),
+        ...texts_1.EXAMPLE_AGENT_TUNNEL_START,
+        ...texts_1.EXAMPLE_AGENT_TUNNEL_LIST,
+        ...texts_1.EXAMPLE_AGENT_TUNNEL_STATUS,
+        ...texts_1.EXAMPLE_AGENT_TUNNEL_REMOVE,
+    ],
+});
 commandAgentTunnel.addCommand(tcp_1.default);
 commandAgentTunnel.addCommand(tls_1.default);
 commandAgentTunnel.addCommand(http_1.default);
@@ -24,11 +34,4 @@ commandAgentTunnel.addCommand(list_1.default);
 commandAgentTunnel.addCommand(status_1.default);
 commandAgentTunnel.addCommand(enable_1.default);
 commandAgentTunnel.addCommand(disable_1.default);
-commandAgentTunnel.addHelpText('after', `\nEXAMPLES:${(0, texts_1.EXAMPLE_TUNNEL_HTTP)(true)}
-${(0, texts_1.EXAMPLE_TUNNEL_TLS)(true)}
-${(0, texts_1.EXAMPLE_TUNNEL_TCP)(true)}
-${texts_1.EXAMPLE_AGENT_TUNNEL_START}
-${texts_1.EXAMPLE_AGENT_TUNNEL_LIST}
-${texts_1.EXAMPLE_AGENT_TUNNEL_STATUS}
-${texts_1.EXAMPLE_AGENT_TUNNEL_REMOVE}`);
 exports.default = commandAgentTunnel;

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

@@ -12,7 +12,10 @@ const logger_1 = __importDefault(require("../../../logger"));
 const fs_1 = __importDefault(require("fs"));
 const path_1 = require("path");
 const uuid_1 = require("uuid");
-const commandArtifactComposerPublish = (0, utils_1.newCommand)('publish', texts_1.DESC_COMMAND_ARTIFACT_COMPOSER_PUBLISH);
+const commandArtifactComposerPublish = (0, utils_1.newCommand)('publish', texts_1.DESC_COMMAND_ARTIFACT_COMPOSER_PUBLISH, {
+    requiredScopes: [utils_1.REST_API_SCOPE.ARTIFACT_WRITE],
+    examples: texts_1.EXAMPLE_ARTIFACT_COMPOSER_PUBLISH,
+});
 commandArtifactComposerPublish.alias('pub');
 commandArtifactComposerPublish.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandArtifactComposerPublish.option('--scope <scope>', texts_1.OPT_COMMAND_SCOPE);
@@ -23,7 +26,6 @@ commandArtifactComposerPublish.option('--agent-note <note>', texts_1.OPTION_ARTI
 commandArtifactComposerPublish.option('--ignore <patterns>', texts_1.OPTION_ARTIFACT_IGNORE);
 commandArtifactComposerPublish.argument('<identifier>', texts_1.OPTION_ARTIFACT_ID);
 commandArtifactComposerPublish.argument('<directory>', texts_1.OPTION_ARTIFACT_COMPOSE_PUBLISH_PATH);
-commandArtifactComposerPublish.addHelpText('after', texts_1.EXAMPLE_ARTIFACT_COMPOSER_PUBLISH);
 commandArtifactComposerPublish.action(async (id, path, options) => {
     const dirPath = input_1.default.resolvePath(path);
     if (!fs_1.default.statSync(dirPath).isDirectory()) {

package/distTs/src/command/artifact/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 commandArtifactCreate = (0, utils_1.newCommand)('create', texts_1.DESC_COMMAND_ARTIFACT_CREATE);
+const commandArtifactCreate = (0, utils_1.newCommand)('create', texts_1.DESC_COMMAND_ARTIFACT_CREATE, {
+    requiredScopes: [utils_1.REST_API_SCOPE.ARTIFACT_WRITE],
+    examples: texts_1.EXAMPLE_ARTIFACT_CREATE,
+});
 commandArtifactCreate.alias('add');
 commandArtifactCreate.option('-i, --identifier <identifier>', texts_1.OPT_COMMAND_ARTIFACT_CREATE_IDENTIFIER);
 commandArtifactCreate.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
@@ -20,7 +23,6 @@ commandArtifactCreate.option('-a, --auth <user:pass>', texts_1.OPTION_HTTP_AUTH)
 commandArtifactCreate.option('--note <note>', texts_1.OPT_COMMAND_NOTE);
 commandArtifactCreate.option('--agent-note <note>', texts_1.OPT_COMMAND_AGENT_NOTE);
 commandArtifactCreate.argument('[name]', texts_1.OPT_COMMAND_ARTIFACT_NAME);
-commandArtifactCreate.addHelpText('after', texts_1.EXAMPLE_ARTIFACT_CREATE);
 commandArtifactCreate.action(async (name, options) => {
     const humanId = require('human-id').default;
     const workspace = input_1.default.restApiWorkspace(options.workspace);

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,7 +25,6 @@ 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.action(async (id, path, options) => {
     const { v4 } = require('uuid');
     let dirPath = input_1.default.resolvePath(path);

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,6 @@ 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.action(async (id, options) => {
     const workspace = input_1.default.restApiWorkspace(options.workspace);
     const project = input_1.default.restApiProject(options.project, true);

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/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,6 @@ 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.action(async (options) => {
     const humanId = require('human-id').default;
     const workspace = input_1.default.restApiWorkspace(options.workspace);

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