deepline 0.1.189 → 0.1.190

package/dist/bundling-sources/sdk/src/release.ts

@@ -105,10 +105,10 @@ export const SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: '0.1.189',
+  version: '0.1.190',
   apiContract: '2026-06-dataset-handle-results-hard-cutover',
   supportPolicy: {
-    latest: '0.1.189',
+    latest: '0.1.190',
     minimumSupported: '0.1.53',
     deprecatedBelow: '0.1.53',
     commandMinimumSupported: [

package/dist/cli/index.js

@@ -623,10 +623,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.189",
+  version: "0.1.190",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.189",
+    latest: "0.1.190",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -4829,14 +4829,64 @@ function readCsvRows(csvPath) {
   });
 }
 function csvStringFromRows(rows, columns) {
-  return (0, import_sync2.stringify)(rows, {
+  return (0, import_sync2.stringify)(rows.map(csvSafeRow), {
     header: true,
     cast: {
-      boolean: (value) => value ? "true" : "false"
+      boolean: (value) => value ? "true" : "false",
+      object: (value) => {
+        const cell = csvSafeCell(value);
+        return typeof cell === "string" ? cell : null;
+      }
     },
     ...columns?.length ? { columns } : {}
   });
 }
+function csvSafeRow(row) {
+  return Object.fromEntries(
+    Object.entries(row).map(([key, value]) => [key, csvSafeCell(value)])
+  );
+}
+function csvSafeCell(value) {
+  if (value === void 0) {
+    return null;
+  }
+  if (value === null) {
+    return null;
+  }
+  if (typeof value === "bigint") {
+    return value.toString();
+  }
+  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+    return value;
+  }
+  if (value instanceof Date) {
+    return value.toISOString();
+  }
+  if (typeof value === "symbol" || typeof value === "function") {
+    return null;
+  }
+  if (typeof value !== "object") {
+    return String(value);
+  }
+  return csvSafeJsonString(value);
+}
+function csvSafeJsonReplacer(_key, nested) {
+  if (typeof nested === "bigint") {
+    return nested.toString();
+  }
+  if (nested === void 0 || typeof nested === "symbol" || typeof nested === "function") {
+    return null;
+  }
+  return nested;
+}
+function csvSafeJsonString(value) {
+  try {
+    const serialized = JSON.stringify(value, csvSafeJsonReplacer);
+    return serialized ?? null;
+  } catch {
+    return String(value);
+  }
+}
 function parseMaybeJsonObject(value) {
   if (typeof value !== "string") {
     return value;
@@ -4877,14 +4927,14 @@ function flattenObjectColumns(row, options = {}) {
     const value = parseMaybeJsonObject(rawValue);
     const parsedFromString = typeof rawValue === "string" && value !== rawValue;
     if (key === "_metadata") {
-      flattened[key] = value && typeof value === "object" ? JSON.stringify(value) : value;
+      flattened[key] = value && typeof value === "object" ? csvSafeJsonString(value) : value;
       continue;
     }
     if (value && typeof value === "object" && !Array.isArray(value)) {
       const record = value;
       const hasMatchedEnvelope = Object.prototype.hasOwnProperty.call(record, "matched_result") || Object.prototype.hasOwnProperty.call(record, "matchedResult");
       if (hasMatchedEnvelope) {
-        flattened[key] = JSON.stringify(record);
+        flattened[key] = csvSafeJsonString(record);
         continue;
       }
       if (parsedFromString && shouldPreserveJsonStringColumn(options.preserveJsonStringColumns, key)) {
@@ -4896,16 +4946,16 @@ function flattenObjectColumns(row, options = {}) {
           flattened[key] = failureMessage;
           continue;
         } else if (Object.prototype.hasOwnProperty.call(record, "result")) {
-          flattened[key] = JSON.stringify(record);
+          flattened[key] = csvSafeJsonString(record);
           continue;
         }
       }
       for (const [nestedKey, nestedValue] of Object.entries(record)) {
-        flattened[`${key}.${nestedKey}`] = nestedValue && typeof nestedValue === "object" ? JSON.stringify(nestedValue) : nestedValue;
+        flattened[`${key}.${nestedKey}`] = nestedValue && typeof nestedValue === "object" ? csvSafeJsonString(nestedValue) : nestedValue;
       }
       continue;
     }
-    flattened[key] = Array.isArray(value) ? JSON.stringify(value) : value;
+    flattened[key] = Array.isArray(value) ? csvSafeJsonString(value) : value;
   }
   return flattened;
 }
@@ -16968,16 +17018,39 @@ function helperSource() {
     ``,
     `function __dlGetByPath(root: unknown, path: string): unknown {`,
     `  let cursor = root;`,
-    `  for (const part of __dlPathParts(path)) {`,
+    `  const parts = __dlPathParts(path);`,
+    `  for (let index = 0; index < parts.length; index += 1) {`,
+    `    const part = parts[index] || '';`,
+    `    cursor = __dlParseJsonContainer(cursor);`,
     `    if (!cursor || typeof cursor !== 'object') return undefined;`,
     `    const record = cursor as Record<string, unknown>;`,
-    `    const field = __dlGetRecordField(record, part);`,
+    `    let field = { found: false, value: undefined as unknown };`,
+    `    for (let end = parts.length; end > index + 1; end -= 1) {`,
+    `      const dottedPart = parts.slice(index, end).join('.');`,
+    `      field = __dlGetRecordField(record, dottedPart);`,
+    `      if (field.found) {`,
+    `        index = end - 1;`,
+    `        break;`,
+    `      }`,
+    `    }`,
+    `    if (!field.found) field = __dlGetRecordField(record, part);`,
     `    if (!field.found) return undefined;`,
     `    cursor = field.value;`,
     `  }`,
     `  return cursor;`,
     `}`,
     ``,
+    `function __dlParseJsonContainer(value: unknown): unknown {`,
+    `  if (typeof value !== 'string') return value;`,
+    `  const trimmed = value.trim();`,
+    `  if ((!trimmed.startsWith('{') || !trimmed.endsWith('}')) && (!trimmed.startsWith('[') || !trimmed.endsWith(']'))) return value;`,
+    `  try {`,
+    `    return JSON.parse(trimmed);`,
+    `  } catch {`,
+    `    return value;`,
+    `  }`,
+    `}`,
+    ``,
     `function __dlMeaningful(value: unknown): boolean {`,
     `  if (value && typeof value === 'object' && !Array.isArray(value)) {`,
     `    const record = value as Record<string, unknown>;`,
@@ -19998,6 +20071,12 @@ function sidecarEnrichRowsExportPath(outputPath) {
   const stem = (0, import_node_path12.basename)(resolved, ext);
   return (0, import_node_path12.join)((0, import_node_path12.dirname)(resolved), `${stem}.deepline-enrich-rows${ext}`);
 }
+function sidecarEnrichBatchManifestPath(outputPath) {
+  const resolved = (0, import_node_path12.resolve)(outputPath);
+  const ext = (0, import_node_path12.extname)(resolved) || ".csv";
+  const stem = (0, import_node_path12.basename)(resolved, ext);
+  return (0, import_node_path12.join)((0, import_node_path12.dirname)(resolved), `${stem}.deepline-enrich-batches.json`);
+}
 function collectDatasetFollowUpCommands(value, state) {
   if (state.depth > 12 || !value || typeof value !== "object" || state.commands.length >= 8) {
     return;
@@ -20503,7 +20582,7 @@ var ENRICH_FLATTENED_CONTROL_FIELDS = /* @__PURE__ */ new Set([
 ]);
 function materializeCsvCellValue(value) {
   if (value && typeof value === "object") {
-    return JSON.stringify(value);
+    return csvSafeJsonString(value);
   }
   return value;
 }
@@ -20905,13 +20984,35 @@ function registerEnrichCommand(program) {
     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;
     const enrichIssueFollowUpOutputPath = options.inPlace && inPlaceFinalOutputPath ? sidecarEnrichRowsExportPath(inPlaceFinalOutputPath) : null;
-    let inPlaceCommitted = false;
+    const prepareInPlaceOutput = async () => {
+      if (!options.inPlace) {
+        return;
+      }
+      if (inPlaceTempDir) {
+        await (0, import_promises3.rm)(inPlaceTempDir, { recursive: true, force: true });
+      }
+      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 commitInPlaceOutput = async (exportResult) => {
       if (!inPlaceTempOutputPath || !inPlaceCommitOutputPath || !inPlaceFinalOutputPath) {
         return exportResult;
       }
+      const committedTempDir = inPlaceTempDir;
       await (0, import_promises3.rename)(inPlaceTempOutputPath, inPlaceCommitOutputPath);
-      inPlaceCommitted = true;
+      inPlaceTempDir = null;
+      inPlaceTempOutputPath = null;
+      outputPath = inPlaceFinalOutputPath;
+      if (committedTempDir) {
+        await (0, import_promises3.rm)(committedTempDir, { recursive: true, force: true });
+      }
       if (!exportResult) {
         return null;
       }
@@ -20923,15 +21024,7 @@ function registerEnrichCommand(program) {
     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;
+        await prepareInPlaceOutput();
       }
       const runOne = async (input2) => {
         const runtimeInput = {
@@ -20986,12 +21079,62 @@ function registerEnrichCommand(program) {
       const autoBatchRows = enrichAutoBatchRowsForConfig(config);
       if (outputPath && selectedRange.count > autoBatchRows) {
         const chunkCount = Math.ceil(selectedRange.count / autoBatchRows);
+        const batchManifestPath = sidecarEnrichBatchManifestPath(
+          inPlaceFinalOutputPath ?? (0, import_node_path12.resolve)(outputPath)
+        );
+        const batchManifest = {
+          version: 1,
+          kind: "deepline_enrich_batch_manifest",
+          input: (0, import_node_path12.resolve)(inputCsv),
+          output: inPlaceFinalOutputPath ?? (0, import_node_path12.resolve)(outputPath),
+          selectedRows: selectedRange.count,
+          sourceCsvRows: selectedRange.sourceRows,
+          chunkRows: autoBatchRows,
+          chunks: chunkCount,
+          updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+          batches: []
+        };
+        const writeBatchManifest = async () => {
+          batchManifest.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+          await (0, import_promises3.writeFile)(
+            batchManifestPath,
+            `${JSON.stringify(batchManifest, null, 2)}
+`,
+            "utf8"
+          );
+        };
+        const appendBatchManifestEntry = async (input2) => {
+          const runId = extractRunId(input2.status) ?? firstCollectedStringField(input2.status, "runId");
+          batchManifest.batches.push({
+            chunk: input2.chunkIndex + 1,
+            chunks: chunkCount,
+            rows: {
+              rowStart: input2.rows.rowStart,
+              rowEnd: input2.rows.rowEnd
+            },
+            status: readEnrichRunStatus(input2.status),
+            runId,
+            customer_db: enrichCustomerDbJson({
+              status: input2.status,
+              client: client2,
+              outputPath: enrichIssueFollowUpOutputPath ?? input2.exportResult?.path ?? outputPath
+            }),
+            output: enrichOutputJson(input2.exportResult),
+            completedAt: (/* @__PURE__ */ new Date()).toISOString()
+          });
+          await writeBatchManifest();
+        };
+        await writeBatchManifest();
         if (!options.json) {
           process.stderr.write(
             `Large enrich input selected ${selectedRange.count.toLocaleString()} rows. Running ${chunkCount.toLocaleString()} sequential batch runs of up to ${autoBatchRows.toLocaleString()} rows and merging ${(0, import_node_path12.resolve)(outputPath)}.
 `
           );
         }
+        process.stderr.write(
+          `Batch recovery manifest: ${batchManifestPath}
+`
+        );
         let workingMergeSourceCsvPath = sourceCsvPath;
         let lastStatus = null;
         const batchStatuses = [];
@@ -21034,6 +21177,7 @@ function registerEnrichCommand(program) {
           lastStatus = chunk.status;
           batchStatuses.push(chunk.status);
           if (chunk.captured.result !== 0) {
+            let currentChunkCommittedExportResult = null;
             if (chunk.exportResult) {
               finalExportResult = chunk.exportResult;
               totalEnrichedRows += countEnrichedRowsInSourceRange(
@@ -21057,37 +21201,48 @@ function registerEnrichCommand(program) {
               waterfallStatus: batchStatuses,
               ...finalExportResult ? { rowSetComplete: !finalExportResult.partial } : {}
             });
-            const committedExportResult2 = finalExportResult ? await commitInPlaceOutput(finalExportResult) : null;
+            if (chunk.exportResult) {
+              currentChunkCommittedExportResult = await commitInPlaceOutput(chunk.exportResult);
+              finalExportResult = currentChunkCommittedExportResult;
+            }
+            const reportedExportResult = currentChunkCommittedExportResult ?? finalExportResult;
+            await appendBatchManifestEntry({
+              chunkIndex,
+              rows: chunkRows,
+              status: chunk.status,
+              exportResult: currentChunkCommittedExportResult
+            });
             if (options.json) {
               printJson({
                 ok: false,
                 batch: {
                   chunk: chunkIndex + 1,
                   chunks: chunkCount,
-                  rows: chunkRows
+                  rows: chunkRows,
+                  manifest: batchManifestPath
                 },
                 result: chunk.status,
-                output: committedExportResult2 ? {
+                output: reportedExportResult ? {
                   sourceCsvRows: selectedRange.sourceRows,
                   selectedRows: selectedRange.count,
                   enrichedRows: totalEnrichedRows,
-                  path: committedExportResult2.path,
-                  ...committedExportResult2.partial ? {
-                    rows: committedExportResult2.rows,
+                  path: reportedExportResult.path,
+                  ...reportedExportResult.partial ? {
+                    rows: reportedExportResult.rows,
                     partial: true
                   } : {}
                 } : null,
                 customer_db: enrichCustomerDbJson({
                   status: chunk.status,
                   client: client2,
-                  outputPath: enrichIssueFollowUpOutputPath ?? committedExportResult2?.path ?? outputPath
+                  outputPath: enrichIssueFollowUpOutputPath ?? reportedExportResult?.path ?? outputPath
                 }),
                 ...enrichReportJson(failureReport3)
               });
             } else {
-              if (committedExportResult2) {
+              if (reportedExportResult) {
                 process.stderr.write(
-                  `Wrote ${committedExportResult2.rows} row(s) to ${committedExportResult2.path}${committedExportResult2.partial ? " (partial run output)" : ""}
+                  `Wrote ${reportedExportResult.rows} row(s) to ${reportedExportResult.path}${reportedExportResult.partial ? " (partial run output)" : ""}
 `
                 );
               }
@@ -21102,13 +21257,22 @@ function registerEnrichCommand(program) {
             return;
           }
           if (chunk.exportResult) {
-            finalExportResult = chunk.exportResult;
             totalEnrichedRows += countEnrichedRowsInSourceRange(
               chunk.exportResult,
               chunkRows
             );
             batchFailureRows.push(...chunk.exportResult.enrichedDataRows);
+            finalExportResult = options.inPlace ? await commitInPlaceOutput(chunk.exportResult) : chunk.exportResult;
+            await appendBatchManifestEntry({
+              chunkIndex,
+              rows: chunkRows,
+              status: chunk.status,
+              exportResult: finalExportResult
+            });
             workingMergeSourceCsvPath = outputPath;
+            if (options.inPlace && (chunkRows.rowEnd ?? selectedRange.end) < selectedRange.end) {
+              await prepareInPlaceOutput();
+            }
           }
         }
         const outputRows = readCsvRows(outputPath);
@@ -21148,7 +21312,8 @@ function registerEnrichCommand(program) {
             batch: {
               chunks: chunkCount,
               chunkRows: autoBatchRows,
-              selectedRows: selectedRange.count
+              selectedRows: selectedRange.count,
+              manifest: batchManifestPath
             },
             output: finalExportResult ? {
               sourceCsvRows: selectedRange.sourceRows,
@@ -21278,7 +21443,7 @@ function registerEnrichCommand(program) {
     } finally {
       if (inPlaceTempDir) {
         await (0, import_promises3.rm)(inPlaceTempDir, { recursive: true, force: true });
-      } else if (inPlaceTempOutputPath && !inPlaceCommitted) {
+      } else if (inPlaceTempOutputPath) {
         await (0, import_promises3.rm)(inPlaceTempOutputPath, { force: true });
       }
       await (0, import_promises3.rm)(tempDir, { recursive: true, force: true });

package/dist/cli/index.mjs

@@ -608,10 +608,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.189",
+  version: "0.1.190",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.189",
+    latest: "0.1.190",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -4826,14 +4826,64 @@ function readCsvRows(csvPath) {
   });
 }
 function csvStringFromRows(rows, columns) {
-  return stringify(rows, {
+  return stringify(rows.map(csvSafeRow), {
     header: true,
     cast: {
-      boolean: (value) => value ? "true" : "false"
+      boolean: (value) => value ? "true" : "false",
+      object: (value) => {
+        const cell = csvSafeCell(value);
+        return typeof cell === "string" ? cell : null;
+      }
     },
     ...columns?.length ? { columns } : {}
   });
 }
+function csvSafeRow(row) {
+  return Object.fromEntries(
+    Object.entries(row).map(([key, value]) => [key, csvSafeCell(value)])
+  );
+}
+function csvSafeCell(value) {
+  if (value === void 0) {
+    return null;
+  }
+  if (value === null) {
+    return null;
+  }
+  if (typeof value === "bigint") {
+    return value.toString();
+  }
+  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+    return value;
+  }
+  if (value instanceof Date) {
+    return value.toISOString();
+  }
+  if (typeof value === "symbol" || typeof value === "function") {
+    return null;
+  }
+  if (typeof value !== "object") {
+    return String(value);
+  }
+  return csvSafeJsonString(value);
+}
+function csvSafeJsonReplacer(_key, nested) {
+  if (typeof nested === "bigint") {
+    return nested.toString();
+  }
+  if (nested === void 0 || typeof nested === "symbol" || typeof nested === "function") {
+    return null;
+  }
+  return nested;
+}
+function csvSafeJsonString(value) {
+  try {
+    const serialized = JSON.stringify(value, csvSafeJsonReplacer);
+    return serialized ?? null;
+  } catch {
+    return String(value);
+  }
+}
 function parseMaybeJsonObject(value) {
   if (typeof value !== "string") {
     return value;
@@ -4874,14 +4924,14 @@ function flattenObjectColumns(row, options = {}) {
     const value = parseMaybeJsonObject(rawValue);
     const parsedFromString = typeof rawValue === "string" && value !== rawValue;
     if (key === "_metadata") {
-      flattened[key] = value && typeof value === "object" ? JSON.stringify(value) : value;
+      flattened[key] = value && typeof value === "object" ? csvSafeJsonString(value) : value;
       continue;
     }
     if (value && typeof value === "object" && !Array.isArray(value)) {
       const record = value;
       const hasMatchedEnvelope = Object.prototype.hasOwnProperty.call(record, "matched_result") || Object.prototype.hasOwnProperty.call(record, "matchedResult");
       if (hasMatchedEnvelope) {
-        flattened[key] = JSON.stringify(record);
+        flattened[key] = csvSafeJsonString(record);
         continue;
       }
       if (parsedFromString && shouldPreserveJsonStringColumn(options.preserveJsonStringColumns, key)) {
@@ -4893,16 +4943,16 @@ function flattenObjectColumns(row, options = {}) {
           flattened[key] = failureMessage;
           continue;
         } else if (Object.prototype.hasOwnProperty.call(record, "result")) {
-          flattened[key] = JSON.stringify(record);
+          flattened[key] = csvSafeJsonString(record);
           continue;
         }
       }
       for (const [nestedKey, nestedValue] of Object.entries(record)) {
-        flattened[`${key}.${nestedKey}`] = nestedValue && typeof nestedValue === "object" ? JSON.stringify(nestedValue) : nestedValue;
+        flattened[`${key}.${nestedKey}`] = nestedValue && typeof nestedValue === "object" ? csvSafeJsonString(nestedValue) : nestedValue;
       }
       continue;
     }
-    flattened[key] = Array.isArray(value) ? JSON.stringify(value) : value;
+    flattened[key] = Array.isArray(value) ? csvSafeJsonString(value) : value;
   }
   return flattened;
 }
@@ -16995,16 +17045,39 @@ function helperSource() {
     ``,
     `function __dlGetByPath(root: unknown, path: string): unknown {`,
     `  let cursor = root;`,
-    `  for (const part of __dlPathParts(path)) {`,
+    `  const parts = __dlPathParts(path);`,
+    `  for (let index = 0; index < parts.length; index += 1) {`,
+    `    const part = parts[index] || '';`,
+    `    cursor = __dlParseJsonContainer(cursor);`,
     `    if (!cursor || typeof cursor !== 'object') return undefined;`,
     `    const record = cursor as Record<string, unknown>;`,
-    `    const field = __dlGetRecordField(record, part);`,
+    `    let field = { found: false, value: undefined as unknown };`,
+    `    for (let end = parts.length; end > index + 1; end -= 1) {`,
+    `      const dottedPart = parts.slice(index, end).join('.');`,
+    `      field = __dlGetRecordField(record, dottedPart);`,
+    `      if (field.found) {`,
+    `        index = end - 1;`,
+    `        break;`,
+    `      }`,
+    `    }`,
+    `    if (!field.found) field = __dlGetRecordField(record, part);`,
     `    if (!field.found) return undefined;`,
     `    cursor = field.value;`,
     `  }`,
     `  return cursor;`,
     `}`,
     ``,
+    `function __dlParseJsonContainer(value: unknown): unknown {`,
+    `  if (typeof value !== 'string') return value;`,
+    `  const trimmed = value.trim();`,
+    `  if ((!trimmed.startsWith('{') || !trimmed.endsWith('}')) && (!trimmed.startsWith('[') || !trimmed.endsWith(']'))) return value;`,
+    `  try {`,
+    `    return JSON.parse(trimmed);`,
+    `  } catch {`,
+    `    return value;`,
+    `  }`,
+    `}`,
+    ``,
     `function __dlMeaningful(value: unknown): boolean {`,
     `  if (value && typeof value === 'object' && !Array.isArray(value)) {`,
     `    const record = value as Record<string, unknown>;`,
@@ -20025,6 +20098,12 @@ function sidecarEnrichRowsExportPath(outputPath) {
   const stem = basename2(resolved, ext);
   return join7(dirname7(resolved), `${stem}.deepline-enrich-rows${ext}`);
 }
+function sidecarEnrichBatchManifestPath(outputPath) {
+  const resolved = resolve9(outputPath);
+  const ext = extname(resolved) || ".csv";
+  const stem = basename2(resolved, ext);
+  return join7(dirname7(resolved), `${stem}.deepline-enrich-batches.json`);
+}
 function collectDatasetFollowUpCommands(value, state) {
   if (state.depth > 12 || !value || typeof value !== "object" || state.commands.length >= 8) {
     return;
@@ -20530,7 +20609,7 @@ var ENRICH_FLATTENED_CONTROL_FIELDS = /* @__PURE__ */ new Set([
 ]);
 function materializeCsvCellValue(value) {
   if (value && typeof value === "object") {
-    return JSON.stringify(value);
+    return csvSafeJsonString(value);
   }
   return value;
 }
@@ -20932,13 +21011,35 @@ function registerEnrichCommand(program) {
     const inPlaceCommitOutputPath = options.inPlace ? (await lstat(inputCsv)).isSymbolicLink() ? await realpath(inputCsv) : inPlaceFinalOutputPath : null;
     const failureReportOutputPath = options.inPlace ? inPlaceFinalOutputPath : null;
     const enrichIssueFollowUpOutputPath = options.inPlace && inPlaceFinalOutputPath ? sidecarEnrichRowsExportPath(inPlaceFinalOutputPath) : null;
-    let inPlaceCommitted = false;
+    const prepareInPlaceOutput = async () => {
+      if (!options.inPlace) {
+        return;
+      }
+      if (inPlaceTempDir) {
+        await rm(inPlaceTempDir, { recursive: true, force: true });
+      }
+      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 commitInPlaceOutput = async (exportResult) => {
       if (!inPlaceTempOutputPath || !inPlaceCommitOutputPath || !inPlaceFinalOutputPath) {
         return exportResult;
       }
+      const committedTempDir = inPlaceTempDir;
       await rename(inPlaceTempOutputPath, inPlaceCommitOutputPath);
-      inPlaceCommitted = true;
+      inPlaceTempDir = null;
+      inPlaceTempOutputPath = null;
+      outputPath = inPlaceFinalOutputPath;
+      if (committedTempDir) {
+        await rm(committedTempDir, { recursive: true, force: true });
+      }
       if (!exportResult) {
         return null;
       }
@@ -20950,15 +21051,7 @@ function registerEnrichCommand(program) {
     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;
+        await prepareInPlaceOutput();
       }
       const runOne = async (input2) => {
         const runtimeInput = {
@@ -21013,12 +21106,62 @@ function registerEnrichCommand(program) {
       const autoBatchRows = enrichAutoBatchRowsForConfig(config);
       if (outputPath && selectedRange.count > autoBatchRows) {
         const chunkCount = Math.ceil(selectedRange.count / autoBatchRows);
+        const batchManifestPath = sidecarEnrichBatchManifestPath(
+          inPlaceFinalOutputPath ?? resolve9(outputPath)
+        );
+        const batchManifest = {
+          version: 1,
+          kind: "deepline_enrich_batch_manifest",
+          input: resolve9(inputCsv),
+          output: inPlaceFinalOutputPath ?? resolve9(outputPath),
+          selectedRows: selectedRange.count,
+          sourceCsvRows: selectedRange.sourceRows,
+          chunkRows: autoBatchRows,
+          chunks: chunkCount,
+          updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+          batches: []
+        };
+        const writeBatchManifest = async () => {
+          batchManifest.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+          await writeFile3(
+            batchManifestPath,
+            `${JSON.stringify(batchManifest, null, 2)}
+`,
+            "utf8"
+          );
+        };
+        const appendBatchManifestEntry = async (input2) => {
+          const runId = extractRunId(input2.status) ?? firstCollectedStringField(input2.status, "runId");
+          batchManifest.batches.push({
+            chunk: input2.chunkIndex + 1,
+            chunks: chunkCount,
+            rows: {
+              rowStart: input2.rows.rowStart,
+              rowEnd: input2.rows.rowEnd
+            },
+            status: readEnrichRunStatus(input2.status),
+            runId,
+            customer_db: enrichCustomerDbJson({
+              status: input2.status,
+              client: client2,
+              outputPath: enrichIssueFollowUpOutputPath ?? input2.exportResult?.path ?? outputPath
+            }),
+            output: enrichOutputJson(input2.exportResult),
+            completedAt: (/* @__PURE__ */ new Date()).toISOString()
+          });
+          await writeBatchManifest();
+        };
+        await writeBatchManifest();
         if (!options.json) {
           process.stderr.write(
             `Large enrich input selected ${selectedRange.count.toLocaleString()} rows. Running ${chunkCount.toLocaleString()} sequential batch runs of up to ${autoBatchRows.toLocaleString()} rows and merging ${resolve9(outputPath)}.
 `
           );
         }
+        process.stderr.write(
+          `Batch recovery manifest: ${batchManifestPath}
+`
+        );
         let workingMergeSourceCsvPath = sourceCsvPath;
         let lastStatus = null;
         const batchStatuses = [];
@@ -21061,6 +21204,7 @@ function registerEnrichCommand(program) {
           lastStatus = chunk.status;
           batchStatuses.push(chunk.status);
           if (chunk.captured.result !== 0) {
+            let currentChunkCommittedExportResult = null;
             if (chunk.exportResult) {
               finalExportResult = chunk.exportResult;
               totalEnrichedRows += countEnrichedRowsInSourceRange(
@@ -21084,37 +21228,48 @@ function registerEnrichCommand(program) {
               waterfallStatus: batchStatuses,
               ...finalExportResult ? { rowSetComplete: !finalExportResult.partial } : {}
             });
-            const committedExportResult2 = finalExportResult ? await commitInPlaceOutput(finalExportResult) : null;
+            if (chunk.exportResult) {
+              currentChunkCommittedExportResult = await commitInPlaceOutput(chunk.exportResult);
+              finalExportResult = currentChunkCommittedExportResult;
+            }
+            const reportedExportResult = currentChunkCommittedExportResult ?? finalExportResult;
+            await appendBatchManifestEntry({
+              chunkIndex,
+              rows: chunkRows,
+              status: chunk.status,
+              exportResult: currentChunkCommittedExportResult
+            });
             if (options.json) {
               printJson({
                 ok: false,
                 batch: {
                   chunk: chunkIndex + 1,
                   chunks: chunkCount,
-                  rows: chunkRows
+                  rows: chunkRows,
+                  manifest: batchManifestPath
                 },
                 result: chunk.status,
-                output: committedExportResult2 ? {
+                output: reportedExportResult ? {
                   sourceCsvRows: selectedRange.sourceRows,
                   selectedRows: selectedRange.count,
                   enrichedRows: totalEnrichedRows,
-                  path: committedExportResult2.path,
-                  ...committedExportResult2.partial ? {
-                    rows: committedExportResult2.rows,
+                  path: reportedExportResult.path,
+                  ...reportedExportResult.partial ? {
+                    rows: reportedExportResult.rows,
                     partial: true
                   } : {}
                 } : null,
                 customer_db: enrichCustomerDbJson({
                   status: chunk.status,
                   client: client2,
-                  outputPath: enrichIssueFollowUpOutputPath ?? committedExportResult2?.path ?? outputPath
+                  outputPath: enrichIssueFollowUpOutputPath ?? reportedExportResult?.path ?? outputPath
                 }),
                 ...enrichReportJson(failureReport3)
               });
             } else {
-              if (committedExportResult2) {
+              if (reportedExportResult) {
                 process.stderr.write(
-                  `Wrote ${committedExportResult2.rows} row(s) to ${committedExportResult2.path}${committedExportResult2.partial ? " (partial run output)" : ""}
+                  `Wrote ${reportedExportResult.rows} row(s) to ${reportedExportResult.path}${reportedExportResult.partial ? " (partial run output)" : ""}
 `
                 );
               }
@@ -21129,13 +21284,22 @@ function registerEnrichCommand(program) {
             return;
           }
           if (chunk.exportResult) {
-            finalExportResult = chunk.exportResult;
             totalEnrichedRows += countEnrichedRowsInSourceRange(
               chunk.exportResult,
               chunkRows
             );
             batchFailureRows.push(...chunk.exportResult.enrichedDataRows);
+            finalExportResult = options.inPlace ? await commitInPlaceOutput(chunk.exportResult) : chunk.exportResult;
+            await appendBatchManifestEntry({
+              chunkIndex,
+              rows: chunkRows,
+              status: chunk.status,
+              exportResult: finalExportResult
+            });
             workingMergeSourceCsvPath = outputPath;
+            if (options.inPlace && (chunkRows.rowEnd ?? selectedRange.end) < selectedRange.end) {
+              await prepareInPlaceOutput();
+            }
           }
         }
         const outputRows = readCsvRows(outputPath);
@@ -21175,7 +21339,8 @@ function registerEnrichCommand(program) {
             batch: {
               chunks: chunkCount,
               chunkRows: autoBatchRows,
-              selectedRows: selectedRange.count
+              selectedRows: selectedRange.count,
+              manifest: batchManifestPath
             },
             output: finalExportResult ? {
               sourceCsvRows: selectedRange.sourceRows,
@@ -21305,7 +21470,7 @@ function registerEnrichCommand(program) {
     } finally {
       if (inPlaceTempDir) {
         await rm(inPlaceTempDir, { recursive: true, force: true });
-      } else if (inPlaceTempOutputPath && !inPlaceCommitted) {
+      } else if (inPlaceTempOutputPath) {
         await rm(inPlaceTempOutputPath, { force: true });
       }
       await rm(tempDir, { recursive: true, force: true });

package/dist/index.js

@@ -422,10 +422,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.189",
+  version: "0.1.190",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.189",
+    latest: "0.1.190",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [

package/dist/index.mjs

@@ -352,10 +352,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.189",
+  version: "0.1.190",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.189",
+    latest: "0.1.190",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.1.189",
+  "version": "0.1.190",
   "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
   "license": "MIT",
   "repository": {