@databricks-solutions/lakebase-scm-utils 0.3.7 → 0.3.9

package/dist/scripts/index.cjs

@@ -88959,8 +88959,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/index.js

@@ -9737,8 +9737,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/ci-resolve-branch.cli.cjs

@@ -79629,8 +79629,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/ci-resolve-branch.cli.js

@@ -721,8 +721,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/collapse-heads.cli.cjs

@@ -79290,8 +79290,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/collapse-heads.cli.js

@@ -393,8 +393,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/detect-language.cli.cjs

@@ -79290,8 +79290,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/detect-language.cli.js

@@ -393,8 +393,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/doctor.cli.cjs

@@ -80800,8 +80800,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/doctor.cli.js

@@ -1959,8 +1959,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/get-connection.cli.cjs

@@ -79285,8 +79285,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/get-connection.cli.js

@@ -389,8 +389,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/index.cjs

@@ -81607,8 +81607,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/index.js

@@ -2521,8 +2521,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/infra-runner.cli.cjs

@@ -79290,8 +79290,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/infra-runner.cli.js

@@ -393,8 +393,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/new-migration.cli.cjs

@@ -79290,8 +79290,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/new-migration.cli.js

@@ -393,8 +393,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/schema-diff.cli.cjs

@@ -79288,8 +79288,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/schema-diff.cli.js

@@ -389,8 +389,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/schema-migrate.cli.cjs

@@ -79324,8 +79324,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/schema-migrate.cli.js

@@ -427,8 +427,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/scm-claim-feature.cli.cjs

@@ -79783,8 +79783,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/scm-claim-feature.cli.js

@@ -864,8 +864,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/scm-doctor.cli.cjs

@@ -88240,8 +88240,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/scm-doctor.cli.js

@@ -9393,8 +9393,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/scm-merge.cli.cjs

@@ -88825,8 +88825,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/scm-merge.cli.js

@@ -9978,8 +9978,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/scm-reconcile-tier.cli.cjs

@@ -79288,8 +79288,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/scm-reconcile-tier.cli.js

@@ -389,8 +389,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/util/index.cjs

@@ -1667,8 +1667,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/util/index.js

@@ -1630,8 +1630,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.7".length > 0) {
-    cached = "0.3.7";
+  if ("0.3.9".length > 0) {
+    cached = "0.3.9";
     return cached;
   }
   cached = "unknown";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@databricks-solutions/lakebase-scm-utils",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "description": "Lakebase SCM + substrate engine: database branching, paired-branch SCM workflows, connection/credential minting, schema migration, project scaffold + deploy primitives, and the git/github utility layer. Extracted from consort for portable, standalone consumption by lakebase-scm-extension and the SFTDD orchestration.",
   "type": "module",
   "private": false,

package/templates/project/common/consort-capture.ts

@@ -9,8 +9,8 @@
 // the client's bundler-resolution tsconfig. Importing these from here keeps the client Playwright-free.
 //
 // Pure observability: everything is wrapped so a write can NEVER fail a test/suite.
-import { appendFileSync, existsSync, mkdirSync } from "node:fs";
-import { dirname, join } from "node:path";
+import { appendFileSync, existsSync, mkdirSync, readdirSync, readFileSync } from "node:fs";
+import { basename, dirname, join } from "node:path";
 
 /** Walk up from `start` to the project's `.consort` dir (tests run from root OR client/, so cwd
  *  varies); fall back to `<cwd>/.consort` (created on write) if none is found. */
@@ -33,15 +33,133 @@ export function emitTestRun(id: string, status: TestRunStatus, absFile: string,
     mkdirSync(dir, { recursive: true });
     const root = dirname(dir);
     const file = (absFile || "").replace(`${root}/`, "");
+    const ts = new Date().toISOString();
     appendFileSync(
       join(dir, "test-run.jsonl"),
-      JSON.stringify({ ts: new Date().toISOString(), test_id: id, status, file, kind }) + "\n",
+      JSON.stringify({ ts, test_id: id, status, file, kind }) + "\n",
     );
+    // RECORD a durable per-test `test.result` into the agent-log AT RUN TIME (not a cycle-end batch),
+    // so the dashboard lights each bubble the moment its test runs (live), scrubbing lights each test
+    // AT the point it actually ran (the event sits at its real position in the stream), and a REPLAY of
+    // the recording does the same — the per-test trail is part of the durable record, not a live-only
+    // overlay. Attributed to its story via the on-disk test-lists (the agent-log fold keys by
+    // feature|story|test). Best-effort: a reporter write must never fail the suite.
+    recordTestResultEvent(dir, id, status, file, ts);
   } catch {
     /* best-effort: a per-test reporter write must never fail the suite */
   }
 }
 
+/** Owner of a test id, resolved from the project's per-story test-lists (the attribution the reporter
+ *  lacks — it only sees id + file). Cached per process (a reporter process is one suite run). */
+interface TestOwner { feature_id: string; story_id: string; ac_id: string; scenario_file?: string }
+const ownerIndexCache = new Map<string, Map<string, TestOwner[]>>();
+
+function buildOwnerIndex(consortDir: string): Map<string, TestOwner[]> {
+  const cached = ownerIndexCache.get(consortDir);
+  if (cached) return cached;
+  const index = new Map<string, TestOwner[]>();
+  try {
+    const featuresDir = join(consortDir, "features");
+    for (const f of readdirSync(featuresDir)) {
+      const storiesDir = join(featuresDir, f, "stories");
+      let stories: string[];
+      try { stories = readdirSync(storiesDir); } catch { continue; }
+      for (const s of stories) {
+        const listFile = join(storiesDir, s, "test-list-per-story.json");
+        if (!existsSync(listFile)) continue;
+        let list: { feature_id?: string; story_id?: string; items?: unknown[] };
+        try { list = JSON.parse(readFileSync(listFile, "utf8")); } catch { continue; }
+        const featureId = typeof list.feature_id === "string" ? list.feature_id : f;
+        const storyId = typeof list.story_id === "string" ? list.story_id : s;
+        for (const raw of list.items ?? []) {
+          const it = raw as { id?: unknown; ac_id?: unknown; scenario_file?: unknown };
+          if (typeof it.id !== "string") continue;
+          const owners = index.get(it.id) ?? [];
+          owners.push({
+            feature_id: featureId,
+            story_id: storyId,
+            ac_id: typeof it.ac_id === "string" ? it.ac_id : "unknown",
+            ...(typeof it.scenario_file === "string" ? { scenario_file: it.scenario_file } : {}),
+          });
+          index.set(it.id, owners);
+        }
+      }
+    }
+  } catch {
+    /* no test-lists (pre-design project) — leave the index empty; the kit's cycle-scoped emit covers it */
+  }
+  ownerIndexCache.set(consortDir, index);
+  return index;
+}
+
+/** The feature currently on the build lane, from `.consort/next.json` — the disambiguator of last
+ *  resort when a reused T-id's file does not pin a single owner (e.g. a fitness/behavior test whose
+ *  test-list item carries no scenario_file). Null when unreadable. */
+function activeFeature(consortDir: string): string | null {
+  try {
+    const next = JSON.parse(readFileSync(join(consortDir, "next.json"), "utf8")) as { feature?: unknown };
+    return typeof next.feature === "string" ? next.feature : null;
+  } catch {
+    return null;
+  }
+}
+
+/** Resolve a (test id, file) to its single owning story. One owner -> it. Several (a T-id reused across
+ *  features — ids are unique only WITHIN a story) -> (1) the owner whose scenario_file basename matches
+ *  the running file (a client/e2e spec pins ITSELF, so a sibling feature's same-id spec resolves to its
+ *  own story); then (2) the owner in the feature currently on the build lane (next.json) — a
+ *  fitness/behavior test carries no scenario_file, so during THIS feature's build its reused id belongs
+ *  to the active feature's story, while another feature's same-id test already resolved via (1). Else
+ *  null (skip, never mis-attribute). */
+function resolveOwner(consortDir: string, id: string, file: string): TestOwner | null {
+  const base = /^(T\d+)/.exec(id)?.[1] ?? id;
+  const index = buildOwnerIndex(consortDir);
+  const owners = index.get(id) ?? index.get(base) ?? [];
+  if (owners.length === 0) return null;
+  if (owners.length === 1) return owners[0];
+  // (1) The owner whose scenario_file matches the running file (unique match).
+  const fileBase = basename(file || "");
+  if (fileBase) {
+    const byFile = owners.filter((o) => o.scenario_file && basename(o.scenario_file) === fileBase);
+    if (byFile.length === 1) return byFile[0];
+  }
+  // (2) Fall back to the owner in the currently-building feature (one match only).
+  const active = activeFeature(consortDir);
+  if (active) {
+    const byFeature = owners.filter((o) => o.feature_id === active);
+    if (byFeature.length === 1) return byFeature[0];
+  }
+  return null;
+}
+
+/** Append a durable, schema-valid `test.result` to the agent-log (+ the corpus mirror when a recording
+ *  is in flight), shaped exactly like the kit's emitAgentLogEvent output so the dashboard fold reads it
+ *  identically. Only emitted for an attributable test; best-effort. */
+export function recordTestResultEvent(consortDir: string, id: string, status: TestRunStatus, file: string, ts: string): void {
+  try {
+    const owner = resolveOwner(consortDir, id, file);
+    if (!owner) return; // cannot attribute (ambiguous reused id) — skip rather than mis-key a bubble
+    const line =
+      JSON.stringify({
+        timestamp: ts,
+        level: "info",
+        role: "driver",
+        event: "test.result",
+        message: `TEST ${id} ${status}`,
+        metadata: { feature_id: owner.feature_id, test_id: id, status, story_id: owner.story_id, ac_id: owner.ac_id },
+      }) + "\n";
+    appendFileSync(join(consortDir, "agent-log.jsonl"), line);
+    // Mirror into the corpus so a RECORDED run replays the per-test trail (same env the kit uses).
+    const recordDir = process.env.LAKEBASE_CONSORT_RECORD_DIR?.trim();
+    if (recordDir) {
+      try { mkdirSync(recordDir, { recursive: true }); appendFileSync(join(recordDir, "agent-log.jsonl"), line); } catch { /* mirror is best-effort */ }
+    }
+  } catch {
+    /* best-effort: recording a per-test result must never fail the suite */
+  }
+}
+
 /** Append a per-test TABLE snapshot (one line per table) to `.consort/table-snapshots.jsonl`, keyed
  *  by test id — parallel to `emitTestRun`. Best-effort. */
 export function emitTableSnapshot(id: string, absFile: string, table: string, rows: unknown[], rowCount: number | null): void {

package/templates/project/common/tests/e2e/conftest.py

@@ -25,6 +25,7 @@ import os
 import subprocess
 import tempfile
 import time
+import urllib.error
 import urllib.request
 
 import pytest
@@ -41,7 +42,10 @@ def _is_up(url: str) -> bool:
             return resp.status < 500
     except urllib.error.HTTPError as exc:  # noqa: PERF203 - a 4xx still means it's up
         return exc.code < 500
-    except Exception:
+    except (urllib.error.URLError, OSError):
+        # NOT a broad-integrity swallow: a readiness poll returns False on the server
+        # not-yet-listening (connection refused / DNS / socket timeout — all URLError/OSError),
+        # never masks a DB-integrity violation. Narrow so the smell gate does not false-positive.
         return False
 
 

package/templates/project/python/tests/conftest.py

@@ -34,7 +34,7 @@ def db_session():
 
 
 @pytest.fixture(autouse=True)
-def _restore_migration_head_after_each_test():
+def _restore_migration_head_after_each_test(request):
     """Within-run test isolation for migration up/down fixtures.
 
     Some tests drive Alembic up/down against the shared verify database (a
@@ -42,10 +42,18 @@ def _restore_migration_head_after_each_test():
     `upgrade head`). Run sequentially against ONE database, those fixtures can
     leave it half-migrated , or, if a downgrade overshoots, below a table a later
     test needs , so the next test fails with `relation ... does not exist`. This
-    autouse teardown brings the DB back to `head` after EVERY test, so each test
-    starts from the fully-migrated schema regardless of what the previous one did.
-    """
+    teardown brings the DB back to `head` after a schema-mutating test.
+
+    SCOPED to ``@pytest.mark.migration`` tests only (perf): ONLY a migration test
+    downgrades/alters the schema , and the ``migration-marker-presence`` smell
+    GUARANTEES every schema-mutating test carries that marker , so a NON-migration
+    test cannot have changed the schema and needs no restore. Restoring after every
+    test ran a full alembic env-load + DB round-trip (~1-2s) after each of the many
+    non-migration tests to 'restore' a schema they never touched , the dominant cost
+    of the non-migration pass. Skipping it there is safe by construction."""
     yield
+    if request.node.get_closest_marker("migration") is None:
+        return  # a non-migration test cannot have altered the schema (marker smell enforces it)
     try:
         from pathlib import Path
 
@@ -95,11 +103,100 @@ def _consort_emit_test_run(test_id, status, item):
         rel = str(Path(str(item.fspath))).replace(f"{root}/", "")
         out = root / ".consort"
         out.mkdir(parents=True, exist_ok=True)
+        ts = datetime.now(timezone.utc).isoformat()
         line = json.dumps(
-            {"ts": datetime.now(timezone.utc).isoformat(), "test_id": test_id, "status": status, "file": rel, "kind": "behavior"}
+            {"ts": ts, "test_id": test_id, "status": status, "file": rel, "kind": "behavior"}
         )
         with open(out / "test-run.jsonl", "a", encoding="utf-8") as fh:
             fh.write(line + "\n")
+        # RECORD a durable per-test test.result into the agent-log AT RUN TIME (mirrors the TS reporter
+        # in consort-capture.ts) so the dashboard lights each behavior test the moment it runs, scrubbing
+        # lights it at its real run position, and a replay of the recording does the same.
+        _consort_record_test_result(out, test_id, status, rel, ts)
+    except (OSError, ValueError, TypeError):
+        pass
+
+
+def _consort_test_owner(consort_dir, test_id, file_rel):
+    """Resolve (feature_id, story_id, ac_id) for a test id from the per-story test-lists — the
+    attribution the reporter lacks (it sees only id + file). Ids are unique only WITHIN a story, so a
+    reused id has several owners: (1) the owner whose scenario_file basename matches ``file_rel`` (a
+    client/e2e spec pins ITSELF); then (2) the owner in the feature currently on the build lane
+    (``next.json``) — a fitness/behavior test carries no scenario_file, so during THIS feature's build
+    its reused id belongs to the active feature (a sibling feature's same-id test already resolved via
+    (1)). Else None (skip, never mis-key). Mirrors consort-capture.ts resolveOwner. Scoped, best-effort."""
+    try:
+        import glob
+        import json
+        import os
+        import re
+
+        m = re.match(r"^(T\d+)", test_id or "")
+        base = m.group(1) if m else test_id
+        owners = []  # (feature, story, ac, scenario_file)
+        for p in glob.glob(os.path.join(str(consort_dir), "features", "*", "stories", "*", "test-list-per-story.json")):
+            try:
+                with open(p, encoding="utf-8") as fh:
+                    o = json.load(fh)
+            except (OSError, ValueError):
+                continue
+            feat, story = o.get("feature_id"), o.get("story_id")
+            for it in o.get("items", []):
+                if it.get("id") in (test_id, base):
+                    owners.append((feat, story, it.get("ac_id") or "unknown", it.get("scenario_file")))
+        if not owners:
+            return None
+        if len(owners) == 1:
+            return owners[0][:3]
+        # (1) the owner whose scenario_file matches the running file (unique match)
+        fb = os.path.basename(file_rel or "")
+        by_file = [o for o in owners if o[3] and os.path.basename(o[3]) == fb]
+        if len(by_file) == 1:
+            return by_file[0][:3]
+        # (2) fall back to the owner in the currently-building feature (one match only)
+        try:
+            with open(os.path.join(str(consort_dir), "next.json"), encoding="utf-8") as fh:
+                active = json.load(fh).get("feature")
+        except (OSError, ValueError):
+            active = None
+        if active:
+            by_feat = [o for o in owners if o[0] == active]
+            if len(by_feat) == 1:
+                return by_feat[0][:3]
+        return None
+    except (OSError, ValueError, TypeError):
+        return None
+
+
+def _consort_record_test_result(out, test_id, status, file_rel, ts):
+    """Append a schema-shaped ``test.result`` to ``.consort/agent-log.jsonl`` (+ the corpus mirror when
+    a recording is in flight), identical in shape to the kit's emitAgentLogEvent output so the dashboard
+    fold reads it the same. Only for an attributable test; scoped except, never breaks the suite."""
+    try:
+        import json
+        import os
+
+        owner = _consort_test_owner(out, test_id, file_rel)
+        if not owner:
+            return
+        feat, story, ac = owner
+        line = json.dumps(
+            {
+                "timestamp": ts,
+                "level": "info",
+                "role": "driver",
+                "event": "test.result",
+                "message": f"TEST {test_id} {status}",
+                "metadata": {"feature_id": feat, "test_id": test_id, "status": status, "story_id": story, "ac_id": ac},
+            }
+        )
+        with open(os.path.join(str(out), "agent-log.jsonl"), "a", encoding="utf-8") as fh:
+            fh.write(line + "\n")
+        rec = (os.environ.get("LAKEBASE_CONSORT_RECORD_DIR") or "").strip()
+        if rec:
+            os.makedirs(rec, exist_ok=True)
+            with open(os.path.join(rec, "agent-log.jsonl"), "a", encoding="utf-8") as fh:
+                fh.write(line + "\n")
     except (OSError, ValueError, TypeError):
         pass
 
@@ -162,6 +259,32 @@ def _consort_capture_tables(test_id, item):
         pass
 
 
+def pytest_collection_modifyitems(config, items):
+    """Build-lane SCOPE (per-cycle waste elimination): when ``SFTDD_TEST_IDS`` is set (a space/comma
+    list of test ids), run ONLY the tests whose ``@pytest.mark.testid`` is in that set and DESELECT the
+    rest. The build's per-cycle GREEN verify sets it to the CURRENT STORY's ids, so a cycle re-runs
+    only its own story instead of every feature's suite (intra-story regressions still caught); the
+    story-close REFACTOR + feature-deploy gates leave it UNSET and run the FULL cross-story suite (that
+    is where a cross-story regression is caught, before merge). UNTAGGED items (no testid — shared
+    fixtures / infra) are always KEPT, never deselected. Unset/empty => no-op (full collection)."""
+    import os
+    import re
+
+    raw = (os.environ.get("SFTDD_TEST_IDS") or "").strip()
+    if not raw:
+        return
+    wanted = {t for t in re.split(r"[,\s]+", raw) if t}
+    if not wanted:
+        return
+    selected, deselected = [], []
+    for item in items:
+        tid = _consort_testid(item)
+        (selected if (tid is None or tid in wanted) else deselected).append(item)
+    if deselected:
+        config.hook.pytest_deselected(items=deselected)
+        items[:] = selected
+
+
 def pytest_runtest_setup(item):
     """Emit ``running`` the moment a tagged test starts, so the dashboard shows it in-flight."""
     test_id = _consort_testid(item)