bdy 1.22.47-dev → 1.22.48-dev

package/distTs/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bdy",
   "preferGlobal": false,
-  "version": "1.22.47-dev",
+  "version": "1.22.48-dev",
   "type": "commonjs",
   "license": "MIT",
   "scripts": {

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

@@ -58,4 +58,5 @@ 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

@@ -144,4 +144,5 @@ async function watchSessionStatus(ctx, buildId) {
         });
     });
 }
+commandCrawlRun.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_CRAWL_RUN}`);
 exports.default = commandCrawlRun;

package/distTs/src/command/crawl.js

@@ -10,4 +10,7 @@ const link_1 = __importDefault(require("./crawl/link"));
 const commandCrawl = (0, utils_1.newCommand)('crawl', texts_1.DESC_COMMAND_CRAWL);
 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/tests/capture.js

@@ -100,4 +100,5 @@ function filterDuplicates(urls) {
         duplicates: Array.from(duplicates),
     };
 }
+commandCapture.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_TESTS_CAPTURE}`);
 exports.default = commandCapture;

package/distTs/src/command/tests/unit/link.js

@@ -58,4 +58,5 @@ commandUtLink.action(async (options) => {
     output_1.default.okSign();
     output_1.default.exitSuccess(texts_1.TXT_COMMAND_UT_LINK_SUCCESS);
 });
+commandUtLink.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_TESTS_UNIT_LINK}`);
 exports.default = commandUtLink;

package/distTs/src/command/tests/unit/upload.js

@@ -42,6 +42,7 @@ commandUtUpload.action(async (input, options) => {
     await sendUploadRequest(ctx, files);
     output_1.default.exitSuccess('Upload completed');
 });
+commandUtUpload.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_TESTS_UNIT_UPLOAD}`);
 exports.default = commandUtUpload;
 function validateInputAndOptions(input, options) {
     const z = require('zod');

package/distTs/src/command/tests/unit.js

@@ -10,4 +10,7 @@ const link_1 = __importDefault(require("./unit/link"));
 const commandUnit = (0, utils_1.newCommand)('unit', texts_1.DESC_COMMAND_UNIT);
 commandUnit.addCommand(upload_1.default);
 commandUnit.addCommand(link_1.default);
+commandUnit.addHelpText('after', `
+EXAMPLES:${texts_1.EXAMPLE_TESTS_UNIT_UPLOAD}
+${texts_1.EXAMPLE_TESTS_UNIT_LINK}`);
 exports.default = commandUnit;

package/distTs/src/command/tests/visual/link.js

@@ -58,4 +58,5 @@ commandVisualLink.action(async (options) => {
     output_1.default.okSign();
     output_1.default.exitSuccess(texts_1.TXT_COMMAND_VT_LINK_SUCCESS);
 });
+commandVisualLink.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_TESTS_VISUAL_LINK}`);
 exports.default = commandVisualLink;

package/distTs/src/command/tests/visual/session/close.js

@@ -29,4 +29,5 @@ commandSessionClose.action(async () => {
         output_1.default.exitError(`${error}`);
     }
 });
+commandSessionClose.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_TESTS_VISUAL_SESSION_CLOSE}`);
 exports.default = commandSessionClose;

package/distTs/src/command/tests/visual/session/create.js

@@ -82,4 +82,5 @@ commandSessionCreate.action(async (command, options) => {
         output_1.default.exitError(`${error}`);
     }
 });
+commandSessionCreate.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_TESTS_VISUAL_SESSION_CREATE}`);
 exports.default = commandSessionCreate;

package/distTs/src/command/tests/visual/session.js

@@ -10,4 +10,7 @@ const close_1 = __importDefault(require("./session/close"));
 const commandSession = (0, utils_1.newCommand)('session', texts_1.DESC_COMMAND_SESSION);
 commandSession.addCommand(create_1.default);
 commandSession.addCommand(close_1.default);
+commandSession.addHelpText('after', `
+EXAMPLES:${texts_1.EXAMPLE_TESTS_VISUAL_SESSION_CREATE}
+${texts_1.EXAMPLE_TESTS_VISUAL_SESSION_CLOSE}`);
 exports.default = commandSession;

package/distTs/src/command/tests/visual/setup.js

@@ -17,4 +17,5 @@ commandVisualSetup.action(async () => {
         output_1.default.exitError(`${error}`);
     }
 });
+commandVisualSetup.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_TESTS_VISUAL_SETUP}`);
 exports.default = commandVisualSetup;

package/distTs/src/command/tests/visual/upload.js

@@ -138,4 +138,5 @@ function getStorybookSnapshots(storiesList) {
     output_1.default.normal((0, texts_1.TXT_STORIES_AMOUNT)(stories.length));
     return stories;
 }
+commandVisualUpload.addHelpText('after', `\nEXAMPLES:${texts_1.EXAMPLE_TESTS_VISUAL_UPLOAD}`);
 exports.default = commandVisualUpload;

package/distTs/src/command/tests/visual.js

@@ -14,4 +14,10 @@ commandVisual.addCommand(setup_1.default);
 commandVisual.addCommand(upload_1.default);
 commandVisual.addCommand(session_1.default);
 commandVisual.addCommand(link_1.default);
+commandVisual.addHelpText('after', `
+EXAMPLES:${texts_1.EXAMPLE_TESTS_VISUAL_SETUP}
+${texts_1.EXAMPLE_TESTS_VISUAL_UPLOAD}
+${texts_1.EXAMPLE_TESTS_VISUAL_LINK}
+${texts_1.EXAMPLE_TESTS_VISUAL_SESSION_CREATE}
+${texts_1.EXAMPLE_TESTS_VISUAL_SESSION_CLOSE}`);
 exports.default = commandVisual;

package/distTs/src/command/tests.js

@@ -12,4 +12,13 @@ const commandTests = (0, utils_1.newCommand)('tests', texts_1.DESC_COMMAND_TESTS
 commandTests.addCommand(unit_1.default);
 commandTests.addCommand(visual_1.default);
 commandTests.addCommand(capture_1.default);
+commandTests.addHelpText('after', `
+EXAMPLES:${texts_1.EXAMPLE_TESTS_UNIT_UPLOAD}
+${texts_1.EXAMPLE_TESTS_UNIT_LINK}
+${texts_1.EXAMPLE_TESTS_VISUAL_SETUP}
+${texts_1.EXAMPLE_TESTS_VISUAL_UPLOAD}
+${texts_1.EXAMPLE_TESTS_VISUAL_LINK}
+${texts_1.EXAMPLE_TESTS_VISUAL_SESSION_CREATE}
+${texts_1.EXAMPLE_TESTS_VISUAL_SESSION_CLOSE}
+${texts_1.EXAMPLE_TESTS_CAPTURE}`);
 exports.default = commandTests;

package/distTs/src/texts.js

@@ -16,7 +16,7 @@ exports.DESC_COMMAND_LOGIN = exports.ERR_API_MEDIA_TYPE_NOT_IMPLEMENTED = export
 exports.ERR_COMMAND_ROUTE_NO_UPDATE = exports.ERR_COMMAND_DISTRO_NOT_FOUND = exports.ERR_COMMAND_DISTRO_SCOPE = exports.TXT_COMMAND_ROUTE_UPDATED = exports.TXT_ROUTE_SERVE = exports.TXT_COMMAND_ROUTE_CREATED = exports.TXT_COMMAND_DISTRO_CREATED = exports.ERR_COMMAND_DISTRO_NO_PROJECT = exports.OPT_COMMAND_DISTRO_NAME = exports.OPT_COMMAND_ROUTE_TARGET = exports.OPT_COMMAND_ROUTE_PATH = exports.OPT_COMMAND_ROUTE_DOMAIN = exports.OPT_COMMAND_ROUTE_SUBDOMAIN = exports.OPT_COMMAND_ROUTE_TYPE = exports.OPT_COMMAND_ROUTE_ID = exports.OPT_COMMAND_DISTRO_IDENTIFIER = exports.OPT_COMMAND_DISTRO_SCOPE = exports.DESC_COMMAND_ROUTE = exports.DESC_COMMAND_ROUTE_UPDATE = exports.DESC_COMMAND_ROUTE_DELETE = exports.DESC_COMMAND_ROUTE_LIST = exports.DESC_COMMAND_DISTRO_LIST = exports.DESC_COMMAND_DISTRO_DELETE = exports.DESC_COMMAND_ROUTE_CREATE = exports.DESC_COMMAND_DISTRO_CREATE = exports.DESC_COMMAND_DISTRO = exports.ERR_API_MESSAGE_REPLACER = exports.ERR_LOGIN_INVALID_BASE_URL = exports.ERR_LOGIN_NO_WORKSPACE_FOUND = exports.ERR_LOGIN_NO_WORKSPACES = exports.ERR_LOGIN_HTTP_CANCEL = exports.ERR_LOGIN_HTTP_FAILED = exports.ERR_LOGIN_HTTP_SERVER_PORT_TAKEN = exports.TXT_LOGIN_SUCCESS = exports.TXT_LOGIN_SELECT_WORKSPACE = exports.TXT_LOGIN_ENTER_BASE_URL = exports.TXT_LOGIN_PROVIDE_CODE = exports.TXT_LOGIN_OPEN_URL = exports.TXT_LOGIN_OPENING_STAR = exports.TXT_LOGIN_OPENING = exports.TXT_LOGIN_SELECT_REGION = exports.TXT_WORKSPACE_NONE = exports.TXT_WORKSPACE_SET_SUCCESS = exports.ARG_COMMAND_WORKSPACE = exports.DESC_COMMAND_WORKSPACE_GET = exports.DESC_COMMAND_WORKSPACE_SET = exports.DESC_COMMAND_WORKSPACE_LIST = exports.DESC_COMMAND_WORKSPACE = exports.TXT_LOGOUT_SUCCESS = exports.DESC_COMMAND_LOGOUT = void 0;
 exports.TXT_ARTIFACT_CREATED = exports.TXT_ARTIFACT_VERSION_DELETED = exports.TXT_ARTIFACT_DELETED = exports.ERR_COMMAND_ARTIFACT_TYPE = exports.OPT_COMMAND_ARTIFACT_VERSION = exports.OPT_COMMAND_ARTIFACT_IDENTIFIER = exports.OPT_COMMAND_ARTIFACT_CREATE_IDENTIFIER = exports.OPT_COMMAND_ARTIFACT_NAME = exports.OPT_COMMAND_ARTIFACT_TYPE = exports.DESC_COMMAND_ARTIFACT_CREATE = exports.DESC_COMMAND_ARTIFACT_GET = exports.TXT_ARTIFACT_DOCKER_LOGIN_FAILED = exports.TXT_ARTIFACT_DOCKER_LOGIN_SUCCESS = exports.TXT_ARTIFACT_VERSION_DELETE_CONFIRM = exports.TXT_ARTIFACT_DELETE_CONFIRM = exports.DESC_COMMAND_ARTIFACT_DELETE = exports.ERR_COMMAND_ARTIFACT_NO_PROJECTS = exports.DESC_COMMAND_ARTIFACT_VERSION_GET = exports.DESC_COMMAND_ARTIFACT_VERSION_LIST = exports.DESC_COMMAND_ARTIFACT_VERSION_DELETE = exports.DESC_COMMAND_ARTIFACT_DOCKER_LOGIN = exports.DESC_COMMAND_ARTIFACT_LIST = exports.DESC_COMMAND_ARTIFACT_VERSION = exports.ERR_COMMAND_DOMAIN_UNAVAILABLE = exports.OPTION_COMMAND_DOMAIN_IDENTIFIER = exports.ERR_COMMAND_DOMAIN_NO_DOMAINS = exports.TXT_COMMAND_DOMAIN_PROMPT_REQUIRED = exports.TXT_COMMAND_DOMAIN_BUY_SELECT_DOMAIN = exports.TXT_COMMAND_DOMAIN_PROVIDE_PROMPT = exports.ERR_COMMAND_DOMAIN_NOT_FOUND = exports.OPT_COMMAND_DOMAIN_ONLY_AVAILABLE = exports.OPT_COMMAND_DOMAIN_SORT = exports.OPT_COMMAND_DOMAIN_PHRASE = exports.OPT_COMMAND_DOMAIN_BUY_OWNER = exports.OPT_COMMAND_DOMAIN_BUY_TLD = exports.DESC_COMMAND_DOMAIN_GET = exports.DESC_COMMAND_DOMAIN_LIST = exports.DESC_COMMAND_DOMAIN_SEARCH = exports.DESC_COMMAND_DOMAIN_BUY = exports.DESC_COMMAND_DOMAIN = exports.ERR_ROUTE_NO_DEFAULT = exports.ERR_WRONG_ROUTE_TARGET = exports.ERR_COMMAND_ROUTE_NO_TARGET = exports.ERR_COMMAND_ROUTE_TYPE = exports.TXT_COMMAND_ROUTES_NOT_FOUND = exports.TXT_COMMAND_DISTROS_NOT_FOUND = exports.TXT_COMMAND_ROUTE_DELETED = exports.TXT_COMMAND_DISTRO_DELETED = exports.TXT_COMMAND_ROUTE_DELETE_CONFIRM = exports.TXT_COMMAND_DISTRO_DELETE_CONFIRM = void 0;
 exports.EXAMPLE_SANDBOX_APP_LIST = exports.EXAMPLE_SANDBOX_EXEC_KILL = exports.EXAMPLE_SANDBOX_EXEC_COMMAND = exports.EXAMPLE_TUNNEL_START = exports.EXAMPLE_TUNNEL_TCP = exports.EXAMPLE_TUNNEL_TLS = exports.EXAMPLE_AGENT_TUNNEL_START = exports.EXAMPLE_AGENT_TUNNEL_STATUS = exports.EXAMPLE_AGENT_TUNNEL_REMOVE = exports.EXAMPLE_AGENT_TUNNEL_LIST = exports.EXAMPLE_TUNNEL_HTTP = exports.EXAMPLE_SANDBOX_CREATE = exports.EXAMPLE_DISTRO_CREATE = exports.EXAMPLE_ROUTE_CREATE = exports.EXAMPLE_ROUTE_LIST = exports.EXAMPLE_ROUTE_UPDATE = exports.EXAMPLE_ROUTE_DELETE = exports.EXAMPLE_DISTRO_DELETE = exports.EXAMPLE_DISTRO_LIST = exports.EXAMPLE_SANDBOX_CP = exports.ERR_PROJECT_NO_PROJECTS = exports.TXT_LOGIN_SELECT_PROJECT = exports.TXT_COMMAND_PROJECT_CREATED = exports.TXT_COMMAND_PROJECT_LINK_NOT_FOUND = exports.TXT_COMMAND_PROJECT_LINK_NAME = exports.TXT_COMMAND_PROJECT_LINK_SELECT_PROJECT = exports.TXT_COMMAND_PROJECT_LINK_TO = exports.TXT_COMMAND_PROJECT_LINK_EXISTING_DESC = exports.TXT_COMMAND_PROJECT_LINK_EXISTING = exports.TXT_COMMAND_PROJECT_LINK_CREATE_NEW_DESC = exports.TXT_COMMAND_PROJECT_LINK_CREATE_NEW = exports.ERR_COMMAND_PROJECT_LINK_DIR_NOT_DIR = exports.TXT_COMMAND_PROJECT_LINK_GIT_REPO_INITIALIZED = exports.TXT_COMMAND_PROJECT_LINK_GIT_REPO = exports.TXT_COMMAND_PROJECT_LINK_DIR_CONFIRM = exports.TXT_COMMAND_PROJECT_LINK_DIR_LINKED = exports.ERR_COMMAND_PROJECT_LINK_DIR_CREATE = exports.OPT_COMMAND_PROJECT_LINK_TRY_NOW = exports.OPT_COMMAND_PROJECT_LINK_SET_GIT_REMOTE = exports.OPT_COMMAND_PROJECT_LINK_HAS_REMOTE = exports.OPT_COMMAND_PROJECT_LINK_DIRECTORY = exports.OPT_COMMAND_PROJECT_LINK_GIT = exports.OPT_COMMAND_PROJECT_LINK_RELINK = exports.DESC_COMMAND_PROJECT_LINK = exports.DESC_COMMAND_PROJECT_LIST = exports.DESC_COMMAND_PROJECT_GIT = exports.DESC_COMMAND_PROJECT_GIT_CREDENTIAL = exports.DESC_COMMAND_PROJECT = exports.TXT_ARTIFACT_VERSION_DOWNLOAD = exports.TXT_ARTIFACT_PUBLISH = void 0;
-exports.EXAMPLE_ARTIFACT_VERSION_DELETE = exports.EXAMPLE_ARTIFACT_VERSION_GET = exports.EXAMPLE_ARTIFACT_VERSION_LIST = exports.EXAMPLE_ARTIFACT_CREATE = exports.EXAMPLE_ARTIFACT_DELETE = exports.EXAMPLE_ARTIFACT_DOWNLOAD = exports.EXAMPLE_ARTIFACT_PUBLISH = exports.EXAMPLE_PIPELINE_RUN_RETRY = exports.EXAMPLE_PIPELINE_RUN_LIST = exports.EXAMPLE_PIPELINE_LIST = exports.EXAMPLE_PIPELINE_YML = exports.EXAMPLE_PIPELINE_GET = exports.EXAMPLE_PIPELINE_UPDATE = exports.EXAMPLE_PIPELINE_DELETE = exports.EXAMPLE_PIPELINE_CREATE = exports.EXAMPLE_PIPELINE_RUN_CANCEL = exports.EXAMPLE_PIPELINE_RUN_APPLY = exports.EXAMPLE_PIPELINE_RUN_LOGS = exports.EXAMPLE_PIPELINE_RUN_JSONL = exports.EXAMPLE_PIPELINE_RUN_STATUS = exports.EXAMPLE_PIPELINE_RUN_START = exports.EXAMPLE_SANDBOX_ENDPOINT_LIST = exports.EXAMPLE_SANDBOX_ENDPOINT_GET = exports.EXAMPLE_SANDBOX_ENDPOINT_DELETE = exports.EXAMPLE_SANDBOX_ENDPOINT_CREATE = exports.EXAMPLE_SANDBOX_SNAPSHOT_LIST = exports.EXAMPLE_SANDBOX_SNAPSHOT_GET = exports.EXAMPLE_SANDBOX_SNAPSHOT_DELETE = exports.EXAMPLE_SANDBOX_SNAPSHOT_CREATE = exports.EXAMPLE_SANDBOX_EXEC_STATUS = exports.EXAMPLE_SANDBOX_EXEC_LOGS = exports.EXAMPLE_SANDBOX_APP_STATUS = exports.EXAMPLE_SANDBOX_APP_STOP = exports.EXAMPLE_SANDBOX_APP_REMOVE = exports.EXAMPLE_SANDBOX_APP_ADD = exports.EXAMPLE_SANDBOX_APP_START = exports.EXAMPLE_SANDBOX_APP_LOGS = exports.EXAMPLE_SANDBOX_EXEC_LIST = void 0;
+exports.EXAMPLE_CRAWL_LINK = exports.EXAMPLE_CRAWL_RUN = exports.EXAMPLE_TESTS_CAPTURE = exports.EXAMPLE_TESTS_VISUAL_SESSION_CLOSE = exports.EXAMPLE_TESTS_VISUAL_SESSION_CREATE = exports.EXAMPLE_TESTS_VISUAL_LINK = exports.EXAMPLE_TESTS_VISUAL_UPLOAD = exports.EXAMPLE_TESTS_VISUAL_SETUP = exports.EXAMPLE_TESTS_UNIT_LINK = exports.EXAMPLE_TESTS_UNIT_UPLOAD = exports.EXAMPLE_ARTIFACT_VERSION_DELETE = exports.EXAMPLE_ARTIFACT_VERSION_GET = exports.EXAMPLE_ARTIFACT_VERSION_LIST = exports.EXAMPLE_ARTIFACT_CREATE = exports.EXAMPLE_ARTIFACT_DELETE = exports.EXAMPLE_ARTIFACT_DOWNLOAD = exports.EXAMPLE_ARTIFACT_PUBLISH = exports.EXAMPLE_PIPELINE_RUN_RETRY = exports.EXAMPLE_PIPELINE_RUN_LIST = exports.EXAMPLE_PIPELINE_LIST = exports.EXAMPLE_PIPELINE_YML = exports.EXAMPLE_PIPELINE_GET = exports.EXAMPLE_PIPELINE_UPDATE = exports.EXAMPLE_PIPELINE_DELETE = exports.EXAMPLE_PIPELINE_CREATE = exports.EXAMPLE_PIPELINE_RUN_CANCEL = exports.EXAMPLE_PIPELINE_RUN_APPLY = exports.EXAMPLE_PIPELINE_RUN_LOGS = exports.EXAMPLE_PIPELINE_RUN_JSONL = exports.EXAMPLE_PIPELINE_RUN_STATUS = exports.EXAMPLE_PIPELINE_RUN_START = exports.EXAMPLE_SANDBOX_ENDPOINT_LIST = exports.EXAMPLE_SANDBOX_ENDPOINT_GET = exports.EXAMPLE_SANDBOX_ENDPOINT_DELETE = exports.EXAMPLE_SANDBOX_ENDPOINT_CREATE = exports.EXAMPLE_SANDBOX_SNAPSHOT_LIST = exports.EXAMPLE_SANDBOX_SNAPSHOT_GET = exports.EXAMPLE_SANDBOX_SNAPSHOT_DELETE = exports.EXAMPLE_SANDBOX_SNAPSHOT_CREATE = exports.EXAMPLE_SANDBOX_EXEC_STATUS = exports.EXAMPLE_SANDBOX_EXEC_LOGS = exports.EXAMPLE_SANDBOX_APP_STATUS = exports.EXAMPLE_SANDBOX_APP_STOP = exports.EXAMPLE_SANDBOX_APP_REMOVE = exports.EXAMPLE_SANDBOX_APP_ADD = exports.EXAMPLE_SANDBOX_APP_START = exports.EXAMPLE_SANDBOX_APP_LOGS = exports.EXAMPLE_SANDBOX_EXEC_LIST = void 0;
 const utils_1 = require("./utils");
 exports.ERR_CANCELLED = 'Cancelled';
 exports.ERR_REST_API_GENERAL_ERROR = 'Something went wrong';
@@ -297,21 +297,21 @@ exports.DESC_COMMAND_PIPELINE_DELETE = 'Pipeline delete. Required scopes: EXECUT
 exports.DESC_COMMAND_PIPELINE_UPDATE = 'Pipeline update. Required scopes: EXECUTION_RUN';
 exports.DESC_COMMAND_PIPELINE_GET = 'Pipeline info. Required scopes: EXECUTION_INFO';
 exports.DESC_COMMAND_PIPELINE_RUN_RETRY = 'Pipeline run retry. Required scopes: EXECUTION_RUN';
-exports.DESC_COMMAND_TESTS = 'Commands to interact with the test services';
-exports.DESC_COMMAND_UNIT = 'Commands to interact with the unit test service';
-exports.DESC_COMMAND_VISUAL = 'Commands to interact with the visual test service';
+exports.DESC_COMMAND_TESTS = 'Manage unit tests and visual regression (Storybook, URL captures, test runners)';
+exports.DESC_COMMAND_UNIT = 'Manage unit testing (JUnit XML report uploads, suite linking)';
+exports.DESC_COMMAND_VISUAL = 'Manage visual regression testing across Storybook, URL captures, and test runners';
 exports.DESC_COMMAND_SESSION = 'Manage visual test sessions';
-exports.DESC_COMMAND_SESSION_CREATE = 'Run tests which use visual service plugin';
-exports.DESC_COMMAND_SESSION_CLOSE = 'Close visual test session';
-exports.DESC_COMMAND_VISUAL_SETUP = 'Install browser for visual test';
-exports.DESC_COMMAND_VISUAL_UPLOAD = 'Create visual test session from storybook';
-exports.DESC_COMMAND_CAPTURE = 'Create visual test session for specific set of urls';
-exports.DESC_COMMAND_CRAWL = 'Commands to interact with the crawl service';
-exports.DESC_COMMAND_CRAWL_RUN = 'Run a crawl session';
+exports.DESC_COMMAND_SESSION_CREATE = 'Run a test command and create a visual test session from emitted snapshots';
+exports.DESC_COMMAND_SESSION_CLOSE = 'Close a parallel visual test session early (skip auto-close timeout)';
+exports.DESC_COMMAND_VISUAL_SETUP = 'Install the resource-discovery browser used by `bdy tests visual session create`';
+exports.DESC_COMMAND_VISUAL_UPLOAD = 'Upload a built Storybook to create a visual test session';
+exports.DESC_COMMAND_CAPTURE = 'Create a visual test session from an explicit URL list, a URLs file, or a sitemap';
+exports.DESC_COMMAND_CRAWL = 'Manage web crawls (Markdown, HTML, PNG/JPEG screenshots; suite linking)';
+exports.DESC_COMMAND_CRAWL_RUN = 'Crawl a URL and download the package (PNG/JPEG/MD/HTML) to --outputDir';
 exports.DESC_COMMAND_UT_UPLOAD = 'Upload unit test reports';
-exports.DESC_COMMAND_VT_LINK = 'Link directory with a visual test suite';
-exports.DESC_COMMAND_CRAWL_LINK = 'Link directory with a crawl suite';
-exports.DESC_COMMAND_UT_LINK = 'Link directory with a unit test suite';
+exports.DESC_COMMAND_VT_LINK = 'Link current directory to a visual test suite';
+exports.DESC_COMMAND_CRAWL_LINK = 'Link current directory to a crawl suite';
+exports.DESC_COMMAND_UT_LINK = 'Link current directory to a unit test suite';
 exports.OPTION_SUITE_IDENTIFIER = 'Suite identifier';
 exports.TXT_COMMAND_VT_LINK_SELECT = 'Select visual test suite';
 exports.TXT_COMMAND_CRAWL_LINK_SELECT = 'Select crawl suite';
@@ -331,9 +331,9 @@ exports.TXT_COMMAND_SUITE_LINK_EXISTING = 'Link existing';
 exports.TXT_COMMAND_SUITE_LINK_EXISTING_DESC = 'Link to an existing suite';
 exports.TXT_COMMAND_SUITE_NAME = 'Provide suite name:';
 exports.TXT_COMMAND_SUITE_CREATED = 'Suite created';
-exports.OPTION_UPLOAD_REPORT_GLOB = 'Glob for reports';
+exports.OPTION_UPLOAD_REPORT_GLOB = 'Glob pattern matching report files';
 exports.OPTION_UPLOAD_REPORT_FORMAT = 'Format of the reports';
-exports.OPTION_UPLOAD_DRY_RUN = 'Run command without uploading reports';
+exports.OPTION_UPLOAD_DRY_RUN = 'List matched files without uploading';
 const TXT_NEW_CLI_DOCKER_VERSION = (version) => `New version of bdy Docker image is available! (${version})\n\n`;
 exports.TXT_NEW_CLI_DOCKER_VERSION = TXT_NEW_CLI_DOCKER_VERSION;
 exports.TXT_NEW_AGENT_VERSION = 'Agent upgrade required. Update the agent by running:\n`bdy agent update`\n\n';
@@ -444,33 +444,33 @@ exports.OPTION_AGENT_TAG = 'Tag agent. Can be passed multiple times';
 exports.OPTION_AGENT_PORT = 'Agent API port';
 exports.OPTION_AGENT_DEBUG = 'Turns on debug mode';
 exports.OPTION_EXEC_COMMAND = 'Test runner command';
-exports.OPTION_EXEC_SKIP_DISCOVERY = 'Skip resource discovery';
-exports.OPTION_EXEC_ONE_BY_ONE = 'Send snapshots one by one';
-exports.OPTION_EXEC_PARALLEL = 'Send parts of session from different processes';
-exports.OPTION_COMPARE_FOLLOW = 'Crawl all subviews of the page';
+exports.OPTION_EXEC_SKIP_DISCOVERY = 'Skip post-snapshot resource discovery (debugging or asset-free pages)';
+exports.OPTION_EXEC_ONE_BY_ONE = 'Send snapshots progressively for early review during long runs';
+exports.OPTION_EXEC_PARALLEL = 'Run as part of a parallel session (multi-machine/process)';
+exports.OPTION_COMPARE_FOLLOW = 'Follow same-origin links and capture all reachable pages';
 exports.OPTION_COMPARE_RESPECT_ROBOTS = 'Respect robots.txt';
-exports.OPTION_COMPARE_URLS = 'Urls to compare (comma separated list, e.g., --urls "https://example.com,https://example.org")';
-exports.OPTION_COMPARE_SITEMAP = 'Url from which sitemap will be gathered (e.g., --sitemap "https://example.com")';
-exports.OPTION_COMPARE_URLS_FILE = 'File with urls to compare (e.g., --urlsFile "urls.txt")';
-exports.OPTION_COMPARE_DRY_RUN = 'Run command without sending urls list to Buddy';
-exports.OPTION_COMPARE_IGNORE_URLS = 'Ignore urls matching the regex pattern (e.g., --ignoreUrls "https://example.com/.*")';
+exports.OPTION_COMPARE_URLS = 'URLs to compare (comma-separated list, e.g., --urls "https://example.com,https://example.org")';
+exports.OPTION_COMPARE_SITEMAP = 'URL of a sitemap to fetch URLs from (e.g., --sitemap "https://example.com/sitemap.xml")';
+exports.OPTION_COMPARE_URLS_FILE = 'File with URLs to compare (e.g., --urlsFile "urls.txt")';
+exports.OPTION_COMPARE_DRY_RUN = 'Print the URL list without sending it to Buddy';
+exports.OPTION_COMPARE_IGNORE_URLS = 'Ignore URLs whose full URL matches the regex (e.g., --ignoreUrls "https://example.com/admin/.*")';
 exports.OPTION_COMPARE_IGNORE = 'Ignore elements matching selectors while comparing (format: [scope::]type=value, e.g., --ignore "CSS=.ad-banner" "XPATH=//div[@id=\'popup\']" "example.com::CSS=.cookie-notice")';
-exports.OPTION_COMPARE_COOKIE = 'Set cookies used when visiting the urls (format: [scope::]cookie_value, e.g., --cookie "session=abc123" "example.com::auth=token123; Path=/; Secure; HttpOnly")';
-exports.OPTION_COMPARE_HEADER = 'Set HTTP headers used when visiting the urls (format: [scope::]name=value, e.g., --header "Authorization=Bearer token" "example.com::Accept=application/json")';
+exports.OPTION_COMPARE_COOKIE = 'Set cookies used when visiting the URLs (format: [scope::]cookie_value, e.g., --cookie "session=abc123" "example.com::auth=token123; Path=/; Secure; HttpOnly")';
+exports.OPTION_COMPARE_HEADER = 'Set HTTP headers used when visiting the URLs (format: [scope::]name=value, e.g., --header "Authorization=Bearer token" "example.com::Accept=application/json")';
 exports.OPTION_COMPARE_DELAY = 'Add delay in milliseconds before taking screenshot (1-60000, format: [scope::]milliseconds, e.g., --delay "1000" "example.com::2000")';
 exports.OPTION_COMPARE_WAIT_FOR = 'Wait for elements to appear before taking screenshot (format: [scope::]type=value, e.g., --waitFor "CSS=#content" "example.com::XPATH=//div[@class=\'loaded\']")';
 exports.OPTION_CRAWL_URL = 'URL to crawl (optional; defaults to crawl suite URL)';
-exports.OPTION_CRAWL_FOLLOW = 'Crawl all subviews of the page';
+exports.OPTION_CRAWL_FOLLOW = 'Follow same-origin links and crawl all reachable pages';
 exports.OPTION_CRAWL_OUTPUT_TYPE = 'Output type';
-exports.OPTION_CRAWL_QUALITY = 'Quality of the png output (default: "100")';
-exports.OPTION_CRAWL_FULL_PAGE = 'Crawl full page';
-exports.OPTION_CRAWL_CSS_SELECTOR = 'CSS selector to crawl';
-exports.OPTION_CRAWL_XPATH_SELECTOR = 'XPath selector to crawl';
+exports.OPTION_CRAWL_QUALITY = 'JPEG output quality (1-100)';
+exports.OPTION_CRAWL_FULL_PAGE = 'Capture full-page screenshots (not just the viewport)';
+exports.OPTION_CRAWL_CSS_SELECTOR = 'CSS selector to scope the snapshot/extraction';
+exports.OPTION_CRAWL_XPATH_SELECTOR = 'XPath selector to scope the snapshot/extraction';
 exports.OPTION_CRAWL_COLOR_SCHEME = 'Color scheme to use (LIGHT, DARK, LIGHT_AND_DARK)';
-exports.OPTION_CRAWL_BROWSERS = 'Browsers to use (comma separated: chrome,firefox,safari)';
+exports.OPTION_CRAWL_BROWSERS = 'Browsers to use (comma-separated: chrome,firefox,safari)';
 exports.OPTION_CRAWL_DEVICES = 'Devices definition as JSON array (e.g., --devices \'[{"viewport":"1920x1080","screen":"1920x1080","devicePixelRatio":1,"isMobile":false}]\')';
-exports.OPTION_CRAWL_LOCAL_STORAGE = 'Set localStorage values used when visiting urls (format: [scope::]key=value)';
-exports.OPTION_CRAWL_DELAY = 'Delay in milliseconds';
+exports.OPTION_CRAWL_LOCAL_STORAGE = 'Set localStorage values used when visiting URLs (format: [scope::]key=value)';
+exports.OPTION_CRAWL_DELAY = 'Delay in milliseconds before capture (format: [scope::]ms)';
 exports.OPTION_CRAWL_OUTPUT_DIR = 'Output directory';
 exports.OPTION_CRAWL_OUTPUT_TYPES = 'Output types as JSON array (e.g., --outputTypes \'[{"type":"md","selector":{"type":"CSS","value":".main"}},{"type":"jpeg","quality":80,"fullPage":true}]\')';
 exports.LOG_REGISTERING_AGENT = 'Registering agent...';
@@ -1384,3 +1384,55 @@ EXAMPLES:
   bdy art ver rm artifact-identifier version
   ### delete artifact version and automatically confirm deletion:
   bdy art ver rm artifact-identifier version -f`;
+exports.EXAMPLE_TESTS_UNIT_UPLOAD = `
+  ### upload junit xml report:
+  bdy tests unit upload "reports/**/*.xml" --format junit-xml
+  ### preview which files would be uploaded without sending:
+  bdy tests unit upload "reports/**/*.xml" --format junit-xml --dryRun`;
+exports.EXAMPLE_TESTS_UNIT_LINK = `
+  ### interactively link current directory to a unit test suite:
+  bdy tests unit link
+  ### link non-interactively to a specific suite:
+  bdy tests unit link -w workspace -p project -s suite-identifier`;
+exports.EXAMPLE_TESTS_VISUAL_SETUP = `
+  ### install the resource-discovery browser (needed by \`session create\` unless --skipDiscovery):
+  bdy tests visual setup`;
+exports.EXAMPLE_TESTS_VISUAL_UPLOAD = `
+  ### upload a built Storybook to the linked visual test suite:
+  bdy tests visual upload`;
+exports.EXAMPLE_TESTS_VISUAL_LINK = `
+  ### interactively link current directory to a visual test suite:
+  bdy tests visual link
+  ### link non-interactively to a specific suite:
+  bdy tests visual link -w workspace -p project -s suite-identifier`;
+exports.EXAMPLE_TESTS_VISUAL_SESSION_CREATE = `
+  ### run your test command with the visual-test plugin server attached:
+  bdy tests visual session create "npm test"
+  ### skip resource discovery (debugging or asset-free pages):
+  bdy tests visual session create "npm test" --skipDiscovery
+  ### send snapshots progressively (quicker review during long runs):
+  bdy tests visual session create "npm test" --oneByOne
+  ### one runner in a parallel session (every runner must share the same $SNAPSHOTS_BUILD_ID):
+  bdy tests visual session create "npm test" --parallel`;
+exports.EXAMPLE_TESTS_VISUAL_SESSION_CLOSE = `
+  ### close the session after all parallel runners finished (build id read from $SNAPSHOTS_BUILD_ID):
+  bdy tests visual session close`;
+exports.EXAMPLE_TESTS_CAPTURE = `
+  ### capture an explicit list of urls:
+  bdy tests capture --urls "https://example.com,https://example.com/about"
+  ### capture from a sitemap and follow links:
+  bdy tests capture --sitemap https://example.com/sitemap.xml --follow
+  ### capture from a urls file and ignore a globbed selector:
+  bdy tests capture --urlsFile ./urls.txt --ignore "header>.banner"`;
+exports.EXAMPLE_CRAWL_RUN = `
+  ### crawl a single page and save md/html into current dir:
+  bdy crawl run https://example.com --outputType md
+  ### follow links and capture full-page screenshots in dark mode:
+  bdy crawl run https://example.com --follow --fullPage --outputType png --colorScheme DARK --outputDir ./out
+  ### crawl with multiple output types and a specific css selector:
+  bdy crawl run https://example.com --outputTypes '["jpeg","md"]' --cssSelector "main"`;
+exports.EXAMPLE_CRAWL_LINK = `
+  ### interactively link current directory to a crawl suite:
+  bdy crawl link
+  ### link non-interactively to a specific suite:
+  bdy crawl link -w workspace -p project -s suite-identifier`;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bdy",
   "preferGlobal": false,
-  "version": "1.22.47-dev",
+  "version": "1.22.48-dev",
   "type": "commonjs",
   "license": "MIT",
   "scripts": {