@mandujs/core 0.12.1 → 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/healing.ts

@@ -669,6 +669,8 @@ function getLayerHierarchy(preset?: GuardPreset): string {
       return "adapters → ports → domain";
     case "atomic":
       return "pages → templates → organisms → molecules → atoms";
+    case "cqrs":
+      return "api → commands|queries → dto/events → domain → shared";
     case "mandu":
       return "client(FSD) | shared | server(Clean)";
     default:

package/src/guard/index.ts

@@ -139,11 +139,13 @@ export {
   cleanPreset,
   hexagonalPreset,
   atomicPreset,
+  cqrsPreset,
   manduPreset,
   FSD_HIERARCHY,
   CLEAN_HIERARCHY,
   HEXAGONAL_HIERARCHY,
   ATOMIC_HIERARCHY,
+  CQRS_HIERARCHY,
 } from "./presets";
 
 // ═══════════════════════════════════════════════════════════════════════════