@mandujs/core 0.12.2 → 0.13.1

package/src/brain/architecture/analyzer.ts

@@ -46,22 +46,24 @@ export const DEFAULT_ARCHITECTURE_CONFIG: ArchitectureConfig = {
       description: "자동 생성 파일. 직접 수정 금지",
       readonly: true,
     },
-    "apps/server/": {
-      pattern: "apps/server/**",
-      description: "백엔드 로직",
+    ".mandu/generated/server/": {
+      pattern: ".mandu/generated/server/**",
+      description: "서버 생성 파일",
       allowedFiles: ["*.ts"],
+      readonly: true,
     },
-    "apps/web/": {
-      pattern: "apps/web/**",
-      description: "프론트엔드 컴포넌트",
+    ".mandu/generated/web/": {
+      pattern: ".mandu/generated/web/**",
+      description: "웹 생성 파일",
       allowedFiles: ["*.ts", "*.tsx"],
+      readonly: true,
     },
   },
   imports: [
     {
-      source: "apps/web/**",
+      source: ".mandu/generated/web/**",
       forbid: ["fs", "child_process", "path", "crypto"],
-      reason: "프론트엔드에서 Node.js 내장 모듈 사용 금지",
+      reason: "프론트엔드 생성 파일에서 Node.js 내장 모듈 사용 금지",
     },
     {
       source: "**/generated/**",
@@ -87,7 +89,7 @@ export const DEFAULT_ARCHITECTURE_CONFIG: ArchitectureConfig = {
     },
     {
       name: "app",
-      folders: ["apps/**"],
+      folders: ["app/**", "src/**"],
       canDependOn: ["spec", "generated"],
     },
   ],
@@ -173,9 +175,9 @@ export class ArchitectureAnalyzer {
   /**
    * 파일 위치 검증
    */
-  async checkLocation(request: CheckLocationRequest): Promise<CheckLocationResult> {
-    const violations: ArchitectureViolation[] = [];
-    const normalizedPath = this.toRelativePath(request.path);
+  async checkLocation(request: CheckLocationRequest): Promise<CheckLocationResult> {
+    const violations: ArchitectureViolation[] = [];
+    const normalizedPath = this.toRelativePath(request.path);
 
     // 1. readonly 폴더 검사
     for (const [key, rule] of Object.entries(this.config.folders || {})) {
@@ -288,14 +290,14 @@ export class ArchitectureAnalyzer {
   /**
    * Import 검증
    */
-  async checkImports(request: CheckImportRequest): Promise<CheckImportResult> {
+  async checkImports(request: CheckImportRequest): Promise<CheckImportResult> {
     const violations: Array<{
       import: string;
       reason: string;
       suggestion?: string;
     }> = [];
 
-    const normalizedSource = this.toRelativePath(request.sourceFile);
+    const normalizedSource = this.toRelativePath(request.sourceFile);
 
     for (const importPath of request.imports) {
       for (const rule of this.config.imports || []) {
@@ -368,7 +370,7 @@ export class ArchitectureAnalyzer {
   /**
    * 코드에서 import 문 추출
    */
-  private extractImports(content: string): string[] {
+  private extractImports(content: string): string[] {
     const imports: string[] = [];
 
     // ES6 import
@@ -385,15 +387,15 @@ export class ArchitectureAnalyzer {
     }
 
     return imports;
-  }
-
-  private toRelativePath(filePath: string): string {
-    const normalized = filePath.replace(/\\/g, "/");
-    if (path.isAbsolute(normalized)) {
-      return path.relative(this.rootDir, normalized).replace(/\\/g, "/");
-    }
-    return normalized;
-  }
+  }
+
+  private toRelativePath(filePath: string): string {
+    const normalized = filePath.replace(/\\/g, "/");
+    if (path.isAbsolute(normalized)) {
+      return path.relative(this.rootDir, normalized).replace(/\\/g, "/");
+    }
+    return normalized;
+  }
 
   /**
    * 폴더 스캔
@@ -449,7 +451,7 @@ export class ArchitectureAnalyzer {
    */
   private getImportSuggestion(importPath: string, sourceFile: string): string {
     if (importPath === "fs") {
-      if (sourceFile.includes("apps/web")) {
+      if (sourceFile.includes(".mandu/generated/web") || sourceFile.includes("client")) {
         return "프론트엔드에서는 fetch API를 사용하세요";
       }
       return "Bun.file() 또는 Bun.write()를 사용하세요";
@@ -513,7 +515,7 @@ ${JSON.stringify(this.config.folders, null, 2)}
       ]);
 
       // 응답에서 경로 추출 시도
-      const pathMatch = result.content.match(/(?:spec\/|apps\/|packages\/)[^\s,)]+/);
+      const pathMatch = result.content.match(/(?:spec\/|\.mandu\/|app\/|src\/|packages\/)[^\s,)]+/);
 
       return {
         suggestion: result.content,

package/src/brain/doctor/analyzer.ts

@@ -140,7 +140,7 @@ export function generateTemplatePatches(
     switch (violation.ruleId) {
       case GUARD_RULES.SPEC_HASH_MISMATCH?.id:
         patches.push({
-          file: "spec/spec.lock.json",
+          file: ".mandu/spec.lock.json",
           description: "Spec lock 파일 갱신",
           type: "command",
           command: "bunx mandu spec-upsert",

package/src/bundler/dev.ts

@@ -63,7 +63,6 @@ const DEFAULT_COMMON_DIRS = [
   "client",
   "src/islands",
   "islands",
-  "apps/web",
 ];
 
 /**

package/src/change/history.ts

@@ -3,7 +3,7 @@ import type { ChangeRecord, HistoryConfig } from "./types";
 import { deleteSnapshot, listSnapshotIds } from "./snapshot";
 import { DEFAULT_HISTORY_CONFIG } from "./types";
 
-const SPEC_DIR = "spec";
+const MANDU_DIR = ".mandu";
 const HISTORY_DIR = "history";
 const CHANGES_FILE = "changes.json";
 
@@ -11,7 +11,7 @@ const CHANGES_FILE = "changes.json";
  * Changes 파일 경로
  */
 function getChangesPath(rootDir: string): string {
-  return path.join(rootDir, SPEC_DIR, HISTORY_DIR, CHANGES_FILE);
+  return path.join(rootDir, MANDU_DIR, HISTORY_DIR, CHANGES_FILE);
 }
 
 /**
@@ -43,7 +43,7 @@ export async function getChange(rootDir: string, id: string): Promise<ChangeReco
  */
 async function writeChanges(rootDir: string, changes: ChangeRecord[]): Promise<void> {
   const changesPath = getChangesPath(rootDir);
-  const historyDir = path.join(rootDir, SPEC_DIR, HISTORY_DIR);
+  const historyDir = path.join(rootDir, MANDU_DIR, HISTORY_DIR);
 
   // 디렉토리 확보
   await Bun.write(path.join(historyDir, ".gitkeep"), "");

package/src/change/snapshot.ts

@@ -11,6 +11,7 @@ import {
 } from "../lockfile";
 import { validateAndReport } from "../config";
 
+const MANDU_DIR = ".mandu";
 const SPEC_DIR = "spec";
 const MANIFEST_FILE = "routes.manifest.json";
 const LOCK_FILE = "spec.lock.json";
@@ -33,7 +34,7 @@ function generateSnapshotId(): string {
  * 스냅샷 저장 경로 반환
  */
 function getSnapshotPath(rootDir: string, snapshotId: string): string {
-  return path.join(rootDir, SPEC_DIR, HISTORY_DIR, SNAPSHOTS_DIR, `${snapshotId}.snapshot.json`);
+  return path.join(rootDir, MANDU_DIR, HISTORY_DIR, SNAPSHOTS_DIR, `${snapshotId}.snapshot.json`);
 }
 
 /**
@@ -71,9 +72,9 @@ async function collectSlotContents(rootDir: string): Promise<Record<string, stri
  * 현재 spec 상태의 스냅샷 생성
  */
 export async function createSnapshot(rootDir: string): Promise<Snapshot> {
-  const specDir = path.join(rootDir, SPEC_DIR);
-  const manifestPath = path.join(specDir, MANIFEST_FILE);
-  const lockPath = path.join(specDir, LOCK_FILE);
+  const manduDir = path.join(rootDir, MANDU_DIR);
+  const manifestPath = path.join(manduDir, MANIFEST_FILE);
+  const lockPath = path.join(manduDir, LOCK_FILE);
 
   // Manifest 읽기 (필수)
   const manifestFile = Bun.file(manifestPath);
@@ -168,10 +169,10 @@ export async function readSnapshotById(rootDir: string, snapshotId: string): Pro
  * 스냅샷으로부터 상태 복원
  */
 export async function restoreSnapshot(rootDir: string, snapshot: Snapshot): Promise<RestoreResult> {
-  const specDir = path.join(rootDir, SPEC_DIR);
-  const manifestPath = path.join(specDir, MANIFEST_FILE);
-  const lockPath = path.join(specDir, LOCK_FILE);
-  const slotsDir = path.join(specDir, SLOTS_DIR);
+  const manduDir = path.join(rootDir, MANDU_DIR);
+  const manifestPath = path.join(manduDir, MANIFEST_FILE);
+  const lockPath = path.join(manduDir, LOCK_FILE);
+  const slotsDir = path.join(rootDir, SPEC_DIR, SLOTS_DIR);
 
   const restoredFiles: string[] = [];
   const failedFiles: string[] = [];
@@ -258,7 +259,7 @@ export async function deleteSnapshot(rootDir: string, snapshotId: string): Promi
  * 모든 스냅샷 ID 목록 조회
  */
 export async function listSnapshotIds(rootDir: string): Promise<string[]> {
-  const snapshotsDir = path.join(rootDir, SPEC_DIR, HISTORY_DIR, SNAPSHOTS_DIR);
+  const snapshotsDir = path.join(rootDir, MANDU_DIR, HISTORY_DIR, SNAPSHOTS_DIR);
 
   try {
     const entries = await Array.fromAsync(

package/src/change/transaction.ts

@@ -8,7 +8,7 @@ import type {
 } from "./types";
 import { createSnapshot, writeSnapshot, readSnapshotById, restoreSnapshot } from "./snapshot";
 
-const SPEC_DIR = "spec";
+const MANDU_DIR = ".mandu";
 const HISTORY_DIR = "history";
 const CHANGES_FILE = "changes.json";
 const ACTIVE_FILE = "active.json";
@@ -28,7 +28,7 @@ function generateChangeId(): string {
  * History 디렉토리 경로
  */
 function getHistoryDir(rootDir: string): string {
-  return path.join(rootDir, SPEC_DIR, HISTORY_DIR);
+  return path.join(rootDir, MANDU_DIR, HISTORY_DIR);
 }
 
 /**

package/src/config/mandu.ts

@@ -1,96 +1,103 @@
-import path from "path";
-import { readJsonFile } from "../utils/bun";
-
-export type GuardRuleSeverity = "error" | "warn" | "warning" | "off";
-
-export interface ManduConfig {
-  server?: {
-    port?: number;
-    hostname?: string;
-    cors?:
-      | boolean
-      | {
-          origin?: string | string[];
-          methods?: string[];
-          credentials?: boolean;
-        };
-    streaming?: boolean;
-  };
-  guard?: {
-    preset?: "mandu" | "fsd" | "clean" | "hexagonal" | "atomic";
-    srcDir?: string;
-    exclude?: string[];
-    realtime?: boolean;
-    rules?: Record<string, GuardRuleSeverity>;
-    contractRequired?: GuardRuleSeverity;
-  };
-  build?: {
-    outDir?: string;
-    minify?: boolean;
-    sourcemap?: boolean;
-    splitting?: boolean;
-  };
-  dev?: {
-    hmr?: boolean;
-    watchDirs?: string[];
-  };
-  fsRoutes?: {
-    routesDir?: string;
-    extensions?: string[];
-    exclude?: string[];
-    islandSuffix?: string;
-    legacyManifestPath?: string;
-    mergeWithLegacy?: boolean;
-  };
-  seo?: {
-    enabled?: boolean;
-    defaultTitle?: string;
-    titleTemplate?: string;
-  };
-}
-
-export const CONFIG_FILES = [
-  "mandu.config.ts",
-  "mandu.config.js",
-  "mandu.config.json",
-  path.join(".mandu", "guard.json"),
-];
-
-export function coerceConfig(raw: unknown, source: string): ManduConfig {
-  if (!raw || typeof raw !== "object") return {};
-
-  // .mandu/guard.json can be guard-only
-  if (source.endsWith("guard.json") && !("guard" in (raw as Record<string, unknown>))) {
-    return { guard: raw as ManduConfig["guard"] };
-  }
-
-  return raw as ManduConfig;
-}
-
-export async function loadManduConfig(rootDir: string): Promise<ManduConfig> {
-  for (const fileName of CONFIG_FILES) {
-    const filePath = path.join(rootDir, fileName);
-    if (!(await Bun.file(filePath).exists())) {
-      continue;
-    }
-
-    if (fileName.endsWith(".json")) {
-      try {
-        const parsed = await readJsonFile(filePath);
-        return coerceConfig(parsed, fileName);
-      } catch {
-        return {};
-      }
-    }
-
-    try {
-      const module = await import(filePath);
-      const raw = module?.default ?? module;
-      return coerceConfig(raw, fileName);
-    } catch {
-      return {};
-    }
-  }
-
-  return {};
-}
+import path from "path";
+import { readJsonFile } from "../utils/bun";
+
+export type GuardRuleSeverity = "error" | "warn" | "warning" | "off";
+
+export interface ManduConfig {
+  server?: {
+    port?: number;
+    hostname?: string;
+    cors?:
+      | boolean
+      | {
+          origin?: string | string[];
+          methods?: string[];
+          credentials?: boolean;
+        };
+    streaming?: boolean;
+    rateLimit?:
+      | boolean
+      | {
+          windowMs?: number;
+          max?: number;
+          message?: string;
+          statusCode?: number;
+          headers?: boolean;
+        };
+  };
+  guard?: {
+    preset?: "mandu" | "fsd" | "clean" | "hexagonal" | "atomic";
+    srcDir?: string;
+    exclude?: string[];
+    realtime?: boolean;
+    rules?: Record<string, GuardRuleSeverity>;
+    contractRequired?: GuardRuleSeverity;
+  };
+  build?: {
+    outDir?: string;
+    minify?: boolean;
+    sourcemap?: boolean;
+    splitting?: boolean;
+  };
+  dev?: {
+    hmr?: boolean;
+    watchDirs?: string[];
+  };
+  fsRoutes?: {
+    routesDir?: string;
+    extensions?: string[];
+    exclude?: string[];
+    islandSuffix?: string;
+  };
+  seo?: {
+    enabled?: boolean;
+    defaultTitle?: string;
+    titleTemplate?: string;
+  };
+}
+
+export const CONFIG_FILES = [
+  "mandu.config.ts",
+  "mandu.config.js",
+  "mandu.config.json",
+  path.join(".mandu", "guard.json"),
+];
+
+export function coerceConfig(raw: unknown, source: string): ManduConfig {
+  if (!raw || typeof raw !== "object") return {};
+
+  // .mandu/guard.json can be guard-only
+  if (source.endsWith("guard.json") && !("guard" in (raw as Record<string, unknown>))) {
+    return { guard: raw as ManduConfig["guard"] };
+  }
+
+  return raw as ManduConfig;
+}
+
+export async function loadManduConfig(rootDir: string): Promise<ManduConfig> {
+  for (const fileName of CONFIG_FILES) {
+    const filePath = path.join(rootDir, fileName);
+    if (!(await Bun.file(filePath).exists())) {
+      continue;
+    }
+
+    if (fileName.endsWith(".json")) {
+      try {
+        const parsed = await readJsonFile(filePath);
+        return coerceConfig(parsed, fileName);
+      } catch {
+        return {};
+      }
+    }
+
+    try {
+      const module = await import(filePath);
+      const raw = module?.default ?? module;
+      return coerceConfig(raw, fileName);
+    } catch {
+      return {};
+    }
+  }
+
+  return {};
+}