@mandujs/mcp 0.13.0 → 0.17.0

package/src/resources/skills/mandu-guard/metadata.json

@@ -1,12 +1,12 @@
-{
-  "version": "1.0.0",
-  "organization": "Mandu Framework",
-  "date": "February 2026",
-  "abstract": "아키텍처 가드 시스템 가이드. 레이어 간 의존성 규칙을 강제하고 위반을 실시간으로 감지합니다. FSD, Clean Architecture, Hexagonal 등 다양한 프리셋을 지원하며, CI/CD 파이프라인에 통합할 수 있습니다.",
-  "references": [
-    "https://feature-sliced.design/",
-    "https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html",
-    "https://alistair.cockburn.us/hexagonal-architecture/"
-  ],
-  "tags": ["guard", "architecture", "layers", "dependencies", "mandu"]
-}
+{
+  "version": "1.0.0",
+  "organization": "Mandu Framework",
+  "date": "February 2026",
+  "abstract": "아키텍처 가드 시스템 가이드. 레이어 간 의존성 규칙을 강제하고 위반을 실시간으로 감지합니다. FSD, Clean Architecture, Hexagonal 등 다양한 프리셋을 지원하며, CI/CD 파이프라인에 통합할 수 있습니다.",
+  "references": [
+    "https://feature-sliced.design/",
+    "https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html",
+    "https://alistair.cockburn.us/hexagonal-architecture/"
+  ],
+  "tags": ["guard", "architecture", "layers", "dependencies", "mandu"]
+}

package/src/resources/skills/mandu-guard/rules/_sections.md

@@ -1,36 +1,36 @@
-# Sections
-
-This file defines all sections, their ordering, impact levels, and descriptions.
-The section ID (in parentheses) is the filename prefix used to group rules.
-
----
-
-## 1. Layer Rules (guard-layer)
-
-**Impact:** CRITICAL
-**Description:** 레이어 의존성 방향 규칙. 상위→하위만 허용, 역방향 import 금지. 아키텍처 무결성의 핵심입니다.
-
-## 2. Presets (guard-preset)
-
-**Impact:** HIGH
-**Description:** mandu, fsd, clean, hexagonal 프리셋 선택. 프로젝트 유형에 맞는 아키텍처 템플릿입니다.
-
-## 3. Validation (guard-validate)
-
-**Impact:** HIGH
-**Description:** import 경로, 파일 위치, 네이밍 검증. 실시간 위반 감지와 리포팅입니다.
-
-## 4. Configuration (guard-config)
-
-**Impact:** MEDIUM
-**Description:** 규칙 severity 설정, ignore 패턴. 프로젝트 특성에 맞게 가드를 커스터마이징합니다.
-
-## 5. CI Integration (guard-ci)
-
-**Impact:** MEDIUM
-**Description:** --ci 플래그, exit code, 리포트 생성. 자동화된 아키텍처 검증 파이프라인입니다.
-
-## 6. Auto Fix (guard-fix)
-
-**Impact:** LOW
-**Description:** --auto-correct 옵션. 일부 위반의 자동 수정 기능입니다.
+# Sections
+
+This file defines all sections, their ordering, impact levels, and descriptions.
+The section ID (in parentheses) is the filename prefix used to group rules.
+
+---
+
+## 1. Layer Rules (guard-layer)
+
+**Impact:** CRITICAL
+**Description:** 레이어 의존성 방향 규칙. 상위→하위만 허용, 역방향 import 금지. 아키텍처 무결성의 핵심입니다.
+
+## 2. Presets (guard-preset)
+
+**Impact:** HIGH
+**Description:** mandu, fsd, clean, hexagonal 프리셋 선택. 프로젝트 유형에 맞는 아키텍처 템플릿입니다.
+
+## 3. Validation (guard-validate)
+
+**Impact:** HIGH
+**Description:** import 경로, 파일 위치, 네이밍 검증. 실시간 위반 감지와 리포팅입니다.
+
+## 4. Configuration (guard-config)
+
+**Impact:** MEDIUM
+**Description:** 규칙 severity 설정, ignore 패턴. 프로젝트 특성에 맞게 가드를 커스터마이징합니다.
+
+## 5. CI Integration (guard-ci)
+
+**Impact:** MEDIUM
+**Description:** --ci 플래그, exit code, 리포트 생성. 자동화된 아키텍처 검증 파이프라인입니다.
+
+## 6. Auto Fix (guard-fix)
+
+**Impact:** LOW
+**Description:** --auto-correct 옵션. 일부 위반의 자동 수정 기능입니다.

package/src/resources/skills/mandu-guard/rules/_template.md

@@ -1,82 +1,82 @@
-# Rule Template
-
-Use this template when creating new rules for mandu-guard.
-
----
-
-```markdown
----
-title: Rule Title Here
-impact: CRITICAL | HIGH | MEDIUM | LOW
-impactDescription: 영향 설명
-tags: guard, tag1, tag2
----
-
-## Rule Title Here
-
-**Impact: {LEVEL} ({impactDescription})**
-
-규칙의 목적과 중요성을 설명합니다.
-
-**Incorrect (위반 예시):**
-
-\`\`\`typescript
-// ❌ entities → features (역방향 의존)
-// src/entities/user/index.ts
-import { useAuth } from "@/features/auth";  // VIOLATION!
-
-export function User() {
-  const { isLoggedIn } = useAuth();
-}
-\`\`\`
-
-**Correct (올바른 방향):**
-
-\`\`\`typescript
-// ✅ features → entities (순방향 의존)
-// src/features/auth/index.ts
-import { User } from "@/entities/user";
-
-export function useAuth() {
-  const user = getCurrentUser();
-  return { user, isLoggedIn: !!user };
-}
-\`\`\`
-
-## CLI Command
-
-\`\`\`bash
-bunx mandu guard arch --ci
-\`\`\`
-
-Reference: [관련 문서 링크](https://example.com)
-```
-
----
-
-## Naming Convention
-
-- 파일명: `{section}-{rule-name}.md`
-- 예시: `guard-layer-direction.md`, `guard-preset-mandu.md`
-
-## Layer Hierarchy Quick Reference
-
-### Frontend (FSD)
-```
-app → pages → widgets → features → entities → shared
-```
-
-### Backend (Clean)
-```
-api → application → domain → infra → core → shared
-```
-
-## Rule IDs Quick Reference
-
-| Rule ID | Description |
-|---------|-------------|
-| `LAYER_VIOLATION` | 레이어 의존성 위반 |
-| `GENERATED_DIRECT_EDIT` | generated 파일 직접 수정 |
-| `WRONG_SLOT_LOCATION` | 잘못된 slot 파일 위치 |
-| `SLOT_NAMING` | slot 파일 이름 규칙 위반 |
-| `FORBIDDEN_IMPORT` | 금지된 import |
+# Rule Template
+
+Use this template when creating new rules for mandu-guard.
+
+---
+
+```markdown
+---
+title: Rule Title Here
+impact: CRITICAL | HIGH | MEDIUM | LOW
+impactDescription: 영향 설명
+tags: guard, tag1, tag2
+---
+
+## Rule Title Here
+
+**Impact: {LEVEL} ({impactDescription})**
+
+규칙의 목적과 중요성을 설명합니다.
+
+**Incorrect (위반 예시):**
+
+\`\`\`typescript
+// ❌ entities → features (역방향 의존)
+// src/entities/user/index.ts
+import { useAuth } from "@/features/auth";  // VIOLATION!
+
+export function User() {
+  const { isLoggedIn } = useAuth();
+}
+\`\`\`
+
+**Correct (올바른 방향):**
+
+\`\`\`typescript
+// ✅ features → entities (순방향 의존)
+// src/features/auth/index.ts
+import { User } from "@/entities/user";
+
+export function useAuth() {
+  const user = getCurrentUser();
+  return { user, isLoggedIn: !!user };
+}
+\`\`\`
+
+## CLI Command
+
+\`\`\`bash
+bunx mandu guard arch --ci
+\`\`\`
+
+Reference: [관련 문서 링크](https://example.com)
+```
+
+---
+
+## Naming Convention
+
+- 파일명: `{section}-{rule-name}.md`
+- 예시: `guard-layer-direction.md`, `guard-preset-mandu.md`
+
+## Layer Hierarchy Quick Reference
+
+### Frontend (FSD)
+```
+app → pages → widgets → features → entities → shared
+```
+
+### Backend (Clean)
+```
+api → application → domain → infra → core → shared
+```
+
+## Rule IDs Quick Reference
+
+| Rule ID | Description |
+|---------|-------------|
+| `LAYER_VIOLATION` | 레이어 의존성 위반 |
+| `GENERATED_DIRECT_EDIT` | generated 파일 직접 수정 |
+| `WRONG_SLOT_LOCATION` | 잘못된 slot 파일 위치 |
+| `SLOT_NAMING` | slot 파일 이름 규칙 위반 |
+| `FORBIDDEN_IMPORT` | 금지된 import |

package/src/resources/skills/mandu-guard/rules/guard-config-rules.md

@@ -1,100 +1,100 @@
----
-title: Configure Rule Severity Levels
-impact: MEDIUM
-impactDescription: Customize guard behavior
-tags: guard, config, rules
----
-
-## Configure Rule Severity Levels
-
-Set severity levels for each guard rule based on your project needs.
-
-## Severity Levels
-
-| Level | Behavior | Use Case |
-|-------|----------|----------|
-| `error` | Fails check, blocks CI | Critical violations |
-| `warn` | Reports issue, continues | Gradual migration |
-| `off` | Ignores rule | Not applicable to project |
-
-## Configuration File
-
-```typescript
-// mandu.config.ts
-
-export default {
-  guard: {
-    preset: "mandu",
-    rules: {
-      // Core rules
-      "LAYER_VIOLATION": "error",      // Always enforce layers
-      "GENERATED_DIRECT_EDIT": "error", // Protect generated files
-
-      // Naming rules
-      "SLOT_NAMING": "warn",           // Warn during migration
-      "WRONG_SLOT_LOCATION": "error",
-
-      // Security rules
-      "FORBIDDEN_IMPORT": "error",     // Block dangerous imports
-    },
-  },
-};
-```
-
-## Available Rules
-
-| Rule ID | Default | Description |
-|---------|---------|-------------|
-| `LAYER_VIOLATION` | error | Layer dependency violation |
-| `GENERATED_DIRECT_EDIT` | error | Direct edit of generated files |
-| `WRONG_SLOT_LOCATION` | error | Slot file in wrong directory |
-| `SLOT_NAMING` | error | Incorrect slot file naming |
-| `FORBIDDEN_IMPORT` | warn | Importing fs, child_process, etc. in browser code |
-| `CIRCULAR_DEPENDENCY` | warn | Circular import detected |
-| `DEEP_IMPORT` | warn | Importing from nested paths instead of index |
-
-## Ignoring Paths
-
-```typescript
-export default {
-  guard: {
-    ignore: [
-      "**/test/**",       // Test files
-      "**/*.test.ts",     // Test files
-      "**/*.spec.ts",     // Spec files
-      "**/mocks/**",      // Mock files
-      "scripts/**",       // Build scripts
-    ],
-  },
-};
-```
-
-## Per-File Override
-
-```typescript
-// src/features/legacy/index.ts
-
-// @guard-disable LAYER_VIOLATION
-import { oldHelper } from "@/entities/legacy";  // Allowed temporarily
-// @guard-enable LAYER_VIOLATION
-```
-
-## Gradual Migration
-
-```typescript
-// Start with warnings for legacy code
-{
-  rules: {
-    "LAYER_VIOLATION": "warn",  // Start with warn
-    "SLOT_NAMING": "off",       // Fix later
-  }
-}
-
-// After migration, enforce strictly
-{
-  rules: {
-    "LAYER_VIOLATION": "error", // Now enforce
-    "SLOT_NAMING": "error",     // Now enforce
-  }
-}
-```
+---
+title: Configure Rule Severity Levels
+impact: MEDIUM
+impactDescription: Customize guard behavior
+tags: guard, config, rules
+---
+
+## Configure Rule Severity Levels
+
+Set severity levels for each guard rule based on your project needs.
+
+## Severity Levels
+
+| Level | Behavior | Use Case |
+|-------|----------|----------|
+| `error` | Fails check, blocks CI | Critical violations |
+| `warn` | Reports issue, continues | Gradual migration |
+| `off` | Ignores rule | Not applicable to project |
+
+## Configuration File
+
+```typescript
+// mandu.config.ts
+
+export default {
+  guard: {
+    preset: "mandu",
+    rules: {
+      // Core rules
+      "LAYER_VIOLATION": "error",      // Always enforce layers
+      "GENERATED_DIRECT_EDIT": "error", // Protect generated files
+
+      // Naming rules
+      "SLOT_NAMING": "warn",           // Warn during migration
+      "WRONG_SLOT_LOCATION": "error",
+
+      // Security rules
+      "FORBIDDEN_IMPORT": "error",     // Block dangerous imports
+    },
+  },
+};
+```
+
+## Available Rules
+
+| Rule ID | Default | Description |
+|---------|---------|-------------|
+| `LAYER_VIOLATION` | error | Layer dependency violation |
+| `GENERATED_DIRECT_EDIT` | error | Direct edit of generated files |
+| `WRONG_SLOT_LOCATION` | error | Slot file in wrong directory |
+| `SLOT_NAMING` | error | Incorrect slot file naming |
+| `FORBIDDEN_IMPORT` | warn | Importing fs, child_process, etc. in browser code |
+| `CIRCULAR_DEPENDENCY` | warn | Circular import detected |
+| `DEEP_IMPORT` | warn | Importing from nested paths instead of index |
+
+## Ignoring Paths
+
+```typescript
+export default {
+  guard: {
+    ignore: [
+      "**/test/**",       // Test files
+      "**/*.test.ts",     // Test files
+      "**/*.spec.ts",     // Spec files
+      "**/mocks/**",      // Mock files
+      "scripts/**",       // Build scripts
+    ],
+  },
+};
+```
+
+## Per-File Override
+
+```typescript
+// src/features/legacy/index.ts
+
+// @guard-disable LAYER_VIOLATION
+import { oldHelper } from "@/entities/legacy";  // Allowed temporarily
+// @guard-enable LAYER_VIOLATION
+```
+
+## Gradual Migration
+
+```typescript
+// Start with warnings for legacy code
+{
+  rules: {
+    "LAYER_VIOLATION": "warn",  // Start with warn
+    "SLOT_NAMING": "off",       // Fix later
+  }
+}
+
+// After migration, enforce strictly
+{
+  rules: {
+    "LAYER_VIOLATION": "error", // Now enforce
+    "SLOT_NAMING": "error",     // Now enforce
+  }
+}
+```

package/src/resources/skills/mandu-guard/rules/guard-layer-direction.md

@@ -1,76 +1,76 @@
----
-title: Dependencies Must Flow Downward Only
-impact: CRITICAL
-impactDescription: Core architecture principle
-tags: guard, layer, dependency
----
-
-## Dependencies Must Flow Downward Only
-
-In layered architecture, imports must always flow from higher to lower layers.
-
-**Incorrect (upward dependency):**
-
-```typescript
-// ❌ entities/user/index.ts importing from features (higher layer)
-import { useAuth } from "@/features/auth";
-
-export function User() {
-  const { isLoggedIn } = useAuth();  // VIOLATION!
-  // ...
-}
-```
-
-**Correct (downward dependency):**
-
-```typescript
-// ✅ features/auth/index.ts importing from entities (lower layer)
-import { User } from "@/entities/user";
-
-export function useAuth() {
-  const user = getCurrentUser();  // Uses entity
-  return { user, isLoggedIn: !!user };
-}
-```
-
-## Layer Hierarchy (Mandu Preset)
-
-### Frontend Layers (top to bottom)
-
-```
-app         → Can import: pages, widgets, features, entities, shared
-pages       → Can import: widgets, features, entities, shared
-widgets     → Can import: features, entities, shared
-features    → Can import: entities, shared
-entities    → Can import: shared
-shared      → Can import: (nothing above)
-```
-
-### Backend Layers (top to bottom)
-
-```
-api         → Can import: application, domain, infra, core, shared
-application → Can import: domain, infra, core, shared
-domain      → Can import: core, shared
-infra       → Can import: core, shared
-core        → Can import: shared
-shared      → Can import: (nothing above)
-```
-
-## Common Violations
-
-| Violation | Fix |
-|-----------|-----|
-| Entity imports Feature | Move shared logic to Entity or Shared |
-| Domain imports API | Use dependency injection |
-| Shared imports Feature | Extract to Shared or keep in Feature |
-
-## Checking Dependencies
-
-```bash
-# Check all architecture rules
-bunx mandu guard arch
-
-# Check specific file
-bunx mandu guard check src/entities/user/index.ts
-```
+---
+title: Dependencies Must Flow Downward Only
+impact: CRITICAL
+impactDescription: Core architecture principle
+tags: guard, layer, dependency
+---
+
+## Dependencies Must Flow Downward Only
+
+In layered architecture, imports must always flow from higher to lower layers.
+
+**Incorrect (upward dependency):**
+
+```typescript
+// ❌ entities/user/index.ts importing from features (higher layer)
+import { useAuth } from "@/features/auth";
+
+export function User() {
+  const { isLoggedIn } = useAuth();  // VIOLATION!
+  // ...
+}
+```
+
+**Correct (downward dependency):**
+
+```typescript
+// ✅ features/auth/index.ts importing from entities (lower layer)
+import { User } from "@/entities/user";
+
+export function useAuth() {
+  const user = getCurrentUser();  // Uses entity
+  return { user, isLoggedIn: !!user };
+}
+```
+
+## Layer Hierarchy (Mandu Preset)
+
+### Frontend Layers (top to bottom)
+
+```
+app         → Can import: pages, widgets, features, entities, shared
+pages       → Can import: widgets, features, entities, shared
+widgets     → Can import: features, entities, shared
+features    → Can import: entities, shared
+entities    → Can import: shared
+shared      → Can import: (nothing above)
+```
+
+### Backend Layers (top to bottom)
+
+```
+api         → Can import: application, domain, infra, core, shared
+application → Can import: domain, infra, core, shared
+domain      → Can import: core, shared
+infra       → Can import: core, shared
+core        → Can import: shared
+shared      → Can import: (nothing above)
+```
+
+## Common Violations
+
+| Violation | Fix |
+|-----------|-----|
+| Entity imports Feature | Move shared logic to Entity or Shared |
+| Domain imports API | Use dependency injection |
+| Shared imports Feature | Extract to Shared or keep in Feature |
+
+## Checking Dependencies
+
+```bash
+# Check all architecture rules
+bunx mandu guard arch
+
+# Check specific file
+bunx mandu guard check src/entities/user/index.ts
+```