deepline 0.3.263 → 0.3.264

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

@@ -200,7 +200,7 @@ export const SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: '0.3.263',
+  version: '0.3.264',
   updateSummary:
     'Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.',
   packageCapabilities: {

package/dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/postgres.ts

@@ -1152,6 +1152,7 @@ export type PostgresSchedulerSchemaShapeRequirements = Readonly<{
   /** v38 makes buffered Gradient2 observations idempotent; v37 ignores it. */
   gradient2ObservationDeduplication?: boolean;
   outboxWakeTrigger?: boolean;
+  gatewayReaderFence?: boolean;
   cronScheduleSchema?: boolean;
   /** v43 added per-run fair-share tracking for rate buckets; v42 ignores it. */
   rateRequesterFairShare?: boolean;
@@ -1448,7 +1449,7 @@ export async function hasCurrentPostgresSchedulerSchemaShape(
         AND to_regclass($15) IS NOT NULL
         AND to_regclass($17) IS NOT NULL
         AND to_regclass($18) IS NOT NULL
-        AND to_regclass($20) IS NOT NULL
+        AND ($39::boolean = false OR to_regclass($20) IS NOT NULL)
         AND to_regclass($21) IS NOT NULL
         AND to_regclass($22) IS NOT NULL
         AND ($24::boolean = false OR to_regclass($23) IS NOT NULL)
@@ -1833,6 +1834,7 @@ export async function hasCurrentPostgresSchedulerSchemaShape(
       requirements.rateScopeRetryAfter !== false,
       `${quotedSchema}.${quoteIdent('rate_scope_holds')}`,
       requirements.runtimeLogStorage !== false,
+      requirements.gatewayReaderFence !== false,
     ],
   );
   if (currentShape.rows[0]?.ready !== true) return false;
@@ -2016,6 +2018,40 @@ export async function hasCurrentPostgresSchedulerSchemaShape(
   return runtimeAdminIndexes.rows[0]?.ready === true;
 }
 
+async function ensurePostgresSchedulerCanonicalOutcomeColumns(
+  client: PostgresSchedulerQueryClient,
+  options?: Pick<PostgresSchedulerOptions, 'schema'>,
+): Promise<void> {
+  await client.query(`
+    ALTER TABLE ${tableName('integration_invocation_receipts', options)}
+      ADD COLUMN IF NOT EXISTS operation_request_digest text,
+      ADD COLUMN IF NOT EXISTS legacy_request_fingerprint text,
+      ADD COLUMN IF NOT EXISTS canonical_outcome_version smallint,
+      ADD COLUMN IF NOT EXISTS canonical_outcome_json jsonb,
+      ADD COLUMN IF NOT EXISTS canonical_outcome_ref jsonb,
+      ADD COLUMN IF NOT EXISTS canonical_outcome_pending_ref jsonb
+  `);
+}
+
+async function ensurePostgresSchedulerGatewayReaderFenceSchema(
+  client: PostgresSchedulerQueryClient,
+  options?: Pick<PostgresSchedulerOptions, 'schema'>,
+): Promise<void> {
+  await client.query(`
+    CREATE TABLE IF NOT EXISTS ${tableName('runtime_gateway_reader_fences', options)} (
+      scheduler_schema text PRIMARY KEY,
+      epoch bigint NOT NULL CHECK (epoch > 0),
+      mode text NOT NULL CHECK (mode IN ('legacy_byte_reader', 'canonical_v1')),
+      canonical_reader_proof jsonb,
+      updated_at timestamptz NOT NULL DEFAULT now(),
+      CHECK (
+        (mode = 'legacy_byte_reader' AND canonical_reader_proof IS NULL)
+        OR (mode = 'canonical_v1' AND canonical_reader_proof IS NOT NULL)
+      )
+    )
+  `);
+}
+
 /**
  * Expand the shared scheduler schema without retaining locks across tables.
  *
@@ -2039,11 +2075,7 @@ export async function ensurePostgresSchedulerOnlineAdditiveExpansion(
     ALTER TABLE ${tableName('receipts', options)}
       ADD COLUMN IF NOT EXISTS output_ref jsonb
   `);
-  await client.query(`
-    ALTER TABLE ${tableName('integration_invocation_receipts', options)}
-      ADD COLUMN IF NOT EXISTS canonical_outcome_ref jsonb,
-      ADD COLUMN IF NOT EXISTS canonical_outcome_pending_ref jsonb
-  `);
+  await ensurePostgresSchedulerCanonicalOutcomeColumns(client, options);
   await client.query(`
     CREATE TABLE IF NOT EXISTS ${tableName(
       'runtime_integration_operation_value_retirements',
@@ -2074,6 +2106,7 @@ export async function ensurePostgresSchedulerOnlineAdditiveExpansion(
       )} (state, updated_at)
   `);
   await ensurePostgresSchedulerRunLogStorageExpansion(client, options);
+  await ensurePostgresSchedulerGatewayReaderFenceSchema(client, options);
 }
 
 /** Deployment-only expansion; absent values keep legacy storage authoritative. */
@@ -2228,7 +2261,7 @@ async function ensurePostgresSchedulerTerminalComputeBillingOutboxTrigger(
  * future lifecycle producers. LISTEN/NOTIFY is only a hint; the projector
  * still leases and reads the durable outbox before delivery.
  */
-async function ensurePostgresSchedulerOutboxWakeTrigger(
+export async function ensurePostgresSchedulerOutboxWakeTrigger(
   client: PostgresSchedulerQueryClient,
   options?: Pick<PostgresSchedulerOptions, 'schema'>,
 ): Promise<void> {
@@ -3169,15 +3202,7 @@ export async function ensurePostgresSchedulerSchema(
     // historical transport records, not inferred canonical outcomes; gateway
     // replay keeps serving them byte-for-byte while the new operation Module
     // fails closed rather than redispatching or guessing their semantics.
-    await client.query(`
-    ALTER TABLE ${tableName('integration_invocation_receipts', options)}
-      ADD COLUMN IF NOT EXISTS operation_request_digest text,
-      ADD COLUMN IF NOT EXISTS legacy_request_fingerprint text,
-      ADD COLUMN IF NOT EXISTS canonical_outcome_version smallint,
-      ADD COLUMN IF NOT EXISTS canonical_outcome_json jsonb,
-      ADD COLUMN IF NOT EXISTS canonical_outcome_ref jsonb,
-      ADD COLUMN IF NOT EXISTS canonical_outcome_pending_ref jsonb
-  `);
+    await ensurePostgresSchedulerCanonicalOutcomeColumns(client, options);
     await client.query(`
     ALTER TABLE ${tableName('integration_invocation_receipts', options)}
       ADD COLUMN IF NOT EXISTS parent_run_id text NOT NULL DEFAULT ''
@@ -3218,19 +3243,7 @@ export async function ensurePostgresSchedulerSchema(
     // intentionally separate from runtime release admission: worker lanes do
     // not prove that every receipt/execution gateway can decode canonical IO
     // rows. Convex owns the source record; this is its local gateway mirror.
-    await client.query(`
-    CREATE TABLE IF NOT EXISTS ${tableName('runtime_gateway_reader_fences', options)} (
-      scheduler_schema text PRIMARY KEY,
-      epoch bigint NOT NULL CHECK (epoch > 0),
-      mode text NOT NULL CHECK (mode IN ('legacy_byte_reader', 'canonical_v1')),
-      canonical_reader_proof jsonb,
-      updated_at timestamptz NOT NULL DEFAULT now(),
-      CHECK (
-        (mode = 'legacy_byte_reader' AND canonical_reader_proof IS NULL)
-        OR (mode = 'canonical_v1' AND canonical_reader_proof IS NOT NULL)
-      )
-    )
-  `);
+    await ensurePostgresSchedulerGatewayReaderFenceSchema(client, options);
     await client.query(`
     CREATE INDEX IF NOT EXISTS ${quoteIdent(
       `${schema}_integration_invocation_state_updated_idx`,

package/dist/cli/index.js

@@ -3512,7 +3512,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.263",
+  version: "0.3.264",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1
@@ -38592,6 +38592,7 @@ async function buildPlanArgs(args) {
     "--with-force",
     "--timeout",
     "--profile",
+    "--run-id-file",
     "--max-credits-per-run"
   ]);
   const localBooleanOptions = /* @__PURE__ */ new Set([
@@ -39024,41 +39025,34 @@ async function stopGeneratedEnrichRunAfterWatchError(client2, error) {
   }).catch(() => void 0);
 }
 async function runGeneratedEnrichPlay(client2, runArgs, options = {}) {
-  for (let attempt = 0; attempt < 2; attempt += 1) {
+  const maxAttempts = runArgs.includes("--run-id-file") ? 1 : 2;
+  for (let attempt = 0; attempt < maxAttempts; attempt += 1) {
     try {
-      let terminalStatus2 = null;
-      const captured2 = await captureStdout(
+      let terminalStatus = null;
+      const captured = await captureStdout(
         () => handlePlayRun(runArgs, {
           onRunStarted: options.onRunStarted,
           onTerminalStatus: (status) => {
-            terminalStatus2 = status;
+            terminalStatus = status;
           }
         }),
         {
           passthrough: options.passthroughStdout
         }
       );
-      return { ...captured2, terminalStatus: terminalStatus2 };
+      return { ...captured, terminalStatus };
     } catch (error) {
       await stopGeneratedEnrichRunAfterWatchError(client2, error);
-      if (attempt === 0 && isPlayStartStreamEndedError(error)) {
+      if (attempt + 1 < maxAttempts && isPlayStartStreamEndedError(error)) {
         await sleep7(250);
         continue;
       }
       throw error;
     }
   }
-  let terminalStatus = null;
-  const captured = await captureStdout(
-    () => handlePlayRun(runArgs, {
-      onRunStarted: options.onRunStarted,
-      onTerminalStatus: (status) => {
-        terminalStatus = status;
-      }
-    }),
-    { passthrough: options.passthroughStdout }
+  throw new Error(
+    "Generated enrich invocation exhausted its allowed attempts."
   );
-  return { ...captured, terminalStatus };
 }
 function writeEnrichInterruptionHint(input2) {
   const output2 = input2.outputPath ? ` --out ${input2.outputPath}` : "";
@@ -41602,7 +41596,10 @@ function registerEnrichCommand(program) {
     optionTerm(option) {
       return option.long === "--timeout" ? "--timeout SECONDS" : option.flags;
     }
-  }).option("--input <path>", "Input CSV path.").option("--csv <path>", "Alias for --input.").option("--output <path>", "Output CSV path.").option("--config <path>", "JSON enrich config.").requiredOption(
+  }).option("--input <path>", "Input CSV path.").option("--csv <path>", "Alias for --input.").option("--output <path>", "Output CSV path.").option(
+    "--run-id-file <path>",
+    "Persist the allocated and confirmed run identity for cancellation and recovery."
+  ).option("--config <path>", "JSON enrich config.").requiredOption(
     "--name <name>",
     "Name for the compiled enrich play. Reuse a name to keep iterating on the same play; use a new name for a distinct enrichment so runs stay separate in the run ledger and share URLs."
   ).option(
@@ -41815,6 +41812,9 @@ function registerEnrichCommand(program) {
           JSON.stringify(runtimeInput),
           "--watch"
         ];
+        if (options.runIdFile) {
+          runArgs.push("--run-id-file", options.runIdFile);
+        }
         if (options.profile) {
           runArgs.push("--profile", options.profile);
         }

package/dist/cli/index.mjs

@@ -3507,7 +3507,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.263",
+  version: "0.3.264",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1
@@ -38665,6 +38665,7 @@ async function buildPlanArgs(args) {
     "--with-force",
     "--timeout",
     "--profile",
+    "--run-id-file",
     "--max-credits-per-run"
   ]);
   const localBooleanOptions = /* @__PURE__ */ new Set([
@@ -39097,41 +39098,34 @@ async function stopGeneratedEnrichRunAfterWatchError(client2, error) {
   }).catch(() => void 0);
 }
 async function runGeneratedEnrichPlay(client2, runArgs, options = {}) {
-  for (let attempt = 0; attempt < 2; attempt += 1) {
+  const maxAttempts = runArgs.includes("--run-id-file") ? 1 : 2;
+  for (let attempt = 0; attempt < maxAttempts; attempt += 1) {
     try {
-      let terminalStatus2 = null;
-      const captured2 = await captureStdout(
+      let terminalStatus = null;
+      const captured = await captureStdout(
         () => handlePlayRun(runArgs, {
           onRunStarted: options.onRunStarted,
           onTerminalStatus: (status) => {
-            terminalStatus2 = status;
+            terminalStatus = status;
           }
         }),
         {
           passthrough: options.passthroughStdout
         }
       );
-      return { ...captured2, terminalStatus: terminalStatus2 };
+      return { ...captured, terminalStatus };
     } catch (error) {
       await stopGeneratedEnrichRunAfterWatchError(client2, error);
-      if (attempt === 0 && isPlayStartStreamEndedError(error)) {
+      if (attempt + 1 < maxAttempts && isPlayStartStreamEndedError(error)) {
         await sleep7(250);
         continue;
       }
       throw error;
     }
   }
-  let terminalStatus = null;
-  const captured = await captureStdout(
-    () => handlePlayRun(runArgs, {
-      onRunStarted: options.onRunStarted,
-      onTerminalStatus: (status) => {
-        terminalStatus = status;
-      }
-    }),
-    { passthrough: options.passthroughStdout }
+  throw new Error(
+    "Generated enrich invocation exhausted its allowed attempts."
   );
-  return { ...captured, terminalStatus };
 }
 function writeEnrichInterruptionHint(input2) {
   const output2 = input2.outputPath ? ` --out ${input2.outputPath}` : "";
@@ -41675,7 +41669,10 @@ function registerEnrichCommand(program) {
     optionTerm(option) {
       return option.long === "--timeout" ? "--timeout SECONDS" : option.flags;
     }
-  }).option("--input <path>", "Input CSV path.").option("--csv <path>", "Alias for --input.").option("--output <path>", "Output CSV path.").option("--config <path>", "JSON enrich config.").requiredOption(
+  }).option("--input <path>", "Input CSV path.").option("--csv <path>", "Alias for --input.").option("--output <path>", "Output CSV path.").option(
+    "--run-id-file <path>",
+    "Persist the allocated and confirmed run identity for cancellation and recovery."
+  ).option("--config <path>", "JSON enrich config.").requiredOption(
     "--name <name>",
     "Name for the compiled enrich play. Reuse a name to keep iterating on the same play; use a new name for a distinct enrichment so runs stay separate in the run ledger and share URLs."
   ).option(
@@ -41888,6 +41885,9 @@ function registerEnrichCommand(program) {
           JSON.stringify(runtimeInput),
           "--watch"
         ];
+        if (options.runIdFile) {
+          runArgs.push("--run-id-file", options.runIdFile);
+        }
         if (options.profile) {
           runArgs.push("--profile", options.profile);
         }

package/dist/index.js

@@ -1325,7 +1325,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.263",
+  version: "0.3.264",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1

package/dist/index.mjs

@@ -1229,7 +1229,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.263",
+  version: "0.3.264",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1

package/dist/release.d.mts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.263";
+    readonly version: "0.3.264";
     readonly updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.";
     readonly packageCapabilities: {
         readonly updatePreferences: 1;

package/dist/release.d.ts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.263";
+    readonly version: "0.3.264";
     readonly updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.";
     readonly packageCapabilities: {
         readonly updatePreferences: 1;

package/dist/release.js

@@ -74,7 +74,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.263",
+  version: "0.3.264",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1

package/dist/release.mjs

@@ -48,7 +48,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.263",
+  version: "0.3.264",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.3.263",
+  "version": "0.3.264",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",