@mandujs/core 0.12.1 → 0.13.0

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",
+  },
+};

package/src/guard/presets/cqrs.test.ts

@@ -0,0 +1,175 @@
+/**
+ * CQRS Preset Tests
+ *
+ * CQRS 프리셋의 구조 검증 및 Command/Query 분리 규칙 테스트
+ */
+
+import { describe, it, expect, beforeAll, afterAll } from "bun:test";
+import { mkdtemp, rm, mkdir } from "fs/promises";
+import { join } from "path";
+import { tmpdir } from "os";
+import { cqrsPreset, CQRS_HIERARCHY } from "./cqrs";
+import { presets, getPreset } from "./index";
+import { negotiate, generateScaffold } from "../negotiation";
+
+// ═══════════════════════════════════════════════════════════════════════════
+// Preset Structure Tests
+// ═══════════════════════════════════════════════════════════════════════════
+
+describe("CQRS Preset - Structure", () => {
+  it("should be registered in presets map", () => {
+    expect(presets.cqrs).toBeDefined();
+    expect(presets.cqrs).toBe(cqrsPreset);
+  });
+
+  it("should be retrievable via getPreset", () => {
+    expect(getPreset("cqrs")).toBe(cqrsPreset);
+  });
+
+  it("should have correct name and description", () => {
+    expect(cqrsPreset.name).toBe("cqrs");
+    expect(cqrsPreset.description).toContain("CQRS");
+  });
+
+  it("should define all 10 layers", () => {
+    expect(cqrsPreset.layers).toHaveLength(10);
+  });
+
+  it("should have hierarchy matching layer names", () => {
+    const layerNames = cqrsPreset.layers.map((l) => l.name);
+    for (const h of CQRS_HIERARCHY) {
+      expect(layerNames).toContain(h);
+    }
+  });
+
+  it("should set layerViolation severity to error", () => {
+    expect(cqrsPreset.defaultSeverity?.layerViolation).toBe("error");
+  });
+});
+
+// ═══════════════════════════════════════════════════════════════════════════
+// CQRS Separation Rules - TODO(human)
+// ═══════════════════════════════════════════════════════════════════════════
+
+describe("CQRS Preset - Command/Query Separation", () => {
+  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([]);
+  });
+});
+
+// ═══════════════════════════════════════════════════════════════════════════
+// CQRS Scaffolding Tests
+// ═══════════════════════════════════════════════════════════════════════════
+
+let SCAFFOLD_DIR: string;
+
+beforeAll(async () => {
+  SCAFFOLD_DIR = await mkdtemp(join(tmpdir(), "test-cqrs-scaffold-"));
+  await mkdir(join(SCAFFOLD_DIR, "spec", "decisions"), { recursive: true });
+});
+
+afterAll(async () => {
+  await rm(SCAFFOLD_DIR, { recursive: true, force: true });
+});
+
+describe("CQRS Preset - Scaffold Templates", () => {
+  it("should generate commands/queries separation for auth", async () => {
+    const result = await negotiate(
+      { intent: "사용자 인증 추가", category: "auth", preset: "cqrs" },
+      SCAFFOLD_DIR,
+    );
+
+    expect(result.approved).toBe(true);
+    expect(result.preset).toBe("cqrs");
+
+    const paths = result.structure.map((s) => s.path);
+    expect(paths.some((p) => p.includes("application/commands"))).toBe(true);
+    expect(paths.some((p) => p.includes("application/queries"))).toBe(true);
+    expect(paths.some((p) => p.includes("application/dto"))).toBe(true);
+    expect(paths.some((p) => p.includes("application/events"))).toBe(true);
+  });
+
+  it("should generate CRUD with separate commands and queries", async () => {
+    const result = await negotiate(
+      { intent: "상품 관리 CRUD", category: "crud", preset: "cqrs" },
+      SCAFFOLD_DIR,
+    );
+
+    const commandsDir = result.structure.find((s) => s.path.includes("application/commands"));
+    const queriesDir = result.structure.find((s) => s.path.includes("application/queries"));
+
+    expect(commandsDir).toBeDefined();
+    expect(queriesDir).toBeDefined();
+
+    // commands에 create/update/delete가 있어야 함
+    const cmdFiles = commandsDir!.files.map((f) => f.name);
+    expect(cmdFiles.some((f) => f.includes("create"))).toBe(true);
+    expect(cmdFiles.some((f) => f.includes("update"))).toBe(true);
+    expect(cmdFiles.some((f) => f.includes("delete"))).toBe(true);
+
+    // queries에 get/list가 있어야 함
+    const qryFiles = queriesDir!.files.map((f) => f.name);
+    expect(qryFiles.some((f) => f.includes("get"))).toBe(true);
+    expect(qryFiles.some((f) => f.includes("list"))).toBe(true);
+  });
+
+  it("should create actual scaffold files", async () => {
+    const testDir = await mkdtemp(join(SCAFFOLD_DIR, "actual-"));
+    await mkdir(join(testDir, "spec", "decisions"), { recursive: true });
+
+    const plan = await negotiate(
+      { intent: "order feature", category: "crud", preset: "cqrs" },
+      testDir,
+    );
+    const result = await generateScaffold(plan.structure, testDir);
+
+    expect(result.success).toBe(true);
+    expect(result.createdFiles.some((f) => f.includes("command"))).toBe(true);
+    expect(result.createdFiles.some((f) => f.includes("query"))).toBe(true);
+  });
+
+  it("should use src/ prefixed paths (no adjustStructureForPreset)", async () => {
+    const result = await negotiate(
+      { intent: "payment api", category: "api", preset: "cqrs" },
+      SCAFFOLD_DIR,
+    );
+
+    // CQRS 전용 템플릿은 이미 src/ 기준 경로를 사용
+    const paths = result.structure.map((s) => s.path);
+    for (const p of paths) {
+      expect(p.startsWith("src/")).toBe(true);
+    }
+  });
+});

package/src/guard/presets/cqrs.ts

@@ -0,0 +1,107 @@
+/**
+ * CQRS Preset
+ *
+ * Command Query Responsibility Segregation 아키텍처
+ * 쓰기 경로(Commands)와 읽기 경로(Queries)의 격리를 프레임워크 레벨에서 강제
+ */
+
+import type { PresetDefinition } from "../types";
+
+/**
+ * CQRS 레이어 계층 구조
+ *
+ * 의존성: 외부 → 내부 (domain이 핵심)
+ * commands와 queries는 서로 격리됨
+ */
+export const CQRS_HIERARCHY = [
+  "api",
+  "infra",
+  "application/commands",
+  "application/queries",
+  "application/dto",
+  "application/mappers",
+  "application/events",
+  "domain",
+  "core",
+  "shared",
+] as const;
+
+/**
+ * CQRS 프리셋 정의
+ */
+export const cqrsPreset: PresetDefinition = {
+  name: "cqrs",
+  description: "CQRS - Command/Query 분리 아키텍처",
+
+  hierarchy: [...CQRS_HIERARCHY],
+
+  layers: [
+    {
+      name: "api",
+      pattern: "src/**/api/**",
+      canImport: ["application/commands", "application/queries", "application/dto", "core", "shared"],
+      description: "Controllers, Routes - Command/Query 디스패치",
+    },
+    {
+      name: "infra",
+      pattern: "src/**/infra/**",
+      canImport: ["application/commands", "application/queries", "domain", "core", "shared"],
+      description: "Repository 구현, 외부 서비스 어댑터",
+    },
+    {
+      name: "application/commands",
+      pattern: "src/**/application/commands/**",
+      canImport: ["domain", "application/dto", "application/events", "core", "shared"],
+      description: "Command Handlers - 쓰기 경로 (queries 접근 불가)",
+    },
+    {
+      name: "application/queries",
+      pattern: "src/**/application/queries/**",
+      canImport: ["domain", "application/dto", "core", "shared"],
+      description: "Query Handlers - 읽기 경로 (commands, events 접근 불가)",
+    },
+    {
+      name: "application/dto",
+      pattern: "src/**/application/dto/**",
+      canImport: ["domain", "shared"],
+      description: "Data Transfer Objects",
+    },
+    {
+      name: "application/mappers",
+      pattern: "src/**/application/mappers/**",
+      canImport: ["domain", "application/dto", "shared"],
+      description: "Domain ↔ DTO 변환기",
+    },
+    {
+      name: "application/events",
+      pattern: "src/**/application/events/**",
+      canImport: ["domain", "shared"],
+      description: "Domain Events, Integration Events",
+    },
+    {
+      name: "domain",
+      pattern: "src/**/domain/**",
+      canImport: ["shared"],
+      description: "Entities, Value Objects, Domain Services, Aggregates",
+    },
+    {
+      name: "core",
+      pattern: "src/core/**",
+      canImport: ["shared"],
+      description: "공통 핵심 (auth, config, errors, CQRS bus)",
+    },
+    {
+      name: "shared",
+      pattern: "src/shared/**",
+      canImport: [],
+      description: "공유 유틸리티, 타입, 인터페이스",
+    },
+  ],
+
+  defaultSeverity: {
+    layerViolation: "error",
+    circularDependency: "error",
+    crossSliceDependency: "warn",
+    deepNesting: "info",
+  },
+};

package/src/guard/presets/fsd.ts

@@ -1,79 +1,79 @@
-/**
- * FSD (Feature-Sliced Design) Preset
- *
- * 프론트엔드 권장 아키텍처
- *
- * @see https://feature-sliced.design/
- */
-
-import type { PresetDefinition } from "../types";
-
-/**
- * FSD 레이어 계층 구조 (상위 → 하위)
- *
- * app → pages → widgets → features → entities → shared
- */
-export const FSD_HIERARCHY = [
-  "app",
-  "pages",
-  "widgets",
-  "features",
-  "entities",
-  "shared",
-] as const;
-
-/**
- * FSD 프리셋 정의
- */
-export const fsdPreset: PresetDefinition = {
-  name: "fsd",
-  description: "Feature-Sliced Design - 프론트엔드 권장 아키텍처",
-
-  hierarchy: [...FSD_HIERARCHY],
-
-  layers: [
-    {
-      name: "app",
-      pattern: "src/app/**",
-      canImport: ["pages", "widgets", "features", "entities", "shared"],
-      description: "앱 진입점, 프로바이더, 글로벌 스타일",
-    },
-    {
-      name: "pages",
-      pattern: "src/pages/**",
-      canImport: ["widgets", "features", "entities", "shared"],
-      description: "페이지 컴포넌트, 라우팅",
-    },
-    {
-      name: "widgets",
-      pattern: "src/widgets/**",
-      canImport: ["features", "entities", "shared"],
-      description: "독립적인 UI 블록 (Header, Sidebar 등)",
-    },
-    {
-      name: "features",
-      pattern: "src/features/**",
-      canImport: ["entities", "shared"],
-      description: "비즈니스 기능 (로그인, 결제 등)",
-    },
-    {
-      name: "entities",
-      pattern: "src/entities/**",
-      canImport: ["shared"],
-      description: "비즈니스 엔티티 (User, Product 등)",
-    },
-    {
-      name: "shared",
-      pattern: "src/shared/**",
-      canImport: [],
-      description: "공유 유틸, UI 컴포넌트, 라이브러리",
-    },
-  ],
-
-  defaultSeverity: {
-    layerViolation: "error",
-    circularDependency: "warn",
-    crossSliceDependency: "warn",
-    deepNesting: "info",
-  },
-};
+/**
+ * FSD (Feature-Sliced Design) Preset
+ *
+ * 프론트엔드 권장 아키텍처
+ *
+ * @see https://feature-sliced.design/
+ */
+
+import type { PresetDefinition } from "../types";
+
+/**
+ * FSD 레이어 계층 구조 (상위 → 하위)
+ *
+ * app → pages → widgets → features → entities → shared
+ */
+export const FSD_HIERARCHY = [
+  "app",
+  "pages",
+  "widgets",
+  "features",
+  "entities",
+  "shared",
+] as const;
+
+/**
+ * FSD 프리셋 정의
+ */
+export const fsdPreset: PresetDefinition = {
+  name: "fsd",
+  description: "Feature-Sliced Design - 프론트엔드 권장 아키텍처",
+
+  hierarchy: [...FSD_HIERARCHY],
+
+  layers: [
+    {
+      name: "app",
+      pattern: "src/app/**",
+      canImport: ["pages", "widgets", "features", "entities", "shared"],
+      description: "앱 진입점, 프로바이더, 글로벌 스타일",
+    },
+    {
+      name: "pages",
+      pattern: "src/pages/**",
+      canImport: ["widgets", "features", "entities", "shared"],
+      description: "페이지 컴포넌트, 라우팅",
+    },
+    {
+      name: "widgets",
+      pattern: "src/widgets/**",
+      canImport: ["features", "entities", "shared"],
+      description: "독립적인 UI 블록 (Header, Sidebar 등)",
+    },
+    {
+      name: "features",
+      pattern: "src/features/**",
+      canImport: ["entities", "shared"],
+      description: "비즈니스 기능 (로그인, 결제 등)",
+    },
+    {
+      name: "entities",
+      pattern: "src/entities/**",
+      canImport: ["shared"],
+      description: "비즈니스 엔티티 (User, Product 등)",
+    },
+    {
+      name: "shared",
+      pattern: "src/shared/**",
+      canImport: [],
+      description: "공유 유틸, UI 컴포넌트, 라이브러리",
+    },
+  ],
+
+  defaultSeverity: {
+    layerViolation: "error",
+    circularDependency: "warn",
+    crossSliceDependency: "warn",
+    deepNesting: "info",
+  },
+};