@cosmicdrift/kumiko-framework 0.76.0 → 0.77.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-framework",
-  "version": "0.76.0",
+  "version": "0.77.0",
   "description": "Framework core — engine, pipeline, API, DB, and every other bit that makes Kumiko go.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -181,7 +181,7 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@cosmicdrift/kumiko-dispatcher-live": "0.76.0",
+    "@cosmicdrift/kumiko-dispatcher-live": "0.77.0",
     "bun-types": "^1.3.13",
     "pino-pretty": "^13.1.3"
   },

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

@@ -257,6 +257,20 @@ describe("parseEnv", () => {
       expect(boot.format()).toContain("✗ JWT_SECRET (auth-email-password, required, missing)");
     }
   });
+
+  it("error.message carries the per-var details (uncaught Bun prints message, not format())", () => {
+    // Without this, `bun run boot` against a misconfigured app shows only
+    // "Boot failed: 1 env-var problem" + the EnvError[] collapsed to
+    // "[Object ...]". The user can't tell which var is the problem.
+    const schema = z.object({ JWT_SECRET: z.string().min(32) });
+    try {
+      parseEnv(schema, {}, { sources: { JWT_SECRET: "auth-email-password" } });
+    } catch (err) {
+      const boot = err as KumikoBootError;
+      expect(boot.message).toContain("Boot failed: 1 env-var problem");
+      expect(boot.message).toContain("✗ JWT_SECRET (auth-email-password, required, missing)");
+    }
+  });
 });
 
 describe("pulumiConfigKey + camelCase", () => {

package/src/env/index.ts

@@ -226,34 +226,36 @@ export type EnvError = {
   readonly suggestion?: string;
 };
 
+function formatBootError(errors: readonly EnvError[]): string {
+  const lines: string[] = [
+    `Boot failed: ${errors.length} env-var problem${errors.length === 1 ? "" : "s"}`,
+    "",
+  ];
+  for (const err of errors) {
+    const tag = err.kind === "missing" ? "required, missing" : "invalid";
+    const sourceTag = err.source ? `${err.source}, ${tag}` : tag;
+    lines.push(`  ✗ ${err.name} (${sourceTag})`);
+    lines.push(`    ${err.message}`);
+    if (err.suggestion) {
+      lines.push(`    ${err.suggestion}`);
+    }
+  }
+  lines.push("");
+  lines.push("See: kumiko-platform/docs/runbooks/standard-deploy-app.md#step-1-boot-dry-run-lokal");
+  return lines.join("\n");
+}
+
 export class KumikoBootError extends Error {
   readonly errors: readonly EnvError[];
 
   constructor(errors: readonly EnvError[]) {
-    super(`Boot failed: ${errors.length} env-var problem${errors.length === 1 ? "" : "s"}`);
+    super(formatBootError(errors));
     this.name = "KumikoBootError";
     this.errors = errors;
   }
 
   format(): string {
-    const lines: string[] = [
-      `Boot failed: ${this.errors.length} env-var problem${this.errors.length === 1 ? "" : "s"}`,
-      "",
-    ];
-    for (const err of this.errors) {
-      const tag = err.kind === "missing" ? "required, missing" : "invalid";
-      const sourceTag = err.source ? `${err.source}, ${tag}` : tag;
-      lines.push(`  ✗ ${err.name} (${sourceTag})`);
-      lines.push(`    ${err.message}`);
-      if (err.suggestion) {
-        lines.push(`    ${err.suggestion}`);
-      }
-    }
-    lines.push("");
-    lines.push(
-      "See: kumiko-platform/docs/runbooks/standard-deploy-app.md#step-1-boot-dry-run-lokal",
-    );
-    return lines.join("\n");
+    return formatBootError(this.errors);
   }
 }