@cosmicdrift/kumiko-dev-server 0.367.0 → 0.368.0

package/README.md

@@ -1,6 +1,6 @@
 # @cosmicdrift/kumiko-dev-server
 
-Dev tooling for Kumiko apps: local dev server (`runDevApp`), scaffolding and codegen, plus the `kumiko-*` build and schema commands.
+Dev tooling for Kumiko apps: local dev server (`runDevApp`), scaffolding, plus the `kumiko-*` build and schema commands.
 
 ## Install
 

package/bin/kumiko-build.ts

@@ -23,23 +23,19 @@ import {
   buildServerBundle,
   discoverServerEntry,
   formatBuildResult,
-  formatScanWarning,
   formatServerBuildResult,
   readClientEntriesConfig,
   readExtraRuntimeExternals,
   resolveClientEntries,
-  runCodegen,
 } from "@cosmicdrift/kumiko-dev-server/cli";
 
 if (process.argv.slice(2).some((arg) => arg === "--help" || arg === "-h")) {
   process.stdout.write(
-    "Usage: kumiko-build [--check] [app-dir]   build client (dist/) and server (dist-server/) bundles;\n" +
-      "       --check only verifies .kumiko/ is up to date (exit 1 on drift, writes nothing)\n",
+    "Usage: kumiko-build [app-dir]   build client (dist/) and server (dist-server/) bundles\n",
   );
   process.exit(0);
 }
 
-const checkCodegenOnly = process.argv.includes("--check");
 const explicit = process.argv.slice(2).find((arg) => !arg.startsWith("-"));
 const cwd = explicit ? resolve(process.cwd(), explicit) : process.cwd();
 
@@ -47,20 +43,6 @@ const red = "\x1b[31m";
 const yellow = "\x1b[33m";
 const reset = "\x1b[0m";
 
-if (checkCodegenOnly) {
-  const drift = runCodegen({ appRoot: cwd, checkOnly: true });
-  for (const w of drift.warnings) {
-    process.stderr.write(`${yellow}!${reset} [codegen] ${formatScanWarning(w)}\n`);
-  }
-  if (drift.didWriteTypes || drift.didWriteDefine || drift.didWriteSchemas) {
-    process.stderr.write(
-      `\n  ${red}✗${reset} .kumiko/ is stale; run kumiko-build or the dev-server and commit.\n\n`,
-    );
-    process.exit(1);
-  }
-  process.exit(0);
-}
-
 try {
   // Read once up front — resolveClientEntries can throw (mutual exclusion,
   // malformed declaration, unmigrated legacy client-*.tsx files) and that
@@ -82,19 +64,6 @@ try {
     process.exit(1);
   }
 
-  // Codegen-Pass vor dem Build — sicherstellt dass `.kumiko/define.ts`
-  // und `types.generated.d.ts` synchron mit den r.defineEvent-Aufrufen
-  // sind. Ohne diesen Pass würde ein veraltetes Wrapper-File ein
-  // Build-Error oder schlimmer: einen Build mit stale Augmentation
-  // erzeugen, der zur Laufzeit die falschen Events erlaubt.
-  const cgResult = runCodegen({ appRoot: cwd });
-  if (cgResult.warnings.length > 0) {
-    for (const w of cgResult.warnings) {
-      // biome-ignore lint/suspicious/noConsole: CLI-Output
-      console.warn(`${yellow}!${reset} [codegen] ${formatScanWarning(w)}`);
-    }
-  }
-
   if (hasClient) {
     const t0 = performance.now();
     const result = await buildProdBundle({ cwd, ...declaredClientEntries });

package/dist/cli.d.ts

@@ -1,4 +1,3 @@
 export { buildProdBundle, buildServerBundle, discoverServerEntry, formatBuildResult, formatServerBuildResult, readClientEntriesConfig, readExtraRuntimeExternals, resolveClientEntries, } from "./build.js";
-export { formatScanWarning, runCodegen } from "./codegen/index.js";
 export { createCrashTracker } from "./crash-tracker.js";
 export { runInitDeployCli } from "./init-deploy-cli.js";

package/dist/cli.js

@@ -3,6 +3,5 @@
 // resolve to src in the workspace and to dist once installed from the
 // tarball, where `src` is not shipped.
 export { buildProdBundle, buildServerBundle, discoverServerEntry, formatBuildResult, formatServerBuildResult, readClientEntriesConfig, readExtraRuntimeExternals, resolveClientEntries, } from "./build.js";
-export { formatScanWarning, runCodegen } from "./codegen/index.js";
 export { createCrashTracker } from "./crash-tracker.js";
 export { runInitDeployCli } from "./init-deploy-cli.js";

package/dist/compose-stacks.js

@@ -8,21 +8,20 @@
 // Presets export feature instances only; no implicit PAT scopes, anonymousAccess,
 // or tier maps (those stay in bin/server.ts / app run-config).
 import { createAuditFeature } from "@cosmicdrift/kumiko-bundled-features/audit";
-import { authFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/auth-foundation";
+import { createAuthFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/auth-foundation";
 import { createAuthMfaFeature, } from "@cosmicdrift/kumiko-bundled-features/auth-mfa";
 import { createComplianceProfilesFeature } from "@cosmicdrift/kumiko-bundled-features/compliance-profiles";
 import { createDataRetentionFeature } from "@cosmicdrift/kumiko-bundled-features/data-retention";
 import { createDeliveryFeature } from "@cosmicdrift/kumiko-bundled-features/delivery";
-import { fileFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/file-foundation";
-import { fileProviderInMemoryFeature } from "@cosmicdrift/kumiko-bundled-features/file-provider-inmemory";
-import { fileProviderS3Feature } from "@cosmicdrift/kumiko-bundled-features/file-provider-s3";
-import { fileProviderS3EnvFeature } from "@cosmicdrift/kumiko-bundled-features/file-provider-s3-env";
+import { createFileFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/file-foundation";
+import { createFileProviderInMemoryFeature } from "@cosmicdrift/kumiko-bundled-features/file-provider-inmemory";
+import { createFileProviderS3Feature } from "@cosmicdrift/kumiko-bundled-features/file-provider-s3";
 import { createFilesFeature } from "@cosmicdrift/kumiko-bundled-features/files";
 import { createJobsFeature } from "@cosmicdrift/kumiko-bundled-features/jobs";
 import { createLegalPagesFeature, } from "@cosmicdrift/kumiko-bundled-features/legal-pages";
-import { mailFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/mail-foundation";
-import { mailTransportInMemoryFeature } from "@cosmicdrift/kumiko-bundled-features/mail-transport-inmemory";
-import { mailTransportSmtpFeature } from "@cosmicdrift/kumiko-bundled-features/mail-transport-smtp";
+import { createMailFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/mail-foundation";
+import { createMailTransportInMemoryFeature } from "@cosmicdrift/kumiko-bundled-features/mail-transport-inmemory";
+import { createMailTransportSmtpFeature } from "@cosmicdrift/kumiko-bundled-features/mail-transport-smtp";
 import { createRateLimitingFeature } from "@cosmicdrift/kumiko-bundled-features/rate-limiting";
 import { createRendererFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/renderer-foundation";
 import { createSessionsFeature } from "@cosmicdrift/kumiko-bundled-features/sessions";
@@ -55,24 +54,24 @@ export function composeRendererStack(options = {}) {
     ];
 }
 export function composeMailStack(options) {
-    const out = [mailFoundationFeature];
+    const out = [createMailFoundationFeature()];
     for (const transport of options.transports) {
         if (transport === "inmemory")
-            out.push(mailTransportInMemoryFeature);
+            out.push(createMailTransportInMemoryFeature());
         if (transport === "smtp")
-            out.push(mailTransportSmtpFeature);
+            out.push(createMailTransportSmtpFeature());
     }
     return out;
 }
 export function composeFileStack(options) {
-    const out = [fileFoundationFeature];
+    const out = [createFileFoundationFeature()];
     for (const provider of options.providers) {
         if (provider === "inmemory")
-            out.push(fileProviderInMemoryFeature);
+            out.push(createFileProviderInMemoryFeature());
         if (provider === "s3")
-            out.push(fileProviderS3Feature);
+            out.push(createFileProviderS3Feature());
         if (provider === "s3-env")
-            out.push(fileProviderS3EnvFeature);
+            out.push(createFileProviderS3Feature({ fromEnv: true }));
     }
     if (options.includeFilesFeature ?? true)
         out.push(createFilesFeature());
@@ -87,7 +86,7 @@ export function composeGdprStack(options = {}) {
     if (options.tenantLifecycle)
         out.push(createTenantLifecycleFeature());
     if (options.sessions) {
-        out.push(authFoundationFeature, createSessionsFeature());
+        out.push(createAuthFoundationFeature(), createSessionsFeature());
         if (options.providers)
             out.push(...options.providers);
     }
@@ -122,7 +121,7 @@ export function composeIdentityStack(options = {}) {
     const sessions = options.sessions ?? true;
     const out = [];
     if (sessions) {
-        out.push(authFoundationFeature, createSessionsFeature());
+        out.push(createAuthFoundationFeature(), createSessionsFeature());
     }
     if (options.mfa !== undefined)
         out.push(createAuthMfaFeature(options.mfa));

package/dist/create-kumiko-server.d.ts

@@ -2,9 +2,9 @@
 import { type AuthRoutesConfig, type ExtraRouteDefinition } from "@cosmicdrift/kumiko-framework/api";
 import { type FeatureDefinition } from "@cosmicdrift/kumiko-framework/engine";
 import type { ErrorDocsConfig } from "@cosmicdrift/kumiko-framework/errors";
-import { type TestStack, type TestStackOptions } from "@cosmicdrift/kumiko-framework/stack";
 import { type PageHeadResolver, type PageHeadSystemQuery } from "@cosmicdrift/kumiko-headless/apex";
 import { type SystemWireDeps } from "@cosmicdrift/kumiko-server-runtime/extra-routes-deps";
+import { type TestStack, type TestStackOptions } from "@cosmicdrift/kumiko-testing/stack";
 type BunServer = typeof Bun extends undefined ? unknown : ReturnType<typeof Bun.serve>;
 export declare const logInfo: (msg: string) => void;
 /** Multi-entry mode for apps that ship several separate bundles (e.g.

package/dist/create-kumiko-server.js

@@ -24,7 +24,7 @@ import { AUTH_COOKIE_BASE, CSRF_COOKIE_BASE, createClientIpResolver, generateTok
 import { buildAppSchema } from "@cosmicdrift/kumiko-framework/engine";
 import { createEventsTable } from "@cosmicdrift/kumiko-framework/event-store";
 import { createMetricsForFactory } from "@cosmicdrift/kumiko-framework/observability";
-import { pushEntityProjectionTables, setupTestStack, TestUsers, } from "@cosmicdrift/kumiko-framework/stack";
+import { TestUsers } from "@cosmicdrift/kumiko-framework/seeding";
 import { resolveAndInjectPageHead, } from "@cosmicdrift/kumiko-headless/apex";
 import { startDevJobRunners } from "@cosmicdrift/kumiko-server-runtime/boot/job-run-logger";
 import { buildBunServeOptions, resolveDerivedMaxRequestBodySize, } from "@cosmicdrift/kumiko-server-runtime/bun-serve-options";
@@ -33,6 +33,7 @@ import { RENDERER_WEB_FONT_FILE_PATTERN, RENDERER_WEB_FONTS_URL_PREFIX, resolveR
 import { buildRequestBoundSystemQuery } from "@cosmicdrift/kumiko-server-runtime/request-bound-system-query";
 import { canResolveTailwindStylesheet, resolveTailwindCli, } from "@cosmicdrift/kumiko-server-runtime/resolve-tailwind-cli";
 import { stripNoRouteMatchHeader, tryHonoFirst, } from "@cosmicdrift/kumiko-server-runtime/try-hono-first";
+import { pushEntityProjectionTables, setupTestStack, } from "@cosmicdrift/kumiko-testing/stack";
 import { errorCodeOf } from "@cosmicdrift/kumiko-types/type-guards";
 import { isPersistentDevDb } from "./is-persistent-dev-db.js";
 // Runtime-detection. The dev-server is meant to run under Bun (Kumiko's

package/dist/index.d.ts

@@ -1,5 +1,4 @@
 export { type ComposeFeaturesOptions, composeFeatures, } from "@cosmicdrift/kumiko-server-runtime/compose-features";
-export { type CodegenOptions, type CodegenResult, runCodegen, type ScannedEvent, type ScanWarning, scanEvents, } from "./codegen/index.js";
 export { composeFileStack, composeGdprStack, composeIdentityStack, composeMailStack, composeOpsStack, composePagesStack, composeRendererStack, composeUserDataRightsStack, type FileProviderKind, type FileStackOptions, type GdprStackOptions, type GdprStackOrder, type IdentityStackOptions, type MailStackOptions, type MailTransportKind, type OpsStackOptions, type PagesStackOptions, stackFeatureNames, type UserDataRightsStackOptions, } from "./compose-stacks.js";
 export { type CreateKumikoServerOptions, createKumikoServer, type KumikoServerHandle, PROD_BUNDLES_ENV, resolveStylesheet, STYLESHEET_WATCH_ENV, } from "./create-kumiko-server.js";
 export { type FrameworkCoreEnv, frameworkCoreEnvSchema } from "./env-schema.js";

package/dist/index.js

@@ -17,7 +17,6 @@ export { composeFeatures, } from "@cosmicdrift/kumiko-server-runtime/compose-fea
 // im Sub-Path-Export `@cosmicdrift/kumiko-dev-server/build`. Damit zieht der Main-Barrel
 // kein Bun-Toolchain-Bundle mehr in Production-Reads (z.B. wenn drizzle-kit
 // die App-Config unter Node lädt).
-export { runCodegen, scanEvents, } from "./codegen/index.js";
 export { composeFileStack, composeGdprStack, composeIdentityStack, composeMailStack, composeOpsStack, composePagesStack, composeRendererStack, composeUserDataRightsStack, stackFeatureNames, } from "./compose-stacks.js";
 export { createKumikoServer, PROD_BUNDLES_ENV, resolveStylesheet, STYLESHEET_WATCH_ENV, } from "./create-kumiko-server.js";
 export { frameworkCoreEnvSchema } from "./env-schema.js";

package/dist/run-dev-app.d.ts

@@ -4,8 +4,8 @@ import { type KmsAdapter } from "@cosmicdrift/kumiko-framework/crypto";
 import { type FeatureDefinition, type Registry, type ValidateBootOptions } from "@cosmicdrift/kumiko-framework/engine";
 import type { ErrorDocsConfig } from "@cosmicdrift/kumiko-framework/errors";
 import type { EnvelopeCipher, MasterKeyProvider } from "@cosmicdrift/kumiko-framework/secrets";
-import type { TestStack } from "@cosmicdrift/kumiko-framework/stack";
 import type { PageHeadResolver } from "@cosmicdrift/kumiko-headless/apex";
+import type { TestStack } from "@cosmicdrift/kumiko-testing/stack";
 import { type CreateKumikoServerOptions, type KumikoServerHandle } from "./create-kumiko-server.js";
 export type { AccountLockoutSetup, AccountUnlockSetup, AuthMailOptions, EmailVerificationSetup, InviteSetup, PasswordResetSetup, SignupSetup, } from "@cosmicdrift/kumiko-server-runtime/run-prod-app";
 import type { AccountLockoutSetup, AccountUnlockSetup, AuthMailOptions, EmailVerificationSetup, InviteSetup, PasswordResetSetup, SignupSetup } from "@cosmicdrift/kumiko-server-runtime/run-prod-app";

package/dist/run-dev-app.js

@@ -29,7 +29,6 @@ import { resolveBootCrypto } from "@cosmicdrift/kumiko-server-runtime/boot/boot-
 import { buildComposeAuthOptions, composeFeatures, } from "@cosmicdrift/kumiko-server-runtime/compose-features";
 import { assertPiiBootInvariants } from "@cosmicdrift/kumiko-server-runtime/pii-boot-gate";
 import { assertSessionBootInvariants } from "@cosmicdrift/kumiko-server-runtime/session-boot-gate";
-import { watchAndRegenerate } from "./codegen/index.js";
 import { createKumikoServer, logInfo, } from "./create-kumiko-server.js";
 import { captureEphemeralDevPiiKms, resolveDevPiiKms } from "./resolve-dev-pii-kms.js";
 import { renderWelcomeBanner } from "./welcome-banner.js";
@@ -62,11 +61,11 @@ export async function runDevApp(options) {
             env: { ...baseBootEnv, [FILE_STORAGE_PROVIDER_ENV]: FILE_STORAGE_PROVIDER_BOOT_SENTINEL },
         }
         : options.validateBootOptions;
-    // Boot-Validation als allererstes — vor fs-Watcher und Server. Dieselbe
+    // Boot-Validation als allererstes — vor dem Server. Dieselbe
     // Fehlerklasse (unqualifizierte nav-/handler-QNs, screen-access etc.),
     // die früher nur runProdApp fing und sonst erst den Prod-Pod im
     // CrashLoopBackOff sterben ließ (#359). Wirft synchron, bevor ein
-    // Socket oder Watcher (codegen-Write) aufgeht.
+    // Socket aufgeht.
     // Resolved before validateBoot: an app-supplied masterKey provider must satisfy the
     // encrypted-field gate here exactly as it does in runProdApp.
     const bootCrypto = resolveBootCrypto(envSource, options.masterKey);
@@ -76,21 +75,6 @@ export async function runDevApp(options) {
     });
     warnIfNonUtcServerTimeZone();
     validateAppCustomScreenWriteQns(process.cwd(), collectWriteHandlerQns(features));
-    // Codegen + File-Watcher — schreibt `<appRoot>/.kumiko/types.generated.d.ts`
-    // + `define.ts` aus den r.defineEvent-Aufrufen der App, einmal beim
-    // Boot UND danach bei jeder relevanten Änderung unter `<appRoot>/src/`.
-    // Idempotent (writeIfChanged) — der TS-Sprachserver kriegt nur einen
-    // Reload-Tick wenn sich tatsächlich was geändert hat.
-    //
-    // 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).
-    // Sammelt alle Write-Handler-QNs für den Codegen — damit
-    // `types.generated.d.ts` eine `WriteHandlerQn`-Union exportieren
-    // kann, die dispatcher.write-Aufrufe client-seitig typisiert.
-    const handlerQns = collectWriteHandlerQns(features);
-    watchAndRegenerate({ appRoot: process.cwd(), handlerQns: [...handlerQns] });
     // Sprint-8a Tier-Composition auto-wire: scan features for a
     // tenantTierResolver-extension. If found AND user didn't supply own
     // effectiveFeatures, we wire a late-bound wrapper here and fill it

package/dist/scaffold-agent-docs.d.ts

@@ -1,3 +1,13 @@
 export declare const FRAMEWORK_AGENTS_IMPORT = "@node_modules/@cosmicdrift/kumiko-framework/AGENTS.md";
-export declare function renderAgentsMd(): string;
+export declare function renderMountedFeatureList(features: ReadonlyArray<{
+    readonly name: string;
+}> | undefined): string;
+export type AgentsMdOptions = {
+    readonly productName: string;
+    readonly features: ReadonlyArray<{
+        readonly name: string;
+    }> | undefined;
+    readonly scriptNames: readonly string[];
+};
+export declare function renderAgentsMd(options: AgentsMdOptions): string;
 export declare function renderClaudeMd(): string;

package/dist/scaffold-agent-docs.js

@@ -1,16 +1,50 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { render } from "./scaffold-deploy.js";
 export const FRAMEWORK_AGENTS_IMPORT = "@node_modules/@cosmicdrift/kumiko-framework/AGENTS.md";
-const FRAMEWORK_AGENTS_PATH = "node_modules/@cosmicdrift/kumiko-framework/AGENTS.md";
-const FRAMEWORK_AGENTS_DIR = "node_modules/@cosmicdrift/kumiko-framework/agents/";
-export function renderAgentsMd() {
-    return `# Agent instructions
-
-This app is built on Kumiko. The framework guide for coding agents ships with the installed package and matches its version:
-
-- \`${FRAMEWORK_AGENTS_PATH}\`: start here.
-- \`${FRAMEWORK_AGENTS_DIR}\`: generated indexes of bundled features, widgets and tested examples.
-
-Read the framework guide before you add or change a feature. App-specific rules go below.
-`;
+const SCRIPT_DESCRIPTIONS = {
+    dev: "run the app with demo data",
+    boot: "boot validation without serving, needs no database",
+    typecheck: "type-check",
+    lint: "Biome check",
+    test: "unit tests",
+    "test:integration": "integration tests, need `docker compose up -d`",
+    "test:real": "tests against real providers, local only",
+    e2e: "browser tests, need `docker compose up -d`",
+    "e2e:real": "browser tests against real providers, local only",
+    "schema:generate": "new migration after an entity change or a newly mounted bundled feature",
+    "schema:apply": "apply the checked-in migrations",
+    build: "production build",
+    start: "run the production build",
+};
+const DEMO_TASKS_FEATURE_LINE = "- `tasks` (demo — list + edit screens)";
+const FOUNDATION_FEATURE_LINES = ["- `secrets` (foundation)", "- `sessions` (foundation)"];
+export function renderMountedFeatureList(features) {
+    const lines = features && features.length > 0
+        ? features.map((f) => `- \`${f.name}\``)
+        : FOUNDATION_FEATURE_LINES;
+    return [...lines, DEMO_TASKS_FEATURE_LINE].join("\n");
+}
+function renderCommandList(scriptNames) {
+    return scriptNames
+        .map((name) => {
+        const description = SCRIPT_DESCRIPTIONS[name];
+        return description === undefined
+            ? `- \`bun run ${name}\``
+            : `- \`bun run ${name}\`: ${description}`;
+    })
+        .join("\n");
+}
+function agentsTemplatePath() {
+    return join(dirname(fileURLToPath(import.meta.url)), "..", "templates", "AGENTS.app.md");
+}
+export function renderAgentsMd(options) {
+    return render(readFileSync(agentsTemplatePath(), "utf-8"), {
+        productName: options.productName,
+        featureList: renderMountedFeatureList(options.features),
+        commands: renderCommandList(options.scriptNames),
+    }, {});
 }
 export function renderClaudeMd() {
     return `${FRAMEWORK_AGENTS_IMPORT}\n@AGENTS.md\n`;

package/dist/scaffold-app.js

@@ -14,7 +14,7 @@ import { dirname, join, relative, resolve } from "node:path";
 import { collectTableMetas, generateMigration, writeSnapshotJson, } from "@cosmicdrift/kumiko-framework/db";
 import { composeFeatures } from "@cosmicdrift/kumiko-server-runtime/compose-features";
 import { isKebabSegment } from "./kebab.js";
-import { renderAgentsMd, renderClaudeMd } from "./scaffold-agent-docs.js";
+import { renderAgentsMd, renderClaudeMd, renderMountedFeatureList } from "./scaffold-agent-docs.js";
 import { createDemoTasksFeature, renderDemoSeedFile, renderDemoTasksFeatureFile, renderDemoTasksI18n, renderDemoTasksIndex, renderDemoTasksWebIndex, } from "./scaffold-demo-tasks.js";
 import { scaffoldDeploy } from "./scaffold-deploy.js";
 // Exact pin (no caret): the generated files are formatted to this Biome's output,
@@ -24,7 +24,6 @@ const SCAFFOLD_GITIGNORE = `node_modules/
 dist/
 dist-server/
 .env
-.kumiko/
 test-results/
 playwright-report/
 `;
@@ -105,7 +104,11 @@ export async function scaffoldApp(options) {
     }
     write(join(destination, "README.md"), `${renderReadme(options.name, options.features)}${testSetup === undefined ? "" : `\n${testSetup.rulesMarkdown}`}`);
     files.push("README.md");
-    write(join(destination, "AGENTS.md"), renderAgentsMd());
+    write(join(destination, "AGENTS.md"), renderAgentsMd({
+        productName: options.name,
+        features: options.features,
+        scriptNames: Object.keys(appScripts(testSetup)),
+    }));
     files.push("AGENTS.md");
     write(join(destination, "CLAUDE.md"), renderClaudeMd());
     files.push("CLAUDE.md");
@@ -115,23 +118,26 @@ export async function scaffoldApp(options) {
 function write(path, content) {
     writeFileSync(path, content);
 }
+function appScripts(testSetup) {
+    return {
+        dev: "bun --watch bin/dev.ts",
+        build: "bun kumiko-build",
+        start: "bun run bin/main.ts",
+        boot: "KUMIKO_DRY_RUN_ENV=boot bun bin/main.ts",
+        typecheck: "tsc --noEmit",
+        lint: "biome check .",
+        ...(testSetup?.scripts ?? { test: "bun --config=bunfig.ci.toml test --dots" }),
+        "schema:apply": "bun kumiko-schema apply",
+        "schema:generate": "bun kumiko-schema generate",
+    };
+}
 function renderPackageJson(name, version, testSetup) {
     return `${JSON.stringify({
         name,
         version: "0.1.0",
         private: true,
         type: "module",
-        scripts: {
-            dev: "bun --watch bin/dev.ts",
-            build: "bun kumiko-build",
-            start: "bun run bin/main.ts",
-            boot: "KUMIKO_DRY_RUN_ENV=boot bun bin/main.ts",
-            typecheck: "tsc --noEmit",
-            lint: "biome check .",
-            ...(testSetup?.scripts ?? { test: "bun --config=bunfig.ci.toml test --dots" }),
-            "schema:apply": "bun kumiko-schema apply",
-            "schema:generate": "bun kumiko-schema generate",
-        },
+        scripts: appScripts(testSetup),
         dependencies: {
             "@cosmicdrift/kumiko-bundled-features": version,
             "@cosmicdrift/kumiko-dev-server": version,
@@ -276,8 +282,8 @@ const FOUNDATION_FEATURES = [
     {
         name: "auth-foundation",
         importPath: "@cosmicdrift/kumiko-bundled-features/auth-foundation",
-        exportName: "authFoundationFeature",
-        callExpression: "authFoundationFeature",
+        exportName: "createAuthFoundationFeature",
+        callExpression: "createAuthFoundationFeature()",
     },
     {
         name: "sessions",
@@ -621,9 +627,7 @@ volumes:
 `;
 }
 function renderReadme(appName, features) {
-    const featureList = features && features.length > 0
-        ? [...features.map((f) => `- \`${f.name}\``), "- `tasks` (demo — list + edit screens)"].join("\n")
-        : "- `secrets` (foundation)\n- `sessions` (foundation)\n- `tasks` (demo — list + edit screens)";
+    const featureList = renderMountedFeatureList(features);
     return `# ${appName}
 
 Scaffolded by \`kumiko new app\`. Includes a demo **tasks** feature with list +

package/dist/scaffold-demo-tasks.js

@@ -212,7 +212,7 @@ export function renderDemoSeedFile() {
     return `// Demo seed — a few tasks so \`bun dev\` shows a non-empty list.
 
 import type { SeedFn } from "@cosmicdrift/kumiko-dev-server";
-import { TestUsers } from "@cosmicdrift/kumiko-framework/stack";
+import { TestUsers } from "@cosmicdrift/kumiko-framework/seeding";
 
 const DEMO_TASKS = [
   { title: "Welcome to Kumiko", status: "todo", priority: 1, isUrgent: false },

package/dist/schema-apply.js

@@ -25,7 +25,7 @@ export async function runSchemaApply(opts) {
         console.error(`\n  ${migrationsDir} fehlt — kumiko/migrations/ muss im Image liegen.\n`);
         return 1;
     }
-    const { db, close } = createDbConnection(dbUrl);
+    const { db, close } = createDbConnection({ url: dbUrl });
     try {
         // Infra-Tabellen (event-store + pipeline-state) zuerst, alle
         // tableExists-gated idempotent: auf einer Bestands-DB no-op, auf einer

package/dist/setup-test-stack-from-features.d.ts

@@ -1,6 +1,6 @@
 import type { FeatureDefinition } from "@cosmicdrift/kumiko-framework/engine";
-import { type TestStack, type TestStackOptions } from "@cosmicdrift/kumiko-framework/stack";
 import { type ComposeFeaturesOptions } from "@cosmicdrift/kumiko-server-runtime/compose-features";
+import { type TestStack, type TestStackOptions } from "@cosmicdrift/kumiko-testing/stack";
 export type TestStackPreset = "config" | "template-resolver";
 export type SetupTestStackFromFeaturesOptions = Omit<TestStackOptions, "features"> & {
     readonly includeBundled?: boolean;

package/dist/setup-test-stack-from-features.js

@@ -2,10 +2,10 @@
 // Apps pass the same feature list as run-config (APP_FEATURES / buildAppFeatures).
 import { createConfigResolver, } from "@cosmicdrift/kumiko-bundled-features/config";
 import { createTemplateResolverApi } from "@cosmicdrift/kumiko-bundled-features/template-resolver";
-import { setupTestStack, } from "@cosmicdrift/kumiko-framework/stack";
 import { jobRunLoggerCallbacks } from "@cosmicdrift/kumiko-server-runtime/boot/job-run-logger";
 import { composeFeatures, } from "@cosmicdrift/kumiko-server-runtime/compose-features";
 import { addConfigAccessorFactory } from "@cosmicdrift/kumiko-server-runtime/run-prod-app";
+import { setupTestStack, } from "@cosmicdrift/kumiko-testing/stack";
 function isConfigResolver(value) {
     return (typeof value === "object" && value !== null && "get" in value && typeof value.get === "function");
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cosmicdrift/kumiko-dev-server",
-  "version": "0.367.0",
-  "description": "Dev-tooling for Kumiko apps: local dev-server bootstrap (runDevApp), scaffolding, codegen. Its compose-stacks/env-schema subpaths are consumed at prod boot too — see @cosmicdrift/kumiko-server-runtime for the prod runner itself.",
+  "version": "0.368.0",
+  "description": "Dev-tooling for Kumiko apps: local dev-server bootstrap (runDevApp), scaffolding. Its compose-stacks/env-schema subpaths are consumed at prod boot too — see @cosmicdrift/kumiko-server-runtime for the prod runner itself.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
   "repository": {
@@ -15,7 +15,11 @@
   "homepage": "https://kumiko.rocks",
   "type": "module",
   "kumiko": {
-    "runtime": "dev"
+    "runtime": "dev",
+    "bunOnlyExports": [
+      ".",
+      "./setup-test-stack-from-features"
+    ]
   },
   "exports": {
     ".": {
@@ -63,13 +67,14 @@
     "kumiko-upgrade": "./bin/kumiko-upgrade.ts"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-bundled-features": "0.367.0",
-    "@cosmicdrift/kumiko-framework": "0.367.0",
-    "@cosmicdrift/kumiko-headless": "0.367.0",
-    "@cosmicdrift/kumiko-renderer-mail-html": "0.367.0",
-    "@cosmicdrift/kumiko-renderer-web": "0.367.0",
-    "@cosmicdrift/kumiko-server-runtime": "0.367.0",
-    "@cosmicdrift/kumiko-types": "0.367.0",
+    "@cosmicdrift/kumiko-bundled-features": "0.368.0",
+    "@cosmicdrift/kumiko-framework": "0.368.0",
+    "@cosmicdrift/kumiko-headless": "0.368.0",
+    "@cosmicdrift/kumiko-renderer-mail-html": "0.368.0",
+    "@cosmicdrift/kumiko-renderer-web": "0.368.0",
+    "@cosmicdrift/kumiko-server-runtime": "0.368.0",
+    "@cosmicdrift/kumiko-testing": "0.368.0",
+    "@cosmicdrift/kumiko-types": "0.368.0",
     "bun-types": "^1.3.13",
     "ts-morph": "^28.0.0",
     "zod": "^4.4.3"

package/src/changes.json

@@ -1,4 +1,17 @@
 [
+  {
+    "version": "0.368.0",
+    "type": "breaking",
+    "title": "@app/define and kumiko codegen are removed",
+    "detail": "The .kumiko/ codegen (define.ts, types.generated.d.ts, schemas.generated.ts) is gone: runCodegen, scanEvents and their types are no longer exported, the dev server no longer watches r.defineEvent calls, `kumiko codegen` is removed, `kumiko-build --check` is removed and kumiko-build no longer runs a codegen pass. The scaffolded .gitignore no longer lists .kumiko/, so the upgrade marker .kumiko/upgrade-state.json can be committed. ctx.appendEvent stays bound to the augmentable KumikoEventTypeMap; to emit an event with a payload checked against its definition use emitEvent(ctx, eventDef, { aggregateId, aggregateType, payload, headers? }) with the EventDef that r.defineEvent returns (emitEvent now also accepts headers).",
+    "migration": "Replace `@app/define` imports with direct framework imports (defineWriteHandler/defineQueryHandler/defineFeature from @cosmicdrift/kumiko-framework/engine, events via r.defineEvent and emitEvent) and drop the `file:./.kumiko` dependency plus the bunfig/tsconfig resolver entries. Known sites: publicstatus 43 files, kumiko-platform 13 (samples), solon 3, money-horse 1, phronexsis 1."
+  },
+  {
+    "version": "0.368.0",
+    "type": "improvement",
+    "title": "Scaffolded apps get AGENTS.md from a template with placeholders",
+    "detail": "The scaffold renders AGENTS.md from templates/AGENTS.app.md instead of a fixed string. It fills in the app name, the mounted features and the commands that exist in the generated package.json. Purpose, production URL and app-specific rules stay as visible TODO(app owner) placeholders. CLAUDE.md is unchanged: it imports the framework guide and AGENTS.md."
+  },
   {
     "version": "0.365.0",
     "type": "fix",

package/templates/AGENTS.app.md

@@ -0,0 +1,27 @@
+# {{productName}}: agent instructions
+
+{{productName}} is built on Kumiko. The framework guide for coding agents ships with the installed package and matches its version:
+
+- `node_modules/@cosmicdrift/kumiko-framework/AGENTS.md`: start here.
+- `node_modules/@cosmicdrift/kumiko-framework/agents/`: generated indexes of bundled features, widgets and tested examples.
+
+Read the framework guide before you add or change a feature. The sections below are specific to this app.
+
+## Product
+
+- Purpose: TODO(app owner): what {{productName}} does and for whom, in one or two sentences.
+- Production URL: TODO(app owner): https://example.com
+
+## Mounted features
+
+{{featureList}}
+
+Mount more in `src/run-config.ts`. App code lives in `src/features/<name>/`.
+
+## Commands
+
+{{commands}}
+
+## App-specific rules
+
+TODO(app owner): decisions an agent cannot read from the code, such as domain terms, roles, data-retention limits or integrations that must not be touched.

package/dist/codegen/index.d.ts

@@ -1,4 +0,0 @@
-export { renderDefineFile, renderInlineSchemasFile, renderTypesAugmentation, renderWriteHandlerTypes, } from "./render.js";
-export { type CodegenOptions, type CodegenResult, runCodegen } from "./run-codegen.js";
-export { formatScanWarning, qualifiedNameToConstName, rewriteImportPath, type ScannedEvent, type ScanOptions, type ScanResult, type ScanWarning, type SchemaSource, scanEvents, } from "./scan-events.js";
-export { type WatchHandle, type WatchOptions, watchAndRegenerate } from "./watch.js";

package/dist/codegen/index.js

@@ -1,4 +0,0 @@
-export { renderDefineFile, renderInlineSchemasFile, renderTypesAugmentation, renderWriteHandlerTypes, } from "./render.js";
-export { runCodegen } from "./run-codegen.js";
-export { formatScanWarning, qualifiedNameToConstName, rewriteImportPath, scanEvents, } from "./scan-events.js";
-export { watchAndRegenerate } from "./watch.js";