@holo-js/cli 0.2.4 → 0.2.6

package/dist/agent-skills-CHAXS2YN.mjs

@@ -0,0 +1,180 @@
+// src/agent-skills.ts
+import { homedir } from "os";
+import { dirname, resolve } from "path";
+import { mkdir, readFile, writeFile } from "fs/promises";
+var SUPPORTED_AGENT_SKILL_TARGETS = [
+  "codex",
+  "claude",
+  "cursor",
+  "windsurf",
+  "opencode",
+  "gemini",
+  "kiro"
+];
+var HOLO_AGENT_SKILL = `---
+name: holo-js
+description: Help users build applications with the Holo-JS framework by researching the current Holo-JS documentation at https://docs.holo-js.com/ before answering or coding. Use when a user asks how to scaffold, configure, integrate, or implement Holo-JS app features in Nuxt, Next.js, or SvelteKit, including database, ORM, auth, authorization, validation, forms, storage, media, queues, events, broadcast, realtime, mail, notifications, testing, or deployment. Prefer this for user-facing app work, not Holo-JS framework internals.
+---
+
+# Holo-JS
+
+Use the docs as the source of truth, then act. Do not answer from memory when exact commands, imports, API names, config shape, route shape, or framework integration details matter.
+
+Primary documentation URL: https://docs.holo-js.com/
+
+## Required Workflow
+
+1. Clarify the user's task category in your own reasoning: setup, config, database, ORM, auth, authorization, validation/forms, storage/media, queue/events, broadcast/realtime, mail/notifications, testing, deployment, or framework integration.
+2. Search the live docs before giving implementation details.
+3. Open the most relevant docs page and read only the sections that match the task.
+4. Open at most one adjacent or overview page when the task touches package setup, framework integration, auth/session/security, background workers, or deployment.
+5. Stop researching as soon as the docs provide enough information to implement the requested task.
+6. Implement the task immediately using the docs you just read.
+7. Mention when docs do not cover the requested detail and ask for a docs link or local project context.
+
+Do not read package implementation files after docs lookup unless one of these is true:
+
+- the docs are missing the API detail required to compile the code
+- the implementation already failed and you need source to debug the failure
+- the user explicitly asks you to inspect package internals
+
+## How To Search
+
+Prefer these approaches, in order:
+
+1. Use the docs site's own search if you have browser access.
+2. Use web search with \`site:docs.holo-js.com\` plus the concrete feature terms.
+3. Open likely docs URLs from search results, then follow sidebar or in-page links to related pages.
+4. If working inside the Holo-JS repository, search local docs source under \`apps/docs/docs/**/*.md\` with \`rg\` as a fallback or for faster exact matching.
+
+Good search queries:
+
+- \`site:docs.holo-js.com Holo-JS install <package-or-feature>\`
+- \`site:docs.holo-js.com Holo-JS <framework> <feature>\`
+- \`site:docs.holo-js.com Holo-JS <api-or-command-name>\`
+- \`site:docs.holo-js.com Holo-JS <error message or concept>\`
+
+Local repo fallback:
+
+\`\`\`bash
+rg -n "<feature|api|command|error>" apps/docs/docs
+find apps/docs/docs -type f -name '*.md' | sort
+\`\`\`
+
+## What To Open
+
+Use docs pages by task area, not by package guesses. Examples:
+
+- Starting a project: installation, configuration, directory structure.
+- Framework routing or handlers: routing, runtime services, framework-specific integration pages.
+- Database and models: database pages first, then ORM pages.
+- Auth flows: auth overview plus the specific flow page, then session/cookies or current auth client if state is involved.
+- Authorization: authorization overview plus policies or abilities.
+- Forms: forms overview plus server validation, client usage, and framework integration as needed.
+- Files: storage first; media only when files belong to models or need conversions/collections.
+- Background work: queue, events, queued listeners, workers, failed jobs, and deployment pages as needed.
+- Browser realtime: broadcast or realtime docs plus framework helper pages.
+- Production behavior: deployment plus any worker/driver page for the feature.
+
+These names are navigation hints, not an API reference. Confirm exact paths and examples from the docs before responding.
+
+## Answering Rules
+
+- Cite or link the docs pages you used when the environment supports links.
+- Keep examples aligned with the user's framework and package manager.
+- Preserve framework-native routing, redirect, server action, and handler conventions shown by the docs.
+- Do not invent helper APIs to make an answer look cleaner.
+- Do not assume optional packages are installed. Check install/setup docs for the feature.
+- Do not expose secrets in client code or examples.
+- Do not hand-edit generated Holo-JS output unless docs explicitly instruct it.
+- If docs and installed package behavior disagree, tell the user what you found and verify the smallest relevant package surface before continuing.
+
+## Coding Against An Existing App
+
+When editing a user's app:
+
+1. Inspect the app's framework, package manager, installed \`@holo-js/*\` packages, and existing Holo-JS config.
+2. Search docs for the exact feature and framework.
+3. Match the app's existing conventions.
+4. Add validation and authorization at boundaries when the docs indicate they are required.
+5. Run the app's relevant typecheck, lint, and tests when available.
+
+If the user asks for a broad implementation such as "add auth" or "add realtime", start from the docs' setup/overview pages and implement the smallest complete vertical slice rather than assembling APIs from memory.
+`;
+function resolveAgentSkillPath(root, agent) {
+  return resolve(root, agentRoot(agent), "skills/holo-js/SKILL.md");
+}
+function resolveGlobalAgentSkillPath(agent) {
+  const home = homedir();
+  if (agent === "opencode") {
+    return resolve(home, ".config/opencode/skills/holo-js/SKILL.md");
+  }
+  return resolveAgentSkillPath(home, agent);
+}
+function agentRoot(agent) {
+  if (agent === "claude") {
+    return ".claude";
+  }
+  if (agent === "opencode") {
+    return ".opencode";
+  }
+  return `.${agent}`;
+}
+async function readExisting(path) {
+  try {
+    return await readFile(path, "utf8");
+  } catch (error) {
+    if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") {
+      return void 0;
+    }
+    throw error;
+  }
+}
+function normalizeAgentSkillTargets(values) {
+  const requested = values.length > 0 ? values : ["all"];
+  const agents = /* @__PURE__ */ new Set();
+  for (const value of requested) {
+    const normalized = value.trim().toLowerCase();
+    if (!normalized) {
+      continue;
+    }
+    if (normalized === "all") {
+      for (const agent of SUPPORTED_AGENT_SKILL_TARGETS) {
+        agents.add(agent);
+      }
+      continue;
+    }
+    if (!SUPPORTED_AGENT_SKILL_TARGETS.includes(normalized)) {
+      throw new Error(`Unsupported agent skill target: ${value}.`);
+    }
+    agents.add(normalized);
+  }
+  return [...agents];
+}
+async function installAgentSkills(projectRoot, options) {
+  const results = [];
+  for (const agent of options.agents) {
+    const path = options.global === true ? resolveGlobalAgentSkillPath(agent) : resolveAgentSkillPath(projectRoot, agent);
+    const existing = await readExisting(path);
+    if (existing === HOLO_AGENT_SKILL) {
+      results.push({ agent, path, status: "unchanged" });
+      continue;
+    }
+    if (typeof existing === "string" && options.force !== true) {
+      throw new Error(`Refusing to overwrite existing ${agent} skill at ${path}. Re-run with --force to replace it.`);
+    }
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, HOLO_AGENT_SKILL, "utf8");
+    results.push({
+      agent,
+      path,
+      status: typeof existing === "string" ? "updated" : "created"
+    });
+  }
+  return results;
+}
+export {
+  SUPPORTED_AGENT_SKILL_TARGETS,
+  installAgentSkills,
+  normalizeAgentSkillTargets
+};

package/dist/bin/holo.mjs

@@ -30,7 +30,7 @@ import {
 } from "../chunk-LBJAJLKU.mjs";
 import "../chunk-D7O4SU6N.mjs";
 import "../chunk-VP2E62DF.mjs";
-import "../chunk-LGU5YVKP.mjs";
+import "../chunk-7B2RVYLL.mjs";
 import "../chunk-YEFJBN56.mjs";
 import "../chunk-J76GH2DR.mjs";
 import {
@@ -112,6 +112,7 @@ var AUTH_INSTALL_FEATURES = ["social", "workos", "clerk"];
 var AUTH_SOCIAL_PROVIDER_MODES = ["default", "specific"];
 var EVENTS_QUEUE_ACTIONS = ["skip", "enable"];
 var MODEL_GENERATOR_OPTIONS = ["migration", "observer", "seeder", "factory"];
+var COMMAND_LIST_DESCRIPTION_COLUMN = 32;
 var runtimeModulePromise;
 var queueModulePromise;
 var cacheModulePromise;
@@ -126,44 +127,45 @@ var projectConfigModulePromise;
 var projectDiscoveryModulePromise;
 var projectRuntimeModulePromise;
 var projectScaffoldModulePromise;
+var agentSkillsModulePromise;
 function loadRuntimeModule() {
-  runtimeModulePromise ??= import("../runtime-7KCBHTRV.mjs");
+  runtimeModulePromise ??= import("../runtime-RPMZMTD4.mjs");
   return runtimeModulePromise;
 }
 function loadQueueModule() {
-  queueModulePromise ??= import("../queue-HB22LB66.mjs");
+  queueModulePromise ??= import("../queue-D4LSWNS2.mjs");
   return queueModulePromise;
 }
 function loadCacheModule() {
-  cacheModulePromise ??= import("../cache-4OVL2YTS.mjs");
+  cacheModulePromise ??= import("../cache-OSJ4PD52.mjs");
   return cacheModulePromise;
 }
 function loadQueueMigrationsModule() {
-  queueMigrationsModulePromise ??= import("../queue-migrations-FENTWONO.mjs");
+  queueMigrationsModulePromise ??= import("../queue-migrations-LXEWXJYT.mjs");
   return queueMigrationsModulePromise;
 }
 function loadCacheMigrationsModule() {
-  cacheMigrationsModulePromise ??= import("../cache-migrations-LGTPRUDS.mjs");
+  cacheMigrationsModulePromise ??= import("../cache-migrations-FKAHRP24.mjs");
   return cacheMigrationsModulePromise;
 }
 function loadMediaMigrationsModule() {
-  mediaMigrationsModulePromise ??= import("../media-migrations-N63DGHGG.mjs");
+  mediaMigrationsModulePromise ??= import("../media-migrations-BNVAPYEM.mjs");
   return mediaMigrationsModulePromise;
 }
 function loadGeneratorsModule() {
-  generatorsModulePromise ??= import("../generators-Y47HYPQT.mjs");
+  generatorsModulePromise ??= import("../generators-VCYISHWO.mjs");
   return generatorsModulePromise;
 }
 function loadBroadcastModule() {
-  broadcastModulePromise ??= import("../broadcast-AVYI67BU.mjs");
+  broadcastModulePromise ??= import("../broadcast-JBQWQZSO.mjs");
   return broadcastModulePromise;
 }
 function loadSecurityModule() {
-  securityModulePromise ??= import("../security-QFDYNF2Z.mjs");
+  securityModulePromise ??= import("../security-K5PZS3E3.mjs");
   return securityModulePromise;
 }
 function loadDevModule() {
-  devModulePromise ??= import("../dev-WOOZOWLR.mjs");
+  devModulePromise ??= import("../dev-YPBQBEOE.mjs");
   return devModulePromise;
 }
 function loadProjectConfigModule() {
@@ -179,9 +181,13 @@ function loadProjectRuntimeModule() {
   return projectRuntimeModulePromise;
 }
 function loadProjectScaffoldModule() {
-  projectScaffoldModulePromise ??= import("../scaffold-3LLBQ2JF.mjs");
+  projectScaffoldModulePromise ??= import("../scaffold-NJ5VH73M.mjs");
   return projectScaffoldModulePromise;
 }
+function loadAgentSkillsModule() {
+  agentSkillsModulePromise ??= import("../agent-skills-CHAXS2YN.mjs");
+  return agentSkillsModulePromise;
+}
 async function resolveRuntimeExecutor(runtimeExecutor) {
   return runtimeExecutor ?? (await loadRuntimeModule()).withRuntimeEnvironment;
 }
@@ -249,23 +255,47 @@ function createCommandContext(io, projectRoot, loadProject, input) {
     loadProject
   };
 }
+function serializePassthroughInput(input) {
+  const tokens = [...input.args];
+  for (const [name, value] of Object.entries(input.flags)) {
+    if (value === false) {
+      continue;
+    }
+    const flag = name.length === 1 ? `-${name}` : `--${name}`;
+    const values = Array.isArray(value) ? value : [value];
+    for (const currentValue of values) {
+      tokens.push(flag);
+      if (currentValue !== true) {
+        tokens.push(String(currentValue));
+      }
+    }
+  }
+  return tokens;
+}
 function printCommandList(io, registry) {
   const internal = registry.filter((command) => command.source === "internal");
   const app = registry.filter((command) => command.source === "app");
-  writeLine(io.stdout, "Internal Commands");
-  for (const command of internal) {
-    writeLine(io.stdout, `  ${command.usage}  ${command.description}`);
-  }
+  writeLine(io.stdout, "Usage:");
+  writeLine(io.stdout, "  holo <command> [options] [arguments]");
   writeLine(io.stdout);
-  writeLine(io.stdout, "App Commands");
+  writeLine(io.stdout, "Internal commands:");
+  printCommandListEntries(io, internal);
+  writeLine(io.stdout);
+  writeLine(io.stdout, "App commands:");
   if (app.length === 0) {
     writeLine(io.stdout, "  (none)");
     return;
   }
-  for (const command of app) {
-    writeLine(io.stdout, `  ${command.usage}  ${command.description}`);
+  printCommandListEntries(io, app);
+}
+function printCommandListEntries(io, commands) {
+  for (const command of commands) {
+    printCommandListEntry(io, command);
   }
 }
+function printCommandListEntry(io, command) {
+  writeLine(io.stdout, `  ${command.name.padEnd(COMMAND_LIST_DESCRIPTION_COLUMN)}${command.description}`);
+}
 function printCommandHelp(io, command) {
   writeLine(io.stdout, command.usage);
   writeLine(io.stdout, command.description);
@@ -368,6 +398,50 @@ function createInternalCommands(context, runtimeExecutor, queueExecutors = {}, p
         writeLine(context.stdout, `  ${resolvePackageManagerDevCommand(packageManager)}`);
       }
     },
+    {
+      name: "agents:install",
+      aliases: ["agent:install", "ai:install"],
+      description: "Install Holo-JS docs-search skills for coding agents.",
+      usage: "holo agents:install [--agent <all|codex|claude|cursor|windsurf|opencode|gemini|kiro>] [--global] [--force]",
+      source: "internal",
+      async prepare(input) {
+        const { normalizeAgentSkillTargets, SUPPORTED_AGENT_SKILL_TARGETS } = await loadAgentSkillsModule();
+        const requestedAgents = (collectMultiStringFlag(input.flags, "agent") ?? []).flatMap((entry) => splitCsv(entry) ?? []);
+        const agents = requestedAgents.length > 0 ? normalizeAgentSkillTargets(requestedAgents) : isInteractive(context, input.flags) ? await promptMultiChoice(context, "Coding agents", SUPPORTED_AGENT_SKILL_TARGETS, {
+          required: true,
+          initialValues: [...SUPPORTED_AGENT_SKILL_TARGETS]
+        }) : normalizeAgentSkillTargets([]);
+        return {
+          args: [],
+          flags: {
+            agent: agents,
+            ...resolveBooleanFlag(input.flags, "global") === true ? { global: true } : {},
+            ...resolveBooleanFlag(input.flags, "force") === true ? { force: true } : {}
+          }
+        };
+      },
+      async run(commandContext) {
+        const { installAgentSkills } = await loadAgentSkillsModule();
+        const agents = collectMultiStringFlag(commandContext.flags, "agent") ?? [];
+        const results = await installAgentSkills(context.projectRoot, {
+          agents,
+          global: commandContext.flags.global === true,
+          force: commandContext.flags.force === true
+        });
+        const created = results.filter((result) => result.status === "created").length;
+        const updated = results.filter((result) => result.status === "updated").length;
+        const unchanged = results.filter((result) => result.status === "unchanged").length;
+        const changed = created + updated;
+        writeLine(
+          context.stdout,
+          changed > 0 ? "Installed Holo-JS agent skills." : "Holo-JS agent skills are already installed."
+        );
+        for (const result of results) {
+          writeLine(context.stdout, `  - ${result.status} ${result.agent}: ${result.path}`);
+        }
+        writeLine(context.stdout, `  - summary: ${created} created, ${updated} updated, ${unchanged} unchanged`);
+      }
+    },
     {
       name: "key:generate",
       description: "Generate APP_KEY in the project .env file when it is missing.",
@@ -751,13 +825,18 @@ function createInternalCommands(context, runtimeExecutor, queueExecutors = {}, p
     {
       name: "start",
       description: "Run the production framework server with Holo runtime preloads.",
-      usage: "holo start",
+      usage: "holo start [...frameworkArgs]",
       source: "internal",
-      async prepare() {
-        return { args: [], flags: {} };
+      async prepare(input) {
+        return { args: input.args, flags: input.flags };
       },
-      async run() {
+      async run(input) {
         const runProjectStartServer = await resolveProjectExecutor(projectExecutors, "runProjectStartServer");
+        const passthroughArgs = serializePassthroughInput(input);
+        if (passthroughArgs.length > 0) {
+          await runProjectStartServer(context, context.projectRoot, void 0, passthroughArgs);
+          return;
+        }
         await runProjectStartServer(context, context.projectRoot);
       }
     },
@@ -1577,7 +1656,8 @@ function findCommand(registry, name) {
 async function runCli(argv, io) {
   try {
     const requestedCommandName = argv[0];
-    const projectRoot = requestedCommandName === "new" ? io.cwd : await (await loadProjectRuntimeModule()).findProjectRoot(io.cwd);
+    const usesCurrentDirectoryAsProjectRoot = requestedCommandName === "new" || requestedCommandName === "agents:install" || requestedCommandName === "agent:install" || requestedCommandName === "ai:install";
+    const projectRoot = usesCurrentDirectoryAsProjectRoot ? io.cwd : await (await loadProjectRuntimeModule()).findProjectRoot(io.cwd);
     let cachedProject;
     const loadProject = async () => {
       cachedProject ??= await (await loadProjectConfigModule()).loadProjectConfig(projectRoot);
@@ -1592,7 +1672,7 @@ async function runCli(argv, io) {
     };
     const internalCommands = createInternalCommands(internalContext);
     const registry = [...internalCommands];
-    const canSkipAppDiscovery = requestedCommandName === "config:cache" || requestedCommandName === "config:clear" || requestedCommandName === "key:generate" || requestedCommandName === "new" || requestedCommandName === "install" || requestedCommandName === "auth:notifications:publish" || requestedCommandName === "prepare" || requestedCommandName === "dev" || requestedCommandName === "build" || requestedCommandName === "cache:table" || requestedCommandName === "cache:clear" || requestedCommandName === "cache:forget" || requestedCommandName === "media:table" || requestedCommandName === "broadcast:work" || requestedCommandName === "queue:table" || requestedCommandName === "queue:failed-table" || requestedCommandName === "queue:work" || requestedCommandName === "queue:listen" || requestedCommandName === "queue:failed" || requestedCommandName === "queue:retry" || requestedCommandName === "queue:forget" || requestedCommandName === "queue:flush" || requestedCommandName === "queue:restart" || requestedCommandName === "queue:clear" || requestedCommandName === "rate-limit:clear";
+    const canSkipAppDiscovery = requestedCommandName === "config:cache" || requestedCommandName === "config:clear" || requestedCommandName === "key:generate" || requestedCommandName === "new" || requestedCommandName === "install" || requestedCommandName === "agents:install" || requestedCommandName === "agent:install" || requestedCommandName === "ai:install" || requestedCommandName === "auth:notifications:publish" || requestedCommandName === "prepare" || requestedCommandName === "dev" || requestedCommandName === "build" || requestedCommandName === "cache:table" || requestedCommandName === "cache:clear" || requestedCommandName === "cache:forget" || requestedCommandName === "media:table" || requestedCommandName === "broadcast:work" || requestedCommandName === "queue:table" || requestedCommandName === "queue:failed-table" || requestedCommandName === "queue:work" || requestedCommandName === "queue:listen" || requestedCommandName === "queue:failed" || requestedCommandName === "queue:retry" || requestedCommandName === "queue:forget" || requestedCommandName === "queue:flush" || requestedCommandName === "queue:restart" || requestedCommandName === "queue:clear" || requestedCommandName === "rate-limit:clear";
     if (!canSkipAppDiscovery) {
       const initialProject = await loadProject();
       const appCommands = (await (await loadProjectDiscoveryModule()).discoverAppCommands(projectRoot, initialProject.config)).map((entry) => createAppCommandDefinition(entry));

package/dist/{broadcast-AVYI67BU.mjs → broadcast-JBQWQZSO.mjs}

@@ -9,7 +9,7 @@ import "./chunk-D7O4SU6N.mjs";
 import {
   prepareProjectDiscovery
 } from "./chunk-VP2E62DF.mjs";
-import "./chunk-LGU5YVKP.mjs";
+import "./chunk-7B2RVYLL.mjs";
 import {
   loadProjectConfig
 } from "./chunk-YEFJBN56.mjs";
@@ -146,6 +146,7 @@ async function createRealtimeWorkerBindings(projectRoot) {
       return await withRealtimeRequest(options.context, async (authRequest) => {
         return await realtime.subscribeRealtimeQuery(await resolveDefinition(name), args, {
           onData: options.onData,
+          onPatch: options.onPatch,
           onError: options.onError
         }, { authRequest });
       });

package/dist/{broadcast-CMPONJ5J.mjs → broadcast-YGJFCEPP.mjs}

@@ -9,7 +9,7 @@ import "./chunk-D7O4SU6N.mjs";
 import {
   prepareProjectDiscovery
 } from "./chunk-VP2E62DF.mjs";
-import "./chunk-6UDDQUXY.mjs";
+import "./chunk-C624G3R2.mjs";
 import {
   loadProjectConfig
 } from "./chunk-YEFJBN56.mjs";
@@ -146,6 +146,7 @@ async function createRealtimeWorkerBindings(projectRoot) {
       return await withRealtimeRequest(options.context, async (authRequest) => {
         return await realtime.subscribeRealtimeQuery(await resolveDefinition(name), args, {
           onData: options.onData,
+          onPatch: options.onPatch,
           onError: options.onError
         }, { authRequest });
       });

package/dist/{cache-2EUUQJX2.mjs → cache-HUGRWOHQ.mjs}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-I7QBCEV7.mjs";
 import "./chunk-D7O4SU6N.mjs";
 import "./chunk-VP2E62DF.mjs";
-import "./chunk-6UDDQUXY.mjs";
+import "./chunk-C624G3R2.mjs";
 import "./chunk-YEFJBN56.mjs";
 import "./chunk-J76GH2DR.mjs";
 import {

package/dist/{cache-4OVL2YTS.mjs → cache-OSJ4PD52.mjs}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-I7QBCEV7.mjs";
 import "./chunk-D7O4SU6N.mjs";
 import "./chunk-VP2E62DF.mjs";
-import "./chunk-LGU5YVKP.mjs";
+import "./chunk-7B2RVYLL.mjs";
 import "./chunk-YEFJBN56.mjs";
 import "./chunk-J76GH2DR.mjs";
 import {

package/dist/{cache-migrations-LGTPRUDS.mjs → cache-migrations-77TLXIVG.mjs}

@@ -1,6 +1,6 @@
 import {
   runProjectPrepare
-} from "./chunk-HZJWXL2W.mjs";
+} from "./chunk-4K4CWMMP.mjs";
 import "./chunk-FGQ2I2YH.mjs";
 import {
   getRegistryMigrationSlug,
@@ -8,15 +8,15 @@ import {
   hasRegisteredMigrationSlug,
   nextMigrationTemplate
 } from "./chunk-LXGQCG56.mjs";
+import "./chunk-LBJAJLKU.mjs";
 import {
   writeLine
 } from "./chunk-I7QBCEV7.mjs";
-import "./chunk-LBJAJLKU.mjs";
 import "./chunk-D7O4SU6N.mjs";
 import {
   prepareProjectDiscovery
 } from "./chunk-VP2E62DF.mjs";
-import "./chunk-LGU5YVKP.mjs";
+import "./chunk-C624G3R2.mjs";
 import {
   ensureProjectConfig
 } from "./chunk-YEFJBN56.mjs";
@@ -94,14 +94,14 @@ function renderCacheTableMigration(tableName = DEFAULT_CACHE_DATABASE_TABLE, loc
   const entryTableDefinition = resolveCacheDatabaseTableDefinition("entries");
   const lockTableDefinition = resolveCacheDatabaseTableDefinition("locks");
   return [
-    "import { defineMigration, type MigrationContext } from '@holo-js/db'",
+    "import { defineMigration } from '@holo-js/db'",
     "",
     "export default defineMigration({",
-    "  async up({ schema }: MigrationContext) {",
+    "  async up({ schema }) {",
     ...renderCacheTableCreateStatement(tableName, entryTableDefinition),
     ...renderCacheTableCreateStatement(lockTableName, lockTableDefinition),
     "  },",
-    "  async down({ schema }: MigrationContext) {",
+    "  async down({ schema }) {",
     `    await schema.dropTable('${escapeSingleQuotedString(lockTableName)}')`,
     `    await schema.dropTable('${escapeSingleQuotedString(tableName)}')`,
     "  },",

package/dist/{cache-migrations-TJWWJB4I.mjs → cache-migrations-FKAHRP24.mjs}

@@ -1,6 +1,6 @@
 import {
   runProjectPrepare
-} from "./chunk-ZHFXVJBE.mjs";
+} from "./chunk-AJLRAC5M.mjs";
 import "./chunk-FGQ2I2YH.mjs";
 import {
   getRegistryMigrationSlug,
@@ -8,15 +8,15 @@ import {
   hasRegisteredMigrationSlug,
   nextMigrationTemplate
 } from "./chunk-LXGQCG56.mjs";
-import "./chunk-LBJAJLKU.mjs";
 import {
   writeLine
 } from "./chunk-I7QBCEV7.mjs";
+import "./chunk-LBJAJLKU.mjs";
 import "./chunk-D7O4SU6N.mjs";
 import {
   prepareProjectDiscovery
 } from "./chunk-VP2E62DF.mjs";
-import "./chunk-6UDDQUXY.mjs";
+import "./chunk-7B2RVYLL.mjs";
 import {
   ensureProjectConfig
 } from "./chunk-YEFJBN56.mjs";
@@ -94,14 +94,14 @@ function renderCacheTableMigration(tableName = DEFAULT_CACHE_DATABASE_TABLE, loc
   const entryTableDefinition = resolveCacheDatabaseTableDefinition("entries");
   const lockTableDefinition = resolveCacheDatabaseTableDefinition("locks");
   return [
-    "import { defineMigration, type MigrationContext } from '@holo-js/db'",
+    "import { defineMigration } from '@holo-js/db'",
     "",
     "export default defineMigration({",
-    "  async up({ schema }: MigrationContext) {",
+    "  async up({ schema }) {",
     ...renderCacheTableCreateStatement(tableName, entryTableDefinition),
     ...renderCacheTableCreateStatement(lockTableName, lockTableDefinition),
     "  },",
-    "  async down({ schema }: MigrationContext) {",
+    "  async down({ schema }) {",
     `    await schema.dropTable('${escapeSingleQuotedString(lockTableName)}')`,
     `    await schema.dropTable('${escapeSingleQuotedString(tableName)}')`,
     "  },",

package/dist/{chunk-HZJWXL2W.mjs → chunk-4K4CWMMP.mjs}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-VP2E62DF.mjs";
 import {
   syncManagedDriverDependencies
-} from "./chunk-LGU5YVKP.mjs";
+} from "./chunk-C624G3R2.mjs";
 import {
   ensureGeneratedSchemaPlaceholder,
   ensureProjectConfig
@@ -97,9 +97,9 @@ async function runProjectBuild(io, projectRoot, spawn2 = spawnSync) {
     throw new Error(result.stderr?.trim() || result.stdout?.trim() || "Project build failed.");
   }
 }
-async function runProjectStartServer(io, projectRoot, spawnProcess = spawn) {
+async function runProjectStartServer(io, projectRoot, spawnProcess = spawn, passthroughArgs = []) {
   const invocation = resolveFrameworkRunnerInvocation(projectRoot, "start");
-  const child = spawnProcess(invocation.command, [...invocation.args], {
+  const child = spawnProcess(invocation.command, [...invocation.args, ...passthroughArgs], {
     cwd: projectRoot,
     env: process.env,
     stdio: ["pipe", "pipe", "pipe"]