dataiku-sdk 3.0.0 → 3.2.0

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

@@ -1,5 +1,6 @@
 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 { requireArgs, UsageError, } from "../usage.js";
 /**
@@ -52,20 +53,20 @@ export const dataQualityCommands = {
                 : typeof config.displayName === "string"
                     ? config.displayName
                     : undefined;
-            if (f["if-not-exists"] === true || f["dry-run"] === true) {
+            if (f["if-not-exists"] === true || executionMode(f).dryRun) {
                 const existing = identity
                     ? (await c.dataQuality.listRules(a[0], pk)).find((rule) => rule.id === identity || rule.displayName === identity)
                     : undefined;
-                if (existing && f["if-not-exists"] === true && f["dry-run"] !== true) {
+                if (existing && f["if-not-exists"] === true && !executionMode(f).dryRun) {
                     return skipResult("data-quality", identity ?? existing.id, "exists", {
                         dataset: a[0],
                         current: existing,
                     });
                 }
-                if (f["if-not-exists"] === true && !identity && f["dry-run"] !== true) {
+                if (f["if-not-exists"] === true && !identity && !executionMode(f).dryRun) {
                     throw new UsageError("--if-not-exists requires rule id or displayName in the rule JSON.");
                 }
-                if (f["dry-run"] === true) {
+                if (executionMode(f).dryRun) {
                     return {
                         dryRun: true,
                         action: "create-rule",
@@ -97,7 +98,7 @@ export const dataQualityCommands = {
         handler: async (c, a, f) => {
             requireArgs(a, 2, "dss data-quality update-rule <dataset> <rule-id> --data JSON");
             const data = requiredJsonInput(f, "--data, --data-file, or --stdin is required.");
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 const current = await c.dataQuality.getRule(a[0], a[1], f["project-key"]);
                 const next = deepMerge(current, data);
                 return {
@@ -125,11 +126,11 @@ export const dataQualityCommands = {
         handler: async (c, a, f) => {
             requireArgs(a, 2, "dss data-quality delete-rule <dataset> <rule-id>");
             const pk = f["project-key"];
-            if (f["dry-run"] === true || f["if-exists"] === true) {
+            if (executionMode(f).dryRun || f["if-exists"] === true) {
                 const current = await readIfExists(() => c.dataQuality.getRule(a[0], a[1], pk));
                 if (!current)
                     return skipResult("data-quality", a[1], "missing", { dataset: a[0], });
-                if (f["dry-run"] === true) {
+                if (executionMode(f).dryRun) {
                     return {
                         dryRun: true,
                         action: "delete-rule",
@@ -248,7 +249,7 @@ export const dataQualityCommands = {
                 projectKey: pk,
                 timeoutMs: num(f["timeout"], "--timeout"),
             };
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 const params = new URLSearchParams();
                 params.set("partition", options.partition?.trim() ? options.partition : "NP");
                 if (options.ruleId !== undefined)

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

@@ -2,6 +2,7 @@ import { buildDatasetCloneSettings, } from "../../resources/datasets.js";
 import { deepMerge, } from "../../utils/deep-merge.js";
 import { compareStrings, stableHash, } from "../../utils/stable-hash.js";
 import { jsonInput, num, schemaColumnsInput, unknownJsonInput, } from "../coerce.js";
+import { executionMode, } from "../flags.js";
 import { datasetSourceSummary, } from "../helpers/dataset.js";
 import { moveCreatedItemsToZone, resolveFlowZoneIdFromFlags, } from "../helpers/flow-zone.js";
 import { enqueueCliWarning, readIfExists, skipResult, } from "../output.js";
@@ -195,7 +196,7 @@ export const datasetCommands = {
             requireArgs(a, 1, usage);
             const columns = schemaColumnsInput(f, usage);
             const pk = f["project-key"];
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 const current = await c.datasets.schema(a[0], pk);
                 return {
                     dryRun: true,
@@ -314,6 +315,7 @@ export const datasetCommands = {
                 outputPath: f["output"],
                 projectKey: f["project-key"],
                 limit: num(f["limit"], "--limit"),
+                rawData: f["raw-data"] === true,
             });
             if (result.truncated) {
                 enqueueCliWarning({
@@ -337,9 +339,13 @@ export const datasetCommands = {
             }
             return result;
         },
-        usage: "dss dataset download <name> [--output PATH] [--limit N] [--project-key KEY]",
-        description: "Download up to --limit rows (default 100k) as CSV; returns { path, rows, truncated, limit }. When truncated, a dataset_download_truncated warning is written to stderr; when --output is omitted, a dataset_download_default_location warning names the file's path in the working directory so the write is never silent.",
-        examples: ["dss dataset download orders", "dss dataset download orders --output ./data/",],
+        usage: "dss dataset download <name> [--output PATH] [--limit N] [--raw-data] [--project-key KEY]",
+        description: "Download up to --limit rows (default 100k) as CSV and return { path, rows, truncated, limit }. Formula-like cells are neutralized for spreadsheets; --raw-data preserves exact bytes. Warnings report truncation and the default output path.",
+        examples: [
+            "dss dataset download orders",
+            "dss dataset download orders --output ./data/",
+            "dss dataset download orders --raw-data",
+        ],
     },
     create: {
         handler: async (c, _a, f) => {
@@ -360,13 +366,13 @@ export const datasetCommands = {
                 projectKey: pk,
             };
             const zoneId = await resolveFlowZoneIdFromFlags(c, f, pk);
-            if (f["if-not-exists"] === true || f["dry-run"] === true) {
+            if (f["if-not-exists"] === true || executionMode(f).dryRun) {
                 const list = await c.datasets.list(pk);
                 const existing = list.find((d) => d.name === name);
-                if (existing && f["if-not-exists"] === true && f["dry-run"] !== true) {
+                if (existing && f["if-not-exists"] === true && !executionMode(f).dryRun) {
                     return skipResult("dataset", name, "exists", { current: existing, });
                 }
-                if (f["dry-run"] === true) {
+                if (executionMode(f).dryRun) {
                     return {
                         dryRun: true,
                         action: "create",
@@ -405,7 +411,7 @@ export const datasetCommands = {
             const current = await c.datasets.get(a[0], pk);
             const next = buildDatasetCloneSettings(current, a[1], pk ?? c.resolveProjectKey(pk), opts);
             const zoneId = await resolveFlowZoneIdFromFlags(c, f, pk);
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return {
                     dryRun: true,
                     action: "clone",
@@ -432,11 +438,11 @@ export const datasetCommands = {
         handler: async (c, a, f) => {
             requireArgs(a, 1, "dss dataset delete <name>");
             const pk = f["project-key"];
-            if (f["dry-run"] === true || f["if-exists"] === true) {
+            if (executionMode(f).dryRun || f["if-exists"] === true) {
                 const current = await readIfExists(() => c.datasets.get(a[0], pk));
                 if (!current)
                     return skipResult("dataset", a[0], "missing");
-                if (f["dry-run"] === true) {
+                if (executionMode(f).dryRun) {
                     return { dryRun: true, action: "delete", resource: "dataset", name: a[0], current, };
                 }
             }
@@ -455,7 +461,7 @@ export const datasetCommands = {
                 throw new UsageError("--data, --data-file, or --stdin is required. Usage: dss dataset update <name> [--data '{...}' | --data-file PATH | --stdin]");
             }
             const pk = f["project-key"];
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 const current = await c.datasets.get(a[0], pk);
                 const next = deepMerge(current, data);
                 return { dryRun: true, action: "update", resource: "dataset", name: a[0], current, next, };

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

@@ -1,7 +1,9 @@
-import { runDoctor, } from "../doctor.js";
 export const doctorCommands = {
     run: {
-        handler: async (_c, _a, f) => (await runDoctor(f)).result,
+        handler: async (_c, _a, f) => {
+            const { runDoctor, } = await import("../doctor.js");
+            return (await runDoctor(f)).result;
+        },
         usage: "dss doctor [--project-key KEY] [--capabilities] [--fast]",
         description: "Run JSON diagnostics for DSS credentials, connectivity, and project access.",
         examples: ["dss doctor", "dss doctor --project-key MYPROJ", "dss doctor --capabilities --fast",],

package/dist/src/cli/commands/flow-zone.js

@@ -1,5 +1,7 @@
+import { ClientValidationError, } from "../../errors.js";
 import { deepMerge, } from "../../utils/deep-merge.js";
-import { ensureFlowZonePlanTarget, findFlowZoneForPlan, flowZoneColor, flowZoneContains, flowZoneCurrentPosition, flowZoneDetailSummary, flowZoneId, flowZoneMoveItems, flowZoneName, flowZoneOrganizeStep, flowZonePlanItemKeys, flowZonePruneItems, flowZoneSamePosition, flowZoneSummary, readFlowZoneOrganizePlan, resolveFlowZoneIdFromFlags, throwFlowZoneValidationError, validateFlowZoneOrganizeObjects, } from "../helpers/flow-zone.js";
+import { executionMode, } from "../flags.js";
+import { ensureFlowZonePlanTarget, findFlowZoneForPlan, flowZoneColor, flowZoneContains, flowZoneCurrentPosition, flowZoneDetailSummary, flowZoneId, flowZoneMoveDelta, flowZoneMoveItems, flowZoneName, flowZoneOrganizeStep, flowZonePlanFromZones, flowZonePlanItemKeys, flowZonePruneItems, flowZoneSamePosition, flowZoneSummary, readFlowZoneOrganizePlan, resolveFlowZoneIdFromFlags, throwFlowZoneValidationError, validateFlowZoneOrganizeObjects, } from "../helpers/flow-zone.js";
 import { readIfExists, skipResult, } from "../output.js";
 import { requireArgs, UsageError, } from "../usage.js";
 export const flowZoneCommands = {
@@ -62,13 +64,13 @@ export const flowZoneCommands = {
                 color: flowZoneColor(f["color"]),
                 projectKey: pk,
             };
-            if (f["if-not-exists"] === true || f["dry-run"] === true) {
+            if (f["if-not-exists"] === true || executionMode(f).dryRun) {
                 const list = await c.flowZones.list(pk);
                 const existing = list.find((zone) => zone.name === name);
-                if (existing && f["if-not-exists"] === true && f["dry-run"] !== true) {
+                if (existing && f["if-not-exists"] === true && !executionMode(f).dryRun) {
                     return skipResult("flow-zone", existing.id, "exists", { current: existing, });
                 }
-                if (f["dry-run"] === true) {
+                if (executionMode(f).dryRun) {
                     return {
                         dryRun: true,
                         action: "create",
@@ -102,7 +104,7 @@ export const flowZoneCommands = {
                 color: flowZoneColor(f["color"]),
                 projectKey: pk,
             };
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 const current = await c.flowZones.get(zoneId, pk);
                 const next = deepMerge(current, patch);
                 return { dryRun: true, action: "update", resource: "flow-zone", id: zoneId, current, next, };
@@ -117,11 +119,11 @@ export const flowZoneCommands = {
         handler: async (c, a, f) => {
             requireArgs(a, 1, "dss flow-zone delete <id>");
             const zoneId = flowZoneId(a[0]);
-            if (f["dry-run"] === true || f["if-exists"] === true) {
+            if (executionMode(f).dryRun || f["if-exists"] === true) {
                 const current = await readIfExists(() => c.flowZones.get(zoneId, f["project-key"]));
                 if (!current)
                     return skipResult("flow-zone", zoneId, "missing");
-                if (f["dry-run"] === true) {
+                if (executionMode(f).dryRun) {
                     return { dryRun: true, action: "delete", resource: "flow-zone", id: zoneId, current, };
                 }
             }
@@ -146,7 +148,7 @@ export const flowZoneCommands = {
             if (items.length === 0) {
                 throw new UsageError("At least one object is required. Use --dataset, --recipe, --folder, or --object TYPE:ID.");
             }
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return {
                     dryRun: true,
                     action: "move",
@@ -166,6 +168,19 @@ export const flowZoneCommands = {
             "dss flow-zone move ZONE_ID --object SAVED_MODEL:model_id",
         ],
     },
+    plan: {
+        handler: async (c, _a, f) => {
+            const pk = f["project-key"];
+            const [zones, topologyFingerprint,] = await Promise.all([
+                c.flowZones.list(pk),
+                c.projects.topologyFingerprint(pk),
+            ]);
+            return flowZonePlanFromZones(zones, topologyFingerprint);
+        },
+        usage: "dss flow-zone plan [--project-key KEY]",
+        description: "Export current visual flow-zone organization as an organize-compatible plan.",
+        examples: ["dss flow-zone plan --project-key MYPROJ",],
+    },
     organize: {
         handler: async (c, _a, f) => {
             const usage = "dss flow-zone organize (--data JSON|--data-file PATH|--file PATH|--stdin) [--sync] [--validate-objects] [--dry-run] [--project-key KEY]";
@@ -173,7 +188,13 @@ export const flowZoneCommands = {
             const plan = readFlowZoneOrganizePlan(f, usage);
             const sync = f["sync"] === true;
             const validateObjects = f["validate-objects"] === true;
-            const zones = await c.flowZones.list(pk);
+            const [zones, topologyFingerprint,] = await Promise.all([
+                c.flowZones.list(pk),
+                c.projects.topologyFingerprint(pk),
+            ]);
+            if (plan.topologyFingerprint && plan.topologyFingerprint !== topologyFingerprint) {
+                throw new ClientValidationError("Flow topology changed after this visual organization plan was generated.", "assertion_failed", "Regenerate the plan with dss flow-zone plan, then review it before applying.", { expected: plan.topologyFingerprint, actual: topologyFingerprint, });
+            }
             const plannedItemKeys = flowZonePlanItemKeys(plan);
             const planned = plan.zones.map((zonePlan) => flowZoneOrganizeStep(zonePlan, findFlowZoneForPlan(zones, zonePlan), sync, plannedItemKeys));
             const validation = validateObjects
@@ -186,7 +207,7 @@ export const flowZoneCommands = {
                 const pruneItems = Array.isArray(step.pruneItems) ? step.pruneItems : [];
                 return count + pruneItems.length;
             }, 0);
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return {
                     dryRun: true,
                     action: "organize",
@@ -194,6 +215,7 @@ export const flowZoneCommands = {
                     projectKey: pk,
                     sync,
                     validateObjects,
+                    topologyFingerprint,
                     zoneCount: plan.zones.length,
                     itemCount,
                     pruneItemCount,
@@ -209,6 +231,7 @@ export const flowZoneCommands = {
             for (const zonePlan of plan.zones) {
                 let zone = findFlowZoneForPlan(currentZones, zonePlan);
                 ensureFlowZonePlanTarget(zonePlan, zone);
+                const moveItems = flowZoneMoveDelta(zone, zonePlan.items);
                 const pruneItems = sync ? flowZonePruneItems(zone, plannedItemKeys) : [];
                 if (!zone) {
                     zone = await c.flowZones.create({
@@ -238,15 +261,19 @@ export const flowZoneCommands = {
                         updated.push(zone);
                     }
                 }
-                if (zonePlan.items.length > 0) {
-                    await c.flowZones.moveItems(zone.id, zonePlan.items, pk);
-                    moved.push({ zoneId: zone.id, name: zone.name, items: zonePlan.items, });
+                if (moveItems.length > 0) {
+                    await c.flowZones.moveItems(zone.id, moveItems, pk);
+                    moved.push({ zoneId: zone.id, name: zone.name, items: moveItems, });
                 }
                 if (pruneItems.length > 0) {
                     await c.flowZones.moveItems("default", pruneItems, pk);
                     pruned.push({ zoneId: "default", fromZoneId: zone.id, name: zone.name, items: pruneItems, });
                 }
             }
+            const topologyFingerprintAfter = await c.projects.topologyFingerprint(pk);
+            if (topologyFingerprintAfter !== topologyFingerprint) {
+                throw new ClientValidationError("Visual flow-zone changes modified flow topology.", "assertion_failed", "Inspect the flow before applying any further organization changes.", { before: topologyFingerprint, after: topologyFingerprintAfter, });
+            }
             return {
                 organized: true,
                 action: "organize",
@@ -254,6 +281,8 @@ export const flowZoneCommands = {
                 projectKey: pk,
                 sync,
                 validateObjects,
+                topologyFingerprint,
+                topologyUnchanged: true,
                 zoneCount: plan.zones.length,
                 itemCount,
                 pruneItemCount,

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

@@ -1,5 +1,6 @@
 import { deepMerge, } from "../../utils/deep-merge.js";
 import { jsonInput, } from "../coerce.js";
+import { executionMode, } from "../flags.js";
 import { addTransientTargetContext, encodedProjectEndpoint, readIfExists, skipResult, } from "../output.js";
 import { requireArgs, UsageError, } from "../usage.js";
 async function resolveFolderId(client, nameOrId, flags) {
@@ -28,13 +29,13 @@ export const folderCommands = {
                 path: f["path"],
                 projectKey: pk,
             };
-            if (f["if-not-exists"] === true || f["dry-run"] === true) {
+            if (f["if-not-exists"] === true || executionMode(f).dryRun) {
                 const list = await c.folders.list(pk);
                 const existing = list.find((folder) => folder.name === name);
-                if (existing && f["if-not-exists"] === true && f["dry-run"] !== true) {
+                if (existing && f["if-not-exists"] === true && !executionMode(f).dryRun) {
                     return skipResult("folder", existing.id ?? name, "exists", { current: existing, });
                 }
-                if (f["dry-run"] === true) {
+                if (executionMode(f).dryRun) {
                     return {
                         dryRun: true,
                         action: "create",
@@ -74,7 +75,7 @@ export const folderCommands = {
             }
             const pk = f["project-key"];
             const folderId = await resolveFolderId(c, a[0], f);
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 const current = await c.folders.get(folderId, pk);
                 const next = deepMerge(current, data);
                 return {
@@ -102,11 +103,11 @@ export const folderCommands = {
             requireArgs(a, 1, "dss folder delete <name-or-id>");
             const pk = f["project-key"];
             const folderId = await resolveFolderId(c, a[0], f);
-            if (f["dry-run"] === true || f["if-exists"] === true) {
+            if (executionMode(f).dryRun || f["if-exists"] === true) {
                 const current = await readIfExists(() => c.folders.get(folderId, pk));
                 if (!current)
                     return skipResult("folder", folderId, "missing");
-                if (f["dry-run"] === true) {
+                if (executionMode(f).dryRun) {
                     return {
                         dryRun: true,
                         action: "delete",
@@ -167,7 +168,7 @@ export const folderCommands = {
             requireArgs(a, 3, "dss folder upload <name-or-id> <path> <localPath>");
             const pk = f["project-key"];
             const folderId = await resolveFolderId(c, a[0], f);
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return {
                     dryRun: true,
                     action: "upload",
@@ -190,7 +191,7 @@ export const folderCommands = {
     "delete-file": {
         handler: async (c, a, f) => {
             requireArgs(a, 2, "dss folder delete-file <name-or-id> <path>");
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return { dryRun: true, action: "delete-file", resource: "folder", folder: a[0], path: a[1], };
             }
             await c.folders.deleteFile(await resolveFolderId(c, a[0], f), a[1], f["project-key"]);

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

@@ -1,4 +1,5 @@
 import { num, } from "../coerce.js";
+import { executionMode, } from "../flags.js";
 import { planResult, } from "../output.js";
 import { requireArgs, } from "../usage.js";
 export const futureCommands = {
@@ -36,7 +37,7 @@ export const futureCommands = {
         handler: async (c, a, f) => {
             requireArgs(a, 1, "dss future abort <id>");
             const id = a[0];
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return planResult("future", "abort", {
                     method: "POST",
                     endpoint: `/public/api/futures/${encodeURIComponent(id)}/abort`,

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

@@ -1,5 +1,6 @@
 import { deepMerge, } from "../../utils/deep-merge.js";
 import { json, jsonInput, parseBooleanOption, textInput, } from "../coerce.js";
+import { executionMode, } from "../flags.js";
 import { readIfExists, skipResult, } from "../output.js";
 import { requireArgs, UsageError, } from "../usage.js";
 export const insightCommands = {
@@ -40,17 +41,17 @@ export const insightCommands = {
             if (params !== undefined)
                 prototype.params = params;
             const pk = f["project-key"];
-            if (f["if-not-exists"] === true || f["dry-run"] === true) {
+            if (f["if-not-exists"] === true || executionMode(f).dryRun) {
                 const existing = name
                     ? (await c.insights.list(pk)).find((insight) => insight.name === name)
                     : undefined;
-                if (existing && f["if-not-exists"] === true && f["dry-run"] !== true) {
+                if (existing && f["if-not-exists"] === true && !executionMode(f).dryRun) {
                     return skipResult("insight", existing.id, "exists", { current: existing, });
                 }
-                if (f["if-not-exists"] === true && !name && f["dry-run"] !== true) {
+                if (f["if-not-exists"] === true && !name && !executionMode(f).dryRun) {
                     throw new UsageError("--if-not-exists requires --name for insight create.");
                 }
-                if (f["dry-run"] === true) {
+                if (executionMode(f).dryRun) {
                     return {
                         dryRun: true,
                         action: "create",
@@ -95,7 +96,7 @@ export const insightCommands = {
                 && contentType === undefined && payload === undefined) {
                 throw new UsageError("--name, --listed, --params, --content, --file, --data, --data-file, or --stdin is required.");
             }
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 const current = await c.insights.get(a[0], f["project-key"]);
                 const next = deepMerge(current, data ?? {});
                 if (name !== undefined)
@@ -138,11 +139,11 @@ export const insightCommands = {
         handler: async (c, a, f) => {
             requireArgs(a, 1, "dss insight delete <id>");
             const pk = f["project-key"];
-            if (f["dry-run"] === true || f["if-exists"] === true) {
+            if (executionMode(f).dryRun || f["if-exists"] === true) {
                 const current = await readIfExists(() => c.insights.get(a[0], pk));
                 if (!current)
                     return skipResult("insight", a[0], "missing");
-                if (f["dry-run"] === true) {
+                if (executionMode(f).dryRun) {
                     return { dryRun: true, action: "delete", resource: "insight", id: a[0], current, };
                 }
             }

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

@@ -2,6 +2,7 @@ import { mkdir, writeFile, } from "node:fs/promises";
 import { dirname, resolve, } from "node:path";
 import { parseJobLogProgress, } from "../../resources/jobs.js";
 import { jobBuildTargetTypeFromFlags, jobLogFilterFromFlag, maxLogLinesFromFlags, num, plainRecord, } from "../coerce.js";
+import { executionMode, } from "../flags.js";
 import { encodedProjectEndpoint, } from "../output.js";
 import { requireArgs, UsageError, } from "../usage.js";
 // ---------------------------------------------------------------------------
@@ -276,7 +277,7 @@ export const jobCommands = {
                 targetType: jobBuildTargetTypeFromFlags(f),
                 timeoutMs: num(f["timeout"], "--timeout"),
             };
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return {
                     dryRun: true,
                     action: "build",
@@ -315,7 +316,7 @@ export const jobCommands = {
                 summary: f["summary"] === true,
                 targetType: jobBuildTargetTypeFromFlags(f),
             };
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return {
                     dryRun: true,
                     action: "build-and-wait",
@@ -399,7 +400,7 @@ export const jobCommands = {
         handler: async (c, a, f) => {
             requireArgs(a, 1, "dss job abort <id>");
             const pk = f["project-key"];
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return {
                     dryRun: true,
                     action: "abort",

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

@@ -1,4 +1,5 @@
 import { jsonInput, requiredJsonInput, } from "../coerce.js";
+import { executionMode, } from "../flags.js";
 import { isNotFoundError, planResult, skipResult, } from "../output.js";
 import { requireArgs, } from "../usage.js";
 const MEANING_PLAN_FAILURE_CODES = { usage: 1, error: 2, transient: 3, };
@@ -40,7 +41,7 @@ export const meaningCommands = {
             requireArgs(a, 3, "dss meaning create <id> <label> <type> [--data JSON|--data-file PATH|--stdin] [--dry-run]");
             const body = jsonInput(f) ?? {};
             const payload = meaningCreatePayload(a[0], a[1], a[2], body);
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return planResult("meaning", "create", {
                     asyncKind: "none",
                     method: "POST",
@@ -62,7 +63,7 @@ export const meaningCommands = {
         handler: async (c, a, f) => {
             requireArgs(a, 1, "dss meaning update <meaningId> (--data JSON|--data-file PATH|--stdin) [--dry-run]");
             const body = requiredJsonInput(f, "--data, --data-file, or --stdin is required (meaning definition).");
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return planResult("meaning", "update", {
                     asyncKind: "none",
                     method: "PUT",
@@ -83,7 +84,7 @@ export const meaningCommands = {
     delete: {
         handler: async (c, a, f) => {
             requireArgs(a, 1, "dss meaning delete <meaningId>");
-            if (f["dry-run"] === true || f["if-exists"] === true) {
+            if (executionMode(f).dryRun || f["if-exists"] === true) {
                 const current = await c.meanings.get(a[0]).catch((error) => {
                     if (isNotFoundError(error)
                         || (error instanceof Error && /unknown meaning/i.test(error.message))) {
@@ -93,7 +94,7 @@ export const meaningCommands = {
                 });
                 if (!current)
                     return skipResult("meaning", a[0], "missing");
-                if (f["dry-run"] === true) {
+                if (executionMode(f).dryRun) {
                     return planResult("meaning", "delete", {
                         asyncKind: "none",
                         method: "DELETE",

package/dist/src/cli/commands/ml-task.js

@@ -1,4 +1,5 @@
 import { requiredJsonInput, requiredStringFlag, } from "../coerce.js";
+import { executionMode, } from "../flags.js";
 import { requireArgs, UsageError, } from "../usage.js";
 function optionalStringFlag(flags, name) {
     const value = flags[name];
@@ -127,7 +128,7 @@ export const mlTaskCommands = {
                 testDatasetRef: optionalStringFlag(f, "test-dataset"),
                 projectKey: f["project-key"],
             };
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return {
                     dryRun: true,
                     action: "deploy",
@@ -148,7 +149,7 @@ export const mlTaskCommands = {
         handler: async (c, a, f) => {
             requireArgs(a, 2, "dss ml-task delete <analysisId> <mlTaskId> [--dry-run] [--project-key KEY]");
             const projectKey = f["project-key"];
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return {
                     dryRun: true,
                     action: "delete",

package/dist/src/cli/commands/model-evaluation-store.js

@@ -1,4 +1,5 @@
 import { requiredStringFlag, } from "../coerce.js";
+import { executionMode, } from "../flags.js";
 import { readIfExists, skipResult, } from "../output.js";
 import { requireArgs, } from "../usage.js";
 export const modelEvaluationStoreCommands = {
@@ -23,7 +24,7 @@ export const modelEvaluationStoreCommands = {
             const name = requiredStringFlag(f, "name", usage);
             const projectKey = f["project-key"];
             const options = { name, projectKey, };
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return {
                     dryRun: true,
                     action: "create",
@@ -56,11 +57,11 @@ export const modelEvaluationStoreCommands = {
         handler: async (c, a, f) => {
             requireArgs(a, 1, "dss model-evaluation-store delete <storeId> [--if-exists] [--dry-run] [--project-key KEY]");
             const projectKey = f["project-key"];
-            if (f["dry-run"] === true || f["if-exists"] === true) {
+            if (executionMode(f).dryRun || f["if-exists"] === true) {
                 const current = await readIfExists(() => c.modelEvaluationStores.get(a[0], projectKey));
                 if (!current)
                     return skipResult("model-evaluation-store", a[0], "missing");
-                if (f["dry-run"] === true) {
+                if (executionMode(f).dryRun) {
                     return {
                         dryRun: true,
                         action: "delete",