@mandujs/mcp 0.38.12 → 0.39.0-beta.1

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

@@ -1,152 +0,0 @@
----
-title: Deploy to Fly.io
-impact: MEDIUM
-impactDescription: Edge deployment for global performance
-tags: deployment, fly, edge, platform
----
-
-## Deploy to Fly.io
-
-**Impact: MEDIUM (Edge deployment for global performance)**
-
-Fly.io를 사용하여 전 세계 엣지에서 Mandu 앱을 실행하세요.
-
-**fly.toml 설정:**
-
-```toml
-app = "mandu-app"
-primary_region = "nrt"  # Tokyo
-
-[build]
-  dockerfile = "Dockerfile"
-
-[env]
-  NODE_ENV = "production"
-  BUN_ENV = "production"
-
-[http_service]
-  internal_port = 3000
-  force_https = true
-  auto_stop_machines = true
-  auto_start_machines = true
-  min_machines_running = 1
-
-  [http_service.concurrency]
-    type = "requests"
-    hard_limit = 250
-    soft_limit = 200
-
-[[vm]]
-  cpu_kind = "shared"
-  cpus = 1
-  memory_mb = 512
-```
-
-**Dockerfile:**
-
-```dockerfile
-FROM oven/bun:1.0-slim as builder
-
-WORKDIR /app
-COPY package.json bun.lockb ./
-RUN bun install --frozen-lockfile
-
-COPY . .
-RUN bun run build
-
-# Production image
-FROM oven/bun:1.0-slim
-
-WORKDIR /app
-COPY --from=builder /app/dist ./dist
-COPY --from=builder /app/node_modules ./node_modules
-COPY package.json ./
-
-EXPOSE 3000
-USER bun
-
-CMD ["bun", "run", "start"]
-```
-
-## 배포 명령어
-
-```bash
-# Fly CLI 설치
-curl -L https://fly.io/install.sh | sh
-
-# 로그인
-fly auth login
-
-# 앱 생성
-fly launch --name mandu-app --region nrt
-
-# 배포
-fly deploy
-
-# 스케일링
-fly scale count 2 --region nrt,sin
-
-# 로그 확인
-fly logs
-```
-
-## 멀티 리전 배포
-
-```toml
-# fly.toml
-app = "mandu-app"
-primary_region = "nrt"
-
-# 여러 리전에 배포
-[processes]
-  app = "bun run start"
-
-[[vm]]
-  cpu_kind = "shared"
-  cpus = 1
-  memory_mb = 512
-
-# 리전별 스케일링
-# fly scale count app=2 --region nrt
-# fly scale count app=1 --region sin
-```
-
-## Secrets 관리
-
-```bash
-# Secret 설정
-fly secrets set DATABASE_URL="postgresql://..."
-fly secrets set SESSION_SECRET="..."
-
-# Secret 목록
-fly secrets list
-
-# Secret 삭제
-fly secrets unset OLD_SECRET
-```
-
-## 볼륨 (Persistent Storage)
-
-```bash
-# 볼륨 생성
-fly volumes create mandu_data --region nrt --size 1
-
-# fly.toml에 마운트
-[mounts]
-  source = "mandu_data"
-  destination = "/data"
-```
-
-## 헬스체크
-
-```toml
-# fly.toml
-[[services.http_checks]]
-  interval = "10s"
-  timeout = "2s"
-  grace_period = "5s"
-  method = "GET"
-  path = "/health"
-```
-
-Reference: [Fly.io Documentation](https://fly.io/docs/)

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

@@ -1,179 +0,0 @@
----
-title: Deploy to Render
-impact: HIGH
-impactDescription: Managed platform for production workloads
-tags: deployment, render, platform, hosting
----
-
-## Deploy to Render
-
-**Impact: HIGH (Managed platform for production workloads)**
-
-Render를 사용하여 Mandu 앱을 배포하세요. 자동 HTTPS, 스케일링, 무중단 배포를 지원합니다.
-
-**render.yaml (Blueprint):**
-
-```yaml
-services:
-  - type: web
-    name: mandu-app
-    runtime: node
-    region: singapore  # 또는 oregon, frankfurt 등
-    plan: starter      # starter, standard, pro
-
-    buildCommand: |
-      curl -fsSL https://bun.sh/install | bash
-      export PATH="$HOME/.bun/bin:$PATH"
-      bun install --frozen-lockfile
-      bun run build
-
-    startCommand: |
-      export PATH="$HOME/.bun/bin:$PATH"
-      bun run start
-
-    healthCheckPath: /health
-
-    envVars:
-      - key: NODE_ENV
-        value: production
-      - key: BUN_ENV
-        value: production
-      - key: DATABASE_URL
-        fromDatabase:
-          name: mandu-db
-          property: connectionString
-      - key: SESSION_SECRET
-        generateValue: true
-
-databases:
-  - name: mandu-db
-    plan: starter
-    databaseName: mandu
-    user: mandu
-```
-
-## 헬스체크 엔드포인트
-
-```typescript
-// app/health/slot.ts
-import { Mandu } from "@mandujs/core";
-
-export default Mandu.filling({
-  get: async (ctx) => {
-    // 데이터베이스 연결 확인
-    try {
-      await db.query("SELECT 1");
-      return ctx.ok({ status: "healthy", timestamp: new Date().toISOString() });
-    } catch (error) {
-      return ctx.fail("Database connection failed");
-    }
-  },
-});
-```
-
-## Render Native Runtime (Bun 직접 지원)
-
-```yaml
-# render.yaml - Bun 네이티브 (Beta)
-services:
-  - type: web
-    name: mandu-app
-    runtime: docker
-    dockerfilePath: ./Dockerfile
-
-    envVars:
-      - key: NODE_ENV
-        value: production
-```
-
-```dockerfile
-# Dockerfile
-FROM oven/bun:1.0-slim
-
-WORKDIR /app
-
-COPY package.json bun.lockb ./
-RUN bun install --frozen-lockfile --production
-
-COPY . .
-RUN bun run build
-
-EXPOSE 3000
-USER bun
-
-CMD ["bun", "run", "start"]
-```
-
-## 환경별 배포
-
-```yaml
-# render.yaml - Preview Environments
-previewsEnabled: true
-previewsExpireAfterDays: 7
-
-services:
-  - type: web
-    name: mandu-app
-    # ... 기본 설정
-
-    envVars:
-      - key: NODE_ENV
-        value: production
-      - key: API_URL
-        fromGroup: mandu-production  # Production
-
-    previews:
-      generation: automatic
-      envVars:
-        - key: API_URL
-          fromGroup: mandu-staging   # Preview는 staging 사용
-```
-
-## 자동 배포 설정
-
-```yaml
-# GitHub 연동 시 자동 배포
-# render.yaml
-services:
-  - type: web
-    name: mandu-app
-    repo: https://github.com/your-org/mandu-app
-    branch: main                    # main 브랜치 자동 배포
-    autoDeploy: true               # push 시 자동 배포
-```
-
-## 스케일링 설정
-
-```yaml
-services:
-  - type: web
-    name: mandu-app
-    plan: standard
-
-    scaling:
-      minInstances: 1
-      maxInstances: 5
-      targetMemoryPercent: 80
-      targetCPUPercent: 70
-```
-
-## Render CLI
-
-```bash
-# CLI 설치
-npm install -g @render/cli
-
-# 로그인
-render login
-
-# 서비스 목록
-render services list
-
-# 수동 배포
-render deploys create --service-id srv-xxx
-
-# 로그 확인
-render logs --service-id srv-xxx --tail
-```
-
-Reference: [Render Documentation](https://render.com/docs)

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

@@ -1,140 +0,0 @@
----
-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,122 +0,0 @@
----
-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이 됩니다.
-
-## Agent Workflow Contract
-
-This skill is a Domain addendum. It must not replace `mandu-agent-workflow`.
-Use it only after `mandu.agent.plan` selects the route or API domain.
-
-Canonical workflow step: `plan -> apply -> verify`.
-
-Preferred MCP tools:
-
-| Step | Tools |
-|------|-------|
-| plan | `mandu.agent.plan`, `mandu.route.list` |
-| apply | `mandu.agent.apply`, `mandu.generate`, `mandu.route.add` |
-| verify | `mandu.agent.verify`, `mandu.manifest.validate` |
-| repair | `mandu.agent.repair` |
-
-Allowed file edits:
-
-- `app/**/page.tsx`, `app/**/layout.tsx`, `app/**/route.ts`
-- Route-local metadata files and co-located helpers
-- Related contract/slot files only when the plan includes those domains
-
-Verification command:
-
-```bash
-mandu agent verify --changed --json --write
-```
-
-Common failures:
-
-- Creating a page or API route before reading the local `app/` pattern
-- Editing generated route manifests by hand
-- Adding API files without contract verification when the plan includes API work
-
-Repair path:
-
-```bash
-mandu agent repair --from .mandu/agent-verify.json --json
-```
-
-## 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 +0,0 @@
-{
-  "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 +0,0 @@
-# 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 +0,0 @@
-# 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` |