@cosmicdrift/kumiko-dev-server 0.155.0 → 0.155.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-dev-server",
-  "version": "0.155.0",
+  "version": "0.155.1",
   "description": "Dev-tooling for Kumiko apps: local dev-server bootstrap (runDevApp), scaffolding, codegen. Not shipped into production node_modules — see @cosmicdrift/kumiko-server-runtime for the prod boot path.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -54,9 +54,9 @@
     "kumiko-schema-check": "./bin/kumiko-schema-check.ts"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-bundled-features": "0.155.0",
-    "@cosmicdrift/kumiko-framework": "0.155.0",
-    "@cosmicdrift/kumiko-server-runtime": "0.155.0",
+    "@cosmicdrift/kumiko-bundled-features": "0.155.1",
+    "@cosmicdrift/kumiko-framework": "0.155.1",
+    "@cosmicdrift/kumiko-server-runtime": "0.155.1",
     "ts-morph": "^28.0.0"
   },
   "publishConfig": {

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

@@ -283,7 +283,7 @@ export default defineFeature("dup", (r) => {
     const result = runCodegen({ appRoot });
     expect(result.eventCount).toBe(1);
     expect(result.warnings.length).toBeGreaterThanOrEqual(1);
-    const w = result.warnings.find((w) => w.reason.includes("duplicate"));
+    const w = result.warnings.find((w) => w.message.includes("duplicate"));
     expect(w).toBeDefined();
   });
 
@@ -368,7 +368,7 @@ export default defineFeature("inline", (r) => {
     const result = runCodegen({ appRoot });
     expect(result.eventCount).toBe(0);
     expect(result.warnings.length).toBe(1);
-    expect(result.warnings[0]?.reason).toMatch(/not a named import nor an inline z\.\* call/);
+    expect(result.warnings[0]?.message).toMatch(/not a named import nor an inline z\.\* call/);
   });
 
   test("skips test files, node_modules, .kumiko, dist", () => {

package/src/codegen/scan-events.ts

@@ -93,7 +93,7 @@ export type SchemaSource =
 export type ScanWarning = {
   readonly file: string;
   readonly line: number;
-  readonly reason: string;
+  readonly message: string;
 };
 
 export type ScanResult = {
@@ -152,7 +152,7 @@ function collectTsFiles(dir: string, out: string[]): void {
   try {
     entries = readdirSync(dir);
   } catch {
-    // Directory missing — fine, just no files to scan there.
+    // skip: directory unreadable, nothing to scan there
     return;
   }
   for (const entry of entries) {
@@ -224,8 +224,9 @@ function collectFromDefineEvent(
     warnings.push({
       file: filePath,
       line: call.getStartLineNumber(),
-      reason: "r.defineEvent: cannot read event-name + schema statically",
+      message: "r.defineEvent: cannot read event-name + schema statically",
     });
+    // skip: defineEvent call shape not statically parseable, already recorded as warning
     return;
   }
 
@@ -241,8 +242,9 @@ function collectFromDefineEvent(
     warnings.push({
       file: filePath,
       line: call.getStartLineNumber(),
-      reason: `r.defineEvent("${parsed.eventName}"): schema "${parsed.schemaNode.getText()}" — not a named import nor an inline z.* call, skipped`,
+      message: `r.defineEvent("${parsed.eventName}"): schema "${parsed.schemaNode.getText()}" — not a named import nor an inline z.* call, skipped`,
     });
+    // skip: schema source not resolvable, already recorded as warning
     return;
   }
 
@@ -544,7 +546,7 @@ function dedupe(events: ScannedEvent[], warnings: ScanWarning[]): ScannedEvent[]
       warnings.push({
         file: ev.source.file,
         line: ev.source.line,
-        reason: `duplicate r.defineEvent("${ev.qualifiedName}") — first declared at ${existing.source.file}:${existing.source.line}, ignored here`,
+        message: `duplicate r.defineEvent("${ev.qualifiedName}") — first declared at ${existing.source.file}:${existing.source.line}, ignored here`,
       });
       continue;
     }

package/src/codegen/watch.ts

@@ -74,7 +74,7 @@ export function watchAndRegenerate(opts: WatchOptions): WatchHandle {
         if (result.warnings.length > 0) {
           for (const w of result.warnings) {
             // biome-ignore lint/suspicious/noConsole: codegen-watcher logs to terminal
-            console.warn(`[codegen] ${w.file}:${w.line} — ${w.reason}`);
+            console.warn(`[codegen] ${w.file}:${w.line} — ${w.message}`);
           }
         }
       }
@@ -95,17 +95,19 @@ export function watchAndRegenerate(opts: WatchOptions): WatchHandle {
 
   try {
     watcher = watch(srcDir, { recursive: true }, (_eventType, filename) => {
+      // skip: watcher closed or no filename reported, nothing to act on
       if (closed || !filename) return;
-      // node liefert filename relativ zu srcDir, kann aber posix oder
+      // skip: node liefert filename relativ zu srcDir, kann aber posix oder
       // windows-style separators haben. Wir prüfen substring-tolerant.
       const normalised = `/${filename.toString().replace(/\\/g, "/")}`;
+      // skip: path matches an excluded segment (node_modules/dist/etc.)
       if (SKIP_SUBSTRINGS.some((seg) => normalised.includes(seg))) return;
-      // Nur .ts/.tsx interessieren — alles andere (CSS, MD, JSON) hat
+      // skip: Nur .ts/.tsx interessieren — alles andere (CSS, MD, JSON) hat
       // keinen Einfluss auf r.defineEvent-Calls.
       if (!normalised.endsWith(".ts") && !normalised.endsWith(".tsx")) return;
-      // .d.ts ausgenommen — die kommen meistens vom codegen selbst.
+      // skip: .d.ts ausgenommen — die kommen meistens vom codegen selbst.
       if (normalised.endsWith(".d.ts")) return;
-      // .test.ts/.test.tsx ausgenommen — Tests definieren keine
+      // skip: .test.ts/.test.tsx ausgenommen — Tests definieren keine
       // Production-Features.
       if (normalised.endsWith(".test.ts") || normalised.endsWith(".test.tsx")) return;
 
@@ -127,6 +129,7 @@ export function watchAndRegenerate(opts: WatchOptions): WatchHandle {
 
   return {
     close: () => {
+      // skip: already closed, avoid double-close
       if (closed) return;
       closed = true;
       if (timer) clearTimeout(timer);

package/src/create-kumiko-server.ts

@@ -342,6 +342,7 @@ async function watchDir(
   } catch (err) {
     // signal.abort() wirft AbortError aus dem async-iterator; das ist
     // gewollt und kein Fehler. Andere Errors weiterreichen.
+    // skip: AbortSignal fired the abort, this is expected teardown not a real error
     if ((err as { name?: string }).name === "AbortError") return;
     throw err;
   }
@@ -954,6 +955,7 @@ export async function createKumikoServer(
         dir,
         async (filename) => {
           const action = classifyChange(filename);
+          // skip: file change classified as ignore (test/css/json), nothing to rebuild
           if (action === "ignore") return;
           if (action === "restart") {
             logInfo(

package/src/few-shot-corpus.ts

@@ -295,6 +295,7 @@ function walkDir(dir: string, acc: string[]): void {
   try {
     entries = readdirSync(dir, { withFileTypes: true });
   } catch {
+    // skip: directory missing/unreadable, nothing to walk
     return;
   }
   for (const entry of entries) {

package/src/schema-apply.ts

@@ -114,6 +114,7 @@ async function rebuildAffectedProjections(
       );
     }
   }
+  // skip: no projections matched the changed tables, nothing to rebuild
   if (projections.size === 0) return;
 
   console.log(`  Rebuild ${projections.size} Projection(s)…`);