@mandujs/mcp 0.13.0 → 0.17.0

package/src/resources/skills/index.ts

@@ -1,12 +1,12 @@
-export { GUIDES, getGuide, listGuides, type GuideId } from "./guides.js";
-export { RECIPES, getRecipe, listRecipes, type RecipeId } from "./recipes.js";
-
-// Agent Skills pattern
-export {
-  listSkills,
-  getSkill,
-  listSkillRules,
-  getSkillRule,
-  type SkillMeta,
-  type RuleMeta,
-} from "./loader.js";
+export { GUIDES, getGuide, listGuides, type GuideId } from "./guides.js";
+export { RECIPES, getRecipe, listRecipes, type RecipeId } from "./recipes.js";
+
+// Agent Skills pattern
+export {
+  listSkills,
+  getSkill,
+  listSkillRules,
+  getSkillRule,
+  type SkillMeta,
+  type RuleMeta,
+} from "./loader.js";

package/src/resources/skills/loader.ts

@@ -1,218 +1,218 @@
-/**
- * Mandu MCP Skills - File-based Skill Loader
- * Agent Skills 패턴으로 구성된 스킬을 파일 시스템에서 로드
- */
-
-import { readdir, readFile } from "fs/promises";
-import { join, dirname } from "path";
-import { fileURLToPath } from "url";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-export interface SkillMeta {
-  id: string;
-  name: string;
-  description: string;
-  version: string;
-  author: string;
-}
-
-export interface RuleMeta {
-  id: string;
-  title: string;
-  impact: "CRITICAL" | "HIGH" | "MEDIUM" | "LOW";
-  impactDescription: string;
-  tags: string[];
-}
-
-// Available skills
-const SKILL_IDS = [
-  "mandu-slot",
-  "mandu-fs-routes",
-  "mandu-hydration",
-  "mandu-guard",
-  "mandu-performance",
-  "mandu-composition",
-  "mandu-security",
-  "mandu-testing",
-  "mandu-deployment",
-  "mandu-styling",
-  "mandu-ui",
-];
-
-/**
- * Parse YAML frontmatter from markdown content
- */
-function parseFrontmatter(content: string): { frontmatter: Record<string, unknown>; body: string } {
-  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/);
-  if (!match) {
-    return { frontmatter: {}, body: content };
-  }
-
-  const [, yamlStr, body] = match;
-  const frontmatter: Record<string, unknown> = {};
-
-  // Simple YAML parsing (key: value pairs)
-  for (const line of yamlStr.split("\n")) {
-    const colonIndex = line.indexOf(":");
-    if (colonIndex > 0) {
-      const key = line.slice(0, colonIndex).trim();
-      let value: unknown = line.slice(colonIndex + 1).trim();
-
-      // Handle multiline values (description with |)
-      if (value === "|") {
-        continue; // Will be captured in subsequent lines
-      }
-
-      // Parse arrays (tags)
-      if (typeof value === "string" && value.includes(",")) {
-        value = value.split(",").map((s) => s.trim());
-      }
-
-      frontmatter[key] = value;
-    }
-  }
-
-  return { frontmatter, body };
-}
-
-/**
- * List all available skills
- */
-export function listSkills(): SkillMeta[] {
-  return SKILL_IDS.map((id) => {
-    const name = id.replace("mandu-", "");
-    return {
-      id,
-      name,
-      description: getSkillDescription(id),
-      version: "1.0.0",
-      author: "mandu",
-    };
-  });
-}
-
-function getSkillDescription(id: string): string {
-  const descriptions: Record<string, string> = {
-    "mandu-slot": "Business logic with Mandu.filling() API",
-    "mandu-fs-routes": "File-system based routing patterns",
-    "mandu-hydration": "Island hydration and client components",
-    "mandu-guard": "Architecture enforcement and layer dependencies",
-    "mandu-performance": "Performance optimization patterns for Mandu apps",
-    "mandu-composition": "React composition patterns for Islands and state",
-    "mandu-security": "Security best practices for authentication and protection",
-    "mandu-testing": "Testing patterns with Bun test and Playwright",
-    "mandu-deployment": "Production deployment with Render, Supabase, Docker, and CI/CD",
-    "mandu-styling": "CSS framework integration with Tailwind, Panda CSS, and theming",
-    "mandu-ui": "UI component library integration with shadcn/ui and accessibility",
-  };
-  return descriptions[id] || "";
-}
-
-/**
- * Get a skill's SKILL.md content
- */
-export async function getSkill(skillId: string): Promise<{ meta: SkillMeta; content: string } | null> {
-  if (!SKILL_IDS.includes(skillId)) {
-    return null;
-  }
-
-  const skillPath = join(__dirname, skillId, "SKILL.md");
-
-  try {
-    const content = await readFile(skillPath, "utf-8");
-    const { frontmatter, body } = parseFrontmatter(content);
-
-    return {
-      meta: {
-        id: skillId,
-        name: (frontmatter.name as string) || skillId,
-        description: (frontmatter.description as string) || "",
-        version: ((frontmatter.metadata as Record<string, string>)?.version as string) || "1.0.0",
-        author: ((frontmatter.metadata as Record<string, string>)?.author as string) || "mandu",
-      },
-      content: body,
-    };
-  } catch {
-    return null;
-  }
-}
-
-/**
- * List rules for a skill
- */
-export async function listSkillRules(skillId: string): Promise<RuleMeta[]> {
-  if (!SKILL_IDS.includes(skillId)) {
-    return [];
-  }
-
-  const rulesPath = join(__dirname, skillId, "rules");
-
-  try {
-    const files = await readdir(rulesPath);
-    const rules: RuleMeta[] = [];
-
-    for (const file of files) {
-      if (!file.endsWith(".md")) continue;
-
-      const ruleId = file.replace(".md", "");
-      const content = await readFile(join(rulesPath, file), "utf-8");
-      const { frontmatter } = parseFrontmatter(content);
-
-      rules.push({
-        id: ruleId,
-        title: (frontmatter.title as string) || ruleId,
-        impact: (frontmatter.impact as RuleMeta["impact"]) || "MEDIUM",
-        impactDescription: (frontmatter.impactDescription as string) || "",
-        tags: Array.isArray(frontmatter.tags)
-          ? (frontmatter.tags as string[])
-          : typeof frontmatter.tags === "string"
-            ? frontmatter.tags.split(",").map((s: string) => s.trim())
-            : [],
-      });
-    }
-
-    // Sort by impact priority
-    const impactOrder = { CRITICAL: 0, HIGH: 1, MEDIUM: 2, LOW: 3 };
-    return rules.sort((a, b) => impactOrder[a.impact] - impactOrder[b.impact]);
-  } catch {
-    return [];
-  }
-}
-
-/**
- * Get a specific rule's content
- */
-export async function getSkillRule(
-  skillId: string,
-  ruleId: string
-): Promise<{ meta: RuleMeta; content: string } | null> {
-  if (!SKILL_IDS.includes(skillId)) {
-    return null;
-  }
-
-  const rulePath = join(__dirname, skillId, "rules", `${ruleId}.md`);
-
-  try {
-    const content = await readFile(rulePath, "utf-8");
-    const { frontmatter, body } = parseFrontmatter(content);
-
-    return {
-      meta: {
-        id: ruleId,
-        title: (frontmatter.title as string) || ruleId,
-        impact: (frontmatter.impact as RuleMeta["impact"]) || "MEDIUM",
-        impactDescription: (frontmatter.impactDescription as string) || "",
-        tags: Array.isArray(frontmatter.tags)
-          ? (frontmatter.tags as string[])
-          : typeof frontmatter.tags === "string"
-            ? frontmatter.tags.split(",").map((s: string) => s.trim())
-            : [],
-      },
-      content: body,
-    };
-  } catch {
-    return null;
-  }
-}
+/**
+ * Mandu MCP Skills - File-based Skill Loader
+ * Agent Skills 패턴으로 구성된 스킬을 파일 시스템에서 로드
+ */
+
+import { readdir, readFile } from "fs/promises";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+export interface SkillMeta {
+  id: string;
+  name: string;
+  description: string;
+  version: string;
+  author: string;
+}
+
+export interface RuleMeta {
+  id: string;
+  title: string;
+  impact: "CRITICAL" | "HIGH" | "MEDIUM" | "LOW";
+  impactDescription: string;
+  tags: string[];
+}
+
+// Available skills
+const SKILL_IDS = [
+  "mandu-slot",
+  "mandu-fs-routes",
+  "mandu-hydration",
+  "mandu-guard",
+  "mandu-performance",
+  "mandu-composition",
+  "mandu-security",
+  "mandu-testing",
+  "mandu-deployment",
+  "mandu-styling",
+  "mandu-ui",
+];
+
+/**
+ * Parse YAML frontmatter from markdown content
+ */
+function parseFrontmatter(content: string): { frontmatter: Record<string, unknown>; body: string } {
+  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/);
+  if (!match) {
+    return { frontmatter: {}, body: content };
+  }
+
+  const [, yamlStr, body] = match;
+  const frontmatter: Record<string, unknown> = {};
+
+  // Simple YAML parsing (key: value pairs)
+  for (const line of yamlStr.split("\n")) {
+    const colonIndex = line.indexOf(":");
+    if (colonIndex > 0) {
+      const key = line.slice(0, colonIndex).trim();
+      let value: unknown = line.slice(colonIndex + 1).trim();
+
+      // Handle multiline values (description with |)
+      if (value === "|") {
+        continue; // Will be captured in subsequent lines
+      }
+
+      // Parse arrays (tags)
+      if (typeof value === "string" && value.includes(",")) {
+        value = value.split(",").map((s) => s.trim());
+      }
+
+      frontmatter[key] = value;
+    }
+  }
+
+  return { frontmatter, body };
+}
+
+/**
+ * List all available skills
+ */
+export function listSkills(): SkillMeta[] {
+  return SKILL_IDS.map((id) => {
+    const name = id.replace("mandu-", "");
+    return {
+      id,
+      name,
+      description: getSkillDescription(id),
+      version: "1.0.0",
+      author: "mandu",
+    };
+  });
+}
+
+function getSkillDescription(id: string): string {
+  const descriptions: Record<string, string> = {
+    "mandu-slot": "Business logic with Mandu.filling() API",
+    "mandu-fs-routes": "File-system based routing patterns",
+    "mandu-hydration": "Island hydration and client components",
+    "mandu-guard": "Architecture enforcement and layer dependencies",
+    "mandu-performance": "Performance optimization patterns for Mandu apps",
+    "mandu-composition": "React composition patterns for Islands and state",
+    "mandu-security": "Security best practices for authentication and protection",
+    "mandu-testing": "Testing patterns with Bun test and Playwright",
+    "mandu-deployment": "Production deployment with Render, Supabase, Docker, and CI/CD",
+    "mandu-styling": "CSS framework integration with Tailwind, Panda CSS, and theming",
+    "mandu-ui": "UI component library integration with shadcn/ui and accessibility",
+  };
+  return descriptions[id] || "";
+}
+
+/**
+ * Get a skill's SKILL.md content
+ */
+export async function getSkill(skillId: string): Promise<{ meta: SkillMeta; content: string } | null> {
+  if (!SKILL_IDS.includes(skillId)) {
+    return null;
+  }
+
+  const skillPath = join(__dirname, skillId, "SKILL.md");
+
+  try {
+    const content = await readFile(skillPath, "utf-8");
+    const { frontmatter, body } = parseFrontmatter(content);
+
+    return {
+      meta: {
+        id: skillId,
+        name: (frontmatter.name as string) || skillId,
+        description: (frontmatter.description as string) || "",
+        version: ((frontmatter.metadata as Record<string, string>)?.version as string) || "1.0.0",
+        author: ((frontmatter.metadata as Record<string, string>)?.author as string) || "mandu",
+      },
+      content: body,
+    };
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * List rules for a skill
+ */
+export async function listSkillRules(skillId: string): Promise<RuleMeta[]> {
+  if (!SKILL_IDS.includes(skillId)) {
+    return [];
+  }
+
+  const rulesPath = join(__dirname, skillId, "rules");
+
+  try {
+    const files = await readdir(rulesPath);
+    const rules: RuleMeta[] = [];
+
+    for (const file of files) {
+      if (!file.endsWith(".md")) continue;
+
+      const ruleId = file.replace(".md", "");
+      const content = await readFile(join(rulesPath, file), "utf-8");
+      const { frontmatter } = parseFrontmatter(content);
+
+      rules.push({
+        id: ruleId,
+        title: (frontmatter.title as string) || ruleId,
+        impact: (frontmatter.impact as RuleMeta["impact"]) || "MEDIUM",
+        impactDescription: (frontmatter.impactDescription as string) || "",
+        tags: Array.isArray(frontmatter.tags)
+          ? (frontmatter.tags as string[])
+          : typeof frontmatter.tags === "string"
+            ? frontmatter.tags.split(",").map((s: string) => s.trim())
+            : [],
+      });
+    }
+
+    // Sort by impact priority
+    const impactOrder = { CRITICAL: 0, HIGH: 1, MEDIUM: 2, LOW: 3 };
+    return rules.sort((a, b) => impactOrder[a.impact] - impactOrder[b.impact]);
+  } catch {
+    return [];
+  }
+}
+
+/**
+ * Get a specific rule's content
+ */
+export async function getSkillRule(
+  skillId: string,
+  ruleId: string
+): Promise<{ meta: RuleMeta; content: string } | null> {
+  if (!SKILL_IDS.includes(skillId)) {
+    return null;
+  }
+
+  const rulePath = join(__dirname, skillId, "rules", `${ruleId}.md`);
+
+  try {
+    const content = await readFile(rulePath, "utf-8");
+    const { frontmatter, body } = parseFrontmatter(content);
+
+    return {
+      meta: {
+        id: ruleId,
+        title: (frontmatter.title as string) || ruleId,
+        impact: (frontmatter.impact as RuleMeta["impact"]) || "MEDIUM",
+        impactDescription: (frontmatter.impactDescription as string) || "",
+        tags: Array.isArray(frontmatter.tags)
+          ? (frontmatter.tags as string[])
+          : typeof frontmatter.tags === "string"
+            ? frontmatter.tags.split(",").map((s: string) => s.trim())
+            : [],
+      },
+      content: body,
+    };
+  } catch {
+    return null;
+  }
+}

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

@@ -1,91 +1,91 @@
----
-name: mandu-composition
-description: |
-  React composition patterns for Mandu applications. Use when designing
-  Island components, managing shared state, or building reusable component
-  APIs. Triggers on compound components, context providers, boolean props,
-  or component architecture tasks.
-license: MIT
-metadata:
-  author: mandu
-  version: "1.0.0"
----
-
-# Mandu Composition
-
-Mandu 애플리케이션을 위한 React 컴포지션 패턴 가이드. Island 컴파운드 컴포넌트, 상태 관리 인터페이스, Provider 패턴, slot-client 분리를 다룹니다. Vercel의 Composition Patterns를 Mandu 컨텍스트로 변환하여 적용합니다.
-
-## When to Apply
-
-Reference these guidelines when:
-- Designing Island component architecture
-- Managing shared state between Islands
-- Building reusable component APIs
-- Refactoring components with boolean prop proliferation
-- Working with compound components or context providers
-
-## Rule Categories by Priority
-
-| Priority | Category | Impact | Prefix |
-|----------|----------|--------|--------|
-| 1 | Component Architecture | HIGH | `comp-arch-` |
-| 2 | State Management | HIGH | `comp-state-` |
-| 3 | Island Patterns | MEDIUM | `comp-island-` |
-| 4 | Implementation Patterns | MEDIUM | `comp-pattern-` |
-
-## Quick Reference
-
-### 1. Component Architecture (HIGH)
-
-- `comp-arch-avoid-boolean-props` - Use composition instead of boolean customization
-- `comp-arch-compound-components` - Structure Islands as compound components
-- `comp-arch-explicit-variants` - Create explicit variant components
-
-### 2. State Management (HIGH)
-
-- `comp-state-context-interface` - Define generic state/actions/meta interface
-- `comp-state-lift-state` - Move state into provider for sibling access
-- `comp-state-decouple-impl` - Provider is the only place knowing implementation
-
-### 3. Island Patterns (MEDIUM)
-
-- `comp-island-compound` - Compose Islands with shared context
-- `comp-island-event` - Communicate between Islands with useIslandEvent
-- `comp-island-slot-split` - Separate server logic (slot) from client (Island)
-
-### 4. Implementation Patterns (MEDIUM)
-
-- `comp-pattern-children` - Use children for composition over render props
-- `comp-pattern-provider-boundary` - Understand provider boundary vs visual nesting
-
-## Core Principle
-
-**Lift state, compose internals, make state dependency-injectable.**
-
-```
-┌─────────────────────────────────────────┐
-│  Provider (state + actions + meta)      │
-│  ┌───────────────────────────────────┐  │
-│  │  Composer.Frame                   │  │
-│  │  ┌─────────┐ ┌─────────────────┐  │  │
-│  │  │ Input   │ │ Footer          │  │  │
-│  │  └─────────┘ │ ┌─────┐ ┌─────┐ │  │  │
-│  │              │ │Emoji│ │Send │ │  │  │
-│  │              │ └─────┘ └─────┘ │  │  │
-│  │              └─────────────────┘  │  │
-│  └───────────────────────────────────┘  │
-│  ┌───────────────┐  ← Outside Frame     │
-│  │ Preview       │     but inside       │
-│  └───────────────┘     Provider!        │
-└─────────────────────────────────────────┘
-```
-
-## How to Use
-
-Read individual rule files for detailed explanations:
-
-```
-rules/comp-arch-compound-components.md
-rules/comp-state-context-interface.md
-rules/comp-island-event.md
-```
+---
+name: mandu-composition
+description: |
+  React composition patterns for Mandu applications. Use when designing
+  Island components, managing shared state, or building reusable component
+  APIs. Triggers on compound components, context providers, boolean props,
+  or component architecture tasks.
+license: MIT
+metadata:
+  author: mandu
+  version: "1.0.0"
+---
+
+# Mandu Composition
+
+Mandu 애플리케이션을 위한 React 컴포지션 패턴 가이드. Island 컴파운드 컴포넌트, 상태 관리 인터페이스, Provider 패턴, slot-client 분리를 다룹니다. Vercel의 Composition Patterns를 Mandu 컨텍스트로 변환하여 적용합니다.
+
+## When to Apply
+
+Reference these guidelines when:
+- Designing Island component architecture
+- Managing shared state between Islands
+- Building reusable component APIs
+- Refactoring components with boolean prop proliferation
+- Working with compound components or context providers
+
+## Rule Categories by Priority
+
+| Priority | Category | Impact | Prefix |
+|----------|----------|--------|--------|
+| 1 | Component Architecture | HIGH | `comp-arch-` |
+| 2 | State Management | HIGH | `comp-state-` |
+| 3 | Island Patterns | MEDIUM | `comp-island-` |
+| 4 | Implementation Patterns | MEDIUM | `comp-pattern-` |
+
+## Quick Reference
+
+### 1. Component Architecture (HIGH)
+
+- `comp-arch-avoid-boolean-props` - Use composition instead of boolean customization
+- `comp-arch-compound-components` - Structure Islands as compound components
+- `comp-arch-explicit-variants` - Create explicit variant components
+
+### 2. State Management (HIGH)
+
+- `comp-state-context-interface` - Define generic state/actions/meta interface
+- `comp-state-lift-state` - Move state into provider for sibling access
+- `comp-state-decouple-impl` - Provider is the only place knowing implementation
+
+### 3. Island Patterns (MEDIUM)
+
+- `comp-island-compound` - Compose Islands with shared context
+- `comp-island-event` - Communicate between Islands with useIslandEvent
+- `comp-island-slot-split` - Separate server logic (slot) from client (Island)
+
+### 4. Implementation Patterns (MEDIUM)
+
+- `comp-pattern-children` - Use children for composition over render props
+- `comp-pattern-provider-boundary` - Understand provider boundary vs visual nesting
+
+## Core Principle
+
+**Lift state, compose internals, make state dependency-injectable.**
+
+```
+┌─────────────────────────────────────────┐
+│  Provider (state + actions + meta)      │
+│  ┌───────────────────────────────────┐  │
+│  │  Composer.Frame                   │  │
+│  │  ┌─────────┐ ┌─────────────────┐  │  │
+│  │  │ Input   │ │ Footer          │  │  │
+│  │  └─────────┘ │ ┌─────┐ ┌─────┐ │  │  │
+│  │              │ │Emoji│ │Send │ │  │  │
+│  │              │ └─────┘ └─────┘ │  │  │
+│  │              └─────────────────┘  │  │
+│  └───────────────────────────────────┘  │
+│  ┌───────────────┐  ← Outside Frame     │
+│  │ Preview       │     but inside       │
+│  └───────────────┘     Provider!        │
+└─────────────────────────────────────────┘
+```
+
+## How to Use
+
+Read individual rule files for detailed explanations:
+
+```
+rules/comp-arch-compound-components.md
+rules/comp-state-context-interface.md
+rules/comp-island-event.md
+```