@mandujs/mcp 0.12.2 → 0.13.0

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

@@ -1,92 +1,92 @@
----
-name: Mandu Deployment
-description: Production deployment patterns for Mandu applications
-metadata:
-  version: "1.0.0"
-  author: mandu
-globs:
-  - "render.yaml"
-  - "Dockerfile"
-  - "docker-compose.yml"
-  - ".github/workflows/*.yml"
-  - "bunfig.toml"
----
-
-# Mandu Deployment Skill
-
-Mandu 앱을 프로덕션 환경에 안전하고 효율적으로 배포하기 위한 가이드입니다.
-
-## 핵심 원칙
-
-1. **Bun 네이티브**: Bun 런타임과 번들러를 최대한 활용
-2. **환경 분리**: 개발/스테이징/프로덕션 환경 명확히 구분
-3. **자동화**: CI/CD를 통한 일관된 배포 프로세스
-4. **보안 우선**: 민감 정보는 환경 변수로 관리
-
-## 빠른 시작
-
-### Render 배포 (권장)
-
-```yaml
-# render.yaml
-services:
-  - type: web
-    name: mandu-app
-    runtime: node
-    buildCommand: bun install && bun run build
-    startCommand: bun run start
-    envVars:
-      - key: NODE_ENV
-        value: production
-      - key: BUN_ENV
-        value: production
-```
-
-### Docker 배포
-
-```dockerfile
-FROM oven/bun:1.0
-
-WORKDIR /app
-COPY package.json bun.lockb ./
-RUN bun install --frozen-lockfile --production
-
-COPY . .
-RUN bun run build
-
-EXPOSE 3000
-CMD ["bun", "run", "start"]
-```
-
-## 배포 체크리스트
-
-### 빌드 준비
-- [ ] `bun run build` 성공 확인
-- [ ] 번들 크기 최적화 (tree-shaking, code-splitting)
-- [ ] 환경 변수 설정 완료
-
-### 플랫폼 설정
-- [ ] Render/Docker 설정 파일 작성
-- [ ] 헬스체크 엔드포인트 구현
-- [ ] 로깅 설정 완료
-
-### 보안
-- [ ] 민감 정보 환경 변수로 분리
-- [ ] HTTPS 강제 적용
-- [ ] 보안 헤더 설정
-
-### 모니터링
-- [ ] 에러 트래킹 설정
-- [ ] 성능 모니터링 구성
-- [ ] 알림 설정
-
-## 규칙 카테고리
-
-| Category | Description | Rules |
-|----------|-------------|-------|
-| Build | 프로덕션 빌드 최적화 | 2 |
-| Platform | 플랫폼별 배포 설정 | 3 |
-| Container | Docker 컨테이너화 | 2 |
-| CI/CD | 자동화 파이프라인 | 1 |
-
-→ 세부 규칙은 `rules/` 폴더 참조
+---
+name: Mandu Deployment
+description: Production deployment patterns for Mandu applications
+metadata:
+  version: "1.0.0"
+  author: mandu
+globs:
+  - "render.yaml"
+  - "Dockerfile"
+  - "docker-compose.yml"
+  - ".github/workflows/*.yml"
+  - "bunfig.toml"
+---
+
+# Mandu Deployment Skill
+
+Mandu 앱을 프로덕션 환경에 안전하고 효율적으로 배포하기 위한 가이드입니다.
+
+## 핵심 원칙
+
+1. **Bun 네이티브**: Bun 런타임과 번들러를 최대한 활용
+2. **환경 분리**: 개발/스테이징/프로덕션 환경 명확히 구분
+3. **자동화**: CI/CD를 통한 일관된 배포 프로세스
+4. **보안 우선**: 민감 정보는 환경 변수로 관리
+
+## 빠른 시작
+
+### Render 배포 (권장)
+
+```yaml
+# render.yaml
+services:
+  - type: web
+    name: mandu-app
+    runtime: node
+    buildCommand: bun install && bun run build
+    startCommand: bun run start
+    envVars:
+      - key: NODE_ENV
+        value: production
+      - key: BUN_ENV
+        value: production
+```
+
+### Docker 배포
+
+```dockerfile
+FROM oven/bun:1.0
+
+WORKDIR /app
+COPY package.json bun.lockb ./
+RUN bun install --frozen-lockfile --production
+
+COPY . .
+RUN bun run build
+
+EXPOSE 3000
+CMD ["bun", "run", "start"]
+```
+
+## 배포 체크리스트
+
+### 빌드 준비
+- [ ] `bun run build` 성공 확인
+- [ ] 번들 크기 최적화 (tree-shaking, code-splitting)
+- [ ] 환경 변수 설정 완료
+
+### 플랫폼 설정
+- [ ] Render/Docker 설정 파일 작성
+- [ ] 헬스체크 엔드포인트 구현
+- [ ] 로깅 설정 완료
+
+### 보안
+- [ ] 민감 정보 환경 변수로 분리
+- [ ] HTTPS 강제 적용
+- [ ] 보안 헤더 설정
+
+### 모니터링
+- [ ] 에러 트래킹 설정
+- [ ] 성능 모니터링 구성
+- [ ] 알림 설정
+
+## 규칙 카테고리
+
+| Category | Description | Rules |
+|----------|-------------|-------|
+| Build | 프로덕션 빌드 최적화 | 2 |
+| Platform | 플랫폼별 배포 설정 | 3 |
+| Container | Docker 컨테이너화 | 2 |
+| CI/CD | 자동화 파이프라인 | 1 |
+
+→ 세부 규칙은 `rules/` 폴더 참조

package/src/resources/skills/mandu-deployment/_sections.md

@@ -1,41 +1,41 @@
-# Mandu Deployment - Rule Categories
-
-## Build
-프로덕션 빌드 최적화 및 번들링 설정
-
-| Impact | Description |
-|--------|-------------|
-| CRITICAL | 빌드 실패 시 배포 불가 |
-| HIGH | 번들 크기, 빌드 시간에 큰 영향 |
-
-## Platform
-배포 플랫폼별 설정 및 최적화
-
-| Impact | Description |
-|--------|-------------|
-| CRITICAL | 플랫폼 호환성 필수 |
-| HIGH | 성능, 비용에 큰 영향 |
-
-## Container
-Docker 컨테이너화 및 오케스트레이션
-
-| Impact | Description |
-|--------|-------------|
-| HIGH | 일관된 배포 환경 보장 |
-| MEDIUM | 개발/프로덕션 환경 일치 |
-
-## CI/CD
-지속적 통합 및 배포 파이프라인
-
-| Impact | Description |
-|--------|-------------|
-| HIGH | 자동화된 품질 보증 |
-| MEDIUM | 배포 속도 및 안정성 향상 |
-
-## Environment
-환경 변수 및 설정 관리
-
-| Impact | Description |
-|--------|-------------|
-| CRITICAL | 보안 민감 정보 보호 |
-| HIGH | 환경별 설정 분리 |
+# Mandu Deployment - Rule Categories
+
+## Build
+프로덕션 빌드 최적화 및 번들링 설정
+
+| Impact | Description |
+|--------|-------------|
+| CRITICAL | 빌드 실패 시 배포 불가 |
+| HIGH | 번들 크기, 빌드 시간에 큰 영향 |
+
+## Platform
+배포 플랫폼별 설정 및 최적화
+
+| Impact | Description |
+|--------|-------------|
+| CRITICAL | 플랫폼 호환성 필수 |
+| HIGH | 성능, 비용에 큰 영향 |
+
+## Container
+Docker 컨테이너화 및 오케스트레이션
+
+| Impact | Description |
+|--------|-------------|
+| HIGH | 일관된 배포 환경 보장 |
+| MEDIUM | 개발/프로덕션 환경 일치 |
+
+## CI/CD
+지속적 통합 및 배포 파이프라인
+
+| Impact | Description |
+|--------|-------------|
+| HIGH | 자동화된 품질 보증 |
+| MEDIUM | 배포 속도 및 안정성 향상 |
+
+## Environment
+환경 변수 및 설정 관리
+
+| Impact | Description |
+|--------|-------------|
+| CRITICAL | 보안 민감 정보 보호 |
+| HIGH | 환경별 설정 분리 |

package/src/resources/skills/mandu-deployment/_template.md

@@ -1,38 +1,38 @@
----
-title: Rule Title Here
-impact: CRITICAL | HIGH | MEDIUM | LOW
-impactDescription: One-line description of why this matters
-tags: deployment, tag2, tag3
----
-
-## Rule Title Here
-
-**Impact: LEVEL (Impact description)**
-
-규칙에 대한 간단한 설명.
-
-**설정 예시:**
-
-```yaml
-# 설정 파일 예시
-key: value
-```
-
-**구현 예시:**
-
-```typescript
-// 코드 예시
-```
-
-## 추가 설정
-
-```bash
-# 명령어 예시
-```
-
-## 주의사항
-
-- 첫 번째 주의사항
-- 두 번째 주의사항
-
-Reference: [문서 링크](https://example.com)
+---
+title: Rule Title Here
+impact: CRITICAL | HIGH | MEDIUM | LOW
+impactDescription: One-line description of why this matters
+tags: deployment, tag2, tag3
+---
+
+## Rule Title Here
+
+**Impact: LEVEL (Impact description)**
+
+규칙에 대한 간단한 설명.
+
+**설정 예시:**
+
+```yaml
+# 설정 파일 예시
+key: value
+```
+
+**구현 예시:**
+
+```typescript
+// 코드 예시
+```
+
+## 추가 설정
+
+```bash
+# 명령어 예시
+```
+
+## 주의사항
+
+- 첫 번째 주의사항
+- 두 번째 주의사항
+
+Reference: [문서 링크](https://example.com)

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

@@ -1,13 +1,13 @@
-{
-  "id": "mandu-deployment",
-  "name": "Mandu Deployment",
-  "version": "1.0.0",
-  "description": "Production deployment patterns for Mandu applications",
-  "author": "mandu",
-  "references": [
-    "https://bun.sh/docs/bundler",
-    "https://render.com/docs",
-    "https://docs.docker.com/"
-  ],
-  "abstract": "Mandu 앱을 프로덕션 환경에 배포하기 위한 패턴과 가이드. Bun 빌드 최적화, Render/Docker 배포, CI/CD 파이프라인, 환경 설정을 다룹니다."
-}
+{
+  "id": "mandu-deployment",
+  "name": "Mandu Deployment",
+  "version": "1.0.0",
+  "description": "Production deployment patterns for Mandu applications",
+  "author": "mandu",
+  "references": [
+    "https://bun.sh/docs/bundler",
+    "https://render.com/docs",
+    "https://docs.docker.com/"
+  ],
+  "abstract": "Mandu 앱을 프로덕션 환경에 배포하기 위한 패턴과 가이드. Bun 빌드 최적화, Render/Docker 배포, CI/CD 파이프라인, 환경 설정을 다룹니다."
+}

package/src/resources/skills/mandu-deployment/rules/deploy-build-bun.md

@@ -1,109 +1,109 @@
----
-title: Bun Production Build
-impact: CRITICAL
-impactDescription: Build failure blocks deployment
-tags: deployment, build, bun, bundler
----
-
-## Bun Production Build
-
-**Impact: CRITICAL (Build failure blocks deployment)**
-
-Bun 번들러를 사용하여 프로덕션 최적화된 빌드를 생성하세요.
-
-**bunfig.toml 설정:**
-
-```toml
-[build]
-target = "bun"
-minify = true
-sourcemap = "external"
-
-[build.define]
-"process.env.NODE_ENV" = "'production'"
-```
-
-**빌드 스크립트:**
-
-```typescript
-// scripts/build.ts
-import { $ } from "bun";
-
-// 클린 빌드
-await $`rm -rf dist`;
-
-// 서버 빌드
-await Bun.build({
-  entrypoints: ["./src/server.ts"],
-  outdir: "./dist",
-  target: "bun",
-  minify: true,
-  sourcemap: "external",
-  define: {
-    "process.env.NODE_ENV": JSON.stringify("production"),
-  },
-});
-
-// 클라이언트 빌드 (Islands)
-await Bun.build({
-  entrypoints: ["./app/**/client.tsx"],
-  outdir: "./dist/public",
-  target: "browser",
-  minify: true,
-  splitting: true,
-  sourcemap: "external",
-});
-
-console.log("✅ Build complete");
-```
-
-## package.json 스크립트
-
-```json
-{
-  "scripts": {
-    "build": "bun run scripts/build.ts",
-    "start": "NODE_ENV=production bun run dist/server.js",
-    "preview": "bun run build && bun run start"
-  }
-}
-```
-
-## 빌드 최적화 옵션
-
-```typescript
-await Bun.build({
-  entrypoints: ["./src/index.ts"],
-  outdir: "./dist",
-
-  // 필수 최적화
-  minify: true,           // 코드 압축
-  splitting: true,        // 코드 분할
-
-  // 선택적 최적화
-  treeshaking: true,      // 미사용 코드 제거 (기본값)
-
-  // 외부 패키지 처리
-  external: ["better-sqlite3"],  // 네이티브 모듈 제외
-
-  // 환경 변수 주입
-  define: {
-    "process.env.API_URL": JSON.stringify(process.env.API_URL),
-  },
-});
-```
-
-## 빌드 검증
-
-```bash
-# 빌드 크기 확인
-du -sh dist/
-
-# 번들 분석
-bun build --analyze ./src/server.ts
-
-# 빌드 테스트
-bun run dist/server.js
-```
-
-Reference: [Bun Bundler](https://bun.sh/docs/bundler)
+---
+title: Bun Production Build
+impact: CRITICAL
+impactDescription: Build failure blocks deployment
+tags: deployment, build, bun, bundler
+---
+
+## Bun Production Build
+
+**Impact: CRITICAL (Build failure blocks deployment)**
+
+Bun 번들러를 사용하여 프로덕션 최적화된 빌드를 생성하세요.
+
+**bunfig.toml 설정:**
+
+```toml
+[build]
+target = "bun"
+minify = true
+sourcemap = "external"
+
+[build.define]
+"process.env.NODE_ENV" = "'production'"
+```
+
+**빌드 스크립트:**
+
+```typescript
+// scripts/build.ts
+import { $ } from "bun";
+
+// 클린 빌드
+await $`rm -rf dist`;
+
+// 서버 빌드
+await Bun.build({
+  entrypoints: ["./src/server.ts"],
+  outdir: "./dist",
+  target: "bun",
+  minify: true,
+  sourcemap: "external",
+  define: {
+    "process.env.NODE_ENV": JSON.stringify("production"),
+  },
+});
+
+// 클라이언트 빌드 (Islands)
+await Bun.build({
+  entrypoints: ["./app/**/client.tsx"],
+  outdir: "./dist/public",
+  target: "browser",
+  minify: true,
+  splitting: true,
+  sourcemap: "external",
+});
+
+console.log("✅ Build complete");
+```
+
+## package.json 스크립트
+
+```json
+{
+  "scripts": {
+    "build": "bun run scripts/build.ts",
+    "start": "NODE_ENV=production bun run dist/server.js",
+    "preview": "bun run build && bun run start"
+  }
+}
+```
+
+## 빌드 최적화 옵션
+
+```typescript
+await Bun.build({
+  entrypoints: ["./src/index.ts"],
+  outdir: "./dist",
+
+  // 필수 최적화
+  minify: true,           // 코드 압축
+  splitting: true,        // 코드 분할
+
+  // 선택적 최적화
+  treeshaking: true,      // 미사용 코드 제거 (기본값)
+
+  // 외부 패키지 처리
+  external: ["better-sqlite3"],  // 네이티브 모듈 제외
+
+  // 환경 변수 주입
+  define: {
+    "process.env.API_URL": JSON.stringify(process.env.API_URL),
+  },
+});
+```
+
+## 빌드 검증
+
+```bash
+# 빌드 크기 확인
+du -sh dist/
+
+# 번들 분석
+bun build --analyze ./src/server.ts
+
+# 빌드 테스트
+bun run dist/server.js
+```
+
+Reference: [Bun Bundler](https://bun.sh/docs/bundler)