@toist/aja 0.6.1 → 0.8.0

package/src/runtime-db.ts

@@ -1,44 +1,25 @@
 // 2121
-// Platform-internal runtime ledger. Holds:
-//   - runs        — every pipeline execution (status, payload, result, steps, timing)
-//   - logs        — log lines emitted from kinds during a run, scoped to run_id
-//   - tasks       — HITL pending tasks (added in migration 002)
-//   - node_outputs — checkpoint-between-nodes memoization (added in migration 002)
-//
-// Schema is owned by the platform and evolved via numbered SQL migrations
-// in ../migrations/. See migrate.ts for the runner.
-//
-// Kinds never receive a handle to this DB — they only see ctx.db (data
-// store) and ctx.cache (capability), so they cannot accidentally touch
-// runtime tables.
-//
-// Migration policy: by default the runner applies pending migrations at
-// startup. RUNTIME_AUTO_MIGRATE=false flips to fail-loud — startup aborts if
-// anything is pending.
-//
-// Lifecycle: openRuntimeDb() is a pure factory. The runner lock is acquired
-// separately by db-handles.initDbs() before this is called, so two callers
-// cannot race on migrations.
-
 import { Database } from "bun:sqlite"
 import { mkdirSync } from "node:fs"
 import { dirname } from "node:path"
 import { runMigrations, pendingMigrations } from "./migrate.ts"
-import { runtimeDbPath } from "./config.ts"
 
-export function openRuntimeDb(): Database {
-  const path = runtimeDbPath()
+export function openRuntimeDb(path: string, opts: { skipMigrations?: boolean } = {}): Database {
   mkdirSync(dirname(path), { recursive: true })
 
-  if (process.env.RUNTIME_AUTO_MIGRATE === "false") {
+  if (opts.skipMigrations) {
+    const pending = pendingMigrations(path)
+    if (pending.length > 0) {
+      throw new Error(
+        `[runtime-db] ${pending.length} pending migration(s) with skipMigrations=true: ${pending.join(", ")}`,
+      )
+    }
+  } else if (process.env.RUNTIME_AUTO_MIGRATE === "false") {
     const pending = pendingMigrations(path)
     if (pending.length > 0) {
-      console.error(
-        `[runtime-db] ${pending.length} pending migration(s); RUNTIME_AUTO_MIGRATE=false.`,
+      throw new Error(
+        `[runtime-db] ${pending.length} pending migration(s); RUNTIME_AUTO_MIGRATE=false. Pending: ${pending.join(", ")}`,
       )
-      console.error(`[runtime-db] pending: ${pending.join(", ")}`)
-      console.error(`[runtime-db] run migrations explicitly, or unset RUNTIME_AUTO_MIGRATE.`)
-      process.exit(1)
     }
   } else {
     runMigrations(path)