@mandujs/mcp 0.36.2 → 0.37.0

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)

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)