dataiku-sdk 3.3.0 → 3.5.0

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

@@ -2,6 +2,7 @@ import { sanitizeErrorSecrets, sanitizeSecrets, } from "../../utils/secret-sanit
 import { requiredJsonInput, } from "../coerce.js";
 import { executionMode, } from "../flags.js";
 import { readIfExists, skipResult, } from "../output.js";
+import { commandUsage, withUsage, } from "../syntax.js";
 import { requireArgs, UsageError, } from "../usage.js";
 /**
  * Keys of a connection payload that carry credentials. CLI plan/error/output
@@ -76,12 +77,11 @@ function requireConnectionName(value, usage) {
     }
     return trimmed;
 }
-export const connectionCommands = {
+export const connectionCommands = withUsage("connection", {
     list: {
         handler: (c, _a, f) => c.connections.list({
             type: f["type"],
         }),
-        usage: "dss connection list [--type TYPE]",
         description: "List all connection names, optionally filtered by connection type.",
         examples: ["dss connection list", "dss connection list --type Filesystem",],
     },
@@ -90,24 +90,22 @@ export const connectionCommands = {
             mode: f["mode"],
             projectKey: f["project-key"],
         }),
-        usage: "dss connection infer [--mode fast|rich] [--project-key KEY]",
         description: "List connections with inferred types and metadata.",
         examples: ["dss connection infer", "dss connection infer --mode rich",],
     },
     get: {
         handler: async (c, a) => {
-            const usage = "dss connection get <name>";
+            const usage = commandUsage("connection", "get");
             requireArgs(a, 1, usage);
             const details = await c.connections.adminGet(requireConnectionName(a[0], usage));
             return sanitizeConnectionSecrets(details);
         },
-        usage: "dss connection get <name>",
         description: "Get a connection by name (admin). Credential-bearing params (e.g. params.password) are redacted in output.",
         examples: ["dss connection get postgres",],
     },
     create: {
         handler: async (c, _a, f) => {
-            const usage = "dss connection create (--data JSON|--data-file PATH|--stdin)";
+            const usage = commandUsage("connection", "create");
             const body = requiredConnectionJson(f, usage);
             if (executionMode(f).dryRun) {
                 return {
@@ -127,7 +125,6 @@ export const connectionCommands = {
                 throw sanitizeConnectionError(error, connectionSecretsFromBody(body));
             }
         },
-        usage: "dss connection create (--data JSON|--data-file PATH|--stdin) [--dry-run]",
         description: 'Create a connection (admin). Body is the Connection definition, e.g. {"name":"new-connection","type":"PostgreSQL","params":{"host":"...","user":"...","password":"..."}}. Secrets are never echoed in errors or output.',
         examples: [
             `dss connection create --data '{"name":"new-connection","type":"PostgreSQL","params":{"db":"dbname","user":"myuser","password":"s3cret"}}'`,
@@ -135,7 +132,7 @@ export const connectionCommands = {
     },
     update: {
         handler: async (c, a, f) => {
-            const usage = "dss connection update <name> (--data JSON|--data-file PATH|--stdin) [--dry-run]";
+            const usage = commandUsage("connection", "update");
             requireArgs(a, 1, usage);
             const name = requireConnectionName(a[0], usage);
             const body = requiredConnectionJson(f, usage);
@@ -160,7 +157,6 @@ export const connectionCommands = {
                 throw sanitizeConnectionError(error, secrets);
             }
         },
-        usage: "dss connection update <name> (--data JSON|--data-file PATH|--stdin) [--dry-run]",
         description: "Update a connection (admin). The body MUST be the Connection object obtained from `dss connection get` (PUT semantics); type and name cannot be modified. Use --dry-run to preview the merged result without writing.",
         examples: [
             `dss connection update postgres --data '{"type":"PostgreSQL","name":"postgres","allowWrite":true,"params":{"db":"dbname","user":"myuser","password":"s3cret"}}'`,
@@ -168,7 +164,7 @@ export const connectionCommands = {
     },
     delete: {
         handler: async (c, a, f) => {
-            const usage = "dss connection delete <name> [--if-exists] [--dry-run]";
+            const usage = commandUsage("connection", "delete");
             requireArgs(a, 1, usage);
             const name = requireConnectionName(a[0], usage);
             if (executionMode(f).dryRun) {
@@ -191,18 +187,16 @@ export const connectionCommands = {
             }
             return c.connections.adminDelete(name);
         },
-        usage: "dss connection delete <name> [--if-exists] [--dry-run]",
         description: "Delete a connection (admin). Destructive: per the DSS docs no check is performed that the connection is not in use by a dataset.",
         examples: ["dss connection delete old-conn", "dss connection delete old-conn --if-exists",],
     },
     test: {
         handler: async (c, a) => {
-            const usage = "dss connection test <name>";
+            const usage = commandUsage("connection", "test");
             requireArgs(a, 1, usage);
             const result = await c.connections.adminTest(requireConnectionName(a[0], usage));
             return sanitizeConnectionSecrets(result);
         },
-        usage: "dss connection test <name>",
         description: "Test whether a connection is available (uses the same GET /connections/{name}/test route as the official Python client; returns connectionOK, errors when testing is unsupported for the type). Credential-bearing fields are redacted in output.",
         examples: ["dss connection test postgres",],
     },
@@ -210,14 +204,13 @@ export const connectionCommands = {
         handler: (c, _a, f) => {
             const connection = f["connection"];
             if (!connection) {
-                throw new UsageError("--connection is required. Usage: dss connection schemas --connection CONN");
+                throw new UsageError(`--connection is required. Usage: ${commandUsage("connection", "schemas")}`);
             }
             return c.connections.schemas({
                 connection,
                 projectKey: f["project-key"],
             });
         },
-        usage: "dss connection schemas --connection CONN [--project-key KEY]",
         description: "List schemas in a SQL connection.",
         examples: ["dss connection schemas --connection ATHENA_CONN --project-key MYPROJ",],
     },
@@ -225,7 +218,7 @@ export const connectionCommands = {
         handler: (c, _a, f) => {
             const connection = f["connection"];
             if (!connection) {
-                throw new UsageError("--connection is required. Usage: dss connection tables --connection CONN");
+                throw new UsageError(`--connection is required. Usage: ${commandUsage("connection", "tables")}`);
             }
             return c.connections.tables({
                 connection,
@@ -234,7 +227,6 @@ export const connectionCommands = {
                 projectKey: f["project-key"],
             });
         },
-        usage: "dss connection tables --connection CONN [--catalog CATALOG] [--schema SCHEMA] [--project-key KEY]",
         description: "List importable tables in a SQL connection, optionally scoped by catalog and schema.",
         examples: [
             "dss connection tables --connection ATHENA_CONN --schema analytics --project-key MYPROJ",
@@ -242,7 +234,7 @@ export const connectionCommands = {
     },
     "prepare-import": {
         handler: async (c, _a, f) => {
-            const usage = "dss connection prepare-import (--data JSON|--data-file PATH|--stdin) [--project-key KEY]";
+            const usage = commandUsage("connection", "prepare-import");
             const body = requiredJsonInput(f, `--data, --data-file, or --stdin is required (tables-import request). Usage: ${usage}`);
             const keys = body["keys"];
             if (!Array.isArray(keys) || keys.length === 0) {
@@ -273,7 +265,6 @@ export const connectionCommands = {
                 projectKey: f["project-key"],
             });
         },
-        usage: "dss connection prepare-import (--data JSON|--data-file PATH|--stdin) [--project-key KEY] [--dry-run]",
         description: 'Prepare the import of selected SQL or Hive tables (WRITE_CONF). Body is {"keys":[...]} per the DSS tables-import docs. Returns a DSS future; poll with `dss future wait <jobId>`.',
         examples: [
             `dss connection prepare-import --data '{"keys":[{"connectionName":"postgres","name":"my_table"}]}' --project-key MYPROJ`,
@@ -281,7 +272,7 @@ export const connectionCommands = {
     },
     "execute-import": {
         handler: async (c, _a, f) => {
-            const usage = "dss connection execute-import (--data JSON|--data-file PATH|--stdin) [--project-key KEY]";
+            const usage = commandUsage("connection", "execute-import");
             const body = requiredJsonInput(f, `--data, --data-file, or --stdin is required (tables-import request). Usage: ${usage}`);
             const sql = body["sqlImportCandidates"];
             const hive = body["hiveImportCandidates"];
@@ -311,10 +302,9 @@ export const connectionCommands = {
                 projectKey: f["project-key"],
             });
         },
-        usage: "dss connection execute-import (--data JSON|--data-file PATH|--stdin) [--project-key KEY] [--dry-run]",
         description: "Perform an import from SQL/Hive table candidates (WRITE_CONF). Body carries sqlImportCandidates and/or hiveImportCandidates per the DSS tables-import docs. Returns a DSS future.",
         examples: [
             `dss connection execute-import --data '{"sqlImportCandidates":[{"connectionName":"pgsql","table":"my_table","checked":false,"datasetName":"imported_from_db","existingDatasetsNames":[]}]}' --project-key MYPROJ`,
         ],
     },
-};
+});

package/dist/src/cli/commands/continuous-activity.js

@@ -1,38 +1,35 @@
 import { jsonInput, } from "../coerce.js";
+import { commandUsage, withUsage, } from "../syntax.js";
 import { requireArgs, } from "../usage.js";
-export const continuousActivityCommands = {
+export const continuousActivityCommands = withUsage("continuous-activity", {
     list: {
         handler: (c, _a, f) => c.continuousActivities.list(f["project-key"]),
-        usage: "dss continuous-activity list [--project-key KEY]",
         description: "List continuous activities in a project.",
         examples: ["dss continuous-activity list",],
     },
     status: {
         handler: (c, a, f) => {
-            requireArgs(a, 1, "dss continuous-activity status <recipeId> [--project-key KEY]");
+            requireArgs(a, 1, commandUsage("continuous-activity", "status"));
             return c.continuousActivities.getStatus(a[0], f["project-key"]);
         },
-        usage: "dss continuous-activity status <recipeId> [--project-key KEY]",
         description: "Get a continuous recipe's desired and effective state.",
         examples: ["dss continuous-activity status compute_stream",],
     },
     start: {
         handler: (c, a, f) => {
-            requireArgs(a, 1, "dss continuous-activity start <recipeId> [--data JSON|--data-file PATH|--stdin] [--project-key KEY]");
+            requireArgs(a, 1, commandUsage("continuous-activity", "start"));
             return c.continuousActivities.start(a[0], jsonInput(f), f["project-key"]);
         },
-        usage: "dss continuous-activity start <recipeId> [--data JSON|--data-file PATH|--stdin] [--project-key KEY]",
         description: "Start a continuous recipe (optional loop restart params via JSON).",
         examples: ["dss continuous-activity start compute_stream",],
     },
     stop: {
         handler: async (c, a, f) => {
-            requireArgs(a, 1, "dss continuous-activity stop <recipeId> [--project-key KEY]");
+            requireArgs(a, 1, commandUsage("continuous-activity", "stop"));
             await c.continuousActivities.stop(a[0], f["project-key"]);
             return { stopped: a[0], };
         },
-        usage: "dss continuous-activity stop <recipeId> [--project-key KEY]",
         description: "Stop a continuous recipe.",
         examples: ["dss continuous-activity stop compute_stream",],
     },
-};
+});

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

@@ -4,26 +4,25 @@ import { deepMerge, } from "../../utils/deep-merge.js";
 import { jsonInput, parseBooleanOption, } from "../coerce.js";
 import { executionMode, } from "../flags.js";
 import { readIfExists, skipResult, } from "../output.js";
+import { commandUsage, withUsage, } from "../syntax.js";
 import { requireArgs, UsageError, } from "../usage.js";
-export const dashboardCommands = {
+export const dashboardCommands = withUsage("dashboard", {
     list: {
         handler: (c, _a, f) => c.dashboards.list(f["project-key"]),
-        usage: "dss dashboard list [--project-key KEY]",
         description: "List project dashboards.",
         examples: ["dss dashboard list",],
     },
     get: {
         handler: (c, a, f) => {
-            requireArgs(a, 1, "dss dashboard get <id>");
+            requireArgs(a, 1, commandUsage("dashboard", "get"));
             return c.dashboards.get(a[0], f["project-key"]);
         },
-        usage: "dss dashboard get <id> [--project-key KEY]",
         description: "Get dashboard definition.",
         examples: ["dss dashboard get DASHBOARD_ID",],
     },
     export: {
         handler: async (c, a, f) => {
-            requireArgs(a, 1, "dss dashboard export <id> --output PATH [--paper-size SIZE] [--orientation PORTRAIT|LANDSCAPE] [--file-type PDF] [--slide-index N] [--project-key KEY]");
+            requireArgs(a, 1, commandUsage("dashboard", "export"));
             const outputPath = f["output"];
             if (typeof outputPath !== "string" || !outputPath.trim()) {
                 throw new UsageError("--output PATH is required.", "missing_required_flag");
@@ -86,7 +85,6 @@ export const dashboardCommands = {
                 slideIndex,
             };
         },
-        usage: "dss dashboard export <id> --output PATH [--paper-size SIZE] [--orientation PORTRAIT|LANDSCAPE] [--file-type PDF] [--slide-index N] [--project-key KEY]",
         description: "Render a dashboard page as PDF. Requires DSS graphics export to be configured.",
         examples: [
             "dss dashboard export DASHBOARD_ID --output dashboard.pdf",
@@ -101,7 +99,7 @@ export const dashboardCommands = {
             const name = flagName ?? (typeof settingsName === "string" ? settingsName : undefined);
             const listed = parseBooleanOption(f["listed"], "--listed");
             if (!name) {
-                throw new UsageError("--name or dashboard settings containing a string name are required. Usage: dss dashboard create --name NAME");
+                throw new UsageError(`--name or dashboard settings containing a string name are required. Usage: ${commandUsage("dashboard", "create")}`);
             }
             const payload = { ...(settings ?? { pages: [], }), name, };
             if (listed !== undefined)
@@ -131,7 +129,6 @@ export const dashboardCommands = {
             });
             return { created: created.id, resource: "dashboard", ...created, };
         },
-        usage: "dss dashboard create (--name NAME|--data JSON|--data-file PATH|--stdin) [--listed true|false] [--if-not-exists] [--dry-run] [--project-key KEY]",
         description: "Create a dashboard from raw settings or minimal name/listed fields. Defaults to an empty pages array.",
         examples: [
             "dss dashboard create --name 'Agent dashboard' --listed true --dry-run",
@@ -140,7 +137,7 @@ export const dashboardCommands = {
     },
     update: {
         handler: async (c, a, f) => {
-            requireArgs(a, 1, "dss dashboard update <id> [--name NAME|--listed true|false|--data JSON]");
+            requireArgs(a, 1, commandUsage("dashboard", "update"));
             const name = f["name"];
             const listed = parseBooleanOption(f["listed"], "--listed");
             const data = jsonInput(f);
@@ -163,13 +160,12 @@ export const dashboardCommands = {
                 projectKey: f["project-key"],
             });
         },
-        usage: "dss dashboard update <id> (--name NAME|--listed true|false|--data JSON|--data-file PATH|--stdin) [--dry-run] [--project-key KEY]",
         description: "Update dashboard settings via merge.",
         examples: ["dss dashboard update DASHBOARD_ID --listed true --dry-run",],
     },
     delete: {
         handler: async (c, a, f) => {
-            requireArgs(a, 1, "dss dashboard delete <id>");
+            requireArgs(a, 1, commandUsage("dashboard", "delete"));
             const pk = f["project-key"];
             if (executionMode(f).dryRun || f["if-exists"] === true) {
                 const current = await readIfExists(() => c.dashboards.get(a[0], pk));
@@ -182,8 +178,7 @@ export const dashboardCommands = {
             await c.dashboards.delete(a[0], pk);
             return { deleted: a[0], resource: "dashboard", };
         },
-        usage: "dss dashboard delete <id> [--if-exists] [--dry-run] [--project-key KEY]",
         description: "Delete a dashboard.",
         examples: ["dss dashboard delete DASHBOARD_ID --dry-run",],
     },
-};
+});

package/dist/src/cli/commands/data-collection.js

@@ -1,24 +1,23 @@
 import { requiredJsonInput, } from "../coerce.js";
 import { executionMode, } from "../flags.js";
 import { planResult, } from "../output.js";
+import { commandUsage, withUsage, } from "../syntax.js";
 import { requireArgs, UsageError, } from "../usage.js";
 const PLAN_FAILURE_CODES = { usage: 1, error: 2, transient: 3, };
 function collectionEndpoint(dataCollectionId, suffix = "") {
     return `/public/api/data-collections/${encodeURIComponent(dataCollectionId)}${suffix}`;
 }
-export const dataCollectionCommands = {
+export const dataCollectionCommands = withUsage("data-collection", {
     list: {
         handler: (c) => c.dataCollections.list(),
-        usage: "dss data-collection list",
         description: "List data collections on which the API key has READ privilege.",
         examples: ["dss data-collection list",],
     },
     get: {
         handler: (c, a) => {
-            requireArgs(a, 1, "dss data-collection get <dataCollectionId>");
+            requireArgs(a, 1, commandUsage("data-collection", "get"));
             return c.dataCollections.get(a[0]);
         },
-        usage: "dss data-collection get <dataCollectionId>",
         description: "Get collection settings. Permissions are omitted for non-admins.",
         examples: ["dss data-collection get OjVsTQ3O",],
     },
@@ -38,7 +37,6 @@ export const dataCollectionCommands = {
             }
             return c.dataCollections.create(body);
         },
-        usage: "dss data-collection create (--data JSON|--data-file PATH|--stdin) [--dry-run]",
         description: "Create a collection (creator becomes admin; requires mayCreateDataCollections).",
         examples: [
             'dss data-collection create --data \'{"displayName":"My Collection"}\'',
@@ -46,7 +44,7 @@ export const dataCollectionCommands = {
     },
     "settings-set": {
         handler: async (c, a, f) => {
-            requireArgs(a, 1, "dss data-collection settings-set <dataCollectionId> (--data JSON|--data-file PATH|--stdin) [--dry-run]");
+            requireArgs(a, 1, commandUsage("data-collection", "settings-set"));
             const settings = requiredJsonInput(f, "--data, --data-file, or --stdin is required (collection settings).");
             if (executionMode(f).dryRun) {
                 return planResult("data-collection", "settings-set", {
@@ -63,7 +61,6 @@ export const dataCollectionCommands = {
             const updated = await c.dataCollections.update(a[0], settings);
             return { updated: a[0], resource: "data-collection", ...updated, };
         },
-        usage: "dss data-collection settings-set <dataCollectionId> (--data JSON|--data-file PATH|--stdin) [--dry-run]",
         description: "Update collection settings; only send settings obtained through get. Admin required.",
         examples: [
             "dss data-collection settings-set OjVsTQ3O --data-file settings.json",
@@ -71,7 +68,7 @@ export const dataCollectionCommands = {
     },
     delete: {
         validate: (a) => {
-            const usage = "dss data-collection delete <dataCollectionId> [--dry-run]";
+            const usage = commandUsage("data-collection", "delete");
             requireArgs(a, 1, usage);
             if (a[0].trim().length === 0) {
                 throw new UsageError(`<dataCollectionId> must be a non-empty identifier. Usage: ${usage}`);
@@ -92,16 +89,14 @@ export const dataCollectionCommands = {
             await c.dataCollections.delete(a[0]);
             return { deleted: a[0], resource: "data-collection", };
         },
-        usage: "dss data-collection delete <dataCollectionId> [--dry-run]",
         description: "Permanently delete a collection. Admin required.",
         examples: ["dss data-collection delete OjVsTQ3O --dry-run",],
     },
     "list-objects": {
         handler: (c, a) => {
-            requireArgs(a, 1, "dss data-collection list-objects <dataCollectionId>");
+            requireArgs(a, 1, commandUsage("data-collection", "list-objects"));
             return c.dataCollections.listObjects(a[0]);
         },
-        usage: "dss data-collection list-objects <dataCollectionId>",
         description: "List the objects in a collection.",
         examples: ["dss data-collection list-objects OjVsTQ3O",],
     },
@@ -111,7 +106,7 @@ export const dataCollectionCommands = {
             const collectionId = a[0]
                 ?? (typeof object.dataCollectionId === "string" ? object.dataCollectionId : undefined);
             if (!collectionId) {
-                throw new UsageError("Usage: dss data-collection add-object <dataCollectionId> (--data JSON|--data-file PATH|--stdin)");
+                throw new UsageError(`Usage: ${commandUsage("data-collection", "add-object")}`);
             }
             const reference = { ...object, };
             delete reference.dataCollectionId;
@@ -130,7 +125,6 @@ export const dataCollectionCommands = {
             await c.dataCollections.addObject(collectionId, reference);
             return { added: reference.id, dataCollectionId: collectionId, resource: "data-collection", };
         },
-        usage: "dss data-collection add-object <dataCollectionId> (--data JSON|--data-file PATH|--stdin) [--dry-run]",
         description: "Add an object (e.g. {type:'DATASET',projectKey:'K',id:'name'}) to a collection. Contributor required.",
         examples: [
             'dss data-collection add-object OjVsTQ3O --data \'{"type":"DATASET","projectKey":"MYPROJECT","id":"orders"}\'',
@@ -138,7 +132,7 @@ export const dataCollectionCommands = {
     },
     "remove-dataset": {
         handler: async (c, a, f) => {
-            requireArgs(a, 3, "dss data-collection remove-dataset <dataCollectionId> <projectKey> <datasetName> [--dry-run]");
+            requireArgs(a, 3, commandUsage("data-collection", "remove-dataset"));
             if (executionMode(f).dryRun) {
                 return planResult("data-collection", "remove-dataset", {
                     asyncKind: "none",
@@ -157,8 +151,7 @@ export const dataCollectionCommands = {
             await c.dataCollections.removeDataset(a[0], a[1], a[2]);
             return { removed: a[2], projectKey: a[1], dataCollectionId: a[0], resource: "data-collection", };
         },
-        usage: "dss data-collection remove-dataset <dataCollectionId> <projectKey> <datasetName> [--dry-run]",
         description: "Remove a dataset from a collection. Contributor required.",
         examples: ["dss data-collection remove-dataset OjVsTQ3O MYPROJECT DATASET1",],
     },
-};
+});

package/dist/src/cli/commands/data-quality.js

@@ -2,6 +2,7 @@ import { deepMerge, } from "../../utils/deep-merge.js";
 import { num, parseBooleanOption, requiredJsonInput, } from "../coerce.js";
 import { executionMode, } from "../flags.js";
 import { encodedProjectEndpoint, readIfExists, skipResult, } from "../output.js";
+import { commandUsage, withUsage, } from "../syntax.js";
 import { requireArgs, UsageError, } from "../usage.js";
 /**
  * A data quality result counts as passing only when it actually carries a
@@ -15,37 +16,34 @@ function resultReportsOk(result) {
         .map((value) => value.trim().toUpperCase());
     return verdicts.length > 0 && verdicts.every((value) => value === "OK");
 }
-export const dataQualityCommands = {
+export const dataQualityCommands = withUsage("data-quality", {
     rules: {
         handler: (c, a, f) => {
-            requireArgs(a, 1, "dss data-quality rules <dataset>");
+            requireArgs(a, 1, commandUsage("data-quality", "rules"));
             return c.dataQuality.listRules(a[0], f["project-key"]);
         },
-        usage: "dss data-quality rules <dataset> [--project-key KEY]",
         description: "List data quality rules for a dataset.",
         examples: ["dss data-quality rules orders",],
     },
     "get-rule": {
         handler: (c, a, f) => {
-            requireArgs(a, 2, "dss data-quality get-rule <dataset> <rule-id>");
+            requireArgs(a, 2, commandUsage("data-quality", "get-rule"));
             return c.dataQuality.getRule(a[0], a[1], f["project-key"]);
         },
-        usage: "dss data-quality get-rule <dataset> <rule-id> [--project-key KEY]",
         description: "Get one data quality rule by id.",
         examples: ["dss data-quality get-rule orders RULE_ID",],
     },
     status: {
         handler: (c, a, f) => {
-            requireArgs(a, 1, "dss data-quality status <dataset>");
+            requireArgs(a, 1, commandUsage("data-quality", "status"));
             return c.dataQuality.status(a[0], f["project-key"]);
         },
-        usage: "dss data-quality status <dataset> [--project-key KEY]",
         description: "Get the aggregate data quality status for a dataset.",
         examples: ["dss data-quality status orders",],
     },
     "create-rule": {
         handler: async (c, a, f) => {
-            requireArgs(a, 1, "dss data-quality create-rule <dataset> --data JSON");
+            requireArgs(a, 1, commandUsage("data-quality", "create-rule"));
             const config = requiredJsonInput(f, "--data, --data-file, or --stdin is required.");
             const pk = f["project-key"];
             const identity = typeof config.id === "string"
@@ -88,7 +86,6 @@ export const dataQualityCommands = {
                 ...created,
             };
         },
-        usage: "dss data-quality create-rule <dataset> (--data JSON|--data-file PATH|--stdin) [--if-not-exists] [--dry-run] [--project-key KEY]",
         description: "Create a data quality rule from raw rule config.",
         examples: [
             'dss data-quality create-rule orders --data \'{"type":"RecordCountInRangeRule","softMinimum":1,"softMinimumEnabled":true,"displayName":"Has rows"}\' --dry-run',
@@ -96,7 +93,7 @@ export const dataQualityCommands = {
     },
     "update-rule": {
         handler: async (c, a, f) => {
-            requireArgs(a, 2, "dss data-quality update-rule <dataset> <rule-id> --data JSON");
+            requireArgs(a, 2, commandUsage("data-quality", "update-rule"));
             const data = requiredJsonInput(f, "--data, --data-file, or --stdin is required.");
             if (executionMode(f).dryRun) {
                 const current = await c.dataQuality.getRule(a[0], a[1], f["project-key"]);
@@ -116,7 +113,6 @@ export const dataQualityCommands = {
                 projectKey: f["project-key"],
             });
         },
-        usage: "dss data-quality update-rule <dataset> <rule-id> (--data JSON|--data-file PATH|--stdin) [--dry-run] [--project-key KEY]",
         description: "Update a data quality rule via GET-before-PUT merge.",
         examples: [
             "dss data-quality update-rule orders RULE_ID --data '{\"enabled\":false}' --dry-run",
@@ -124,7 +120,7 @@ export const dataQualityCommands = {
     },
     "delete-rule": {
         handler: async (c, a, f) => {
-            requireArgs(a, 2, "dss data-quality delete-rule <dataset> <rule-id>");
+            requireArgs(a, 2, commandUsage("data-quality", "delete-rule"));
             const pk = f["project-key"];
             if (executionMode(f).dryRun || f["if-exists"] === true) {
                 const current = await readIfExists(() => c.dataQuality.getRule(a[0], a[1], pk));
@@ -144,38 +140,35 @@ export const dataQualityCommands = {
             await c.dataQuality.deleteRule(a[0], a[1], pk);
             return { deleted: a[1], dataset: a[0], resource: "data-quality", };
         },
-        usage: "dss data-quality delete-rule <dataset> <rule-id> [--if-exists] [--dry-run] [--project-key KEY]",
         description: "Delete a data quality rule.",
         examples: ["dss data-quality delete-rule orders RULE_ID --dry-run",],
     },
     "status-by-partition": {
         handler: (c, a, f) => {
-            requireArgs(a, 1, "dss data-quality status-by-partition <dataset>");
+            requireArgs(a, 1, commandUsage("data-quality", "status-by-partition"));
             return c.dataQuality.statusByPartition(a[0], {
                 includeAllPartitions: f["include-all-partitions"] === true,
                 projectKey: f["project-key"],
             });
         },
-        usage: "dss data-quality status-by-partition <dataset> [--include-all-partitions] [--project-key KEY]",
         description: "Get data quality status by dataset partition.",
         examples: ["dss data-quality status-by-partition orders --include-all-partitions",],
     },
     "last-results": {
         handler: (c, a, f) => {
-            requireArgs(a, 1, "dss data-quality last-results <dataset>");
+            requireArgs(a, 1, commandUsage("data-quality", "last-results"));
             return c.dataQuality.lastResults(a[0], {
                 partition: f["partition"],
                 ruleId: f["rule-id"],
                 projectKey: f["project-key"],
             });
         },
-        usage: "dss data-quality last-results <dataset> [--partition P] [--rule-id ID] [--project-key KEY]",
         description: "Get latest data quality rule results for a dataset.",
         examples: ["dss data-quality last-results orders",],
     },
     "assert-results": {
         handler: async (c, a, f) => {
-            requireArgs(a, 1, "dss data-quality assert-results <dataset>");
+            requireArgs(a, 1, commandUsage("data-quality", "assert-results"));
             const ruleId = f["rule-id"];
             const pk = f["project-key"];
             const results = await c.dataQuality.lastResults(a[0], { ruleId, projectKey: pk, });
@@ -196,7 +189,6 @@ export const dataQualityCommands = {
                 ...(selected.length === 0 ? { reason: "no_results", } : {}),
             };
         },
-        usage: "dss data-quality assert-results <dataset> [--rule-id ID] [--project-key KEY]",
         description: "Assert the latest data quality results: at least one selected rule must exist and every selected result must report OK. Returns { satisfied, checked, failed } with failed rule ids/outcomes only; a failed assertion exits 4 with assertion_failed.",
         examples: [
             "dss data-quality assert-results orders",
@@ -205,7 +197,7 @@ export const dataQualityCommands = {
     },
     history: {
         handler: (c, a, f) => {
-            requireArgs(a, 1, "dss data-quality history <dataset>");
+            requireArgs(a, 1, commandUsage("data-quality", "history"));
             return c.dataQuality.history(a[0], {
                 minTimestamp: num(f["min-timestamp"], "--min-timestamp"),
                 maxTimestamp: num(f["max-timestamp"], "--max-timestamp"),
@@ -215,7 +207,6 @@ export const dataQualityCommands = {
                 projectKey: f["project-key"],
             });
         },
-        usage: "dss data-quality history <dataset> [--rule-id ID] [--min-timestamp MS] [--max-timestamp MS] [--results-per-page N] [--page N] [--project-key KEY]",
         description: "Get data quality rule execution history.",
         examples: ["dss data-quality history orders --results-per-page 100",],
     },
@@ -224,7 +215,6 @@ export const dataQualityCommands = {
             onlyMonitored: parseBooleanOption(f["only-monitored"], "--only-monitored"),
             projectKey: f["project-key"],
         }),
-        usage: "dss data-quality project-status [--only-monitored true|false] [--project-key KEY]",
         description: "Get project-level data quality status by dataset.",
         examples: ["dss data-quality project-status --only-monitored false",],
     },
@@ -234,13 +224,12 @@ export const dataQualityCommands = {
             maxTimestamp: num(f["max-timestamp"], "--max-timestamp"),
             projectKey: f["project-key"],
         }),
-        usage: "dss data-quality project-timeline [--min-timestamp MS] [--max-timestamp MS] [--project-key KEY]",
         description: "Get project-level data quality timeline aggregates.",
         examples: ["dss data-quality project-timeline --min-timestamp 1714521600000",],
     },
     compute: {
         handler: async (c, a, f) => {
-            requireArgs(a, 1, "dss data-quality compute <dataset>");
+            requireArgs(a, 1, commandUsage("data-quality", "compute"));
             const pk = f["project-key"];
             const options = {
                 partition: f["partition"],
@@ -268,11 +257,10 @@ export const dataQualityCommands = {
                 return c.dataQuality.computeRulesAndWait(a[0], options);
             return c.dataQuality.computeRules(a[0], options);
         },
-        usage: "dss data-quality compute <dataset> [--partition P] [--rule-id ID] [--wait] [--timeout MS] [--poll-interval MS] [--dry-run] [--project-key KEY]",
         description: "Start data quality rule computation, optionally waiting on the returned DSS future.",
         examples: [
             "dss data-quality compute orders --dry-run",
             "dss data-quality compute orders --wait",
         ],
     },
-};
+});