@databricks-solutions/lakebase-scm-utils 0.3.2 → 0.3.4

package/dist/scripts/index.cjs

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

package/dist/scripts/index.js

@@ -9725,8 +9725,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     return cached;
   }
   cached = "unknown";

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

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

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

@@ -484,8 +484,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     return cached;
   }
   cached = "unknown";

package/dist/scripts/lakebase/index.cjs

@@ -81604,8 +81604,8 @@ var PKG_NAME = "@databricks-solutions/lakebase-scm-utils";
 var cached;
 function substrateSelfVersion() {
   if (cached !== void 0) return cached;
-  if ("0.3.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     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.2".length > 0) {
-    cached = "0.3.2";
+  if ("0.3.4".length > 0) {
+    cached = "0.3.4";
     return cached;
   }
   cached = "unknown";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@databricks-solutions/lakebase-scm-utils",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "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/client/consort-vitest-reporter.ts

@@ -0,0 +1,96 @@
+// Consort per-test "green as it runs" reporter for Vitest (client component/hook tests).
+//
+// Mirrors the Playwright reporter: a test whose name carries `@T<id>` streams its lifecycle to
+// `.consort/test-run.jsonl` so the Consort dashboard lights that bubble. Reuses the single
+// `emitTestRun` writer from the shared Playwright reporter one directory up (`../consort-test-reporter`)
+// — one writer, one JSONL shape, one `.consort` resolver.
+//
+// Recent Vitest (the "Reported Tasks" reporter API, v2.1+) fires per-test hooks, so we stream
+// `running` the moment a test starts and the final status when it ends. OLDER Vitest does not fire
+// those hooks — so `onFinished` is a BATCH BACKSTOP that emits any test the per-test hooks did not
+// already handle (tracked in `handled`), giving a correct end-of-run signal on any version. Typed
+// structurally (not against vitest's own types) so a vitest major bump can't break the build;
+// everything is wrapped so a reporter error can never fail the suite.
+import { emitTestRun, type TestRunStatus } from "../consort-capture";
+
+const TEST_ID = /@(T\d+(?:-[a-z0-9-]+)?)/;
+
+// NOTE: per-test TABLE-STATE capture does NOT live here — it is in `tests/setup.ts`'s afterEach,
+// which runs in the WORKER process where the booted backend's base URL (`.consort/.vitest-backend`)
+// actually resolves. This reporter runs in the MAIN process, where that base did not resolve, so a
+// capture here silently no-op'd. This reporter is purely the per-test STATUS stream (test-run.jsonl).
+
+function idOf(name: string | undefined): string | undefined {
+  return TEST_ID.exec(name ?? "")?.[1];
+}
+
+function stateToStatus(state: string | undefined): TestRunStatus {
+  return state === "pass" || state === "passed" ? "green" : state === "skip" || state === "skipped" ? "skipped" : "red";
+}
+
+// --- Modern "Reported Tasks" shapes (duck-typed) ---------------------------------------------
+interface ReportedTestCase {
+  name?: string;
+  module?: { moduleId?: string; id?: string };
+  result?: (() => { state?: string } | undefined) | { state?: string };
+}
+
+function moduleIdOf(tc: ReportedTestCase): string {
+  return tc.module?.moduleId ?? tc.module?.id ?? "";
+}
+
+function resultStateOf(tc: ReportedTestCase): string | undefined {
+  const r = typeof tc.result === "function" ? tc.result() : tc.result;
+  return r?.state;
+}
+
+// --- Legacy onFinished task tree (duck-typed) ------------------------------------------------
+interface VitestTaskLike {
+  type?: string;
+  name?: string;
+  mode?: string;
+  result?: { state?: string };
+  tasks?: VitestTaskLike[];
+  filepath?: string;
+}
+
+export default class ConsortVitestReporter {
+  // Keys (`file\0name`) already emitted by the per-test hooks, so the onFinished backstop skips
+  // them on recent Vitest and only fires for versions where the per-test hooks never ran.
+  private handled = new Set<string>();
+
+  onTestCaseReady(testCase: ReportedTestCase): void {
+    const id = idOf(testCase.name);
+    if (id) emitTestRun(id, "running", moduleIdOf(testCase), "client");
+  }
+
+  onTestCaseResult(testCase: ReportedTestCase): void {
+    const id = idOf(testCase.name);
+    if (!id) return;
+    const file = moduleIdOf(testCase);
+    this.handled.add(`${file}\u0000${testCase.name ?? ""}`);
+    emitTestRun(id, stateToStatus(resultStateOf(testCase)), file, "client");
+  }
+
+  onFinished(files: VitestTaskLike[] = []): void {
+    try {
+      for (const f of files) this.walk(f, f.filepath ?? "");
+    } catch {
+      /* best-effort: a per-test reporter write must never fail the suite */
+    }
+  }
+
+  private walk(task: VitestTaskLike, file: string): void {
+    const isLeaf = task.type === "test" || task.type === "custom" || (!task.tasks && !!task.result);
+    if (isLeaf) {
+      const id = idOf(task.name);
+      if (!id) return;
+      if (this.handled.has(`${file}\u0000${task.name ?? ""}`)) return; // already streamed by the per-test hooks
+      const st = task.result?.state;
+      const status: TestRunStatus = st === "pass" ? "green" : st === "skip" || task.mode === "skip" ? "skipped" : "red";
+      emitTestRun(id, status, file, "client");
+      return;
+    }
+    for (const child of task.tasks ?? []) this.walk(child, file);
+  }
+}

package/templates/project/client/package.json

@@ -23,6 +23,7 @@
     "@testing-library/jest-dom": "^6.4.8",
     "@testing-library/react": "^16.0.0",
     "@testing-library/user-event": "^14.5.2",
+    "@types/node": "^20.14.0",
     "@types/react": "^18.3.3",
     "@types/react-dom": "^18.3.0",
     "@vitejs/plugin-react": "^4.3.1",

package/templates/project/client/playwright.config.ts

@@ -25,6 +25,7 @@ const ROOT = join(process.cwd(), "..");
 function resolvePort(envVar: string, fallback: number): string {
   const fromEnv = process.env[envVar];
   if (fromEnv) return fromEnv;
+  let resolved = String(fallback);
   const portUtils = join(ROOT, "scripts", "port-utils.sh");
   if (existsSync(portUtils)) {
     try {
@@ -33,12 +34,21 @@ function resolvePort(envVar: string, fallback: number): string {
         ["-c", `source ${JSON.stringify(portUtils)} && free_port ${fallback}`],
         { encoding: "utf8" }
       ).trim();
-      if (/^\d+$/.test(out)) return out;
+      if (/^\d+$/.test(out)) resolved = out;
     } catch {
       // fall through to the conventional default
     }
   }
-  return String(fallback);
+  // PERSIST the chosen port into the environment so Playwright's WORKER processes reuse it.
+  // Playwright evaluates this config in the main process AND re-evaluates it in each test
+  // worker. Without this, a worker re-runs resolvePort with E2E_CLIENT_PORT still unset, finds
+  // the port the main process picked (e.g. 5173) now TAKEN by the Vite webServer, allocates a
+  // DIFFERENT free port (5174), and points `baseURL` at 5174 where nothing listens — so the
+  // browser specs fail "not reachable" even though the app is healthy on the real port. Workers
+  // are spawned AFTER the main-process config load and inherit its process.env, so recording the
+  // resolution here makes every worker read it back via `fromEnv` above: resolve once, share it.
+  process.env[envVar] = resolved;
+  return resolved;
 }
 const BACKEND_PORT = resolvePort("E2E_BACKEND_PORT", 8000);
 const CLIENT_PORT = resolvePort("E2E_CLIENT_PORT", 5173);
@@ -91,7 +101,12 @@ export default defineConfig({
   workers: 1,
   forbidOnly: !!process.env.CI,
   retries: process.env.CI ? 2 : 0,
-  reporter: process.env.CI ? [["list"], ["html", { open: "never" }]] : "list",
+  // `../consort-test-reporter.ts` (shared with the root config) appends each `@T<id>`-tagged test
+  // to `.consort/test-run.jsonl` as it finishes, for the dashboard's per-test live signal. It walks
+  // up from cwd to the project `.consort`, so running from client/ still finds the right ledger.
+  reporter: process.env.CI
+    ? [["list"], ["html", { open: "never" }], ["../consort-test-reporter.ts"]]
+    : [["list"], ["../consort-test-reporter.ts"]],
   use: {
     baseURL: CLIENT_URL,
     trace: "on-first-retry",

package/templates/project/client/tests/e2e/about.spec.ts

@@ -1,4 +1,4 @@
-import { test, expect } from "@playwright/test";
+import { test, expect } from "./consort-fixtures";
 
 // The reachability pattern proven end-to-end: a feature page is reachable by
 // NAVIGATING the real app (a navbar link / a route), not just by mounting the

package/templates/project/client/tests/e2e/consort-fixtures.ts

@@ -0,0 +1,23 @@
+// Consort e2e test fixture: tag every spec's browser requests with the X-Consort-Test-Id header,
+// derived from the test title's @T<id>. The backend's per-test capture (app/consort_capture.py) uses
+// it to attribute the rows this spec RETRIEVES/STORES — the same per-test key the Vitest fetch shim
+// and the pytest client fixture set, so the dashboard's per-test table view works for e2e specs too.
+//
+// Import { test, expect } from THIS module in e2e specs instead of "@playwright/test" — nothing else
+// changes. (The header rides through Vite's /api proxy to the backend; it's inert in production.)
+import { test as base } from "@playwright/test";
+
+// Re-export EVERYTHING from @playwright/test (expect, devices, types like APIRequestContext, …) so a
+// spec imports solely from here; the local `test` below overrides the re-exported one (an explicit
+// export shadows a star re-export of the same name).
+export * from "@playwright/test";
+
+const TEST_ID = /@(T\d+(?:-[a-z0-9-]+)?)/;
+
+export const test = base.extend({
+  page: async ({ page }, use, testInfo) => {
+    const id = TEST_ID.exec(testInfo.title)?.[1];
+    if (id) await page.setExtraHTTPHeaders({ "X-Consort-Test-Id": id });
+    await use(page);
+  },
+});

package/templates/project/client/tests/e2e/home.spec.ts

@@ -1,4 +1,4 @@
-import { test, expect } from "@playwright/test";
+import { test, expect } from "./consort-fixtures";
 
 // The one behavior a fresh scaffold can prove end-to-end: the SPA loads, calls
 // the backend /health through the Vite proxy, and shows the result as an