deepline 0.1.268 → 0.1.269

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

@@ -155,7 +155,7 @@ export const SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: '0.1.268',
+  version: '0.1.269',
   contracts: {
     api: {
       name: 'sdk-http-api',

package/dist/bundling-sources/shared_libs/play-runtime/run-ledger.ts

@@ -1023,6 +1023,57 @@ function terminalFinishedAt(
   return base.finishedAt ?? occurredAt;
 }
 
+function isStepLifecycleEvent(event: PlayRunLedgerEvent): boolean {
+  return (
+    event.type === 'step.started' ||
+    event.type === 'step.progress' ||
+    event.type === 'step.completed' ||
+    event.type === 'step.failed' ||
+    event.type === 'step.skipped'
+  );
+}
+
+/**
+ * A terminal status patch can arrive twice: first without a step start, then
+ * with the original start timestamp after the runner recovers its progress
+ * buffer. A completed node whose start equals its completion is synthetic, so
+ * this is the only late lifecycle refinement that is safe to admit. It cannot
+ * create a node, change a terminal status, alter completion, or revive active
+ * work. Preserve the Run Snapshot's own timestamps while making the node's
+ * duration truthful.
+ */
+function refineTerminalSyntheticStepStart(
+  snapshot: PlayRunLedgerSnapshot,
+  event: Extract<PlayRunLedgerEvent, { type: 'step.progress' }>,
+): PlayRunLedgerSnapshot | null {
+  const current = snapshot.stepsById[event.stepId];
+  const startedAt = event.progress.startedAt;
+  if (
+    current?.status !== 'completed' ||
+    event.status !== 'completed' ||
+    typeof startedAt !== 'number' ||
+    current.startedAt == null ||
+    current.completedAt == null ||
+    current.startedAt !== current.completedAt ||
+    startedAt >= current.startedAt
+  ) {
+    return null;
+  }
+  return {
+    ...snapshot,
+    stepsById: {
+      ...snapshot.stepsById,
+      [event.stepId]: {
+        ...current,
+        startedAt,
+        progress: current.progress
+          ? { ...current.progress, startedAt }
+          : { startedAt },
+      },
+    },
+  };
+}
+
 export function reducePlayRunLedgerEvent(
   snapshot: PlayRunLedgerSnapshot,
   event: PlayRunLedgerEvent,
@@ -1030,6 +1081,18 @@ export function reducePlayRunLedgerEvent(
   if (event.runId !== snapshot.runId) {
     return snapshot;
   }
+  // A terminal Run Snapshot is immutable with respect to step lifecycle.
+  // Detached runners can race their best-effort progress transport against the
+  // terminal outbox, and gateway processes can restart or split that traffic.
+  // The Play Run Ledger is the durable projection authority, so late
+  // `step.*` facts must be a true no-op here rather than relying on a gateway
+  // process to remember terminal state.
+  if (isTerminalPlayRunLedgerStatus(snapshot.status)) {
+    if (event.type === 'step.progress') {
+      return refineTerminalSyntheticStepStart(snapshot, event) ?? snapshot;
+    }
+    if (isStepLifecycleEvent(event)) return snapshot;
+  }
   // The scheduler's outbox can replay an older wait transition after its run
   // reached a terminal state. That transition is no longer meaningful and
   // must be byte-for-byte inert: even advancing `updatedAt` would re-publish

package/dist/cli/index.js

@@ -718,7 +718,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.268",
+  version: "0.1.269",
   contracts: {
     api: {
       name: "sdk-http-api",

package/dist/cli/index.mjs

@@ -703,7 +703,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.268",
+  version: "0.1.269",
   contracts: {
     api: {
       name: "sdk-http-api",

package/dist/index.js

@@ -437,7 +437,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.268",
+  version: "0.1.269",
   contracts: {
     api: {
       name: "sdk-http-api",

package/dist/index.mjs

@@ -367,7 +367,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.268",
+  version: "0.1.269",
   contracts: {
     api: {
       name: "sdk-http-api",

package/package.json

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