@mandujs/core 0.12.2 → 0.13.0

package/src/guard/auto-correct.ts

@@ -172,7 +172,7 @@ async function correctSpecHashMismatch(
   rootDir: string
 ): Promise<AutoCorrectStep> {
   try {
-    const lockPath = path.join(rootDir, "spec/spec.lock.json");
+    const lockPath = path.join(rootDir, ".mandu/spec.lock.json");
     await writeLock(lockPath, manifest);
 
     return {

package/src/guard/check.ts

@@ -1,46 +1,46 @@
-import { GUARD_RULES, FORBIDDEN_IMPORTS, type GuardViolation } from "./rules";
-import { verifyLock, computeHash } from "../spec/lock";
-import { runContractGuardCheck } from "./contract-guard";
-import { validateSlotContent } from "../slot/validator";
-import type { RoutesManifest } from "../spec/schema";
-import type { GeneratedMap } from "../generator/generate";
-import { loadManduConfig, type GuardRuleSeverity } from "../config";
-import path from "path";
-import fs from "fs/promises";
-
-export interface GuardCheckResult {
-  passed: boolean;
-  violations: GuardViolation[];
-}
-
-function normalizeSeverity(level: GuardRuleSeverity): "error" | "warning" | "off" {
-  if (level === "warn") return "warning";
-  return level;
-}
-
-function applyRuleSeverity(
-  violations: GuardViolation[],
-  config: { rules?: Record<string, GuardRuleSeverity>; contractRequired?: GuardRuleSeverity }
-): GuardViolation[] {
-  const resolved: GuardViolation[] = [];
-  const ruleOverrides = config.rules ?? {};
-
-  for (const violation of violations) {
-    let override = ruleOverrides[violation.ruleId];
-    if (violation.ruleId === "CONTRACT_MISSING" && config.contractRequired) {
-      override = config.contractRequired;
-    }
-
-    const baseSeverity = violation.severity ?? GUARD_RULES[violation.ruleId]?.severity ?? "error";
-    const finalSeverity = override ? normalizeSeverity(override) : baseSeverity;
-
-    if (finalSeverity === "off") continue;
-
-    resolved.push({ ...violation, severity: finalSeverity });
-  }
-
-  return resolved;
-}
+import { GUARD_RULES, FORBIDDEN_IMPORTS, type GuardViolation } from "./rules";
+import { verifyLock, computeHash } from "../spec/lock";
+import { runContractGuardCheck } from "./contract-guard";
+import { validateSlotContent } from "../slot/validator";
+import type { RoutesManifest } from "../spec/schema";
+import type { GeneratedMap } from "../generator/generate";
+import { loadManduConfig, type GuardRuleSeverity } from "../config";
+import path from "path";
+import fs from "fs/promises";
+
+export interface GuardCheckResult {
+  passed: boolean;
+  violations: GuardViolation[];
+}
+
+function normalizeSeverity(level: GuardRuleSeverity): "error" | "warning" | "off" {
+  if (level === "warn") return "warning";
+  return level;
+}
+
+function applyRuleSeverity(
+  violations: GuardViolation[],
+  config: { rules?: Record<string, GuardRuleSeverity>; contractRequired?: GuardRuleSeverity }
+): GuardViolation[] {
+  const resolved: GuardViolation[] = [];
+  const ruleOverrides = config.rules ?? {};
+
+  for (const violation of violations) {
+    let override = ruleOverrides[violation.ruleId];
+    if (violation.ruleId === "CONTRACT_MISSING" && config.contractRequired) {
+      override = config.contractRequired;
+    }
+
+    const baseSeverity = violation.severity ?? GUARD_RULES[violation.ruleId]?.severity ?? "error";
+    const finalSeverity = override ? normalizeSeverity(override) : baseSeverity;
+
+    if (finalSeverity === "off") continue;
+
+    resolved.push({ ...violation, severity: finalSeverity });
+  }
+
+  return resolved;
+}
 
 async function fileExists(filePath: string): Promise<boolean> {
   try {
@@ -116,8 +116,8 @@ export async function checkInvalidGeneratedImport(
   // Scan non-generated source files
   const sourceDirs = [
     path.join(rootDir, "packages"),
-    path.join(rootDir, "apps/server"),
-    path.join(rootDir, "apps/web"),
+    path.join(rootDir, "src"),
+    path.join(rootDir, "app"),
   ];
 
   for (const sourceDir of sourceDirs) {
@@ -200,15 +200,15 @@ export async function checkSlotContentValidation(
       if (issue.severity === "error") {
         // Map slot issue codes to guard rule IDs
         let ruleId = "SLOT_VALIDATION_ERROR";
-        if (issue.code === "MISSING_DEFAULT_EXPORT") {
-          ruleId = GUARD_RULES.SLOT_MISSING_DEFAULT_EXPORT?.id ?? "SLOT_MISSING_DEFAULT_EXPORT";
-        } else if (issue.code === "NO_RESPONSE_PATTERN" || issue.code === "INVALID_HANDLER_RETURN") {
-          ruleId = GUARD_RULES.SLOT_INVALID_RETURN?.id ?? "SLOT_INVALID_RETURN";
-        } else if (issue.code === "MISSING_FILLING_PATTERN") {
-          ruleId = GUARD_RULES.SLOT_MISSING_FILLING_PATTERN?.id ?? "SLOT_MISSING_FILLING_PATTERN";
-        } else if (issue.code === "ZOD_DIRECT_IMPORT") {
-          ruleId = GUARD_RULES.SLOT_ZOD_DIRECT_IMPORT?.id ?? "SLOT_ZOD_DIRECT_IMPORT";
-        }
+        if (issue.code === "MISSING_DEFAULT_EXPORT") {
+          ruleId = GUARD_RULES.SLOT_MISSING_DEFAULT_EXPORT?.id ?? "SLOT_MISSING_DEFAULT_EXPORT";
+        } else if (issue.code === "NO_RESPONSE_PATTERN" || issue.code === "INVALID_HANDLER_RETURN") {
+          ruleId = GUARD_RULES.SLOT_INVALID_RETURN?.id ?? "SLOT_INVALID_RETURN";
+        } else if (issue.code === "MISSING_FILLING_PATTERN") {
+          ruleId = GUARD_RULES.SLOT_MISSING_FILLING_PATTERN?.id ?? "SLOT_MISSING_FILLING_PATTERN";
+        } else if (issue.code === "ZOD_DIRECT_IMPORT") {
+          ruleId = GUARD_RULES.SLOT_ZOD_DIRECT_IMPORT?.id ?? "SLOT_ZOD_DIRECT_IMPORT";
+        }
 
         violations.push({
           ruleId,
@@ -339,7 +339,7 @@ export async function checkSpecDirNaming(
           ruleId: GUARD_RULES.SLOT_DIR_INVALID_FILE.id,
           file: `spec/slots/${file}`,
           message: `spec/slots/에 .slot.ts가 아닌 파일: ${file}`,
-          suggestion: `.slot.ts로 이름을 바꾸거나, 이 파일이 client slot이면 apps/web/components/로 이동하세요`,
+          suggestion: `.slot.ts로 이름을 바꾸거나, 이 파일이 client slot이면 spec/slots/로 .client.ts 접미사로 이동하세요`,
         });
       }
     }
@@ -364,76 +364,76 @@ export async function checkSpecDirNaming(
   return violations;
 }
 
-export async function runGuardCheck(
-  manifest: RoutesManifest,
-  rootDir: string
-): Promise<GuardCheckResult> {
-  const config = await loadManduConfig(rootDir);
-
-  const lockPath = path.join(rootDir, "spec/spec.lock.json");
-  const mapPath = path.join(rootDir, "packages/core/map/generated.map.json");
-
-  // ============================================
-  // Phase 1: 독립적인 검사 병렬 실행
-  // ============================================
-  const [
-    hashViolation,
-    importViolations,
-    slotViolations,
-    specDirViolations,
-    islandViolations,
-  ] = await Promise.all([
-    checkSpecHashMismatch(manifest, lockPath),
-    checkInvalidGeneratedImport(rootDir),
-    checkSlotFileExists(manifest, rootDir),
-    checkSpecDirNaming(rootDir),
-    checkIslandFirstIntegrity(manifest, rootDir),
-  ]);
-
-  const violations: GuardViolation[] = [];
-  if (hashViolation) violations.push(hashViolation);
-  violations.push(...importViolations);
-  violations.push(...slotViolations);
-  violations.push(...specDirViolations);
-  violations.push(...islandViolations);
-
-  // ============================================
-  // Phase 2: generatedMap 의존 검사
-  // ============================================
-  let generatedMap: GeneratedMap | null = null;
-  if (await fileExists(mapPath)) {
-    try {
-      const mapContent = await Bun.file(mapPath).text();
-      generatedMap = JSON.parse(mapContent);
-    } catch {
-      // Map file corrupted or missing
-    }
-  }
-
-  if (generatedMap) {
-    const [editViolations, forbiddenViolations] = await Promise.all([
-      checkGeneratedManualEdit(rootDir, generatedMap),
-      checkForbiddenImportsInGenerated(rootDir, generatedMap),
-    ]);
-    violations.push(...editViolations);
-    violations.push(...forbiddenViolations);
-  }
-
-  // ============================================
-  // Phase 3: Slot + Contract 검사 병렬
-  // ============================================
-  const [slotContentViolations, contractViolations] = await Promise.all([
-    checkSlotContentValidation(manifest, rootDir),
-    runContractGuardCheck(manifest, rootDir),
-  ]);
-  violations.push(...slotContentViolations);
-  violations.push(...contractViolations);
-
-  const resolvedViolations = applyRuleSeverity(violations, config.guard ?? {});
-  const passed = resolvedViolations.every((v) => v.severity !== "error");
-
-  return {
-    passed,
-    violations: resolvedViolations,
-  };
-}
+export async function runGuardCheck(
+  manifest: RoutesManifest,
+  rootDir: string
+): Promise<GuardCheckResult> {
+  const config = await loadManduConfig(rootDir);
+
+  const lockPath = path.join(rootDir, ".mandu/spec.lock.json");
+  const mapPath = path.join(rootDir, ".mandu/generated/generated.map.json");
+
+  // ============================================
+  // Phase 1: 독립적인 검사 병렬 실행
+  // ============================================
+  const [
+    hashViolation,
+    importViolations,
+    slotViolations,
+    specDirViolations,
+    islandViolations,
+  ] = await Promise.all([
+    checkSpecHashMismatch(manifest, lockPath),
+    checkInvalidGeneratedImport(rootDir),
+    checkSlotFileExists(manifest, rootDir),
+    checkSpecDirNaming(rootDir),
+    checkIslandFirstIntegrity(manifest, rootDir),
+  ]);
+
+  const violations: GuardViolation[] = [];
+  if (hashViolation) violations.push(hashViolation);
+  violations.push(...importViolations);
+  violations.push(...slotViolations);
+  violations.push(...specDirViolations);
+  violations.push(...islandViolations);
+
+  // ============================================
+  // Phase 2: generatedMap 의존 검사
+  // ============================================
+  let generatedMap: GeneratedMap | null = null;
+  if (await fileExists(mapPath)) {
+    try {
+      const mapContent = await Bun.file(mapPath).text();
+      generatedMap = JSON.parse(mapContent);
+    } catch {
+      // Map file corrupted or missing
+    }
+  }
+
+  if (generatedMap) {
+    const [editViolations, forbiddenViolations] = await Promise.all([
+      checkGeneratedManualEdit(rootDir, generatedMap),
+      checkForbiddenImportsInGenerated(rootDir, generatedMap),
+    ]);
+    violations.push(...editViolations);
+    violations.push(...forbiddenViolations);
+  }
+
+  // ============================================
+  // Phase 3: Slot + Contract 검사 병렬
+  // ============================================
+  const [slotContentViolations, contractViolations] = await Promise.all([
+    checkSlotContentValidation(manifest, rootDir),
+    runContractGuardCheck(manifest, rootDir),
+  ]);
+  violations.push(...slotContentViolations);
+  violations.push(...contractViolations);
+
+  const resolvedViolations = applyRuleSeverity(violations, config.guard ?? {});
+  const passed = resolvedViolations.every((v) => v.severity !== "error");
+
+  return {
+    passed,
+    violations: resolvedViolations,
+  };
+}

package/src/guard/contract-guard.ts

@@ -199,15 +199,15 @@ export async function checkContractSlotConsistency(
 /**
  * Run all contract-related guard checks
  */
-export async function runContractGuardCheck(
-  manifest: RoutesManifest,
-  rootDir: string
-): Promise<ContractViolation[]> {
-  const violations: ContractViolation[] = [];
-
-  // Check missing contracts (warning level)
-  const missingContracts = await checkMissingContract(manifest, rootDir);
-  violations.push(...missingContracts);
+export async function runContractGuardCheck(
+  manifest: RoutesManifest,
+  rootDir: string
+): Promise<ContractViolation[]> {
+  const violations: ContractViolation[] = [];
+
+  // Check missing contracts (warning level)
+  const missingContracts = await checkMissingContract(manifest, rootDir);
+  violations.push(...missingContracts);
 
   // Check contract file exists
   const notFoundContracts = await checkContractFileExists(manifest, rootDir);

package/src/guard/file-type.test.ts

@@ -1,24 +1,24 @@
-import { describe, it, expect } from "vitest";
-import { validateFileAnalysis } from "./validator";
-import { fsdPreset } from "./presets/fsd";
-import type { FileAnalysis, GuardConfig } from "./types";
-
-describe("TypeScript-only rule", () => {
-  const layers = fsdPreset.layers;
-  const config: GuardConfig = {
-    preset: "fsd",
-    severity: { fileType: "error" },
-  };
-
-  it("should flag .jsx files", () => {
-    const analysis: FileAnalysis = {
-      filePath: "src/pages/home.jsx",
-      layer: "pages",
-      imports: [],
-      analyzedAt: Date.now(),
-    };
-
-    const violations = validateFileAnalysis(analysis, layers, config);
-    expect(violations.some((v) => v.type === "file-type")).toBe(true);
-  });
-});
+import { describe, it, expect } from "vitest";
+import { validateFileAnalysis } from "./validator";
+import { fsdPreset } from "./presets/fsd";
+import type { FileAnalysis, GuardConfig } from "./types";
+
+describe("TypeScript-only rule", () => {
+  const layers = fsdPreset.layers;
+  const config: GuardConfig = {
+    preset: "fsd",
+    severity: { fileType: "error" },
+  };
+
+  it("should flag .jsx files", () => {
+    const analysis: FileAnalysis = {
+      filePath: "src/pages/home.jsx",
+      layer: "pages",
+      imports: [],
+      analyzedAt: Date.now(),
+    };
+
+    const violations = validateFileAnalysis(analysis, layers, config);
+    expect(violations.some((v) => v.type === "file-type")).toBe(true);
+  });
+});

package/src/guard/presets/atomic.ts

@@ -1,70 +1,70 @@
-/**
- * Atomic Design Preset
- *
- * UI 컴포넌트 아키텍처
- *
- * @see https://bradfrost.com/blog/post/atomic-web-design/
- */
-
-import type { PresetDefinition } from "../types";
-
-/**
- * Atomic Design 레이어 계층 구조 (복잡 → 단순)
- */
-export const ATOMIC_HIERARCHY = [
-  "pages",
-  "templates",
-  "organisms",
-  "molecules",
-  "atoms",
-] as const;
-
-/**
- * Atomic Design 프리셋 정의
- */
-export const atomicPreset: PresetDefinition = {
-  name: "atomic",
-  description: "Atomic Design - UI 컴포넌트 아키텍처",
-
-  hierarchy: [...ATOMIC_HIERARCHY],
-
-  layers: [
-    {
-      name: "pages",
-      pattern: "src/components/pages/**",
-      canImport: ["templates", "organisms", "molecules", "atoms"],
-      description: "페이지 컴포넌트 (특정 콘텐츠가 있는 템플릿)",
-    },
-    {
-      name: "templates",
-      pattern: "src/components/templates/**",
-      canImport: ["organisms", "molecules", "atoms"],
-      description: "페이지 템플릿 (레이아웃 구조)",
-    },
-    {
-      name: "organisms",
-      pattern: "src/components/organisms/**",
-      canImport: ["molecules", "atoms"],
-      description: "복잡한 UI 블록 (Header, Footer, Form)",
-    },
-    {
-      name: "molecules",
-      pattern: "src/components/molecules/**",
-      canImport: ["atoms"],
-      description: "조합된 컴포넌트 (SearchInput, Card)",
-    },
-    {
-      name: "atoms",
-      pattern: "src/components/atoms/**",
-      canImport: [],
-      description: "기본 요소 (Button, Input, Text)",
-    },
-  ],
-
-  defaultSeverity: {
-    layerViolation: "error",
-    circularDependency: "warn",
-    crossSliceDependency: "info",
-    deepNesting: "info",
-  },
-};
+/**
+ * Atomic Design Preset
+ *
+ * UI 컴포넌트 아키텍처
+ *
+ * @see https://bradfrost.com/blog/post/atomic-web-design/
+ */
+
+import type { PresetDefinition } from "../types";
+
+/**
+ * Atomic Design 레이어 계층 구조 (복잡 → 단순)
+ */
+export const ATOMIC_HIERARCHY = [
+  "pages",
+  "templates",
+  "organisms",
+  "molecules",
+  "atoms",
+] as const;
+
+/**
+ * Atomic Design 프리셋 정의
+ */
+export const atomicPreset: PresetDefinition = {
+  name: "atomic",
+  description: "Atomic Design - UI 컴포넌트 아키텍처",
+
+  hierarchy: [...ATOMIC_HIERARCHY],
+
+  layers: [
+    {
+      name: "pages",
+      pattern: "src/components/pages/**",
+      canImport: ["templates", "organisms", "molecules", "atoms"],
+      description: "페이지 컴포넌트 (특정 콘텐츠가 있는 템플릿)",
+    },
+    {
+      name: "templates",
+      pattern: "src/components/templates/**",
+      canImport: ["organisms", "molecules", "atoms"],
+      description: "페이지 템플릿 (레이아웃 구조)",
+    },
+    {
+      name: "organisms",
+      pattern: "src/components/organisms/**",
+      canImport: ["molecules", "atoms"],
+      description: "복잡한 UI 블록 (Header, Footer, Form)",
+    },
+    {
+      name: "molecules",
+      pattern: "src/components/molecules/**",
+      canImport: ["atoms"],
+      description: "조합된 컴포넌트 (SearchInput, Card)",
+    },
+    {
+      name: "atoms",
+      pattern: "src/components/atoms/**",
+      canImport: [],
+      description: "기본 요소 (Button, Input, Text)",
+    },
+  ],
+
+  defaultSeverity: {
+    layerViolation: "error",
+    circularDependency: "warn",
+    crossSliceDependency: "info",
+    deepNesting: "info",
+  },
+};

package/src/guard/presets/clean.ts

@@ -1,77 +1,77 @@
-/**
- * Clean Architecture Preset
- *
- * 백엔드 권장 아키텍처
- */
-
-import type { PresetDefinition } from "../types";
-
-/**
- * Clean Architecture 레이어 계층 구조
- *
- * 의존성: 외부 → 내부 (domain이 핵심)
- */
-export const CLEAN_HIERARCHY = [
-  "api",
-  "infra",
-  "application",
-  "domain",
-  "core",
-  "shared",
-] as const;
-
-/**
- * Clean Architecture 프리셋 정의
- */
-export const cleanPreset: PresetDefinition = {
-  name: "clean",
-  description: "Clean Architecture - 백엔드 권장 아키텍처",
-
-  hierarchy: [...CLEAN_HIERARCHY],
-
-  layers: [
-    {
-      name: "api",
-      pattern: "src/**/api/**",
-      canImport: ["application", "core", "shared"],
-      description: "Controllers, Routes, DTOs",
-    },
-    {
-      name: "infra",
-      pattern: "src/**/infra/**",
-      canImport: ["application", "domain", "core", "shared"],
-      description: "Repositories 구현, 외부 API 클라이언트",
-    },
-    {
-      name: "application",
-      pattern: "src/**/application/**",
-      canImport: ["domain", "core", "shared"],
-      description: "Use Cases, Application Services",
-    },
-    {
-      name: "domain",
-      pattern: "src/**/domain/**",
-      canImport: ["shared"],
-      description: "Entities, Value Objects, Domain Services",
-    },
-    {
-      name: "core",
-      pattern: "src/core/**",
-      canImport: ["shared"],
-      description: "공통 핵심 (auth, config, errors)",
-    },
-    {
-      name: "shared",
-      pattern: "src/shared/**",
-      canImport: [],
-      description: "공유 유틸리티, 타입",
-    },
-  ],
-
-  defaultSeverity: {
-    layerViolation: "error",
-    circularDependency: "error",
-    crossSliceDependency: "warn",
-    deepNesting: "info",
-  },
-};
+/**
+ * Clean Architecture Preset
+ *
+ * 백엔드 권장 아키텍처
+ */
+
+import type { PresetDefinition } from "../types";
+
+/**
+ * Clean Architecture 레이어 계층 구조
+ *
+ * 의존성: 외부 → 내부 (domain이 핵심)
+ */
+export const CLEAN_HIERARCHY = [
+  "api",
+  "infra",
+  "application",
+  "domain",
+  "core",
+  "shared",
+] as const;
+
+/**
+ * Clean Architecture 프리셋 정의
+ */
+export const cleanPreset: PresetDefinition = {
+  name: "clean",
+  description: "Clean Architecture - 백엔드 권장 아키텍처",
+
+  hierarchy: [...CLEAN_HIERARCHY],
+
+  layers: [
+    {
+      name: "api",
+      pattern: "src/**/api/**",
+      canImport: ["application", "core", "shared"],
+      description: "Controllers, Routes, DTOs",
+    },
+    {
+      name: "infra",
+      pattern: "src/**/infra/**",
+      canImport: ["application", "domain", "core", "shared"],
+      description: "Repositories 구현, 외부 API 클라이언트",
+    },
+    {
+      name: "application",
+      pattern: "src/**/application/**",
+      canImport: ["domain", "core", "shared"],
+      description: "Use Cases, Application Services",
+    },
+    {
+      name: "domain",
+      pattern: "src/**/domain/**",
+      canImport: ["shared"],
+      description: "Entities, Value Objects, Domain Services",
+    },
+    {
+      name: "core",
+      pattern: "src/core/**",
+      canImport: ["shared"],
+      description: "공통 핵심 (auth, config, errors)",
+    },
+    {
+      name: "shared",
+      pattern: "src/shared/**",
+      canImport: [],
+      description: "공유 유틸리티, 타입",
+    },
+  ],
+
+  defaultSeverity: {
+    layerViolation: "error",
+    circularDependency: "error",
+    crossSliceDependency: "warn",
+    deepNesting: "info",
+  },
+};