@mandujs/mcp 0.12.2 → 0.13.0

package/src/resources/skills/mandu-deployment/rules/deploy-platform-vercel.md

@@ -1,140 +1,140 @@
----
-title: Deploy to Vercel
-impact: MEDIUM
-impactDescription: Serverless deployment with edge functions
-tags: deployment, vercel, serverless, edge
----
-
-## Deploy to Vercel
-
-**Impact: MEDIUM (Serverless deployment with edge functions)**
-
-Vercel을 사용하여 Mandu 앱을 서버리스로 배포하세요.
-
-**vercel.json 설정:**
-
-```json
-{
-  "buildCommand": "bun run build",
-  "outputDirectory": "dist",
-  "framework": null,
-  "functions": {
-    "api/**/*.ts": {
-      "runtime": "nodejs20.x",
-      "memory": 1024,
-      "maxDuration": 10
-    }
-  },
-  "rewrites": [
-    { "source": "/api/(.*)", "destination": "/api/$1" },
-    { "source": "/(.*)", "destination": "/index.html" }
-  ]
-}
-```
-
-**주의사항:**
-Vercel은 Bun 런타임을 직접 지원하지 않으므로, Node.js 호환 모드로 빌드해야 합니다.
-
-**Node.js 호환 빌드:**
-
-```typescript
-// scripts/build-vercel.ts
-await Bun.build({
-  entrypoints: ["./src/server.ts"],
-  outdir: "./dist",
-  target: "node",  // Node.js 타겟으로 빌드
-  minify: true,
-  external: ["@vercel/node"],
-});
-```
-
-## API Routes 변환
-
-```typescript
-// api/users/index.ts (Vercel Serverless Function)
-import type { VercelRequest, VercelResponse } from "@vercel/node";
-import { createHandler } from "@mandujs/vercel";
-import usersSlot from "../../app/users/slot";
-
-export default createHandler(usersSlot);
-```
-
-**createHandler 구현:**
-
-```typescript
-// lib/vercel.ts
-import type { VercelRequest, VercelResponse } from "@vercel/node";
-
-export function createHandler(slot: Slot) {
-  return async (req: VercelRequest, res: VercelResponse) => {
-    const method = req.method?.toLowerCase() || "get";
-    const handler = slot.handlers[method];
-
-    if (!handler) {
-      return res.status(405).json({ error: "Method not allowed" });
-    }
-
-    const ctx = createContext(req);
-    const result = await handler(ctx);
-
-    return res.status(result.status || 200).json(result.body);
-  };
-}
-```
-
-## Edge Functions
-
-```typescript
-// api/geo.ts
-export const config = {
-  runtime: "edge",
-};
-
-export default async function handler(request: Request) {
-  const geo = request.headers.get("x-vercel-ip-country");
-
-  return new Response(JSON.stringify({ country: geo }), {
-    headers: { "Content-Type": "application/json" },
-  });
-}
-```
-
-## 환경 변수
-
-```bash
-# Vercel CLI로 환경 변수 설정
-vercel env add DATABASE_URL production
-vercel env add SESSION_SECRET production
-
-# .env.local (로컬 개발)
-DATABASE_URL=postgresql://localhost:5432/mandu
-SESSION_SECRET=dev-secret
-```
-
-## 배포
-
-```bash
-# Vercel CLI 설치
-npm install -g vercel
-
-# 프로젝트 연결
-vercel link
-
-# Preview 배포
-vercel
-
-# Production 배포
-vercel --prod
-```
-
-## 추천 사용 케이스
-
-- 정적 사이트 + API routes
-- Edge에서 가벼운 처리가 필요한 경우
-- Vercel의 다른 서비스(Analytics, Speed Insights)와 통합
-
-**비추천:**
-- 장시간 실행 프로세스 (WebSocket, 스트리밍)
-- Bun 특화 기능 필요 시
-
-Reference: [Vercel Documentation](https://vercel.com/docs)
+---
+title: Deploy to Vercel
+impact: MEDIUM
+impactDescription: Serverless deployment with edge functions
+tags: deployment, vercel, serverless, edge
+---
+
+## Deploy to Vercel
+
+**Impact: MEDIUM (Serverless deployment with edge functions)**
+
+Vercel을 사용하여 Mandu 앱을 서버리스로 배포하세요.
+
+**vercel.json 설정:**
+
+```json
+{
+  "buildCommand": "bun run build",
+  "outputDirectory": "dist",
+  "framework": null,
+  "functions": {
+    "api/**/*.ts": {
+      "runtime": "nodejs20.x",
+      "memory": 1024,
+      "maxDuration": 10
+    }
+  },
+  "rewrites": [
+    { "source": "/api/(.*)", "destination": "/api/$1" },
+    { "source": "/(.*)", "destination": "/index.html" }
+  ]
+}
+```
+
+**주의사항:**
+Vercel은 Bun 런타임을 직접 지원하지 않으므로, Node.js 호환 모드로 빌드해야 합니다.
+
+**Node.js 호환 빌드:**
+
+```typescript
+// scripts/build-vercel.ts
+await Bun.build({
+  entrypoints: ["./src/server.ts"],
+  outdir: "./dist",
+  target: "node",  // Node.js 타겟으로 빌드
+  minify: true,
+  external: ["@vercel/node"],
+});
+```
+
+## API Routes 변환
+
+```typescript
+// api/users/index.ts (Vercel Serverless Function)
+import type { VercelRequest, VercelResponse } from "@vercel/node";
+import { createHandler } from "@mandujs/vercel";
+import usersSlot from "../../app/users/slot";
+
+export default createHandler(usersSlot);
+```
+
+**createHandler 구현:**
+
+```typescript
+// lib/vercel.ts
+import type { VercelRequest, VercelResponse } from "@vercel/node";
+
+export function createHandler(slot: Slot) {
+  return async (req: VercelRequest, res: VercelResponse) => {
+    const method = req.method?.toLowerCase() || "get";
+    const handler = slot.handlers[method];
+
+    if (!handler) {
+      return res.status(405).json({ error: "Method not allowed" });
+    }
+
+    const ctx = createContext(req);
+    const result = await handler(ctx);
+
+    return res.status(result.status || 200).json(result.body);
+  };
+}
+```
+
+## Edge Functions
+
+```typescript
+// api/geo.ts
+export const config = {
+  runtime: "edge",
+};
+
+export default async function handler(request: Request) {
+  const geo = request.headers.get("x-vercel-ip-country");
+
+  return new Response(JSON.stringify({ country: geo }), {
+    headers: { "Content-Type": "application/json" },
+  });
+}
+```
+
+## 환경 변수
+
+```bash
+# Vercel CLI로 환경 변수 설정
+vercel env add DATABASE_URL production
+vercel env add SESSION_SECRET production
+
+# .env.local (로컬 개발)
+DATABASE_URL=postgresql://localhost:5432/mandu
+SESSION_SECRET=dev-secret
+```
+
+## 배포
+
+```bash
+# Vercel CLI 설치
+npm install -g vercel
+
+# 프로젝트 연결
+vercel link
+
+# Preview 배포
+vercel
+
+# Production 배포
+vercel --prod
+```
+
+## 추천 사용 케이스
+
+- 정적 사이트 + API routes
+- Edge에서 가벼운 처리가 필요한 경우
+- Vercel의 다른 서비스(Analytics, Speed Insights)와 통합
+
+**비추천:**
+- 장시간 실행 프로세스 (WebSocket, 스트리밍)
+- Bun 특화 기능 필요 시
+
+Reference: [Vercel Documentation](https://vercel.com/docs)

package/src/resources/skills/mandu-fs-routes/SKILL.md

@@ -1,82 +1,82 @@
----
-name: mandu-fs-routes
-description: |
-  File-system based routing for Mandu. Use when creating pages, API routes,
-  layouts, or dynamic routes. Triggers on tasks involving app/ folder,
-  page.tsx, route.ts, layout.tsx, [id], [...slug], or URL patterns.
-license: MIT
-metadata:
-  author: mandu
-  version: "1.0.0"
----
-
-# Mandu FS Routes
-
-FS Routes는 파일 시스템 기반 라우팅입니다. `app/` 폴더의 파일 구조가 URL이 됩니다.
-
-## When to Apply
-
-Reference these guidelines when:
-- Creating new pages or API endpoints
-- Setting up dynamic routes with parameters
-- Implementing shared layouts
-- Organizing route groups
-- Working with catch-all routes
-
-## Rule Categories by Priority
-
-| Priority | Category | Impact | Prefix |
-|----------|----------|--------|--------|
-| 1 | File Naming | CRITICAL | `routes-naming-` |
-| 2 | Page Routes | HIGH | `routes-page-` |
-| 3 | API Routes | HIGH | `routes-api-` |
-| 4 | Dynamic Routes | MEDIUM | `routes-dynamic-` |
-| 5 | Layouts | MEDIUM | `routes-layout-` |
-
-## Quick Reference
-
-### 1. File Naming (CRITICAL)
-
-- `routes-naming-page` - Use page.tsx for page components
-- `routes-naming-route` - Use route.ts for API handlers
-- `routes-naming-layout` - Use layout.tsx for shared layouts
-
-### 2. Page Routes (HIGH)
-
-- `routes-page-component` - Export default function component
-- `routes-page-metadata` - Export metadata object for SEO
-
-### 3. API Routes (HIGH)
-
-- `routes-api-methods` - Export GET, POST, PUT, DELETE functions
-- `routes-api-request` - Access Request object as first parameter
-
-### 4. Dynamic Routes (MEDIUM)
-
-- `routes-dynamic-param` - Use [id] for single parameter
-- `routes-dynamic-catchall` - Use [...slug] for catch-all
-- `routes-dynamic-optional` - Use [[...slug]] for optional catch-all
-
-### 5. Layouts (MEDIUM)
-
-- `routes-layout-wrapper` - Layouts wrap all child pages
-- `routes-layout-nesting` - Layouts can be nested
-
-## URL Mapping
-
-| File Path | URL |
-|-----------|-----|
-| `app/page.tsx` | `/` |
-| `app/about/page.tsx` | `/about` |
-| `app/users/[id]/page.tsx` | `/users/:id` |
-| `app/api/users/route.ts` | `/api/users` |
-| `app/(auth)/login/page.tsx` | `/login` |
-
-## How to Use
-
-Read individual rule files for detailed explanations:
-
-```
-rules/routes-naming-page.md
-rules/routes-dynamic-param.md
-```
+---
+name: mandu-fs-routes
+description: |
+  File-system based routing for Mandu. Use when creating pages, API routes,
+  layouts, or dynamic routes. Triggers on tasks involving app/ folder,
+  page.tsx, route.ts, layout.tsx, [id], [...slug], or URL patterns.
+license: MIT
+metadata:
+  author: mandu
+  version: "1.0.0"
+---
+
+# Mandu FS Routes
+
+FS Routes는 파일 시스템 기반 라우팅입니다. `app/` 폴더의 파일 구조가 URL이 됩니다.
+
+## When to Apply
+
+Reference these guidelines when:
+- Creating new pages or API endpoints
+- Setting up dynamic routes with parameters
+- Implementing shared layouts
+- Organizing route groups
+- Working with catch-all routes
+
+## Rule Categories by Priority
+
+| Priority | Category | Impact | Prefix |
+|----------|----------|--------|--------|
+| 1 | File Naming | CRITICAL | `routes-naming-` |
+| 2 | Page Routes | HIGH | `routes-page-` |
+| 3 | API Routes | HIGH | `routes-api-` |
+| 4 | Dynamic Routes | MEDIUM | `routes-dynamic-` |
+| 5 | Layouts | MEDIUM | `routes-layout-` |
+
+## Quick Reference
+
+### 1. File Naming (CRITICAL)
+
+- `routes-naming-page` - Use page.tsx for page components
+- `routes-naming-route` - Use route.ts for API handlers
+- `routes-naming-layout` - Use layout.tsx for shared layouts
+
+### 2. Page Routes (HIGH)
+
+- `routes-page-component` - Export default function component
+- `routes-page-metadata` - Export metadata object for SEO
+
+### 3. API Routes (HIGH)
+
+- `routes-api-methods` - Export GET, POST, PUT, DELETE functions
+- `routes-api-request` - Access Request object as first parameter
+
+### 4. Dynamic Routes (MEDIUM)
+
+- `routes-dynamic-param` - Use [id] for single parameter
+- `routes-dynamic-catchall` - Use [...slug] for catch-all
+- `routes-dynamic-optional` - Use [[...slug]] for optional catch-all
+
+### 5. Layouts (MEDIUM)
+
+- `routes-layout-wrapper` - Layouts wrap all child pages
+- `routes-layout-nesting` - Layouts can be nested
+
+## URL Mapping
+
+| File Path | URL |
+|-----------|-----|
+| `app/page.tsx` | `/` |
+| `app/about/page.tsx` | `/about` |
+| `app/users/[id]/page.tsx` | `/users/:id` |
+| `app/api/users/route.ts` | `/api/users` |
+| `app/(auth)/login/page.tsx` | `/login` |
+
+## How to Use
+
+Read individual rule files for detailed explanations:
+
+```
+rules/routes-naming-page.md
+rules/routes-dynamic-param.md
+```

package/src/resources/skills/mandu-fs-routes/metadata.json

@@ -1,12 +1,12 @@
-{
-  "version": "1.0.0",
-  "organization": "Mandu Framework",
-  "date": "February 2026",
-  "abstract": "파일 시스템 기반 라우팅 가이드. app/ 폴더 구조가 URL이 되는 규칙, 동적 라우트 [id], catch-all [...slug], 라우트 그룹 (group), 특수 파일 (page.tsx, route.ts, layout.tsx) 사용법을 다룹니다.",
-  "references": [
-    "https://nextjs.org/docs/app/building-your-application/routing",
-    "https://fresh.deno.dev/docs/concepts/routing",
-    "https://kit.svelte.dev/docs/routing"
-  ],
-  "tags": ["routes", "filesystem", "pages", "api", "mandu"]
-}
+{
+  "version": "1.0.0",
+  "organization": "Mandu Framework",
+  "date": "February 2026",
+  "abstract": "파일 시스템 기반 라우팅 가이드. app/ 폴더 구조가 URL이 되는 규칙, 동적 라우트 [id], catch-all [...slug], 라우트 그룹 (group), 특수 파일 (page.tsx, route.ts, layout.tsx) 사용법을 다룹니다.",
+  "references": [
+    "https://nextjs.org/docs/app/building-your-application/routing",
+    "https://fresh.deno.dev/docs/concepts/routing",
+    "https://kit.svelte.dev/docs/routing"
+  ],
+  "tags": ["routes", "filesystem", "pages", "api", "mandu"]
+}

package/src/resources/skills/mandu-fs-routes/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. File Naming (routes-naming)
-
-**Impact:** CRITICAL
-**Description:** page.tsx, route.ts, layout.tsx 등 특수 파일 명명 규칙. 잘못된 파일명은 라우트로 인식되지 않습니다.
-
-## 2. Page Routes (routes-page)
-
-**Impact:** HIGH
-**Description:** page.tsx 컴포넌트 작성법. default export, metadata, props 접근 패턴을 다룹니다.
-
-## 3. API Routes (routes-api)
-
-**Impact:** HIGH
-**Description:** route.ts에서 HTTP 메서드 함수 export. GET, POST, PUT, DELETE 핸들러 작성법입니다.
-
-## 4. Dynamic Routes (routes-dynamic)
-
-**Impact:** MEDIUM
-**Description:** [id], [...slug], [[...slug]] 동적 세그먼트. URL 파라미터 캡처와 접근 방법을 다룹니다.
-
-## 5. Layouts (routes-layout)
-
-**Impact:** MEDIUM
-**Description:** layout.tsx로 페이지 감싸기. 중첩 레이아웃과 공유 UI 패턴입니다.
-
-## 6. Route Groups (routes-group)
-
-**Impact:** LOW
-**Description:** (group) 괄호로 URL에 영향 없이 폴더 구조 정리. 코드 구성에만 사용됩니다.
+# 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. File Naming (routes-naming)
+
+**Impact:** CRITICAL
+**Description:** page.tsx, route.ts, layout.tsx 등 특수 파일 명명 규칙. 잘못된 파일명은 라우트로 인식되지 않습니다.
+
+## 2. Page Routes (routes-page)
+
+**Impact:** HIGH
+**Description:** page.tsx 컴포넌트 작성법. default export, metadata, props 접근 패턴을 다룹니다.
+
+## 3. API Routes (routes-api)
+
+**Impact:** HIGH
+**Description:** route.ts에서 HTTP 메서드 함수 export. GET, POST, PUT, DELETE 핸들러 작성법입니다.
+
+## 4. Dynamic Routes (routes-dynamic)
+
+**Impact:** MEDIUM
+**Description:** [id], [...slug], [[...slug]] 동적 세그먼트. URL 파라미터 캡처와 접근 방법을 다룹니다.
+
+## 5. Layouts (routes-layout)
+
+**Impact:** MEDIUM
+**Description:** layout.tsx로 페이지 감싸기. 중첩 레이아웃과 공유 UI 패턴입니다.
+
+## 6. Route Groups (routes-group)
+
+**Impact:** LOW
+**Description:** (group) 괄호로 URL에 영향 없이 폴더 구조 정리. 코드 구성에만 사용됩니다.

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

@@ -1,69 +1,69 @@
-# Rule Template
-
-Use this template when creating new rules for mandu-fs-routes.
-
----
-
-```markdown
----
-title: Rule Title Here
-impact: CRITICAL | HIGH | MEDIUM | LOW
-impactDescription: 영향 설명
-tags: routes, tag1, tag2
----
-
-## Rule Title Here
-
-**Impact: {LEVEL} ({impactDescription})**
-
-규칙의 목적과 중요성을 설명합니다.
-
-**Incorrect (문제점 설명):**
-
-\`\`\`
-app/
-├── about/
-│   └── About.tsx      ❌ 인식되지 않음
-└── users/
-    └── index.tsx      ❌ 인식되지 않음
-\`\`\`
-
-**Correct (올바른 구조):**
-
-\`\`\`
-app/
-├── about/
-│   └── page.tsx       ✅ → /about
-└── users/
-    └── page.tsx       ✅ → /users
-\`\`\`
-
-## Code Example
-
-\`\`\`tsx
-// app/about/page.tsx
-
-export default function AboutPage() {
-  return <h1>About Us</h1>;
-}
-\`\`\`
-
-Reference: [관련 문서 링크](https://example.com)
-```
-
----
-
-## Naming Convention
-
-- 파일명: `{section}-{rule-name}.md`
-- 예시: `routes-naming-page.md`, `routes-dynamic-param.md`
-
-## URL Mapping Quick Reference
-
-| File Path | URL |
-|-----------|-----|
-| `app/page.tsx` | `/` |
-| `app/about/page.tsx` | `/about` |
-| `app/users/[id]/page.tsx` | `/users/:id` |
-| `app/api/users/route.ts` | `/api/users` |
-| `app/(auth)/login/page.tsx` | `/login` |
+# Rule Template
+
+Use this template when creating new rules for mandu-fs-routes.
+
+---
+
+```markdown
+---
+title: Rule Title Here
+impact: CRITICAL | HIGH | MEDIUM | LOW
+impactDescription: 영향 설명
+tags: routes, tag1, tag2
+---
+
+## Rule Title Here
+
+**Impact: {LEVEL} ({impactDescription})**
+
+규칙의 목적과 중요성을 설명합니다.
+
+**Incorrect (문제점 설명):**
+
+\`\`\`
+app/
+├── about/
+│   └── About.tsx      ❌ 인식되지 않음
+└── users/
+    └── index.tsx      ❌ 인식되지 않음
+\`\`\`
+
+**Correct (올바른 구조):**
+
+\`\`\`
+app/
+├── about/
+│   └── page.tsx       ✅ → /about
+└── users/
+    └── page.tsx       ✅ → /users
+\`\`\`
+
+## Code Example
+
+\`\`\`tsx
+// app/about/page.tsx
+
+export default function AboutPage() {
+  return <h1>About Us</h1>;
+}
+\`\`\`
+
+Reference: [관련 문서 링크](https://example.com)
+```
+
+---
+
+## Naming Convention
+
+- 파일명: `{section}-{rule-name}.md`
+- 예시: `routes-naming-page.md`, `routes-dynamic-param.md`
+
+## URL Mapping Quick Reference
+
+| File Path | URL |
+|-----------|-----|
+| `app/page.tsx` | `/` |
+| `app/about/page.tsx` | `/about` |
+| `app/users/[id]/page.tsx` | `/users/:id` |
+| `app/api/users/route.ts` | `/api/users` |
+| `app/(auth)/login/page.tsx` | `/login` |