@mandujs/mcp 0.12.2 → 0.13.0

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

@@ -1,152 +1,152 @@
----
-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/)
+---
+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 +1,179 @@
----
-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)
+---
+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)