@korajs/cli 1.0.0-beta.1 → 1.0.0-beta.10

package/dist/bin.cjs

@@ -32,25 +32,25 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 // src/utils/fs-helpers.ts
 async function directoryExists(path) {
   try {
-    await (0, import_promises2.access)(path);
+    await (0, import_promises.access)(path);
     return true;
   } catch {
     return false;
   }
 }
 async function findProjectRoot(startDir) {
-  let current = (0, import_node_path2.resolve)(startDir ?? process.cwd());
+  let current = (0, import_node_path.resolve)(startDir ?? process.cwd());
   for (; ; ) {
-    const pkgPath = (0, import_node_path2.join)(current, "package.json");
+    const pkgPath = (0, import_node_path.join)(current, "package.json");
     try {
-      const content = await (0, import_promises2.readFile)(pkgPath, "utf-8");
+      const content = await (0, import_promises.readFile)(pkgPath, "utf-8");
       const pkg = JSON.parse(content);
       if (isKoraProject(pkg)) {
         return current;
       }
     } catch {
     }
-    const parent = (0, import_node_path2.dirname)(current);
+    const parent = (0, import_node_path.dirname)(current);
     if (parent === current) break;
     current = parent;
   }
@@ -58,14 +58,14 @@ async function findProjectRoot(startDir) {
 }
 async function findSchemaFile(projectRoot) {
   const candidates = [
-    (0, import_node_path2.join)(projectRoot, "src", "schema.ts"),
-    (0, import_node_path2.join)(projectRoot, "schema.ts"),
-    (0, import_node_path2.join)(projectRoot, "src", "schema.js"),
-    (0, import_node_path2.join)(projectRoot, "schema.js")
+    (0, import_node_path.join)(projectRoot, "src", "schema.ts"),
+    (0, import_node_path.join)(projectRoot, "schema.ts"),
+    (0, import_node_path.join)(projectRoot, "src", "schema.js"),
+    (0, import_node_path.join)(projectRoot, "schema.js")
   ];
   for (const candidate of candidates) {
     try {
-      await (0, import_promises2.access)(candidate);
+      await (0, import_promises.access)(candidate);
       return candidate;
     } catch {
     }
@@ -74,16 +74,16 @@ async function findSchemaFile(projectRoot) {
 }
 async function hasTsxInstalled(projectRoot) {
   try {
-    await (0, import_promises2.access)((0, import_node_path2.join)(projectRoot, "node_modules", "tsx", "package.json"));
+    await (0, import_promises.access)((0, import_node_path.join)(projectRoot, "node_modules", "tsx", "package.json"));
     return true;
   } catch {
     return false;
   }
 }
 async function resolveProjectBinaryEntryPoint(projectRoot, packageName, binaryName) {
-  const pkgJsonPath = (0, import_node_path2.join)(projectRoot, "node_modules", packageName, "package.json");
+  const pkgJsonPath = (0, import_node_path.join)(projectRoot, "node_modules", packageName, "package.json");
   try {
-    const content = await (0, import_promises2.readFile)(pkgJsonPath, "utf-8");
+    const content = await (0, import_promises.readFile)(pkgJsonPath, "utf-8");
     const pkg = JSON.parse(content);
     let binPath;
     if (typeof pkg.bin === "string") {
@@ -92,8 +92,8 @@ async function resolveProjectBinaryEntryPoint(projectRoot, packageName, binaryNa
       binPath = pkg.bin[binaryName];
     }
     if (!binPath) return null;
-    const fullPath = (0, import_node_path2.join)(projectRoot, "node_modules", packageName, binPath);
-    await (0, import_promises2.access)(fullPath);
+    const fullPath = (0, import_node_path.join)(projectRoot, "node_modules", packageName, binPath);
+    await (0, import_promises.access)(fullPath);
     return fullPath;
   } catch {
     return null;
@@ -108,12 +108,12 @@ function hasKoraDep(deps) {
   if (typeof deps !== "object" || deps === null) return false;
   return Object.keys(deps).some((key) => key === "kora" || key.startsWith("@korajs/"));
 }
-var import_promises2, import_node_path2;
+var import_promises, import_node_path;
 var init_fs_helpers = __esm({
   "src/utils/fs-helpers.ts"() {
     "use strict";
-    import_promises2 = require("fs/promises");
-    import_node_path2 = require("path");
+    import_promises = require("fs/promises");
+    import_node_path = require("path");
   }
 });
 
@@ -123,7 +123,7 @@ __export(schema_loader_exports, {
   loadSchemaDefinition: () => loadSchemaDefinition
 });
 async function loadSchemaDefinition(schemaPath, projectRoot) {
-  const ext = (0, import_node_path4.extname)(schemaPath);
+  const ext = (0, import_node_path5.extname)(schemaPath);
   const moduleValue = ext === ".ts" || ext === ".mts" || ext === ".cts" ? await loadTypeScriptModule(schemaPath, projectRoot) : await import(`${(0, import_node_url2.pathToFileURL)(schemaPath).href}?t=${Date.now()}-${Math.random()}`);
   return extractSchema(moduleValue);
 }
@@ -190,12 +190,12 @@ async function runCommand2(command, args, cwd) {
     });
   });
 }
-var import_node_child_process2, import_node_path4, import_node_url2;
+var import_node_child_process2, import_node_path5, import_node_url2;
 var init_schema_loader = __esm({
   "src/commands/migrate/schema-loader.ts"() {
     "use strict";
     import_node_child_process2 = require("child_process");
-    import_node_path4 = require("path");
+    import_node_path5 = require("path");
     import_node_url2 = require("url");
     init_fs_helpers();
   }
@@ -1981,13 +1981,13 @@ var spectator_manager_exports = {};
 __export(spectator_manager_exports, {
   SpectatorManager: () => SpectatorManager
 });
-var import_node_fs6, import_node_os, import_node_path27, FORWARDED_EVENTS, MAX_EVENT_BUFFER, SpectatorManager;
+var import_node_fs7, import_node_os, import_node_path28, FORWARDED_EVENTS, MAX_EVENT_BUFFER, SpectatorManager;
 var init_spectator_manager = __esm({
   "src/commands/studio/spectator-manager.ts"() {
     "use strict";
-    import_node_fs6 = require("fs");
+    import_node_fs7 = require("fs");
     import_node_os = require("os");
-    import_node_path27 = require("path");
+    import_node_path28 = require("path");
     FORWARDED_EVENTS = [
       "merge:started",
       "merge:conflict",
@@ -2001,8 +2001,8 @@ var init_spectator_manager = __esm({
     SpectatorManager = class {
       constructor(options) {
         this.options = options;
-        this.tmpDir = (0, import_node_fs6.mkdtempSync)((0, import_node_path27.join)((0, import_node_os.tmpdir)(), "kora-studio-spectator-"));
-        this.dbPath = (0, import_node_path27.join)(this.tmpDir, "spectator-replica.db");
+        this.tmpDir = (0, import_node_fs7.mkdtempSync)((0, import_node_path28.join)((0, import_node_os.tmpdir)(), "kora-studio-spectator-"));
+        this.dbPath = (0, import_node_path28.join)(this.tmpDir, "spectator-replica.db");
       }
       options;
       runtime = null;
@@ -2099,7 +2099,7 @@ var init_spectator_manager = __esm({
           this.runtime = null;
         }
         if (this.tmpDir) {
-          (0, import_node_fs6.rmSync)(this.tmpDir, { recursive: true, force: true });
+          (0, import_node_fs7.rmSync)(this.tmpDir, { recursive: true, force: true });
           this.tmpDir = null;
         }
       }
@@ -2182,13 +2182,13 @@ function summarizeEvent(type, payload) {
       return type.replace("lab:", "");
   }
 }
-var import_node_fs7, import_node_os2, import_node_path28, import_core3, DEFAULT_CHAOS, FORWARDED_EVENTS2, MAX_EVENT_BUFFER2, LabManager;
+var import_node_fs8, import_node_os2, import_node_path29, import_core3, DEFAULT_CHAOS, FORWARDED_EVENTS2, MAX_EVENT_BUFFER2, LabManager;
 var init_lab_manager = __esm({
   "src/commands/studio/lab-manager.ts"() {
     "use strict";
-    import_node_fs7 = require("fs");
+    import_node_fs8 = require("fs");
     import_node_os2 = require("os");
-    import_node_path28 = require("path");
+    import_node_path29 = require("path");
     import_core3 = require("@korajs/core");
     DEFAULT_CHAOS = {
       dropRate: 0,
@@ -2246,7 +2246,7 @@ var init_lab_manager = __esm({
       }
       async start(initialDevices = 2) {
         const harness = await this.loadHarness();
-        this.tmpDir = (0, import_node_fs7.mkdtempSync)((0, import_node_path28.join)((0, import_node_os2.tmpdir)(), "kora-studio-lab-"));
+        this.tmpDir = (0, import_node_fs8.mkdtempSync)((0, import_node_path29.join)((0, import_node_os2.tmpdir)(), "kora-studio-lab-"));
         this.server = new harness.TestServer(this.schema);
         for (let i = 0; i < initialDevices; i++) {
           await this.addDevice();
@@ -2298,7 +2298,7 @@ var init_lab_manager = __esm({
           nodeId: entry.device.getNodeId(),
           connected: entry.device.isConnected(),
           chaos: { ...entry.chaos },
-          dbPath: (0, import_node_path28.join)(this.tmpDir ?? "", `test-device-${name}.db`),
+          dbPath: (0, import_node_path29.join)(this.tmpDir ?? "", `test-device-${name}.db`),
           pendingOperations: entry.device.getSyncEngine()?.getStatus().pendingOperations ?? 0
         };
       }
@@ -2377,7 +2377,7 @@ var init_lab_manager = __esm({
         });
         this.server = null;
         if (this.tmpDir) {
-          (0, import_node_fs7.rmSync)(this.tmpDir, { recursive: true, force: true });
+          (0, import_node_fs8.rmSync)(this.tmpDir, { recursive: true, force: true });
           this.tmpDir = null;
         }
       }
@@ -2409,12 +2409,13 @@ var init_lab_manager = __esm({
 });
 
 // src/bin.ts
-var import_citty12 = require("citty");
+var import_citty13 = require("citty");
 
-// src/commands/backup/backup-command.ts
-var import_promises = require("fs/promises");
-var import_node_path = require("path");
+// src/commands/agents/agents-command.ts
+var import_promises2 = require("fs/promises");
+var import_node_path2 = require("path");
 var import_citty = require("citty");
+init_fs_helpers();
 
 // src/utils/logger.ts
 var RESET = "\x1B[0m";
@@ -2451,22 +2452,233 @@ function createLogger(options) {
     banner() {
       console.log();
       console.log(
-        color(BOLD + CYAN, "  Kora.js") + color(DIM, " \u2014 Offline-first application framework")
+        color(BOLD + CYAN, "  Kora.js") + color(DIM, ", the offline-first application framework")
       );
       console.log();
     }
   };
 }
 
+// src/commands/agents/agents-md-content.ts
+var AGENTS_FRAMEWORKS = ["react", "vue", "svelte"];
+function isAgentsFramework(value) {
+  return AGENTS_FRAMEWORKS.includes(value);
+}
+function detectFrameworkFromManifest(manifest) {
+  if (typeof manifest !== "object" || manifest === null) return null;
+  const record = manifest;
+  const deps = collectDependencyNames(record.dependencies, record.devDependencies);
+  if (deps.has("@korajs/react")) return "react";
+  if (deps.has("@korajs/vue")) return "vue";
+  if (deps.has("@korajs/svelte")) return "svelte";
+  return null;
+}
+function collectDependencyNames(...groups) {
+  const names = /* @__PURE__ */ new Set();
+  for (const group of groups) {
+    if (typeof group !== "object" || group === null) continue;
+    for (const name of Object.keys(group)) {
+      names.add(name);
+    }
+  }
+  return names;
+}
+var FRAMEWORK_BINDINGS = {
+  react: `## React bindings
+
+\`\`\`tsx
+import { KoraProvider, useCollection, useMutation, useQuery, useSyncStatus } from '@korajs/react'
+
+// Wrap the tree once near your app entry: <KoraProvider app={app}><App /></KoraProvider>
+
+const todos = useCollection('todos')
+const rows = useQuery(todos.where({ completed: false }).orderBy('createdAt'))
+const addTodo = useMutation((data) => todos.insert(data))
+addTodo.mutate({ title: 'x' })                // fire-and-forget; errors land in addTodo.error
+await addTodo.mutateAsync({ title: 'x' })     // resolves with the result; throws on failure
+const status = useSyncStatus()                // status.status, status.pendingOperations
+\`\`\`
+
+Rules: always render \`mutation.error\` somewhere. Keep \`<StrictMode>\` in place; the hooks are StrictMode-safe. \`useQuery\` returns data synchronously from the local store, so do not add loading spinners for local reads.`,
+  vue: `## Vue bindings
+
+\`\`\`ts
+import { useCollection, useMutation, useQuery, useSyncStatus } from '@korajs/vue'
+
+const todos = useCollection('todos')
+const rows = useQuery(todos.where({ completed: false }).orderBy('createdAt'))  // readonly reactive ref
+const addTodo = useMutation((data) => todos.insert(data))
+addTodo.mutate({ title: 'x' })                // fire-and-forget; errors land in addTodo.error
+const status = useSyncStatus()                // status.status, status.pendingOperations
+\`\`\`
+
+Rules: surface the mutation's error state in the UI. \`useQuery\` reads synchronously from the local store, so avoid loading spinners for local data. The Kora context comes from \`KoraProvider\`, wired in your app entry (for example \`src/main.ts\`).`,
+  svelte: `## Svelte bindings
+
+Kora's Svelte bindings from \`@korajs/svelte\` expose \`useCollection\`, \`useQuery\`, \`useMutation\`, and \`useSyncStatus\`, wired through the provider set up in your app entry.
+
+\`\`\`ts
+import { useCollection, useMutation, useQuery, useSyncStatus } from '@korajs/svelte'
+
+const todos = useCollection('todos')
+const rows = useQuery(todos.where({ completed: false }).orderBy('createdAt'))  // reactive store
+const addTodo = useMutation((data) => todos.insert(data))
+addTodo.mutate({ title: 'x' })                // fire-and-forget; errors land in addTodo.error
+const status = useSyncStatus()                // readable store; read $status.status in markup
+\`\`\`
+
+Rules: queries are reactive stores that read synchronously from the local database, so avoid loading spinners for local reads. Mutations expose an \`error\` state that must be surfaced in the UI.`
+};
+function generateAgentsMd(framework) {
+  return `# AGENTS.md
+
+Guidance for AI coding agents working in this project. Humans: this is useful for you too.
+
+## What this project is
+
+This project uses **Kora.js**, an offline-first application framework. All application data lives in a local SQLite database (WASM + OPFS in the browser, native SQLite on desktop and server) and optionally syncs across devices through a Kora sync server. Offline is the normal state, not an error state. Full docs live at https://korajs.dev, with a machine-readable index at https://korajs.dev/llms.txt and the complete docs in one file at https://korajs.dev/llms-full.txt. Any documentation page is available as raw markdown by appending \`.md\` to its URL.
+
+## Golden rules
+
+1. **The schema is the source of truth.** Collections are defined with \`defineSchema\` and the \`t.*\` field builders (by convention in \`src/schema.ts\`). To add or change data shapes, edit the schema first; types flow from it automatically. Never hand-write types for records.
+2. **Never fetch application data over HTTP.** Do not add REST or GraphQL calls for app data, and do not talk to the sync server directly. Read and write through Kora collections only; sync happens automatically in the background.
+3. **Await readiness before direct collection access.** Outside the UI bindings, \`await app.ready\` before calling \`app.<collection>\` methods. The framework bindings handle this for you inside components.
+4. **Offline must keep working.** Any feature you add must function with the network off. Never gate a read or write on connectivity. If you are checking \`navigator.onLine\` before a data operation, you are doing it wrong.
+5. **Surface mutation errors.** Fire-and-forget \`mutate\` calls fold errors into the mutation state. Always render the mutation's \`error\`, or handle the promise from the \`mutateAsync\` variant. Silent failure is the worst failure.
+6. **Do not add a state library for server or app data.** Kora's reactive queries are the store. Do not reach for react-query, SWR, Redux, Zustand, or similar for data that lives in a collection. Local UI state (form inputs, toggles) can use your framework's normal state tools.
+7. **Do not add loading spinners for local reads.** \`useQuery\` returns data synchronously from the local store, so there is no loading state to wait on for local data.
+
+## Data API cheat sheet
+
+\`\`\`ts
+await app.ready
+const rec = await app.todos.insert({ title: 'x' })   // defaults and .auto() fields applied
+await app.todos.update(rec.id, { completed: true })  // partial update, changed fields only
+await app.todos.delete(rec.id)
+const one = await app.todos.findById(rec.id)
+const unsubscribe = app.todos
+  .where({ completed: false })
+  .orderBy('createdAt', 'desc')
+  .subscribe((rows) => {/* fires immediately, then on every change */})
+\`\`\`
+
+Schema example (\`src/schema.ts\`):
+
+\`\`\`ts
+import { defineSchema, t } from 'korajs'
+
+export default defineSchema({
+  version: 1,
+  collections: {
+    todos: {
+      fields: {
+        title: t.string(),
+        completed: t.boolean().default(false),
+        tags: t.array(t.string()).default([]),
+        priority: t.enum(['low', 'medium', 'high']).default('medium'),
+        createdAt: t.timestamp().auto(), // set automatically; never pass it on insert
+      },
+      indexes: ['completed', 'createdAt'],
+    },
+  },
+})
+\`\`\`
+
+If you change collection shapes, increment \`version\` and run \`npx kora migrate\`.
+
+## Conflict handling
+
+Concurrent edits merge automatically: last-write-wins per field, add-wins for arrays, and character-level CRDT for \`t.richtext()\` fields. When a field needs domain-specific merging (counters, quantities), add a \`resolve\` function in the schema rather than writing sync logic by hand. Never write your own conflict or merge code.
+
+## Sync and auth
+
+Enable sync by adding one line to \`createApp\`: \`createApp({ schema, sync: { url } })\`. When the app is offline, writes queue locally and sync when connectivity returns. If the project uses \`@korajs/auth\`, pass its client as \`createApp({ schema, sync: { url, authClient } })\`. Local writes work without sign-in; sync requires the server to accept the connection.
+
+${FRAMEWORK_BINDINGS[framework]}
+
+## Commands
+
+- \`npx kora dev\` runs the dev environment (app server, local sync server when configured, schema watcher).
+- \`npx kora doctor\` diagnoses a broken setup.
+- \`npx kora migrate\` applies a schema change to the local store.
+- In a running app, the DevTools overlay (Ctrl+Shift+K, Cmd+Shift+K on macOS) inspects operations, merges, and sync status.
+`;
+}
+
+// src/commands/agents/agents-command.ts
+async function fileExists(path) {
+  try {
+    await (0, import_promises2.access)(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function readManifest(root) {
+  try {
+    return JSON.parse(await (0, import_promises2.readFile)((0, import_node_path2.join)(root, "package.json"), "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function resolveFramework(override, manifest) {
+  if (override !== void 0 && isAgentsFramework(override)) return override;
+  return detectFrameworkFromManifest(manifest) ?? "react";
+}
+var agentsCommand = (0, import_citty.defineCommand)({
+  meta: {
+    name: "agents-md",
+    description: "Write an AGENTS.md with Kora rules for AI coding agents into this project"
+  },
+  args: {
+    force: {
+      type: "boolean",
+      description: "Overwrite an existing AGENTS.md",
+      default: false
+    },
+    framework: {
+      type: "string",
+      description: "Override framework detection (react, vue, or svelte)"
+    }
+  },
+  async run({ args }) {
+    const logger = createLogger();
+    const projectRoot = await findProjectRoot() ?? process.cwd();
+    const manifest = await readManifest(projectRoot);
+    const override = typeof args.framework === "string" ? args.framework : void 0;
+    if (override !== void 0 && !isAgentsFramework(override)) {
+      logger.error(`Unknown framework "${override}". Use one of: react, vue, svelte.`);
+      process.exitCode = 1;
+      return;
+    }
+    const framework = resolveFramework(override, manifest);
+    const target = (0, import_node_path2.join)(projectRoot, "AGENTS.md");
+    const force = args.force === true;
+    if (await fileExists(target) && !force) {
+      logger.warn("AGENTS.md already exists. Re-run with --force to overwrite it.");
+      process.exitCode = 1;
+      return;
+    }
+    await (0, import_promises2.writeFile)(target, generateAgentsMd(framework), "utf-8");
+    logger.banner();
+    logger.success(`Wrote AGENTS.md (${framework} bindings) to ${target}`);
+    logger.step("Commit it so coding agents pick up Kora conventions automatically.");
+    logger.blank();
+  }
+});
+
 // src/commands/backup/backup-command.ts
+var import_promises3 = require("fs/promises");
+var import_node_path3 = require("path");
+var import_citty2 = require("citty");
 var DEFAULT_SYNC_PORT = 3001;
-var backupCommand = (0, import_citty.defineCommand)({
+var backupCommand = (0, import_citty2.defineCommand)({
   meta: {
     name: "backup",
     description: "Backup and restore Kora sync server data"
   },
   subCommands: {
-    create: (0, import_citty.defineCommand)({
+    create: (0, import_citty2.defineCommand)({
       meta: {
         name: "create",
         description: "Create a backup of the sync server"
@@ -2506,7 +2718,7 @@ var backupCommand = (0, import_citty.defineCommand)({
             );
           }
           const buffer = await response.arrayBuffer();
-          await (0, import_promises.writeFile)(outFile, new Uint8Array(buffer));
+          await (0, import_promises3.writeFile)(outFile, new Uint8Array(buffer));
           const size = (buffer.byteLength / 1024).toFixed(1);
           logger.success(`Backup saved to ${outFile} (${size} KB)`);
         } catch (error) {
@@ -2518,7 +2730,7 @@ var backupCommand = (0, import_citty.defineCommand)({
         }
       }
     }),
-    restore: (0, import_citty.defineCommand)({
+    restore: (0, import_citty2.defineCommand)({
       meta: {
         name: "restore",
         description: "Restore a backup to the sync server"
@@ -2553,7 +2765,7 @@ var backupCommand = (0, import_citty.defineCommand)({
         logger.banner();
         logger.info(`Restoring backup from ${filePath} to ${url}...`);
         try {
-          const data = await (0, import_promises.readFile)(filePath);
+          const data = await (0, import_promises3.readFile)(filePath);
           const restoreUrl = `${url.replace(/\/$/, "")}/__kora/backup/import?merge=${merge}`;
           const response = await fetch(restoreUrl, {
             method: "POST",
@@ -2581,7 +2793,7 @@ var backupCommand = (0, import_citty.defineCommand)({
         }
       }
     }),
-    info: (0, import_citty.defineCommand)({
+    info: (0, import_citty2.defineCommand)({
       meta: {
         name: "info",
         description: "Show backup file information"
@@ -2597,7 +2809,7 @@ var backupCommand = (0, import_citty.defineCommand)({
         const logger = createLogger();
         const filePath = typeof args.file === "string" ? args.file : "";
         try {
-          const data = await (0, import_promises.readFile)(filePath);
+          const data = await (0, import_promises3.readFile)(filePath);
           const { readBackupManifest } = await import("@korajs/store");
           const manifest = readBackupManifest(
             new Uint8Array(data.buffer, data.byteOffset, data.byteLength)
@@ -2624,8 +2836,8 @@ var backupCommand = (0, import_citty.defineCommand)({
 });
 
 // src/commands/compact/compact-command.ts
-var import_node_path5 = require("path");
-var import_citty2 = require("citty");
+var import_node_path6 = require("path");
+var import_citty3 = require("citty");
 
 // src/errors.ts
 var import_core = require("@korajs/core");
@@ -2685,8 +2897,8 @@ init_fs_helpers();
 
 // src/commands/dev/kora-config.ts
 var import_node_child_process = require("child_process");
-var import_promises3 = require("fs/promises");
-var import_node_path3 = require("path");
+var import_promises4 = require("fs/promises");
+var import_node_path4 = require("path");
 var import_node_url = require("url");
 init_fs_helpers();
 var CONFIG_CANDIDATES = [
@@ -2700,7 +2912,7 @@ var CONFIG_CANDIDATES = [
 async function loadKoraConfig(projectRoot) {
   const configPath = await findKoraConfigFile(projectRoot);
   if (!configPath) return null;
-  const ext = (0, import_node_path3.extname)(configPath);
+  const ext = (0, import_node_path4.extname)(configPath);
   if (ext === ".ts" || ext === ".mts" || ext === ".cts") {
     const loaded2 = await loadTypeScriptConfig(configPath, projectRoot);
     return toConfigObject(loaded2);
@@ -2710,9 +2922,9 @@ async function loadKoraConfig(projectRoot) {
 }
 async function findKoraConfigFile(projectRoot) {
   for (const file of CONFIG_CANDIDATES) {
-    const candidate = (0, import_node_path3.join)(projectRoot, file);
+    const candidate = (0, import_node_path4.join)(projectRoot, file);
     try {
-      await (0, import_promises3.access)(candidate);
+      await (0, import_promises4.access)(candidate);
       return candidate;
     } catch {
     }
@@ -2777,7 +2989,7 @@ function toConfigObject(mod) {
 
 // src/commands/compact/compact-command.ts
 init_schema_loader();
-var compactCommand = (0, import_citty2.defineCommand)({
+var compactCommand = (0, import_citty3.defineCommand)({
   meta: {
     name: "compact",
     description: "Compact the local Kora operation log after server ack"
@@ -2808,12 +3020,12 @@ var compactCommand = (0, import_citty2.defineCommand)({
     if (!projectRoot) {
       throw new InvalidProjectError(process.cwd());
     }
-    const dbPath = typeof args.db === "string" ? (0, import_node_path5.resolve)(projectRoot, args.db) : void 0;
+    const dbPath = typeof args.db === "string" ? (0, import_node_path6.resolve)(projectRoot, args.db) : void 0;
     if (!dbPath) {
       throw new Error("Missing --db <path> to the local SQLite database file.");
     }
     const config = await loadKoraConfig(projectRoot);
-    const schemaPath = typeof args.schema === "string" ? (0, import_node_path5.resolve)(projectRoot, args.schema) : typeof config?.schema === "string" ? (0, import_node_path5.resolve)(projectRoot, config.schema) : void 0;
+    const schemaPath = typeof args.schema === "string" ? (0, import_node_path6.resolve)(projectRoot, args.schema) : typeof config?.schema === "string" ? (0, import_node_path6.resolve)(projectRoot, config.schema) : void 0;
     if (!schemaPath) {
       throw new Error("Could not resolve schema path. Pass --schema <path>.");
     }
@@ -2850,9 +3062,9 @@ var compactCommand = (0, import_citty2.defineCommand)({
 // src/commands/create/create-command.ts
 var import_node_child_process4 = require("child_process");
 var import_node_fs2 = require("fs");
-var import_node_path9 = require("path");
+var import_node_path10 = require("path");
 var import_node_url4 = require("url");
-var import_citty3 = require("citty");
+var import_citty4 = require("citty");
 
 // src/prompts/preferences.ts
 var import_conf = __toESM(require("conf"), 1);
@@ -3099,8 +3311,8 @@ function getRunDevCommand(pm) {
 }
 
 // src/commands/create/environment-detection.ts
-var import_promises4 = require("fs/promises");
-var import_node_path6 = require("path");
+var import_promises5 = require("fs/promises");
+var import_node_path7 = require("path");
 function detectEditorFromEnvironment(env = process.env) {
   const termProgram = String(env.TERM_PROGRAM ?? "").toLowerCase();
   const editorValue = `${String(env.EDITOR ?? "")} ${String(env.VISUAL ?? "")}`.toLowerCase();
@@ -3126,18 +3338,18 @@ async function detectGitContext(startDir) {
   };
 }
 async function detectMonorepoContext(startDir) {
-  let current = (0, import_node_path6.resolve)(startDir);
+  let current = (0, import_node_path7.resolve)(startDir);
   for (; ; ) {
-    if (await fileExists((0, import_node_path6.join)(current, "pnpm-workspace.yaml"))) {
+    if (await fileExists2((0, import_node_path7.join)(current, "pnpm-workspace.yaml"))) {
       return { isMonorepo: true, root: current, kind: "pnpm-workspace" };
     }
-    if (await fileExists((0, import_node_path6.join)(current, "turbo.json"))) {
+    if (await fileExists2((0, import_node_path7.join)(current, "turbo.json"))) {
       return { isMonorepo: true, root: current, kind: "turborepo" };
     }
-    const packageJsonPath = (0, import_node_path6.join)(current, "package.json");
-    if (await fileExists(packageJsonPath)) {
+    const packageJsonPath = (0, import_node_path7.join)(current, "package.json");
+    if (await fileExists2(packageJsonPath)) {
       try {
-        const packageJsonRaw = await (0, import_promises4.readFile)(packageJsonPath, "utf-8");
+        const packageJsonRaw = await (0, import_promises5.readFile)(packageJsonPath, "utf-8");
         const parsed = JSON.parse(packageJsonRaw);
         if (Array.isArray(parsed.workspaces) || isNpmWorkspaceObject(parsed.workspaces)) {
           return { isMonorepo: true, root: current, kind: "npm-workspaces" };
@@ -3145,7 +3357,7 @@ async function detectMonorepoContext(startDir) {
       } catch {
       }
     }
-    const parent = (0, import_node_path6.dirname)(current);
+    const parent = (0, import_node_path7.dirname)(current);
     if (parent === current) {
       return { isMonorepo: false, root: null, kind: "none" };
     }
@@ -3157,9 +3369,9 @@ async function applyEditorWorkspacePreset(params) {
   if (editor !== "vscode" && editor !== "cursor" && editor !== "windsurf") {
     return { applied: false, filePath: null };
   }
-  const vscodeDir = (0, import_node_path6.join)(targetDir, ".vscode");
-  const extensionsPath = (0, import_node_path6.join)(vscodeDir, "extensions.json");
-  await (0, import_promises4.mkdir)(vscodeDir, { recursive: true });
+  const vscodeDir = (0, import_node_path7.join)(targetDir, ".vscode");
+  const extensionsPath = (0, import_node_path7.join)(vscodeDir, "extensions.json");
+  await (0, import_promises5.mkdir)(vscodeDir, { recursive: true });
   const recommendations = ["korajs.kora-devtools"];
   const existing = await readJsonObject(extensionsPath);
   const existingRecommendations = Array.isArray(existing?.recommendations) ? existing.recommendations.filter((item) => typeof item === "string") : [];
@@ -3167,19 +3379,19 @@ async function applyEditorWorkspacePreset(params) {
   const next = {
     recommendations: mergedRecommendations
   };
-  await (0, import_promises4.writeFile)(extensionsPath, `${JSON.stringify(next, null, 2)}
+  await (0, import_promises5.writeFile)(extensionsPath, `${JSON.stringify(next, null, 2)}
 `, "utf-8");
   return { applied: true, filePath: extensionsPath };
 }
 function resolveMonorepoTargetDirectory(monorepoRoot, projectName) {
-  return (0, import_node_path6.join)(monorepoRoot, "packages", projectName);
+  return (0, import_node_path7.join)(monorepoRoot, "packages", projectName);
 }
 function dedupeStrings(values) {
   return Array.from(new Set(values));
 }
 async function readJsonObject(path) {
   try {
-    const content = await (0, import_promises4.readFile)(path, "utf-8");
+    const content = await (0, import_promises5.readFile)(path, "utf-8");
     const parsed = JSON.parse(content);
     if (typeof parsed === "object" && parsed !== null) {
       return parsed;
@@ -3194,24 +3406,24 @@ function isNpmWorkspaceObject(value) {
   const record = value;
   return Array.isArray(record.packages);
 }
-async function fileExists(path) {
+async function fileExists2(path) {
   try {
-    await (0, import_promises4.access)(path);
+    await (0, import_promises5.access)(path);
     return true;
   } catch {
     return false;
   }
 }
 async function findNearestAncestorWithEntry(startDir, entryName) {
-  let current = (0, import_node_path6.resolve)(startDir);
+  let current = (0, import_node_path7.resolve)(startDir);
   for (; ; ) {
-    const candidate = (0, import_node_path6.join)(current, entryName);
+    const candidate = (0, import_node_path7.join)(current, entryName);
     try {
-      await (0, import_promises4.stat)(candidate);
+      await (0, import_promises5.stat)(candidate);
       return current;
     } catch {
     }
-    const parent = (0, import_node_path6.dirname)(current);
+    const parent = (0, import_node_path7.dirname)(current);
     if (parent === current) {
       return null;
     }
@@ -3490,8 +3702,8 @@ function validateProjectName(name) {
 }
 
 // src/commands/create/sync-provider-preset.ts
-var import_promises5 = require("fs/promises");
-var import_node_path7 = require("path");
+var import_promises6 = require("fs/promises");
+var import_node_path8 = require("path");
 async function applySyncProviderPreset(options) {
   if (!isSyncTemplate(options.template)) {
     return;
@@ -3501,10 +3713,10 @@ async function applySyncProviderPreset(options) {
   }
   const providerName = getProviderDisplayName(options.dbProvider);
   const providerConnectionString = getProviderConnectionStringExample(options.dbProvider);
-  const envPath = (0, import_node_path7.join)(options.targetDir, ".env.example");
-  const readmePath = (0, import_node_path7.join)(options.targetDir, "README.md");
-  const existingReadme = await (0, import_promises5.readFile)(readmePath, "utf-8");
-  const existingEnv = await (0, import_promises5.readFile)(envPath, "utf-8");
+  const envPath = (0, import_node_path8.join)(options.targetDir, ".env.example");
+  const readmePath = (0, import_node_path8.join)(options.targetDir, "README.md");
+  const existingReadme = await (0, import_promises6.readFile)(readmePath, "utf-8");
+  const existingEnv = await (0, import_promises6.readFile)(envPath, "utf-8");
   const trimmedReadme = existingReadme.trimEnd();
   const trimmedEnv = existingEnv.trimEnd();
   const envSuffix = [
@@ -3524,9 +3736,9 @@ async function applySyncProviderPreset(options) {
     ""
   ].join("\n");
   const readmeTemplate = `${trimmedReadme}${readmeSuffix}`;
-  await (0, import_promises5.writeFile)(envPath, `${trimmedEnv}${envSuffix}
+  await (0, import_promises6.writeFile)(envPath, `${trimmedEnv}${envSuffix}
 `, "utf-8");
-  await (0, import_promises5.writeFile)(readmePath, readmeTemplate, "utf-8");
+  await (0, import_promises6.writeFile)(readmePath, readmeTemplate, "utf-8");
 }
 function isSyncTemplate(template) {
   return template === "react-sync" || template === "react-tailwind-sync" || template === "vue-sync" || template === "vue-tailwind-sync" || template === "svelte-sync" || template === "svelte-tailwind-sync" || template === "tauri-react";
@@ -3570,8 +3782,8 @@ function getProviderConnectionStringExample(provider) {
 
 // src/templates/composer.ts
 var import_node_fs = require("fs");
-var import_promises6 = require("fs/promises");
-var import_node_path8 = require("path");
+var import_promises7 = require("fs/promises");
+var import_node_path9 = require("path");
 var import_node_url3 = require("url");
 var import_meta = {};
 function substituteVariables(template, context) {
@@ -3581,16 +3793,16 @@ function substituteVariables(template, context) {
   });
 }
 function getTemplatePath(templateName) {
-  let dir = (0, import_node_path8.dirname)((0, import_node_url3.fileURLToPath)(import_meta.url));
+  let dir = (0, import_node_path9.dirname)((0, import_node_url3.fileURLToPath)(import_meta.url));
   for (let i = 0; i < 7; i++) {
-    const candidate = (0, import_node_path8.resolve)(dir, "templates", templateName);
+    const candidate = (0, import_node_path9.resolve)(dir, "templates", templateName);
     if ((0, import_node_fs.existsSync)(candidate)) {
       return candidate;
     }
-    dir = (0, import_node_path8.dirname)(dir);
+    dir = (0, import_node_path9.dirname)(dir);
   }
-  const currentDir = (0, import_node_path8.dirname)((0, import_node_url3.fileURLToPath)(import_meta.url));
-  return (0, import_node_path8.resolve)(currentDir, "..", "..", "..", "templates", templateName);
+  const currentDir = (0, import_node_path9.dirname)((0, import_node_url3.fileURLToPath)(import_meta.url));
+  return (0, import_node_path9.resolve)(currentDir, "..", "..", "..", "templates", templateName);
 }
 function createCompatibilityLayerPlan(templateName) {
   const baseLayer = { category: "base", name: "base", sourceTemplate: "react-basic" };
@@ -3723,22 +3935,22 @@ async function composeTemplateLayers(plan, targetDir, context) {
   }
 }
 async function copyDirectory(src, dest, vars) {
-  await (0, import_promises6.mkdir)(dest, { recursive: true });
-  const entries = await (0, import_promises6.readdir)(src);
+  await (0, import_promises7.mkdir)(dest, { recursive: true });
+  const entries = await (0, import_promises7.readdir)(src);
   for (const entry of entries) {
-    const srcPath = (0, import_node_path8.join)(src, entry);
-    const srcStat = await (0, import_promises6.stat)(srcPath);
+    const srcPath = (0, import_node_path9.join)(src, entry);
+    const srcStat = await (0, import_promises7.stat)(srcPath);
     if (srcStat.isDirectory()) {
-      await copyDirectory(srcPath, (0, import_node_path8.join)(dest, entry), vars);
+      await copyDirectory(srcPath, (0, import_node_path9.join)(dest, entry), vars);
       continue;
     }
     if (entry.endsWith(".hbs")) {
-      const content = await (0, import_promises6.readFile)(srcPath, "utf-8");
+      const content = await (0, import_promises7.readFile)(srcPath, "utf-8");
       const outputName = entry.slice(0, -4);
-      await (0, import_promises6.writeFile)((0, import_node_path8.join)(dest, outputName), substituteVariables(content, vars), "utf-8");
+      await (0, import_promises7.writeFile)((0, import_node_path9.join)(dest, outputName), substituteVariables(content, vars), "utf-8");
       continue;
     }
-    await (0, import_promises6.copyFile)(srcPath, (0, import_node_path8.join)(dest, entry));
+    await (0, import_promises7.copyFile)(srcPath, (0, import_node_path9.join)(dest, entry));
   }
 }
 
@@ -3750,7 +3962,7 @@ async function scaffoldTemplate(templateName, targetDir, context) {
 
 // src/commands/create/create-command.ts
 var import_meta2 = {};
-var createCommand = (0, import_citty3.defineCommand)({
+var createCommand = (0, import_citty4.defineCommand)({
   meta: {
     name: "create",
     description: "Create a new Kora application"
@@ -3891,7 +4103,7 @@ var createCommand = (0, import_citty3.defineCommand)({
       const editorDetection = detectEditorFromEnvironment();
       const gitContext = await detectGitContext(process.cwd());
       const monorepoContext = await detectMonorepoContext(process.cwd());
-      let targetDir = (0, import_node_path9.resolve)(process.cwd(), projectName);
+      let targetDir = (0, import_node_path10.resolve)(process.cwd(), projectName);
       if (!useDefaults && monorepoContext.isMonorepo && monorepoContext.root !== null) {
         const useWorkspaceTarget = await prompts.confirm(
           `Detected ${formatMonorepoKind(monorepoContext.kind)} at ${monorepoContext.root}. Create app under packages/${projectName}?`,
@@ -4061,29 +4273,33 @@ function relativeToTarget(targetDir, filePath) {
 }
 function resolveKoraVersion() {
   try {
-    let dir = (0, import_node_path9.dirname)((0, import_node_url4.fileURLToPath)(import_meta2.url));
+    let dir = (0, import_node_path10.dirname)((0, import_node_url4.fileURLToPath)(import_meta2.url));
     for (let i = 0; i < 5; i++) {
-      const pkgPath = (0, import_node_path9.resolve)(dir, "package.json");
+      const pkgPath = (0, import_node_path10.resolve)(dir, "package.json");
       if ((0, import_node_fs2.existsSync)(pkgPath)) {
         const pkg = JSON.parse((0, import_node_fs2.readFileSync)(pkgPath, "utf-8"));
         if (pkg.name === "@korajs/cli") {
-          if (pkg.version === "0.0.0") return "latest";
-          const parts = pkg.version.split(".");
-          return `^${parts[0]}.${parts[1]}.0`;
+          return deriveKoraTemplateVersion(pkg.version);
         }
       }
-      dir = (0, import_node_path9.dirname)(dir);
+      dir = (0, import_node_path10.dirname)(dir);
     }
     return "latest";
   } catch {
     return "latest";
   }
 }
+function deriveKoraTemplateVersion(version) {
+  if (version === "0.0.0") return "latest";
+  if (version.includes("-")) return version;
+  const parts = version.split(".");
+  return `^${parts[0]}.${parts[1]}.0`;
+}
 
 // src/commands/deploy/deploy-command.ts
 var import_node_fs4 = require("fs");
-var import_node_path20 = require("path");
-var import_citty4 = require("citty");
+var import_node_path21 = require("path");
+var import_citty5 = require("citty");
 init_fs_helpers();
 
 // src/commands/deploy/adapters/adapter.ts
@@ -4102,13 +4318,13 @@ function isDeployPlatform(value) {
 
 // src/commands/deploy/adapters/aws-ecs-adapter.ts
 var import_node_child_process6 = require("child_process");
-var import_node_path12 = require("path");
+var import_node_path13 = require("path");
 
 // src/commands/deploy/builder/client-builder.ts
 var import_node_child_process5 = require("child_process");
 var import_node_fs3 = require("fs");
-var import_promises7 = require("fs/promises");
-var import_node_path10 = require("path");
+var import_promises8 = require("fs/promises");
+var import_node_path11 = require("path");
 init_fs_helpers();
 async function buildClient(options) {
   const viteEntryPoint = await resolveProjectBinaryEntryPoint(options.projectRoot, "vite", "vite");
@@ -4130,15 +4346,15 @@ async function buildClient(options) {
   return { outDir: options.outDir };
 }
 async function patchSqliteWasmAssets(projectRoot, outDir) {
-  const assetsDir = (0, import_node_path10.join)(outDir, "assets");
+  const assetsDir = (0, import_node_path11.join)(outDir, "assets");
   if (!(0, import_node_fs3.existsSync)(assetsDir)) return;
-  const files = await (0, import_promises7.readdir)(assetsDir);
+  const files = await (0, import_promises8.readdir)(assetsDir);
   const hashedWasm = files.find((f) => /^sqlite3-.+\.wasm$/.test(f));
   if (hashedWasm && !files.includes("sqlite3.wasm")) {
-    await (0, import_promises7.copyFile)((0, import_node_path10.join)(assetsDir, hashedWasm), (0, import_node_path10.join)(assetsDir, "sqlite3.wasm"));
+    await (0, import_promises8.copyFile)((0, import_node_path11.join)(assetsDir, hashedWasm), (0, import_node_path11.join)(assetsDir, "sqlite3.wasm"));
   }
   if (!files.includes("sqlite3-opfs-async-proxy.js")) {
-    const proxyFile = (0, import_node_path10.resolve)(
+    const proxyFile = (0, import_node_path11.resolve)(
       projectRoot,
       "node_modules",
       "@sqlite.org",
@@ -4148,7 +4364,7 @@ async function patchSqliteWasmAssets(projectRoot, outDir) {
       "sqlite3-opfs-async-proxy.js"
     );
     if ((0, import_node_fs3.existsSync)(proxyFile)) {
-      await (0, import_promises7.copyFile)(proxyFile, (0, import_node_path10.join)(assetsDir, "sqlite3-opfs-async-proxy.js"));
+      await (0, import_promises8.copyFile)(proxyFile, (0, import_node_path11.join)(assetsDir, "sqlite3-opfs-async-proxy.js"));
     }
   }
 }
@@ -4173,9 +4389,9 @@ async function runProcess(command, args, cwd) {
 }
 
 // src/commands/deploy/builder/server-bundler.ts
-var import_promises8 = require("fs/promises");
 var import_promises9 = require("fs/promises");
-var import_node_path11 = require("path");
+var import_promises10 = require("fs/promises");
+var import_node_path12 = require("path");
 var import_esbuild = require("esbuild");
 var DEFAULT_ENTRY_CANDIDATES = [
   "server.ts",
@@ -4191,8 +4407,8 @@ async function bundleServer(options) {
       `Could not find a server entry file in ${options.projectRoot}. Looked for: ${candidates.join(", ")}`
     );
   }
-  await (0, import_promises8.mkdir)(options.deployDirectory, { recursive: true });
-  const outputFilePath = (0, import_node_path11.join)(options.deployDirectory, "server-bundled.js");
+  await (0, import_promises9.mkdir)(options.deployDirectory, { recursive: true });
+  const outputFilePath = (0, import_node_path12.join)(options.deployDirectory, "server-bundled.js");
   await (0, import_esbuild.build)({
     entryPoints: [entryFilePath],
     outfile: outputFilePath,
@@ -4214,9 +4430,9 @@ async function bundleServer(options) {
 }
 async function resolveServerEntry(projectRoot, candidates) {
   for (const candidate of candidates) {
-    const fullPath = (0, import_node_path11.join)(projectRoot, candidate);
+    const fullPath = (0, import_node_path12.join)(projectRoot, candidate);
     try {
-      await (0, import_promises9.access)(fullPath);
+      await (0, import_promises10.access)(fullPath);
       return fullPath;
     } catch {
     }
@@ -4318,19 +4534,19 @@ var AwsEcsAdapter = class {
       appName: config.appName,
       region: config.region
     };
-    const deployDirectory = (0, import_node_path12.join)(config.projectRoot, ".kora", "deploy");
+    const deployDirectory = (0, import_node_path13.join)(config.projectRoot, ".kora", "deploy");
     await bundleServer({
       projectRoot: config.projectRoot,
       deployDirectory
     });
     const client = config.deployTarget === "sync-server" ? null : await buildClient({
       projectRoot: config.projectRoot,
-      outDir: (0, import_node_path12.join)(deployDirectory, "dist"),
+      outDir: (0, import_node_path13.join)(deployDirectory, "dist"),
       mode: "production"
     });
     return {
       clientDirectory: client?.outDir ?? null,
-      serverBundlePath: (0, import_node_path12.join)(deployDirectory, "server-bundled.js"),
+      serverBundlePath: (0, import_node_path13.join)(deployDirectory, "server-bundled.js"),
       deployDirectory
     };
   }
@@ -4596,7 +4812,7 @@ function inferLogLevel(line) {
 
 // src/commands/deploy/adapters/aws-lightsail-adapter.ts
 var import_node_child_process7 = require("child_process");
-var import_node_path13 = require("path");
+var import_node_path14 = require("path");
 var AwsLightsailAdapter = class {
   name = "aws-lightsail";
   logger = createLogger();
@@ -4669,19 +4885,19 @@ var AwsLightsailAdapter = class {
       appName: config.appName,
       region: config.region
     };
-    const deployDirectory = (0, import_node_path13.join)(config.projectRoot, ".kora", "deploy");
+    const deployDirectory = (0, import_node_path14.join)(config.projectRoot, ".kora", "deploy");
     await bundleServer({
       projectRoot: config.projectRoot,
       deployDirectory
     });
     const client = config.deployTarget === "sync-server" ? null : await buildClient({
       projectRoot: config.projectRoot,
-      outDir: (0, import_node_path13.join)(deployDirectory, "dist"),
+      outDir: (0, import_node_path14.join)(deployDirectory, "dist"),
       mode: "production"
     });
     return {
       clientDirectory: client?.outDir ?? null,
-      serverBundlePath: (0, import_node_path13.join)(deployDirectory, "server-bundled.js"),
+      serverBundlePath: (0, import_node_path14.join)(deployDirectory, "server-bundled.js"),
       deployDirectory
     };
   }
@@ -4981,11 +5197,11 @@ function inferLogLevel2(line) {
 
 // src/commands/deploy/adapters/fly-adapter.ts
 var import_node_child_process8 = require("child_process");
-var import_node_path15 = require("path");
+var import_node_path16 = require("path");
 
 // src/commands/deploy/artifacts/fly-toml-generator.ts
-var import_promises10 = require("fs/promises");
-var import_node_path14 = require("path");
+var import_promises11 = require("fs/promises");
+var import_node_path15 = require("path");
 var GENERATED_HEADER = "# Generated by kora deploy \u2014 do not edit manually";
 function generateFlyToml(options) {
   const internalPort = options.internalPort ?? 3e3;
@@ -5015,9 +5231,9 @@ function generateFlyToml(options) {
   ].join("\n");
 }
 async function writeFlyTomlArtifact(deployDirectory, options) {
-  await (0, import_promises10.mkdir)(deployDirectory, { recursive: true });
-  const filePath = (0, import_node_path14.join)(deployDirectory, "fly.toml");
-  await (0, import_promises10.writeFile)(filePath, generateFlyToml(options), "utf-8");
+  await (0, import_promises11.mkdir)(deployDirectory, { recursive: true });
+  const filePath = (0, import_node_path15.join)(deployDirectory, "fly.toml");
+  await (0, import_promises11.writeFile)(filePath, generateFlyToml(options), "utf-8");
   return filePath;
 }
 
@@ -5111,7 +5327,7 @@ var FlyAdapter = class {
       appName: config.appName,
       region: config.region
     };
-    const deployDirectory = (0, import_node_path15.join)(config.projectRoot, ".kora", "deploy");
+    const deployDirectory = (0, import_node_path16.join)(config.projectRoot, ".kora", "deploy");
     await writeFlyTomlArtifact(deployDirectory, {
       appName: config.appName,
       region: config.region ?? "iad"
@@ -5122,12 +5338,12 @@ var FlyAdapter = class {
     });
     const client = config.deployTarget === "sync-server" ? null : await buildClient({
       projectRoot: config.projectRoot,
-      outDir: (0, import_node_path15.join)(deployDirectory, "dist"),
+      outDir: (0, import_node_path16.join)(deployDirectory, "dist"),
       mode: "production"
     });
     return {
       clientDirectory: client?.outDir ?? null,
-      serverBundlePath: (0, import_node_path15.join)(deployDirectory, "server-bundled.js"),
+      serverBundlePath: (0, import_node_path16.join)(deployDirectory, "server-bundled.js"),
       deployDirectory
     };
   }
@@ -5349,11 +5565,11 @@ ${stdout}`.toLowerCase();
 
 // src/commands/deploy/adapters/railway-adapter.ts
 var import_node_child_process9 = require("child_process");
-var import_node_path17 = require("path");
+var import_node_path18 = require("path");
 
 // src/commands/deploy/artifacts/railway-json-generator.ts
-var import_promises11 = require("fs/promises");
-var import_node_path16 = require("path");
+var import_promises12 = require("fs/promises");
+var import_node_path17 = require("path");
 var GENERATED_HEADER2 = "Generated by kora deploy - do not edit manually.";
 function generateRailwayJson(options) {
   const file = {
@@ -5378,9 +5594,9 @@ function generateRailwayJson(options) {
 `;
 }
 async function writeRailwayJsonArtifact(deployDirectory, options) {
-  await (0, import_promises11.mkdir)(deployDirectory, { recursive: true });
-  const filePath = (0, import_node_path16.join)(deployDirectory, "railway.json");
-  await (0, import_promises11.writeFile)(filePath, generateRailwayJson(options), "utf-8");
+  await (0, import_promises12.mkdir)(deployDirectory, { recursive: true });
+  const filePath = (0, import_node_path17.join)(deployDirectory, "railway.json");
+  await (0, import_promises12.writeFile)(filePath, generateRailwayJson(options), "utf-8");
   return filePath;
 }
 
@@ -5469,7 +5685,7 @@ var RailwayAdapter = class {
       appName: config.appName,
       region: config.region
     };
-    const deployDirectory = (0, import_node_path17.join)(config.projectRoot, ".kora", "deploy");
+    const deployDirectory = (0, import_node_path18.join)(config.projectRoot, ".kora", "deploy");
     await writeRailwayJsonArtifact(deployDirectory, {
       appName: config.appName,
       environment: config.environment
@@ -5480,12 +5696,12 @@ var RailwayAdapter = class {
     });
     const client = config.deployTarget === "sync-server" ? null : await buildClient({
       projectRoot: config.projectRoot,
-      outDir: (0, import_node_path17.join)(deployDirectory, "dist"),
+      outDir: (0, import_node_path18.join)(deployDirectory, "dist"),
       mode: "production"
     });
     return {
       clientDirectory: client?.outDir ?? null,
-      serverBundlePath: (0, import_node_path17.join)(deployDirectory, "server-bundled.js"),
+      serverBundlePath: (0, import_node_path18.join)(deployDirectory, "server-bundled.js"),
       deployDirectory
     };
   }
@@ -5770,8 +5986,8 @@ function createDeployAdapter(platform) {
 }
 
 // src/commands/deploy/artifacts/dockerfile-generator.ts
-var import_promises12 = require("fs/promises");
-var import_node_path18 = require("path");
+var import_promises13 = require("fs/promises");
+var import_node_path19 = require("path");
 var GENERATED_HEADER3 = "# Generated by kora deploy \u2014 do not edit manually";
 function generateDockerfile(options = {}) {
   const nodeVersion = options.nodeVersion ?? "20-alpine";
@@ -5837,37 +6053,37 @@ function generateDockerIgnore() {
   ].join("\n");
 }
 async function writeDockerfileArtifact(deployDirectory, options = {}) {
-  await (0, import_promises12.mkdir)(deployDirectory, { recursive: true });
-  const dockerfilePath = (0, import_node_path18.join)(deployDirectory, "Dockerfile");
-  await (0, import_promises12.writeFile)(dockerfilePath, generateDockerfile(options), "utf-8");
+  await (0, import_promises13.mkdir)(deployDirectory, { recursive: true });
+  const dockerfilePath = (0, import_node_path19.join)(deployDirectory, "Dockerfile");
+  await (0, import_promises13.writeFile)(dockerfilePath, generateDockerfile(options), "utf-8");
   if (options.nativeDependencies && Object.keys(options.nativeDependencies).length > 0) {
-    const pkgJsonPath = (0, import_node_path18.join)(deployDirectory, "package.json");
-    await (0, import_promises12.writeFile)(pkgJsonPath, generateDeployPackageJson(options.nativeDependencies), "utf-8");
+    const pkgJsonPath = (0, import_node_path19.join)(deployDirectory, "package.json");
+    await (0, import_promises13.writeFile)(pkgJsonPath, generateDeployPackageJson(options.nativeDependencies), "utf-8");
   }
   return dockerfilePath;
 }
 async function writeDockerIgnoreArtifact(deployDirectory) {
-  await (0, import_promises12.mkdir)(deployDirectory, { recursive: true });
-  const dockerIgnorePath = (0, import_node_path18.join)(deployDirectory, ".dockerignore");
-  await (0, import_promises12.writeFile)(dockerIgnorePath, generateDockerIgnore(), "utf-8");
+  await (0, import_promises13.mkdir)(deployDirectory, { recursive: true });
+  const dockerIgnorePath = (0, import_node_path19.join)(deployDirectory, ".dockerignore");
+  await (0, import_promises13.writeFile)(dockerIgnorePath, generateDockerIgnore(), "utf-8");
   return dockerIgnorePath;
 }
 
 // src/commands/deploy/state/deploy-state.ts
-var import_promises13 = require("fs/promises");
-var import_node_path19 = require("path");
-var KORA_DEPLOY_DIRECTORY = (0, import_node_path19.join)(".kora", "deploy");
+var import_promises14 = require("fs/promises");
+var import_node_path20 = require("path");
+var KORA_DEPLOY_DIRECTORY = (0, import_node_path20.join)(".kora", "deploy");
 var DEPLOY_STATE_FILENAME = "deploy.json";
 function resolveDeployDirectory(projectRoot) {
-  return (0, import_node_path19.join)(projectRoot, KORA_DEPLOY_DIRECTORY);
+  return (0, import_node_path20.join)(projectRoot, KORA_DEPLOY_DIRECTORY);
 }
 function resolveDeployStatePath(projectRoot) {
-  return (0, import_node_path19.join)(resolveDeployDirectory(projectRoot), DEPLOY_STATE_FILENAME);
+  return (0, import_node_path20.join)(resolveDeployDirectory(projectRoot), DEPLOY_STATE_FILENAME);
 }
 async function readDeployState(projectRoot) {
   const statePath = resolveDeployStatePath(projectRoot);
   try {
-    const source = await (0, import_promises13.readFile)(statePath, "utf-8");
+    const source = await (0, import_promises14.readFile)(statePath, "utf-8");
     const parsed = JSON.parse(source);
     return parseDeployState(parsed);
   } catch (error) {
@@ -5914,13 +6130,13 @@ async function updateDeployState(projectRoot, patch, now = /* @__PURE__ */ new D
   return nextState;
 }
 async function resetDeployState(projectRoot) {
-  await (0, import_promises13.rm)(resolveDeployDirectory(projectRoot), { recursive: true, force: true });
+  await (0, import_promises14.rm)(resolveDeployDirectory(projectRoot), { recursive: true, force: true });
 }
 async function persistDeployState(projectRoot, state) {
   const deployDir = resolveDeployDirectory(projectRoot);
   const statePath = resolveDeployStatePath(projectRoot);
-  await (0, import_promises13.mkdir)(deployDir, { recursive: true });
-  await (0, import_promises13.writeFile)(statePath, `${JSON.stringify(state, null, 2)}
+  await (0, import_promises14.mkdir)(deployDir, { recursive: true });
+  await (0, import_promises14.writeFile)(statePath, `${JSON.stringify(state, null, 2)}
 `, "utf-8");
 }
 function parseDeployState(value) {
@@ -5970,7 +6186,7 @@ function readOptionalString(value, field) {
 }
 
 // src/commands/deploy/deploy-command.ts
-var deployCommand = (0, import_citty4.defineCommand)({
+var deployCommand = (0, import_citty5.defineCommand)({
   meta: {
     name: "deploy",
     description: "Deploy a Kora project to your selected platform"
@@ -6005,7 +6221,7 @@ var deployCommand = (0, import_citty4.defineCommand)({
     }
   },
   subCommands: {
-    status: (0, import_citty4.defineCommand)({
+    status: (0, import_citty5.defineCommand)({
       meta: {
         name: "status",
         description: "Show current deployment status"
@@ -6036,7 +6252,7 @@ var deployCommand = (0, import_citty4.defineCommand)({
         logger.step(`Sync URL: ${state.syncUrl ?? "n/a"}`);
       }
     }),
-    rollback: (0, import_citty4.defineCommand)({
+    rollback: (0, import_citty5.defineCommand)({
       meta: {
         name: "rollback",
         description: "Rollback the current deployment"
@@ -6067,7 +6283,7 @@ var deployCommand = (0, import_citty4.defineCommand)({
         logger.success(`Rolled back ${state.platform} deployment to ${deploymentId}.`);
       }
     }),
-    logs: (0, import_citty4.defineCommand)({
+    logs: (0, import_citty5.defineCommand)({
       meta: {
         name: "logs",
         description: "Read deployment logs"
@@ -6254,7 +6470,7 @@ function resolveAppName(argValue, storedValue, projectRoot, confirm) {
       "Missing app name in --confirm mode. Provide --app or run an interactive deploy first."
     );
   }
-  return sanitizeAppName((0, import_node_path20.basename)(projectRoot));
+  return sanitizeAppName((0, import_node_path21.basename)(projectRoot));
 }
 function resolveRegion(argValue, storedValue, confirm) {
   if (typeof argValue === "string" && argValue.length > 0) return argValue;
@@ -6289,17 +6505,18 @@ function configureAdapterContext(adapter, context) {
   }
 }
 function detectDeployTarget(projectRoot) {
-  return (0, import_node_fs4.existsSync)((0, import_node_path20.join)(projectRoot, "src-tauri")) ? "sync-server" : "full-stack";
+  return (0, import_node_fs4.existsSync)((0, import_node_path21.join)(projectRoot, "src-tauri")) ? "sync-server" : "full-stack";
 }
 function hasContextSetter(adapter) {
   return typeof adapter.setContext === "function";
 }
 
 // src/commands/dev/dev-command.ts
-var import_promises14 = require("fs/promises");
-var import_node_path22 = require("path");
+var import_node_fs6 = require("fs");
+var import_promises15 = require("fs/promises");
 var import_node_path23 = require("path");
-var import_citty5 = require("citty");
+var import_node_path24 = require("path");
+var import_citty6 = require("citty");
 init_fs_helpers();
 
 // src/commands/dev/process-manager.ts
@@ -6307,6 +6524,7 @@ var import_node_child_process10 = require("child_process");
 var ProcessManager = class {
   processes = /* @__PURE__ */ new Map();
   spawn(config) {
+    this.processes.get(config.label)?.child.kill("SIGTERM");
     const options = {
       cwd: config.cwd,
       env: { ...process.env, ...config.env },
@@ -6350,6 +6568,20 @@ var ProcessManager = class {
   hasRunning() {
     return this.processes.size > 0;
   }
+  async restart(config) {
+    await this.stop(config.label);
+    this.spawn(config);
+  }
+  async stop(label) {
+    const running = this.processes.get(label);
+    if (!running) return;
+    running.child.kill("SIGTERM");
+    await Promise.race([running.exitPromise, delay(5e3)]);
+    const remaining = this.processes.get(label);
+    if (!remaining) return;
+    remaining.child.kill("SIGKILL");
+    await remaining.exitPromise;
+  }
   async shutdownAll() {
     const running = Array.from(this.processes.values());
     if (running.length === 0) return;
@@ -6392,8 +6624,9 @@ function delay(ms) {
 // src/commands/dev/schema-watcher.ts
 var import_node_child_process11 = require("child_process");
 var import_node_fs5 = require("fs");
-var import_node_path21 = require("path");
+var import_node_path22 = require("path");
 init_fs_helpers();
+init_schema_loader();
 var SchemaWatcher = class {
   constructor(config) {
     this.config = config;
@@ -6403,6 +6636,7 @@ var SchemaWatcher = class {
   debounceMs;
   watcher = null;
   debounceTimer = null;
+  schemaVersion = null;
   start() {
     if (this.watcher) return;
     this.watcher = (0, import_node_fs5.watch)(this.config.schemaPath, () => {
@@ -6411,6 +6645,9 @@ var SchemaWatcher = class {
     this.watcher.on("error", (error) => {
       this.config.onError?.(toError(error));
     });
+    void this.refreshSchemaVersion().catch((error) => {
+      this.config.onError?.(toError(error));
+    });
   }
   stop() {
     if (this.debounceTimer) {
@@ -6421,7 +6658,7 @@ var SchemaWatcher = class {
     this.watcher = null;
   }
   async regenerate() {
-    const koraBinJs = (0, import_node_path21.join)(
+    const koraBinJs = (0, import_node_path22.join)(
       this.config.projectRoot,
       "node_modules",
       "@korajs",
@@ -6434,6 +6671,15 @@ var SchemaWatcher = class {
     const args = hasTsx ? ["--import", "tsx", koraBinJs, "generate", "types", "--schema", this.config.schemaPath] : [koraBinJs, "generate", "types", "--schema", this.config.schemaPath];
     await spawnCommand(command, args, this.config.projectRoot);
     this.config.onRegenerate?.();
+    await this.refreshSchemaVersion();
+  }
+  async refreshSchemaVersion() {
+    const schema = await loadSchemaDefinition(this.config.schemaPath, this.config.projectRoot);
+    const previous = this.schemaVersion;
+    this.schemaVersion = schema.version;
+    if (previous !== null && previous !== schema.version) {
+      this.config.onSchemaVersionChange?.({ previous, next: schema.version });
+    }
   }
   scheduleRegeneration() {
     if (this.debounceTimer) {
@@ -6487,7 +6733,7 @@ function toError(error) {
 }
 
 // src/commands/dev/dev-command.ts
-var devCommand = (0, import_citty5.defineCommand)({
+var devCommand = (0, import_citty6.defineCommand)({
   meta: {
     name: "dev",
     description: "Start the Kora development environment"
@@ -6518,6 +6764,7 @@ var devCommand = (0, import_citty5.defineCommand)({
     if (!projectRoot) {
       throw new InvalidProjectError(process.cwd());
     }
+    loadProjectEnv(projectRoot);
     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;
@@ -6527,7 +6774,7 @@ var devCommand = (0, import_citty5.defineCommand)({
     const watchDebounceMs = typeof config?.dev?.watch === "object" && typeof config.dev.watch.debounceMs === "number" ? config.dev.watch.debounceMs : 300;
     const viteEntryPoint = await resolveProjectBinaryEntryPoint(projectRoot, "vite", "vite");
     if (!viteEntryPoint) {
-      throw new DevServerError("vite", (0, import_node_path22.join)(projectRoot, "node_modules", ".bin", "vite"));
+      throw new DevServerError("vite", (0, import_node_path23.join)(projectRoot, "node_modules", ".bin", "vite"));
     }
     const syncServerFile = await findSyncServerFile(projectRoot);
     let managedSyncStore = normalizeManagedSyncStore(config, projectRoot);
@@ -6542,8 +6789,8 @@ var devCommand = (0, import_citty5.defineCommand)({
       }
     }
     if (shouldStartSync && syncServerFile === null && managedSyncStore) {
-      const hasServerPackage = await fileExists2(
-        (0, import_node_path22.join)(projectRoot, "node_modules", "@korajs", "server", "package.json")
+      const hasServerPackage = await fileExists3(
+        (0, import_node_path23.join)(projectRoot, "node_modules", "@korajs", "server", "package.json")
       );
       if (!hasServerPackage) {
         logger.warn(
@@ -6560,8 +6807,8 @@ var devCommand = (0, import_citty5.defineCommand)({
     }
     let configuredSchemaPath = null;
     if (typeof config?.schema === "string") {
-      const candidate = (0, import_node_path23.resolve)(projectRoot, config.schema);
-      if (await fileExists2(candidate)) {
+      const candidate = (0, import_node_path24.resolve)(projectRoot, config.schema);
+      if (await fileExists3(candidate)) {
         configuredSchemaPath = candidate;
       } else {
         logger.warn(
@@ -6619,7 +6866,9 @@ var devCommand = (0, import_citty5.defineCommand)({
       logger.step("  Schema watcher disabled (schema.ts not found)");
     }
     logger.blank();
-    logger.step("  Kora DevTools overlay: Ctrl+Shift+K (Cmd+Shift+K on macOS) when devtools: true");
+    logger.step(
+      "  Kora DevTools overlay: Ctrl+Shift+K (Cmd+Shift+K on macOS) when devtools is enabled"
+    );
     processManager.spawn({
       label: "vite",
       command: process.execPath,
@@ -6630,33 +6879,31 @@ var devCommand = (0, import_citty5.defineCommand)({
       },
       onExit: onManagedProcessExit
     });
-    if (shouldStartSync && hasTsx && syncServerFile) {
-      processManager.spawn({
-        label: "sync",
-        command: process.execPath,
-        args: ["--import", "tsx", 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
-      });
+    const syncProcessConfig = shouldStartSync && hasTsx && syncServerFile ? {
+      label: "sync",
+      command: process.execPath,
+      args: ["--import", "tsx", syncServerFile],
+      cwd: projectRoot,
+      env: {
+        PORT: String(syncPort),
+        KORA_SYNC_PORT: String(syncPort)
+      },
+      onExit: onManagedProcessExit
+    } : shouldStartSync && syncServerFile === null && managedSyncStore !== null ? {
+      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
+    } : null;
+    if (syncProcessConfig) {
+      processManager.spawn(syncProcessConfig);
     }
     if (watchEnabled && schemaPath) {
       schemaWatcher = new SchemaWatcher({
@@ -6666,6 +6913,16 @@ var devCommand = (0, import_citty5.defineCommand)({
         onRegenerate: () => {
           logger.success("Regenerated types from schema changes");
         },
+        onSchemaVersionChange: ({ previous, next }) => {
+          if (!syncProcessConfig) {
+            logger.warn(
+              `Schema version changed from ${previous} to ${next}; restart your sync server before clients can sync.`
+            );
+            return;
+          }
+          logger.warn(`Schema version changed from ${previous} to ${next}; restarting sync server.`);
+          void processManager.restart(syncProcessConfig);
+        },
         onError: (error) => {
           logger.error(`Schema watcher error: ${error.message}`);
         }
@@ -6678,31 +6935,68 @@ var devCommand = (0, import_citty5.defineCommand)({
   }
 });
 async function findSyncServerFile(projectRoot) {
-  const candidates = [(0, import_node_path22.join)(projectRoot, "server.ts"), (0, import_node_path22.join)(projectRoot, "server.js")];
+  const candidates = [(0, import_node_path23.join)(projectRoot, "server.ts"), (0, import_node_path23.join)(projectRoot, "server.js")];
   for (const candidate of candidates) {
     try {
-      await (0, import_promises14.access)(candidate);
+      await (0, import_promises15.access)(candidate);
       return candidate;
     } catch {
     }
   }
   return null;
 }
-async function fileExists2(path) {
+async function fileExists3(path) {
   try {
-    await (0, import_promises14.access)(path);
+    await (0, import_promises15.access)(path);
     return true;
   } catch {
     return false;
   }
 }
+function loadProjectEnv(projectRoot, mode = "development") {
+  const files = [".env", ".env.local", `.env.${mode}`, `.env.${mode}.local`];
+  const existingKeys = new Set(Object.keys(process.env));
+  for (const file of files) {
+    const path = (0, import_node_path23.join)(projectRoot, file);
+    if (!(0, import_node_fs6.existsSync)(path)) continue;
+    const parsed = parseEnvFile((0, import_node_fs6.readFileSync)(path, "utf8"));
+    for (const [key, value] of Object.entries(parsed)) {
+      if (!existingKeys.has(key)) {
+        process.env[key] = value;
+      }
+    }
+  }
+}
+function parseEnvFile(contents) {
+  const env = {};
+  for (const rawLine of contents.split(/\r?\n/)) {
+    const line = rawLine.trim();
+    if (!line || line.startsWith("#")) continue;
+    const normalized = line.startsWith("export ") ? line.slice("export ".length).trim() : line;
+    const equalsIndex = normalized.indexOf("=");
+    if (equalsIndex <= 0) continue;
+    const key = normalized.slice(0, equalsIndex).trim();
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key)) continue;
+    env[key] = parseEnvValue(normalized.slice(equalsIndex + 1).trim());
+  }
+  return env;
+}
+function parseEnvValue(value) {
+  const quote = value[0];
+  if ((quote === '"' || quote === "'") && value[value.length - 1] === quote) {
+    const inner = value.slice(1, -1);
+    return quote === '"' ? inner.replace(/\\n/g, "\n").replace(/\\r/g, "\r") : inner;
+  }
+  const commentIndex = value.search(/\s#/);
+  return (commentIndex >= 0 ? value.slice(0, commentIndex) : value).trim();
+}
 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: (0, import_node_path22.join)(projectRoot, "kora-sync.db") };
+  if (store === "sqlite") return { type: "sqlite", filename: (0, import_node_path23.join)(projectRoot, "kora-sync.db") };
   if (store === "postgres") {
     const connectionString = process.env.DATABASE_URL;
     if (!connectionString) return null;
@@ -6711,7 +7005,7 @@ function normalizeManagedSyncStore(config, projectRoot) {
   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 ? (0, import_node_path23.resolve)(projectRoot, store.filename) : (0, import_node_path22.join)(projectRoot, "kora-sync.db");
+      const filename = typeof store.filename === "string" && store.filename.length > 0 ? (0, import_node_path24.resolve)(projectRoot, store.filename) : (0, import_node_path23.join)(projectRoot, "kora-sync.db");
       return { type: "sqlite", filename };
     }
     if (store.type === "postgres" && typeof store.connectionString === "string") {
@@ -6775,12 +7069,12 @@ await new Promise(() => {});
 `;
 
 // src/commands/doctor/doctor-command.ts
-var import_citty6 = require("citty");
+var import_citty7 = require("citty");
 init_fs_helpers();
 
 // src/commands/doctor/doctor-checks.ts
-var import_promises15 = require("fs/promises");
-var import_node_path24 = require("path");
+var import_promises16 = require("fs/promises");
+var import_node_path25 = require("path");
 init_fs_helpers();
 init_schema_loader();
 var STATUS_ENDPOINT = "/__kora/status";
@@ -6860,9 +7154,9 @@ async function runDoctorChecks(options) {
 }
 async function resolveSchemaPath(projectRoot, configSchema) {
   if (typeof configSchema === "string") {
-    const resolved = (0, import_node_path24.resolve)(projectRoot, configSchema);
+    const resolved = (0, import_node_path25.resolve)(projectRoot, configSchema);
     try {
-      await (0, import_promises15.access)(resolved);
+      await (0, import_promises16.access)(resolved);
       return resolved;
     } catch {
     }
@@ -6871,12 +7165,12 @@ async function resolveSchemaPath(projectRoot, configSchema) {
 }
 async function checkWorkerFile(projectRoot) {
   const candidates = [
-    (0, import_node_path24.join)(projectRoot, "src", "kora-worker.ts"),
-    (0, import_node_path24.join)(projectRoot, "src", "kora-worker.js")
+    (0, import_node_path25.join)(projectRoot, "src", "kora-worker.ts"),
+    (0, import_node_path25.join)(projectRoot, "src", "kora-worker.js")
   ];
   for (const path of candidates) {
     try {
-      await (0, import_promises15.access)(path);
+      await (0, import_promises16.access)(path);
       return {
         id: "worker",
         title: "SQLite WASM worker",
@@ -6896,7 +7190,7 @@ async function checkWorkerFile(projectRoot) {
 }
 async function checkDependencies(projectRoot) {
   try {
-    const raw = await (0, import_promises15.readFile)((0, import_node_path24.join)(projectRoot, "package.json"), "utf-8");
+    const raw = await (0, import_promises16.readFile)((0, import_node_path25.join)(projectRoot, "package.json"), "utf-8");
     const pkg = JSON.parse(raw);
     const deps = { ...pkg.dependencies, ...pkg.devDependencies };
     const hasKora = Boolean(deps.korajs || deps.kora);
@@ -6945,9 +7239,9 @@ async function resolveSyncHttpUrl(projectRoot, config) {
 }
 async function readEnvSyncUrl(projectRoot) {
   for (const file of [".env", ".env.local"]) {
-    const path = (0, import_node_path24.join)(projectRoot, file);
+    const path = (0, import_node_path25.join)(projectRoot, file);
     try {
-      const content = await (0, import_promises15.readFile)(path, "utf-8");
+      const content = await (0, import_promises16.readFile)(path, "utf-8");
       for (const line of content.split("\n")) {
         const trimmed = line.trim();
         if (!trimmed || trimmed.startsWith("#")) continue;
@@ -7038,7 +7332,7 @@ function doctorHasFailures(results) {
 }
 
 // src/commands/doctor/doctor-command.ts
-var doctorCommand = (0, import_citty6.defineCommand)({
+var doctorCommand = (0, import_citty7.defineCommand)({
   meta: {
     name: "doctor",
     description: "Check Kora project setup (schema, worker, sync server, versions)"
@@ -7093,9 +7387,9 @@ var doctorCommand = (0, import_citty6.defineCommand)({
 });
 
 // src/commands/generate/generate-command.ts
-var import_promises16 = require("fs/promises");
-var import_node_path25 = require("path");
-var import_citty7 = require("citty");
+var import_promises17 = require("fs/promises");
+var import_node_path26 = require("path");
+var import_citty8 = require("citty");
 init_fs_helpers();
 init_schema_loader();
 
@@ -7250,13 +7544,13 @@ function toPascalCase2(name) {
 }
 
 // src/commands/generate/generate-command.ts
-var generateCommand = (0, import_citty7.defineCommand)({
+var generateCommand = (0, import_citty8.defineCommand)({
   meta: {
     name: "generate",
     description: "Generate code from your Kora schema"
   },
   subCommands: {
-    types: (0, import_citty7.defineCommand)({
+    types: (0, import_citty8.defineCommand)({
       meta: {
         name: "types",
         description: "Generate TypeScript types from your schema"
@@ -7280,7 +7574,7 @@ var generateCommand = (0, import_citty7.defineCommand)({
         }
         let schemaPath;
         if (args.schema && typeof args.schema === "string") {
-          schemaPath = (0, import_node_path25.resolve)(args.schema);
+          schemaPath = (0, import_node_path26.resolve)(args.schema);
         } else {
           const found = await findSchemaFile(projectRoot);
           if (!found) {
@@ -7303,13 +7597,13 @@ var generateCommand = (0, import_citty7.defineCommand)({
         }
         const output = generateTypes(schema);
         const outputFile = typeof args.output === "string" ? args.output : "kora/generated/types.ts";
-        const outputPath = (0, import_node_path25.resolve)(projectRoot, outputFile);
-        await (0, import_promises16.mkdir)((0, import_node_path25.dirname)(outputPath), { recursive: true });
-        await (0, import_promises16.writeFile)(outputPath, output, "utf-8");
+        const outputPath = (0, import_node_path26.resolve)(projectRoot, outputFile);
+        await (0, import_promises17.mkdir)((0, import_node_path26.dirname)(outputPath), { recursive: true });
+        await (0, import_promises17.writeFile)(outputPath, output, "utf-8");
         logger.success(`Generated types at ${outputPath}`);
       }
     }),
-    hooks: (0, import_citty7.defineCommand)({
+    hooks: (0, import_citty8.defineCommand)({
       meta: {
         name: "hooks",
         description: "Generate per-collection React hook stubs"
@@ -7338,7 +7632,7 @@ var generateCommand = (0, import_citty7.defineCommand)({
         }
         let schemaPath;
         if (args.schema && typeof args.schema === "string") {
-          schemaPath = (0, import_node_path25.resolve)(projectRoot, args.schema);
+          schemaPath = (0, import_node_path26.resolve)(projectRoot, args.schema);
         } else {
           const found = await findSchemaFile(projectRoot);
           if (!found) {
@@ -7352,13 +7646,13 @@ var generateCommand = (0, import_citty7.defineCommand)({
           schemaPath = found;
         }
         const schema = await loadSchemaDefinition(schemaPath, projectRoot);
-        const outputDir = typeof args.output === "string" ? (0, import_node_path25.resolve)(projectRoot, args.output) : (0, import_node_path25.resolve)(projectRoot, "kora/generated/hooks");
+        const outputDir = typeof args.output === "string" ? (0, import_node_path26.resolve)(projectRoot, args.output) : (0, import_node_path26.resolve)(projectRoot, "kora/generated/hooks");
         const files = generateCollectionHooks(schema);
         for (const [name, content] of files) {
           const adjusted = typeof args.types === "string" && args.types !== "../types" ? content.replace("from '../types'", `from '${args.types}'`) : content;
-          const filePath = (0, import_node_path25.resolve)(outputDir, name);
-          await (0, import_promises16.mkdir)((0, import_node_path25.dirname)(filePath), { recursive: true });
-          await (0, import_promises16.writeFile)(filePath, adjusted, "utf-8");
+          const filePath = (0, import_node_path26.resolve)(outputDir, name);
+          await (0, import_promises17.mkdir)((0, import_node_path26.dirname)(filePath), { recursive: true });
+          await (0, import_promises17.writeFile)(filePath, adjusted, "utf-8");
         }
         logger.success(`Generated ${String(files.size)} hook file(s) at ${outputDir}`);
         logger.step("Run `kora generate types` first if ../types is missing.");
@@ -7380,10 +7674,10 @@ function isSchemaDefinition2(value) {
 }
 
 // src/commands/logs/logs-command.ts
-var import_citty8 = require("citty");
+var import_citty9 = require("citty");
 var DEFAULT_SYNC_PORT2 = 3001;
 var EVENTS_ENDPOINT = "/__kora/events";
-var logsCommand = (0, import_citty8.defineCommand)({
+var logsCommand = (0, import_citty9.defineCommand)({
   meta: {
     name: "logs",
     description: "Stream real-time events from a Kora sync server"
@@ -7487,9 +7781,9 @@ var logsCommand = (0, import_citty8.defineCommand)({
 });
 
 // src/commands/migrate/migrate-command.ts
-var import_promises17 = require("fs/promises");
-var import_node_path26 = require("path");
-var import_citty9 = require("citty");
+var import_promises18 = require("fs/promises");
+var import_node_path27 = require("path");
+var import_citty10 = require("citty");
 init_fs_helpers();
 
 // src/commands/migrate/migration-generator.ts
@@ -7833,6 +8127,14 @@ function mapFieldType(descriptor) {
       return "INTEGER";
     case "array":
       return "TEXT";
+    case "object":
+      return "TEXT";
+    case "json":
+      return "TEXT";
+    case "blob":
+      return "TEXT";
+    case "secret":
+      return "TEXT";
     case "richtext":
       return "BLOB";
   }
@@ -7848,7 +8150,7 @@ function quoteIdentifier(identifier) {
   if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(identifier)) {
     throw new Error(`Invalid SQL identifier: ${identifier}`);
   }
-  return identifier;
+  return `"${identifier}"`;
 }
 function formatChange(change) {
   switch (change.type) {
@@ -8084,7 +8386,7 @@ function generateOperationTransformModule(fromVersion, toVersion) {
 init_schema_loader();
 var SNAPSHOT_PATH = "kora/schema.snapshot.json";
 var MIGRATIONS_DIR = "kora/migrations";
-var migrateCommand = (0, import_citty9.defineCommand)({
+var migrateCommand = (0, import_citty10.defineCommand)({
   meta: {
     name: "migrate",
     description: "Detect schema changes and generate/apply migrations"
@@ -8126,12 +8428,12 @@ var migrateCommand = (0, import_citty9.defineCommand)({
       throw new InvalidProjectError(process.cwd());
     }
     const config = await loadKoraConfig(projectRoot);
-    const resolvedSchemaPath = typeof args.schema === "string" ? (0, import_node_path26.resolve)(projectRoot, args.schema) : typeof config?.schema === "string" ? (0, import_node_path26.resolve)(projectRoot, config.schema) : await findSchemaFile(projectRoot);
+    const resolvedSchemaPath = typeof args.schema === "string" ? (0, import_node_path27.resolve)(projectRoot, args.schema) : typeof config?.schema === "string" ? (0, import_node_path27.resolve)(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 = (0, import_node_path26.join)(projectRoot, SNAPSHOT_PATH);
+    const snapshotFile = (0, import_node_path27.join)(projectRoot, SNAPSHOT_PATH);
     const previousSchema = await readSchemaSnapshot(snapshotFile);
     if (!previousSchema) {
       if (args["dry-run"] === true) {
@@ -8144,7 +8446,7 @@ var migrateCommand = (0, import_citty9.defineCommand)({
       return;
     }
     const diff = diffSchemas(previousSchema, currentSchema);
-    const outputDir = typeof args["output-dir"] === "string" ? (0, import_node_path26.resolve)(projectRoot, args["output-dir"]) : (0, import_node_path26.resolve)(projectRoot, MIGRATIONS_DIR);
+    const outputDir = typeof args["output-dir"] === "string" ? (0, import_node_path27.resolve)(projectRoot, args["output-dir"]) : (0, import_node_path27.resolve)(projectRoot, MIGRATIONS_DIR);
     if (!diff.hasChanges) {
       logger.success("No schema changes detected.");
       if (args.apply === true) {
@@ -8196,7 +8498,7 @@ var migrateCommand = (0, import_citty9.defineCommand)({
       logger.warn("Dry run enabled: no files written, no migrations applied.");
       return;
     }
-    await (0, import_promises17.mkdir)(outputDir, { recursive: true });
+    await (0, import_promises18.mkdir)(outputDir, { recursive: true });
     const migrationPath = await writeMigrationFile(
       outputDir,
       diff.fromVersion,
@@ -8232,7 +8534,7 @@ var migrateCommand = (0, import_citty9.defineCommand)({
 });
 async function readSchemaSnapshot(path) {
   try {
-    const content = await (0, import_promises17.readFile)(path, "utf-8");
+    const content = await (0, import_promises18.readFile)(path, "utf-8");
     return JSON.parse(content);
   } catch {
     return null;
@@ -8253,15 +8555,15 @@ function isInteractiveTerminal2() {
   return process.stdin.isTTY === true && process.stdout.isTTY === true;
 }
 async function writeSchemaSnapshot(path, schema) {
-  await (0, import_promises17.mkdir)((0, import_node_path26.dirname)(path), { recursive: true });
-  await (0, import_promises17.writeFile)(path, `${JSON.stringify(schema, null, 2)}
+  await (0, import_promises18.mkdir)((0, import_node_path27.dirname)(path), { recursive: true });
+  await (0, import_promises18.writeFile)(path, `${JSON.stringify(schema, null, 2)}
 `, "utf-8");
 }
 async function writeMigrationFile(outputDir, fromVersion, toVersion, generated) {
-  const existing = await (0, import_promises17.readdir)(outputDir).catch(() => []);
+  const existing = await (0, import_promises18.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 = (0, import_node_path26.join)(outputDir, filename);
+  const path = (0, import_node_path27.join)(outputDir, filename);
   const migrationId = filename.replace(/\.ts$/, "");
   const fileContent = [
     `export const up = ${JSON.stringify(generated.up, null, 2)} as const`,
@@ -8273,10 +8575,10 @@ async function writeMigrationFile(outputDir, fromVersion, toVersion, generated)
     `export const containsBreakingChanges = ${generated.containsBreakingChanges}`,
     ""
   ].join("\n");
-  await (0, import_promises17.writeFile)(path, fileContent, "utf-8");
-  const transformsPath = (0, import_node_path26.join)(outputDir, `${migrationId}.transforms.ts`);
-  await (0, import_promises17.writeFile)(transformsPath, generateOperationTransformModule(fromVersion, toVersion), "utf-8");
-  await writeMigrationManifest((0, import_node_path26.join)(outputDir, `${migrationId}.json`), {
+  await (0, import_promises18.writeFile)(path, fileContent, "utf-8");
+  const transformsPath = (0, import_node_path27.join)(outputDir, `${migrationId}.transforms.ts`);
+  await (0, import_promises18.writeFile)(transformsPath, generateOperationTransformModule(fromVersion, toVersion), "utf-8");
+  await writeMigrationManifest((0, import_node_path27.join)(outputDir, `${migrationId}.json`), {
     id: migrationId,
     fromVersion,
     toVersion,
@@ -8288,22 +8590,22 @@ async function writeMigrationFile(outputDir, fromVersion, toVersion, generated)
   return path;
 }
 async function writeMigrationManifest(path, manifest) {
-  await (0, import_promises17.writeFile)(path, `${JSON.stringify(manifest, null, 2)}
+  await (0, import_promises18.writeFile)(path, `${JSON.stringify(manifest, null, 2)}
 `, "utf-8");
 }
 async function listMigrationManifests(outputDir) {
-  const files = await (0, import_promises17.readdir)(outputDir).catch(() => []);
+  const files = await (0, import_promises18.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 = (0, import_node_path26.join)(outputDir, `${id}.json`);
+    const manifestPath = (0, import_node_path27.join)(outputDir, `${id}.json`);
     const jsonManifest = await readMigrationManifest(manifestPath);
     if (jsonManifest) {
       manifests.push({ ...jsonManifest, id });
       continue;
     }
-    const migrationPath = (0, import_node_path26.join)(outputDir, file);
+    const migrationPath = (0, import_node_path27.join)(outputDir, file);
     const sourceManifest = await readMigrationManifestFromSource(migrationPath, id);
     manifests.push(sourceManifest);
   }
@@ -8311,7 +8613,7 @@ async function listMigrationManifests(outputDir) {
 }
 async function readMigrationManifest(path) {
   try {
-    const content = await (0, import_promises17.readFile)(path, "utf-8");
+    const content = await (0, import_promises18.readFile)(path, "utf-8");
     return JSON.parse(content);
   } catch (error) {
     const code = error.code;
@@ -8322,7 +8624,7 @@ async function readMigrationManifest(path) {
   }
 }
 async function readMigrationManifestFromSource(path, id) {
-  const content = await (0, import_promises17.readFile)(path, "utf-8");
+  const content = await (0, import_promises18.readFile)(path, "utf-8");
   const versions = parseVersionsFromMigrationId(id);
   return {
     id,
@@ -8384,18 +8686,18 @@ function parseLiteralExport(source, exportName) {
 }
 function resolveSqliteApplyPath(dbArg, projectRoot, config) {
   if (typeof dbArg === "string") {
-    return (0, import_node_path26.resolve)(projectRoot, dbArg);
+    return (0, import_node_path27.resolve)(projectRoot, dbArg);
   }
   const sync = config?.dev?.sync;
   if (typeof sync === "object" && sync !== null) {
     if (sync.store === "sqlite") {
-      return (0, import_node_path26.join)(projectRoot, "kora-sync.db");
+      return (0, import_node_path27.join)(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 (0, import_node_path26.resolve)(projectRoot, sync.store.filename);
+        return (0, import_node_path27.resolve)(projectRoot, sync.store.filename);
       }
-      return (0, import_node_path26.join)(projectRoot, "kora-sync.db");
+      return (0, import_node_path27.join)(projectRoot, "kora-sync.db");
     }
   }
   return void 0;
@@ -8413,7 +8715,7 @@ function resolvePostgresConnectionString(config) {
 }
 
 // src/commands/status/status-command.ts
-var import_citty10 = require("citty");
+var import_citty11 = require("citty");
 var DEFAULT_SYNC_PORT3 = 3001;
 var STATUS_ENDPOINT2 = "/__kora/status";
 async function fetchServerStatus(url, token) {
@@ -8440,7 +8742,7 @@ function formatUptime(ms) {
   parts.push(`${seconds % 60}s`);
   return parts.join(" ");
 }
-var statusCommand = (0, import_citty10.defineCommand)({
+var statusCommand = (0, import_citty11.defineCommand)({
   meta: {
     name: "status",
     description: "Show Kora sync server status"
@@ -8545,10 +8847,10 @@ function printStatus(status, url, logger) {
 }
 
 // src/commands/studio/studio-command.ts
-var import_node_fs8 = require("fs");
-var import_node_path29 = require("path");
-var import_citty11 = require("citty");
-var studioCommand = (0, import_citty11.defineCommand)({
+var import_node_fs9 = require("fs");
+var import_node_path30 = require("path");
+var import_citty12 = require("citty");
+var studioCommand = (0, import_citty12.defineCommand)({
   meta: {
     name: "studio",
     description: "Kora Studio: visualize records, operations, and sync \u2014 or run the sync lab"
@@ -8597,7 +8899,7 @@ var studioCommand = (0, import_citty11.defineCommand)({
         );
       }
       const { loadSchemaDefinition: loadSchemaDefinition2 } = await Promise.resolve().then(() => (init_schema_loader(), schema_loader_exports));
-      const schema = await loadSchemaDefinition2((0, import_node_path29.resolve)(process.cwd(), args.schema), process.cwd());
+      const schema = await loadSchemaDefinition2((0, import_node_path30.resolve)(process.cwd(), args.schema), process.cwd());
       const { SpectatorManager: SpectatorManager2 } = await Promise.resolve().then(() => (init_spectator_manager(), spectator_manager_exports));
       const spectator = new SpectatorManager2({
         url: args.connect,
@@ -8624,7 +8926,7 @@ var studioCommand = (0, import_citty11.defineCommand)({
       let schema = defaultLabSchema2();
       if (typeof args.schema === "string") {
         const { loadSchemaDefinition: loadSchemaDefinition2 } = await Promise.resolve().then(() => (init_schema_loader(), schema_loader_exports));
-        schema = await loadSchemaDefinition2((0, import_node_path29.resolve)(process.cwd(), args.schema), process.cwd());
+        schema = await loadSchemaDefinition2((0, import_node_path30.resolve)(process.cwd(), args.schema), process.cwd());
       }
       const initialDevices = args.devices !== void 0 ? Math.max(1, Number.parseInt(args.devices, 10) || 2) : 2;
       const lab = new LabManager2(schema);
@@ -8649,8 +8951,8 @@ var studioCommand = (0, import_citty11.defineCommand)({
         "Pass --db <path> to inspect a database, --lab for the sync laboratory, or --connect <wss url> for live spectator mode."
       );
     }
-    const dbPath = (0, import_node_path29.resolve)(process.cwd(), args.db);
-    if (!(0, import_node_fs8.existsSync)(dbPath)) {
+    const dbPath = (0, import_node_path30.resolve)(process.cwd(), args.db);
+    if (!(0, import_node_fs9.existsSync)(dbPath)) {
       throw new Error(`Database file not found: ${dbPath}`);
     }
     const server = await startStudioServer2({ port, dbPath });
@@ -8668,12 +8970,13 @@ var studioCommand = (0, import_citty11.defineCommand)({
 });
 
 // src/bin.ts
-var main = (0, import_citty12.defineCommand)({
+var main = (0, import_citty13.defineCommand)({
   meta: {
     name: "kora",
-    description: "Kora.js \u2014 Offline-first application framework"
+    description: "Kora.js, the offline-first application framework"
   },
   subCommands: {
+    "agents-md": agentsCommand,
     backup: backupCommand,
     compact: compactCommand,
     create: createCommand,
@@ -8687,5 +8990,5 @@ var main = (0, import_citty12.defineCommand)({
     studio: studioCommand
   }
 });
-(0, import_citty12.runMain)(main);
+(0, import_citty13.runMain)(main);
 //# sourceMappingURL=bin.cjs.map