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

package/dist/index.cjs

@@ -30,6 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  AGENTS_FRAMEWORKS: () => AGENTS_FRAMEWORKS,
   ClackPromptClient: () => ClackPromptClient,
   CliError: () => CliError,
   DEPLOY_PLATFORMS: () => DEPLOY_PLATFORMS,
@@ -48,13 +49,16 @@ __export(index_exports, {
   StubDeployAdapter: () => StubDeployAdapter,
   TEMPLATES: () => TEMPLATES,
   TEMPLATE_INFO: () => TEMPLATE_INFO,
+  agentsCommand: () => agentsCommand,
   applySyncProviderPreset: () => applySyncProviderPreset,
   buildClient: () => buildClient,
   bundleServer: () => bundleServer,
   createDeployAdapter: () => createDeployAdapter,
   createPromptClient: () => createPromptClient,
   deployCommand: () => deployCommand,
+  detectFrameworkFromManifest: () => detectFrameworkFromManifest,
   determineTemplateFromSelections: () => determineTemplateFromSelections,
+  generateAgentsMd: () => generateAgentsMd,
   generateDeployPackageJson: () => generateDeployPackageJson,
   generateDockerIgnore: () => generateDockerIgnore,
   generateDockerfile: () => generateDockerfile,
@@ -63,6 +67,7 @@ __export(index_exports, {
   generateTypes: () => generateTypes,
   getCreatePreferencesOrDefault: () => getCreatePreferencesOrDefault,
   getDefaultCreatePreferences: () => getDefaultCreatePreferences,
+  isAgentsFramework: () => isAgentsFramework,
   isAuthValue: () => isAuthValue,
   isDatabaseProviderValue: () => isDatabaseProviderValue,
   isDatabaseValue: () => isDatabaseValue,
@@ -229,6 +234,311 @@ var DevServerError = class extends import_core.KoraError {
   searchPath;
 };
 
+// src/commands/agents/agents-command.ts
+var import_promises2 = require("fs/promises");
+var import_node_path2 = require("path");
+var import_citty = require("citty");
+
+// src/utils/fs-helpers.ts
+var import_promises = require("fs/promises");
+var import_node_path = require("path");
+async function findProjectRoot(startDir) {
+  let current = (0, import_node_path.resolve)(startDir ?? process.cwd());
+  for (; ; ) {
+    const pkgPath = (0, import_node_path.join)(current, "package.json");
+    try {
+      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_path.dirname)(current);
+    if (parent === current) break;
+    current = parent;
+  }
+  return null;
+}
+async function resolveProjectBinaryEntryPoint(projectRoot, packageName, binaryName) {
+  const pkgJsonPath = (0, import_node_path.join)(projectRoot, "node_modules", packageName, "package.json");
+  try {
+    const content = await (0, import_promises.readFile)(pkgJsonPath, "utf-8");
+    const pkg = JSON.parse(content);
+    let binPath;
+    if (typeof pkg.bin === "string") {
+      binPath = pkg.bin;
+    } else if (typeof pkg.bin === "object" && pkg.bin !== null) {
+      binPath = pkg.bin[binaryName];
+    }
+    if (!binPath) return null;
+    const fullPath = (0, import_node_path.join)(projectRoot, "node_modules", packageName, binPath);
+    await (0, import_promises.access)(fullPath);
+    return fullPath;
+  } catch {
+    return null;
+  }
+}
+function isKoraProject(pkg) {
+  if (typeof pkg !== "object" || pkg === null) return false;
+  const record = pkg;
+  return hasKoraDep(record.dependencies) || hasKoraDep(record.devDependencies);
+}
+function hasKoraDep(deps) {
+  if (typeof deps !== "object" || deps === null) return false;
+  return Object.keys(deps).some((key) => key === "kora" || key.startsWith("@korajs/"));
+}
+
+// src/utils/logger.ts
+var RESET = "\x1B[0m";
+var BOLD = "\x1B[1m";
+var DIM = "\x1B[2m";
+var GREEN = "\x1B[32m";
+var YELLOW = "\x1B[33m";
+var RED = "\x1B[31m";
+var CYAN = "\x1B[36m";
+function createLogger(options) {
+  const colorDisabled = options?.noColor === true || process.env.NO_COLOR !== void 0 || !process.stdout.isTTY;
+  function color(code, text) {
+    return colorDisabled ? text : `${code}${text}${RESET}`;
+  }
+  return {
+    info(message) {
+      console.log(color(CYAN, message));
+    },
+    success(message) {
+      console.log(color(GREEN, `  \u2713 ${message}`));
+    },
+    warn(message) {
+      console.warn(color(YELLOW, `  \u26A0 ${message}`));
+    },
+    error(message) {
+      console.error(color(RED, `  \u2717 ${message}`));
+    },
+    step(message) {
+      console.log(color(DIM, `  ${message}`));
+    },
+    blank() {
+      console.log();
+    },
+    banner() {
+      console.log();
+      console.log(
+        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/generate/type-generator.ts
 function generateTypes(schema) {
   const lines = [
@@ -328,8 +638,8 @@ function toPascalCase(name) {
 
 // src/commands/deploy/deploy-command.ts
 var import_node_fs2 = require("fs");
-var import_node_path12 = require("path");
-var import_citty = require("citty");
+var import_node_path13 = require("path");
+var import_citty2 = require("citty");
 
 // src/prompts/prompt-client.ts
 var import_prompts = require("@clack/prompts");
@@ -499,98 +809,6 @@ var ClackPromptClient = class {
   }
 };
 
-// src/utils/fs-helpers.ts
-var import_promises = require("fs/promises");
-var import_node_path = require("path");
-async function findProjectRoot(startDir) {
-  let current = (0, import_node_path.resolve)(startDir ?? process.cwd());
-  for (; ; ) {
-    const pkgPath = (0, import_node_path.join)(current, "package.json");
-    try {
-      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_path.dirname)(current);
-    if (parent === current) break;
-    current = parent;
-  }
-  return null;
-}
-async function resolveProjectBinaryEntryPoint(projectRoot, packageName, binaryName) {
-  const pkgJsonPath = (0, import_node_path.join)(projectRoot, "node_modules", packageName, "package.json");
-  try {
-    const content = await (0, import_promises.readFile)(pkgJsonPath, "utf-8");
-    const pkg = JSON.parse(content);
-    let binPath;
-    if (typeof pkg.bin === "string") {
-      binPath = pkg.bin;
-    } else if (typeof pkg.bin === "object" && pkg.bin !== null) {
-      binPath = pkg.bin[binaryName];
-    }
-    if (!binPath) return null;
-    const fullPath = (0, import_node_path.join)(projectRoot, "node_modules", packageName, binPath);
-    await (0, import_promises.access)(fullPath);
-    return fullPath;
-  } catch {
-    return null;
-  }
-}
-function isKoraProject(pkg) {
-  if (typeof pkg !== "object" || pkg === null) return false;
-  const record = pkg;
-  return hasKoraDep(record.dependencies) || hasKoraDep(record.devDependencies);
-}
-function hasKoraDep(deps) {
-  if (typeof deps !== "object" || deps === null) return false;
-  return Object.keys(deps).some((key) => key === "kora" || key.startsWith("@korajs/"));
-}
-
-// src/utils/logger.ts
-var RESET = "\x1B[0m";
-var BOLD = "\x1B[1m";
-var DIM = "\x1B[2m";
-var GREEN = "\x1B[32m";
-var YELLOW = "\x1B[33m";
-var RED = "\x1B[31m";
-var CYAN = "\x1B[36m";
-function createLogger(options) {
-  const colorDisabled = options?.noColor === true || process.env.NO_COLOR !== void 0 || !process.stdout.isTTY;
-  function color(code, text) {
-    return colorDisabled ? text : `${code}${text}${RESET}`;
-  }
-  return {
-    info(message) {
-      console.log(color(CYAN, message));
-    },
-    success(message) {
-      console.log(color(GREEN, `  \u2713 ${message}`));
-    },
-    warn(message) {
-      console.warn(color(YELLOW, `  \u26A0 ${message}`));
-    },
-    error(message) {
-      console.error(color(RED, `  \u2717 ${message}`));
-    },
-    step(message) {
-      console.log(color(DIM, `  ${message}`));
-    },
-    blank() {
-      console.log();
-    },
-    banner() {
-      console.log();
-      console.log(
-        color(BOLD + CYAN, "  Kora.js") + color(DIM, " \u2014 Offline-first application framework")
-      );
-      console.log();
-    }
-  };
-}
-
 // src/commands/deploy/adapters/adapter.ts
 var DEPLOY_PLATFORMS = [
   "fly",
@@ -607,13 +825,13 @@ function isDeployPlatform(value) {
 
 // src/commands/deploy/adapters/aws-ecs-adapter.ts
 var import_node_child_process2 = require("child_process");
-var import_node_path4 = require("path");
+var import_node_path5 = require("path");
 
 // src/commands/deploy/builder/client-builder.ts
 var import_node_child_process = require("child_process");
 var import_node_fs = require("fs");
-var import_promises2 = require("fs/promises");
-var import_node_path2 = require("path");
+var import_promises3 = require("fs/promises");
+var import_node_path3 = require("path");
 async function buildClient(options) {
   const viteEntryPoint = await resolveProjectBinaryEntryPoint(options.projectRoot, "vite", "vite");
   if (!viteEntryPoint) {
@@ -634,15 +852,15 @@ async function buildClient(options) {
   return { outDir: options.outDir };
 }
 async function patchSqliteWasmAssets(projectRoot, outDir) {
-  const assetsDir = (0, import_node_path2.join)(outDir, "assets");
+  const assetsDir = (0, import_node_path3.join)(outDir, "assets");
   if (!(0, import_node_fs.existsSync)(assetsDir)) return;
-  const files = await (0, import_promises2.readdir)(assetsDir);
+  const files = await (0, import_promises3.readdir)(assetsDir);
   const hashedWasm = files.find((f) => /^sqlite3-.+\.wasm$/.test(f));
   if (hashedWasm && !files.includes("sqlite3.wasm")) {
-    await (0, import_promises2.copyFile)((0, import_node_path2.join)(assetsDir, hashedWasm), (0, import_node_path2.join)(assetsDir, "sqlite3.wasm"));
+    await (0, import_promises3.copyFile)((0, import_node_path3.join)(assetsDir, hashedWasm), (0, import_node_path3.join)(assetsDir, "sqlite3.wasm"));
   }
   if (!files.includes("sqlite3-opfs-async-proxy.js")) {
-    const proxyFile = (0, import_node_path2.resolve)(
+    const proxyFile = (0, import_node_path3.resolve)(
       projectRoot,
       "node_modules",
       "@sqlite.org",
@@ -652,7 +870,7 @@ async function patchSqliteWasmAssets(projectRoot, outDir) {
       "sqlite3-opfs-async-proxy.js"
     );
     if ((0, import_node_fs.existsSync)(proxyFile)) {
-      await (0, import_promises2.copyFile)(proxyFile, (0, import_node_path2.join)(assetsDir, "sqlite3-opfs-async-proxy.js"));
+      await (0, import_promises3.copyFile)(proxyFile, (0, import_node_path3.join)(assetsDir, "sqlite3-opfs-async-proxy.js"));
     }
   }
 }
@@ -677,9 +895,9 @@ async function runProcess(command, args, cwd) {
 }
 
 // src/commands/deploy/builder/server-bundler.ts
-var import_promises3 = require("fs/promises");
 var import_promises4 = require("fs/promises");
-var import_node_path3 = require("path");
+var import_promises5 = require("fs/promises");
+var import_node_path4 = require("path");
 var import_esbuild = require("esbuild");
 var DEFAULT_ENTRY_CANDIDATES = [
   "server.ts",
@@ -695,8 +913,8 @@ async function bundleServer(options) {
       `Could not find a server entry file in ${options.projectRoot}. Looked for: ${candidates.join(", ")}`
     );
   }
-  await (0, import_promises3.mkdir)(options.deployDirectory, { recursive: true });
-  const outputFilePath = (0, import_node_path3.join)(options.deployDirectory, "server-bundled.js");
+  await (0, import_promises4.mkdir)(options.deployDirectory, { recursive: true });
+  const outputFilePath = (0, import_node_path4.join)(options.deployDirectory, "server-bundled.js");
   await (0, import_esbuild.build)({
     entryPoints: [entryFilePath],
     outfile: outputFilePath,
@@ -718,9 +936,9 @@ async function bundleServer(options) {
 }
 async function resolveServerEntry(projectRoot, candidates) {
   for (const candidate of candidates) {
-    const fullPath = (0, import_node_path3.join)(projectRoot, candidate);
+    const fullPath = (0, import_node_path4.join)(projectRoot, candidate);
     try {
-      await (0, import_promises4.access)(fullPath);
+      await (0, import_promises5.access)(fullPath);
       return fullPath;
     } catch {
     }
@@ -822,19 +1040,19 @@ var AwsEcsAdapter = class {
       appName: config.appName,
       region: config.region
     };
-    const deployDirectory = (0, import_node_path4.join)(config.projectRoot, ".kora", "deploy");
+    const deployDirectory = (0, import_node_path5.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_path4.join)(deployDirectory, "dist"),
+      outDir: (0, import_node_path5.join)(deployDirectory, "dist"),
       mode: "production"
     });
     return {
       clientDirectory: client?.outDir ?? null,
-      serverBundlePath: (0, import_node_path4.join)(deployDirectory, "server-bundled.js"),
+      serverBundlePath: (0, import_node_path5.join)(deployDirectory, "server-bundled.js"),
       deployDirectory
     };
   }
@@ -1100,7 +1318,7 @@ function inferLogLevel(line) {
 
 // src/commands/deploy/adapters/aws-lightsail-adapter.ts
 var import_node_child_process3 = require("child_process");
-var import_node_path5 = require("path");
+var import_node_path6 = require("path");
 var AwsLightsailAdapter = class {
   name = "aws-lightsail";
   logger = createLogger();
@@ -1173,19 +1391,19 @@ var AwsLightsailAdapter = class {
       appName: config.appName,
       region: config.region
     };
-    const deployDirectory = (0, import_node_path5.join)(config.projectRoot, ".kora", "deploy");
+    const deployDirectory = (0, import_node_path6.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_path5.join)(deployDirectory, "dist"),
+      outDir: (0, import_node_path6.join)(deployDirectory, "dist"),
       mode: "production"
     });
     return {
       clientDirectory: client?.outDir ?? null,
-      serverBundlePath: (0, import_node_path5.join)(deployDirectory, "server-bundled.js"),
+      serverBundlePath: (0, import_node_path6.join)(deployDirectory, "server-bundled.js"),
       deployDirectory
     };
   }
@@ -1485,11 +1703,11 @@ function inferLogLevel2(line) {
 
 // src/commands/deploy/adapters/fly-adapter.ts
 var import_node_child_process4 = require("child_process");
-var import_node_path7 = require("path");
+var import_node_path8 = require("path");
 
 // src/commands/deploy/artifacts/fly-toml-generator.ts
-var import_promises5 = require("fs/promises");
-var import_node_path6 = require("path");
+var import_promises6 = require("fs/promises");
+var import_node_path7 = require("path");
 var GENERATED_HEADER = "# Generated by kora deploy \u2014 do not edit manually";
 function generateFlyToml(options) {
   const internalPort = options.internalPort ?? 3e3;
@@ -1519,9 +1737,9 @@ function generateFlyToml(options) {
   ].join("\n");
 }
 async function writeFlyTomlArtifact(deployDirectory, options) {
-  await (0, import_promises5.mkdir)(deployDirectory, { recursive: true });
-  const filePath = (0, import_node_path6.join)(deployDirectory, "fly.toml");
-  await (0, import_promises5.writeFile)(filePath, generateFlyToml(options), "utf-8");
+  await (0, import_promises6.mkdir)(deployDirectory, { recursive: true });
+  const filePath = (0, import_node_path7.join)(deployDirectory, "fly.toml");
+  await (0, import_promises6.writeFile)(filePath, generateFlyToml(options), "utf-8");
   return filePath;
 }
 
@@ -1615,7 +1833,7 @@ var FlyAdapter = class {
       appName: config.appName,
       region: config.region
     };
-    const deployDirectory = (0, import_node_path7.join)(config.projectRoot, ".kora", "deploy");
+    const deployDirectory = (0, import_node_path8.join)(config.projectRoot, ".kora", "deploy");
     await writeFlyTomlArtifact(deployDirectory, {
       appName: config.appName,
       region: config.region ?? "iad"
@@ -1626,12 +1844,12 @@ var FlyAdapter = class {
     });
     const client = config.deployTarget === "sync-server" ? null : await buildClient({
       projectRoot: config.projectRoot,
-      outDir: (0, import_node_path7.join)(deployDirectory, "dist"),
+      outDir: (0, import_node_path8.join)(deployDirectory, "dist"),
       mode: "production"
     });
     return {
       clientDirectory: client?.outDir ?? null,
-      serverBundlePath: (0, import_node_path7.join)(deployDirectory, "server-bundled.js"),
+      serverBundlePath: (0, import_node_path8.join)(deployDirectory, "server-bundled.js"),
       deployDirectory
     };
   }
@@ -1853,11 +2071,11 @@ ${stdout}`.toLowerCase();
 
 // src/commands/deploy/adapters/railway-adapter.ts
 var import_node_child_process5 = require("child_process");
-var import_node_path9 = require("path");
+var import_node_path10 = require("path");
 
 // src/commands/deploy/artifacts/railway-json-generator.ts
-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 GENERATED_HEADER2 = "Generated by kora deploy - do not edit manually.";
 function generateRailwayJson(options) {
   const file = {
@@ -1882,9 +2100,9 @@ function generateRailwayJson(options) {
 `;
 }
 async function writeRailwayJsonArtifact(deployDirectory, options) {
-  await (0, import_promises6.mkdir)(deployDirectory, { recursive: true });
-  const filePath = (0, import_node_path8.join)(deployDirectory, "railway.json");
-  await (0, import_promises6.writeFile)(filePath, generateRailwayJson(options), "utf-8");
+  await (0, import_promises7.mkdir)(deployDirectory, { recursive: true });
+  const filePath = (0, import_node_path9.join)(deployDirectory, "railway.json");
+  await (0, import_promises7.writeFile)(filePath, generateRailwayJson(options), "utf-8");
   return filePath;
 }
 
@@ -1973,7 +2191,7 @@ var RailwayAdapter = class {
       appName: config.appName,
       region: config.region
     };
-    const deployDirectory = (0, import_node_path9.join)(config.projectRoot, ".kora", "deploy");
+    const deployDirectory = (0, import_node_path10.join)(config.projectRoot, ".kora", "deploy");
     await writeRailwayJsonArtifact(deployDirectory, {
       appName: config.appName,
       environment: config.environment
@@ -1984,12 +2202,12 @@ var RailwayAdapter = class {
     });
     const client = config.deployTarget === "sync-server" ? null : await buildClient({
       projectRoot: config.projectRoot,
-      outDir: (0, import_node_path9.join)(deployDirectory, "dist"),
+      outDir: (0, import_node_path10.join)(deployDirectory, "dist"),
       mode: "production"
     });
     return {
       clientDirectory: client?.outDir ?? null,
-      serverBundlePath: (0, import_node_path9.join)(deployDirectory, "server-bundled.js"),
+      serverBundlePath: (0, import_node_path10.join)(deployDirectory, "server-bundled.js"),
       deployDirectory
     };
   }
@@ -2274,8 +2492,8 @@ function createDeployAdapter(platform) {
 }
 
 // src/commands/deploy/artifacts/dockerfile-generator.ts
-var import_promises7 = require("fs/promises");
-var import_node_path10 = require("path");
+var import_promises8 = require("fs/promises");
+var import_node_path11 = require("path");
 var GENERATED_HEADER3 = "# Generated by kora deploy \u2014 do not edit manually";
 function generateDockerfile(options = {}) {
   const nodeVersion = options.nodeVersion ?? "20-alpine";
@@ -2341,37 +2559,37 @@ function generateDockerIgnore() {
   ].join("\n");
 }
 async function writeDockerfileArtifact(deployDirectory, options = {}) {
-  await (0, import_promises7.mkdir)(deployDirectory, { recursive: true });
-  const dockerfilePath = (0, import_node_path10.join)(deployDirectory, "Dockerfile");
-  await (0, import_promises7.writeFile)(dockerfilePath, generateDockerfile(options), "utf-8");
+  await (0, import_promises8.mkdir)(deployDirectory, { recursive: true });
+  const dockerfilePath = (0, import_node_path11.join)(deployDirectory, "Dockerfile");
+  await (0, import_promises8.writeFile)(dockerfilePath, generateDockerfile(options), "utf-8");
   if (options.nativeDependencies && Object.keys(options.nativeDependencies).length > 0) {
-    const pkgJsonPath = (0, import_node_path10.join)(deployDirectory, "package.json");
-    await (0, import_promises7.writeFile)(pkgJsonPath, generateDeployPackageJson(options.nativeDependencies), "utf-8");
+    const pkgJsonPath = (0, import_node_path11.join)(deployDirectory, "package.json");
+    await (0, import_promises8.writeFile)(pkgJsonPath, generateDeployPackageJson(options.nativeDependencies), "utf-8");
   }
   return dockerfilePath;
 }
 async function writeDockerIgnoreArtifact(deployDirectory) {
-  await (0, import_promises7.mkdir)(deployDirectory, { recursive: true });
-  const dockerIgnorePath = (0, import_node_path10.join)(deployDirectory, ".dockerignore");
-  await (0, import_promises7.writeFile)(dockerIgnorePath, generateDockerIgnore(), "utf-8");
+  await (0, import_promises8.mkdir)(deployDirectory, { recursive: true });
+  const dockerIgnorePath = (0, import_node_path11.join)(deployDirectory, ".dockerignore");
+  await (0, import_promises8.writeFile)(dockerIgnorePath, generateDockerIgnore(), "utf-8");
   return dockerIgnorePath;
 }
 
 // src/commands/deploy/state/deploy-state.ts
-var import_promises8 = require("fs/promises");
-var import_node_path11 = require("path");
-var KORA_DEPLOY_DIRECTORY = (0, import_node_path11.join)(".kora", "deploy");
+var import_promises9 = require("fs/promises");
+var import_node_path12 = require("path");
+var KORA_DEPLOY_DIRECTORY = (0, import_node_path12.join)(".kora", "deploy");
 var DEPLOY_STATE_FILENAME = "deploy.json";
 function resolveDeployDirectory(projectRoot) {
-  return (0, import_node_path11.join)(projectRoot, KORA_DEPLOY_DIRECTORY);
+  return (0, import_node_path12.join)(projectRoot, KORA_DEPLOY_DIRECTORY);
 }
 function resolveDeployStatePath(projectRoot) {
-  return (0, import_node_path11.join)(resolveDeployDirectory(projectRoot), DEPLOY_STATE_FILENAME);
+  return (0, import_node_path12.join)(resolveDeployDirectory(projectRoot), DEPLOY_STATE_FILENAME);
 }
 async function readDeployState(projectRoot) {
   const statePath = resolveDeployStatePath(projectRoot);
   try {
-    const source = await (0, import_promises8.readFile)(statePath, "utf-8");
+    const source = await (0, import_promises9.readFile)(statePath, "utf-8");
     const parsed = JSON.parse(source);
     return parseDeployState(parsed);
   } catch (error) {
@@ -2418,13 +2636,13 @@ async function updateDeployState(projectRoot, patch, now = /* @__PURE__ */ new D
   return nextState;
 }
 async function resetDeployState(projectRoot) {
-  await (0, import_promises8.rm)(resolveDeployDirectory(projectRoot), { recursive: true, force: true });
+  await (0, import_promises9.rm)(resolveDeployDirectory(projectRoot), { recursive: true, force: true });
 }
 async function persistDeployState(projectRoot, state) {
   const deployDir = resolveDeployDirectory(projectRoot);
   const statePath = resolveDeployStatePath(projectRoot);
-  await (0, import_promises8.mkdir)(deployDir, { recursive: true });
-  await (0, import_promises8.writeFile)(statePath, `${JSON.stringify(state, null, 2)}
+  await (0, import_promises9.mkdir)(deployDir, { recursive: true });
+  await (0, import_promises9.writeFile)(statePath, `${JSON.stringify(state, null, 2)}
 `, "utf-8");
 }
 function parseDeployState(value) {
@@ -2474,7 +2692,7 @@ function readOptionalString(value, field) {
 }
 
 // src/commands/deploy/deploy-command.ts
-var deployCommand = (0, import_citty.defineCommand)({
+var deployCommand = (0, import_citty2.defineCommand)({
   meta: {
     name: "deploy",
     description: "Deploy a Kora project to your selected platform"
@@ -2509,7 +2727,7 @@ var deployCommand = (0, import_citty.defineCommand)({
     }
   },
   subCommands: {
-    status: (0, import_citty.defineCommand)({
+    status: (0, import_citty2.defineCommand)({
       meta: {
         name: "status",
         description: "Show current deployment status"
@@ -2540,7 +2758,7 @@ var deployCommand = (0, import_citty.defineCommand)({
         logger.step(`Sync URL: ${state.syncUrl ?? "n/a"}`);
       }
     }),
-    rollback: (0, import_citty.defineCommand)({
+    rollback: (0, import_citty2.defineCommand)({
       meta: {
         name: "rollback",
         description: "Rollback the current deployment"
@@ -2571,7 +2789,7 @@ var deployCommand = (0, import_citty.defineCommand)({
         logger.success(`Rolled back ${state.platform} deployment to ${deploymentId}.`);
       }
     }),
-    logs: (0, import_citty.defineCommand)({
+    logs: (0, import_citty2.defineCommand)({
       meta: {
         name: "logs",
         description: "Read deployment logs"
@@ -2758,7 +2976,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_path12.basename)(projectRoot));
+  return sanitizeAppName((0, import_node_path13.basename)(projectRoot));
 }
 function resolveRegion(argValue, storedValue, confirm) {
   if (typeof argValue === "string" && argValue.length > 0) return argValue;
@@ -2793,7 +3011,7 @@ function configureAdapterContext(adapter, context) {
   }
 }
 function detectDeployTarget(projectRoot) {
-  return (0, import_node_fs2.existsSync)((0, import_node_path12.join)(projectRoot, "src-tauri")) ? "sync-server" : "full-stack";
+  return (0, import_node_fs2.existsSync)((0, import_node_path13.join)(projectRoot, "src-tauri")) ? "sync-server" : "full-stack";
 }
 function hasContextSetter(adapter) {
   return typeof adapter.setContext === "function";
@@ -3104,8 +3322,8 @@ function formatStoredPreferenceLabel(preferences) {
 }
 
 // src/commands/create/sync-provider-preset.ts
-var import_promises9 = require("fs/promises");
-var import_node_path13 = require("path");
+var import_promises10 = require("fs/promises");
+var import_node_path14 = require("path");
 async function applySyncProviderPreset(options) {
   if (!isSyncTemplate(options.template)) {
     return;
@@ -3115,10 +3333,10 @@ async function applySyncProviderPreset(options) {
   }
   const providerName = getProviderDisplayName(options.dbProvider);
   const providerConnectionString = getProviderConnectionStringExample(options.dbProvider);
-  const envPath = (0, import_node_path13.join)(options.targetDir, ".env.example");
-  const readmePath = (0, import_node_path13.join)(options.targetDir, "README.md");
-  const existingReadme = await (0, import_promises9.readFile)(readmePath, "utf-8");
-  const existingEnv = await (0, import_promises9.readFile)(envPath, "utf-8");
+  const envPath = (0, import_node_path14.join)(options.targetDir, ".env.example");
+  const readmePath = (0, import_node_path14.join)(options.targetDir, "README.md");
+  const existingReadme = await (0, import_promises10.readFile)(readmePath, "utf-8");
+  const existingEnv = await (0, import_promises10.readFile)(envPath, "utf-8");
   const trimmedReadme = existingReadme.trimEnd();
   const trimmedEnv = existingEnv.trimEnd();
   const envSuffix = [
@@ -3138,9 +3356,9 @@ async function applySyncProviderPreset(options) {
     ""
   ].join("\n");
   const readmeTemplate = `${trimmedReadme}${readmeSuffix}`;
-  await (0, import_promises9.writeFile)(envPath, `${trimmedEnv}${envSuffix}
+  await (0, import_promises10.writeFile)(envPath, `${trimmedEnv}${envSuffix}
 `, "utf-8");
-  await (0, import_promises9.writeFile)(readmePath, readmeTemplate, "utf-8");
+  await (0, import_promises10.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";
@@ -3183,6 +3401,7 @@ function getProviderConnectionStringExample(provider) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AGENTS_FRAMEWORKS,
   ClackPromptClient,
   CliError,
   DEPLOY_PLATFORMS,
@@ -3201,13 +3420,16 @@ function getProviderConnectionStringExample(provider) {
   StubDeployAdapter,
   TEMPLATES,
   TEMPLATE_INFO,
+  agentsCommand,
   applySyncProviderPreset,
   buildClient,
   bundleServer,
   createDeployAdapter,
   createPromptClient,
   deployCommand,
+  detectFrameworkFromManifest,
   determineTemplateFromSelections,
+  generateAgentsMd,
   generateDeployPackageJson,
   generateDockerIgnore,
   generateDockerfile,
@@ -3216,6 +3438,7 @@ function getProviderConnectionStringExample(provider) {
   generateTypes,
   getCreatePreferencesOrDefault,
   getDefaultCreatePreferences,
+  isAgentsFramework,
   isAuthValue,
   isDatabaseProviderValue,
   isDatabaseValue,