@mandujs/core 0.12.2 → 0.13.1

package/src/config/validate.ts

@@ -1,215 +1,225 @@
-import { z, ZodError, ZodIssueCode } from "zod";
-import path from "path";
-import { pathToFileURL } from "url";
-import { CONFIG_FILES, coerceConfig } from "./mandu";
-import { readJsonFile } from "../utils/bun";
-
-/**
- * DNA-003: Strict mode schema helper
- *
- * Creates a schema that warns about unknown keys instead of failing
- * This provides the benefits of .strict() while maintaining compatibility
- */
-function strictWithWarnings<T extends z.ZodRawShape>(
-  schema: z.ZodObject<T>,
-  schemaName: string
-): z.ZodObject<T> {
-  return schema.superRefine((data, ctx) => {
-    if (typeof data !== "object" || data === null) return;
-
-    const knownKeys = new Set(Object.keys(schema.shape));
-    const unknownKeys = Object.keys(data).filter((key) => !knownKeys.has(key));
-
-    if (unknownKeys.length > 0 && process.env.MANDU_STRICT !== "0") {
-      // In strict mode (default), add warnings to issues
-      for (const key of unknownKeys) {
-        ctx.addIssue({
-          code: ZodIssueCode.unrecognized_keys,
-          keys: [key],
-          message: `Unknown key '${key}' in ${schemaName}. Did you mean one of: ${[...knownKeys].join(", ")}?`,
-        });
-      }
-    }
-  });
-}
-
-/**
- * Server 설정 스키마 (strict)
- */
-const ServerConfigSchema = z
-  .object({
-    port: z.number().min(1).max(65535).default(3000),
-    hostname: z.string().default("localhost"),
-    cors: z
-      .union([
-        z.boolean(),
-        z.object({
-          origin: z.union([z.string(), z.array(z.string())]).optional(),
-          methods: z.array(z.string()).optional(),
-          credentials: z.boolean().optional(),
-        }).strict(),
-      ])
-      .default(false),
-    streaming: z.boolean().default(false),
-  })
-  .strict();
-
-/**
- * Guard 설정 스키마 (strict)
- */
-const GuardConfigSchema = z
-  .object({
-    preset: z.enum(["mandu", "fsd", "clean", "hexagonal", "atomic"]).default("mandu"),
-    srcDir: z.string().default("src"),
-    exclude: z.array(z.string()).default([]),
-    realtime: z.boolean().default(true),
-    rules: z.record(z.enum(["error", "warn", "warning", "off"])).optional(),
-  })
-  .strict();
-
-/**
- * Build 설정 스키마 (strict)
- */
-const BuildConfigSchema = z
-  .object({
-    outDir: z.string().default(".mandu"),
-    minify: z.boolean().default(true),
-    sourcemap: z.boolean().default(false),
-    splitting: z.boolean().default(false),
-  })
-  .strict();
-
-/**
- * Dev 설정 스키마 (strict)
- */
-const DevConfigSchema = z
-  .object({
-    hmr: z.boolean().default(true),
-    watchDirs: z.array(z.string()).default([]),
-  })
-  .strict();
-
-/**
- * FS Routes 설정 스키마 (strict)
- */
-const FsRoutesConfigSchema = z
-  .object({
-    routesDir: z.string().default("app"),
-    extensions: z.array(z.string()).default([".tsx", ".ts", ".jsx", ".js"]),
-    exclude: z.array(z.string()).default([]),
-    islandSuffix: z.string().default(".island"),
-    legacyManifestPath: z.string().optional(),
-    mergeWithLegacy: z.boolean().default(true),
-  })
-  .strict();
-
-/**
- * SEO 설정 스키마 (strict)
- */
-const SeoConfigSchema = z
-  .object({
-    enabled: z.boolean().default(true),
-    defaultTitle: z.string().optional(),
-    titleTemplate: z.string().optional(),
-  })
-  .strict();
-
-/**
- * Mandu 설정 스키마 (DNA-003: strict mode)
- *
- * 알 수 없는 키가 있으면 오류 발생 → 오타 즉시 감지
- * MANDU_STRICT=0 으로 비활성화 가능
- */
-export const ManduConfigSchema = z
-  .object({
-    server: ServerConfigSchema.default({}),
-    guard: GuardConfigSchema.default({}),
-    build: BuildConfigSchema.default({}),
-    dev: DevConfigSchema.default({}),
-    fsRoutes: FsRoutesConfigSchema.default({}),
-    seo: SeoConfigSchema.default({}),
-  })
-  .strict();
-
-export type ValidatedManduConfig = z.infer<typeof ManduConfigSchema>;
-
-/**
- * 검증 결과
- */
-export interface ValidationResult {
-  valid: boolean;
-  config?: ValidatedManduConfig;
-  errors?: Array<{
-    path: string;
-    message: string;
-  }>;
-  source?: string;
-}
-
-/**
- * 설정 파일 검증
- */
-export async function validateConfig(rootDir: string): Promise<ValidationResult> {
-  for (const fileName of CONFIG_FILES) {
-    const filePath = path.join(rootDir, fileName);
-    if (!(await Bun.file(filePath).exists())) {
-      continue;
-    }
-
-    try {
-      let raw: unknown;
-      if (fileName.endsWith(".json")) {
-        raw = await readJsonFile(filePath);
-      } else {
-        const module = await import(pathToFileURL(filePath).href);
-        raw = module?.default ?? module;
-      }
-
-      const config = ManduConfigSchema.parse(coerceConfig(raw ?? {}, fileName));
-      return { valid: true, config, source: fileName };
-    } catch (error) {
-      if (error instanceof ZodError) {
-        const errors = error.errors.map((e) => ({
-          path: e.path.join("."),
-          message: e.message,
-        }));
-        return { valid: false, errors, source: fileName };
-      }
-
-      return {
-        valid: false,
-        errors: [
-          {
-            path: "",
-            message: `Failed to load config: ${
-              error instanceof Error ? error.message : String(error)
-            }`,
-          },
-        ],
-        source: fileName,
-      };
-    }
-  }
-
-  // 설정 파일 없음 - 기본값 사용
-  return { valid: true, config: ManduConfigSchema.parse({}) };
-}
-
-/**
- * CLI용 검증 및 리포트
- */
-export async function validateAndReport(rootDir: string): Promise<ValidatedManduConfig | null> {
-  const result = await validateConfig(rootDir);
-
-  if (!result.valid) {
-    console.error(`\n❌ Invalid config${result.source ? ` (${result.source})` : ""}:\n`);
-    for (const error of result.errors || []) {
-      const location = error.path ? `  ${error.path}: ` : "  ";
-      console.error(`${location}${error.message}`);
-    }
-    console.error("");
-    return null;
-  }
-
-  return result.config!;
-}
+import { z, ZodError, ZodIssueCode } from "zod";
+import path from "path";
+import { pathToFileURL } from "url";
+import { CONFIG_FILES, coerceConfig } from "./mandu";
+import { readJsonFile } from "../utils/bun";
+
+/**
+ * DNA-003: Strict mode schema helper
+ *
+ * Creates a schema that warns about unknown keys instead of failing
+ * This provides the benefits of .strict() while maintaining compatibility
+ */
+function strictWithWarnings<T extends z.ZodRawShape>(
+  schema: z.ZodObject<T>,
+  schemaName: string
+): z.ZodObject<T> {
+  return schema.superRefine((data, ctx) => {
+    if (typeof data !== "object" || data === null) return;
+
+    const knownKeys = new Set(Object.keys(schema.shape));
+    const unknownKeys = Object.keys(data).filter((key) => !knownKeys.has(key));
+
+    if (unknownKeys.length > 0 && process.env.MANDU_STRICT !== "0") {
+      // In strict mode (default), add warnings to issues
+      for (const key of unknownKeys) {
+        ctx.addIssue({
+          code: ZodIssueCode.unrecognized_keys,
+          keys: [key],
+          message: `Unknown key '${key}' in ${schemaName}. Did you mean one of: ${[...knownKeys].join(", ")}?`,
+        });
+      }
+    }
+  });
+}
+
+/**
+ * Server 설정 스키마 (strict)
+ */
+const ServerConfigSchema = z
+  .object({
+    port: z.number().min(1).max(65535).default(3000),
+    hostname: z.string().default("localhost"),
+    cors: z
+      .union([
+        z.boolean(),
+        z.object({
+          origin: z.union([z.string(), z.array(z.string())]).optional(),
+          methods: z.array(z.string()).optional(),
+          credentials: z.boolean().optional(),
+        }).strict(),
+      ])
+      .default(false),
+    streaming: z.boolean().default(false),
+    rateLimit: z
+      .union([
+        z.boolean(),
+        z.object({
+          windowMs: z.number().int().positive().optional(),
+          max: z.number().int().positive().optional(),
+          message: z.string().min(1).optional(),
+          statusCode: z.number().int().min(400).max(599).optional(),
+          headers: z.boolean().optional(),
+        }).strict(),
+      ])
+      .default(false),
+  })
+  .strict();
+
+/**
+ * Guard 설정 스키마 (strict)
+ */
+const GuardConfigSchema = z
+  .object({
+    preset: z.enum(["mandu", "fsd", "clean", "hexagonal", "atomic"]).default("mandu"),
+    srcDir: z.string().default("src"),
+    exclude: z.array(z.string()).default([]),
+    realtime: z.boolean().default(true),
+    rules: z.record(z.enum(["error", "warn", "warning", "off"])).optional(),
+  })
+  .strict();
+
+/**
+ * Build 설정 스키마 (strict)
+ */
+const BuildConfigSchema = z
+  .object({
+    outDir: z.string().default(".mandu"),
+    minify: z.boolean().default(true),
+    sourcemap: z.boolean().default(false),
+    splitting: z.boolean().default(false),
+  })
+  .strict();
+
+/**
+ * Dev 설정 스키마 (strict)
+ */
+const DevConfigSchema = z
+  .object({
+    hmr: z.boolean().default(true),
+    watchDirs: z.array(z.string()).default([]),
+  })
+  .strict();
+
+/**
+ * FS Routes 설정 스키마 (strict)
+ */
+const FsRoutesConfigSchema = z
+  .object({
+    routesDir: z.string().default("app"),
+    extensions: z.array(z.string()).default([".tsx", ".ts", ".jsx", ".js"]),
+    exclude: z.array(z.string()).default([]),
+    islandSuffix: z.string().default(".island"),
+  })
+  .strict();
+
+/**
+ * SEO 설정 스키마 (strict)
+ */
+const SeoConfigSchema = z
+  .object({
+    enabled: z.boolean().default(true),
+    defaultTitle: z.string().optional(),
+    titleTemplate: z.string().optional(),
+  })
+  .strict();
+
+/**
+ * Mandu 설정 스키마 (DNA-003: strict mode)
+ *
+ * 알 수 없는 키가 있으면 오류 발생 → 오타 즉시 감지
+ * MANDU_STRICT=0 으로 비활성화 가능
+ */
+export const ManduConfigSchema = z
+  .object({
+    server: ServerConfigSchema.default({}),
+    guard: GuardConfigSchema.default({}),
+    build: BuildConfigSchema.default({}),
+    dev: DevConfigSchema.default({}),
+    fsRoutes: FsRoutesConfigSchema.default({}),
+    seo: SeoConfigSchema.default({}),
+  })
+  .strict();
+
+export type ValidatedManduConfig = z.infer<typeof ManduConfigSchema>;
+
+/**
+ * 검증 결과
+ */
+export interface ValidationResult {
+  valid: boolean;
+  config?: ValidatedManduConfig;
+  errors?: Array<{
+    path: string;
+    message: string;
+  }>;
+  source?: string;
+}
+
+/**
+ * 설정 파일 검증
+ */
+export async function validateConfig(rootDir: string): Promise<ValidationResult> {
+  for (const fileName of CONFIG_FILES) {
+    const filePath = path.join(rootDir, fileName);
+    if (!(await Bun.file(filePath).exists())) {
+      continue;
+    }
+
+    try {
+      let raw: unknown;
+      if (fileName.endsWith(".json")) {
+        raw = await readJsonFile(filePath);
+      } else {
+        const module = await import(pathToFileURL(filePath).href);
+        raw = module?.default ?? module;
+      }
+
+      const config = ManduConfigSchema.parse(coerceConfig(raw ?? {}, fileName));
+      return { valid: true, config, source: fileName };
+    } catch (error) {
+      if (error instanceof ZodError) {
+        const errors = error.errors.map((e) => ({
+          path: e.path.join("."),
+          message: e.message,
+        }));
+        return { valid: false, errors, source: fileName };
+      }
+
+      return {
+        valid: false,
+        errors: [
+          {
+            path: "",
+            message: `Failed to load config: ${
+              error instanceof Error ? error.message : String(error)
+            }`,
+          },
+        ],
+        source: fileName,
+      };
+    }
+  }
+
+  // 설정 파일 없음 - 기본값 사용
+  return { valid: true, config: ManduConfigSchema.parse({}) };
+}
+
+/**
+ * CLI용 검증 및 리포트
+ */
+export async function validateAndReport(rootDir: string): Promise<ValidatedManduConfig | null> {
+  const result = await validateConfig(rootDir);
+
+  if (!result.valid) {
+    console.error(`\n❌ Invalid config${result.source ? ` (${result.source})` : ""}:\n`);
+    for (const error of result.errors || []) {
+      const location = error.path ? `  ${error.path}: ` : "  ";
+      console.error(`${location}${error.message}`);
+    }
+    console.error("");
+    return null;
+  }
+
+  return result.config!;
+}

package/src/error/classifier.ts

@@ -95,7 +95,7 @@ export class ErrorClassifier {
       case "spec":
         errorType = "SPEC_ERROR";
         code = ErrorCode.SPEC_VALIDATION_ERROR;
-        fixFile = blameFrame?.file || "spec/routes.manifest.json";
+        fixFile = blameFrame?.file || ".mandu/routes.manifest.json";
         suggestion = "Spec 파일의 JSON 구문 또는 스키마를 확인하세요";
         break;
 
@@ -258,7 +258,7 @@ export class ErrorClassifier {
 export function createSpecError(
   code: ErrorCode,
   message: string,
-  file: string = "spec/routes.manifest.json",
+  file: string = ".mandu/routes.manifest.json",
   suggestion?: string
 ): ManduError {
   return {

package/src/error/formatter.ts

@@ -105,14 +105,14 @@ export function createNotFoundResponse(
   pathname: string,
   routeContext?: RouteContext
 ): ManduError {
-  return {
-    errorType: "SPEC_ERROR",
-    code: ErrorCode.SPEC_ROUTE_NOT_FOUND,
-    httpStatus: 404,
-    message: `Route not found: ${pathname}`,
-    summary: "라우트 없음 - spec 파일에 추가 필요",
-    fix: {
-      file: "spec/routes.manifest.json",
+  return {
+    errorType: "SPEC_ERROR",
+    code: ErrorCode.SPEC_ROUTE_NOT_FOUND,
+    httpStatus: 404,
+    message: `Route not found: ${pathname}`,
+    summary: "라우트 없음 - spec 파일에 추가 필요",
+    fix: {
+      file: ".mandu/routes.manifest.json",
       suggestion: `'${pathname}' 패턴의 라우트를 추가하세요`,
     },
     route: routeContext,
@@ -127,14 +127,14 @@ export function createHandlerNotFoundResponse(
   routeId: string,
   pattern: string
 ): ManduError {
-  return {
-    errorType: "FRAMEWORK_BUG",
-    code: ErrorCode.FRAMEWORK_ROUTER_ERROR,
-    httpStatus: 500,
-    message: `Handler not registered for route: ${routeId}`,
-    summary: "핸들러 미등록 - generate 재실행 필요",
-    fix: {
-      file: `apps/server/generated/routes/${routeId}.route.ts`,
+  return {
+    errorType: "FRAMEWORK_BUG",
+    code: ErrorCode.FRAMEWORK_ROUTER_ERROR,
+    httpStatus: 500,
+    message: `Handler not registered for route: ${routeId}`,
+    summary: "핸들러 미등록 - generate 재실행 필요",
+    fix: {
+      file: `.mandu/generated/server/routes/${routeId}.route.ts`,
       suggestion: "bunx mandu generate를 실행하세요",
     },
     route: {
@@ -153,14 +153,14 @@ export function createPageLoadErrorResponse(
   pattern: string,
   originalError?: Error
 ): ManduError {
-  const error: ManduError = {
-    errorType: "LOGIC_ERROR",
-    code: ErrorCode.SLOT_IMPORT_ERROR,
-    httpStatus: 500,
-    message: originalError?.message || `Failed to load page module for route: ${routeId}`,
-    summary: `페이지 모듈 로드 실패 - ${routeId}.route.tsx 확인 필요`,
-    fix: {
-      file: `apps/web/generated/routes/${routeId}.route.tsx`,
+  const error: ManduError = {
+    errorType: "LOGIC_ERROR",
+    code: ErrorCode.SLOT_IMPORT_ERROR,
+    httpStatus: 500,
+    message: originalError?.message || `Failed to load page module for route: ${routeId}`,
+    summary: `페이지 모듈 로드 실패 - ${routeId}.route.tsx 확인 필요`,
+    fix: {
+      file: `.mandu/generated/web/routes/${routeId}.route.tsx`,
       suggestion: "import 경로와 컴포넌트 export를 확인하세요",
     },
     route: {
@@ -189,14 +189,14 @@ export function createSSRErrorResponse(
   pattern: string,
   originalError?: Error
 ): ManduError {
-  const error: ManduError = {
-    errorType: "FRAMEWORK_BUG",
-    code: ErrorCode.FRAMEWORK_SSR_ERROR,
-    httpStatus: 500,
-    message: originalError?.message || `SSR rendering failed for route: ${routeId}`,
-    summary: `SSR 렌더링 실패 - 컴포넌트 확인 필요`,
-    fix: {
-      file: `apps/web/generated/routes/${routeId}.route.tsx`,
+  const error: ManduError = {
+    errorType: "FRAMEWORK_BUG",
+    code: ErrorCode.FRAMEWORK_SSR_ERROR,
+    httpStatus: 500,
+    message: originalError?.message || `SSR rendering failed for route: ${routeId}`,
+    summary: `SSR 렌더링 실패 - 컴포넌트 확인 필요`,
+    fix: {
+      file: `.mandu/generated/web/routes/${routeId}.route.tsx`,
       suggestion: "React 컴포넌트가 서버에서 렌더링 가능한지 확인하세요 (브라우저 전용 API 사용 금지)",
     },
     route: {

package/src/error/stack-analyzer.ts

@@ -183,6 +183,11 @@ export class StackTraceAnalyzer {
   isSpecFile(file: string): boolean {
     const normalized = this.normalizePath(file);
 
+    // .mandu/ 디렉토리 내 생성된 매니페스트/락 파일
+    if (normalized.startsWith(".mandu/") && normalized.endsWith(".json")) {
+      return true;
+    }
+
     // spec/ 디렉토리 내 JSON 파일
     if (normalized.startsWith("spec/") && normalized.endsWith(".json")) {
       return true;