dataiku-sdk 3.1.0 → 3.2.0

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

@@ -1,5 +1,6 @@
 import { ClientValidationError, } from "../../errors.js";
 import { deepMerge, } from "../../utils/deep-merge.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";
@@ -63,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",
@@ -103,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, };
@@ -118,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, };
                 }
             }
@@ -147,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",
@@ -206,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",

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",

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

@@ -1,4 +1,5 @@
 import { jsonInput, num, parseBooleanOption, } from "../coerce.js";
+import { executionMode, } from "../flags.js";
 import { encodedProjectEndpoint, readIfExists, skipResult, } from "../output.js";
 import { requireArgs, requireNoArgs, UsageError, } from "../usage.js";
 export const notebookCommands = {
@@ -26,11 +27,11 @@ export const notebookCommands = {
         handler: async (c, a, f) => {
             requireArgs(a, 1, "dss notebook delete-jupyter <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.notebooks.getJupyter(a[0], pk));
                 if (!current)
                     return skipResult("jupyter-notebook", a[0], "missing");
-                if (f["dry-run"] === true) {
+                if (executionMode(f).dryRun) {
                     return { dryRun: true, action: "delete", resource: "jupyter-notebook", name: a[0], current, };
                 }
             }
@@ -45,7 +46,7 @@ export const notebookCommands = {
         handler: async (c, a, f) => {
             requireArgs(a, 1, "dss notebook clear-jupyter-outputs <name>");
             const pk = f["project-key"];
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 // The real mutation is a single server-side DELETE of the
                 // outputs endpoint, so the dry run can only report the current
                 // content (read-only) and the exact request that would run; the
@@ -82,7 +83,7 @@ export const notebookCommands = {
             const pk = f["project-key"];
             if (f["all"] === true) {
                 requireNoArgs(a, "dss notebook unload-jupyter --all [--dry-run] [--project-key KEY]");
-                if (f["dry-run"] === true) {
+                if (executionMode(f).dryRun) {
                     const planned = [];
                     for (const notebook of await c.notebooks.listJupyter(pk, { active: true, })) {
                         for (const session of await c.notebooks.listJupyterSessions(notebook.name, pk)) {
@@ -106,7 +107,7 @@ export const notebookCommands = {
                 return { unloaded, resource: "jupyter-notebook", all: true, };
             }
             requireArgs(a, 2, "dss notebook unload-jupyter <name> <sessionId>");
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 const sessions = await c.notebooks.listJupyterSessions(a[0], pk);
                 const current = sessions.find((session) => session.sessionId === a[1]);
                 return {
@@ -149,11 +150,11 @@ export const notebookCommands = {
         handler: async (c, a, f) => {
             requireArgs(a, 1, "dss notebook delete-sql <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.notebooks.getSql(a[0], pk));
                 if (!current)
                     return skipResult("sql-notebook", a[0], "missing");
-                if (f["dry-run"] === true) {
+                if (executionMode(f).dryRun) {
                     return { dryRun: true, action: "delete", resource: "sql-notebook", id: a[0], current, };
                 }
             }
@@ -181,7 +182,7 @@ export const notebookCommands = {
                 throw new UsageError("--data, --data-file, or --stdin is required (notebook JSON content).");
             }
             const pk = f["project-key"];
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 const current = await readIfExists(() => c.notebooks.getJupyter(a[0], pk));
                 return {
                     dryRun: true,
@@ -217,7 +218,7 @@ export const notebookCommands = {
                 throw new UsageError("--data, --data-file, or --stdin is required (SQL notebook content JSON).");
             }
             const pk = f["project-key"];
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 const current = await readIfExists(() => c.notebooks.getSql(a[0], pk));
                 return {
                     dryRun: true,
@@ -251,7 +252,7 @@ export const notebookCommands = {
                 numRunsToRetain: num(f["retain"], "--retain"),
                 projectKey: pk,
             };
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 const current = await c.notebooks.getSqlHistory(a[0], pk);
                 return {
                     dryRun: true,

package/dist/src/cli/commands/project-library.js

@@ -1,6 +1,7 @@
 import * as fs from "node:fs";
 import { encodeLibraryPath, EXPECT_SHA256_PATTERN, validateLibraryDestinationPath, validateLibraryName, validateLibraryPath, } from "../../resources/project-library.js";
 import { numFlag, readStdinText, sha256Hex, } from "../coerce.js";
+import { executionMode, } from "../flags.js";
 import { encodedProjectEndpoint, planResult, skipResult, } from "../output.js";
 import { requireArgs, UsageError, } from "../usage.js";
 const PROJECT_LIBRARY_EXIT_CODES = { usage: 1, error: 2, transient: 3, };
@@ -100,7 +101,7 @@ export const projectLibraryCommands = {
             requireArgs(a, 1, "dss project-library create-file <path> [--if-not-exists] [--dry-run] [--project-key KEY]");
             const pk = f["project-key"];
             validateLibraryPath(a[0]);
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return projectLibraryPlan("create-file", {
                     method: "POST",
                     endpoint: projectLibraryContentsEndpoint(c, pk, a[0]),
@@ -126,7 +127,7 @@ export const projectLibraryCommands = {
             requireArgs(a, 1, "dss project-library create-folder <path> [--if-not-exists] [--dry-run] [--project-key KEY]");
             const pk = f["project-key"];
             validateLibraryPath(a[0]);
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return projectLibraryPlan("create-folder", {
                     method: "POST",
                     endpoint: projectLibraryFolderEndpoint(c, pk, a[0]),
@@ -153,7 +154,7 @@ export const projectLibraryCommands = {
             const pk = f["project-key"];
             const expectSha256 = expectSha256FromFlags(f);
             validateLibraryPath(a[0]);
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return projectLibraryPlan("put", {
                     method: "POST",
                     endpoint: projectLibraryContentsEndpoint(c, pk, a[0]),
@@ -206,7 +207,7 @@ export const projectLibraryCommands = {
             requireArgs(a, 1, "dss project-library delete <path> [--dry-run] [--project-key KEY]");
             const pk = f["project-key"];
             validateLibraryPath(a[0]);
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return projectLibraryPlan("delete", {
                     method: "DELETE",
                     endpoint: projectLibraryContentsEndpoint(c, pk, a[0]),
@@ -226,7 +227,7 @@ export const projectLibraryCommands = {
             const pk = f["project-key"];
             const validPath = validateLibraryPath(a[0]);
             const validName = validateLibraryName(a[1]);
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return projectLibraryPlan("rename", {
                     method: "POST",
                     endpoint: projectLibraryActionEndpoint(c, pk, "rename/"),
@@ -247,7 +248,7 @@ export const projectLibraryCommands = {
             const pk = f["project-key"];
             const validPath = validateLibraryPath(a[0]);
             const destination = validateLibraryDestinationPath(a[1]);
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return projectLibraryPlan("move", {
                     method: "POST",
                     endpoint: projectLibraryActionEndpoint(c, pk, "move"),

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

@@ -3,6 +3,7 @@ import { deepMerge, } from "../../utils/deep-merge.js";
 import { inspectProjectArchive, } from "../../utils/project-archive.js";
 import { projectIncarnationHash, } from "../../utils/project-incarnation.js";
 import { jsonInput, num, requiredJsonInput, requiredStringFlag, } from "../coerce.js";
+import { executionMode, } from "../flags.js";
 import { CommandResultFailure, } from "../output.js";
 import { requireArgs, UsageError, } from "../usage.js";
 const INSPECT_ARCHIVE_USAGE = "dss project inspect-archive <file>";
@@ -91,7 +92,7 @@ export const projectCommands = {
                 throw new UsageError("--expect-project-incarnation must be a 64-character lowercase SHA-256 hash.", "validation_failed");
             }
             const guarded = f["if-exists"] === true
-                || f["dry-run"] === true
+                || executionMode(f).dryRun
                 || expectedIncarnation !== undefined;
             if (!guarded) {
                 // Purely user-requested delete without any guard flag: keep the
@@ -128,7 +129,7 @@ export const projectCommands = {
                 }
                 throw error;
             }
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return {
                     deleted: false,
                     dryRun: true,

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

@@ -3,6 +3,7 @@ import { writeFile, } from "node:fs/promises";
 import { join, } from "node:path";
 import { deepMerge, } from "../../utils/deep-merge.js";
 import { jobLogFilterFromFlag, jsonInput, maxLogLinesFromFlags, normalizeLineEndings, num, recipeInputDatasetsFromFlags, requiredStringFlag, rewritePairsFromFlags, sha256Hex, splitCsvFlag, stableHash, } from "../coerce.js";
+import { executionMode, } from "../flags.js";
 import { moveCreatedItemsToZone, resolveFlowZoneIdFromFlags, } from "../helpers/flow-zone.js";
 import { ensureRecipeBackupDir, readRecipeBackup, recipeBackupDocument, recipeBackupPath, recipeCodeEnv, recipeGraph, recipeInputItemRef, recipeRoleInputItems, recipeRunShouldWait, writeRecipeBackup, } from "../helpers/recipe.js";
 import { encodedProjectEndpoint, readIfExists, skipResult, } from "../output.js";
@@ -109,7 +110,7 @@ export const recipeCommands = {
                 summary: f["summary"] === true,
                 wait,
             };
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 const outputs = await c.recipes.resolveRunOutputs(a[0], {
                     partition: options.partition,
                     projectKey: pk,
@@ -139,11 +140,11 @@ export const recipeCommands = {
         handler: async (c, a, f) => {
             requireArgs(a, 1, "dss recipe 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.recipes.get(a[0], { projectKey: pk, includePayload: true, }));
                 if (!current)
                     return skipResult("recipe", a[0], "missing");
-                if (f["dry-run"] === true) {
+                if (executionMode(f).dryRun) {
                     return { dryRun: true, action: "delete", resource: "recipe", name: a[0], current, };
                 }
             }
@@ -241,13 +242,13 @@ export const recipeCommands = {
             const zoneMove = zoneId && name
                 ? [{ objectId: name, objectType: "RECIPE", },]
                 : undefined;
-            if ((f["if-not-exists"] === true || f["dry-run"] === true) && name) {
+            if ((f["if-not-exists"] === true || executionMode(f).dryRun) && name) {
                 const list = await c.recipes.list(pk);
                 const existing = list.find((r) => r.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("recipe", name, "exists", { current: existing, });
                 }
-                if (f["dry-run"] === true) {
+                if (executionMode(f).dryRun) {
                     return {
                         dryRun: true,
                         action: "create",
@@ -259,7 +260,7 @@ export const recipeCommands = {
                     };
                 }
             }
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return {
                     dryRun: true,
                     action: "create",
@@ -328,7 +329,7 @@ export const recipeCommands = {
                 throw new UsageError("Cannot reuse --path or --metastore-table for multiple cloned output datasets.", "invalid_enum");
             }
             const zoneId = await resolveFlowZoneIdFromFlags(c, f, pk);
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return {
                     dryRun: true,
                     action: "clone",
@@ -391,7 +392,7 @@ export const recipeCommands = {
                 throw new UsageError("--data, --data-file, or --stdin is required. Usage: dss recipe 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.recipes.get(a[0], { projectKey: pk, includePayload: true, });
                 const currentRecipe = current.recipe;
                 const next = {
@@ -430,7 +431,7 @@ export const recipeCommands = {
             }
             const nextItems = [...items, { ref: a[1], deps: [], },];
             const inputs = nextItems.map(recipeInputItemRef).filter((ref) => Boolean(ref));
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return {
                     dryRun: true,
                     action: "add-input",
@@ -467,7 +468,7 @@ export const recipeCommands = {
             }
             const nextItems = items.filter((item) => recipeInputItemRef(item) !== a[1]);
             const inputs = nextItems.map(recipeInputItemRef).filter((ref) => Boolean(ref));
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return {
                     dryRun: true,
                     action: "remove-input",
@@ -542,7 +543,7 @@ export const recipeCommands = {
                 projectKey: pk,
                 includePayload: true,
             });
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return {
                     dryRun: true,
                     action: "set-payload",
@@ -593,7 +594,7 @@ export const recipeCommands = {
             const next = f["payload-only"] === true || !restoredRecipe
                 ? { ...current, payload, }
                 : { ...current, recipe: restoredRecipe, payload, };
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return {
                     dryRun: true,
                     action: "restore",

package/dist/src/cli/commands/saved-model.js

@@ -1,3 +1,4 @@
+import { executionMode, } from "../flags.js";
 import { readIfExists, skipResult, } from "../output.js";
 import { requireArgs, } from "../usage.js";
 export const savedModelCommands = {
@@ -40,7 +41,7 @@ export const savedModelCommands = {
         handler: async (c, a, f) => {
             requireArgs(a, 2, "dss saved-model set-active <modelId> <versionId> [--dry-run] [--project-key KEY]");
             const projectKey = f["project-key"];
-            if (f["dry-run"] === true) {
+            if (executionMode(f).dryRun) {
                 return {
                     dryRun: true,
                     action: "set-active",
@@ -64,11 +65,11 @@ export const savedModelCommands = {
         handler: async (c, a, f) => {
             requireArgs(a, 1, "dss saved-model delete <modelId> [--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.savedModels.get(a[0], projectKey));
                 if (!current)
                     return skipResult("saved-model", a[0], "missing");
-                if (f["dry-run"] === true) {
+                if (executionMode(f).dryRun) {
                     return { dryRun: true, action: "delete", resource: "saved-model", id: a[0], current, };
                 }
             }