@cosmicdrift/kumiko-dev-server 0.19.1 → 0.21.0

package/LICENSE

@@ -21,7 +21,7 @@ managed offering of the Licensed Work.
 This restriction does not apply to the Licensor, any entity controlled by, 
 controlling, or under common control with the Licensor ("Affiliates"), or 
 contractors acting on their behalf. The Licensor remains free to use the 
-Licensed Work for any purpose, including for the operation of kumiko.so.
+Licensed Work for any purpose, including for the operation of kumiko.rocks.
 
 Change Date:          2030-05-05
 Change License:       Apache License, Version 2.0

package/bin/kumiko-dev.ts

@@ -10,7 +10,7 @@
 //     Crash-Loop-Schutz via createCrashTracker. Verhindert Endlos-Loop
 //     bei syntaktisch totem bin/main.ts und gibt dem User trotzdem
 //     "Live-Edit"-Feeling: ein Code-Fehler in einem Feature killt nicht
-//     die ganze yarn-dev-Session.
+//     die ganze bun-dev-Session.
 //   - Signal-killed (SIGINT/SIGTERM): wir folgen dem Caller, exit 0.
 //
 // Nutzung: `kumiko-dev src/app/server.ts` in package.json:
@@ -74,7 +74,7 @@ const spawnServer = (): void => {
     if (!allowed) {
       process.stderr.write(
         `[kumiko-dev] ${MAX_CRASHES} Crashes in ${CRASH_WINDOW_MS / 1000}s — aufgeben (exit ${code}). ` +
-          "Fehler oben fixen und yarn dev erneut starten.\n",
+          "Fehler oben fixen und bun dev erneut starten.\n",
       );
       process.exit(code);
       return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-dev-server",
-  "version": "0.19.1",
+  "version": "0.21.0",
   "description": "Development server bootstrap for Kumiko apps. Bundles the client, mints dev-JWTs, injects the resolved AppSchema, and seeds an admin. Not for production.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -12,7 +12,7 @@
   "bugs": {
     "url": "https://github.com/CosmicDriftGameStudio/kumiko-framework/issues"
   },
-  "homepage": "https://kumiko.so",
+  "homepage": "https://kumiko.rocks",
   "type": "module",
   "kumiko": {
     "runtime": "dev"

package/src/__tests__/build-prod-bundle.test.ts

@@ -3,7 +3,7 @@
 // Bun.build und Tailwind-CLI brauchen einen Bun-Runtime, deshalb
 // werden die hier nicht aufgerufen — nur Discovery + HTML-Injection
 // die unter Node funktionieren. End-to-End-Tests (mit echtem Bun.build)
-// laufen im CI als `yarn build` auf der Showcase-App; das ist der
+// laufen im CI als `bun run build` auf der Showcase-App; das ist der
 // ehrlichere Smoke-Test.
 
 import { afterEach, beforeEach, describe, expect, test } from "bun:test";

package/src/__tests__/build-server-bundle.test.ts

@@ -0,0 +1,64 @@
+import { describe, expect, test } from "bun:test";
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { buildServerBundle } from "../build-server-bundle";
+
+// Baut ein Mini-App-Fixture (bin/main.ts + bin/kumiko.ts teilen ein Modul) und
+// prüft das Variante-B-Verhalten: ein Bun.build-Call → server.js + kumiko.js als
+// Entries + geteilter chunk statt zwei vollen Bundles.
+function makeFixture(): string {
+  const dir = mkdtempSync(join(tmpdir(), "server-bundle-"));
+  mkdirSync(join(dir, "bin"));
+  mkdirSync(join(dir, "src"));
+  writeFileSync(join(dir, "package.json"), `${JSON.stringify({ name: "fixture-app" })}\n`);
+  writeFileSync(join(dir, "src/shared.ts"), "export function shared(): number { return 42; }\n");
+  // main.ts → wird zu server.js umbenannt; kumiko.ts macht findRepoRoot zum
+  // repoRoot dieses Fixtures, also wird kumiko.js gebaut.
+  writeFileSync(
+    join(dir, "bin/main.ts"),
+    `import { shared } from "../src/shared";\nconsole.log("server", shared());\n`,
+  );
+  writeFileSync(
+    join(dir, "bin/kumiko.ts"),
+    `import { shared } from "../src/shared";\nconsole.log("migrate", shared());\n`,
+  );
+  return dir;
+}
+
+describe("buildServerBundle (multi-entry + splitting)", () => {
+  test("produces server.js + kumiko.js as entries + a shared chunk", async () => {
+    const dir = makeFixture();
+    try {
+      const result = await buildServerBundle({ cwd: dir, outDir: join(dir, "dist-server") });
+      const outDir = result.outDir;
+
+      // main.ts wurde zu server.js umbenannt.
+      expect(existsSync(join(outDir, "server.js"))).toBe(true);
+      expect(existsSync(join(outDir, "main.js"))).toBe(false);
+      expect(existsSync(join(outDir, "kumiko.js"))).toBe(true);
+
+      const entryFiles = result.entries.map((e) => e.file).sort();
+      expect(entryFiles).toEqual(["kumiko.js", "server.js"]);
+
+      // Das geteilte Modul liegt in einem chunk, nicht in beiden Entries inlined.
+      expect(result.chunks.length).toBeGreaterThanOrEqual(1);
+      const serverSrc = readFileSync(join(outDir, "server.js"), "utf8");
+      expect(serverSrc).toContain("chunk-");
+
+      // Kein Legacy-Drizzle-Output mehr.
+      expect(existsSync(join(outDir, "migration-hooks.js"))).toBe(false);
+      expect(existsSync(join(outDir, "drizzle.config.ts"))).toBe(false);
+
+      // Runtime-package.json mit start-Script, ohne drizzle-deps.
+      const pkg = JSON.parse(readFileSync(join(outDir, "package.json"), "utf8"));
+      expect(pkg.scripts.start).toBe("bun run server.js");
+      expect(Object.keys(pkg.dependencies)).not.toContain("drizzle-kit");
+      expect(Object.keys(pkg.dependencies)).not.toContain("drizzle-orm");
+
+      expect(result.totalBytes).toBeGreaterThan(0);
+    } finally {
+      rmSync(dir, { recursive: true, force: true });
+    }
+  });
+});

package/src/__tests__/walkthrough.integration.test.ts

@@ -1,7 +1,7 @@
 // DX-3.1 — walkthrough-snapshot-test. Reproduces the 3-command path from
-// docs.kumiko.so/en/walkthrough/ in-process and asserts what the walkthrough
+// docs.kumiko.rocks/en/walkthrough/ in-process and asserts what the walkthrough
 // claims. Catches drift in scaffoldApp + scaffoldAppFeature against the
-// docs without an actual `bunx … && yarn install && bun run boot` CI run.
+// docs without an actual `bunx … && bun install && bun run boot` CI run.
 //
 // What this test pins:
 //   - scaffoldApp produces the 6 files the walkthrough lists

package/src/build-prod-bundle.ts

@@ -332,7 +332,7 @@ export function discoverHtmlTemplate(cwd: string): string | undefined {
 async function runTailwindOnce(entry: string, cwd: string): Promise<string> {
   if (!hasBun) {
     throw new Error(
-      "[kumiko build] Tailwind one-shot requires Bun (Bun.spawn) — run via `bun run …` or `yarn kumiko build`.",
+      "[kumiko build] Tailwind one-shot requires Bun (Bun.spawn) — run via `bun run …` or `bun kumiko build`.",
     );
   }
   const bunResolver = (globalThis as { Bun: { resolveSync: (id: string, from: string) => string } })
@@ -373,7 +373,7 @@ async function buildClientBundles(
   outDir: string,
 ): Promise<Record<string, string>> {
   if (!hasBun) {
-    throw new Error("[kumiko build] requires Bun — run via `bun run …` or `yarn kumiko build`.");
+    throw new Error("[kumiko build] requires Bun — run via `bun run …` or `bun kumiko build`.");
   }
   const built = await Bun.build({
     entrypoints: entries.map((e) => e.sourceFile),

package/src/build-server-bundle.ts

@@ -1,37 +1,27 @@
-// buildServerBundle — Production-Server-Bundle für Kumiko-Apps. Pendant
-// zu buildProdBundle (Client). Convention-Driven Discovery liest
-// bin/main.ts + optional drizzle/migration-hooks.ts und produziert ein
-// runtime-self-contained dist-server/ aus dem ein Bun-Alpine-Container
-// ohne Monorepo bootet.
+// buildServerBundle — Production-Server-Bundle für Kumiko-Apps. Pendant zu
+// buildProdBundle (Client). Convention-Driven Discovery liest bin/main.ts
+// (+ optional <repo>/bin/kumiko.ts) und produziert ein runtime-self-contained
+// dist-server/ aus dem ein Bun-Alpine-Container ohne Monorepo bootet.
 //
 // Convention:
 //
-//   bin/main.ts                      →  dist-server/server.js
-//                                       (App-Boot, ruft runProdApp)
-//   <repo>/bin/kumiko.ts             →  dist-server/kumiko.js
-//                                       (Migrate-CLI für Pre-Deploy-Step,
-//                                        gefunden durch walk-up bis bin/kumiko.ts)
-//   drizzle/migration-hooks.ts       →  dist-server/migration-hooks.js
-//                                       (optional — Projection-Rebuild-Marker-
-//                                        Reader, wird via KUMIKO_MIGRATION_HOOKS
-//                                        env-var von der CLI gefunden)
-//   drizzle.config.ts                →  dist-server/drizzle.config.ts
-//                                       (drizzle-kit lädt's per Convention.
-//                                        kumikoDrizzleConfig-Helper-Imports
-//                                        werden inlined damit der Container
-//                                        kein @cosmicdrift/kumiko-dev-server-Paket
-//                                        installiert haben muss.)
-//   dist-server/package.json         →  generiert mit Versionen aus framework +
-//                                       bundled-features package.json
+//   bin/main.ts            →  dist-server/server.js   (App-Boot, ruft runProdApp)
+//   <repo>/bin/kumiko.ts   →  dist-server/kumiko.js   (Migrate-CLI: `schema apply`,
+//                             gefunden via walk-up bis bin/kumiko.ts)
+//   dist-server/package.json → runtime-deps mit gepinnten Versionen
+//
+// Beide Entries werden in EINEM Bun.build-Call mit `splitting` gebaut: das
+// Framework landet als geteilte chunk-*.js, server.js + kumiko.js sind schlanke
+// Entries die sie importieren — statt das Framework pro Entry neu zu inlinen
+// (vorher ~14 MB × N separate Bundles).
 //
 // Output:
 //
 //   dist-server/
-//     server.js                      ← App-Boot-Entry (~1 MB)
-//     kumiko.js                      ← Migrate-CLI (~1 MB)
-//     migration-hooks.js             ← Rebuild-Marker-Reader (optional, ~1 MB)
-//     drizzle.config.ts              ← gebundelter drizzle-kit-Config (~10 KB)
-//     package.json                   ← runtime-deps mit gepinnten Versionen
+//     server.js            ← App-Boot-Entry
+//     kumiko.js            ← Migrate-CLI-Entry (wenn bin/kumiko.ts gefunden)
+//     chunk-*.js           ← geteilte Framework-Chunks
+//     package.json         ← runtime-deps mit gepinnten Versionen
 //
 // Externals — Pakete die NICHT ins Bundle gebakt werden, sondern via
 // `bun install` im Runtime-Container nachgeholt werden:
@@ -41,52 +31,34 @@
 //                       dist-server/package.json#dependencies.
 //
 //   BUILD_ONLY_EXTERNALS — referenziert nur transitiv im Framework, vom
-//                          App-Code aber nie. Tree-Shake wirft sie aus
-//                          dem Bundle, der external-Marker schaltet nur
-//                          das resolution-during-build ab. NICHT in
-//                          runtime-deps.
-//
-// Beide Listen leben hier zentral statt pro-App. Wenn eine App ein neues
-// natively-bound Paket nutzt, fällt es heute in die App-eigene Boilerplate
-// (oder via opts.extraRuntimeExternals) — das wird sich mit
-// auto-Detection entwickeln.
+//                          App-Code aber nie. Tree-Shake wirft sie aus dem
+//                          Bundle, der external-Marker schaltet nur das
+//                          resolution-during-build ab. NICHT in runtime-deps.
 
-import { existsSync, readFileSync } from "node:fs";
-import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
 
 const hasBun = typeof (globalThis as { Bun?: unknown }).Bun !== "undefined";
 
-// Pakete die das Bundle zur Laufzeit weiter referenziert (`from "<pkg>"`
-// nach Tree-Shake). Native bindings (argon2), worker-thread-Loader (bullmq,
-// ioredis), dynamic-require (postgres, temporal-polyfill) — alles was
-// unter Bun-bundling bricht.
-//
-// `drizzle-kit` + `drizzle-orm` sind im Bundle 0 Refs (drizzle-orm wird
-// inline gebakt), liegen aber in runtime-deps damit der Pre-Deploy-
-// Migrate-Step (`bun /app/kumiko.js migrate apply`) drizzle-kit als CLI
-// findet. drizzle-kit prüft beim Start ob drizzle-orm separat installiert
-// ist und exit'tet sonst mit "Please install latest version of drizzle-orm".
+// Pakete die das Bundle zur Laufzeit weiter referenziert (`from "<pkg>"` nach
+// Tree-Shake). Native bindings (argon2), worker-thread-Loader (bullmq,
+// ioredis), dynamic-require (postgres, temporal-polyfill) — alles was unter
+// Bun-bundling bricht. (drizzle-kit/drizzle-orm sind raus: der Migrate-Pfad
+// nutzt jetzt den framework-eigenen runMigrationsFromDir, kein drizzle-kit.)
 const RUNTIME_EXTERNALS = [
   "@node-rs/argon2",
   "bullmq",
-  "drizzle-kit",
-  "drizzle-orm",
   "ioredis",
   "postgres",
   "temporal-polyfill",
 ] as const;
 
-// Pakete die nur im Build-Stack erscheinen (transitive Imports im
-// Framework), aber vom App-Code nicht referenziert werden. Ohne external-
-// Markierung scheitert bun build an dynamic-imports (z.B. drizzle-kit →
-// @libsql/client). Tree-Shake wirft sie eh aus dem Bundle — der Marker
-// schaltet nur das resolution-during-build ab. NICHT in runtime-deps.
-//
-// drizzle-kit's dialect-resolver macht dynamic-imports zu allen DB-driver-
-// packages (planetscale/libsql/sqlite/neon/vercel/mysql2). Wir nutzen nur
-// postgres → diese werden never-loaded zur Runtime, aber der Bundler will
-// sie resolven. Aufgedeckt durch C1 Empfehlung 4 (bundle-smoke).
+// Pakete die nur im Build-Stack erscheinen (transitive Imports im Framework),
+// aber vom App-Code nicht referenziert werden. Ohne external-Markierung
+// scheitert bun build an dynamic-imports. Tree-Shake wirft sie eh aus dem
+// Bundle — der Marker schaltet nur das resolution-during-build ab. NICHT in
+// runtime-deps.
 const BUILD_ONLY_EXTERNALS = [
   "meilisearch",
   "pino",
@@ -121,12 +93,20 @@ export type BuildServerBundleEntry = {
 
 export type BuildServerBundleResult = {
   readonly outDir: string;
+  /** Benannte Entry-Files (server.js, ggf. kumiko.js). */
   readonly entries: readonly BuildServerBundleEntry[];
+  /** Geteilte Framework-Chunks (von splitting). */
+  readonly chunks: readonly BuildServerBundleEntry[];
+  /** Gesamt-Größe aller Outputs (entries + chunks) in Bytes. */
+  readonly totalBytes: number;
   readonly runtimeDeps: Readonly<Record<string, string>>;
-  /** undefined wenn keine drizzle/migration-hooks.ts existiert. */
-  readonly migrationHooks: BuildServerBundleEntry | undefined;
 };
 
+// Bun benennt Entries nach Source-Basename (bin/main.ts → main.js). server.js
+// ist die Runtime-Convention; der Entry wird von nichts importiert (nur die
+// chunks werden referenziert, per relativem Pfad), darum ist der Rename sicher.
+const ENTRY_RENAMES: Readonly<Record<string, string>> = { "main.js": "server.js" };
+
 export async function buildServerBundle(
   options: BuildServerBundleOptions = {},
 ): Promise<BuildServerBundleResult> {
@@ -151,8 +131,6 @@ export async function buildServerBundle(
       `[buildServerBundle] Repo-Root erkannt (${repoRoot}), aber bin/kumiko.ts fehlt — kann Migrate-CLI nicht bündeln.`,
     );
   }
-  const migrationHooks = discoverMigrationHooks(cwd);
-  const drizzleConfig = discoverDrizzleConfig(cwd);
 
   const externals = [
     ...RUNTIME_EXTERNALS,
@@ -164,29 +142,42 @@ export async function buildServerBundle(
   await rm(outDir, { recursive: true, force: true });
   await mkdir(outDir, { recursive: true });
 
-  const entries: BuildServerBundleEntry[] = [];
-  entries.push(await bundleEntry(serverEntry, outDir, "server.js", externals));
-  if (kumikoCli) {
-    entries.push(await bundleEntry(kumikoCli, outDir, "kumiko.js", externals));
-  }
-  let migrationHooksEntry: BuildServerBundleEntry | undefined;
-  if (migrationHooks) {
-    migrationHooksEntry = await bundleEntry(
-      migrationHooks,
-      outDir,
-      "migration-hooks.js",
-      externals,
-    );
-    entries.push(migrationHooksEntry);
+  // Ein Bun.build-Call mit allen Entries + splitting → das Framework wird
+  // einmal als shared chunk abgelegt statt pro Entry inlined.
+  const entrypoints = kumikoCli ? [serverEntry, kumikoCli] : [serverEntry];
+  const result = await Bun.build({
+    entrypoints,
+    outdir: outDir,
+    target: "bun",
+    external: externals as string[],
+    splitting: true,
+    sourcemap: "none",
+    naming: { entry: "[name].js", chunk: "chunk-[hash].js" },
+    minify: false,
+  });
+  if (!result.success) {
+    const logs = result.logs.map(String).join("\n");
+    throw new Error(`[buildServerBundle] build FAILED:\n${logs}`);
   }
-  // drizzle.config.ts wird mit-bundelt damit drizzle-kit migrate im
-  // Runtime-Container den kumikoDrizzleConfig-Helper nicht via
-  // @cosmicdrift/kumiko-dev-server resolven muss (das Paket ist nicht installiert).
-  // Output behält die .ts-Endung — drizzle-kit's TS-Loader akzeptiert
-  // bundled JavaScript.
-  if (drizzleConfig) {
-    entries.push(await bundleEntry(drizzleConfig, outDir, "drizzle.config.ts", externals));
+
+  // Größe von Disk lesen, nicht aus out.size — letzteres ist für gesplittete
+  // Entry-Points unzuverlässig (meldet teils ~0 für den Entry-Stub).
+  const entries: BuildServerBundleEntry[] = [];
+  const chunks: BuildServerBundleEntry[] = [];
+  for (const out of result.outputs) {
+    const base = out.path.split("/").pop() ?? out.path;
+    if (out.kind === "entry-point") {
+      const desired = ENTRY_RENAMES[base] ?? base;
+      if (desired !== base) {
+        await rename(join(outDir, base), join(outDir, desired));
+      }
+      entries.push({ file: desired, sizeBytes: statSync(join(outDir, desired)).size });
+    } else if (out.kind === "chunk") {
+      chunks.push({ file: base, sizeBytes: statSync(join(outDir, base)).size });
+    }
   }
+  entries.sort((a, b) => a.file.localeCompare(b.file));
+  const totalBytes = [...entries, ...chunks].reduce((sum, e) => sum + e.sizeBytes, 0);
 
   const runtimeDeps = await resolveRuntimeDepsVersions(repoRoot, [
     ...RUNTIME_EXTERNALS,
@@ -202,32 +193,7 @@ export async function buildServerBundle(
   };
   await writeFile(join(outDir, "package.json"), `${JSON.stringify(runtimePkg, null, 2)}\n`);
 
-  return { outDir, entries, runtimeDeps, migrationHooks: migrationHooksEntry };
-}
-
-async function bundleEntry(
-  entry: string,
-  outDir: string,
-  naming: string,
-  externals: readonly string[],
-): Promise<BuildServerBundleEntry> {
-  const result = await Bun.build({
-    entrypoints: [entry],
-    outdir: outDir,
-    target: "bun",
-    external: externals as string[],
-    naming,
-    minify: false,
-  });
-  if (!result.success) {
-    const logs = result.logs.map(String).join("\n");
-    throw new Error(`[buildServerBundle] Bundle ${naming} FAILED:\n${logs}`);
-  }
-  const out = result.outputs[0];
-  if (!out) {
-    throw new Error(`[buildServerBundle] Bundle ${naming}: no output produced.`);
-  }
-  return { file: naming, sizeBytes: out.size };
+  return { outDir, entries, chunks, totalBytes, runtimeDeps };
 }
 
 export function discoverServerEntry(cwd: string): string | undefined {
@@ -238,20 +204,9 @@ export function discoverServerEntry(cwd: string): string | undefined {
   return undefined;
 }
 
-export function discoverDrizzleConfig(cwd: string): string | undefined {
-  const path = join(cwd, "drizzle.config.ts");
-  return existsSync(path) ? path : undefined;
-}
-
-export function discoverMigrationHooks(cwd: string): string | undefined {
-  const path = join(cwd, "drizzle/migration-hooks.ts");
-  return existsSync(path) ? path : undefined;
-}
-
-// Walking up vom App-cwd bis ein Verzeichnis mit `bin/kumiko.ts` und einer
-// monorepo-package.json (workspaces[]) gefunden wird. Failsafe: nach 8
-// Levels aufgeben — nichts gefunden, kein Repo-Root, dann liefert die
-// Funktion undefined und der Caller skippt das CLI-Bundle.
+// Walking up vom App-cwd bis ein Verzeichnis mit `bin/kumiko.ts` gefunden wird.
+// Failsafe: nach 8 Levels aufgeben — nichts gefunden, kein Repo-Root, dann
+// liefert die Funktion undefined und der Caller skippt das CLI-Bundle.
 function findRepoRoot(start: string): string | undefined {
   let cur = start;
   for (let i = 0; i < 8; i++) {
@@ -313,14 +268,22 @@ export function formatServerBuildResult(
   const dim = "\x1b[2m";
   const green = "\x1b[32m";
   const reset = "\x1b[0m";
+  const mb = (bytes: number): string => (bytes / 1024 / 1024).toFixed(2);
   const lines: string[] = [];
   lines.push("");
   lines.push(`  ${green}✓${reset} server bundle ${dim}(${durationMs}ms)${reset}`);
   for (const entry of result.entries) {
-    const sizeMb = (entry.sizeBytes / 1024 / 1024).toFixed(2);
-    lines.push(`    ${cyan}→${reset} ${entry.file}  ${sizeMb} MB`);
+    lines.push(`    ${cyan}→${reset} ${entry.file}  ${mb(entry.sizeBytes)} MB`);
+  }
+  if (result.chunks.length > 0) {
+    const chunkBytes = result.chunks.reduce((sum, c) => sum + c.sizeBytes, 0);
+    lines.push(
+      `    ${cyan}→${reset} ${result.chunks.length} shared chunk(s)  ${mb(chunkBytes)} MB`,
+    );
   }
   const depCount = Object.keys(result.runtimeDeps).length;
-  lines.push(`    ${dim}runtime-deps: ${depCount} packages${reset}`);
+  lines.push(
+    `    ${dim}total: ${mb(result.totalBytes)} MB · runtime-deps: ${depCount} packages${reset}`,
+  );
   return lines.join("\n");
 }

package/src/build.ts

@@ -21,8 +21,6 @@ export {
   type BuildServerBundleOptions,
   type BuildServerBundleResult,
   buildServerBundle,
-  discoverDrizzleConfig,
-  discoverMigrationHooks,
   discoverServerEntry,
   formatServerBuildResult,
 } from "./build-server-bundle";

package/src/codegen/render.ts

@@ -29,7 +29,7 @@ import { rewriteImportPath } from "./scan-events";
 const HEADER = [
   "// =====================================================================",
   "// AUTO-GENERATED — DO NOT EDIT BY HAND",
-  "// Run `yarn kumiko codegen` to regenerate (or rely on the dev-server's",
+  "// Run `bun kumiko codegen` to regenerate (or rely on the dev-server's",
   "// file-watcher, which calls it on every r.defineEvent change).",
   "// =====================================================================",
 ].join("\n");
@@ -129,7 +129,7 @@ export function renderInlineSchemasFile(
     "// Schema extracts purely for type inference: this file is referenced",
     "// from types.generated.d.ts via `import type`. ts-strip elides it at",
     "// build time, so there is NO runtime duplication of the inline schemas",
-    "// in feature files. When an event schema changes: re-run `yarn kumiko",
+    "// in feature files. When an event schema changes: re-run `bun kumiko",
     "// codegen` — otherwise the z.infer type drifts from the runtime schema.",
     "",
     `import { z } from "zod";`,

package/src/codegen/run-codegen.ts

@@ -1,5 +1,5 @@
 // runCodegen — Top-Level Entry-Point. Wird vom Dev-Server (auf Boot),
-// vom Build-Step (vor Bundle) und von der CLI (`yarn kumiko codegen`)
+// vom Build-Step (vor Bundle) und von der CLI (`bun kumiko codegen`)
 // aufgerufen.
 //
 // Lifecycle:

package/src/create-kumiko-server.ts

@@ -221,7 +221,7 @@ const AUTH_COOKIE = "kumiko_auth";
 //     die erste bootId; wenn nach einem Reconnect (Server-Restart!) eine
 //     ANDERE bootId kommt, refresh — sonst bleibt der Browser ewig auf
 //     dem alten Bundle hängen wenn der Watcher classifyChange="restart"
-//     gewählt hat oder der User Ctrl-C/yarn dev gemacht hat.
+//     gewählt hat oder der User Ctrl-C/bun dev gemacht hat.
 const RELOAD_SNIPPET = `
 <script>
   (() => {

package/src/run-dev-app.ts

@@ -161,7 +161,7 @@ export async function runDevApp(options: RunDevAppOptions): Promise<KumikoServer
   // Idempotent (writeIfChanged) — der TS-Sprachserver kriegt nur einen
   // Reload-Tick wenn sich tatsächlich was geändert hat.
   //
-  // App-Root ist process.cwd() (yarn-dev läuft vom App-Workspace). Der
+  // App-Root ist process.cwd() (bun-dev läuft vom App-Workspace). Der
   // Watcher läuft solange der Dev-Server lebt; close() bei Shutdown
   // wird über das createKumikoServer-Handle implizit erledigt (Bun's
   // process-exit räumt fs.watch-handles auf).

package/src/run-prod-app.ts

@@ -6,7 +6,7 @@
 //   - Hard Schema-Drift-Gate: prüft drizzle/migrations/_journal vs.
 //     __drizzle_migrations + tableExists für jede erwartete Tabelle.
 //     KEIN Auto-CREATE TABLE im Boot — Migration ist ein CI-Step
-//     (`yarn kumiko migrate apply`), Boot validiert nur. Verhindert
+//     (`bun kumiko migrate apply`), Boot validiert nur. Verhindert
 //     Race-Conditions bei Multi-Replica-Deploys + macht Schema-Stand
 //     reviewbar in der Pull-Request.
 //   - Idempotente Seeds: laufen nur wenn DB leer (über `isDbEmpty`-Probe

package/src/scaffold-app-feature.ts

@@ -72,7 +72,7 @@ function renderFeature(name: string): string {
   const camel = kebabToCamel(name);
   return `// ${name} feature — scaffolded by \`kumiko add feature\`. Edit freely.
 //
-// Doc-Pointer: https://docs.kumiko.so/en/patterns/ for the \`r.*\` API
+// Doc-Pointer: https://docs.kumiko.rocks/en/patterns/ for the \`r.*\` API
 // (r.entity, r.writeHandler, r.queryHandler, hooks, …).
 
 import { defineFeature } from "@cosmicdrift/kumiko-framework/engine";

package/src/scaffold-app.ts

@@ -249,7 +249,7 @@ function renderMain(appName: string): string {
       "// Production-bootstrap. KUMIKO_DRY_RUN_ENV=boot exits after",
       "// composeFeatures + validateBoot + createRegistry without DB/Redis-connect",
       "// (siehe @cosmicdrift/kumiko-dev-server runProdApp). Echter Dev-Boot",
-      "// passiert via `yarn kumiko dev` (in-repo dev-tool) mit Docker-stack — DX-1.0 deckt nur",
+      "// passiert via `bun kumiko dev` (in-repo dev-tool) mit Docker-stack — DX-1.0 deckt nur",
       "// den boot-mode-Pfad ab; `kumiko dev` kommt in einer späteren DX-Phase.",
       "",
       "",
@@ -282,7 +282,7 @@ mounted (foundation set). Add features with \`bunx @cosmicdrift/kumiko-cli add f
 ## First boot
 
 \`\`\`sh
-yarn install
+bun install
 cp .env.example .env
 # edit .env — set JWT_SECRET + KUMIKO_SECRETS_MASTER_KEY_V1
 bun run boot
@@ -302,7 +302,7 @@ bunx @cosmicdrift/kumiko-cli add feature my-domain
 - \`src/run-config.ts\` — single source of truth: which features your app mounts.
 - \`bin/main.ts\` — production-bootstrap. Reads env, mounts features, starts server.
 
-For full docs see https://docs.kumiko.so.
+For full docs see https://docs.kumiko.rocks.
 `;
 }
 

package/src/scaffold-feature.ts

@@ -1,12 +1,12 @@
 // scaffoldFeature — generate a fresh feature workspace from a name.
-// Used by `yarn kumiko create <name>` and (later) by the Designer when
+// Used by `bun kumiko create <name>` and (later) by the Designer when
 // a tenant scaffolds a new feature inside their repo. Wraps the
 // canonical-form renderer (feature-ast/render.ts) so every freshly
 // scaffolded feature is born in canonical Object-Form with the
 // schema-version header set.
 //
 // The generated workspace is intentionally minimal: a single entity
-// pattern as a starter, so the user has something to point a "yarn
+// pattern as a starter, so the user has something to point a "bun
 // kumiko dev" at and immediately see something on screen. Adding more
 // patterns is the user's job (or the Designer's / AI's, on top of this
 // scaffolding).
@@ -48,7 +48,7 @@ export type ScaffoldFeatureResult = {
 /**
  * Generate a starter feature workspace at `destination`. Throws when
  * the destination already exists — refuses to overwrite. The caller is
- * expected to run `yarn install` afterwards to wire the workspace.
+ * expected to run `bun install` afterwards to wire the workspace.
  */
 export function scaffoldFeature(options: ScaffoldFeatureOptions): ScaffoldFeatureResult {
   const featureName = validateFeatureName(options.name);
@@ -156,7 +156,7 @@ function renderPackageJson(packageName: string): string {
   return `${JSON.stringify(
     {
       name: packageName,
-      description: "Kumiko sample feature — scaffolded by `yarn kumiko create`",
+      description: "Kumiko sample feature — scaffolded by `bun kumiko create`",
       private: true,
       dependencies: {
         "@cosmicdrift/kumiko-framework": "workspace:*",
@@ -170,7 +170,7 @@ function renderPackageJson(packageName: string): string {
 /**
  * Standard tsconfig matching the rest of the sample workspaces:
  * strict, ESNext, bundler-resolution, no-emit. Without this file
- * `yarn install + tsc` immediately complains about missing config —
+ * `bun install + tsc` immediately complains about missing config —
  * scaffolded features should compile cleanly out of the box.
  */
 function renderTsconfig(): string {
@@ -210,7 +210,7 @@ const SYNTHETIC_LOC: SourceLocation = {
 
 function starterPatterns(): readonly FeaturePattern[] {
   // One entity, one field. Smallest interesting output: parses, renders,
-  // can be `yarn kumiko dev`'d, and gives the user something to extend.
+  // can be `bun kumiko dev`'d, and gives the user something to extend.
   return [
     {
       kind: "entity",