@testrigor/testrigor-cli 2.0.6 → 2.0.7

package/README.md

@@ -134,6 +134,7 @@ Pull requests to `master` must pass two CircleCI checks before they can be merge
 
    This updates the version in `package.json` and in both root entries of `package-lock.json` (`version` and `packages[""].version`). `--no-git-tag-version` stops npm from creating its own commit and `v*` tag. npm also runs the `version` script (`oclif readme && git add README.md`). That script loads the commands from `dist`, which is why you build first. It only rewrites README sections between oclif markers such as `<!-- commands -->
 * [`testrigor authenticate`](#testrigor-authenticate)
+* [`testrigor clone SUITE`](#testrigor-clone-suite)
 * [`testrigor help [COMMAND]`](#testrigor-help-command)
 * [`testrigor test-suite config`](#testrigor-test-suite-config)
 * [`testrigor test-suite run [TESTSUITEID]`](#testrigor-test-suite-run-testsuiteid)
@@ -167,7 +168,37 @@ EXAMPLES
   Config will be stored in ~/.testrigor/testrigor.yml
 ```
 
-_See code: [src/commands/authenticate.ts](https://github.com/TestRigor/testrigor-cli/blob/v2.0.6/src/commands/authenticate.ts)_
+_See code: [src/commands/authenticate.ts](https://github.com/TestRigor/testrigor-cli/blob/v2.0.7/src/commands/authenticate.ts)_
+
+## `testrigor clone SUITE`
+
+Download a test suite's test cases, rules and test data into a folder named after the suite
+
+```
+USAGE
+  $ testrigor clone SUITE [--auth-token <value>] [-t <value>] [--verbose] [--base-url-api <value>]
+
+ARGUMENTS
+  SUITE  The test suite URL or id
+
+FLAGS
+  --base-url-api=<value>  Base URL for API2 (e.g., https://api2.testrigor.com)
+
+GLOBAL FLAGS
+  -t, --token=<value>       Suite authentication token
+      --auth-token=<value>  Personal authentication token
+      --verbose             Verbose output
+
+DESCRIPTION
+  Download a test suite's test cases, rules and test data into a folder named after the suite
+
+EXAMPLES
+  $ testrigor clone https://app.testrigor.com/test-suites/<test-suite-id>/test-cases
+
+  $ testrigor clone <test-suite-id>
+```
+
+_See code: [src/commands/clone.ts](https://github.com/TestRigor/testrigor-cli/blob/v2.0.7/src/commands/clone.ts)_
 
 ## `testrigor help [COMMAND]`
 
@@ -213,7 +244,7 @@ EXAMPLES
   $ testrigor test-suite config --delete
 ```
 
-_See code: [src/commands/test-suite/config.ts](https://github.com/TestRigor/testrigor-cli/blob/v2.0.6/src/commands/test-suite/config.ts)_
+_See code: [src/commands/test-suite/config.ts](https://github.com/TestRigor/testrigor-cli/blob/v2.0.7/src/commands/test-suite/config.ts)_
 
 ## `testrigor test-suite run [TESTSUITEID]`
 
@@ -273,7 +304,7 @@ DESCRIPTION
   Run all tests of a Test Suite
 ```
 
-_See code: [src/commands/test-suite/run.ts](https://github.com/TestRigor/testrigor-cli/blob/v2.0.6/src/commands/test-suite/run.ts)_
+_See code: [src/commands/test-suite/run.ts](https://github.com/TestRigor/testrigor-cli/blob/v2.0.7/src/commands/test-suite/run.ts)_
 
 ## `testrigor test-suite validate-syntax [TESTSUITEID]`
 
@@ -313,7 +344,7 @@ EXAMPLES
   $ testrigor test-suite validate-syntax <test-suite-id> --test-cases-path "test_cases/**/*.{yaml,txt}"
 ```
 
-_See code: [src/commands/test-suite/validate-syntax.ts](https://github.com/TestRigor/testrigor-cli/blob/v2.0.6/src/commands/test-suite/validate-syntax.ts)_
+_See code: [src/commands/test-suite/validate-syntax.ts](https://github.com/TestRigor/testrigor-cli/blob/v2.0.7/src/commands/test-suite/validate-syntax.ts)_
 <!-- commandsstop -->`, so this README currently stays unchanged.
 
 3. Check that the diff only touches the version fields, then build and test from the lockfile:

package/dist/commands/clone.d.ts

@@ -0,0 +1,24 @@
+import { CommandBase } from "../command-base";
+export default class Clone extends CommandBase<typeof Clone> {
+    static description: string;
+    static examples: string[];
+    static baseFlags: (typeof CommandBase)["baseFlags"];
+    static flags: {
+        "base-url-api": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    static args: {
+        suite: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static pollIntervalMs: number;
+    private TESTRIGOR_API2_URL;
+    run(): Promise<void>;
+    private triggerExport;
+    private fetchExport;
+    /**
+     * Polls the export until it finishes and returns its download URL.
+     */
+    private waitForExport;
+    private downloadAndExtract;
+    private fetchArchive;
+    private callApi;
+}

package/dist/commands/clone.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const core_1 = require("@oclif/core");
+const fs = tslib_1.__importStar(require("fs"));
+const path = tslib_1.__importStar(require("path"));
+const stream_1 = require("stream");
+const command_base_1 = require("../command-base");
+const environments_1 = require("../config/environments");
+const suite_archive_1 = require("../util/suite-archive");
+const utils_1 = require("../util/utils");
+const EXPORT_PAYLOAD = {
+    testCases: "TXT",
+    testData: "YAML",
+    datasets: "YAML",
+    rules: "AUTO",
+    settings: "YAML",
+};
+const EXPORT_TIMEOUT_MS = 10 * 60 * 1000;
+const DOWNLOAD_TIMEOUT_MS = 10 * 60 * 1000;
+class Clone extends command_base_1.CommandBase {
+    async run() {
+        const baseUrlApi = this.flags["base-url-api"] || environments_1.environments.prod.TESTRIGOR_API_URL;
+        this.TESTRIGOR_API2_URL = `${baseUrlApi.replace(/\/$/, "")}/api/v1`;
+        const testSuiteId = (0, utils_1.parseTestSuiteId)(this.args.suite);
+        if (!testSuiteId) {
+            this.error(`"${this.args.suite}" is not a test suite URL or id`, {
+                exit: 1,
+            });
+        }
+        const token = await this.resolveToken();
+        core_1.ux.stdout(`Exporting test suite ${testSuiteId}...`);
+        const exportId = await this.triggerExport(testSuiteId, token);
+        const downloadUrl = await this.waitForExport(testSuiteId, exportId, token);
+        // Named after the ZIP generated by the backend, which already ends with
+        // the export id, so repeated clones get their own folders.
+        const folderName = (0, suite_archive_1.sanitizeFolderName)((0, suite_archive_1.archiveNameFromDownloadUrl)(downloadUrl));
+        const targetDir = path.resolve(folderName);
+        const createdTargetDir = !fs.existsSync(targetDir);
+        try {
+            fs.mkdirSync(targetDir, { recursive: true });
+            core_1.ux.stdout("Downloading...");
+            await this.downloadAndExtract(testSuiteId, exportId, downloadUrl, token, targetDir);
+        }
+        catch (error) {
+            // Leave nothing half-extracted behind, but never delete a folder that
+            // was there before.
+            if (createdTargetDir) {
+                fs.rmSync(targetDir, { recursive: true, force: true });
+            }
+            throw error;
+        }
+        core_1.ux.stdout(`Cloned test suite ${testSuiteId} into ${path.join(folderName, suite_archive_1.TESTRIGOR_DIR)}`);
+    }
+    async triggerExport(testSuiteId, token) {
+        const response = await this.callApi(`/apps/${testSuiteId}/exports`, testSuiteId, token, "start the export", { method: "POST", body: JSON.stringify(EXPORT_PAYLOAD) });
+        return response.data;
+    }
+    async fetchExport(testSuiteId, exportId, token) {
+        const response = await this.callApi(`/apps/${testSuiteId}/exports/${exportId}`, testSuiteId, token, "get the export status", { method: "GET" });
+        return response.data;
+    }
+    /**
+     * Polls the export until it finishes and returns its download URL.
+     */
+    async waitForExport(testSuiteId, exportId, token) {
+        const deadline = Date.now() + EXPORT_TIMEOUT_MS;
+        for (;;) {
+            const exportInfo = await this.fetchExport(testSuiteId, exportId, token);
+            if (exportInfo.status === "FINISHED") {
+                if (!exportInfo.downloadUrl) {
+                    throw new Error("The export finished without a download URL");
+                }
+                return exportInfo.downloadUrl;
+            }
+            if (exportInfo.status === "FAILED") {
+                this.error(`The export of test suite ${testSuiteId} failed. Please try again.`, { exit: 1 });
+            }
+            if (Date.now() >= deadline) {
+                this.error(`The export of test suite ${testSuiteId} did not finish within ${EXPORT_TIMEOUT_MS / 60000} minutes.`, { exit: 1 });
+            }
+            await new Promise((resolve) => setTimeout(resolve, Clone.pollIntervalMs));
+        }
+    }
+    async downloadAndExtract(testSuiteId, exportId, downloadUrl, token, targetDir) {
+        let response = await this.fetchArchive(downloadUrl);
+        if (response.status === 403) {
+            // The signed URL is only valid for a few minutes, so ask for a new one.
+            const exportInfo = await this.fetchExport(testSuiteId, exportId, token);
+            if (exportInfo.downloadUrl) {
+                response = await this.fetchArchive(exportInfo.downloadUrl);
+            }
+        }
+        if (!response.ok || response.body == null) {
+            throw new Error(`Failed to download the export: ${response.status} ${response.statusText}`);
+        }
+        await (0, suite_archive_1.extractSuiteArchive)(targetDir, stream_1.Readable.fromWeb(response.body));
+    }
+    // The download URL is a pre-signed S3 URL: it must not carry the token.
+    fetchArchive(url) {
+        return fetch(url, { signal: AbortSignal.timeout(DOWNLOAD_TIMEOUT_MS) });
+    }
+    async callApi(endpoint, testSuiteId, token, action, init) {
+        const response = await fetch(`${this.TESTRIGOR_API2_URL}${endpoint}`, {
+            ...init,
+            headers: {
+                "Content-Type": "application/json",
+                Accept: "application/json",
+                "auth-token": token,
+            },
+        });
+        if (response.status === 401 || response.status === 403) {
+            this.error(`Access to test suite ${testSuiteId} was denied.\n` +
+                "Make sure you use a valid personal access token: run 'testrigor authenticate' to store one.", { exit: 1 });
+        }
+        if (!response.ok) {
+            const body = (await response.json().catch(() => null));
+            const details = body?.errors?.join("; ") || body?.message;
+            throw new Error(`Failed to ${action}: ${response.status} ${response.statusText}${details ? ` - ${details}` : ""}`);
+        }
+        return (await response.json());
+    }
+}
+Clone.description = "Download a test suite's test cases, rules and test data into a folder named after the suite";
+Clone.examples = [
+    "testrigor clone https://app.testrigor.com/test-suites/<test-suite-id>/test-cases",
+    "testrigor clone <test-suite-id>",
+];
+// Override base flags to remove tunnel-only flags that are not needed by clone.
+Clone.baseFlags = {
+    "auth-token": command_base_1.CommandBase.baseFlags["auth-token"],
+    token: command_base_1.CommandBase.baseFlags.token,
+    verbose: command_base_1.CommandBase.baseFlags.verbose,
+};
+Clone.flags = {
+    "base-url-api": core_1.Flags.string({
+        description: "Base URL for API2 (e.g., https://api2.testrigor.com)",
+    }),
+};
+Clone.args = {
+    suite: core_1.Args.string({
+        name: "suite",
+        description: "The test suite URL or id",
+        required: true,
+    }),
+};
+// Overridable so tests do not have to wait between polls.
+Clone.pollIntervalMs = 2000;
+exports.default = Clone;

package/dist/types.d.ts

@@ -56,6 +56,27 @@ export type ParserError = {
 export type ValidateSyntaxApiResponse = Api2Wrapper & {
     data?: ParserError[];
 };
+export type ExportFileType = "TXT" | "YAML" | "AUTO" | "NONE";
+export type ExportApplicationPayload = {
+    testCases: ExportFileType;
+    testData: ExportFileType;
+    datasets: ExportFileType;
+    rules: ExportFileType;
+    settings: ExportFileType;
+};
+export type ExportStatus = "IN_PROGRESS" | "FINISHED" | "FAILED";
+export type ExportInfo = {
+    id: string;
+    status: ExportStatus;
+    createdAt: string;
+    downloadUrl?: string;
+};
+export type TriggerExportApiResponse = Api2Wrapper & {
+    data: string;
+};
+export type ExportApiResponse = Api2Wrapper & {
+    data: ExportInfo;
+};
 export type ChromeExtensionInput = {
     name: string;
     file: string;

package/dist/util/suite-archive.d.ts

@@ -0,0 +1,25 @@
+export declare const TESTRIGOR_DIR = "testrigor";
+/**
+ * Makes a test suite name usable as a folder name on every OS: whitespace
+ * becomes "_", characters Windows rejects are dropped, and leading or trailing
+ * dots are trimmed. Returns "" when nothing usable is left.
+ */
+export declare function sanitizeFolderName(name: string): string;
+/**
+ * The ZIP file name without its extension. The backend names each export
+ * "<suite_name>_<exportId>.zip", so the name is unique per export.
+ */
+export declare function archiveNameFromDownloadUrl(downloadUrl: string): string;
+/**
+ * Maps a path inside the export ZIP to its place under the testrigor folder,
+ * or null for entries that are not kept. Throws for entries that would land
+ * outside the target folder (zip-slip). unzip-stream already rewrites ".."
+ * segments to ".", so this guards against whatever it lets through, such as
+ * drive-letter paths.
+ */
+export declare function mapArchivePath(archivePath: string): string | null;
+/**
+ * Extracts a suite export ZIP into <targetDir>/testrigor, rearranged into
+ * rules, testcases, testdata and testdata/datasets.
+ */
+export declare function extractSuiteArchive(targetDir: string, stream: NodeJS.ReadableStream): Promise<void>;

package/dist/util/suite-archive.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TESTRIGOR_DIR = void 0;
+exports.sanitizeFolderName = sanitizeFolderName;
+exports.archiveNameFromDownloadUrl = archiveNameFromDownloadUrl;
+exports.mapArchivePath = mapArchivePath;
+exports.extractSuiteArchive = extractSuiteArchive;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("fs"));
+const path = tslib_1.__importStar(require("path"));
+const unzip = tslib_1.__importStar(require("unzip-stream"));
+const trtc_1 = require("./trtc");
+exports.TESTRIGOR_DIR = "testrigor";
+// Created even when the export has nothing for them, so every clone has the
+// same layout.
+const SUITE_DIRS = [
+    "rules",
+    "testcases",
+    "testdata",
+    path.join("testdata", "datasets"),
+];
+// Describes the export's own layout, which no longer holds once datasets are
+// moved under testdata.
+const STRUCTURE_FILE = "structure.yaml";
+const WINDOWS_RESERVED_NAME = /^(con|prn|aux|nul|com\d|lpt\d)(\..*)?$/i;
+/**
+ * Makes a test suite name usable as a folder name on every OS: whitespace
+ * becomes "_", characters Windows rejects are dropped, and leading or trailing
+ * dots are trimmed. Returns "" when nothing usable is left.
+ */
+function sanitizeFolderName(name) {
+    const cleaned = name
+        .trim()
+        .replace(/\s+/g, "_")
+        // eslint-disable-next-line no-control-regex
+        .replace(/[<>:"/\\|?*\u0000-\u001f]/g, "")
+        .replace(/^\.+|\.+$/g, "");
+    return WINDOWS_RESERVED_NAME.test(cleaned) ? `${cleaned}_` : cleaned;
+}
+/**
+ * The ZIP file name without its extension. The backend names each export
+ * "<suite_name>_<exportId>.zip", so the name is unique per export.
+ */
+function archiveNameFromDownloadUrl(downloadUrl) {
+    return decodeURIComponent(path.posix.basename(new URL(downloadUrl).pathname)).replace(/\.zip$/i, "");
+}
+/**
+ * Maps a path inside the export ZIP to its place under the testrigor folder,
+ * or null for entries that are not kept. Throws for entries that would land
+ * outside the target folder (zip-slip). unzip-stream already rewrites ".."
+ * segments to ".", so this guards against whatever it lets through, such as
+ * drive-letter paths.
+ */
+function mapArchivePath(archivePath) {
+    const normalized = archivePath.replace(/\\/g, "/");
+    const segments = normalized
+        .split("/")
+        .filter((segment) => segment !== "" && segment !== ".");
+    if (normalized.startsWith("/") ||
+        segments.some((segment) => segment === ".." || segment.includes(":"))) {
+        throw new Error(`Refusing to extract "${archivePath}": it points outside the target folder`);
+    }
+    if (segments.length === 0 ||
+        (segments.length === 1 && segments[0] === STRUCTURE_FILE)) {
+        return null;
+    }
+    if (segments[0] === "datasets") {
+        segments.splice(0, 1, "testdata", "datasets");
+    }
+    return path.join(...segments);
+}
+/**
+ * Extracts a suite export ZIP into <targetDir>/testrigor, rearranged into
+ * rules, testcases, testdata and testdata/datasets.
+ */
+function extractSuiteArchive(targetDir, stream) {
+    const root = path.join(targetDir, exports.TESTRIGOR_DIR);
+    const parser = unzip.Parse();
+    const writes = [];
+    // Reported once the files already being written are done, so the caller
+    // can clean up without racing them.
+    let rejectedEntryError;
+    return new Promise((resolve, reject) => {
+        stream.on("error", reject);
+        parser.on("error", reject);
+        parser.on("entry", (entry) => {
+            if (rejectedEntryError) {
+                entry.autodrain();
+                return;
+            }
+            let relativePath;
+            try {
+                relativePath = mapArchivePath(entry.path);
+            }
+            catch (error) {
+                entry.autodrain();
+                rejectedEntryError = error;
+                return;
+            }
+            if (relativePath === null) {
+                entry.autodrain();
+                return;
+            }
+            const entryPath = path.join(root, relativePath);
+            if (entry.type === "Directory") {
+                fs.mkdirSync(entryPath, { recursive: true });
+                entry.autodrain();
+                return;
+            }
+            fs.mkdirSync(path.dirname(entryPath), { recursive: true });
+            writes.push((0, trtc_1.writeEntry)(entryPath, entry));
+        });
+        parser.on("finish", () => Promise.allSettled(writes).then((results) => {
+            const failedWrite = results.find((result) => result.status === "rejected");
+            if (rejectedEntryError || failedWrite) {
+                reject(rejectedEntryError ?? failedWrite?.reason);
+                return;
+            }
+            for (const dir of SUITE_DIRS) {
+                fs.mkdirSync(path.join(root, dir), { recursive: true });
+            }
+            resolve();
+        }));
+        stream.pipe(parser);
+    });
+}

package/dist/util/trtc.d.ts

@@ -1,3 +1,4 @@
+export declare function writeEntry(entryPath: string, entry: NodeJS.ReadableStream, mode?: number): Promise<void>;
 export declare function extractZip(dir: string, stream: NodeJS.ReadableStream): Promise<string>;
 export declare function extractTar(dir: string, stream: NodeJS.ReadableStream): Promise<string>;
 export declare function download(dir: string): Promise<string>;

package/dist/util/trtc.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeEntry = writeEntry;
 exports.extractZip = extractZip;
 exports.extractTar = extractTar;
 exports.download = download;

package/dist/util/utils.d.ts

@@ -15,3 +15,4 @@ export declare function extractUrlWithoutQueryParams(urlString: string): string;
 export declare function extractRunIdFromDetailsUrl(detailsUrl: string | undefined): string;
 export declare function isValidUrl(url: string): boolean;
 export declare function splitLabels(values: string[] | undefined): string[];
+export declare function parseTestSuiteId(input: string): string | null;

package/dist/util/utils.js

@@ -16,6 +16,7 @@ exports.extractUrlWithoutQueryParams = extractUrlWithoutQueryParams;
 exports.extractRunIdFromDetailsUrl = extractRunIdFromDetailsUrl;
 exports.isValidUrl = isValidUrl;
 exports.splitLabels = splitLabels;
+exports.parseTestSuiteId = parseTestSuiteId;
 const tslib_1 = require("tslib");
 const fs_1 = tslib_1.__importDefault(require("@supercharge/fs"));
 const path = tslib_1.__importStar(require("path"));
@@ -107,3 +108,16 @@ function splitLabels(values) {
         .map((label) => label.trim())
         .filter((label) => label.length > 0);
 }
+const TEST_SUITES_PATH_SEGMENT = "test-suites";
+// Accepts a bare test suite id or a test suite URL such as
+// https://app.testrigor.com/test-suites/<id>/test-cases, where the id is the
+// path segment right after "test-suites". Returns null when there is no id.
+function parseTestSuiteId(input) {
+    const value = input.trim();
+    if (!value.includes("/")) {
+        return value || null;
+    }
+    const segments = value.split("/");
+    const index = segments.indexOf(TEST_SUITES_PATH_SEGMENT);
+    return (index !== -1 && segments[index + 1]) || null;
+}

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@testrigor/testrigor-cli",
-  "version": "2.0.6",
+  "version": "2.0.7",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@testrigor/testrigor-cli",
-      "version": "2.0.6",
+      "version": "2.0.7",
       "hasInstallScript": true,
       "license": "MIT",
       "dependencies": {

package/oclif.manifest.json

@@ -36,6 +36,71 @@
         "authenticate.js"
       ]
     },
+    "clone": {
+      "aliases": [],
+      "args": {
+        "suite": {
+          "description": "The test suite URL or id",
+          "name": "suite",
+          "required": true
+        }
+      },
+      "description": "Download a test suite's test cases, rules and test data into a folder named after the suite",
+      "examples": [
+        "testrigor clone https://app.testrigor.com/test-suites/<test-suite-id>/test-cases",
+        "testrigor clone <test-suite-id>"
+      ],
+      "flags": {
+        "auth-token": {
+          "description": "Personal authentication token",
+          "helpGroup": "GLOBAL",
+          "name": "auth-token",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "token": {
+          "char": "t",
+          "description": "Suite authentication token",
+          "helpGroup": "GLOBAL",
+          "name": "token",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verbose": {
+          "description": "Verbose output",
+          "helpGroup": "GLOBAL",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "base-url-api": {
+          "description": "Base URL for API2 (e.g., https://api2.testrigor.com)",
+          "name": "base-url-api",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "clone",
+      "pluginAlias": "@testrigor/testrigor-cli",
+      "pluginName": "@testrigor/testrigor-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "pollIntervalMs": 2000,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "clone.js"
+      ]
+    },
     "test-suite:config": {
       "aliases": [],
       "args": {},
@@ -456,5 +521,5 @@
       ]
     }
   },
-  "version": "2.0.6"
+  "version": "2.0.7"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testrigor/testrigor-cli",
-  "version": "2.0.6",
+  "version": "2.0.7",
   "description": "TestRigor Command Line",
   "author": "Ivo Parun Rua @parunruaivo",
   "bin": {
@@ -87,6 +87,9 @@
       },
       "authenticate": {
         "description": "Set your testRigor personal authentication token"
+      },
+      "clone": {
+        "description": "Download a test suite's test cases, rules and test data into a folder named after the suite"
       }
     }
   },