deepline 0.3.315 → 0.3.316

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.315',
+  version: '0.3.316',
   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/sdk/src/runs/overview.ts

@@ -209,7 +209,11 @@ function stepExecution(
 
 /** A read-only overview of recorded run facts, never a complete row export. */
 export function buildRunOverview(status: PlayStatus, fullStatus?: PlayStatus) {
-  const pkg = status.package;
+  // Full inspection can observe a later lifecycle transition than the compact
+  // read. Present its package and status together; older full servers without
+  // a package retain the existing compact inspection path.
+  const inspectedStatus = fullStatus?.package ? fullStatus : status;
+  const pkg = inspectedStatus.package;
   if (!pkg) {
     throw new Error(
       'This server did not return a run package; use runs get --full --json.',
@@ -218,7 +222,10 @@ export function buildRunOverview(status: PlayStatus, fullStatus?: PlayStatus) {
   const outputs = Object.entries(pkg.outputs);
   const resultPackage = fullStatus?.package?.resultState
     ? fullStatus.package
-    : pkg;
+    : (status.package ?? pkg);
+  // The CLI requests this log window with its compact read; full inspection
+  // may omit that independent query option.
+  const failedLogs = inspectedStatus.failedLogs ?? status.failedLogs;
   const warnings = [...(pkg.warnings ?? [])];
   const { outcome: _outcome, ...run } = pkg.run;
   const steps = pkg.steps.map((step) => {
@@ -373,13 +380,13 @@ export function buildRunOverview(status: PlayStatus, fullStatus?: PlayStatus) {
   return {
     schemaVersion: pkg.schemaVersion,
     kind: 'run_overview',
-    ...((status.runStatus ?? pkg.runStatus)
-      ? { runStatus: status.runStatus ?? pkg.runStatus }
+    ...((inspectedStatus.runStatus ?? pkg.runStatus)
+      ? { runStatus: inspectedStatus.runStatus ?? pkg.runStatus }
       : {}),
     run: {
       ...run,
-      ...(status.revisionId && !run.revisionId
-        ? { revisionId: status.revisionId }
+      ...(inspectedStatus.revisionId && !run.revisionId
+        ? { revisionId: inspectedStatus.revisionId }
         : {}),
     },
     steps,
@@ -406,23 +413,23 @@ export function buildRunOverview(status: PlayStatus, fullStatus?: PlayStatus) {
     },
     errorDetails: {
       coverage: 'unknown',
-      reported: record(pkg)?.errors ?? record(status)?.errors ?? [],
+      reported: record(pkg)?.errors ?? record(inspectedStatus)?.errors ?? [],
       ...(pkg.run.error ? { run: pkg.run.error } : {}),
       steps: steps
         .filter((step) => step.error)
         .map((step) => ({ stepId: step.id, message: step.error })),
       ...(pkg.next?.logs ? { getMore: 'actions.getLogsCmd' } : {}),
     },
-    rowOutcomes: status.rowOutcomes,
+    rowOutcomes: inspectedStatus.rowOutcomes ?? pkg.rowOutcomes,
     warnings,
-    ...(status.failedLogs ? { failedLogs: status.failedLogs } : {}),
+    ...(failedLogs ? { failedLogs } : {}),
     datasets,
     ...(Object.hasOwn(resultPackage, 'result')
       ? { result: resultPackage.result }
       : {}),
     resultState: resultPackage.resultState ?? 'unavailable',
     actions: {
-      ...lifecycleActions(status, pkg.run.id, pkg.run.status),
+      ...lifecycleActions(inspectedStatus, pkg.run.id, pkg.run.status),
       ...actions(pkg.next, {
         inspect: 'getRunCmd',
         full: 'getFullRunCmd',

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

@@ -793,11 +793,8 @@ export type PlayRunDatasetActions = {
 };
 
 /**
- * Compact canonical package for an inspected play run.
- *
- * This object is designed for SDK/CLI/API consumers that need stable run
- * metadata, output handles, and follow-up actions without reading dashboard
- * internals.
+ * Compact canonical run package for SDK/CLI consumers: stable metadata,
+ * output handles and follow-up actions without dashboard internals.
  */
 export interface PlayRunPackage {
   /** Package schema version. */
@@ -818,6 +815,8 @@ export interface PlayRunPackage {
   overview?: RunLifecycleStatus;
   /** Optional bounded live evidence from the existing run status projection. */
   runStatus?: RunGetStatus;
+  /** Terminal scalar row outcomes shared with full status and watch snapshots. */
+  rowOutcomes?: PlayStatus['rowOutcomes'];
   /** Run identity, status, timing, and dashboard metadata. */
   run: {
     id: string;
@@ -969,6 +968,8 @@ export interface PlayStatus {
     failedRows: number;
     totalRows: number;
     hasRowFailures: boolean;
+    /** Terminal rows omitted from this run's latest view because a newer write won. */
+    supersededRows?: number;
   };
   /** Compact typed run package returned by current run status endpoints. */
   package?: PlayRunPackage;