npm - @mandujs/mcp - Versions diffs - 0.13.0 → 0.17.0 - Mend

@mandujs/mcp 0.13.0 → 0.17.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (136) hide show

package/README.md +102 -7
package/package.json +3 -2
package/src/adapters/index.ts +20 -20
package/src/adapters/monitor-adapter.ts +100 -100
package/src/adapters/tool-adapter.ts +88 -88
package/src/executor/error-handler.ts +250 -250
package/src/executor/index.ts +22 -22
package/src/executor/tool-executor.ts +148 -148
package/src/hooks/config-watcher.ts +174 -174
package/src/hooks/index.ts +23 -23
package/src/hooks/mcp-hooks.ts +227 -227
package/src/logging/index.ts +15 -15
package/src/logging/mcp-transport.ts +134 -134
package/src/registry/index.ts +13 -13
package/src/registry/mcp-tool-registry.ts +298 -298
package/src/resources/skills/guides.ts +1136 -1136
package/src/resources/skills/index.ts +12 -12
package/src/resources/skills/loader.ts +218 -218
package/src/resources/skills/mandu-composition/SKILL.md +91 -91
package/src/resources/skills/mandu-composition/metadata.json +13 -13
package/src/resources/skills/mandu-composition/rules/_sections.md +26 -26
package/src/resources/skills/mandu-composition/rules/_template.md +77 -77
package/src/resources/skills/mandu-composition/rules/comp-arch-avoid-boolean-props.md +146 -146
package/src/resources/skills/mandu-composition/rules/comp-arch-compound-components.md +164 -164
package/src/resources/skills/mandu-composition/rules/comp-island-event.md +161 -161
package/src/resources/skills/mandu-composition/rules/comp-island-slot-split.md +167 -167
package/src/resources/skills/mandu-composition/rules/comp-pattern-children.md +149 -149
package/src/resources/skills/mandu-composition/rules/comp-state-context-interface.md +148 -148
package/src/resources/skills/mandu-composition/rules/comp-state-lift-state.md +150 -150
package/src/resources/skills/mandu-deployment/SKILL.md +92 -92
package/src/resources/skills/mandu-deployment/_sections.md +41 -41
package/src/resources/skills/mandu-deployment/_template.md +38 -38
package/src/resources/skills/mandu-deployment/metadata.json +13 -13
package/src/resources/skills/mandu-deployment/rules/deploy-build-bun.md +109 -109
package/src/resources/skills/mandu-deployment/rules/deploy-build-output.md +115 -115
package/src/resources/skills/mandu-deployment/rules/deploy-cicd-github.md +219 -219
package/src/resources/skills/mandu-deployment/rules/deploy-docker-bun.md +150 -150
package/src/resources/skills/mandu-deployment/rules/deploy-docker-compose.md +223 -223
package/src/resources/skills/mandu-deployment/rules/deploy-platform-fly.md +152 -152
package/src/resources/skills/mandu-deployment/rules/deploy-platform-render.md +179 -179
package/src/resources/skills/mandu-deployment/rules/deploy-platform-supabase.md +323 -323
package/src/resources/skills/mandu-deployment/rules/deploy-platform-vercel.md +140 -140
package/src/resources/skills/mandu-fs-routes/SKILL.md +82 -82
package/src/resources/skills/mandu-fs-routes/metadata.json +12 -12
package/src/resources/skills/mandu-fs-routes/rules/_sections.md +36 -36
package/src/resources/skills/mandu-fs-routes/rules/_template.md +69 -69
package/src/resources/skills/mandu-fs-routes/rules/routes-api-methods.md +65 -65
package/src/resources/skills/mandu-fs-routes/rules/routes-dynamic-param.md +93 -93
package/src/resources/skills/mandu-fs-routes/rules/routes-naming-page.md +55 -55
package/src/resources/skills/mandu-guard/SKILL.md +129 -129
package/src/resources/skills/mandu-guard/metadata.json +12 -12
package/src/resources/skills/mandu-guard/rules/_sections.md +36 -36
package/src/resources/skills/mandu-guard/rules/_template.md +82 -82
package/src/resources/skills/mandu-guard/rules/guard-config-rules.md +100 -100
package/src/resources/skills/mandu-guard/rules/guard-layer-direction.md +76 -76
package/src/resources/skills/mandu-guard/rules/guard-preset-mandu.md +81 -81
package/src/resources/skills/mandu-guard/rules/guard-validate-import.md +80 -80
package/src/resources/skills/mandu-hydration/SKILL.md +91 -91
package/src/resources/skills/mandu-hydration/metadata.json +12 -12
package/src/resources/skills/mandu-hydration/rules/_sections.md +31 -31
package/src/resources/skills/mandu-hydration/rules/_template.md +72 -72
package/src/resources/skills/mandu-hydration/rules/hydration-data-event.md +109 -109
package/src/resources/skills/mandu-hydration/rules/hydration-directive-use-client.md +55 -55
package/src/resources/skills/mandu-hydration/rules/hydration-island-setup.md +113 -113
package/src/resources/skills/mandu-hydration/rules/hydration-priority-visible.md +68 -68
package/src/resources/skills/mandu-performance/SKILL.md +85 -85
package/src/resources/skills/mandu-performance/metadata.json +14 -14
package/src/resources/skills/mandu-performance/rules/_sections.md +31 -31
package/src/resources/skills/mandu-performance/rules/_template.md +64 -64
package/src/resources/skills/mandu-performance/rules/perf-async-defer-await.md +103 -103
package/src/resources/skills/mandu-performance/rules/perf-async-parallel.md +95 -95
package/src/resources/skills/mandu-performance/rules/perf-bun-file.md +124 -124
package/src/resources/skills/mandu-performance/rules/perf-bun-serve.md +125 -125
package/src/resources/skills/mandu-performance/rules/perf-bundle-imports.md +80 -80
package/src/resources/skills/mandu-performance/rules/perf-bundle-island-lazy.md +145 -145
package/src/resources/skills/mandu-performance/rules/perf-cache-react.md +98 -98
package/src/resources/skills/mandu-performance/rules/perf-render-transitions.md +154 -154
package/src/resources/skills/mandu-security/SKILL.md +87 -87
package/src/resources/skills/mandu-security/metadata.json +13 -13
package/src/resources/skills/mandu-security/rules/_sections.md +31 -31
package/src/resources/skills/mandu-security/rules/_template.md +74 -74
package/src/resources/skills/mandu-security/rules/sec-auth-guard.md +127 -127
package/src/resources/skills/mandu-security/rules/sec-env-management.md +133 -133
package/src/resources/skills/mandu-security/rules/sec-input-validate.md +148 -148
package/src/resources/skills/mandu-security/rules/sec-protect-csrf.md +146 -146
package/src/resources/skills/mandu-security/rules/sec-protect-headers.md +138 -138
package/src/resources/skills/mandu-slot/SKILL.md +85 -85
package/src/resources/skills/mandu-slot/metadata.json +12 -12
package/src/resources/skills/mandu-slot/rules/_sections.md +36 -36
package/src/resources/skills/mandu-slot/rules/_template.md +63 -63
package/src/resources/skills/mandu-slot/rules/slot-basic-structure.md +38 -38
package/src/resources/skills/mandu-slot/rules/slot-ctx-response.md +56 -56
package/src/resources/skills/mandu-slot/rules/slot-guard-auth.md +59 -59
package/src/resources/skills/mandu-slot/rules/slot-http-methods.md +64 -64
package/src/resources/skills/mandu-styling/SKILL.md +154 -154
package/src/resources/skills/mandu-styling/_sections.md +43 -43
package/src/resources/skills/mandu-styling/_template.md +32 -32
package/src/resources/skills/mandu-styling/metadata.json +15 -15
package/src/resources/skills/mandu-styling/rules/style-component-compound.md +235 -235
package/src/resources/skills/mandu-styling/rules/style-component-slots.md +255 -255
package/src/resources/skills/mandu-styling/rules/style-component-tokens.md +205 -205
package/src/resources/skills/mandu-styling/rules/style-island-animations.md +272 -272
package/src/resources/skills/mandu-styling/rules/style-island-scoping.md +167 -167
package/src/resources/skills/mandu-styling/rules/style-island-variants.md +221 -221
package/src/resources/skills/mandu-styling/rules/style-perf-critical.md +209 -209
package/src/resources/skills/mandu-styling/rules/style-perf-purge.md +192 -192
package/src/resources/skills/mandu-styling/rules/style-setup-modules.md +162 -162
package/src/resources/skills/mandu-styling/rules/style-setup-panda.md +164 -164
package/src/resources/skills/mandu-styling/rules/style-setup-tailwind.md +170 -170
package/src/resources/skills/mandu-styling/rules/style-tailwind-v4-gotchas.md +179 -179
package/src/resources/skills/mandu-styling/rules/style-theme-darkmode.md +229 -229
package/src/resources/skills/mandu-testing/SKILL.md +99 -99
package/src/resources/skills/mandu-testing/metadata.json +13 -13
package/src/resources/skills/mandu-testing/rules/_sections.md +26 -26
package/src/resources/skills/mandu-testing/rules/_template.md +65 -65
package/src/resources/skills/mandu-testing/rules/test-component-island.md +195 -195
package/src/resources/skills/mandu-testing/rules/test-e2e-playwright.md +196 -196
package/src/resources/skills/mandu-testing/rules/test-mock-fetch.md +219 -219
package/src/resources/skills/mandu-testing/rules/test-slot-unit.md +192 -192
package/src/resources/skills/mandu-ui/SKILL.md +117 -117
package/src/resources/skills/mandu-ui/_sections.md +23 -23
package/src/resources/skills/mandu-ui/_template.md +32 -32
package/src/resources/skills/mandu-ui/metadata.json +13 -13
package/src/resources/skills/mandu-ui/rules/ui-accessibility-aria.md +232 -232
package/src/resources/skills/mandu-ui/rules/ui-accessibility-focus.md +238 -238
package/src/resources/skills/mandu-ui/rules/ui-composition-patterns.md +259 -259
package/src/resources/skills/mandu-ui/rules/ui-island-integration.md +258 -258
package/src/resources/skills/mandu-ui/rules/ui-radix-patterns.md +213 -213
package/src/resources/skills/mandu-ui/rules/ui-shadcn-setup.md +209 -209
package/src/resources/skills/recipes.ts +932 -932
package/src/tools/ate.ts +219 -0
package/src/tools/index.ts +4 -1
package/src/tools/project.ts +334 -334
package/src/tools/runtime.ts +497 -497
package/src/tools/seo.ts +417 -417
package/src/utils/withWarnings.ts +83 -83

package/src/resources/skills/mandu-styling/rules/style-perf-critical.md CHANGED Viewed

@@ -1,209 +1,209 @@
----
-title: Critical CSS Extraction
-impact: MEDIUM
-impactDescription: Improves First Contentful Paint
-tags: styling, performance, critical, fcp
----
-## Critical CSS Extraction
-**Impact: MEDIUM (Improves First Contentful Paint)**
-초기 렌더링에 필요한 CSS만 인라인으로 포함하여 FCP를 개선하세요.
-## Tailwind의 자동 최적화
-Tailwind CSS는 JIT 컴파일로 사용된 클래스만 생성합니다.
-```typescript
-// tailwind.config.ts
-export default {
-  content: [
-    "./app/**/*.{ts,tsx}",  // 실제 사용되는 파일만 스캔
-  ],
-  // ...
-};
-```
-## Above-the-fold CSS 분리
-```tsx
-// app/layout.tsx
-export default function RootLayout({ children }) {
-  return (
-    <html>
-      <head>
-        {/* Critical CSS: 인라인 */}
-        <style
-          dangerouslySetInnerHTML={{
-            __html: `
-              /* Above-the-fold 스타일만 */
-              body { margin: 0; font-family: system-ui; }
-              .header { height: 64px; background: white; }
-              .hero { min-height: 50vh; }
-            `,
-          }}
-        />
-        {/* Non-critical CSS: 비동기 로드 */}
-        <link
-          rel="preload"
-          href="/styles/main.css"
-          as="style"
-          onLoad="this.onload=null;this.rel='stylesheet'"
-        />
-        <noscript>
-          <link rel="stylesheet" href="/styles/main.css" />
-        </noscript>
-      </head>
-      <body>{children}</body>
-    </html>
-  );
-}
-```
-## Lightning CSS 통합
-```bash
-bun add -d lightningcss
-```
-```typescript
-// scripts/build-css.ts
-import { transform, browserslistToTargets } from "lightningcss";
-import browserslist from "browserslist";
-const targets = browserslistToTargets(browserslist(">= 0.25%"));
-const css = await Bun.file("app/globals.css").text();
-const { code } = transform({
-  filename: "globals.css",
-  code: Buffer.from(css),
-  minify: true,
-  targets,
-  // Critical CSS 추출
-  analyzeDependencies: true,
-});
-await Bun.write("dist/styles.css", code);
-```
-## PostCSS 설정
-```javascript
-// postcss.config.js
-export default {
-  plugins: {
-    tailwindcss: {},
-    autoprefixer: {},
-    ...(process.env.NODE_ENV === "production"
-      ? {
-          cssnano: {
-            preset: [
-              "default",
-              {
-                discardComments: { removeAll: true },
-              },
-            ],
-          },
-        }
-      : {}),
-  },
-};
-```
-## CSS Layer 우선순위
-```css
-/* globals.css */
-@layer reset, base, components, utilities;
-/* Critical: reset과 base만 인라인 */
-@layer reset {
-  *,
-  *::before,
-  *::after {
-    box-sizing: border-box;
-  }
-}
-@layer base {
-  body {
-    @apply bg-background text-foreground;
-  }
-}
-/* Non-critical: 별도 파일 */
-@layer components {
-  /* ... */
-}
-@layer utilities {
-  /* ... */
-}
-```
-## Font 최적화
-```tsx
-// 폰트 preload로 FOIT/FOUT 방지
-<link
-  rel="preload"
-  href="/fonts/inter-var.woff2"
-  as="font"
-  type="font/woff2"
-  crossOrigin="anonymous"
-/>
-// 폰트 display 설정
-<style>
-  {`
-    @font-face {
-      font-family: 'Inter';
-      src: url('/fonts/inter-var.woff2') format('woff2');
-      font-display: swap;
-    }
-  `}
-</style>
-```
-## 성능 측정
-```typescript
-// 빌드 후 CSS 크기 확인
-import { gzipSync } from "bun";
-const css = await Bun.file("dist/styles.css").text();
-const gzipped = gzipSync(Buffer.from(css));
-console.log("CSS size:", css.length, "bytes");
-console.log("Gzipped:", gzipped.length, "bytes");
-// 목표: < 14KB (TCP 첫 라운드트립)
-```
-## Inline Critical + Lazy Load 패턴
-```tsx
-// components/StyleLoader.tsx
-"use client";
-import { useEffect } from "react";
-export function StyleLoader({ href }: { href: string }) {
-  useEffect(() => {
-    const link = document.createElement("link");
-    link.rel = "stylesheet";
-    link.href = href;
-    document.head.appendChild(link);
-  }, [href]);
-  return null;
-}
-// 사용
-<StyleLoader href="/styles/non-critical.css" />
-```
-Reference: [web.dev Critical CSS](https://web.dev/articles/extract-critical-css)
+---
+title: Critical CSS Extraction
+impact: MEDIUM
+impactDescription: Improves First Contentful Paint
+tags: styling, performance, critical, fcp
+---
+## Critical CSS Extraction
+**Impact: MEDIUM (Improves First Contentful Paint)**
+초기 렌더링에 필요한 CSS만 인라인으로 포함하여 FCP를 개선하세요.
+## Tailwind의 자동 최적화
+Tailwind CSS는 JIT 컴파일로 사용된 클래스만 생성합니다.
+```typescript
+// tailwind.config.ts
+export default {
+  content: [
+    "./app/**/*.{ts,tsx}",  // 실제 사용되는 파일만 스캔
+  ],
+  // ...
+};
+```
+## Above-the-fold CSS 분리
+```tsx
+// app/layout.tsx
+export default function RootLayout({ children }) {
+  return (
+    <html>
+      <head>
+        {/* Critical CSS: 인라인 */}
+        <style
+          dangerouslySetInnerHTML={{
+            __html: `
+              /* Above-the-fold 스타일만 */
+              body { margin: 0; font-family: system-ui; }
+              .header { height: 64px; background: white; }
+              .hero { min-height: 50vh; }
+            `,
+          }}
+        />
+        {/* Non-critical CSS: 비동기 로드 */}
+        <link
+          rel="preload"
+          href="/styles/main.css"
+          as="style"
+          onLoad="this.onload=null;this.rel='stylesheet'"
+        />
+        <noscript>
+          <link rel="stylesheet" href="/styles/main.css" />
+        </noscript>
+      </head>
+      <body>{children}</body>
+    </html>
+  );
+}
+```
+## Lightning CSS 통합
+```bash
+bun add -d lightningcss
+```
+```typescript
+// scripts/build-css.ts
+import { transform, browserslistToTargets } from "lightningcss";
+import browserslist from "browserslist";
+const targets = browserslistToTargets(browserslist(">= 0.25%"));
+const css = await Bun.file("app/globals.css").text();
+const { code } = transform({
+  filename: "globals.css",
+  code: Buffer.from(css),
+  minify: true,
+  targets,
+  // Critical CSS 추출
+  analyzeDependencies: true,
+});
+await Bun.write("dist/styles.css", code);
+```
+## PostCSS 설정
+```javascript
+// postcss.config.js
+export default {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+    ...(process.env.NODE_ENV === "production"
+      ? {
+          cssnano: {
+            preset: [
+              "default",
+              {
+                discardComments: { removeAll: true },
+              },
+            ],
+          },
+        }
+      : {}),
+  },
+};
+```
+## CSS Layer 우선순위
+```css
+/* globals.css */
+@layer reset, base, components, utilities;
+/* Critical: reset과 base만 인라인 */
+@layer reset {
+  *,
+  *::before,
+  *::after {
+    box-sizing: border-box;
+  }
+}
+@layer base {
+  body {
+    @apply bg-background text-foreground;
+  }
+}
+/* Non-critical: 별도 파일 */
+@layer components {
+  /* ... */
+}
+@layer utilities {
+  /* ... */
+}
+```
+## Font 최적화
+```tsx
+// 폰트 preload로 FOIT/FOUT 방지
+<link
+  rel="preload"
+  href="/fonts/inter-var.woff2"
+  as="font"
+  type="font/woff2"
+  crossOrigin="anonymous"
+/>
+// 폰트 display 설정
+<style>
+  {`
+    @font-face {
+      font-family: 'Inter';
+      src: url('/fonts/inter-var.woff2') format('woff2');
+      font-display: swap;
+    }
+  `}
+</style>
+```
+## 성능 측정
+```typescript
+// 빌드 후 CSS 크기 확인
+import { gzipSync } from "bun";
+const css = await Bun.file("dist/styles.css").text();
+const gzipped = gzipSync(Buffer.from(css));
+console.log("CSS size:", css.length, "bytes");
+console.log("Gzipped:", gzipped.length, "bytes");
+// 목표: < 14KB (TCP 첫 라운드트립)
+```
+## Inline Critical + Lazy Load 패턴
+```tsx
+// components/StyleLoader.tsx
+"use client";
+import { useEffect } from "react";
+export function StyleLoader({ href }: { href: string }) {
+  useEffect(() => {
+    const link = document.createElement("link");
+    link.rel = "stylesheet";
+    link.href = href;
+    document.head.appendChild(link);
+  }, [href]);
+  return null;
+}
+// 사용
+<StyleLoader href="/styles/non-critical.css" />
+```
+Reference: [web.dev Critical CSS](https://web.dev/articles/extract-critical-css)