@mandujs/mcp 0.12.2 → 0.13.0

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

@@ -1,115 +1,115 @@
----
-title: Build Output Configuration
-impact: HIGH
-impactDescription: Affects bundle size and load performance
-tags: deployment, build, output, optimization
----
-
-## Build Output Configuration
-
-**Impact: HIGH (Affects bundle size and load performance)**
-
-빌드 출력을 최적화하여 번들 크기를 줄이고 로딩 성능을 개선하세요.
-
-**디렉토리 구조:**
-
-```
-dist/
-├── server.js          # 서버 엔트리포인트
-├── public/
-│   ├── islands/       # Island 컴포넌트 청크
-│   │   ├── counter-abc123.js
-│   │   └── form-def456.js
-│   ├── shared/        # 공유 청크
-│   │   └── react-vendor-xyz789.js
-│   └── assets/        # 정적 자산
-│       ├── styles.css
-│       └── images/
-└── server.js.map      # 소스맵 (프로덕션 디버깅용)
-```
-
-**청크 분할 설정:**
-
-```typescript
-// scripts/build.ts
-await Bun.build({
-  entrypoints: ["./app/**/client.tsx"],
-  outdir: "./dist/public/islands",
-  target: "browser",
-  splitting: true,        // 공유 코드 자동 분리
-  minify: true,
-  naming: {
-    chunk: "[name]-[hash].js",
-    entry: "[name]-[hash].js",
-    asset: "[name]-[hash][ext]",
-  },
-});
-```
-
-## 정적 자산 처리
-
-```typescript
-// 정적 파일 복사
-import { $ } from "bun";
-
-// public 폴더 복사
-await $`cp -r public/* dist/public/`;
-
-// CSS 최적화 (optional)
-await $`bunx lightningcss --minify public/styles.css -o dist/public/styles.css`;
-```
-
-## Gzip/Brotli 압축
-
-```typescript
-// 프로덕션 서버에서 압축
-import { gzipSync } from "bun";
-
-// 또는 빌드 시 사전 압축
-import { $ } from "bun";
-
-const files = await Array.fromAsync(
-  new Bun.Glob("dist/public/**/*.{js,css}").scan()
-);
-
-for (const file of files) {
-  const content = await Bun.file(file).arrayBuffer();
-  await Bun.write(`${file}.gz`, gzipSync(new Uint8Array(content)));
-}
-```
-
-## 빌드 매니페스트
-
-```typescript
-// 빌드 후 매니페스트 생성
-const manifest = {
-  version: process.env.BUILD_VERSION || Date.now().toString(),
-  files: {},
-};
-
-const files = await Array.fromAsync(
-  new Bun.Glob("dist/public/**/*").scan()
-);
-
-for (const file of files) {
-  const hash = Bun.hash(await Bun.file(file).arrayBuffer());
-  manifest.files[file] = hash.toString(16);
-}
-
-await Bun.write("dist/manifest.json", JSON.stringify(manifest, null, 2));
-```
-
-## 번들 크기 모니터링
-
-```bash
-# 번들 크기 리포트
-bun run scripts/bundle-size.ts
-
-# CI에서 크기 제한 체크
-if [ $(du -sb dist/public | cut -f1) -gt 1048576 ]; then
-  echo "Bundle size exceeds 1MB limit"
-  exit 1
-fi
-```
-
-Reference: [Bun Build Naming](https://bun.sh/docs/bundler#naming)
+---
+title: Build Output Configuration
+impact: HIGH
+impactDescription: Affects bundle size and load performance
+tags: deployment, build, output, optimization
+---
+
+## Build Output Configuration
+
+**Impact: HIGH (Affects bundle size and load performance)**
+
+빌드 출력을 최적화하여 번들 크기를 줄이고 로딩 성능을 개선하세요.
+
+**디렉토리 구조:**
+
+```
+dist/
+├── server.js          # 서버 엔트리포인트
+├── public/
+│   ├── islands/       # Island 컴포넌트 청크
+│   │   ├── counter-abc123.js
+│   │   └── form-def456.js
+│   ├── shared/        # 공유 청크
+│   │   └── react-vendor-xyz789.js
+│   └── assets/        # 정적 자산
+│       ├── styles.css
+│       └── images/
+└── server.js.map      # 소스맵 (프로덕션 디버깅용)
+```
+
+**청크 분할 설정:**
+
+```typescript
+// scripts/build.ts
+await Bun.build({
+  entrypoints: ["./app/**/client.tsx"],
+  outdir: "./dist/public/islands",
+  target: "browser",
+  splitting: true,        // 공유 코드 자동 분리
+  minify: true,
+  naming: {
+    chunk: "[name]-[hash].js",
+    entry: "[name]-[hash].js",
+    asset: "[name]-[hash][ext]",
+  },
+});
+```
+
+## 정적 자산 처리
+
+```typescript
+// 정적 파일 복사
+import { $ } from "bun";
+
+// public 폴더 복사
+await $`cp -r public/* dist/public/`;
+
+// CSS 최적화 (optional)
+await $`bunx lightningcss --minify public/styles.css -o dist/public/styles.css`;
+```
+
+## Gzip/Brotli 압축
+
+```typescript
+// 프로덕션 서버에서 압축
+import { gzipSync } from "bun";
+
+// 또는 빌드 시 사전 압축
+import { $ } from "bun";
+
+const files = await Array.fromAsync(
+  new Bun.Glob("dist/public/**/*.{js,css}").scan()
+);
+
+for (const file of files) {
+  const content = await Bun.file(file).arrayBuffer();
+  await Bun.write(`${file}.gz`, gzipSync(new Uint8Array(content)));
+}
+```
+
+## 빌드 매니페스트
+
+```typescript
+// 빌드 후 매니페스트 생성
+const manifest = {
+  version: process.env.BUILD_VERSION || Date.now().toString(),
+  files: {},
+};
+
+const files = await Array.fromAsync(
+  new Bun.Glob("dist/public/**/*").scan()
+);
+
+for (const file of files) {
+  const hash = Bun.hash(await Bun.file(file).arrayBuffer());
+  manifest.files[file] = hash.toString(16);
+}
+
+await Bun.write("dist/manifest.json", JSON.stringify(manifest, null, 2));
+```
+
+## 번들 크기 모니터링
+
+```bash
+# 번들 크기 리포트
+bun run scripts/bundle-size.ts
+
+# CI에서 크기 제한 체크
+if [ $(du -sb dist/public | cut -f1) -gt 1048576 ]; then
+  echo "Bundle size exceeds 1MB limit"
+  exit 1
+fi
+```
+
+Reference: [Bun Build Naming](https://bun.sh/docs/bundler#naming)

package/src/resources/skills/mandu-deployment/rules/deploy-cicd-github.md

@@ -1,219 +1,219 @@
----
-title: GitHub Actions CI/CD
-impact: HIGH
-impactDescription: Automates testing and deployment pipeline
-tags: deployment, cicd, github, automation
----
-
-## GitHub Actions CI/CD
-
-**Impact: HIGH (Automates testing and deployment pipeline)**
-
-GitHub Actions를 사용하여 테스트, 빌드, 배포를 자동화하세요.
-
-**.github/workflows/ci.yml:**
-
-```yaml
-name: CI
-
-on:
-  push:
-    branches: [main, develop]
-  pull_request:
-    branches: [main]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v1
-        with:
-          bun-version: latest
-
-      - name: Install dependencies
-        run: bun install --frozen-lockfile
-
-      - name: Type check
-        run: bun run typecheck
-
-      - name: Lint
-        run: bun run lint
-
-      - name: Test
-        run: bun test --coverage
-
-      - name: Upload coverage
-        uses: codecov/codecov-action@v3
-        with:
-          files: ./coverage/lcov.info
-
-  build:
-    runs-on: ubuntu-latest
-    needs: test
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v1
-
-      - name: Install dependencies
-        run: bun install --frozen-lockfile
-
-      - name: Build
-        run: bun run build
-
-      - name: Upload artifacts
-        uses: actions/upload-artifact@v4
-        with:
-          name: dist
-          path: dist/
-```
-
-## 배포 워크플로우
-
-```yaml
-# .github/workflows/deploy.yml
-name: Deploy
-
-on:
-  push:
-    branches: [main]
-
-jobs:
-  deploy-render:
-    runs-on: ubuntu-latest
-    if: github.ref == 'refs/heads/main'
-
-    steps:
-      - name: Deploy to Render
-        uses: johnbeynon/render-deploy-action@v0.0.8
-        with:
-          service-id: ${{ secrets.RENDER_SERVICE_ID }}
-          api-key: ${{ secrets.RENDER_API_KEY }}
-
-  deploy-fly:
-    runs-on: ubuntu-latest
-    if: github.ref == 'refs/heads/main'
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Setup Fly
-        uses: superfly/flyctl-actions/setup-flyctl@master
-
-      - name: Deploy to Fly.io
-        run: flyctl deploy --remote-only
-        env:
-          FLY_API_TOKEN: ${{ secrets.FLY_API_TOKEN }}
-```
-
-## Docker 이미지 빌드 & 푸시
-
-```yaml
-# .github/workflows/docker.yml
-name: Docker
-
-on:
-  push:
-    branches: [main]
-    tags: ['v*']
-
-jobs:
-  docker:
-    runs-on: ubuntu-latest
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v3
-
-      - name: Login to GitHub Container Registry
-        uses: docker/login-action@v3
-        with:
-          registry: ghcr.io
-          username: ${{ github.actor }}
-          password: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Extract metadata
-        id: meta
-        uses: docker/metadata-action@v5
-        with:
-          images: ghcr.io/${{ github.repository }}
-          tags: |
-            type=ref,event=branch
-            type=semver,pattern={{version}}
-            type=sha,prefix=
-
-      - name: Build and push
-        uses: docker/build-push-action@v5
-        with:
-          context: .
-          push: true
-          tags: ${{ steps.meta.outputs.tags }}
-          cache-from: type=gha
-          cache-to: type=gha,mode=max
-```
-
-## E2E 테스트 (Playwright)
-
-```yaml
-  e2e:
-    runs-on: ubuntu-latest
-    needs: build
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v1
-
-      - name: Install dependencies
-        run: bun install --frozen-lockfile
-
-      - name: Install Playwright browsers
-        run: bunx playwright install --with-deps
-
-      - name: Run E2E tests
-        run: bunx playwright test
-
-      - name: Upload test results
-        if: always()
-        uses: actions/upload-artifact@v4
-        with:
-          name: playwright-report
-          path: playwright-report/
-```
-
-## 환경별 배포
-
-```yaml
-jobs:
-  deploy:
-    runs-on: ubuntu-latest
-    environment: ${{ github.ref == 'refs/heads/main' && 'production' || 'staging' }}
-
-    steps:
-      - name: Deploy
-        run: |
-          echo "Deploying to ${{ github.ref == 'refs/heads/main' && 'production' || 'staging' }}"
-        env:
-          API_URL: ${{ secrets.API_URL }}
-```
-
-## 시크릿 설정
-
-```bash
-# GitHub CLI로 시크릿 설정
-gh secret set RENDER_API_KEY --body "rnd_xxx"
-gh secret set RENDER_SERVICE_ID --body "srv_xxx"
-gh secret set FLY_API_TOKEN --body "xxx"
-gh secret set DATABASE_URL --body "postgresql://..."
-```
-
-Reference: [GitHub Actions Documentation](https://docs.github.com/en/actions)
+---
+title: GitHub Actions CI/CD
+impact: HIGH
+impactDescription: Automates testing and deployment pipeline
+tags: deployment, cicd, github, automation
+---
+
+## GitHub Actions CI/CD
+
+**Impact: HIGH (Automates testing and deployment pipeline)**
+
+GitHub Actions를 사용하여 테스트, 빌드, 배포를 자동화하세요.
+
+**.github/workflows/ci.yml:**
+
+```yaml
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Type check
+        run: bun run typecheck
+
+      - name: Lint
+        run: bun run lint
+
+      - name: Test
+        run: bun test --coverage
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v3
+        with:
+          files: ./coverage/lcov.info
+
+  build:
+    runs-on: ubuntu-latest
+    needs: test
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Build
+        run: bun run build
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+```
+
+## 배포 워크플로우
+
+```yaml
+# .github/workflows/deploy.yml
+name: Deploy
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  deploy-render:
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main'
+
+    steps:
+      - name: Deploy to Render
+        uses: johnbeynon/render-deploy-action@v0.0.8
+        with:
+          service-id: ${{ secrets.RENDER_SERVICE_ID }}
+          api-key: ${{ secrets.RENDER_API_KEY }}
+
+  deploy-fly:
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main'
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Fly
+        uses: superfly/flyctl-actions/setup-flyctl@master
+
+      - name: Deploy to Fly.io
+        run: flyctl deploy --remote-only
+        env:
+          FLY_API_TOKEN: ${{ secrets.FLY_API_TOKEN }}
+```
+
+## Docker 이미지 빌드 & 푸시
+
+```yaml
+# .github/workflows/docker.yml
+name: Docker
+
+on:
+  push:
+    branches: [main]
+    tags: ['v*']
+
+jobs:
+  docker:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ghcr.io/${{ github.repository }}
+          tags: |
+            type=ref,event=branch
+            type=semver,pattern={{version}}
+            type=sha,prefix=
+
+      - name: Build and push
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+```
+
+## E2E 테스트 (Playwright)
+
+```yaml
+  e2e:
+    runs-on: ubuntu-latest
+    needs: build
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Install Playwright browsers
+        run: bunx playwright install --with-deps
+
+      - name: Run E2E tests
+        run: bunx playwright test
+
+      - name: Upload test results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-report
+          path: playwright-report/
+```
+
+## 환경별 배포
+
+```yaml
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment: ${{ github.ref == 'refs/heads/main' && 'production' || 'staging' }}
+
+    steps:
+      - name: Deploy
+        run: |
+          echo "Deploying to ${{ github.ref == 'refs/heads/main' && 'production' || 'staging' }}"
+        env:
+          API_URL: ${{ secrets.API_URL }}
+```
+
+## 시크릿 설정
+
+```bash
+# GitHub CLI로 시크릿 설정
+gh secret set RENDER_API_KEY --body "rnd_xxx"
+gh secret set RENDER_SERVICE_ID --body "srv_xxx"
+gh secret set FLY_API_TOKEN --body "xxx"
+gh secret set DATABASE_URL --body "postgresql://..."
+```
+
+Reference: [GitHub Actions Documentation](https://docs.github.com/en/actions)