dataiku-sdk 3.3.0 → 3.5.0

package/dist/src/cli/commands/bundle.js

@@ -1,16 +1,17 @@
+import { unexpectedResponseError, } from "../../errors.js";
 import { writeResponseToFile, } from "../../utils/response-file.js";
 import { json, parseBooleanOption, } from "../coerce.js";
+import { commandUsage, withUsage, } from "../syntax.js";
 import { requireArgs, UsageError, } from "../usage.js";
-export const bundleCommands = {
+export const bundleCommands = withUsage("bundle", {
     "list-exported": {
         handler: (c, _a, f) => c.bundles.listExported(f["project-key"]),
-        usage: "dss bundle list-exported [--project-key KEY]",
         description: "List bundles exported from a project on the Design node.",
         examples: ["dss bundle list-exported",],
     },
     export: {
         handler: async (c, a, f) => {
-            const usage = "dss bundle export <bundleId> [--release-notes TEXT] [--evaluate-standards-checks true|false] [--project-key KEY]";
+            const usage = commandUsage("bundle", "export");
             requireArgs(a, 1, usage);
             await c.bundles.exportBundle(a[0], f["project-key"], {
                 ...(typeof f["release-notes"] === "string" ? { releaseNotes: f["release-notes"], } : {}),
@@ -22,7 +23,6 @@ export const bundleCommands = {
             });
             return { exported: a[0], };
         },
-        usage: "dss bundle export <bundleId> [--release-notes TEXT] [--evaluate-standards-checks true|false] [--project-key KEY]",
         description: "Create an exported Design-node bundle. --release-notes forwards the documented releaseNotes parameter; --evaluate-standards-checks toggles the documented Project Standards Checks evaluation (default true; this instance forbids disabling it). DSS refuses re-exporting an existing bundle id — delete-exported first to replace one.",
         examples: [
             "dss bundle export v1",
@@ -31,40 +31,37 @@ export const bundleCommands = {
     },
     "delete-exported": {
         handler: async (c, a, f) => {
-            requireArgs(a, 1, "dss bundle delete-exported <bundleId> [--project-key KEY]");
+            requireArgs(a, 1, commandUsage("bundle", "delete-exported"));
             await c.bundles.deleteExported(a[0], f["project-key"]);
             return { deleted: true, };
         },
-        usage: "dss bundle delete-exported <bundleId> [--project-key KEY]",
         description: "Delete an exported Design-node bundle.",
         examples: ["dss bundle delete-exported v1",],
     },
     "download-exported": {
         handler: async (c, a, f) => {
-            requireArgs(a, 1, "dss bundle download-exported <bundleId> --output PATH [--project-key KEY]");
+            requireArgs(a, 1, commandUsage("bundle", "download-exported"));
             const out = f["output"];
             if (!out)
                 throw new UsageError("--output PATH is required.", "missing_required_flag");
             const res = await c.bundles.downloadExportedArchive(a[0], f["project-key"]);
             if (!res.body) {
-                throw new Error("bundles.downloadExportedArchive response did not include a body");
+                throw unexpectedResponseError("bundles.downloadExportedArchive response did not include a body");
             }
             const bytes = await writeResponseToFile(out, res);
             return { path: out, bytes, };
         },
-        usage: "dss bundle download-exported <bundleId> --output PATH [--project-key KEY]",
         description: "Download an exported Design-node bundle archive to a local file.",
         examples: ["dss bundle download-exported v1 --output ./bundle.zip",],
     },
     publish: {
         handler: (c, a, f) => {
-            const usage = "dss bundle publish <bundleId> [--published-project-key KEY] [--project-key KEY]";
+            const usage = commandUsage("bundle", "publish");
             requireArgs(a, 1, usage);
             return c.bundles.publish(a[0], f["project-key"], typeof f["published-project-key"] === "string"
                 ? { publishedProjectKey: f["published-project-key"], }
                 : {});
         },
-        usage: "dss bundle publish <bundleId> [--published-project-key KEY] [--project-key KEY]",
         description: "Publish a Design-node bundle to the Project Deployer; --published-project-key forwards the documented publishedProjectKey query parameter (a new published project is created when no match exists; the source project's key is the server-side default).",
         examples: [
             "dss bundle publish v1",
@@ -73,32 +70,29 @@ export const bundleCommands = {
     },
     "list-imported": {
         handler: (c, _a, f) => c.bundles.listImported(f["project-key"]),
-        usage: "dss bundle list-imported [--project-key KEY]",
         description: "List bundles imported into a project on the Automation node.",
         examples: ["dss bundle list-imported",],
     },
     "import-from-archive": {
         handler: (c, a, f) => {
-            requireArgs(a, 1, "dss bundle import-from-archive <serverArchivePath> [--project-key KEY]");
+            requireArgs(a, 1, commandUsage("bundle", "import-from-archive"));
             return c.bundles.importFromArchive(a[0], f["project-key"]);
         },
-        usage: "dss bundle import-from-archive <serverArchivePath> [--project-key KEY]",
         description: "Import a server-side bundle archive into an Automation-node project.",
         examples: ["dss bundle import-from-archive /data/bundles/v1.zip",],
     },
     "import-from-stream": {
         handler: async (c, a, f) => {
-            requireArgs(a, 1, "dss bundle import-from-stream <filePath> [--project-key KEY]");
+            requireArgs(a, 1, commandUsage("bundle", "import-from-stream"));
             await c.bundles.importFromStream(a[0], f["project-key"]);
             return { imported: true, };
         },
-        usage: "dss bundle import-from-stream <filePath> [--project-key KEY]",
         description: "Upload and import a local bundle archive into an Automation-node project.",
         examples: ["dss bundle import-from-stream ./v1.zip",],
     },
     activate: {
         handler: (c, a, f) => {
-            const usage = "dss bundle activate <bundleId> [--scenarios JSON] [--project-key KEY]";
+            const usage = commandUsage("bundle", "activate");
             requireArgs(a, 1, usage);
             const rawScenarios = f["scenarios"];
             let scenariosToEnable;
@@ -108,13 +102,12 @@ export const bundleCommands = {
                     || parsed === null
                     || Array.isArray(parsed)
                     || !Object.values(parsed).every((value) => typeof value === "boolean")) {
-                    throw new UsageError("--scenarios must be a JSON object mapping scenario IDs to true|false. Usage: dss bundle activate <bundleId> --scenarios '{\"daily_build\":true}'");
+                    throw new UsageError(`--scenarios must be a JSON object mapping scenario IDs to true|false. Usage: ${commandUsage("bundle", "activate")}`);
                 }
                 scenariosToEnable = parsed;
             }
             return c.bundles.activate(a[0], f["project-key"], scenariosToEnable !== undefined ? { scenariosToEnable, } : {});
         },
-        usage: "dss bundle activate <bundleId> [--scenarios JSON] [--project-key KEY]",
         description: "Activate an imported Automation-node bundle; --scenarios forwards the documented scenario-ID-to-enabled dict as the scenariosActiveOnActivation body.",
         examples: [
             "dss bundle activate v1",
@@ -123,21 +116,19 @@ export const bundleCommands = {
     },
     preload: {
         handler: (c, a, f) => {
-            requireArgs(a, 1, "dss bundle preload <bundleId> [--project-key KEY]");
+            requireArgs(a, 1, commandUsage("bundle", "preload"));
             return c.bundles.preload(a[0], f["project-key"]);
         },
-        usage: "dss bundle preload <bundleId> [--project-key KEY]",
         description: "Preload an imported Automation-node bundle (stage data/models).",
         examples: ["dss bundle preload v1",],
     },
     "delete-imported": {
         handler: async (c, a, f) => {
-            requireArgs(a, 1, "dss bundle delete-imported <bundleId> [--project-key KEY]");
+            requireArgs(a, 1, commandUsage("bundle", "delete-imported"));
             await c.bundles.deleteImported(a[0], f["project-key"]);
             return { deleted: true, };
         },
-        usage: "dss bundle delete-imported <bundleId> [--project-key KEY]",
         description: "Delete an imported Automation-node bundle.",
         examples: ["dss bundle delete-imported v1",],
     },
-};
+});

package/dist/src/cli/commands/business-app.js

@@ -1,76 +1,69 @@
 import { requiredJsonInput, } from "../coerce.js";
+import { commandUsage, withUsage, } from "../syntax.js";
 import { requireArgs, } from "../usage.js";
-export const businessAppCommands = {
+export const businessAppCommands = withUsage("business-app", {
     list: {
         handler: (c) => c.applications.listBusinessApps(),
-        usage: "dss business-app list",
         description: "List all Business Apps.",
         examples: ["dss business-app list",],
     },
     get: {
         handler: (c, a) => {
-            requireArgs(a, 1, "dss business-app get <id>");
+            requireArgs(a, 1, commandUsage("business-app", "get"));
             return c.applications.getBusinessApp(a[0]);
         },
-        usage: "dss business-app get <id>",
         description: "Get Business App details.",
         examples: ["dss business-app get my-bapp",],
     },
     settings: {
         handler: (c, a) => {
-            requireArgs(a, 1, "dss business-app settings <id>");
+            requireArgs(a, 1, commandUsage("business-app", "settings"));
             return c.applications.getBusinessAppSettings(a[0]);
         },
-        usage: "dss business-app settings <id>",
         description: "Get Business App settings.",
         examples: ["dss business-app settings my-bapp",],
     },
     "save-settings": {
         handler: (c, a, f) => {
-            requireArgs(a, 1, "dss business-app save-settings <id> (--data JSON|--data-file PATH|--stdin)");
+            requireArgs(a, 1, commandUsage("business-app", "save-settings"));
             const body = requiredJsonInput(f, "--data, --data-file, or --stdin is required (settings JSON).");
             return c.applications.saveBusinessAppSettings(a[0], body);
         },
-        usage: "dss business-app save-settings <id> (--data JSON|--data-file PATH|--stdin)",
         description: "Save Business App settings (admin only; includes connection remapping).",
         examples: ["dss business-app save-settings my-bapp --data-file settings.json",],
     },
     instances: {
         handler: (c, a) => {
-            requireArgs(a, 1, "dss business-app instances <id>");
+            requireArgs(a, 1, commandUsage("business-app", "instances"));
             return c.applications.listBusinessAppInstances(a[0]);
         },
-        usage: "dss business-app instances <id>",
         description: "List instances of a Business App.",
         examples: ["dss business-app instances my-bapp",],
     },
     "create-instance": {
         handler: (c, a, f) => {
-            requireArgs(a, 1, "dss business-app create-instance <id> (--data JSON|--data-file PATH|--stdin)");
+            requireArgs(a, 1, commandUsage("business-app", "create-instance"));
             const body = requiredJsonInput(f, "--data, --data-file, or --stdin is required (instance payload).");
             return c.applications.createBusinessAppInstance(a[0], body);
         },
-        usage: "dss business-app create-instance <id> (--data JSON|--data-file PATH|--stdin)",
         description: "Create an instance of a Business App.",
         examples: ["dss business-app create-instance my-bapp --data '{}'",],
     },
     "upgrade-instance": {
         handler: (c, a) => {
-            requireArgs(a, 2, "dss business-app upgrade-instance <id> <projectKey>");
+            requireArgs(a, 2, commandUsage("business-app", "upgrade-instance"));
             return c.applications.upgradeBusinessAppInstance(a[0], a[1]);
         },
-        usage: "dss business-app upgrade-instance <id> <projectKey>",
         description: "Upgrade a Business App instance to the latest version.",
         examples: ["dss business-app upgrade-instance my-bapp INSTANCEPROJ",],
     },
     "install-from-archive": {
         handler: async (c, a) => {
-            requireArgs(a, 1, "dss business-app install-from-archive <filePath>");
+            requireArgs(a, 1, commandUsage("business-app", "install-from-archive"));
             await c.applications.installBusinessAppFromArchive(a[0]);
             return { installed: true, };
         },
-        usage: "dss business-app install-from-archive <filePath>",
         description: "Install or upgrade a Business App from a zip archive (admin only).",
         examples: ["dss business-app install-from-archive ./my-bapp.zip",],
     },
-};
+});

package/dist/src/cli/commands/code-env.js

@@ -1,9 +1,10 @@
 import { readFileSync, writeFileSync, } from "node:fs";
 import { ClientValidationError, } from "../../errors.js";
-import { stableHash, } from "../../utils/stable-hash.js";
+import { SHA256_HEX_PATTERN, stableHash, } from "../../utils/stable-hash.js";
 import { json, jsonInput, num, numFlag, parseBooleanOption, } from "../coerce.js";
 import { executionMode, } from "../flags.js";
 import { enqueueCliWarning, isNotFoundError, readIfExists, skipResult, } from "../output.js";
+import { commandUsage, withUsage, } from "../syntax.js";
 import { requireArgs, UsageError, } from "../usage.js";
 const CODE_ENV_LANGS = ["PYTHON", "R",];
 /** Validate a positional `<lang>` argument: required, must be PYTHON or R. */
@@ -24,10 +25,10 @@ function definitionHashMismatch(envLang, envName, expected, current) {
 function validateExpectHash(value) {
     if (value === undefined || value === false)
         return undefined;
-    if (typeof value !== "string" || !/^[0-9a-fA-F]{64}$/.test(value)) {
+    if (typeof value !== "string" || !SHA256_HEX_PATTERN.test(value)) {
         throw new ClientValidationError("Expected code env definition hash must be a 64-character SHA-256 hex digest.", "validation_failed", "Use the definitionHash value returned by dss code-env get.");
     }
-    return value;
+    return value.toLowerCase();
 }
 function codeEnvWait(flags) {
     return flags["no-wait"] !== true;
@@ -64,10 +65,10 @@ function codeEnvPackageList(flags) {
     }
     return packages;
 }
-export const codeEnvCommands = {
+export const codeEnvCommands = withUsage("code-env", {
     list: {
         handler: (c, _a, f) => {
-            const usage = "dss code-env list [--lang PYTHON|R]";
+            const usage = commandUsage("code-env", "list");
             const lang = f["lang"];
             return c.codeEnvs.list({
                 envLang: typeof lang === "string"
@@ -75,46 +76,42 @@ export const codeEnvCommands = {
                     : undefined,
             });
         },
-        usage: "dss code-env list [--lang PYTHON|R]",
         description: "List code environments, optionally filtered to one language.",
         examples: ["dss code-env list", "dss code-env list --lang PYTHON",],
     },
     get: {
         handler: (c, a) => {
-            const usage = "dss code-env get <lang> <name>";
+            const usage = commandUsage("code-env", "get");
             requireArgs(a, 2, usage);
             const envLang = requireEnvLang(a[0], usage);
             return c.codeEnvs.get(envLang, a[1]);
         },
-        usage: "dss code-env get <lang> <name>",
         description: "Get code environment details: requested vs installed packages, Python interpreter, deployment mode, and the stable definition hash (definitionHash) used by set-definition --expect-hash.",
         examples: ["dss code-env get PYTHON my_env",],
     },
     "get-definition": {
         handler: (c, a) => {
-            const usage = "dss code-env get-definition <lang> <name>";
+            const usage = commandUsage("code-env", "get-definition");
             requireArgs(a, 2, usage);
             const envLang = requireEnvLang(a[0], usage);
             return c.codeEnvs.getDefinition(envLang, a[1]);
         },
-        usage: "dss code-env get-definition <lang> <name>",
         description: "Get the raw code environment definition exactly as DSS stores it; capture its hash (definitionHash from code-env get) before replacing it with set-definition --expect-hash.",
         examples: ["dss code-env get-definition PYTHON my_env",],
     },
     "list-logs": {
         handler: (c, a) => {
-            const usage = "dss code-env list-logs <lang> <name>";
+            const usage = commandUsage("code-env", "list-logs");
             requireArgs(a, 2, usage);
             const envLang = requireEnvLang(a[0], usage);
             return c.codeEnvs.listLogs(envLang, a[1]);
         },
-        usage: "dss code-env list-logs <lang> <name>",
         description: "List the build log files DSS keeps for a code environment.",
         examples: ["dss code-env list-logs PYTHON my_env",],
     },
     "get-log": {
         handler: async (c, a, f) => {
-            const usage = "dss code-env get-log <lang> <name> <logName> [--max-lines N|--max-log-lines N] [--max-log-bytes N] [--output PATH]";
+            const usage = commandUsage("code-env", "get-log");
             requireArgs(a, 3, usage);
             const envLang = requireEnvLang(a[0], usage);
             const maxLines = numFlag(f, ["max-lines", "max-log-lines",]);
@@ -153,7 +150,6 @@ export const codeEnvCommands = {
             }
             return { ...result, envLang, envName: a[1], logName: a[2], };
         },
-        usage: "dss code-env get-log <lang> <name> <logName> [--max-lines N|--max-log-lines N] [--max-log-bytes N] [--output PATH]",
         description: "Fetch one code-env build log, bounded for safe output: the last --max-lines lines (default 500, 0 for all) and at most --max-log-bytes bytes (default 10 MiB, 0 for all). --output PATH writes the kept content to a file; stdout then carries the path metadata. A truncation warning names which cap hit.",
         examples: [
             "dss code-env get-log PYTHON my_env install.log --max-lines 200",
@@ -162,23 +158,22 @@ export const codeEnvCommands = {
     },
     version: {
         handler: (c, a) => {
-            const usage = "dss code-env version <lang> <name> <projectKey>";
+            const usage = commandUsage("code-env", "version");
             requireArgs(a, 3, usage);
             const envLang = requireEnvLang(a[0], usage);
             return c.codeEnvs.getVersionForProject(envLang, a[1], a[2]);
         },
-        usage: "dss code-env version <lang> <name> <projectKey>",
         description: "Resolve the code environment version a project uses (versioned automation environments); empty version for unversioned environments.",
         examples: ["dss code-env version PYTHON my_env MY_PROJ",],
     },
     create: {
         handler: async (c, a, f) => {
-            const usage = "dss code-env create <lang> <name> --deployment-mode MODE";
+            const usage = commandUsage("code-env", "create");
             requireArgs(a, 2, usage);
             const envLang = requireEnvLang(a[0], usage);
             const deploymentMode = f["deployment-mode"];
             if (!deploymentMode) {
-                throw new UsageError("--deployment-mode is required. Usage: dss code-env create <lang> <name> --deployment-mode MODE");
+                throw new UsageError(`--deployment-mode is required. Usage: ${commandUsage("code-env", "create")}`);
             }
             const params = codeEnvParams(f);
             const wait = codeEnvWait(f);
@@ -213,7 +208,6 @@ export const codeEnvCommands = {
             });
             return { created: a[1], resource: "code-env", envLang, ...created, };
         },
-        usage: "dss code-env create <lang> <name> --deployment-mode MODE [--params JSON|--data JSON|--data-file PATH|--stdin] [--python-interpreter PYTHON311] [--no-wait] [--if-not-exists] [--dry-run]",
         description: "Create a code environment; --no-wait hands back a DSS future payload you can settle with dss future wait.",
         examples: [
             "dss code-env create PYTHON my_env --deployment-mode DESIGN_MANAGED --python-interpreter PYTHON311",
@@ -222,12 +216,12 @@ export const codeEnvCommands = {
     },
     "set-definition": {
         handler: async (c, a, f) => {
-            const usage = "dss code-env set-definition <lang> <name> (--data JSON|--data-file PATH|--stdin) [--expect-hash SHA256]";
+            const usage = commandUsage("code-env", "set-definition");
             requireArgs(a, 2, usage);
             const envLang = requireEnvLang(a[0], usage);
             const definition = jsonInput(f);
             if (!definition) {
-                throw new UsageError("--data, --data-file, or --stdin is required. Usage: dss code-env set-definition <lang> <name> --data JSON");
+                throw new UsageError(`--data, --data-file, or --stdin is required. Usage: ${commandUsage("code-env", "set-definition")}`);
             }
             const expectHash = validateExpectHash(f["expect-hash"]);
             const definitionHash = stableHash(definition);
@@ -253,7 +247,6 @@ export const codeEnvCommands = {
             }
             return c.codeEnvs.setDefinition(envLang, a[1], definition, { expectHash, });
         },
-        usage: "dss code-env set-definition <lang> <name> (--data JSON|--data-file PATH|--stdin) [--expect-hash SHA256] [--dry-run]",
         description: "Replace a code environment definition previously fetched from DSS (get-definition). --expect-hash SHA256 refuses the PUT unless the current definition still hashes to the hash captured with code-env get, so concurrent edits are never clobbered; --dry-run also fetches the current definition and reports both hashes plus a changed flag.",
         examples: [
             "dss code-env set-definition PYTHON my_env --data-file code-env.json --expect-hash $HASH --dry-run",
@@ -261,7 +254,7 @@ export const codeEnvCommands = {
     },
     "set-packages": {
         handler: async (c, a, f) => {
-            const usage = "dss code-env set-packages <lang> <name> (--packages PKGS|--package PKG|--file PATH)";
+            const usage = commandUsage("code-env", "set-packages");
             requireArgs(a, 2, usage);
             const envLang = requireEnvLang(a[0], usage);
             const packages = codeEnvPackageList(f);
@@ -281,7 +274,6 @@ export const codeEnvCommands = {
             }
             return c.codeEnvs.setPackages(envLang, a[1], packages, { installCorePackages, expectHash, });
         },
-        usage: "dss code-env set-packages <lang> <name> (--packages PKGS|--package PKG|--file PATH) [--install-core-packages true|false] [--expect-hash SHA256] [--dry-run]",
         description: "Fetch the current definition, merge the requested package specs (and --install-core-packages) into it, then PUT the merged definition, so fields outside the package list are never dropped; --expect-hash refuses the merge when DSS changed since the hash was captured. The package list is replaced wholesale, so an explicitly empty --packages value or an empty --file clears the requested packages.",
         examples: [
             "dss code-env set-packages PYTHON my_env --packages 'tabulate\\nnameparser' --dry-run",
@@ -290,7 +282,7 @@ export const codeEnvCommands = {
     },
     "update-packages": {
         handler: async (c, a, f) => {
-            const usage = "dss code-env update-packages <lang> <name>";
+            const usage = commandUsage("code-env", "update-packages");
             requireArgs(a, 2, usage);
             const envLang = requireEnvLang(a[0], usage);
             const wait = codeEnvWait(f);
@@ -316,13 +308,12 @@ export const codeEnvCommands = {
             }
             return c.codeEnvs.updatePackages(envLang, a[1], opts);
         },
-        usage: "dss code-env update-packages <lang> <name> [--force-rebuild] [--env-version VERSION] [--no-wait] [--dry-run]",
         description: "Rebuild or update code environment packages to match the requested specs; --no-wait hands back a DSS future payload you can settle with dss future wait.",
         examples: ["dss code-env update-packages PYTHON my_env --force-rebuild --dry-run",],
     },
     "update-images": {
         handler: async (c, a, f) => {
-            const usage = "dss code-env update-images <lang> <name>";
+            const usage = commandUsage("code-env", "update-images");
             requireArgs(a, 2, usage);
             const envLang = requireEnvLang(a[0], usage);
             const wait = codeEnvWait(f);
@@ -340,7 +331,6 @@ export const codeEnvCommands = {
             }
             return c.codeEnvs.updateImages(envLang, a[1], { envVersion, wait, });
         },
-        usage: "dss code-env update-images <lang> <name> [--env-version VERSION] [--no-wait] [--dry-run]",
         description: "Rebuild the Docker image(s) of a code environment to match its settings; --env-version targets one version of a versioned environment and --no-wait hands back a DSS future payload you can settle with dss future wait.",
         examples: [
             "dss code-env update-images PYTHON my_env --dry-run",
@@ -349,12 +339,12 @@ export const codeEnvCommands = {
     },
     "set-jupyter": {
         handler: async (c, a, f) => {
-            const usage = "dss code-env set-jupyter <lang> <name> --active true|false";
+            const usage = commandUsage("code-env", "set-jupyter");
             requireArgs(a, 2, usage);
             const envLang = requireEnvLang(a[0], usage);
             const active = parseBooleanOption(f["active"], "--active");
             if (active === undefined) {
-                throw new UsageError("--active is required. Usage: dss code-env set-jupyter <lang> <name> --active true|false");
+                throw new UsageError(`--active is required. Usage: ${commandUsage("code-env", "set-jupyter")}`);
             }
             const wait = codeEnvWait(f);
             if (executionMode(f).dryRun) {
@@ -370,13 +360,12 @@ export const codeEnvCommands = {
             }
             return c.codeEnvs.setJupyterSupport(envLang, a[1], active, { wait, });
         },
-        usage: "dss code-env set-jupyter <lang> <name> --active true|false [--no-wait] [--dry-run]",
         description: "Enable or disable Jupyter support for a code environment; --no-wait hands back a DSS future payload you can settle with dss future wait.",
         examples: ["dss code-env set-jupyter PYTHON my_env --active true --dry-run",],
     },
     delete: {
         handler: async (c, a, f) => {
-            const usage = "dss code-env delete <lang> <name>";
+            const usage = commandUsage("code-env", "delete");
             requireArgs(a, 2, usage);
             const envLang = requireEnvLang(a[0], usage);
             const wait = codeEnvWait(f);
@@ -404,7 +393,6 @@ export const codeEnvCommands = {
             }
             return c.codeEnvs.delete(envLang, a[1], { wait, });
         },
-        usage: "dss code-env delete <lang> <name> [--no-wait] [--if-exists] [--dry-run]",
         description: "Delete a code environment; --no-wait hands back a DSS future payload you can settle with dss future wait.",
         examples: ["dss code-env delete PYTHON my_env --dry-run",],
     },
@@ -414,10 +402,9 @@ export const codeEnvCommands = {
                 return c.codeEnvs.listUsages();
             if (a.length === 2)
                 return c.codeEnvs.listUsages(a[0], a[1]);
-            throw new UsageError("Usage: dss code-env usages [<lang> <name>]");
+            throw new UsageError(`Usage: ${commandUsage("code-env", "usages")}`);
         },
-        usage: "dss code-env usages [<lang> <name>]",
         description: "List code environment usages globally or for one environment.",
         examples: ["dss code-env usages", "dss code-env usages PYTHON my_env",],
     },
-};
+});

package/dist/src/cli/commands/code.js

@@ -1,9 +1,9 @@
 import { readFileSync, } from "node:fs";
-import { ScenarioScriptRunWithCleanupFailureError, } from "../../resources/scenarios.js";
 import { num, readStdinText, stripUtf8Bom, } from "../coerce.js";
 import { enqueueCliWarning, } from "../output.js";
+import { commandUsage, withUsage, } from "../syntax.js";
 import { UsageError, } from "../usage.js";
-const CODE_RUN_USAGE = "dss code run (--file PATH | --stdin) [--env ENV] [--timeout MS (default 120000)] [--keep] [--full-log] [--max-log-bytes N (default 1048576)] [--project-key KEY]";
+const CODE_RUN_USAGE = commandUsage("code", "run");
 function previewFlagValue(value) {
     const text = typeof value === "string" ? value : String(value);
     return text.length <= 32 ? text : `${text.slice(0, 32)}…`;
@@ -78,13 +78,14 @@ function reportCleanupFailure(cleanupFailure) {
     });
 }
 function unwrapCodeRunError(error) {
+    const { ScenarioScriptRunWithCleanupFailureError, } = require("../../resources/scenarios.js");
     if (error instanceof ScenarioScriptRunWithCleanupFailureError) {
         reportCleanupFailure(error.cleanupFailure);
         return error.cause;
     }
     return error;
 }
-export const codeCommands = {
+export const codeCommands = withUsage("code", {
     run: {
         handler: async (c, a, f) => {
             const timeoutMs = parseCodeRunIntegerFlag(f["timeout"], "--timeout");
@@ -123,7 +124,6 @@ export const codeCommands = {
             }
             return result;
         },
-        usage: CODE_RUN_USAGE,
         description: "Run Python through a throwaway custom-python scenario and return captured output plus outcome. --timeout caps waiting; --max-log-bytes caps logs; --full-log returns the capped raw log. Exits 4 unless outcome is SUCCESS.",
         examples: [
             "dss code run --file inspect.py",
@@ -132,4 +132,4 @@ export const codeCommands = {
             "dss code run --file inspect.py --full-log",
         ],
     },
-};
+});