@cosmicdrift/kumiko-dev-server 0.13.0 → 0.15.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-dev-server",
-  "version": "0.13.0",
+  "version": "0.15.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>",
@@ -30,17 +30,13 @@
       "types": "./src/compose-features.ts",
       "default": "./src/compose-features.ts"
     },
-    "./drizzle-config": {
-      "types": "./src/drizzle-config.ts",
-      "default": "./src/drizzle-config.ts"
+    "./schema-tables-auth-mode": {
+      "types": "./src/schema-tables-auth-mode.ts",
+      "default": "./src/schema-tables-auth-mode.ts"
     },
-    "./drizzle-tables-auth-mode": {
-      "types": "./src/drizzle-tables-auth-mode.ts",
-      "default": "./src/drizzle-tables-auth-mode.ts"
-    },
-    "./drizzle-tables-minimal": {
-      "types": "./src/drizzle-tables-minimal.ts",
-      "default": "./src/drizzle-tables-minimal.ts"
+    "./schema-tables-minimal": {
+      "types": "./src/schema-tables-minimal.ts",
+      "default": "./src/schema-tables-minimal.ts"
     }
   },
   "bin": {
@@ -49,8 +45,9 @@
     "kumiko-schema-check": "./bin/kumiko-schema-check.ts"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-bundled-features": "0.13.0",
-    "@cosmicdrift/kumiko-framework": "0.13.0"
+    "@cosmicdrift/kumiko-bundled-features": "0.14.0",
+    "@cosmicdrift/kumiko-framework": "0.14.0",
+    "ts-morph": "^28.0.0"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
@@ -62,4 +59,4 @@
     "README.md",
     "LICENSE"
   ]
-}
+}

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

@@ -12,13 +12,13 @@
 //      braucht Bun. Spawnen kumiko-build als subprocess via PATH.
 //      Skipped wenn `bun` nicht erreichbar — selten, aber sauber.
 
+import { afterEach, beforeEach, describe, expect, test } from "bun:test";
 import { execFileSync } from "node:child_process";
 import { existsSync } from "node:fs";
 import { mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { afterEach, beforeEach, describe, expect, test } from "vitest";
 import { buildProdBundle } from "../build-prod-bundle";
 
 const __filename = fileURLToPath(import.meta.url);

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

@@ -6,11 +6,11 @@
 // laufen im CI als `yarn build` auf der Showcase-App; das ist der
 // ehrlichere Smoke-Test.
 
+import { afterEach, beforeEach, describe, expect, test } from "bun:test";
 import { existsSync } from "node:fs";
 import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
-import { afterEach, beforeEach, describe, expect, test } from "vitest";
 import {
   type ClientEntry,
   discoverClientEntries,

package/src/__tests__/cache-headers.test.ts

@@ -7,7 +7,7 @@
 //   /manifest.json, /sw.js  → no-cache
 //   alles andere            → kein expliziter Header
 
-import { describe, expect, test } from "vitest";
+import { describe, expect, test } from "bun:test";
 import { cacheHeadersFor } from "../run-prod-app";
 
 describe("cacheHeadersFor", () => {

package/src/__tests__/classify-change.test.ts

@@ -5,7 +5,7 @@
 // Restarts (DX schlecht) oder echte Schema-Änderungen schlagen
 // nicht durch (UX broken). Beide sind teuer — daher pinnen wir.
 
-import { describe, expect, test } from "vitest";
+import { describe, expect, test } from "bun:test";
 import { classifyChange } from "../create-kumiko-server";
 
 describe("classifyChange", () => {

package/src/__tests__/compose-features-wiring.integration.ts

@@ -21,6 +21,7 @@
 // schreibt in ein lokales Array — gewollter Capture-Spy ohne vitest-
 // Mock-API (CLAUDE.md "Kein Mock in *.integration.ts").
 
+import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, test } from "bun:test";
 import { randomBytes } from "node:crypto";
 import {
   AuthErrors,
@@ -34,6 +35,7 @@ import {
 import { tenantEntity, tenantMembershipsTable } from "@cosmicdrift/kumiko-bundled-features/tenant";
 import { seedTenantMembership } from "@cosmicdrift/kumiko-bundled-features/tenant/testing";
 import { UserHandlers, userEntity, userTable } from "@cosmicdrift/kumiko-bundled-features/user";
+import { deleteMany } from "@cosmicdrift/kumiko-framework/bun-db";
 import type { TenantId } from "@cosmicdrift/kumiko-framework/engine";
 import {
   setupTestStack,
@@ -42,7 +44,6 @@ import {
   unsafeCreateEntityTable,
   unsafePushTables,
 } from "@cosmicdrift/kumiko-framework/stack";
-import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, test } from "vitest";
 import { composeFeatures } from "../compose-features";
 
 const RESET_HMAC = randomBytes(32).toString("base64");
@@ -151,8 +152,8 @@ describe("composeFeatures wiring — passwordReset", () => {
   });
 
   beforeEach(async () => {
-    await suite.stack.db.delete(userTable);
-    await suite.stack.db.delete(tenantMembershipsTable);
+    await deleteMany(suite.stack.db, userTable, {});
+    await deleteMany(suite.stack.db, tenantMembershipsTable, {});
     suite.resetEmails.length = 0;
     suite.verifyEmails.length = 0;
   });
@@ -225,8 +226,8 @@ describe("composeFeatures wiring — emailVerification", () => {
   });
 
   beforeEach(async () => {
-    await suite.stack.db.delete(userTable);
-    await suite.stack.db.delete(tenantMembershipsTable);
+    await deleteMany(suite.stack.db, userTable, {});
+    await deleteMany(suite.stack.db, tenantMembershipsTable, {});
     suite.resetEmails.length = 0;
     suite.verifyEmails.length = 0;
   });
@@ -271,8 +272,8 @@ describe("composeFeatures wiring — asymmetric activation", () => {
   });
 
   beforeEach(async () => {
-    await suite.stack.db.delete(userTable);
-    await suite.stack.db.delete(tenantMembershipsTable);
+    await deleteMany(suite.stack.db, userTable, {});
+    await deleteMany(suite.stack.db, tenantMembershipsTable, {});
     suite.resetEmails.length = 0;
     suite.verifyEmails.length = 0;
   });
@@ -325,8 +326,8 @@ describe("composeFeatures wiring — fail-closed ohne authOptions", () => {
   });
 
   afterEach(async () => {
-    await suite.stack.db.delete(userTable);
-    await suite.stack.db.delete(tenantMembershipsTable);
+    await deleteMany(suite.stack.db, userTable, {});
+    await deleteMany(suite.stack.db, tenantMembershipsTable, {});
     suite.resetEmails.length = 0;
   });
 

package/src/__tests__/compose-features.test.ts

@@ -7,8 +7,8 @@
 // aber die Handler fehlen → POST /api/auth/request-password-reset
 // dispatched ins Leere → 500.
 
+import { describe, expect, test } from "bun:test";
 import { defineFeature } from "@cosmicdrift/kumiko-framework/engine";
-import { describe, expect, test } from "vitest";
 import { composeFeatures } from "../compose-features";
 
 const noopFeature = defineFeature("noop-app", () => {});

package/src/__tests__/config-seed-boot.integration.ts

@@ -12,12 +12,14 @@
 //   3. an admin set on top of a seed wins the resolver cascade; coexistence
 //      vs. override semantics depend on the admin user's tenantId.
 
+import { afterAll, beforeAll, describe, expect, test } from "bun:test";
 import {
   configValuesTable,
   createConfigAccessorFactory,
   createConfigFeature,
   createConfigResolver,
 } from "@cosmicdrift/kumiko-bundled-features/config";
+import { selectMany } from "@cosmicdrift/kumiko-framework/bun-db";
 import {
   access,
   createSystemConfig,
@@ -32,7 +34,6 @@ import {
   TestUsers,
   unsafePushTables,
 } from "@cosmicdrift/kumiko-framework/stack";
-import { afterAll, beforeAll, describe, expect, test } from "vitest";
 import { applyBootSeeds } from "../boot/apply-boot-seeds";
 
 const bootSeedsFeature = defineFeature("boot-seeds-test", (r) => {
@@ -82,7 +83,7 @@ describe("config-seed boot wiring", () => {
   test("first boot: applyBootSeeds writes one row per seed", async () => {
     await applyBootSeeds({ registry: stack.registry, db: stack.db });
 
-    const rows = await stack.db.select().from(configValuesTable);
+    const rows = await selectMany(stack.db, configValuesTable);
     expect(rows.length).toBe(2);
 
     const siteKeyDef = stack.registry.getConfigKey(SITE_KEY);
@@ -111,7 +112,7 @@ describe("config-seed boot wiring", () => {
   test("re-boot: idempotent — every seed already on disk → no extra rows", async () => {
     await applyBootSeeds({ registry: stack.registry, db: stack.db });
 
-    const rows = await stack.db.select().from(configValuesTable);
+    const rows = await selectMany(stack.db, configValuesTable);
     expect(rows.length).toBe(2);
   });
 
@@ -151,7 +152,7 @@ describe("config-seed boot wiring", () => {
     //   - 3 rows = coexistence path (admin tenantId !== SYSTEM_TENANT_ID,
     //     new specific-tenant row sits next to the seed system-row).
     // Either is correct as long as the resolver picks the admin value.
-    const rows = await stack.db.select().from(configValuesTable);
+    const rows = await selectMany(stack.db, configValuesTable);
     expect([2, 3]).toContain(rows.length);
   });
 });

package/src/__tests__/crash-tracker.test.ts

@@ -3,7 +3,7 @@
 // Wrapper aufgibt oder noch eine Runde respawnt; off-by-one am Fenster-
 // Rand würde im Bin-Skript schlecht auffallen.
 
-import { describe, expect, test } from "vitest";
+import { describe, expect, test } from "bun:test";
 import { createCrashTracker } from "../crash-tracker";
 
 describe("createCrashTracker", () => {

package/src/__tests__/create-kumiko-server.integration.ts

@@ -1,14 +1,14 @@
+import { afterEach, describe, expect, test } from "bun:test";
 import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
+import { asRawClient } from "@cosmicdrift/kumiko-framework/bun-db";
 import {
   createBooleanField,
   createEntity,
   createTextField,
   defineFeature,
 } from "@cosmicdrift/kumiko-framework/engine";
-import { sql } from "drizzle-orm";
-import { afterEach, describe, expect, test } from "vitest";
 import { createKumikoServer, type KumikoServerHandle } from "../create-kumiko-server";
 
 // Integration-Test: bootet createKumikoServer mit echtem Postgres,
@@ -50,10 +50,10 @@ async function boot(): Promise<KumikoServerHandle> {
 describe("createKumikoServer", () => {
   test("bootet den Kumiko-Stack + legt die Feature-Tables an", async () => {
     const h = await boot();
-    const rows = await h.stack.db.execute<{ exists: boolean }>(
-      sql`SELECT to_regclass('public.kumiko_server_probe') IS NOT NULL AS exists`,
+    const rows = await asRawClient(h.stack.db).unsafe(
+      `SELECT to_regclass('public.kumiko_server_probe') IS NOT NULL AS "exists"`,
     );
-    expect(rows[0]?.exists).toBe(true);
+    expect((rows as Array<Record<string, unknown>>)[0]?.["exists"]).toBe(true);
   });
 
   test("GET / → HTML + kumiko_auth/kumiko_csrf Set-Cookie", async () => {

package/src/__tests__/env-schema.integration.ts

@@ -4,9 +4,9 @@
 // throws (via bootErrorReporter override) and KUMIKO_DRY_RUN_ENV
 // returns the dry-run handle without booting.
 
+import { describe, expect, it } from "bun:test";
 import { defineFeature } from "@cosmicdrift/kumiko-framework/engine";
 import { composeEnvSchema, KumikoBootError } from "@cosmicdrift/kumiko-framework/env";
-import { describe, expect, it } from "vitest";
 import { z } from "zod";
 import { frameworkCoreEnvSchema } from "../env-schema";
 import * as devServerPublicApi from "../index";

package/src/__tests__/env-schema.test.ts

@@ -1,5 +1,5 @@
+import { describe, expect, it } from "bun:test";
 import { composeEnvSchema, KumikoBootError, parseEnv } from "@cosmicdrift/kumiko-framework/env";
-import { describe, expect, it } from "vitest";
 import { z } from "zod";
 import { type FrameworkCoreEnv, frameworkCoreEnvSchema } from "../env-schema";
 

package/src/__tests__/few-shot-corpus.test.ts

@@ -13,11 +13,11 @@
 // because the corpus JSON now lives there — framework is public and must
 // not carry the eval baseline.
 
+import { afterEach, beforeEach, describe, expect, test } from "bun:test";
 import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { buildFewShotCorpus, pathToId } from "@cosmicdrift/kumiko-dev-server";
-import { afterEach, beforeEach, describe, expect, test } from "vitest";
 
 let workdir: string;
 

package/src/__tests__/inject-schema.test.ts

@@ -4,7 +4,7 @@
 // nicht und mountet leer. Tests pinnen die Idempotenz + die zwei
 // Insertion-Punkte (vor /client.js-Tag oder vor </body>).
 
-import { describe, expect, test } from "vitest";
+import { describe, expect, test } from "bun:test";
 import { injectSchema } from "../inject-schema";
 
 const SCHEMA = '{"features":[]}';

package/src/__tests__/resolve-stylesheet.test.ts

@@ -7,10 +7,10 @@
 // die anderen Tests dort booten ein TestStack (DB + Redis), das brauchen
 // wir für reine Resolver-Logik nicht.
 
+import { describe, expect, test } from "bun:test";
 import { mkdirSync, mkdtempSync, realpathSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
-import { describe, expect, test } from "vitest";
 import { resolveStylesheet } from "../create-kumiko-server";
 
 describe("resolveStylesheet", () => {
@@ -48,16 +48,20 @@ describe("resolveStylesheet", () => {
     expect(out).toBeUndefined();
   });
 
-  test("undefined + clientEntry unter Node (ohne Bun): undefined (silent skip)", () => {
-    // hasBun ist false in vitest-Node — Default-Resolution wird übersprungen,
-    // ohne Throw. Wer im Test eine echte CSS will, übergibt explicit string.
-    // Unter Bun (production) würde Bun.resolveSync den Path liefern; das
-    // testet der bestehende create-kumiko-server.integration.ts.
+  test("undefined + clientEntry: undefined (silent skip)", () => {
+    // Bun resolveSync findet packages/renderer-web/src/styles.css im
+    // Repo. Das ist der prod-Pfad — unter Bun (real oder CI) ist der
+    // Wert ein absoluter path; unter Node (von wo der Test portiert
+    // wurde) wäre es undefined. Wir akzeptieren beides.
     const out = resolveStylesheet({
       features: [],
       clientEntry: "./entry.tsx",
     });
-    expect(out).toBeUndefined();
+    if (typeof Bun === "undefined") {
+      expect(out).toBeUndefined();
+    } else {
+      expect(out).toMatch(/renderer-web\/src\/styles\.css$/);
+    }
   });
 
   test("undefined + clientEntry + src/styles.css existiert → returns App-Theme-Override", () => {

package/src/__tests__/resolve-tailwind-cli.test.ts

@@ -2,7 +2,7 @@
 // genau das, was den dev-server-Crash bei flakigem Netz verhindert:
 // kein Bun → undefined, Package nicht installiert → undefined.
 
-import { describe, expect, test } from "vitest";
+import { describe, expect, test } from "bun:test";
 import { resolveTailwindCli } from "../resolve-tailwind-cli";
 
 describe("resolveTailwindCli", () => {

package/src/__tests__/run-prod-app-spec.test.ts

@@ -4,8 +4,8 @@
 // "looks like a leak"-Reverts oder "bisschen rauf, sollte reichen"-
 // Tweaks.
 
+import { describe, expect, test } from "bun:test";
 import { SSE_HEARTBEAT_INTERVAL_MS } from "@cosmicdrift/kumiko-framework/api";
-import { describe, expect, test } from "vitest";
 import { buildBunServeOptions } from "../run-prod-app";
 
 describe("Bun.serve options for production", () => {

package/src/__tests__/run-prod-app.integration.ts

@@ -9,9 +9,11 @@
 // fetch direkt. Bun.serve-Wiring ist in Production-Coolify selbst
 // getestet wenn der Container hochfährt.
 
+import { afterEach, beforeAll, describe, expect, test } from "bun:test";
 import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { dirname, join } from "node:path";
+import { asRawClient } from "@cosmicdrift/kumiko-framework/bun-db";
 import { createDbConnection } from "@cosmicdrift/kumiko-framework/db";
 import {
   createBooleanField,
@@ -28,9 +30,7 @@ import {
   createProjectionStateTable,
 } from "@cosmicdrift/kumiko-framework/pipeline";
 import { unsafeEnsureEntityTable } from "@cosmicdrift/kumiko-framework/stack";
-import { sql } from "drizzle-orm";
 import postgres from "postgres";
-import { afterEach, beforeAll, describe, expect, test } from "vitest";
 import { z } from "zod";
 import { type ProdAppHandle, runProdApp } from "../run-prod-app";
 
@@ -448,7 +448,7 @@ describe("runProdApp", () => {
     });
 
     expect(invocations).toBe(1);
-    expect(factoryDeps).toEqual({ db: true, redis: true, registry: true });
+    expect(factoryDeps!).toEqual({ db: true, redis: true, registry: true });
     // Smoke: handle is functional (boot completed without error).
     expect(handle.entrypoint).toBeDefined();
   });
@@ -465,9 +465,9 @@ describe("runProdApp", () => {
       seedInvocations++;
       // Seed-side idempotence: check before inserting. runProdApp doesn't
       // gate seeds — the seed itself is responsible.
-      const existing = await db.execute(sql`SELECT 1 FROM prod_widgets LIMIT 1`);
-      if (existing.length > 0) return;
-      await db.execute(sql`INSERT INTO prod_widgets (id, tenant_id, name) VALUES
+      const existing = await asRawClient(db).unsafe(`SELECT 1 FROM prod_widgets LIMIT 1`);
+      if ((existing as Array<Record<string, unknown>>).length > 0) return;
+      await asRawClient(db).unsafe(`INSERT INTO prod_widgets (id, tenant_id, name) VALUES
         (gen_random_uuid(), '00000000-0000-4000-8000-000000000001', 'seeded')`);
       inserted = true;
     };

package/src/__tests__/scaffold-app-feature.test.ts

@@ -1,9 +1,9 @@
 // scaffoldAppFeature unit-tests (DX-2).
 
+import { afterEach, beforeEach, describe, expect, test } from "bun:test";
 import { existsSync, mkdtempSync, readFileSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
-import { afterEach, beforeEach, describe, expect, test } from "vitest";
 import { scaffoldApp } from "../scaffold-app";
 import { scaffoldAppFeature } from "../scaffold-app-feature";
 

package/src/__tests__/scaffold-app.test.ts

@@ -1,9 +1,9 @@
 // scaffoldApp unit-tests (DX-1.0).
 
+import { afterEach, beforeEach, describe, expect, test } from "bun:test";
 import { existsSync, mkdtempSync, readFileSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
-import { afterEach, beforeEach, describe, expect, test } from "vitest";
 import { scaffoldApp } from "../scaffold-app";
 
 describe("scaffoldApp", () => {

package/src/__tests__/scaffold-deploy.test.ts

@@ -1,7 +1,7 @@
+import { afterEach, beforeEach, describe, expect, it } from "bun:test";
 import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
 import { scaffoldDeploy } from "../scaffold-deploy";
 
 describe("scaffoldDeploy", () => {

package/src/__tests__/scaffold-feature.test.ts

@@ -8,12 +8,12 @@
 //   4. Validation: bad names fail loudly, existing destination refuses
 //      to overwrite
 
+import { afterEach, beforeEach, describe, expect, test } from "bun:test";
 import { existsSync, mkdtempSync, readFileSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { parseSourceFile, VERSION_HEADER } from "@cosmicdrift/kumiko-framework/engine";
 import { Project } from "ts-morph";
-import { afterEach, beforeEach, describe, expect, test } from "vitest";
 import { scaffoldFeature } from "../scaffold-feature";
 
 let workdir: string;

package/src/__tests__/try-hono-first.test.ts

@@ -5,7 +5,7 @@
 // sich ändert (z.B. "matched" auch für 4xx anders als 404), MÜSSEN
 // beide Pfade synchron updaten.
 
-import { describe, expect, test } from "vitest";
+import { describe, expect, test } from "bun:test";
 import { type HonoLikeApp, tryHonoFirst } from "../try-hono-first";
 
 function makeApp(response: Response): HonoLikeApp {

package/src/__tests__/walkthrough.integration.ts

@@ -0,0 +1,118 @@
+// DX-3.1 — walkthrough-snapshot-test. Reproduces the 3-command path from
+// docs.kumiko.so/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.
+//
+// What this test pins:
+//   - scaffoldApp produces the 6 files the walkthrough lists
+//   - scaffoldAppFeature scaffolds + auto-mounts (the diff-block shown)
+//   - composeFeatures(includeBundled:true) yields the exact feature-count
+//     the walkthrough advertises in "Expected output"
+
+import { afterEach, beforeEach, describe, expect, test } from "bun:test";
+import { mkdtempSync, readFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { createSecretsFeature } from "@cosmicdrift/kumiko-bundled-features/secrets";
+import { createSessionsFeature } from "@cosmicdrift/kumiko-bundled-features/sessions";
+import { createRegistry, defineFeature, validateBoot } from "@cosmicdrift/kumiko-framework/engine";
+import { composeFeatures } from "../compose-features";
+import { scaffoldApp } from "../scaffold-app";
+import { scaffoldAppFeature } from "../scaffold-app-feature";
+
+describe("walkthrough — DX-3.1 snapshot", () => {
+  let tmp: string;
+  let appRoot: string;
+
+  beforeEach(() => {
+    tmp = mkdtempSync(join(tmpdir(), "walkthrough-"));
+    appRoot = join(tmp, "my-notes");
+  });
+  afterEach(() => {
+    rmSync(tmp, { recursive: true, force: true });
+  });
+
+  test("Step 1 (kumiko new app) — produces walkthrough's 6 files", () => {
+    const result = scaffoldApp({ name: "my-notes", destination: appRoot });
+    expect(result.files).toEqual([
+      "package.json",
+      "tsconfig.json",
+      "src/run-config.ts",
+      "bin/main.ts",
+      ".env.example",
+      "README.md",
+    ]);
+  });
+
+  test("Step 2 (kumiko add feature) — auto-mounts + walkthrough diff matches", () => {
+    scaffoldApp({ name: "my-notes", destination: appRoot });
+    const result = scaffoldAppFeature({ name: "notes", appRoot });
+    expect(result.autoMounted).toBe(true);
+
+    const runConfig = readFileSync(join(appRoot, "src/run-config.ts"), "utf-8");
+    // Walkthrough's diff-block claims:
+    //   + import { notesFeature } from "./features/notes";
+    //   + notesFeature  (in APP_FEATURES)
+    expect(runConfig).toContain(`import { notesFeature } from "./features/notes";`);
+    expect(runConfig).toContain("notesFeature");
+    // Foundation still mounted (createSecretsFeature + createSessionsFeature).
+    expect(runConfig).toContain("createSecretsFeature()");
+    expect(runConfig).toContain("createSessionsFeature()");
+  });
+
+  test("Step 3 (boot validation) — scaffolded run-config matches walkthrough's APP_FEATURES claim", () => {
+    scaffoldApp({ name: "my-notes", destination: appRoot });
+    scaffoldAppFeature({ name: "notes", appRoot });
+
+    // Text-assert: scaffolded run-config.ts contains exactly the 3 features
+    // the walkthrough's diff-block shows (secrets + sessions + notesFeature).
+    // Dynamic-import would fail because /tmp can't resolve @cosmicdrift/*
+    // workspace symlinks — instead we reproduce the equivalent APP_FEATURES
+    // array in-process below.
+    const runConfig = readFileSync(join(appRoot, "src/run-config.ts"), "utf-8");
+    expect(runConfig).toContain("createSecretsFeature()");
+    expect(runConfig).toContain("createSessionsFeature()");
+    expect(runConfig).toContain("notesFeature");
+  });
+
+  test("Step 3 (composeFeatures) — 3 explicit + 4 auto-mounted = 7 features", () => {
+    // Reproduces the scaffolded APP_FEATURES in-process. notesFeature gets
+    // a dummy defineFeature here — the scaffold-side of "notesFeature"
+    // (file-content) is pinned in test 2; this test pins the runtime-side
+    // (composeFeatures auto-prepend behaviour the walkthrough claims).
+    const notesFeature = defineFeature("notes", () => {});
+    const APP_FEATURES = [createSecretsFeature(), createSessionsFeature(), notesFeature];
+
+    const composed = composeFeatures(APP_FEATURES, { includeBundled: true });
+    // 3 explicit + 4 auto-mounted bundled = 7 total features.
+    expect(composed.length).toBe(7);
+
+    const composedNames = composed.map((f) => f.name).sort();
+    expect(composedNames).toEqual([
+      "auth-email-password",
+      "config",
+      "notes",
+      "secrets",
+      "sessions",
+      "tenant",
+      "user",
+    ]);
+
+    // validateBoot must pass (no missing-requires, no schema-errors).
+    expect(() => validateBoot(composed)).not.toThrow();
+    // Registry must contain all 7 features.
+    const registry = createRegistry(composed);
+    expect(registry.features.size).toBe(7);
+  });
+
+  test("bin/main.ts contains the auth.admin stub the walkthrough relies on", () => {
+    scaffoldApp({ name: "my-notes", destination: appRoot });
+    const main = readFileSync(join(appRoot, "bin/main.ts"), "utf-8");
+    // composeFeatures(includeBundled:true)-trigger is `auth: { admin: { … } }`.
+    // Walkthrough explicitly says this is what auto-mounts the 4 bundled features.
+    expect(main).toContain("auth: {");
+    expect(main).toContain("admin: {");
+    expect(main).toContain("memberships:");
+    expect(main).toContain("runProdApp");
+  });
+});

package/src/codegen/__tests__/run-codegen.test.ts

@@ -16,10 +16,10 @@
 //   - skipped-Flag wenn 0 Events UND kein .kumiko/ schon existiert
 //   - schemas.generated.ts wird erzeugt wenn inline-Schemas, sonst nicht
 
+import { describe, expect, test } from "bun:test";
 import { existsSync, mkdirSync, mkdtempSync, readFileSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
-import { describe, expect, test } from "vitest";
 import { runCodegen } from "../run-codegen";
 
 function makeAppDir(): string {

package/src/codegen/__tests__/strict-mode-diagnostics.test.ts

@@ -1,7 +1,7 @@
+import { afterAll, beforeAll, describe, expect, test } from "bun:test";
 import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import * as ts from "typescript";
-import { afterAll, beforeAll, describe, expect, test } from "vitest";
 import { runCodegen } from "../run-codegen";
 
 const REPO_ROOT = join(__dirname, "../../../../..");

package/src/codegen/__tests__/watch.test.ts

@@ -8,9 +8,9 @@
 // 'zod' nicht direct nutzen, runCodegen scant feature-files die
 // `import { z } from "zod"` haben.
 
+import { afterAll, describe, expect, test } from "bun:test";
 import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
-import { afterAll, describe, expect, test } from "vitest";
 import type { CodegenResult } from "../run-codegen";
 import { watchAndRegenerate } from "../watch";
 

package/src/scaffold-app-feature.ts

@@ -114,7 +114,8 @@ function mountInRunConfig(runConfigPath: string, name: string): boolean {
 
   // 1. Prepend import after the last existing import.
   const imports = sf.getImportDeclarations();
-  const insertIndex = imports.length > 0 ? imports[imports.length - 1]!.getChildIndex() + 1 : 0;
+  const insertIndex =
+    imports.length > 0 ? (imports[imports.length - 1]?.getChildIndex() ?? 0) + 1 : 0;
   sf.insertImportDeclaration(insertIndex, {
     moduleSpecifier: `./features/${name}`,
     namedImports: [`${camel}Feature`],