@monoharada/wcf-mcp 0.6.0 → 0.8.0

package/README.md

@@ -78,7 +78,7 @@ claude mcp add wcf -- npx @monoharada/wcf-mcp
 }
 ```
 
-## 提供機能（16 tools + 1 prompt + 4 resources）
+## 提供機能（19 tools + 1 prompt + 4 resources）
 
 ### ガードレール
 
@@ -145,6 +145,17 @@ claude mcp add wcf -- npx @monoharada/wcf-mcp
 | `get_accessibility_docs` | component/topic/wcagLevel で A11y チェックリストとガイドライン要点を検索（`topic=all` では両ソースを混在返却） |
 | `search_guidelines` | ガイドライン（topic/query）をスコア付きで検索 |
 
+### スキル管理（リポジトリ内専用）
+
+| ツール | 説明 |
+|--------|------|
+| `list_skills` | 登録済みデザインシステムスキル一覧を取得 |
+| `get_skill_manifest` | スキルの SKILL.md マニフェストを取得 |
+| `check_drift` | スキルレジストリとリポジトリの整合性を検証 |
+
+> **注意**: これらのツールはリポジトリ内でのみ有効です。npx 実行時は `SKILLS_REGISTRY_UNAVAILABLE` エラーを返します。
+> 有効化には `wcf-mcp.config.json` で `design-system-skills` プラグインを設定してください（下記参照）。
+
 #### `get_design_tokens` の使用例
 
 **リクエスト:**
@@ -328,7 +339,7 @@ npx @monoharada/wcf-mcp --transport=http --port=3100
 ※ `./plugins/custom-validation-plugin.mjs` は利用側プロジェクトに配置してください。  
 このリポジトリには参照用として `packages/mcp-server/examples/plugins/custom-validation-plugin.mjs` を同梱しています。
 
-### plugin 契約（v1）
+### plugin 契約（v1.1）
 
 詳細仕様: [docs/plugin-contract-v1.md](../../docs/plugin-contract-v1.md)
 
@@ -381,6 +392,21 @@ Claude Desktop 設定例:
 prefix: "myui" → dads-button → myui-button
 ```
 
+## v0.8.0 新機能
+
+### 新ツール（スキル管理）
+- **`list_skills`** — 登録済みデザインシステムスキルの一覧を取得
+- **`get_skill_manifest`** — スキルの SKILL.md マニフェスト内容を取得
+- **`check_drift`** — スキルレジストリとリポジトリの整合性を検証（ドリフト検出）
+
+### 改善
+- **Plugin 契約 v1.1** — module plugin の `dataSources` パス解決をモジュールディレクトリ基準に統一
+- **Skills Registry plugin** — `plugins/design-system-skills/` として同梱。`wcf-mcp.config.json` で有効化
+
+> スキル管理ツールはリポジトリ内でのみ動作します。npx 実行時は graceful に `SKILLS_REGISTRY_UNAVAILABLE` を返します。
+
+---
+
 ## v0.4.0 新機能
 
 ### 新ツール
@@ -642,6 +668,8 @@ packages/mcp-server/
 ├── server.mjs       # MCP サーバー本体
 ├── validator.mjs    # HTML バリデーター
 ├── package.json     # npm パッケージ定義
+├── plugins/         # 同梱プラグイン
+│   └── design-system-skills/  # スキル管理ツール (list_skills, get_skill_manifest, check_drift)
 └── data/            # バンドルデータ (npm run mcp:build で生成)
     ├── custom-elements.json
     ├── install-registry.json

package/core.mjs

@@ -17,8 +17,25 @@ export const CANONICAL_PREFIX = 'dads';
 export const MAX_PREFIX_LENGTH = 64;
 export const STRUCTURED_CONTENT_DISABLE_FLAG = 'WCF_MCP_DISABLE_STRUCTURED_CONTENT';
 export const MAX_TOOL_RESULT_BYTES = 100 * 1024;
-export const PLUGIN_TOOL_NOTICE = 'Plugin tool (contract v1).';
-export const PLUGIN_CONTRACT_VERSION = '1.0.0';
+export const PLUGIN_TOOL_NOTICE = 'Plugin tool (contract v1.1).';
+export const PLUGIN_CONTRACT_VERSION = '1.1.0';
+
+/**
+ * Convert a plugin tool's inputSchema to a passthrough Zod schema.
+ * Handles three cases:
+ *  - Already a Zod schema instance (has _def or _zod) → apply .passthrough()
+ *  - Plain object (raw shape map) → wrap with z.object().passthrough()
+ *  - Falsy / empty → z.object({}).passthrough()
+ */
+function toPassthroughSchema(schema) {
+  if (schema && (schema._def || schema._zod)) {
+    // Already a Zod schema — apply passthrough if it's an object type
+    return typeof schema.passthrough === 'function'
+      ? schema.passthrough()
+      : schema;
+  }
+  return z.object(schema ?? {}).passthrough();
+}
 
 export const CATEGORY_MAP = {
   'dads-input-text': 'Form',
@@ -722,7 +739,7 @@ function toPluginErrorMessage(name, reason) {
  *   name: string,
  *   description?: string,
  *   inputSchema?: Record<string, unknown>,
- *   handler?: (args: Record<string, unknown>, context: { plugin: { name: string, version: string }, helpers: { loadJsonData: Function } }) => unknown,
+ *   handler?: (args: Record<string, unknown>, context: { plugin: { name: string, version: string }, helpers: { loadJsonData: Function, loadTextData: Function } }) => unknown,
  *   staticPayload?: unknown,
  * }} WcfMcpPluginTool
  */
@@ -1132,6 +1149,20 @@ export function serializeApi(decl, modulePath, prefix) {
   };
 }
 
+/**
+ * Generic fallback values for common attributes when CEM default is missing.
+ * Attribute-name-based (not component-specific). `type` is excluded to avoid
+ * conflicts between button (type="button") and input (type="text").
+ * `variant` is also excluded — its valid values differ per component,
+ * so the first enum value is used instead (see generateSnippet).
+ */
+const SNIPPET_FALLBACK_VALUES = {
+  label: 'ラベル',
+  name: 'field1',
+  value: 'サンプル値',
+  'support-text': '説明テキスト',
+};
+
 export function generateSnippet(api, prefix) {
   // Use custom snippet if injected by CEM plugin (e.g. data-* driven components)
   const customSnippet = api.custom?.usageSnippet;
@@ -1174,7 +1205,28 @@ export function generateSnippet(api, prefix) {
     if (isBoolean) {
       lines.push(`  ${name}`);
     } else {
-      const defaultVal = typeof a.default === 'string' ? a.default.replace(/^['"]|['"]$/g, '') : '';
+      let defaultVal;
+      if (typeof a.default === 'string') {
+        defaultVal = a.default.replace(/^['"]|['"]$/g, '');
+      } else if (SNIPPET_FALLBACK_VALUES[name] !== undefined) {
+        defaultVal = SNIPPET_FALLBACK_VALUES[name];
+      } else {
+        // For enum types, use the first enum value as fallback
+        const enumMatch = t.match(/^'([^']+)'/);
+        if (enumMatch) {
+          defaultVal = enumMatch[1];
+        } else {
+          // Fallback: extract first value from description pattern like "(solid | outlined | text)"
+          const desc = String(a.description ?? '');
+          const descEnum = desc.match(/\(([^)]+)\)/);
+          if (descEnum) {
+            const first = descEnum[1].split(/\s*[|｜]\s*/)[0]?.trim();
+            defaultVal = first || '';
+          } else {
+            defaultVal = '';
+          }
+        }
+      }
       lines.push(`  ${name}="${defaultVal}"`);
     }
     if (lines.length >= 4) break;
@@ -1264,7 +1316,36 @@ export function resolveComponentClosure({ installRegistry }, componentIds) {
   return [...out];
 }
 
-export function buildComponentSummaries(indexes, { category, query, limit, offset, prefix } = {}) {
+/**
+ * Build a frequency map: componentId → count of patterns that require it.
+ * Counts from pattern-registry.json `requires` arrays only.
+ */
+export function buildPatternFrequencyMap(patterns) {
+  const freq = new Map();
+  if (!patterns || typeof patterns !== 'object') return freq;
+  for (const pat of Object.values(patterns)) {
+    const requires = Array.isArray(pat?.requires) ? pat.requires : [];
+    for (const id of requires) {
+      const key = String(id ?? '').trim();
+      if (key) freq.set(key, (freq.get(key) ?? 0) + 1);
+    }
+  }
+  return freq;
+}
+
+/**
+ * Convert a tag from the current prefix to canonical prefix using string ops
+ * (no regex, safe for arbitrary prefix values).
+ */
+function toCanonicalTag(tag, currentPrefix) {
+  const cp = `${currentPrefix}-`;
+  if (tag.startsWith(cp)) {
+    return `${CANONICAL_PREFIX}-${tag.slice(cp.length)}`;
+  }
+  return tag;
+}
+
+export function buildComponentSummaries(indexes, { category, query, limit, offset, prefix, patternId, sort, patterns, installRegistry, patternFrequency } = {}) {
   const p = normalizePrefix(prefix);
   const q = typeof query === 'string' ? query.trim().toLowerCase() : '';
   const limitExplicit = Number.isInteger(limit);
@@ -1279,6 +1360,24 @@ export function buildComponentSummaries(indexes, { category, query, limit, offse
     modulePath,
   }));
 
+  // patternId filter: restrict to components required by a specific pattern
+  if (typeof patternId === 'string' && patternId.trim()) {
+    const pats = patterns && typeof patterns === 'object' ? patterns : {};
+    const pat = pats[patternId.trim()];
+    if (pat && Array.isArray(pat.requires)) {
+      const requiredIds = new Set(pat.requires.map((r) => String(r ?? '').trim()).filter(Boolean));
+      const tags = installRegistry?.tags && typeof installRegistry.tags === 'object' ? installRegistry.tags : {};
+      items = items.filter((item) => {
+        // Map tagName to componentId via install registry
+        const canonicalTag = toCanonicalTag(item.tagName, p);
+        const componentId = tags[canonicalTag];
+        return componentId && requiredIds.has(componentId);
+      });
+    } else {
+      items = [];
+    }
+  }
+
   if (category) {
     items = items.filter((item) => item.category === category);
   }
@@ -1296,6 +1395,18 @@ export function buildComponentSummaries(indexes, { category, query, limit, offse
     });
   }
 
+  // frequency sort: order by pattern usage count descending
+  if (sort === 'frequency') {
+    const freq = patternFrequency instanceof Map ? patternFrequency : new Map();
+    const tags = installRegistry?.tags && typeof installRegistry.tags === 'object' ? installRegistry.tags : {};
+    items = items.map((item) => {
+      const canonicalTag = toCanonicalTag(item.tagName, p);
+      const componentId = tags[canonicalTag] ?? '';
+      return { ...item, frequency: freq.get(componentId) ?? 0 };
+    });
+    items.sort((a, b) => b.frequency - a.frequency);
+  }
+
   const total = items.length;
   const paged = items.slice(pageOffset, pageOffset + pageSize);
 
@@ -1886,6 +1997,7 @@ export async function createMcpServer(loadJsonData, loadValidator, options = {})
   const patternRegistry = await loadJson('pattern-registry.json');
   const { patterns } = loadPatternRegistryShape(patternRegistry);
   const relatedComponentMap = buildRelatedComponentMap(installRegistry, patterns);
+  const patternFrequency = buildPatternFrequencyMap(patterns);
 
   // Load optional data files (design tokens, guidelines index)
   let designTokensData = null;
@@ -1916,7 +2028,7 @@ export async function createMcpServer(loadJsonData, loadValidator, options = {})
 
   const server = new McpServer({
     name: 'web-components-factory-design-system',
-    version: '0.6.0',
+    version: '0.7.0',
   });
 
   server.registerPrompt(
@@ -2066,7 +2178,7 @@ export async function createMcpServer(loadJsonData, loadValidator, options = {})
 
       const overview = {
         name: 'DADS Web Components (wcf)',
-        version: '0.6.0',
+        version: '0.7.0',
         prefix: detectedPrefix,
         totalComponents: indexes.decls.length,
         componentsByCategory: categoryCount,
@@ -2221,10 +2333,12 @@ export async function createMcpServer(loadJsonData, loadValidator, options = {})
         limit: z.number().int().min(1).max(200).optional().describe('Maximum items to return (default: 20; set 200 for all results)'),
         offset: z.number().int().min(0).optional().describe('Pagination offset (default: 0)'),
         prefix: z.string().optional(),
+        patternId: z.string().optional().describe('Filter to components required by this pattern'),
+        sort: z.enum(['default', 'frequency']).optional().describe('Sort order: "default" (CEM declaration order) or "frequency" (pattern usage count, descending)'),
       },
     },
-    async ({ category, query, limit, offset, prefix }) => {
-      const page = buildComponentSummaries(indexes, { category, query, limit, offset, prefix });
+    async ({ category, query, limit, offset, prefix, patternId, sort }) => {
+      const page = buildComponentSummaries(indexes, { category, query, limit, offset, prefix, patternId, sort, patterns, installRegistry, patternFrequency });
       const payload = {
         items: page.items,
         total: page.total,
@@ -3229,7 +3343,7 @@ export async function createMcpServer(loadJsonData, loadValidator, options = {})
         tool.name,
         {
           description: tool.description,
-          inputSchema: tool.inputSchema ?? {},
+          inputSchema: toPassthroughSchema(tool.inputSchema),
         },
         async (args) => {
           try {
@@ -3238,6 +3352,7 @@ export async function createMcpServer(loadJsonData, loadValidator, options = {})
                 plugin: { name: plugin.name, version: plugin.version },
                 helpers: {
                   loadJsonData: loadJson,
+                  loadTextData: loadText,
                   buildJsonToolResponse,
                   normalizePrefix,
                   withPrefix,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monoharada/wcf-mcp",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "MCP server for the web-components-factory design system. Provides component discovery, validation, and pattern-based UI composition without cloning the repository.",
   "type": "module",
   "bin": {
@@ -13,6 +13,7 @@
     "validator.mjs",
     "data/",
     "examples/",
+    "plugins/",
     "wcf-mcp.config.example.json"
   ],
   "keywords": [