@mandujs/mcp 0.13.0 → 0.16.0

package/src/resources/skills/mandu-fs-routes/rules/routes-api-methods.md

@@ -1,65 +1,65 @@
----
-title: Export HTTP Method Functions for API Routes
-impact: HIGH
-impactDescription: RESTful API structure
-tags: routes, api, methods
----
-
-## Export HTTP Method Functions for API Routes
-
-API routes use named exports for each HTTP method: GET, POST, PUT, PATCH, DELETE.
-
-**Incorrect (default export handler):**
-
-```typescript
-// app/api/users/route.ts
-export default function handler(req: Request) {
-  if (req.method === "GET") {
-    return Response.json({ users: [] });
-  }
-}
-```
-
-**Correct (named method exports):**
-
-```typescript
-// app/api/users/route.ts
-
-export function GET() {
-  return Response.json({ users: [] });
-}
-
-export async function POST(request: Request) {
-  const body = await request.json();
-  return Response.json({ created: body }, { status: 201 });
-}
-
-export function DELETE() {
-  return new Response(null, { status: 204 });
-}
-```
-
-## Supported Methods
-
-```typescript
-export function GET(request: Request) { }
-export function POST(request: Request) { }
-export function PUT(request: Request) { }
-export function PATCH(request: Request) { }
-export function DELETE(request: Request) { }
-export function HEAD(request: Request) { }
-export function OPTIONS(request: Request) { }
-```
-
-## With Dynamic Parameters
-
-```typescript
-// app/api/users/[id]/route.ts
-
-export function GET(
-  request: Request,
-  { params }: { params: { id: string } }
-) {
-  return Response.json({ userId: params.id });
-}
-```
+---
+title: Export HTTP Method Functions for API Routes
+impact: HIGH
+impactDescription: RESTful API structure
+tags: routes, api, methods
+---
+
+## Export HTTP Method Functions for API Routes
+
+API routes use named exports for each HTTP method: GET, POST, PUT, PATCH, DELETE.
+
+**Incorrect (default export handler):**
+
+```typescript
+// app/api/users/route.ts
+export default function handler(req: Request) {
+  if (req.method === "GET") {
+    return Response.json({ users: [] });
+  }
+}
+```
+
+**Correct (named method exports):**
+
+```typescript
+// app/api/users/route.ts
+
+export function GET() {
+  return Response.json({ users: [] });
+}
+
+export async function POST(request: Request) {
+  const body = await request.json();
+  return Response.json({ created: body }, { status: 201 });
+}
+
+export function DELETE() {
+  return new Response(null, { status: 204 });
+}
+```
+
+## Supported Methods
+
+```typescript
+export function GET(request: Request) { }
+export function POST(request: Request) { }
+export function PUT(request: Request) { }
+export function PATCH(request: Request) { }
+export function DELETE(request: Request) { }
+export function HEAD(request: Request) { }
+export function OPTIONS(request: Request) { }
+```
+
+## With Dynamic Parameters
+
+```typescript
+// app/api/users/[id]/route.ts
+
+export function GET(
+  request: Request,
+  { params }: { params: { id: string } }
+) {
+  return Response.json({ userId: params.id });
+}
+```

package/src/resources/skills/mandu-fs-routes/rules/routes-dynamic-param.md

@@ -1,93 +1,93 @@
----
-title: Use [param] for Dynamic Route Parameters
-impact: MEDIUM
-impactDescription: Enables dynamic URLs
-tags: routes, dynamic, params
----
-
-## Use [param] for Dynamic Route Parameters
-
-Wrap folder name in brackets to create dynamic routes that capture URL segments.
-
-**Incorrect (hardcoded routes):**
-
-```
-app/users/
-├── user1/page.tsx
-├── user2/page.tsx
-└── user3/page.tsx
-```
-
-**Correct (dynamic parameter):**
-
-```
-app/users/
-└── [id]/
-    └── page.tsx    → /users/:id
-```
-
-## Accessing Parameters
-
-### In Page Components
-
-```tsx
-// app/users/[id]/page.tsx
-
-interface Props {
-  params: { id: string };
-}
-
-export default function UserPage({ params }: Props) {
-  return <h1>User ID: {params.id}</h1>;
-}
-```
-
-### In API Routes
-
-```typescript
-// app/api/users/[id]/route.ts
-
-export function GET(
-  request: Request,
-  { params }: { params: { id: string } }
-) {
-  return Response.json({ userId: params.id });
-}
-```
-
-## Multiple Parameters
-
-```
-app/posts/[postId]/comments/[commentId]/page.tsx
-→ /posts/:postId/comments/:commentId
-```
-
-```tsx
-interface Props {
-  params: { postId: string; commentId: string };
-}
-
-export default function CommentPage({ params }: Props) {
-  return (
-    <div>
-      Post: {params.postId}, Comment: {params.commentId}
-    </div>
-  );
-}
-```
-
-## Catch-All Routes
-
-```
-app/docs/[...slug]/page.tsx → /docs/a, /docs/a/b, /docs/a/b/c
-```
-
-```tsx
-interface Props {
-  params: { slug: string[] };
-}
-
-export default function DocsPage({ params }: Props) {
-  return <p>Path: {params.slug.join("/")}</p>;
-}
-```
+---
+title: Use [param] for Dynamic Route Parameters
+impact: MEDIUM
+impactDescription: Enables dynamic URLs
+tags: routes, dynamic, params
+---
+
+## Use [param] for Dynamic Route Parameters
+
+Wrap folder name in brackets to create dynamic routes that capture URL segments.
+
+**Incorrect (hardcoded routes):**
+
+```
+app/users/
+├── user1/page.tsx
+├── user2/page.tsx
+└── user3/page.tsx
+```
+
+**Correct (dynamic parameter):**
+
+```
+app/users/
+└── [id]/
+    └── page.tsx    → /users/:id
+```
+
+## Accessing Parameters
+
+### In Page Components
+
+```tsx
+// app/users/[id]/page.tsx
+
+interface Props {
+  params: { id: string };
+}
+
+export default function UserPage({ params }: Props) {
+  return <h1>User ID: {params.id}</h1>;
+}
+```
+
+### In API Routes
+
+```typescript
+// app/api/users/[id]/route.ts
+
+export function GET(
+  request: Request,
+  { params }: { params: { id: string } }
+) {
+  return Response.json({ userId: params.id });
+}
+```
+
+## Multiple Parameters
+
+```
+app/posts/[postId]/comments/[commentId]/page.tsx
+→ /posts/:postId/comments/:commentId
+```
+
+```tsx
+interface Props {
+  params: { postId: string; commentId: string };
+}
+
+export default function CommentPage({ params }: Props) {
+  return (
+    <div>
+      Post: {params.postId}, Comment: {params.commentId}
+    </div>
+  );
+}
+```
+
+## Catch-All Routes
+
+```
+app/docs/[...slug]/page.tsx → /docs/a, /docs/a/b, /docs/a/b/c
+```
+
+```tsx
+interface Props {
+  params: { slug: string[] };
+}
+
+export default function DocsPage({ params }: Props) {
+  return <p>Path: {params.slug.join("/")}</p>;
+}
+```

package/src/resources/skills/mandu-fs-routes/rules/routes-naming-page.md

@@ -1,55 +1,55 @@
----
-title: Use page.tsx for Page Components
-impact: CRITICAL
-impactDescription: Required for routing to work
-tags: routes, page, naming
----
-
-## Use page.tsx for Page Components
-
-Page components must be named `page.tsx`. This is how Mandu recognizes
-which files should become routes.
-
-**Incorrect (wrong filename):**
-
-```
-app/
-├── about/
-│   └── About.tsx      ❌ Won't be recognized
-└── users/
-    └── index.tsx      ❌ Won't be recognized
-```
-
-**Correct (page.tsx):**
-
-```
-app/
-├── about/
-│   └── page.tsx       ✅ → /about
-└── users/
-    └── page.tsx       ✅ → /users
-```
-
-## Page Component Structure
-
-```tsx
-// app/about/page.tsx
-
-export default function AboutPage() {
-  return (
-    <div>
-      <h1>About Us</h1>
-    </div>
-  );
-}
-```
-
-## Special Files
-
-| File | Purpose |
-|------|---------|
-| `page.tsx` | Page component |
-| `layout.tsx` | Shared layout |
-| `loading.tsx` | Loading UI |
-| `error.tsx` | Error boundary |
-| `route.ts` | API handler |
+---
+title: Use page.tsx for Page Components
+impact: CRITICAL
+impactDescription: Required for routing to work
+tags: routes, page, naming
+---
+
+## Use page.tsx for Page Components
+
+Page components must be named `page.tsx`. This is how Mandu recognizes
+which files should become routes.
+
+**Incorrect (wrong filename):**
+
+```
+app/
+├── about/
+│   └── About.tsx      ❌ Won't be recognized
+└── users/
+    └── index.tsx      ❌ Won't be recognized
+```
+
+**Correct (page.tsx):**
+
+```
+app/
+├── about/
+│   └── page.tsx       ✅ → /about
+└── users/
+    └── page.tsx       ✅ → /users
+```
+
+## Page Component Structure
+
+```tsx
+// app/about/page.tsx
+
+export default function AboutPage() {
+  return (
+    <div>
+      <h1>About Us</h1>
+    </div>
+  );
+}
+```
+
+## Special Files
+
+| File | Purpose |
+|------|---------|
+| `page.tsx` | Page component |
+| `layout.tsx` | Shared layout |
+| `loading.tsx` | Loading UI |
+| `error.tsx` | Error boundary |
+| `route.ts` | API handler |

package/src/resources/skills/mandu-guard/SKILL.md

@@ -1,129 +1,129 @@
----
-name: mandu-guard
-description: |
-  Architecture guard system for Mandu. Use when checking layer dependencies,
-  enforcing architecture rules, or validating file locations. Triggers on
-  tasks involving architecture, layers, dependencies, or guard commands.
-license: MIT
-metadata:
-  author: mandu
-  version: "1.0.0"
----
-
-# Mandu Guard
-
-Mandu Guard는 아키텍처 규칙을 강제하는 시스템입니다.
-레이어 간 의존성을 검사하고 위반을 실시간으로 감지합니다.
-
-## When to Apply
-
-Reference these guidelines when:
-- Setting up architecture rules
-- Checking layer dependencies
-- Validating import paths
-- Running architecture checks in CI
-- Configuring guard presets
-
-## Rule Categories by Priority
-
-| Priority | Category | Impact | Prefix |
-|----------|----------|--------|--------|
-| 1 | Layer Rules | CRITICAL | `guard-layer-` |
-| 2 | Presets | HIGH | `guard-preset-` |
-| 3 | Validation | HIGH | `guard-validate-` |
-| 4 | Configuration | MEDIUM | `guard-config-` |
-
-## Quick Reference
-
-### 1. Layer Rules (CRITICAL)
-
-- `guard-layer-direction` - Dependencies flow downward only
-- `guard-layer-violation` - Detect and fix layer violations
-- `guard-layer-same-level` - Restrict same-layer imports
-
-### 2. Presets (HIGH)
-
-- `guard-preset-mandu` - FSD + Clean hybrid (default)
-- `guard-preset-fsd` - Feature-Sliced Design
-- `guard-preset-clean` - Clean Architecture
-- `guard-preset-hexagonal` - Hexagonal/Ports & Adapters
-
-### 3. Validation (HIGH)
-
-- `guard-validate-import` - Check import path validity
-- `guard-validate-location` - Check file location
-- `guard-validate-naming` - Check naming conventions
-
-### 4. Configuration (MEDIUM)
-
-- `guard-config-rules` - Configure rule severity
-- `guard-config-ignore` - Configure ignored paths
-
-## Mandu Preset Layers
-
-### Frontend (FSD)
-
-```
-app          # Top: app entry point
-  ↓
-pages        # Page components
-  ↓
-widgets      # Complex UI blocks
-  ↓
-features     # Feature units
-  ↓
-entities     # Business entities
-  ↓
-shared       # Shared utilities
-```
-
-### Backend (Clean)
-
-```
-api          # Top: API entry point
-  ↓
-application  # Use cases
-  ↓
-domain       # Business logic
-  ↓
-infra        # Infrastructure (DB, external APIs)
-  ↓
-core         # Core utilities
-  ↓
-shared       # Shared
-```
-
-## Validation Rules
-
-| Rule ID | Description |
-|---------|-------------|
-| `LAYER_VIOLATION` | Layer dependency violation |
-| `GENERATED_DIRECT_EDIT` | Direct edit of generated files |
-| `WRONG_SLOT_LOCATION` | Wrong slot file location |
-| `SLOT_NAMING` | Slot file naming rule violation |
-| `FORBIDDEN_IMPORT` | Forbidden import (fs, child_process, etc.) |
-
-## CLI Commands
-
-```bash
-# Architecture check
-bunx mandu guard arch
-
-# Watch mode
-bunx mandu guard arch --watch
-
-# CI mode (exit 1 on violation)
-bunx mandu guard arch --ci
-
-# Use specific preset
-bunx mandu guard arch --preset fsd
-```
-
-## How to Use
-
-Read individual rule files for detailed explanations:
-
-```
-rules/guard-layer-direction.md
-rules/guard-preset-mandu.md
-```
+---
+name: mandu-guard
+description: |
+  Architecture guard system for Mandu. Use when checking layer dependencies,
+  enforcing architecture rules, or validating file locations. Triggers on
+  tasks involving architecture, layers, dependencies, or guard commands.
+license: MIT
+metadata:
+  author: mandu
+  version: "1.0.0"
+---
+
+# Mandu Guard
+
+Mandu Guard는 아키텍처 규칙을 강제하는 시스템입니다.
+레이어 간 의존성을 검사하고 위반을 실시간으로 감지합니다.
+
+## When to Apply
+
+Reference these guidelines when:
+- Setting up architecture rules
+- Checking layer dependencies
+- Validating import paths
+- Running architecture checks in CI
+- Configuring guard presets
+
+## Rule Categories by Priority
+
+| Priority | Category | Impact | Prefix |
+|----------|----------|--------|--------|
+| 1 | Layer Rules | CRITICAL | `guard-layer-` |
+| 2 | Presets | HIGH | `guard-preset-` |
+| 3 | Validation | HIGH | `guard-validate-` |
+| 4 | Configuration | MEDIUM | `guard-config-` |
+
+## Quick Reference
+
+### 1. Layer Rules (CRITICAL)
+
+- `guard-layer-direction` - Dependencies flow downward only
+- `guard-layer-violation` - Detect and fix layer violations
+- `guard-layer-same-level` - Restrict same-layer imports
+
+### 2. Presets (HIGH)
+
+- `guard-preset-mandu` - FSD + Clean hybrid (default)
+- `guard-preset-fsd` - Feature-Sliced Design
+- `guard-preset-clean` - Clean Architecture
+- `guard-preset-hexagonal` - Hexagonal/Ports & Adapters
+
+### 3. Validation (HIGH)
+
+- `guard-validate-import` - Check import path validity
+- `guard-validate-location` - Check file location
+- `guard-validate-naming` - Check naming conventions
+
+### 4. Configuration (MEDIUM)
+
+- `guard-config-rules` - Configure rule severity
+- `guard-config-ignore` - Configure ignored paths
+
+## Mandu Preset Layers
+
+### Frontend (FSD)
+
+```
+app          # Top: app entry point
+  ↓
+pages        # Page components
+  ↓
+widgets      # Complex UI blocks
+  ↓
+features     # Feature units
+  ↓
+entities     # Business entities
+  ↓
+shared       # Shared utilities
+```
+
+### Backend (Clean)
+
+```
+api          # Top: API entry point
+  ↓
+application  # Use cases
+  ↓
+domain       # Business logic
+  ↓
+infra        # Infrastructure (DB, external APIs)
+  ↓
+core         # Core utilities
+  ↓
+shared       # Shared
+```
+
+## Validation Rules
+
+| Rule ID | Description |
+|---------|-------------|
+| `LAYER_VIOLATION` | Layer dependency violation |
+| `GENERATED_DIRECT_EDIT` | Direct edit of generated files |
+| `WRONG_SLOT_LOCATION` | Wrong slot file location |
+| `SLOT_NAMING` | Slot file naming rule violation |
+| `FORBIDDEN_IMPORT` | Forbidden import (fs, child_process, etc.) |
+
+## CLI Commands
+
+```bash
+# Architecture check
+bunx mandu guard arch
+
+# Watch mode
+bunx mandu guard arch --watch
+
+# CI mode (exit 1 on violation)
+bunx mandu guard arch --ci
+
+# Use specific preset
+bunx mandu guard arch --preset fsd
+```
+
+## How to Use
+
+Read individual rule files for detailed explanations:
+
+```
+rules/guard-layer-direction.md
+rules/guard-preset-mandu.md
+```