@mandujs/core 0.12.2 → 0.13.1

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/presets/cqrs.test.ts

@@ -52,20 +52,41 @@ describe("CQRS Preset - Structure", () => {
 // ═══════════════════════════════════════════════════════════════════════════
 
 describe("CQRS Preset - Command/Query Separation", () => {
-  // TODO(human): CQRS 분리 규칙 검증 테스트를 작성하세요.
-  //
-  // 힌트:
-  //   - cqrsPreset.layers 배열에서 특정 레이어를 찾으려면:
-  //     const commandsLayer = cqrsPreset.layers.find(l => l.name === "application/commands");
-  //   - commandsLayer.canImport 배열에 특정 레이어가 포함/미포함인지 검증
-  //
-  // 작성해야 할 테스트 케이스:
-  //   1. commands는 queries를 import할 수 없어야 함
-  //   2. queries는 commands와 events를 import할 수 없어야 함
-  //   3. commands는 domain, dto, events를 import할 수 있어야 함
-  //   4. queries는 domain, dto를 import할 수 있어야 함
-  //   5. domain은 shared만 import할 수 있어야 함
-  //   6. shared는 아무것도 import할 수 없어야 함
+  const findLayer = (name: string) => cqrsPreset.layers.find((l) => l.name === name)!;
+
+  it("commands cannot import queries", () => {
+    const commands = findLayer("application/commands");
+    expect(commands.canImport).not.toContain("application/queries");
+  });
+
+  it("queries cannot import commands or events", () => {
+    const queries = findLayer("application/queries");
+    expect(queries.canImport).not.toContain("application/commands");
+    expect(queries.canImport).not.toContain("application/events");
+  });
+
+  it("commands can import domain, dto, events", () => {
+    const commands = findLayer("application/commands");
+    expect(commands.canImport).toContain("domain");
+    expect(commands.canImport).toContain("application/dto");
+    expect(commands.canImport).toContain("application/events");
+  });
+
+  it("queries can import domain, dto", () => {
+    const queries = findLayer("application/queries");
+    expect(queries.canImport).toContain("domain");
+    expect(queries.canImport).toContain("application/dto");
+  });
+
+  it("domain can only import shared", () => {
+    const domain = findLayer("domain");
+    expect(domain.canImport).toEqual(["shared"]);
+  });
+
+  it("shared cannot import anything", () => {
+    const shared = findLayer("shared");
+    expect(shared.canImport).toEqual([]);
+  });
 });
 
 // ═══════════════════════════════════════════════════════════════════════════

package/src/index.ts

@@ -21,9 +21,10 @@ export * from "./seo";
 export * from "./island";
 export * from "./intent";
 export * from "./devtools";
+export * from "./paths";
 
 // Consolidated Mandu namespace
-import { ManduFilling, ManduContext, ManduFillingFactory } from "./filling";
+import { ManduFilling, ManduContext, ManduFillingFactory, createSSEConnection } from "./filling";
 import { createContract, defineHandler, defineRoute, createClient, contractFetch, createClientContract } from "./contract";
 import { defineContract, generateAllFromContract, generateOpenAPISpec } from "./contract/define";
 import { island, isIsland, type IslandComponent, type HydrationStrategy } from "./island";
@@ -74,6 +75,11 @@ export const Mandu = {
    */
   context: ManduFillingFactory.context,
 
+  /**
+   * Create a Server-Sent Events (SSE) connection helper
+   */
+  sse: createSSEConnection,
+
   // === Contract API ===
   /**
    * Define a typed API contract

package/src/paths.test.ts

@@ -0,0 +1,47 @@
+import { describe, test, expect } from "bun:test";
+import { resolveGeneratedPaths, GENERATED_RELATIVE_PATHS } from "./paths";
+import path from "path";
+
+describe("resolveGeneratedPaths", () => {
+  test("should return .mandu/generated based paths", () => {
+    const rootDir = "/project";
+    const paths = resolveGeneratedPaths(rootDir);
+
+    expect(paths.serverRoutesDir).toBe(
+      path.join("/project", ".mandu/generated/server/routes")
+    );
+    expect(paths.webRoutesDir).toBe(
+      path.join("/project", ".mandu/generated/web/routes")
+    );
+    expect(paths.typesDir).toBe(
+      path.join("/project", ".mandu/generated/server/types")
+    );
+    expect(paths.mapDir).toBe(
+      path.join("/project", ".mandu/generated")
+    );
+  });
+
+  test("should handle Windows-style root paths", () => {
+    const rootDir = "C:\\Users\\User\\project";
+    const paths = resolveGeneratedPaths(rootDir);
+
+    expect(paths.serverRoutesDir).toContain(".mandu");
+    expect(paths.serverRoutesDir).toContain("server");
+    expect(paths.serverRoutesDir).toContain("routes");
+  });
+});
+
+describe("GENERATED_RELATIVE_PATHS", () => {
+  test("should not contain apps/ prefix", () => {
+    expect(GENERATED_RELATIVE_PATHS.serverRoutes).not.toContain("apps/");
+    expect(GENERATED_RELATIVE_PATHS.webRoutes).not.toContain("apps/");
+    expect(GENERATED_RELATIVE_PATHS.types).not.toContain("apps/");
+  });
+
+  test("should use .mandu/generated prefix", () => {
+    expect(GENERATED_RELATIVE_PATHS.serverRoutes).toStartWith(".mandu/generated");
+    expect(GENERATED_RELATIVE_PATHS.webRoutes).toStartWith(".mandu/generated");
+    expect(GENERATED_RELATIVE_PATHS.types).toStartWith(".mandu/generated");
+    expect(GENERATED_RELATIVE_PATHS.map).toStartWith(".mandu/generated");
+  });
+});

package/src/paths.ts

@@ -0,0 +1,47 @@
+import path from "path";
+
+/**
+ * 프레임워크가 생성하는 파일들의 경로 구조
+ * apps/ 하드코딩 대신 .mandu/ 기반 중앙 관리
+ */
+export interface GeneratedPaths {
+  /** 서버 라우트 핸들러 디렉토리 */
+  serverRoutesDir: string;
+  /** 웹 라우트 컴포넌트 디렉토리 */
+  webRoutesDir: string;
+  /** 타입 글루 디렉토리 */
+  typesDir: string;
+  /** 생성 맵 디렉토리 */
+  mapDir: string;
+  /** 생성된 매니페스트 경로 */
+  manifestPath: string;
+  /** 생성된 lock 경로 */
+  lockPath: string;
+}
+
+/**
+ * 프로젝트 루트에서 생성 경로를 결정
+ */
+export function resolveGeneratedPaths(rootDir: string): GeneratedPaths {
+  return {
+    serverRoutesDir: path.join(rootDir, ".mandu/generated/server/routes"),
+    webRoutesDir: path.join(rootDir, ".mandu/generated/web/routes"),
+    typesDir: path.join(rootDir, ".mandu/generated/server/types"),
+    mapDir: path.join(rootDir, ".mandu/generated"),
+    manifestPath: path.join(rootDir, ".mandu/routes.manifest.json"),
+    lockPath: path.join(rootDir, ".mandu/spec.lock.json"),
+  };
+}
+
+/**
+ * 생성된 파일의 상대 경로 (generatedMap.files 키 등에 사용)
+ */
+export const GENERATED_RELATIVE_PATHS = {
+  serverRoutes: ".mandu/generated/server/routes",
+  webRoutes: ".mandu/generated/web/routes",
+  types: ".mandu/generated/server/types",
+  map: ".mandu/generated",
+  manifest: ".mandu/routes.manifest.json",
+  lock: ".mandu/spec.lock.json",
+  history: ".mandu/history",
+} as const;

package/src/report/build.ts

@@ -32,7 +32,7 @@ export function buildGuardReport(checkResult: GuardCheckResult): ManuduReport {
     );
 
     if (hasHashMismatch) {
-      nextActions.push("bunx mandu spec-upsert --file spec/routes.manifest.json");
+      nextActions.push("bunx mandu routes generate");
     }
     if (hasManualEdit) {
       nextActions.push("bunx mandu generate");