deepline 0.1.156 → 0.1.158

package/dist/cli/index.js

@@ -657,10 +657,10 @@ var SDK_RELEASE = {
   // 0.1.111 ships dataset-native tool list getters and result row datasets.
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
-  version: "0.1.156",
+  version: "0.1.158",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.156",
+    latest: "0.1.158",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -17637,7 +17637,7 @@ async function buildEnrichFailureReport(input2) {
     rows: input2.rows,
     rowRange: input2.rowRange,
     client: input2.client,
-    outputPath: input2.exportResult?.path ?? input2.outputPath ?? null,
+    outputPath: input2.reportOutputPath ?? input2.exportResult?.path ?? input2.outputPath ?? null,
     status: input2.status
   });
 }
@@ -18926,7 +18926,7 @@ function registerEnrichCommand(program) {
       return;
     }
     const rows = parseRows(options.rows, options.all);
-    const outputPath = options.inPlace ? inputCsv : options.output;
+    let outputPath = options.inPlace ? inputCsv : options.output;
     const sourceCsvPath = !options.inPlace && outputPath && await regularFileExists(outputPath) ? outputPath : inputCsv;
     const forceAliases = resolveForceAliases(config, options);
     for (const alias of collectFailedInputAliases(
@@ -18944,8 +18944,39 @@ function registerEnrichCommand(program) {
     });
     const tempDir = await (0, import_promises3.mkdtemp)((0, import_node_path12.join)((0, import_node_os8.tmpdir)(), "deepline-enrich-play-"));
     const tempPlay = (0, import_node_path12.join)(tempDir, "deepline-enrich.play.ts");
+    let inPlaceTempDir = null;
+    let inPlaceTempOutputPath = null;
+    const inPlaceFinalOutputPath = options.inPlace ? (0, import_node_path12.resolve)(inputCsv) : null;
+    const inPlaceCommitOutputPath = options.inPlace ? (await (0, import_promises3.lstat)(inputCsv)).isSymbolicLink() ? await (0, import_promises3.realpath)(inputCsv) : inPlaceFinalOutputPath : null;
+    const failureReportOutputPath = options.inPlace ? inPlaceFinalOutputPath : null;
+    let inPlaceCommitted = false;
+    const commitInPlaceOutput = async (exportResult) => {
+      if (!inPlaceTempOutputPath || !inPlaceCommitOutputPath || !inPlaceFinalOutputPath) {
+        return exportResult;
+      }
+      await (0, import_promises3.rename)(inPlaceTempOutputPath, inPlaceCommitOutputPath);
+      inPlaceCommitted = true;
+      if (!exportResult) {
+        return null;
+      }
+      return {
+        ...exportResult,
+        path: inPlaceFinalOutputPath
+      };
+    };
     try {
       await (0, import_promises3.writeFile)(tempPlay, playSource, "utf8");
+      if (options.inPlace) {
+        inPlaceTempDir = await (0, import_promises3.mkdtemp)(
+          (0, import_node_path12.join)(
+            (0, import_node_path12.dirname)(inPlaceCommitOutputPath ?? (0, import_node_path12.resolve)(inputCsv)),
+            ".deepline-enrich-in-place-"
+          )
+        );
+        inPlaceTempOutputPath = (0, import_node_path12.join)(inPlaceTempDir, "output.csv");
+        await (0, import_promises3.copyFile)((0, import_node_path12.resolve)(inputCsv), inPlaceTempOutputPath);
+        outputPath = inPlaceTempOutputPath;
+      }
       const runOne = async (input2) => {
         const runtimeInput = {
           file: (0, import_node_path12.resolve)(input2.sourceCsvPath),
@@ -19042,10 +19073,10 @@ function registerEnrichCommand(program) {
                   rows: chunkRows
                 },
                 result: chunk.status,
-                output: enrichOutputJson(chunk.exportResult)
+                output: options.inPlace ? null : enrichOutputJson(chunk.exportResult)
               });
             } else {
-              if (chunk.exportResult) {
+              if (chunk.exportResult && !options.inPlace) {
                 process.stderr.write(
                   `Wrote ${chunk.exportResult.rows} row(s) to ${chunk.exportResult.path}${chunk.exportResult.partial ? " (partial run output)" : ""}
 `
@@ -19077,15 +19108,18 @@ function registerEnrichCommand(program) {
             rowEnd: selectedRange.end
           },
           client: client2,
-          outputPath,
+          outputPath: failureReportOutputPath ?? finalExportResult?.path ?? outputPath,
           status: lastStatus
         });
+        if (!failureReport2) {
+          finalExportResult = await commitInPlaceOutput(finalExportResult);
+        }
         if (options.json) {
           const run = rewriteEnrichJsonStatus({
             status: lastStatus,
             config,
             forceAliases,
-            output: finalExportResult ? {
+            output: finalExportResult && (!failureReport2 || !options.inPlace) ? {
               ...finalExportResult,
               sourceCsvRows: selectedRange.sourceRows,
               selectedRows: selectedRange.count,
@@ -19103,7 +19137,7 @@ function registerEnrichCommand(program) {
               chunkRows: ENRICH_AUTO_BATCH_ROWS,
               selectedRows: selectedRange.count
             },
-            output: finalExportResult ? {
+            output: finalExportResult && (!failureReport2 || !options.inPlace) ? {
               sourceCsvRows: selectedRange.sourceRows,
               selectedRows: selectedRange.count,
               enrichedRows: totalEnrichedRows,
@@ -19130,7 +19164,7 @@ function registerEnrichCommand(program) {
       });
       const rowsForFailureReport = exportResult?.enrichedDataRows ?? extractCanonicalRowsInfo(status)?.rows ?? [];
       if (captured.result !== 0) {
-        if (exportResult) {
+        if (exportResult && !options.inPlace) {
           process.stderr.write(
             `Wrote ${exportResult.rows} row(s) to ${exportResult.path}${exportResult.partial ? " (partial run output)" : ""}
 `
@@ -19143,13 +19177,14 @@ function registerEnrichCommand(program) {
           client: client2,
           exportResult,
           outputPath,
+          reportOutputPath: failureReportOutputPath,
           status
         });
         if (options.json) {
           printJson({
             ok: false,
             run: status,
-            output: enrichOutputJson(exportResult),
+            output: options.inPlace ? null : enrichOutputJson(exportResult),
             ...failureReport2 ? {
               failure_report: {
                 path: failureReport2.path,
@@ -19169,19 +19204,21 @@ function registerEnrichCommand(program) {
           client: client2,
           exportResult,
           outputPath,
+          reportOutputPath: failureReportOutputPath,
           status
         });
+        const committedExportResult2 = failureReport2 ? exportResult : await commitInPlaceOutput(exportResult);
         const run = rewriteEnrichJsonStatus({
           status,
           config,
           forceAliases,
-          output: exportResult,
+          output: failureReport2 && options.inPlace ? null : committedExportResult2,
           failureReport: failureReport2
         });
         printJson({
           ok: !failureReport2,
           run,
-          output: enrichOutputJson(exportResult),
+          output: failureReport2 && options.inPlace ? null : enrichOutputJson(committedExportResult2),
           ...failureReport2 ? {
             failure_report: {
               path: failureReport2.path,
@@ -19194,32 +19231,38 @@ function registerEnrichCommand(program) {
         }
         return;
       }
-      if (exportResult) {
+      const failureReport = await maybeEmitEnrichFailureReport({
+        config,
+        rows: rowsForFailureReport,
+        rowRange: rows,
+        client: client2,
+        outputPath: failureReportOutputPath ?? exportResult?.path ?? null,
+        status
+      });
+      const committedExportResult = failureReport ? options.inPlace ? null : exportResult : await commitInPlaceOutput(exportResult);
+      if (committedExportResult) {
         process.stderr.write(
-          `Wrote ${exportResult.rows} row(s) to ${exportResult.path}
+          `Wrote ${committedExportResult.rows} row(s) to ${committedExportResult.path}
 `
         );
         const waterfallSummaryLines = buildEnrichWaterfallSummaryLines(
           config,
-          exportResult.enrichedDataRows
+          committedExportResult.enrichedDataRows
         );
         if (waterfallSummaryLines.length > 0) {
           process.stdout.write(`${waterfallSummaryLines.join("\n")}
 `);
         }
       }
-      const failureReport = await maybeEmitEnrichFailureReport({
-        config,
-        rows: rowsForFailureReport,
-        rowRange: rows,
-        client: client2,
-        outputPath: exportResult?.path ?? outputPath ?? null,
-        status
-      });
       if (failureReport) {
         process.exitCode = EXIT_SERVER2;
       }
     } finally {
+      if (inPlaceTempDir) {
+        await (0, import_promises3.rm)(inPlaceTempDir, { recursive: true, force: true });
+      } else if (inPlaceTempOutputPath && !inPlaceCommitted) {
+        await (0, import_promises3.rm)(inPlaceTempOutputPath, { force: true });
+      }
       await (0, import_promises3.rm)(tempDir, { recursive: true, force: true });
     }
   });

package/dist/cli/index.mjs

@@ -642,10 +642,10 @@ var SDK_RELEASE = {
   // 0.1.111 ships dataset-native tool list getters and result row datasets.
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
-  version: "0.1.156",
+  version: "0.1.158",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.156",
+    latest: "0.1.158",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -7636,15 +7636,19 @@ Examples:
 
 // src/cli/commands/enrich.ts
 import {
+  copyFile,
+  lstat,
   mkdir as mkdir3,
   mkdtemp,
   readFile,
+  realpath,
+  rename,
   rm,
   stat,
   writeFile as writeFile3
 } from "fs/promises";
 import { homedir as homedir7, tmpdir as tmpdir2 } from "os";
-import { join as join7, resolve as resolve9 } from "path";
+import { dirname as dirname7, join as join7, resolve as resolve9 } from "path";
 
 // src/cli/commands/play.ts
 import { createHash as createHash2 } from "crypto";
@@ -17660,7 +17664,7 @@ async function buildEnrichFailureReport(input2) {
     rows: input2.rows,
     rowRange: input2.rowRange,
     client: input2.client,
-    outputPath: input2.exportResult?.path ?? input2.outputPath ?? null,
+    outputPath: input2.reportOutputPath ?? input2.exportResult?.path ?? input2.outputPath ?? null,
     status: input2.status
   });
 }
@@ -18949,7 +18953,7 @@ function registerEnrichCommand(program) {
       return;
     }
     const rows = parseRows(options.rows, options.all);
-    const outputPath = options.inPlace ? inputCsv : options.output;
+    let outputPath = options.inPlace ? inputCsv : options.output;
     const sourceCsvPath = !options.inPlace && outputPath && await regularFileExists(outputPath) ? outputPath : inputCsv;
     const forceAliases = resolveForceAliases(config, options);
     for (const alias of collectFailedInputAliases(
@@ -18967,8 +18971,39 @@ function registerEnrichCommand(program) {
     });
     const tempDir = await mkdtemp(join7(tmpdir2(), "deepline-enrich-play-"));
     const tempPlay = join7(tempDir, "deepline-enrich.play.ts");
+    let inPlaceTempDir = null;
+    let inPlaceTempOutputPath = null;
+    const inPlaceFinalOutputPath = options.inPlace ? resolve9(inputCsv) : null;
+    const inPlaceCommitOutputPath = options.inPlace ? (await lstat(inputCsv)).isSymbolicLink() ? await realpath(inputCsv) : inPlaceFinalOutputPath : null;
+    const failureReportOutputPath = options.inPlace ? inPlaceFinalOutputPath : null;
+    let inPlaceCommitted = false;
+    const commitInPlaceOutput = async (exportResult) => {
+      if (!inPlaceTempOutputPath || !inPlaceCommitOutputPath || !inPlaceFinalOutputPath) {
+        return exportResult;
+      }
+      await rename(inPlaceTempOutputPath, inPlaceCommitOutputPath);
+      inPlaceCommitted = true;
+      if (!exportResult) {
+        return null;
+      }
+      return {
+        ...exportResult,
+        path: inPlaceFinalOutputPath
+      };
+    };
     try {
       await writeFile3(tempPlay, playSource, "utf8");
+      if (options.inPlace) {
+        inPlaceTempDir = await mkdtemp(
+          join7(
+            dirname7(inPlaceCommitOutputPath ?? resolve9(inputCsv)),
+            ".deepline-enrich-in-place-"
+          )
+        );
+        inPlaceTempOutputPath = join7(inPlaceTempDir, "output.csv");
+        await copyFile(resolve9(inputCsv), inPlaceTempOutputPath);
+        outputPath = inPlaceTempOutputPath;
+      }
       const runOne = async (input2) => {
         const runtimeInput = {
           file: resolve9(input2.sourceCsvPath),
@@ -19065,10 +19100,10 @@ function registerEnrichCommand(program) {
                   rows: chunkRows
                 },
                 result: chunk.status,
-                output: enrichOutputJson(chunk.exportResult)
+                output: options.inPlace ? null : enrichOutputJson(chunk.exportResult)
               });
             } else {
-              if (chunk.exportResult) {
+              if (chunk.exportResult && !options.inPlace) {
                 process.stderr.write(
                   `Wrote ${chunk.exportResult.rows} row(s) to ${chunk.exportResult.path}${chunk.exportResult.partial ? " (partial run output)" : ""}
 `
@@ -19100,15 +19135,18 @@ function registerEnrichCommand(program) {
             rowEnd: selectedRange.end
           },
           client: client2,
-          outputPath,
+          outputPath: failureReportOutputPath ?? finalExportResult?.path ?? outputPath,
           status: lastStatus
         });
+        if (!failureReport2) {
+          finalExportResult = await commitInPlaceOutput(finalExportResult);
+        }
         if (options.json) {
           const run = rewriteEnrichJsonStatus({
             status: lastStatus,
             config,
             forceAliases,
-            output: finalExportResult ? {
+            output: finalExportResult && (!failureReport2 || !options.inPlace) ? {
               ...finalExportResult,
               sourceCsvRows: selectedRange.sourceRows,
               selectedRows: selectedRange.count,
@@ -19126,7 +19164,7 @@ function registerEnrichCommand(program) {
               chunkRows: ENRICH_AUTO_BATCH_ROWS,
               selectedRows: selectedRange.count
             },
-            output: finalExportResult ? {
+            output: finalExportResult && (!failureReport2 || !options.inPlace) ? {
               sourceCsvRows: selectedRange.sourceRows,
               selectedRows: selectedRange.count,
               enrichedRows: totalEnrichedRows,
@@ -19153,7 +19191,7 @@ function registerEnrichCommand(program) {
       });
       const rowsForFailureReport = exportResult?.enrichedDataRows ?? extractCanonicalRowsInfo(status)?.rows ?? [];
       if (captured.result !== 0) {
-        if (exportResult) {
+        if (exportResult && !options.inPlace) {
           process.stderr.write(
             `Wrote ${exportResult.rows} row(s) to ${exportResult.path}${exportResult.partial ? " (partial run output)" : ""}
 `
@@ -19166,13 +19204,14 @@ function registerEnrichCommand(program) {
           client: client2,
           exportResult,
           outputPath,
+          reportOutputPath: failureReportOutputPath,
           status
         });
         if (options.json) {
           printJson({
             ok: false,
             run: status,
-            output: enrichOutputJson(exportResult),
+            output: options.inPlace ? null : enrichOutputJson(exportResult),
             ...failureReport2 ? {
               failure_report: {
                 path: failureReport2.path,
@@ -19192,19 +19231,21 @@ function registerEnrichCommand(program) {
           client: client2,
           exportResult,
           outputPath,
+          reportOutputPath: failureReportOutputPath,
           status
         });
+        const committedExportResult2 = failureReport2 ? exportResult : await commitInPlaceOutput(exportResult);
         const run = rewriteEnrichJsonStatus({
           status,
           config,
           forceAliases,
-          output: exportResult,
+          output: failureReport2 && options.inPlace ? null : committedExportResult2,
           failureReport: failureReport2
         });
         printJson({
           ok: !failureReport2,
           run,
-          output: enrichOutputJson(exportResult),
+          output: failureReport2 && options.inPlace ? null : enrichOutputJson(committedExportResult2),
           ...failureReport2 ? {
             failure_report: {
               path: failureReport2.path,
@@ -19217,32 +19258,38 @@ function registerEnrichCommand(program) {
         }
         return;
       }
-      if (exportResult) {
+      const failureReport = await maybeEmitEnrichFailureReport({
+        config,
+        rows: rowsForFailureReport,
+        rowRange: rows,
+        client: client2,
+        outputPath: failureReportOutputPath ?? exportResult?.path ?? null,
+        status
+      });
+      const committedExportResult = failureReport ? options.inPlace ? null : exportResult : await commitInPlaceOutput(exportResult);
+      if (committedExportResult) {
         process.stderr.write(
-          `Wrote ${exportResult.rows} row(s) to ${exportResult.path}
+          `Wrote ${committedExportResult.rows} row(s) to ${committedExportResult.path}
 `
         );
         const waterfallSummaryLines = buildEnrichWaterfallSummaryLines(
           config,
-          exportResult.enrichedDataRows
+          committedExportResult.enrichedDataRows
         );
         if (waterfallSummaryLines.length > 0) {
           process.stdout.write(`${waterfallSummaryLines.join("\n")}
 `);
         }
       }
-      const failureReport = await maybeEmitEnrichFailureReport({
-        config,
-        rows: rowsForFailureReport,
-        rowRange: rows,
-        client: client2,
-        outputPath: exportResult?.path ?? outputPath ?? null,
-        status
-      });
       if (failureReport) {
         process.exitCode = EXIT_SERVER2;
       }
     } finally {
+      if (inPlaceTempDir) {
+        await rm(inPlaceTempDir, { recursive: true, force: true });
+      } else if (inPlaceTempOutputPath && !inPlaceCommitted) {
+        await rm(inPlaceTempOutputPath, { force: true });
+      }
       await rm(tempDir, { recursive: true, force: true });
     }
   });
@@ -19302,7 +19349,7 @@ import {
   writeFileSync as writeFileSync10
 } from "fs";
 import { homedir as homedir8, platform } from "os";
-import { basename as basename2, dirname as dirname7, join as join8, resolve as resolve10 } from "path";
+import { basename as basename2, dirname as dirname8, join as join8, resolve as resolve10 } from "path";
 import { gzipSync } from "zlib";
 import { randomUUID as randomUUID2 } from "crypto";
 var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
@@ -19814,9 +19861,9 @@ function loadViewerAssets() {
   const cliEntry = process.argv[1]?.trim() ? resolve10(process.argv[1]) : null;
   const candidateRoots2 = [
     ...cliEntry ? [
-      join8(dirname7(dirname7(cliEntry)), "viewer"),
+      join8(dirname8(dirname8(cliEntry)), "viewer"),
       join8(
-        dirname7(dirname7(dirname7(cliEntry))),
+        dirname8(dirname8(dirname8(cliEntry))),
         "src",
         "lib",
         "cli",
@@ -19865,7 +19912,7 @@ async function handleSessionsRender(options) {
       targets.length > 1 ? "session-viewer.html" : `session-${targets[0]?.sessionId}.html`
     );
   } else {
-    mkdirSync6(dirname7(outputPath), { recursive: true });
+    mkdirSync6(dirname8(outputPath), { recursive: true });
   }
   const sessions = targets.map((target) => ({
     label: target.label,
@@ -21340,7 +21387,7 @@ Examples:
 // src/cli/commands/switch.ts
 import { existsSync as existsSync9, mkdirSync as mkdirSync7, readFileSync as readFileSync9, writeFileSync as writeFileSync11 } from "fs";
 import { homedir as homedir9 } from "os";
-import { dirname as dirname8, join as join9 } from "path";
+import { dirname as dirname9, join as join9 } from "path";
 function hostSlugFromBaseUrl(baseUrl) {
   try {
     const url = new URL(baseUrl);
@@ -21380,7 +21427,7 @@ function readActiveFamily() {
 }
 function writeActiveFamily(family) {
   const path = activeFamilyPath();
-  mkdirSync7(dirname8(path), { recursive: true });
+  mkdirSync7(dirname9(path), { recursive: true });
   writeFileSync11(path, `${family}
 `, "utf-8");
   return path;
@@ -21517,7 +21564,7 @@ import {
   writeSync
 } from "fs";
 import { homedir as homedir10 } from "os";
-import { dirname as dirname9, join as join10 } from "path";
+import { dirname as dirname10, join as join10 } from "path";
 function isPlainObject(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
@@ -21656,7 +21703,7 @@ function writeJsonOutputFile(payload, stem) {
 }
 function writeCsvOutputFile(rows, stem, options) {
   const outputPath = options?.outPath ? options.outPath : join10(ensureOutputDir(), `${stem}_${Date.now()}.csv`);
-  mkdirSync8(dirname9(outputPath), { recursive: true });
+  mkdirSync8(dirname10(outputPath), { recursive: true });
   const columns = columnsForRows(rows);
   const escapeCell = (value) => {
     const normalized = value == null ? "" : typeof value === "string" || typeof value === "number" || typeof value === "boolean" ? String(value) : JSON.stringify(value);
@@ -23320,7 +23367,7 @@ async function executeTool(args) {
 
 // src/cli/commands/workflow.ts
 import { mkdir as mkdir4, readFile as readFile2, writeFile as writeFile4 } from "fs/promises";
-import { dirname as dirname10, join as join12, resolve as resolve12 } from "path";
+import { dirname as dirname11, join as join12, resolve as resolve12 } from "path";
 
 // src/cli/workflow-to-play.ts
 import { createHash as createHash3 } from "crypto";
@@ -23599,7 +23646,7 @@ async function transformOne(api, workflowId, outDir, publish) {
       { workflowName: workflow.name, version: revision.version }
     );
     const file = join12(resolve12(outDir), `${compiled.playName}.play.ts`);
-    await mkdir4(dirname10(file), { recursive: true });
+    await mkdir4(dirname11(file), { recursive: true });
     await writeFile4(file, compiled.sourceCode, "utf8");
     let published = false;
     if (publish) {
@@ -23857,12 +23904,12 @@ import {
   writeFileSync as writeFileSync15
 } from "fs";
 import { homedir as homedir11 } from "os";
-import { dirname as dirname12, isAbsolute as isAbsolute2, join as join14, relative as relative2, resolve as resolve13 } from "path";
+import { dirname as dirname13, isAbsolute as isAbsolute2, join as join14, relative as relative2, resolve as resolve13 } from "path";
 
 // src/cli/skills-sync.ts
 import { spawn as spawn3, spawnSync as spawnSync2 } from "child_process";
 import { existsSync as existsSync11, mkdirSync as mkdirSync9, readFileSync as readFileSync11, writeFileSync as writeFileSync14 } from "fs";
-import { dirname as dirname11, join as join13 } from "path";
+import { dirname as dirname12, join as join13 } from "path";
 
 // ../shared_libs/cli/install-commands.json
 var install_commands_default = {
@@ -23996,7 +24043,7 @@ function sdkSkillsVersionPath(baseUrl) {
   return join13(sdkCliStateDirPath(baseUrl), "skills-version");
 }
 function legacySdkSkillsVersionPath(baseUrl) {
-  return join13(dirname11(sdkCliStateDirPath(baseUrl)), "sdk-skills", ".version");
+  return join13(dirname12(sdkCliStateDirPath(baseUrl)), "sdk-skills", ".version");
 }
 function readSdkSkillsLocalVersion(baseUrl) {
   const pluginVersion = readPluginSkillsVersion();
@@ -24011,7 +24058,7 @@ function readSdkSkillsLocalVersion(baseUrl) {
 }
 function writeLocalSkillsVersion(baseUrl, version) {
   const path = sdkSkillsVersionPath(baseUrl);
-  mkdirSync9(dirname11(path), { recursive: true });
+  mkdirSync9(dirname12(path), { recursive: true });
   writeFileSync14(path, `${version}
 `, "utf-8");
 }
@@ -24340,7 +24387,7 @@ function findRepoBackedSdkRoot(startPath) {
     if (existsSync12(join14(current, "sdk", "package.json")) && existsSync12(join14(current, "sdk", "bin", "deepline-dev.ts"))) {
       return current;
     }
-    const parent = dirname12(current);
+    const parent = dirname13(current);
     if (parent === current) return null;
     current = parent;
   }
@@ -24370,7 +24417,7 @@ function resolveUpdatePlan(options = {}) {
   const env = options.env ?? process.env;
   const homeDir2 = options.homeDir ?? homedir11();
   const entrypoint = options.entrypoint ?? (process.argv[1] ? resolve13(process.argv[1]) : "");
-  const sourceRoot = entrypoint ? findRepoBackedSdkRoot(dirname12(entrypoint)) : null;
+  const sourceRoot = entrypoint ? findRepoBackedSdkRoot(dirname13(entrypoint)) : null;
   if (sourceRoot) {
     return {
       kind: "source",
@@ -24449,7 +24496,7 @@ function writeAutoUpdateFailure(plan, exitCode) {
     manualCommand: plan.manualCommand
   };
   try {
-    mkdirSync10(dirname12(path), { recursive: true });
+    mkdirSync10(dirname13(path), { recursive: true });
     writeFileSync15(path, `${JSON.stringify(marker, null, 2)}
 `, "utf8");
   } catch {
@@ -24544,7 +24591,7 @@ function runCommand(command, args, env = process.env, options = {}) {
   });
 }
 function writeSidecarLauncher(input2) {
-  mkdirSync10(dirname12(input2.path), { recursive: true });
+  mkdirSync10(dirname13(input2.path), { recursive: true });
   if (process.platform === "win32") {
     writeFileSync15(
       input2.path,
@@ -24581,7 +24628,7 @@ async function runPythonSidecarUpdatePlan(plan, options = {}) {
   writeFileSync15(join14(tempDir, "package.json"), NPM_SDK_SIDECAR_PACKAGE_JSON);
   const env = {
     ...process.env,
-    PATH: `${dirname12(plan.nodeBin)}${process.platform === "win32" ? ";" : ":"}${process.env.PATH ?? ""}`
+    PATH: `${dirname13(plan.nodeBin)}${process.platform === "win32" ? ";" : ":"}${process.env.PATH ?? ""}`
   };
   const installExitCode = await runCommand(
     plan.npmCommand,

package/dist/index.d.mts

@@ -2983,6 +2983,17 @@ type ConditionalStepResolver<Row, Value, Else = null> = {
 type StepOptions<Row, Value = unknown> = {
     /** Optional row-level gate. Skipped rows produce `null` for this column. */
     readonly runIf?: (row: Row, index: number) => boolean | Promise<boolean>;
+    /**
+     * Legacy dataset-column recompute flag accepted for older authored plays.
+     *
+     * Prefer putting freshness on the actual reusable call
+     * (`ctx.tools.execute`, `ctx.step`, `ctx.fetch`, or `ctx.runPlay`).
+     */
+    readonly recompute?: boolean;
+    /** Legacy error-recompute flag accepted for older authored plays. */
+    readonly recomputeOnError?: boolean;
+    /** Legacy cell staleness metadata accepted for older authored plays. */
+    readonly staleAfterSeconds?: number;
 };
 type StepProgram<Input, Output, Return = Output> = {
     readonly kind: 'steps';
@@ -3001,6 +3012,9 @@ type StepProgramResolver<Input, Return> = {
 };
 type PlayStepProgramStep = {
     readonly name: string;
+    readonly recompute?: boolean;
+    readonly recomputeOnError?: boolean;
+    readonly staleAfterSeconds?: number;
     readonly resolver: StepResolver<Record<string, unknown>, unknown> | ConditionalStepResolver<Record<string, unknown>, unknown> | StepProgramResolver<Record<string, unknown>, unknown>;
 };
 type ColumnResolver<Row, Value> = StepResolver<Row, Value> | ConditionalStepResolver<Row, Value> | StepProgramResolver<Row, Value>;

package/dist/index.d.ts

@@ -2983,6 +2983,17 @@ type ConditionalStepResolver<Row, Value, Else = null> = {
 type StepOptions<Row, Value = unknown> = {
     /** Optional row-level gate. Skipped rows produce `null` for this column. */
     readonly runIf?: (row: Row, index: number) => boolean | Promise<boolean>;
+    /**
+     * Legacy dataset-column recompute flag accepted for older authored plays.
+     *
+     * Prefer putting freshness on the actual reusable call
+     * (`ctx.tools.execute`, `ctx.step`, `ctx.fetch`, or `ctx.runPlay`).
+     */
+    readonly recompute?: boolean;
+    /** Legacy error-recompute flag accepted for older authored plays. */
+    readonly recomputeOnError?: boolean;
+    /** Legacy cell staleness metadata accepted for older authored plays. */
+    readonly staleAfterSeconds?: number;
 };
 type StepProgram<Input, Output, Return = Output> = {
     readonly kind: 'steps';
@@ -3001,6 +3012,9 @@ type StepProgramResolver<Input, Return> = {
 };
 type PlayStepProgramStep = {
     readonly name: string;
+    readonly recompute?: boolean;
+    readonly recomputeOnError?: boolean;
+    readonly staleAfterSeconds?: number;
     readonly resolver: StepResolver<Record<string, unknown>, unknown> | ConditionalStepResolver<Record<string, unknown>, unknown> | StepProgramResolver<Record<string, unknown>, unknown>;
 };
 type ColumnResolver<Row, Value> = StepResolver<Row, Value> | ConditionalStepResolver<Row, Value> | StepProgramResolver<Row, Value>;

package/dist/index.js

@@ -421,10 +421,10 @@ var SDK_RELEASE = {
   // 0.1.111 ships dataset-native tool list getters and result row datasets.
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
-  version: "0.1.156",
+  version: "0.1.158",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.156",
+    latest: "0.1.158",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -5114,6 +5114,9 @@ var DeeplineStepProgram = class _DeeplineStepProgram {
         ...this.steps,
         {
           name,
+          ...options?.recompute === true ? { recompute: true } : {},
+          ...options?.recomputeOnError === true ? { recomputeOnError: true } : {},
+          ...typeof options?.staleAfterSeconds === "number" ? { staleAfterSeconds: options.staleAfterSeconds } : {},
           resolver: stepResolver
         }
       ],