@mandujs/mcp 0.12.2 → 0.13.0

package/src/resources/skills/mandu-performance/rules/_template.md

@@ -1,64 +1,64 @@
-# Rule Template
-
-Use this template when creating new rules for mandu-performance.
-
----
-
-```markdown
----
-title: Rule Title Here
-impact: CRITICAL | HIGH | MEDIUM | LOW
-impactDescription: 개선 수치 (예: "2-10× improvement", "40% faster")
-tags: performance, tag1, tag2
----
-
-## Rule Title Here
-
-**Impact: {LEVEL} ({impactDescription})**
-
-규칙의 목적과 성능 영향을 설명합니다.
-
-**Incorrect (문제점 - 성능 영향 명시):**
-
-\`\`\`typescript
-// ❌ 순차 실행: 3번의 네트워크 왕복
-const user = await fetchUser();
-const posts = await fetchPosts();
-const comments = await fetchComments();
-// 총 시간: 100ms + 100ms + 100ms = 300ms
-\`\`\`
-
-**Correct (해결책 - 성능 개선 명시):**
-
-\`\`\`typescript
-// ✅ 병렬 실행: 1번의 네트워크 왕복
-const [user, posts, comments] = await Promise.all([
-  fetchUser(),
-  fetchPosts(),
-  fetchComments(),
-]);
-// 총 시간: max(100ms, 100ms, 100ms) = 100ms
-\`\`\`
-
-## Mandu Context
-
-Mandu에서 이 규칙을 적용하는 구체적인 방법을 설명합니다.
-
-Reference: [관련 문서 링크](https://example.com)
-```
-
----
-
-## Naming Convention
-
-- 파일명: `perf-{category}-{rule-name}.md`
-- 예시: `perf-async-parallel.md`, `perf-bundle-imports.md`
-
-## Impact Measurement
-
-| Level | Typical Improvement |
-|-------|---------------------|
-| CRITICAL | 2-10× or 50%+ |
-| HIGH | 20-50% |
-| MEDIUM | 10-20% |
-| LOW | < 10% |
+# Rule Template
+
+Use this template when creating new rules for mandu-performance.
+
+---
+
+```markdown
+---
+title: Rule Title Here
+impact: CRITICAL | HIGH | MEDIUM | LOW
+impactDescription: 개선 수치 (예: "2-10× improvement", "40% faster")
+tags: performance, tag1, tag2
+---
+
+## Rule Title Here
+
+**Impact: {LEVEL} ({impactDescription})**
+
+규칙의 목적과 성능 영향을 설명합니다.
+
+**Incorrect (문제점 - 성능 영향 명시):**
+
+\`\`\`typescript
+// ❌ 순차 실행: 3번의 네트워크 왕복
+const user = await fetchUser();
+const posts = await fetchPosts();
+const comments = await fetchComments();
+// 총 시간: 100ms + 100ms + 100ms = 300ms
+\`\`\`
+
+**Correct (해결책 - 성능 개선 명시):**
+
+\`\`\`typescript
+// ✅ 병렬 실행: 1번의 네트워크 왕복
+const [user, posts, comments] = await Promise.all([
+  fetchUser(),
+  fetchPosts(),
+  fetchComments(),
+]);
+// 총 시간: max(100ms, 100ms, 100ms) = 100ms
+\`\`\`
+
+## Mandu Context
+
+Mandu에서 이 규칙을 적용하는 구체적인 방법을 설명합니다.
+
+Reference: [관련 문서 링크](https://example.com)
+```
+
+---
+
+## Naming Convention
+
+- 파일명: `perf-{category}-{rule-name}.md`
+- 예시: `perf-async-parallel.md`, `perf-bundle-imports.md`
+
+## Impact Measurement
+
+| Level | Typical Improvement |
+|-------|---------------------|
+| CRITICAL | 2-10× or 50%+ |
+| HIGH | 20-50% |
+| MEDIUM | 10-20% |
+| LOW | < 10% |

package/src/resources/skills/mandu-performance/rules/perf-async-defer-await.md

@@ -1,103 +1,103 @@
----
-title: Defer await to Where Actually Used
-impact: CRITICAL
-impactDescription: Eliminates unnecessary blocking
-tags: performance, async, await, slot
----
-
-## Defer await to Where Actually Used
-
-**Impact: CRITICAL (Eliminates unnecessary blocking)**
-
-await는 실제로 값이 필요한 시점까지 지연하세요. 함수 시작에서 모든 것을 await하면 불필요한 블로킹이 발생합니다.
-
-**Incorrect (너무 일찍 await):**
-
-```typescript
-// spec/slots/user.slot.ts
-import { Mandu } from "@mandujs/core";
-
-export default Mandu.filling()
-  .get(async (ctx) => {
-    const userId = ctx.params.id;
-
-    // ❌ 캐시 확인 전에 DB 쿼리 시작하고 대기
-    const user = await fetchUserFromDB(userId);
-
-    // 캐시에 있으면 DB 쿼리는 불필요했음
-    const cached = cache.get(`user:${userId}`);
-    if (cached) {
-      return ctx.ok(cached);
-    }
-
-    return ctx.ok(user);
-  });
-```
-
-**Correct (필요한 시점에 await):**
-
-```typescript
-// spec/slots/user.slot.ts
-import { Mandu } from "@mandujs/core";
-
-export default Mandu.filling()
-  .get(async (ctx) => {
-    const userId = ctx.params.id;
-
-    // 캐시 먼저 확인
-    const cached = cache.get(`user:${userId}`);
-    if (cached) {
-      return ctx.ok(cached);  // DB 쿼리 안 함
-    }
-
-    // ✅ 캐시 미스일 때만 DB 쿼리
-    const user = await fetchUserFromDB(userId);
-    cache.set(`user:${userId}`, user);
-
-    return ctx.ok(user);
-  });
-```
-
-## Promise 시작은 일찍, await는 늦게
-
-```typescript
-export default Mandu.filling()
-  .get(async (ctx) => {
-    // ✅ Promise 시작 (블로킹 없음)
-    const userPromise = fetchUser(ctx.params.id);
-    const configPromise = fetchConfig();
-
-    // 동기 작업 수행
-    const requestId = generateRequestId();
-    const timestamp = Date.now();
-    logRequest(requestId, timestamp);
-
-    // ✅ 필요한 시점에 await
-    const [user, config] = await Promise.all([userPromise, configPromise]);
-
-    return ctx.ok({ user, config, requestId });
-  });
-```
-
-## 조건부 분기에서의 활용
-
-```typescript
-export default Mandu.filling()
-  .get(async (ctx) => {
-    const { type } = ctx.query;
-
-    if (type === "summary") {
-      // 요약만 필요하면 상세 데이터 불필요
-      const summary = await fetchSummary(ctx.params.id);
-      return ctx.ok({ summary });
-    }
-
-    // 상세 데이터가 필요한 경우에만 fetch
-    const [summary, details] = await Promise.all([
-      fetchSummary(ctx.params.id),
-      fetchDetails(ctx.params.id),
-    ]);
-
-    return ctx.ok({ summary, details });
-  });
-```
+---
+title: Defer await to Where Actually Used
+impact: CRITICAL
+impactDescription: Eliminates unnecessary blocking
+tags: performance, async, await, slot
+---
+
+## Defer await to Where Actually Used
+
+**Impact: CRITICAL (Eliminates unnecessary blocking)**
+
+await는 실제로 값이 필요한 시점까지 지연하세요. 함수 시작에서 모든 것을 await하면 불필요한 블로킹이 발생합니다.
+
+**Incorrect (너무 일찍 await):**
+
+```typescript
+// spec/slots/user.slot.ts
+import { Mandu } from "@mandujs/core";
+
+export default Mandu.filling()
+  .get(async (ctx) => {
+    const userId = ctx.params.id;
+
+    // ❌ 캐시 확인 전에 DB 쿼리 시작하고 대기
+    const user = await fetchUserFromDB(userId);
+
+    // 캐시에 있으면 DB 쿼리는 불필요했음
+    const cached = cache.get(`user:${userId}`);
+    if (cached) {
+      return ctx.ok(cached);
+    }
+
+    return ctx.ok(user);
+  });
+```
+
+**Correct (필요한 시점에 await):**
+
+```typescript
+// spec/slots/user.slot.ts
+import { Mandu } from "@mandujs/core";
+
+export default Mandu.filling()
+  .get(async (ctx) => {
+    const userId = ctx.params.id;
+
+    // 캐시 먼저 확인
+    const cached = cache.get(`user:${userId}`);
+    if (cached) {
+      return ctx.ok(cached);  // DB 쿼리 안 함
+    }
+
+    // ✅ 캐시 미스일 때만 DB 쿼리
+    const user = await fetchUserFromDB(userId);
+    cache.set(`user:${userId}`, user);
+
+    return ctx.ok(user);
+  });
+```
+
+## Promise 시작은 일찍, await는 늦게
+
+```typescript
+export default Mandu.filling()
+  .get(async (ctx) => {
+    // ✅ Promise 시작 (블로킹 없음)
+    const userPromise = fetchUser(ctx.params.id);
+    const configPromise = fetchConfig();
+
+    // 동기 작업 수행
+    const requestId = generateRequestId();
+    const timestamp = Date.now();
+    logRequest(requestId, timestamp);
+
+    // ✅ 필요한 시점에 await
+    const [user, config] = await Promise.all([userPromise, configPromise]);
+
+    return ctx.ok({ user, config, requestId });
+  });
+```
+
+## 조건부 분기에서의 활용
+
+```typescript
+export default Mandu.filling()
+  .get(async (ctx) => {
+    const { type } = ctx.query;
+
+    if (type === "summary") {
+      // 요약만 필요하면 상세 데이터 불필요
+      const summary = await fetchSummary(ctx.params.id);
+      return ctx.ok({ summary });
+    }
+
+    // 상세 데이터가 필요한 경우에만 fetch
+    const [summary, details] = await Promise.all([
+      fetchSummary(ctx.params.id),
+      fetchDetails(ctx.params.id),
+    ]);
+
+    return ctx.ok({ summary, details });
+  });
+```

package/src/resources/skills/mandu-performance/rules/perf-async-parallel.md

@@ -1,95 +1,95 @@
----
-title: Use Promise.all() for Independent Operations
-impact: CRITICAL
-impactDescription: 2-10× improvement
-tags: performance, async, parallel, promises, slot
----
-
-## Use Promise.all() for Independent Operations
-
-**Impact: CRITICAL (2-10× improvement)**
-
-독립적인 비동기 작업은 `Promise.all()`로 병렬 실행하세요. 순차 실행은 각 await마다 전체 네트워크 지연을 추가합니다.
-
-**Incorrect (순차 실행, 3번의 왕복):**
-
-```typescript
-// spec/slots/dashboard.slot.ts
-import { Mandu } from "@mandujs/core";
-
-export default Mandu.filling()
-  .get(async (ctx) => {
-    // ❌ 순차 실행: 300ms (100ms × 3)
-    const user = await fetchUser(ctx.get("userId"));
-    const posts = await fetchPosts(ctx.get("userId"));
-    const notifications = await fetchNotifications(ctx.get("userId"));
-
-    return ctx.ok({ user, posts, notifications });
-  });
-```
-
-**Correct (병렬 실행, 1번의 왕복):**
-
-```typescript
-// spec/slots/dashboard.slot.ts
-import { Mandu } from "@mandujs/core";
-
-export default Mandu.filling()
-  .get(async (ctx) => {
-    const userId = ctx.get("userId");
-
-    // ✅ 병렬 실행: 100ms (가장 느린 것 기준)
-    const [user, posts, notifications] = await Promise.all([
-      fetchUser(userId),
-      fetchPosts(userId),
-      fetchNotifications(userId),
-    ]);
-
-    return ctx.ok({ user, posts, notifications });
-  });
-```
-
-## 부분 의존성이 있는 경우
-
-일부 작업이 다른 작업의 결과에 의존하는 경우:
-
-```typescript
-export default Mandu.filling()
-  .get(async (ctx) => {
-    // 1단계: 독립적인 작업 병렬 실행
-    const [user, config] = await Promise.all([
-      fetchUser(ctx.get("userId")),
-      fetchConfig(),
-    ]);
-
-    // 2단계: user에 의존하는 작업 병렬 실행
-    const [posts, followers] = await Promise.all([
-      fetchPosts(user.id),
-      fetchFollowers(user.id),
-    ]);
-
-    return ctx.ok({ user, config, posts, followers });
-  });
-```
-
-## Promise.allSettled() 사용
-
-일부 실패를 허용하는 경우:
-
-```typescript
-const results = await Promise.allSettled([
-  fetchUser(userId),
-  fetchPosts(userId),   // 실패해도 OK
-  fetchNotifications(userId),  // 실패해도 OK
-]);
-
-const [userResult, postsResult, notificationsResult] = results;
-
-return ctx.ok({
-  user: userResult.status === "fulfilled" ? userResult.value : null,
-  posts: postsResult.status === "fulfilled" ? postsResult.value : [],
-  notifications: notificationsResult.status === "fulfilled" ? notificationsResult.value : [],
-});
-```
-
-Reference: [MDN Promise.all()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/all)
+---
+title: Use Promise.all() for Independent Operations
+impact: CRITICAL
+impactDescription: 2-10× improvement
+tags: performance, async, parallel, promises, slot
+---
+
+## Use Promise.all() for Independent Operations
+
+**Impact: CRITICAL (2-10× improvement)**
+
+독립적인 비동기 작업은 `Promise.all()`로 병렬 실행하세요. 순차 실행은 각 await마다 전체 네트워크 지연을 추가합니다.
+
+**Incorrect (순차 실행, 3번의 왕복):**
+
+```typescript
+// spec/slots/dashboard.slot.ts
+import { Mandu } from "@mandujs/core";
+
+export default Mandu.filling()
+  .get(async (ctx) => {
+    // ❌ 순차 실행: 300ms (100ms × 3)
+    const user = await fetchUser(ctx.get("userId"));
+    const posts = await fetchPosts(ctx.get("userId"));
+    const notifications = await fetchNotifications(ctx.get("userId"));
+
+    return ctx.ok({ user, posts, notifications });
+  });
+```
+
+**Correct (병렬 실행, 1번의 왕복):**
+
+```typescript
+// spec/slots/dashboard.slot.ts
+import { Mandu } from "@mandujs/core";
+
+export default Mandu.filling()
+  .get(async (ctx) => {
+    const userId = ctx.get("userId");
+
+    // ✅ 병렬 실행: 100ms (가장 느린 것 기준)
+    const [user, posts, notifications] = await Promise.all([
+      fetchUser(userId),
+      fetchPosts(userId),
+      fetchNotifications(userId),
+    ]);
+
+    return ctx.ok({ user, posts, notifications });
+  });
+```
+
+## 부분 의존성이 있는 경우
+
+일부 작업이 다른 작업의 결과에 의존하는 경우:
+
+```typescript
+export default Mandu.filling()
+  .get(async (ctx) => {
+    // 1단계: 독립적인 작업 병렬 실행
+    const [user, config] = await Promise.all([
+      fetchUser(ctx.get("userId")),
+      fetchConfig(),
+    ]);
+
+    // 2단계: user에 의존하는 작업 병렬 실행
+    const [posts, followers] = await Promise.all([
+      fetchPosts(user.id),
+      fetchFollowers(user.id),
+    ]);
+
+    return ctx.ok({ user, config, posts, followers });
+  });
+```
+
+## Promise.allSettled() 사용
+
+일부 실패를 허용하는 경우:
+
+```typescript
+const results = await Promise.allSettled([
+  fetchUser(userId),
+  fetchPosts(userId),   // 실패해도 OK
+  fetchNotifications(userId),  // 실패해도 OK
+]);
+
+const [userResult, postsResult, notificationsResult] = results;
+
+return ctx.ok({
+  user: userResult.status === "fulfilled" ? userResult.value : null,
+  posts: postsResult.status === "fulfilled" ? postsResult.value : [],
+  notifications: notificationsResult.status === "fulfilled" ? notificationsResult.value : [],
+});
+```
+
+Reference: [MDN Promise.all()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/all)