@korajs/cli 0.1.0

package/dist/bin.js

@@ -0,0 +1,1640 @@
+#!/usr/bin/env node
+import {
+  createCommand,
+  createLogger,
+  findProjectRoot,
+  findSchemaFile,
+  promptConfirm,
+  resolveProjectBinary
+} from "./chunk-REOTYAM6.js";
+import {
+  generateTypes
+} from "./chunk-N36PFOSA.js";
+import {
+  DevServerError,
+  InvalidProjectError,
+  SchemaNotFoundError
+} from "./chunk-ZVB4HAB3.js";
+
+// src/bin.ts
+import { defineCommand as defineCommand4, runMain } from "citty";
+
+// src/commands/dev/dev-command.ts
+import { access as access2 } from "fs/promises";
+import { join as join2 } from "path";
+import { resolve } from "path";
+import { defineCommand } from "citty";
+
+// src/commands/dev/kora-config.ts
+import { spawn } from "child_process";
+import { access } from "fs/promises";
+import { extname, join } from "path";
+import { pathToFileURL } from "url";
+var CONFIG_CANDIDATES = [
+  "kora.config.ts",
+  "kora.config.mts",
+  "kora.config.cts",
+  "kora.config.js",
+  "kora.config.mjs",
+  "kora.config.cjs"
+];
+async function loadKoraConfig(projectRoot) {
+  const configPath = await findKoraConfigFile(projectRoot);
+  if (!configPath) return null;
+  const ext = extname(configPath);
+  if (ext === ".ts" || ext === ".mts" || ext === ".cts") {
+    const loaded2 = await loadTypeScriptConfig(configPath, projectRoot);
+    return toConfigObject(loaded2);
+  }
+  const loaded = await import(pathToFileURL(configPath).href);
+  return toConfigObject(loaded);
+}
+async function findKoraConfigFile(projectRoot) {
+  for (const file of CONFIG_CANDIDATES) {
+    const candidate = join(projectRoot, file);
+    try {
+      await access(candidate);
+      return candidate;
+    } catch {
+    }
+  }
+  return null;
+}
+async function loadTypeScriptConfig(configPath, projectRoot) {
+  const tsxBinary = await resolveProjectBinary(projectRoot, "tsx");
+  if (!tsxBinary) {
+    throw new Error(
+      `Found TypeScript config at ${configPath}, but "tsx" is not installed in this project. Install tsx or use kora.config.js.`
+    );
+  }
+  const script = [
+    "import { pathToFileURL } from 'node:url'",
+    "const configPath = process.argv[process.argv.length - 1]",
+    "const mod = await import(pathToFileURL(configPath).href)",
+    "const value = mod.default ?? mod",
+    "process.stdout.write(JSON.stringify(value))"
+  ].join(";");
+  const output = await runCommand(tsxBinary, ["--eval", script, configPath], projectRoot);
+  try {
+    return JSON.parse(output);
+  } catch {
+    throw new Error(`Failed to parse ${configPath} output as JSON.`);
+  }
+}
+async function runCommand(command, args, cwd) {
+  return await new Promise((resolve4, reject) => {
+    const child = spawn(command, args, {
+      cwd,
+      stdio: ["ignore", "pipe", "pipe"],
+      env: process.env
+    });
+    let stdout = "";
+    let stderr = "";
+    child.stdout?.on("data", (chunk) => {
+      stdout += chunk.toString("utf-8");
+    });
+    child.stderr?.on("data", (chunk) => {
+      stderr += chunk.toString("utf-8");
+    });
+    child.on("error", (error) => {
+      reject(error);
+    });
+    child.on("exit", (code) => {
+      if (code === 0) {
+        resolve4(stdout.trim());
+        return;
+      }
+      reject(new Error(`Failed to load kora config (exit ${code ?? "unknown"}): ${stderr.trim()}`));
+    });
+  });
+}
+function toConfigObject(mod) {
+  if (typeof mod !== "object" || mod === null) {
+    throw new Error("kora config must export an object.");
+  }
+  const value = mod.default ?? mod;
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    throw new Error("kora config must export an object.");
+  }
+  return value;
+}
+
+// src/commands/dev/process-manager.ts
+import { spawn as spawn2 } from "child_process";
+var ProcessManager = class {
+  processes = /* @__PURE__ */ new Map();
+  spawn(config) {
+    const options = {
+      cwd: config.cwd,
+      env: { ...process.env, ...config.env },
+      stdio: ["ignore", "pipe", "pipe"]
+    };
+    const child = spawn2(config.command, config.args, options);
+    let resolveExit;
+    const runningProcess = {
+      child,
+      exitPromise: new Promise((resolve4) => {
+        resolveExit = resolve4;
+      }),
+      stdoutBuffer: "",
+      stderrBuffer: ""
+    };
+    this.processes.set(config.label, runningProcess);
+    child.stdout?.on("data", (chunk) => {
+      runningProcess.stdoutBuffer = this.writeChunk(
+        config.label,
+        runningProcess.stdoutBuffer,
+        chunk,
+        false
+      );
+    });
+    child.stderr?.on("data", (chunk) => {
+      runningProcess.stderrBuffer = this.writeChunk(
+        config.label,
+        runningProcess.stderrBuffer,
+        chunk,
+        true
+      );
+    });
+    child.on("exit", (code, signal) => {
+      this.flushBuffer(config.label, runningProcess.stdoutBuffer, false);
+      this.flushBuffer(config.label, runningProcess.stderrBuffer, true);
+      this.processes.delete(config.label);
+      config.onExit?.(code, signal);
+      resolveExit?.();
+    });
+  }
+  hasRunning() {
+    return this.processes.size > 0;
+  }
+  async shutdownAll() {
+    const running = Array.from(this.processes.values());
+    if (running.length === 0) return;
+    for (const processEntry of running) {
+      processEntry.child.kill("SIGTERM");
+    }
+    await Promise.race([Promise.all(running.map((entry) => entry.exitPromise)), delay(5e3)]);
+    const remaining = Array.from(this.processes.values());
+    if (remaining.length === 0) return;
+    for (const processEntry of remaining) {
+      processEntry.child.kill("SIGKILL");
+    }
+    await Promise.all(remaining.map((entry) => entry.exitPromise));
+  }
+  writeChunk(label, buffer, chunk, isError) {
+    const combined = `${buffer}${chunk.toString("utf-8")}`;
+    const lines = combined.split(/\r?\n/);
+    const remaining = lines.pop() ?? "";
+    for (const line of lines) {
+      this.writeLine(label, line, isError);
+    }
+    return remaining;
+  }
+  flushBuffer(label, buffer, isError) {
+    if (!buffer) return;
+    this.writeLine(label, buffer, isError);
+  }
+  writeLine(label, line, isError) {
+    const stream = isError ? process.stderr : process.stdout;
+    stream.write(`[${label}] ${line}
+`);
+  }
+};
+function delay(ms) {
+  return new Promise((resolve4) => {
+    setTimeout(resolve4, ms);
+  });
+}
+
+// src/commands/dev/schema-watcher.ts
+import { spawn as spawn3 } from "child_process";
+import { watch } from "fs";
+var SchemaWatcher = class {
+  constructor(config) {
+    this.config = config;
+    this.debounceMs = config.debounceMs ?? 300;
+  }
+  config;
+  debounceMs;
+  watcher = null;
+  debounceTimer = null;
+  start() {
+    if (this.watcher) return;
+    this.watcher = watch(this.config.schemaPath, () => {
+      this.scheduleRegeneration();
+    });
+    this.watcher.on("error", (error) => {
+      this.config.onError?.(toError(error));
+    });
+  }
+  stop() {
+    if (this.debounceTimer) {
+      clearTimeout(this.debounceTimer);
+      this.debounceTimer = null;
+    }
+    this.watcher?.close();
+    this.watcher = null;
+  }
+  async regenerate() {
+    const koraBinary = await resolveProjectBinary(this.config.projectRoot, "kora");
+    if (!koraBinary) {
+      throw new Error('Could not find project binary "kora" in node_modules/.bin.');
+    }
+    const tsxBinary = await resolveProjectBinary(this.config.projectRoot, "tsx");
+    if (!tsxBinary) {
+      process.stderr.write('[kora] Could not find "tsx" binary. Falling back to node.\n');
+    }
+    const command = tsxBinary ?? process.execPath;
+    const args = [koraBinary, "generate", "types", "--schema", this.config.schemaPath];
+    await spawnCommand(command, args, this.config.projectRoot);
+    this.config.onRegenerate?.();
+  }
+  scheduleRegeneration() {
+    if (this.debounceTimer) {
+      clearTimeout(this.debounceTimer);
+    }
+    this.debounceTimer = setTimeout(() => {
+      this.debounceTimer = null;
+      void this.regenerate().catch((error) => {
+        this.config.onError?.(toError(error));
+      });
+    }, this.debounceMs);
+  }
+};
+async function spawnCommand(command, args, cwd) {
+  await new Promise((resolve4, reject) => {
+    const child = spawn3(command, args, {
+      cwd,
+      stdio: ["ignore", "pipe", "pipe"],
+      env: process.env
+    });
+    child.stdout?.on("data", (chunk) => {
+      writePrefixedLines(chunk, false);
+    });
+    child.stderr?.on("data", (chunk) => {
+      writePrefixedLines(chunk, true);
+    });
+    child.on("error", (error) => {
+      reject(error);
+    });
+    child.on("exit", (code) => {
+      if (code === 0) {
+        resolve4();
+        return;
+      }
+      reject(new Error(`Type generation exited with code ${code ?? "unknown"}.`));
+    });
+  });
+}
+function writePrefixedLines(chunk, isError) {
+  const text = chunk.toString("utf-8");
+  const lines = text.split(/\r?\n/).filter((line) => line.length > 0);
+  const stream = isError ? process.stderr : process.stdout;
+  for (const line of lines) {
+    stream.write(`[kora] ${line}
+`);
+  }
+}
+function toError(error) {
+  if (error instanceof Error) return error;
+  return new Error(String(error));
+}
+
+// src/commands/dev/dev-command.ts
+var devCommand = defineCommand({
+  meta: {
+    name: "dev",
+    description: "Start the Kora development environment"
+  },
+  args: {
+    port: {
+      type: "string",
+      description: "Vite dev server port"
+    },
+    "sync-port": {
+      type: "string",
+      description: "Kora sync server port"
+    },
+    "no-sync": {
+      type: "boolean",
+      description: "Disable sync server startup",
+      default: false
+    },
+    "no-watch": {
+      type: "boolean",
+      description: "Disable schema file watching",
+      default: false
+    }
+  },
+  async run({ args }) {
+    const logger = createLogger();
+    const projectRoot = await findProjectRoot();
+    if (!projectRoot) {
+      throw new InvalidProjectError(process.cwd());
+    }
+    const config = await loadKoraConfig(projectRoot);
+    const vitePort = typeof args.port === "string" ? args.port : String(config?.dev?.port ?? 5173);
+    const syncPortFromConfig = typeof config?.dev?.sync === "object" && typeof config.dev.sync.port === "number" ? config.dev.sync.port : 3001;
+    const syncPort = typeof args["sync-port"] === "string" ? args["sync-port"] : String(syncPortFromConfig);
+    const configSyncEnabled = config?.dev?.sync === void 0 || config.dev.sync === true || typeof config.dev.sync === "object" && config.dev.sync.enabled !== false;
+    const configWatchEnabled = config?.dev?.watch === void 0 || config.dev.watch === true || typeof config.dev.watch === "object" && config.dev.watch.enabled !== false;
+    const watchDebounceMs = typeof config?.dev?.watch === "object" && typeof config.dev.watch.debounceMs === "number" ? config.dev.watch.debounceMs : 300;
+    const viteBinary = await resolveProjectBinary(projectRoot, "vite");
+    if (!viteBinary) {
+      throw new DevServerError("vite", join2(projectRoot, "node_modules", ".bin", "vite"));
+    }
+    const syncServerFile = await findSyncServerFile(projectRoot);
+    let managedSyncStore = normalizeManagedSyncStore(config, projectRoot);
+    const postgresEnvRequested = isPostgresEnvRequested(config);
+    const syncAllowed = args["no-sync"] !== true && configSyncEnabled;
+    let shouldStartSync = syncAllowed && (syncServerFile !== null || managedSyncStore !== null);
+    let syncBinary = null;
+    if (shouldStartSync && syncServerFile !== null) {
+      syncBinary = await resolveProjectBinary(projectRoot, "tsx");
+      if (!syncBinary) {
+        logger.warn('Sync server detected, but local "tsx" binary was not found. Skipping sync.');
+      }
+    }
+    if (shouldStartSync && syncServerFile === null && managedSyncStore) {
+      const hasServerPackage = await fileExists(
+        join2(projectRoot, "node_modules", "@kora", "server", "package.json")
+      );
+      if (!hasServerPackage) {
+        logger.warn(
+          "Managed sync is configured, but @korajs/server is not installed. Install it or add server.ts."
+        );
+        managedSyncStore = null;
+        shouldStartSync = syncAllowed && (syncServerFile !== null || managedSyncStore !== null);
+      }
+    }
+    if (syncAllowed && syncServerFile === null && managedSyncStore === null && postgresEnvRequested) {
+      logger.warn(
+        "Managed postgres sync requested but no connection string found. Set dev.sync.store.connectionString or DATABASE_URL."
+      );
+    }
+    let configuredSchemaPath = null;
+    if (typeof config?.schema === "string") {
+      const candidate = resolve(projectRoot, config.schema);
+      if (await fileExists(candidate)) {
+        configuredSchemaPath = candidate;
+      } else {
+        logger.warn(`Configured schema file not found: ${candidate}. Falling back to auto-detection.`);
+      }
+    }
+    const schemaPath = configuredSchemaPath ?? await findSchemaFile(projectRoot);
+    const watchEnabled = args["no-watch"] !== true && configWatchEnabled && schemaPath !== null;
+    const processManager = new ProcessManager();
+    let schemaWatcher = null;
+    let shuttingDown = false;
+    let resolveFinished;
+    const finished = new Promise((resolve4) => {
+      resolveFinished = resolve4;
+    });
+    const onManagedProcessExit = () => {
+      if (!processManager.hasRunning() && !shuttingDown) {
+        resolveFinished?.();
+      }
+    };
+    const shutdown = async () => {
+      if (shuttingDown) return;
+      shuttingDown = true;
+      schemaWatcher?.stop();
+      await processManager.shutdownAll();
+      resolveFinished?.();
+    };
+    const onSigInt = () => {
+      void shutdown();
+    };
+    const onSigTerm = () => {
+      void shutdown();
+    };
+    process.on("SIGINT", onSigInt);
+    process.on("SIGTERM", onSigTerm);
+    logger.banner();
+    logger.info("Starting development environment:");
+    logger.blank();
+    logger.step(`  Vite dev server on port ${vitePort}`);
+    if (shouldStartSync && syncBinary && syncServerFile) {
+      logger.step(`  Sync server on port ${syncPort}`);
+    } else if (shouldStartSync && syncServerFile === null && managedSyncStore !== null) {
+      logger.step(`  Managed sync server on port ${syncPort} (${managedSyncStore.type})`);
+    } else if (syncAllowed && syncServerFile === null) {
+      logger.step("  Sync server configured but no server.ts/server.js or managed store found");
+    } else if (!syncAllowed) {
+      logger.step("  Sync server disabled via --no-sync");
+    }
+    if (watchEnabled && schemaPath) {
+      logger.step(`  Schema watcher enabled (${schemaPath})`);
+    } else if (args["no-watch"] === true) {
+      logger.step("  Schema watcher disabled via --no-watch");
+    } else {
+      logger.step("  Schema watcher disabled (schema.ts not found)");
+    }
+    logger.blank();
+    processManager.spawn({
+      label: "vite",
+      command: viteBinary,
+      args: ["--port", String(vitePort)],
+      cwd: projectRoot,
+      onExit: onManagedProcessExit
+    });
+    if (shouldStartSync && syncBinary && syncServerFile) {
+      processManager.spawn({
+        label: "sync",
+        command: syncBinary,
+        args: [syncServerFile],
+        cwd: projectRoot,
+        env: {
+          PORT: String(syncPort),
+          KORA_SYNC_PORT: String(syncPort)
+        },
+        onExit: onManagedProcessExit
+      });
+    }
+    if (shouldStartSync && syncServerFile === null && managedSyncStore !== null) {
+      processManager.spawn({
+        label: "sync",
+        command: process.execPath,
+        args: ["--input-type=module", "--eval", MANAGED_SYNC_BOOTSTRAP_SCRIPT],
+        cwd: projectRoot,
+        env: {
+          KORA_DEV_SYNC_CONFIG: JSON.stringify({
+            port: Number(syncPort),
+            store: managedSyncStore
+          })
+        },
+        onExit: onManagedProcessExit
+      });
+    }
+    if (watchEnabled && schemaPath) {
+      schemaWatcher = new SchemaWatcher({
+        schemaPath,
+        projectRoot,
+        debounceMs: watchDebounceMs,
+        onRegenerate: () => {
+          logger.success("Regenerated types from schema changes");
+        },
+        onError: (error) => {
+          logger.error(`Schema watcher error: ${error.message}`);
+        }
+      });
+      schemaWatcher.start();
+    }
+    await finished;
+    process.off("SIGINT", onSigInt);
+    process.off("SIGTERM", onSigTerm);
+  }
+});
+async function findSyncServerFile(projectRoot) {
+  const candidates = [join2(projectRoot, "server.ts"), join2(projectRoot, "server.js")];
+  for (const candidate of candidates) {
+    try {
+      await access2(candidate);
+      return candidate;
+    } catch {
+    }
+  }
+  return null;
+}
+async function fileExists(path) {
+  try {
+    await access2(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function normalizeManagedSyncStore(config, projectRoot) {
+  const sync = config?.dev?.sync;
+  if (typeof sync !== "object" || sync === null) return null;
+  const store = sync.store;
+  if (store === void 0) return { type: "memory" };
+  if (store === "memory") return { type: "memory" };
+  if (store === "sqlite") return { type: "sqlite", filename: join2(projectRoot, "kora-sync.db") };
+  if (store === "postgres") {
+    const connectionString = process.env.DATABASE_URL;
+    if (!connectionString) return null;
+    return { type: "postgres", connectionString };
+  }
+  if (typeof store === "object" && store !== null) {
+    if (store.type === "memory") return { type: "memory" };
+    if (store.type === "sqlite") {
+      const filename = typeof store.filename === "string" && store.filename.length > 0 ? resolve(projectRoot, store.filename) : join2(projectRoot, "kora-sync.db");
+      return { type: "sqlite", filename };
+    }
+    if (store.type === "postgres" && typeof store.connectionString === "string") {
+      return { type: "postgres", connectionString: store.connectionString };
+    }
+  }
+  return null;
+}
+function isPostgresEnvRequested(config) {
+  const sync = config?.dev?.sync;
+  if (typeof sync !== "object" || sync === null) return false;
+  if (sync.store === "postgres") return true;
+  if (typeof sync.store === "object" && sync.store !== null && sync.store.type === "postgres") return true;
+  return false;
+}
+var MANAGED_SYNC_BOOTSTRAP_SCRIPT = `
+const config = JSON.parse(process.env.KORA_DEV_SYNC_CONFIG ?? '{}');
+const {
+  createKoraServer,
+  MemoryServerStore,
+  createSqliteServerStore,
+  createPostgresServerStore,
+} = await import('@korajs/server');
+const storeConfig = config.store ?? { type: 'memory' };
+let store;
+if (storeConfig.type === 'memory') {
+  store = new MemoryServerStore();
+} else if (storeConfig.type === 'sqlite') {
+  const filename = typeof storeConfig.filename === 'string' && storeConfig.filename.length > 0
+    ? storeConfig.filename
+    : './kora-sync.db';
+  store = createSqliteServerStore({ filename });
+} else if (storeConfig.type === 'postgres') {
+  if (typeof storeConfig.connectionString !== 'string' || storeConfig.connectionString.length === 0) {
+    throw new Error('Managed postgres sync requires a connectionString');
+  }
+  store = await createPostgresServerStore({
+    connectionString: storeConfig.connectionString,
+  });
+} else {
+  throw new Error('Unsupported managed sync store type: ' + String(storeConfig.type));
+}
+const server = createKoraServer({ store, port: Number(config.port ?? 3001) });
+const shutdown = async () => {
+  try {
+    await server.stop();
+  } catch {
+  }
+  process.exit(0);
+};
+process.on('SIGINT', () => {
+  void shutdown();
+});
+process.on('SIGTERM', () => {
+  void shutdown();
+});
+await server.start();
+process.stdout.write('Managed sync server running on ws://localhost:' + String(config.port ?? 3001) + '\\n');
+await new Promise(() => {});
+`;
+
+// src/commands/generate/generate-command.ts
+import { mkdir, writeFile } from "fs/promises";
+import { dirname, resolve as resolve2 } from "path";
+import { defineCommand as defineCommand2 } from "citty";
+var generateCommand = defineCommand2({
+  meta: {
+    name: "generate",
+    description: "Generate code from your Kora schema"
+  },
+  subCommands: {
+    types: defineCommand2({
+      meta: {
+        name: "types",
+        description: "Generate TypeScript types from your schema"
+      },
+      args: {
+        schema: {
+          type: "string",
+          description: "Path to schema file"
+        },
+        output: {
+          type: "string",
+          description: "Output file path",
+          default: "kora/generated/types.ts"
+        }
+      },
+      async run({ args }) {
+        const logger = createLogger();
+        const projectRoot = await findProjectRoot();
+        if (!projectRoot) {
+          throw new InvalidProjectError(process.cwd());
+        }
+        let schemaPath;
+        if (args.schema && typeof args.schema === "string") {
+          schemaPath = resolve2(args.schema);
+        } else {
+          const found = await findSchemaFile(projectRoot);
+          if (!found) {
+            throw new SchemaNotFoundError([
+              "src/schema.ts",
+              "schema.ts",
+              "src/schema.js",
+              "schema.js"
+            ]);
+          }
+          schemaPath = found;
+        }
+        logger.step(`Reading schema from ${schemaPath}...`);
+        const schemaModule = await import(schemaPath);
+        const schema = extractSchema(schemaModule);
+        if (!schema) {
+          logger.error("Schema file must export a SchemaDefinition as the default export.");
+          process.exitCode = 1;
+          return;
+        }
+        const output = generateTypes(schema);
+        const outputFile = typeof args.output === "string" ? args.output : "kora/generated/types.ts";
+        const outputPath = resolve2(projectRoot, outputFile);
+        await mkdir(dirname(outputPath), { recursive: true });
+        await writeFile(outputPath, output, "utf-8");
+        logger.success(`Generated types at ${outputPath}`);
+      }
+    })
+  }
+});
+function extractSchema(mod) {
+  if (typeof mod !== "object" || mod === null) return null;
+  const record = mod;
+  const candidate = record.default ?? record;
+  if (isSchemaDefinition(candidate)) return candidate;
+  return null;
+}
+function isSchemaDefinition(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const obj = value;
+  return typeof obj.version === "number" && typeof obj.collections === "object" && obj.collections !== null;
+}
+
+// src/commands/migrate/migrate-command.ts
+import { mkdir as mkdir2, readFile, readdir, writeFile as writeFile2 } from "fs/promises";
+import { dirname as dirname2, join as join3, resolve as resolve3 } from "path";
+import { defineCommand as defineCommand3 } from "citty";
+
+// src/commands/migrate/migration-generator.ts
+import { generateSQL } from "@korajs/core";
+
+// src/commands/migrate/schema-differ.ts
+function diffSchemas(previous, current) {
+  const changes = [];
+  const previousCollections = new Set(Object.keys(previous.collections));
+  const currentCollections = new Set(Object.keys(current.collections));
+  for (const collection of currentCollections) {
+    if (!previousCollections.has(collection)) {
+      changes.push({ type: "collection-added", collection });
+    }
+  }
+  for (const collection of previousCollections) {
+    if (!currentCollections.has(collection)) {
+      changes.push({ type: "collection-removed", collection });
+    }
+  }
+  for (const collection of currentCollections) {
+    if (!previousCollections.has(collection)) continue;
+    const previousDef = previous.collections[collection];
+    const currentDef = current.collections[collection];
+    if (!previousDef || !currentDef) continue;
+    const previousFields = previousDef.fields;
+    const currentFields = currentDef.fields;
+    for (const [fieldName, currentField] of Object.entries(currentFields)) {
+      const previousField = previousFields[fieldName];
+      if (!previousField) {
+        changes.push({
+          type: "field-added",
+          collection,
+          field: fieldName,
+          descriptor: currentField
+        });
+        continue;
+      }
+      if (!fieldDescriptorsEqual(previousField, currentField)) {
+        changes.push({
+          type: "field-changed",
+          collection,
+          field: fieldName,
+          before: previousField,
+          after: currentField
+        });
+      }
+    }
+    for (const [fieldName, previousField] of Object.entries(previousFields)) {
+      if (!(fieldName in currentFields)) {
+        changes.push({
+          type: "field-removed",
+          collection,
+          field: fieldName,
+          descriptor: previousField
+        });
+      }
+    }
+    const previousIndexes = new Set(previousDef.indexes);
+    const currentIndexes = new Set(currentDef.indexes);
+    for (const index of currentIndexes) {
+      if (!previousIndexes.has(index)) {
+        changes.push({ type: "index-added", collection, index });
+      }
+    }
+    for (const index of previousIndexes) {
+      if (!currentIndexes.has(index)) {
+        changes.push({ type: "index-removed", collection, index });
+      }
+    }
+  }
+  changes.sort(compareChanges);
+  return {
+    fromVersion: previous.version,
+    toVersion: current.version,
+    changes,
+    hasChanges: changes.length > 0,
+    hasBreakingChanges: changes.some(isBreakingChange)
+  };
+}
+function getChangedCollections(diff) {
+  const collections = /* @__PURE__ */ new Set();
+  for (const change of diff.changes) {
+    collections.add(change.collection);
+  }
+  return [...collections].sort();
+}
+function isBreakingChange(change) {
+  if (change.type === "collection-removed" || change.type === "field-removed") return true;
+  if (change.type === "field-changed") {
+    if (change.before.kind !== change.after.kind) return true;
+    if (change.before.itemKind !== change.after.itemKind) return true;
+    if (serializeEnum(change.before.enumValues) !== serializeEnum(change.after.enumValues)) return true;
+    if (change.before.required !== change.after.required && change.after.required) return true;
+    return false;
+  }
+  if (change.type === "field-added") {
+    const descriptor = change.descriptor;
+    return descriptor.required && descriptor.defaultValue === void 0 && !descriptor.auto;
+  }
+  return false;
+}
+function fieldDescriptorsEqual(left, right) {
+  return left.kind === right.kind && left.required === right.required && left.defaultValue === right.defaultValue && left.auto === right.auto && left.itemKind === right.itemKind && serializeEnum(left.enumValues) === serializeEnum(right.enumValues);
+}
+function serializeEnum(values) {
+  if (!values) return "";
+  return values.join("|");
+}
+function compareChanges(left, right) {
+  if (left.collection < right.collection) return -1;
+  if (left.collection > right.collection) return 1;
+  if (left.type < right.type) return -1;
+  if (left.type > right.type) return 1;
+  const leftKey = "field" in left ? left.field : "index" in left ? left.index : "";
+  const rightKey = "field" in right ? right.field : "index" in right ? right.index : "";
+  if (leftKey < rightKey) return -1;
+  if (leftKey > rightKey) return 1;
+  return 0;
+}
+
+// src/commands/migrate/migration-generator.ts
+function generateMigration(previous, current, diff) {
+  const up = [];
+  const down = [];
+  for (const change of diff.changes) {
+    if (change.type === "collection-added") {
+      const collectionDef = current.collections[change.collection];
+      if (!collectionDef) continue;
+      up.push(...generateSQL(change.collection, collectionDef));
+      down.push(...dropCollectionStatements(change.collection));
+    }
+    if (change.type === "collection-removed") {
+      const collectionDef = previous.collections[change.collection];
+      up.push(...dropCollectionStatements(change.collection));
+      if (collectionDef) {
+        down.push(...generateSQL(change.collection, collectionDef));
+      }
+    }
+  }
+  const changedCollections = getChangedCollections(diff).filter(
+    (collection) => collection in previous.collections && collection in current.collections && diff.changes.some(
+      (change) => change.collection === collection && (change.type === "field-added" || change.type === "field-removed" || change.type === "field-changed" || change.type === "index-added" || change.type === "index-removed")
+    )
+  );
+  for (const collection of changedCollections) {
+    const previousDef = previous.collections[collection];
+    const currentDef = current.collections[collection];
+    if (!previousDef || !currentDef) continue;
+    validateRebuildSafety(collection, previousDef, currentDef);
+    up.push(...generateRebuildStatements(collection, previousDef, currentDef));
+    down.push(...generateRebuildStatements(collection, currentDef, previousDef));
+  }
+  down.reverse();
+  return {
+    up,
+    down,
+    summary: diff.changes.map(formatChange),
+    containsBreakingChanges: diff.hasBreakingChanges
+  };
+}
+function generateRebuildStatements(collection, from, to) {
+  const table = quoteIdentifier(collection);
+  const tempTable = quoteIdentifier(`_kora_mig_${collection}_new`);
+  const targetColumns = [
+    "id TEXT PRIMARY KEY NOT NULL",
+    ...Object.entries(to.fields).map(([field, descriptor]) => columnDefinition(field, descriptor)),
+    "_created_at INTEGER NOT NULL",
+    "_updated_at INTEGER NOT NULL",
+    "_deleted INTEGER NOT NULL DEFAULT 0"
+  ];
+  const statements = [];
+  statements.push(`CREATE TABLE ${tempTable} (
+  ${targetColumns.join(",\n  ")}
+)`);
+  const toFields = Object.keys(to.fields);
+  const columns = ["id", ...toFields, "_created_at", "_updated_at", "_deleted"];
+  const selectExpressions = columns.map(
+    (column) => projectionForColumn(column, from.fields, to.fields[column] ?? null)
+  );
+  statements.push(
+    `INSERT INTO ${tempTable} (${columns.map(quoteIdentifier).join(", ")}) SELECT ${selectExpressions.join(", ")} FROM ${table}`
+  );
+  statements.push(`DROP TABLE ${table}`);
+  statements.push(`ALTER TABLE ${tempTable} RENAME TO ${table}`);
+  for (const indexField of to.indexes) {
+    statements.push(
+      `CREATE INDEX IF NOT EXISTS idx_${collection}_${indexField} ON ${table} (${quoteIdentifier(indexField)})`
+    );
+  }
+  return statements;
+}
+function validateRebuildSafety(collection, from, to) {
+  for (const [fieldName, descriptor] of Object.entries(to.fields)) {
+    if (fieldName in from.fields) continue;
+    if (descriptor.required && descriptor.defaultValue === void 0 && !descriptor.auto) {
+      throw new Error(
+        `Cannot auto-migrate collection "${collection}": added required field "${fieldName}" has no default value.`
+      );
+    }
+  }
+  for (const [fieldName, targetDescriptor] of Object.entries(to.fields)) {
+    const sourceDescriptor = from.fields[fieldName];
+    if (!sourceDescriptor) continue;
+    if (canTransformField(sourceDescriptor, targetDescriptor)) continue;
+    if (targetDescriptor.required && targetDescriptor.defaultValue === void 0 && !targetDescriptor.auto) {
+      throw new Error(
+        `Cannot auto-migrate collection "${collection}": changed required field "${fieldName}" from ${sourceDescriptor.kind} to ${targetDescriptor.kind} without a safe transform/default.`
+      );
+    }
+  }
+}
+function projectionForColumn(column, fromFields, targetDescriptor) {
+  if (column === "id" || column === "_created_at" || column === "_updated_at" || column === "_deleted") {
+    return quoteIdentifier(column);
+  }
+  const sourceDescriptor = fromFields[column];
+  if (sourceDescriptor && targetDescriptor) {
+    return projectionForFieldTransform(column, sourceDescriptor, targetDescriptor);
+  }
+  if (sourceDescriptor) {
+    return quoteIdentifier(column);
+  }
+  if (!targetDescriptor) {
+    return "NULL";
+  }
+  if (targetDescriptor.auto && targetDescriptor.kind === "timestamp") {
+    return "CAST(strftime('%s','now') AS INTEGER) * 1000";
+  }
+  if (targetDescriptor.defaultValue !== void 0) {
+    return sqlLiteral(targetDescriptor.defaultValue);
+  }
+  return "NULL";
+}
+function projectionForFieldTransform(column, source, target) {
+  const sourceColumn = quoteIdentifier(column);
+  if (source.kind === target.kind && source.itemKind === target.itemKind) {
+    if (target.kind === "enum" && target.enumValues && target.enumValues.length > 0) {
+      const allowed = target.enumValues.map((value) => sqlLiteral(value)).join(", ");
+      const fallback = target.defaultValue !== void 0 ? sqlLiteral(target.defaultValue) : sourceColumn;
+      return `CASE WHEN ${sourceColumn} IN (${allowed}) THEN ${sourceColumn} ELSE ${fallback} END`;
+    }
+    return sourceColumn;
+  }
+  if (target.kind === "string") {
+    return `CAST(${sourceColumn} AS TEXT)`;
+  }
+  if (target.kind === "number" || target.kind === "timestamp") {
+    if (source.kind === "string" || source.kind === "enum" || source.kind === "number" || source.kind === "timestamp" || source.kind === "boolean") {
+      const castType = target.kind === "number" ? "REAL" : "INTEGER";
+      return `CASE WHEN ${sourceColumn} IS NULL THEN NULL ELSE CAST(${sourceColumn} AS ${castType}) END`;
+    }
+  }
+  if (target.kind === "boolean") {
+    if (source.kind === "number" || source.kind === "timestamp" || source.kind === "boolean") {
+      return `CASE WHEN ${sourceColumn} IS NULL THEN NULL WHEN CAST(${sourceColumn} AS REAL) = 0 THEN 0 ELSE 1 END`;
+    }
+    if (source.kind === "string" || source.kind === "enum") {
+      return `CASE WHEN ${sourceColumn} IS NULL THEN NULL WHEN LOWER(TRIM(CAST(${sourceColumn} AS TEXT))) IN ('1','true','t','yes','y','on') THEN 1 WHEN LOWER(TRIM(CAST(${sourceColumn} AS TEXT))) IN ('0','false','f','no','n','off') THEN 0 ELSE ${projectionFallback(target)} END`;
+    }
+  }
+  if (target.kind === "enum" && target.enumValues && target.enumValues.length > 0) {
+    if (source.kind === "string" || source.kind === "enum") {
+      const allowed = target.enumValues.map((value) => sqlLiteral(value)).join(", ");
+      return `CASE WHEN ${sourceColumn} IN (${allowed}) THEN ${sourceColumn} ELSE ${projectionFallback(target)} END`;
+    }
+  }
+  if (target.kind === "array" && source.kind === "array" && source.itemKind === target.itemKind) {
+    return sourceColumn;
+  }
+  if (target.auto && target.kind === "timestamp") {
+    return "CAST(strftime('%s','now') AS INTEGER) * 1000";
+  }
+  return projectionFallback(target);
+}
+function canTransformField(source, target) {
+  if (source.kind === target.kind && source.itemKind === target.itemKind) {
+    return true;
+  }
+  if (target.kind === "string") {
+    return true;
+  }
+  if (target.kind === "number" || target.kind === "timestamp") {
+    return source.kind === "string" || source.kind === "enum" || source.kind === "number" || source.kind === "timestamp" || source.kind === "boolean";
+  }
+  if (target.kind === "boolean") {
+    return source.kind === "number" || source.kind === "timestamp" || source.kind === "boolean" || source.kind === "string" || source.kind === "enum";
+  }
+  if (target.kind === "enum") {
+    return source.kind === "string" || source.kind === "enum";
+  }
+  if (target.kind === "array") {
+    return source.kind === "array" && source.itemKind === target.itemKind;
+  }
+  if (target.kind === "richtext") {
+    return source.kind === "richtext";
+  }
+  return false;
+}
+function projectionFallback(target) {
+  if (target.auto && target.kind === "timestamp") {
+    return "CAST(strftime('%s','now') AS INTEGER) * 1000";
+  }
+  if (target.defaultValue !== void 0) {
+    return sqlLiteral(target.defaultValue);
+  }
+  return "NULL";
+}
+function dropCollectionStatements(collection) {
+  const table = quoteIdentifier(collection);
+  const opsTable = quoteIdentifier(`_kora_ops_${collection}`);
+  return [`DROP TABLE IF EXISTS ${table}`, `DROP TABLE IF EXISTS ${opsTable}`];
+}
+function columnDefinition(fieldName, descriptor) {
+  const sqlType = mapFieldType(descriptor);
+  const parts = [quoteIdentifier(fieldName), sqlType];
+  if (descriptor.required && descriptor.defaultValue === void 0 && !descriptor.auto) {
+    parts.push("NOT NULL");
+  }
+  if (descriptor.defaultValue !== void 0) {
+    parts.push(`DEFAULT ${sqlLiteral(descriptor.defaultValue)}`);
+  }
+  if (descriptor.kind === "enum" && descriptor.enumValues) {
+    const values = descriptor.enumValues.map((value) => sqlLiteral(value)).join(", ");
+    parts.push(`CHECK (${quoteIdentifier(fieldName)} IN (${values}))`);
+  }
+  return parts.join(" ");
+}
+function mapFieldType(descriptor) {
+  switch (descriptor.kind) {
+    case "string":
+      return "TEXT";
+    case "number":
+      return "REAL";
+    case "boolean":
+      return "INTEGER";
+    case "enum":
+      return "TEXT";
+    case "timestamp":
+      return "INTEGER";
+    case "array":
+      return "TEXT";
+    case "richtext":
+      return "BLOB";
+  }
+}
+function sqlLiteral(value) {
+  if (value === null) return "NULL";
+  if (typeof value === "number") return String(value);
+  if (typeof value === "boolean") return value ? "1" : "0";
+  if (typeof value === "string") return `'${value.replaceAll("'", "''")}'`;
+  return `'${JSON.stringify(value).replaceAll("'", "''")}'`;
+}
+function quoteIdentifier(identifier) {
+  if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(identifier)) {
+    throw new Error(`Invalid SQL identifier: ${identifier}`);
+  }
+  return identifier;
+}
+function formatChange(change) {
+  switch (change.type) {
+    case "collection-added":
+      return `+ collection ${change.collection}`;
+    case "collection-removed":
+      return `- collection ${change.collection}`;
+    case "field-added":
+      return `+ ${change.collection}.${change.field}`;
+    case "field-removed":
+      return `- ${change.collection}.${change.field}`;
+    case "field-changed":
+      return `~ ${change.collection}.${change.field}`;
+    case "index-added":
+      return `+ index ${change.collection}.${change.index}`;
+    case "index-removed":
+      return `- index ${change.collection}.${change.index}`;
+  }
+}
+
+// src/commands/migrate/migration-runner.ts
+var MigrationApplyError = class extends Error {
+  constructor(message, backend, report) {
+    super(message);
+    this.backend = backend;
+    this.report = report;
+    this.name = "MigrationApplyError";
+  }
+  backend;
+  report;
+};
+async function runMigration(options) {
+  const report = { backends: [] };
+  const migrationId = options.migrationId ?? `migration-${Date.now()}`;
+  const fromVersion = options.fromVersion ?? 0;
+  const toVersion = options.toVersion ?? 0;
+  if (options.sqlitePath) {
+    try {
+      const sqliteReport = await runSqliteMigration(
+        options.sqlitePath,
+        options.upStatements,
+        migrationId,
+        fromVersion,
+        toVersion,
+        options.projectRoot,
+        options.sqliteDriver
+      );
+      report.backends.push(sqliteReport);
+    } catch (error) {
+      throw new MigrationApplyError(error.message, "sqlite", report);
+    }
+  }
+  if (options.postgresConnectionString) {
+    try {
+      const postgresReport = await runPostgresMigration(
+        options.postgresConnectionString,
+        options.upStatements,
+        migrationId,
+        fromVersion,
+        toVersion,
+        options.postgresClientFactory
+      );
+      report.backends.push(postgresReport);
+    } catch (error) {
+      throw new MigrationApplyError(error.message, "postgres", report);
+    }
+  }
+  return report;
+}
+async function runSqliteMigration(path, statements, migrationId, fromVersion, toVersion, projectRoot, driverOverride) {
+  const driver = driverOverride ?? await loadSqliteDriver(projectRoot);
+  const db = driver.open(path);
+  let statementsApplied = 0;
+  try {
+    db.exec("BEGIN");
+    db.exec(
+      "CREATE TABLE IF NOT EXISTS _kora_migrations (id TEXT PRIMARY KEY NOT NULL, from_version INTEGER NOT NULL, to_version INTEGER NOT NULL, applied_at INTEGER NOT NULL)"
+    );
+    const alreadyApplied = typeof db.isMigrationApplied === "function" ? db.isMigrationApplied(migrationId) : false;
+    if (alreadyApplied) {
+      db.exec("COMMIT");
+      return {
+        backend: "sqlite",
+        statementsApplied: 0,
+        historyRecorded: true,
+        skipped: true
+      };
+    }
+    for (const statement of statements) {
+      db.exec(statement);
+      statementsApplied++;
+    }
+    db.exec(
+      `INSERT OR REPLACE INTO _kora_migrations (id, from_version, to_version, applied_at) VALUES (${sqlLiteral2(migrationId)}, ${fromVersion}, ${toVersion}, ${Date.now()})`
+    );
+    db.exec("COMMIT");
+    return {
+      backend: "sqlite",
+      statementsApplied,
+      historyRecorded: true,
+      skipped: false
+    };
+  } catch (error) {
+    try {
+      db.exec("ROLLBACK");
+    } catch {
+    }
+    throw error;
+  } finally {
+    if (typeof db.close === "function") {
+      db.close();
+    }
+  }
+}
+async function loadSqliteDriver(projectRoot) {
+  try {
+    const { createRequire } = await import("module");
+    const requireFrom = createRequire(
+      projectRoot ? `${projectRoot}/package.json` : import.meta.url
+    );
+    const Database = requireFrom("better-sqlite3");
+    return {
+      open(path) {
+        const db = new Database(path);
+        return {
+          exec(sql) {
+            db.exec(sql);
+          },
+          isMigrationApplied(id) {
+            const row = db.prepare("SELECT COUNT(*) AS count FROM _kora_migrations WHERE id = ?").get(id);
+            return (row?.count ?? 0) > 0;
+          },
+          close() {
+            db.close();
+          }
+        };
+      }
+    };
+  } catch {
+    throw new Error(
+      'SQLite migration apply requires the "better-sqlite3" package in the target project dependencies.'
+    );
+  }
+}
+async function runPostgresMigration(connectionString, statements, migrationId, fromVersion, toVersion, clientFactoryOverride) {
+  const sql = typeof clientFactoryOverride === "function" ? clientFactoryOverride(connectionString) : (await loadPostgresModule()).default(connectionString);
+  let statementsApplied = 0;
+  try {
+    await sql.unsafe("BEGIN");
+    await sql.unsafe(
+      "CREATE TABLE IF NOT EXISTS _kora_migrations (id TEXT PRIMARY KEY, from_version INTEGER NOT NULL, to_version INTEGER NOT NULL, applied_at BIGINT NOT NULL)"
+    );
+    const existing = await sql.unsafe(
+      `SELECT COUNT(*)::int AS count FROM _kora_migrations WHERE id = ${sqlLiteral2(migrationId)}`
+    );
+    if ((existing[0]?.count ?? 0) > 0) {
+      await sql.unsafe("COMMIT");
+      return {
+        backend: "postgres",
+        statementsApplied: 0,
+        historyRecorded: true,
+        skipped: true
+      };
+    }
+    for (const statement of statements) {
+      await sql.unsafe(statement);
+      statementsApplied++;
+    }
+    await sql.unsafe(
+      `INSERT INTO _kora_migrations (id, from_version, to_version, applied_at) VALUES (${sqlLiteral2(migrationId)}, ${fromVersion}, ${toVersion}, ${Date.now()}) ON CONFLICT (id) DO UPDATE SET from_version = EXCLUDED.from_version, to_version = EXCLUDED.to_version, applied_at = EXCLUDED.applied_at`
+    );
+    await sql.unsafe("COMMIT");
+    return {
+      backend: "postgres",
+      statementsApplied,
+      historyRecorded: true,
+      skipped: false
+    };
+  } catch (error) {
+    try {
+      await sql.unsafe("ROLLBACK");
+    } catch {
+    }
+    throw error;
+  } finally {
+    if (typeof sql.end === "function") {
+      await sql.end();
+    }
+  }
+}
+function sqlLiteral2(value) {
+  return `'${value.replaceAll("'", "''")}'`;
+}
+async function loadPostgresModule() {
+  try {
+    const dynamicImport = new Function("specifier", "return import(specifier)");
+    const mod = await dynamicImport("postgres");
+    if (typeof mod === "object" && mod !== null && "default" in mod) {
+      return mod;
+    }
+    throw new Error("Invalid postgres module");
+  } catch {
+    throw new Error(
+      'PostgreSQL migration apply requires the "postgres" package in the target project dependencies.'
+    );
+  }
+}
+
+// src/commands/migrate/schema-loader.ts
+import { spawn as spawn4 } from "child_process";
+import { extname as extname2 } from "path";
+import { pathToFileURL as pathToFileURL2 } from "url";
+async function loadSchemaDefinition(schemaPath, projectRoot) {
+  const ext = extname2(schemaPath);
+  const moduleValue = ext === ".ts" || ext === ".mts" || ext === ".cts" ? await loadTypeScriptModule(schemaPath, projectRoot) : await import(`${pathToFileURL2(schemaPath).href}?t=${Date.now()}-${Math.random()}`);
+  return extractSchema2(moduleValue);
+}
+function extractSchema2(value) {
+  if (typeof value !== "object" || value === null) {
+    throw new Error("Schema module must export an object.");
+  }
+  const moduleRecord = value;
+  const candidate = moduleRecord.default ?? moduleRecord;
+  if (!isSchemaDefinition2(candidate)) {
+    throw new Error("Schema module must export a valid SchemaDefinition as default export.");
+  }
+  return candidate;
+}
+function isSchemaDefinition2(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const object = value;
+  return typeof object.version === "number" && typeof object.collections === "object" && object.collections !== null && typeof object.relations === "object" && object.relations !== null;
+}
+async function loadTypeScriptModule(schemaPath, projectRoot) {
+  const tsxBinary = await resolveProjectBinary(projectRoot, "tsx");
+  if (!tsxBinary) {
+    throw new Error(
+      `Schema file is TypeScript (${schemaPath}) but local "tsx" was not found. Install tsx in the project.`
+    );
+  }
+  const script = [
+    "import { pathToFileURL } from 'node:url'",
+    "const modulePath = process.argv[process.argv.length - 1]",
+    "const mod = await import(pathToFileURL(modulePath).href)",
+    "const value = mod.default ?? mod",
+    "process.stdout.write(JSON.stringify(value))"
+  ].join(";");
+  const output = await runCommand2(tsxBinary, ["--eval", script, schemaPath], projectRoot);
+  try {
+    return JSON.parse(output);
+  } catch {
+    throw new Error(`Failed to parse schema module output for ${schemaPath}`);
+  }
+}
+async function runCommand2(command, args, cwd) {
+  return await new Promise((resolve4, reject) => {
+    const child = spawn4(command, args, {
+      cwd,
+      stdio: ["ignore", "pipe", "pipe"],
+      env: process.env
+    });
+    let stdout = "";
+    let stderr = "";
+    child.stdout?.on("data", (chunk) => {
+      stdout += chunk.toString("utf-8");
+    });
+    child.stderr?.on("data", (chunk) => {
+      stderr += chunk.toString("utf-8");
+    });
+    child.on("error", (error) => {
+      reject(error);
+    });
+    child.on("exit", (code) => {
+      if (code === 0) {
+        resolve4(stdout.trim());
+        return;
+      }
+      reject(
+        new Error(`Failed to load TypeScript schema (exit ${code ?? "unknown"}): ${stderr.trim()}`)
+      );
+    });
+  });
+}
+
+// src/commands/migrate/migrate-command.ts
+var SNAPSHOT_PATH = "kora/schema.snapshot.json";
+var MIGRATIONS_DIR = "kora/migrations";
+var migrateCommand = defineCommand3({
+  meta: {
+    name: "migrate",
+    description: "Detect schema changes and generate/apply migrations"
+  },
+  args: {
+    apply: {
+      type: "boolean",
+      description: "Apply migration to configured database backends",
+      default: false
+    },
+    schema: {
+      type: "string",
+      description: "Path to schema file"
+    },
+    db: {
+      type: "string",
+      description: "SQLite database path for --apply (overrides config)"
+    },
+    "output-dir": {
+      type: "string",
+      description: "Migration output directory",
+      default: MIGRATIONS_DIR
+    },
+    "dry-run": {
+      type: "boolean",
+      description: "Preview migration changes without writing files",
+      default: false
+    },
+    force: {
+      type: "boolean",
+      description: "Skip breaking-change confirmation prompts",
+      default: false
+    }
+  },
+  async run({ args }) {
+    const logger = createLogger();
+    const projectRoot = await findProjectRoot();
+    if (!projectRoot) {
+      throw new InvalidProjectError(process.cwd());
+    }
+    const config = await loadKoraConfig(projectRoot);
+    const resolvedSchemaPath = typeof args.schema === "string" ? resolve3(projectRoot, args.schema) : typeof config?.schema === "string" ? resolve3(projectRoot, config.schema) : await findSchemaFile(projectRoot);
+    if (!resolvedSchemaPath) {
+      throw new SchemaNotFoundError(["src/schema.ts", "schema.ts", "src/schema.js", "schema.js"]);
+    }
+    const currentSchema = await loadSchemaDefinition(resolvedSchemaPath, projectRoot);
+    const snapshotFile = join3(projectRoot, SNAPSHOT_PATH);
+    const previousSchema = await readSchemaSnapshot(snapshotFile);
+    if (!previousSchema) {
+      if (args["dry-run"] === true) {
+        logger.info("No schema snapshot found. Dry run: baseline snapshot would be created.");
+        return;
+      }
+      await writeSchemaSnapshot(snapshotFile, currentSchema);
+      logger.success(`Initialized schema snapshot at ${snapshotFile}`);
+      logger.step("Run `kora migrate` again after schema changes to generate migrations.");
+      return;
+    }
+    const diff = diffSchemas(previousSchema, currentSchema);
+    const outputDir = typeof args["output-dir"] === "string" ? resolve3(projectRoot, args["output-dir"]) : resolve3(projectRoot, MIGRATIONS_DIR);
+    if (!diff.hasChanges) {
+      logger.success("No schema changes detected.");
+      if (args.apply === true) {
+        const sqlitePath = resolveSqliteApplyPath(args.db, projectRoot, config);
+        const postgresConnectionString = resolvePostgresConnectionString(config);
+        const pending = await listMigrationManifests(outputDir);
+        if (pending.length === 0) {
+          logger.step("No migration files found to apply.");
+          return;
+        }
+        for (const manifest of pending) {
+          const report = await runMigration({
+            upStatements: manifest.up,
+            migrationId: manifest.id,
+            fromVersion: manifest.fromVersion,
+            toVersion: manifest.toVersion,
+            sqlitePath,
+            postgresConnectionString,
+            projectRoot
+          });
+          for (const backend of report.backends) {
+            logger.step(
+              `  ${manifest.id} -> ${backend.backend}: applied=${backend.statementsApplied}, skipped=${backend.skipped}`
+            );
+          }
+        }
+      }
+      return;
+    }
+    const generated = generateMigration(previousSchema, currentSchema, diff);
+    logger.banner();
+    logger.info(`Detected schema change: v${diff.fromVersion} \u2192 v${diff.toVersion}`);
+    logger.blank();
+    logger.info("Changes:");
+    for (const line of generated.summary) {
+      logger.step(`  ${line}`);
+    }
+    if (diff.hasBreakingChanges && args["dry-run"] !== true) {
+      logger.blank();
+      logger.warn("Breaking schema changes detected.");
+      const shouldContinue = await confirmBreakingChanges(args.force === true);
+      if (!shouldContinue) {
+        logger.warn("Migration generation aborted.");
+        return;
+      }
+    }
+    if (args["dry-run"] === true) {
+      logger.blank();
+      logger.warn("Dry run enabled: no files written, no migrations applied.");
+      return;
+    }
+    await mkdir2(outputDir, { recursive: true });
+    const migrationPath = await writeMigrationFile(outputDir, diff.fromVersion, diff.toVersion, generated);
+    await writeSchemaSnapshot(snapshotFile, currentSchema);
+    logger.blank();
+    logger.success(`Generated migration: ${migrationPath}`);
+    if (args.apply === true) {
+      const sqlitePath = resolveSqliteApplyPath(args.db, projectRoot, config);
+      const postgresConnectionString = resolvePostgresConnectionString(config);
+      const pending = await listMigrationManifests(outputDir);
+      for (const manifest of pending) {
+        const report = await runMigration({
+          upStatements: manifest.up,
+          migrationId: manifest.id,
+          fromVersion: manifest.fromVersion,
+          toVersion: manifest.toVersion,
+          sqlitePath,
+          postgresConnectionString,
+          projectRoot
+        });
+        for (const backend of report.backends) {
+          logger.step(
+            `  ${manifest.id} -> ${backend.backend}: applied=${backend.statementsApplied}, skipped=${backend.skipped}, history=${backend.historyRecorded}`
+          );
+        }
+      }
+      logger.success("Applied pending migrations successfully.");
+    }
+  }
+});
+async function readSchemaSnapshot(path) {
+  try {
+    const content = await readFile(path, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+async function confirmBreakingChanges(force) {
+  if (force) {
+    return true;
+  }
+  if (!isInteractiveTerminal()) {
+    throw new Error(
+      "Breaking schema changes require confirmation. Re-run with --force to continue or --dry-run to preview."
+    );
+  }
+  return await promptConfirm("Continue and generate a breaking migration?", false);
+}
+function isInteractiveTerminal() {
+  return process.stdin.isTTY === true && process.stdout.isTTY === true;
+}
+async function writeSchemaSnapshot(path, schema) {
+  await mkdir2(dirname2(path), { recursive: true });
+  await writeFile2(path, `${JSON.stringify(schema, null, 2)}
+`, "utf-8");
+}
+async function writeMigrationFile(outputDir, fromVersion, toVersion, generated) {
+  const existing = await readdir(outputDir).catch(() => []);
+  const sequence = existing.filter((file) => /^\d{3}-/.test(file)).length + 1;
+  const filename = `${String(sequence).padStart(3, "0")}-v${fromVersion}-to-v${toVersion}.ts`;
+  const path = join3(outputDir, filename);
+  const migrationId = filename.replace(/\.ts$/, "");
+  const fileContent = [
+    `export const up = ${JSON.stringify(generated.up, null, 2)} as const`,
+    "",
+    `export const down = ${JSON.stringify(generated.down, null, 2)} as const`,
+    "",
+    `export const summary = ${JSON.stringify(generated.summary, null, 2)} as const`,
+    "",
+    `export const containsBreakingChanges = ${generated.containsBreakingChanges}`,
+    ""
+  ].join("\n");
+  await writeFile2(path, fileContent, "utf-8");
+  await writeMigrationManifest(join3(outputDir, `${migrationId}.json`), {
+    id: migrationId,
+    fromVersion,
+    toVersion,
+    up: generated.up,
+    down: generated.down,
+    summary: generated.summary,
+    containsBreakingChanges: generated.containsBreakingChanges
+  });
+  return path;
+}
+async function writeMigrationManifest(path, manifest) {
+  await writeFile2(path, `${JSON.stringify(manifest, null, 2)}
+`, "utf-8");
+}
+async function listMigrationManifests(outputDir) {
+  const files = await readdir(outputDir).catch(() => []);
+  const migrationFiles = files.filter((file) => /^\d{3}-.*\.ts$/.test(file)).sort((left, right) => left.localeCompare(right));
+  const manifests = [];
+  for (const file of migrationFiles) {
+    const id = file.replace(/\.ts$/, "");
+    const manifestPath = join3(outputDir, `${id}.json`);
+    const jsonManifest = await readMigrationManifest(manifestPath);
+    if (jsonManifest) {
+      manifests.push({ ...jsonManifest, id });
+      continue;
+    }
+    const migrationPath = join3(outputDir, file);
+    const sourceManifest = await readMigrationManifestFromSource(migrationPath, id);
+    manifests.push(sourceManifest);
+  }
+  return manifests;
+}
+async function readMigrationManifest(path) {
+  try {
+    const content = await readFile(path, "utf-8");
+    return JSON.parse(content);
+  } catch (error) {
+    const code = error.code;
+    if (code === "ENOENT") {
+      return null;
+    }
+    throw error;
+  }
+}
+async function readMigrationManifestFromSource(path, id) {
+  const content = await readFile(path, "utf-8");
+  const versions = parseVersionsFromMigrationId(id);
+  return {
+    id,
+    fromVersion: versions.fromVersion,
+    toVersion: versions.toVersion,
+    up: parseStringArrayExport(content, "up"),
+    down: parseStringArrayExport(content, "down"),
+    summary: parseStringArrayExport(content, "summary"),
+    containsBreakingChanges: parseBooleanExport(content, "containsBreakingChanges")
+  };
+}
+function parseVersionsFromMigrationId(id) {
+  const match = id.match(/-v(\d+)-to-v(\d+)$/);
+  if (!match) {
+    throw new Error(`Migration id "${id}" does not include a vX-to-vY version suffix.`);
+  }
+  return {
+    fromVersion: Number.parseInt(match[1], 10),
+    toVersion: Number.parseInt(match[2], 10)
+  };
+}
+function parseStringArrayExport(source, exportName) {
+  const expression = parseExportExpression(source, exportName);
+  const parsed = JSON.parse(expression);
+  if (!Array.isArray(parsed) || parsed.some((item) => typeof item !== "string")) {
+    throw new Error(`Migration export "${exportName}" must be a string array.`);
+  }
+  return parsed;
+}
+function parseBooleanExport(source, exportName) {
+  const expression = parseLiteralExport(source, exportName);
+  if (expression === "true") return true;
+  if (expression === "false") return false;
+  throw new Error(`Migration export "${exportName}" must be a boolean literal.`);
+}
+function parseExportExpression(source, exportName) {
+  const escapedName = exportName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const regex = new RegExp(`export const ${escapedName} = ([\\s\\S]*?) as const`);
+  const match = source.match(regex);
+  if (!match || !match[1]) {
+    throw new Error(`Failed to read migration export "${exportName}".`);
+  }
+  return match[1].trim();
+}
+function parseLiteralExport(source, exportName) {
+  const escapedName = exportName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const regex = new RegExp(`export const ${escapedName} = ([^
+\r]+)`);
+  const match = source.match(regex);
+  if (!match || !match[1]) {
+    throw new Error(`Failed to read migration export "${exportName}".`);
+  }
+  return match[1].trim();
+}
+function resolveSqliteApplyPath(dbArg, projectRoot, config) {
+  if (typeof dbArg === "string") {
+    return resolve3(projectRoot, dbArg);
+  }
+  const sync = config?.dev?.sync;
+  if (typeof sync === "object" && sync !== null) {
+    if (sync.store === "sqlite") {
+      return join3(projectRoot, "kora-sync.db");
+    }
+    if (typeof sync.store === "object" && sync.store !== null && sync.store.type === "sqlite") {
+      if (typeof sync.store.filename === "string" && sync.store.filename.length > 0) {
+        return resolve3(projectRoot, sync.store.filename);
+      }
+      return join3(projectRoot, "kora-sync.db");
+    }
+  }
+  return void 0;
+}
+function resolvePostgresConnectionString(config) {
+  const sync = config?.dev?.sync;
+  if (typeof sync !== "object" || sync === null) return void 0;
+  if (sync.store === "postgres") {
+    return process.env.DATABASE_URL;
+  }
+  if (typeof sync.store === "object" && sync.store !== null && sync.store.type === "postgres") {
+    return sync.store.connectionString;
+  }
+  return void 0;
+}
+
+// src/bin.ts
+var main = defineCommand4({
+  meta: {
+    name: "kora",
+    description: "Kora.js \u2014 Offline-first application framework"
+  },
+  subCommands: {
+    create: createCommand,
+    dev: devCommand,
+    generate: generateCommand,
+    migrate: migrateCommand
+  }
+});
+runMain(main);
+//# sourceMappingURL=bin.js.map