wavemaker-dev-mcp 0.1.3 → 1.0.0

package/README.md

@@ -1,98 +1,121 @@
 # wavemaker-dev-mcp
 
-An MCP (Model Context Protocol) server that exposes **read-only** tools to search and read:
+An MCP (Model Context Protocol) server that helps AI coding assistants generate WaveMaker React markup using pre-built skill documents. No repo checkout required — all component and token docs are bundled in the package.
 
-- **`@wavemaker/react-runtime`** — component sources, `props.js` / `props.ts`, and references to widget names
-- **`@wavemaker/foundation-css`** or **`@wavemaker-ai/foundation-css`** — tokens, LESS, and CSS
-- **Layout helpers** — rule-based suggestions (component choice, spacing tokens, layout checks, sibling wrapper hints via `fix_layout_spacing`), plus a placeholder DOM analysis tool (replaceable with Playwright later)
-
-There are **no embeddings** and **no vector DB**. Search uses [ripgrep](https://github.com/BurntSushi/ripgrep) when available, with a Node.js fallback.
+There are **no embeddings**, **no vector DB**, and **no live repo scanning**. Skills are generated from WaveMaker source repos and bundled at publish time.
 
 ## Requirements
 
 - Node.js 18+
-- A project that installs `@wavemaker/react-runtime` and (optionally) `@wavemaker/foundation-css` under `node_modules`
-- Optional: `rg` on `PATH` for faster search
+- No additional configuration — skill docs are bundled in the package.
 
 ## Install
 
 ```bash
-git clone <your-repo-url> wavemaker-dev-mcp
+# From npm (recommended)
+npx -y wavemaker-dev-mcp
+
+# From source
+git clone <repo-url> wavemaker-dev-mcp
 cd wavemaker-dev-mcp
 npm install
 npm run build
 ```
 
-The published npm package includes `dist/`; a git clone must run `npm run build` before using `dist/index.js` in MCP config.
+## Skills system
 
-## Local testing (MCP Inspector)
+Skills are pre-generated Markdown documents covering every WaveMaker component and design token group. They are bundled in the package under `skills/` — no live repo access needed.
+
+### Recommended LLM session workflow
+
+1. Call `list_skills` once at the start to load the component index (~500 tokens).
+2. Call `get_skill("WmSelect")` before generating markup for a specific component (~400–700 tokens per skill).
+3. Call `search_skills("sortable table with pagination")` when unsure which component to use.
 
-Use [@modelcontextprotocol/inspector](https://www.npmjs.com/package/@modelcontextprotocol/inspector) to exercise the server in a browser. The inspector expects **Node.js ≥ 22.7.5**.
+### Regenerating skills after repo updates
 
-From this repository root (after `npm run build` so `dist/index.js` exists):
+Skills are generated from the react-runtime and foundation-css source repos. Run this after pulling updates:
 
+**Option 1 — CLI args:**
 ```bash
-npx @modelcontextprotocol/inspector --config mcp.json --server wavemaker-dev
+npm run generate-skills -- \
+  --runtime-path=/path/to/wavemaker-react-runtime \
+  --css-path=/path/to/wavemaker-foundation-css \
+  --force
 ```
 
-If `mcp.json` defines only this server, `--server wavemaker-dev` may be omitted. Open the UI URL printed in the terminal (default **http://localhost:6274**). When prompted, use the session token from the console to authenticate to the proxy.
+**Option 2 — env vars** (set once in your shell profile, then just run the script):
+```bash
+# Add to ~/.zshrc or ~/.bashrc
+export WM_REACT_RUNTIME_SOURCE=/path/to/wavemaker-react-runtime
+export WM_FOUNDATION_CSS_SOURCE=/path/to/wavemaker-foundation-css
+```
 
-Point the server at your WaveMaker app or source clones by adding an `env` block to the `wavemaker-dev` entry in `mcp.json` (see **Environment variables** below), or set variables in your shell before the `npx` command.
+```bash
+npm run generate-skills -- --force
+```
+
+CLI args take priority over env vars. `--runtime-path` / `WM_REACT_RUNTIME_SOURCE` is required; `--css-path` / `WM_FOUNDATION_CSS_SOURCE` is optional (skips token doc generation if omitted).
+
+| Flag | Description |
+|------|-------------|
+| `--force` | Regenerates all auto-generated skills. Hand-crafted skills (no `generated: true` in frontmatter) are always preserved. |
+| `--dry-run` | Preview what would be written without touching any files. |
+
+> These env vars are only used by the `generate-skills` script — the MCP server itself needs no configuration.
+
+## Local testing (MCP Inspector)
+
+Use [@modelcontextprotocol/inspector](https://www.npmjs.com/package/@modelcontextprotocol/inspector) to exercise the server in a browser (requires Node.js ≥ 22.7.5):
+
+```bash
+npm run build
+npx @modelcontextprotocol/inspector --config mcp.json --server wavemaker-dev
+```
+
+Open the URL printed in the terminal (default **http://localhost:6274**).
 
 ## Environment variables
 
+The MCP server needs no environment variables. The following are only used by the `generate-skills` script:
+
 | Variable | Purpose |
 |----------|---------|
-| `WM_PROJECT_ROOT` | App root (directory containing `node_modules`). Used when the MCP process `cwd` is not your app. Overridden by the `workingDirectory` tool argument when set. |
-| `WM_REACT_RUNTIME_ROOT` | Absolute path to `@wavemaker/react-runtime` (skips `node_modules` lookup). |
-| `WM_FOUNDATION_CSS_ROOT` | Absolute path to the foundation-css package root. |
+| `WM_REACT_RUNTIME_SOURCE` | Path to a local react-runtime source clone (used by `generate-skills`). |
+| `WM_FOUNDATION_CSS_SOURCE` | Path to a local foundation-css source clone (used by `generate-skills`). |
 
 ## Tools
 
+### Skill tools (no repo required)
+
 | Tool | Description |
 |------|-------------|
-| `get_wavemaker_roots` | Show resolved paths for react-runtime and foundation-css. |
-| `search_wavemaker_runtime` | Search inside the react-runtime package (`pattern`, optional `fileGlob`, `maxResults`). |
-| `read_wavemaker_runtime_file` | Read a file relative to that package (e.g. `components/input/select/props.js`). |
-| `search_foundation_css` | Search inside foundation-css. |
-| `read_foundation_css_file` | Read a file relative to foundation-css. |
-| `find_wavemaker_component` | Given a name like `WmSelect` or `select`, list matching `props` paths and sample references under `components/`. |
-| `suggest_component` | Map layout intent (`layout`, `repeat`, `grouped`) to a component name (e.g. `WmGrid`, `WmList`, `WmCard`, `WmFlex`). |
-| `map_spacing` | Map a pixel value (`px`) to the nearest spacing token (`xs`–`xl`) and numeric value. |
-| `validate_layout` | Check a `layout` string and `code` snippet for common issues (e.g. row direction, `Wm*` components). |
-| `analyze_dom` | Returns mock header height, spacing, and alignment; intended as a stub until real DOM analysis is added. |
-| `enforce_spacing` | Given optional `type` (e.g. `card-group`, `section`) and `layout` (`row` / `column`), returns rule-based `gap` and `padding` tokens. |
-| `fix_layout_spacing` | Given optional `siblingsCount`, returns `WmFlex` with `direction: row` and `gap: lg` when count is greater than one; otherwise `{ wrapper: null }`. |
-
-## Cursor
+| `list_skills` | Returns the skill index: all component names, categories, summaries, and tags. Accepts optional `category` filter. |
+| `get_skill` | Returns the full Markdown skill doc for a component (e.g. `WmSelect`, `WmLinearLayout`) or token group (e.g. `spacing`, `colors`). Case-insensitive, strips `Wm` prefix. |
+| `search_skills` | Free-text search across all skills by intent (e.g. `"sortable table with pagination"`). Returns top-N matches with scores. |
+| `skills_meta` | Returns skill index metadata: version, generated timestamp, source git hashes, component/token counts. |
 
-Add a **global** or **project** MCP config so the server runs with **`cwd` set to your WaveMaker app** (the folder that contains `node_modules`).
+### Layout / spacing tools
 
-Example (adjust absolute paths):
-
-```json
-{
-  "mcpServers": {
-    "wavemaker-dev": {
-      "command": "node",
-      "args": ["/path/to/wavemaker-dev-mcp/dist/index.js"],
-      "cwd": "/path/to/your-wm-react-app"
-    }
-  }
-}
-```
+| Tool | Description |
+|------|-------------|
+| `suggest_component` | Map layout intent (`layout`, `repeat`, `grouped`) to a WaveMaker component name and import path. |
+| `map_spacing` | Map a pixel value to the nearest spacing token (`xs`–`xl`) and `WmLinearLayout` spacing value. |
+| `validate_layout` | Check a layout string and code snippet for common issues (wrong prefix, missing direction). |
+| `analyze_dom` | Returns mock header height, spacing, and alignment. Stub for future Playwright integration. |
+| `enforce_spacing` | Given `type` (e.g. `card-group`, `section`) and `layout` (`row`/`column`), returns token-based gap and padding values. |
+| `fix_layout_spacing` | Given `siblingsCount`, recommends wrapping siblings in `WmLinearLayout` + `WmLinearLayoutItem`. |
 
-If you cannot set `cwd`, set `WM_PROJECT_ROOT` to your app root (e.g. `env` in the MCP server entry, if your client supports it).
+## Cursor / Claude Code setup
 
-After publishing to npm, you can use:
+Zero config — add to your MCP config and it works immediately:
 
 ```json
 {
   "mcpServers": {
     "wavemaker-dev": {
       "command": "npx",
-      "args": ["-y", "wavemaker-dev-mcp"],
-      "cwd": "/path/to/your-wm-react-app"
+      "args": ["-y", "wavemaker-dev-mcp"]
     }
   }
 }
@@ -100,7 +123,7 @@ After publishing to npm, you can use:
 
 ## Tests (Playwright)
 
-Integration tests spawn the server over stdio with the official MCP client and call tools. They expect a WaveMaker app at `../wm-react-base-app` (sibling directory) or set **`WM_TEST_APP_ROOT`** to an app root that contains `node_modules/@wavemaker/react-runtime`.
+Integration tests spawn the actual server over stdio. All tests run standalone — no WM repo checkout needed.
 
 ```bash
 npm run build

package/dist/index.js

@@ -1,213 +1,144 @@
 #!/usr/bin/env node
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const node_fs_1 = __importDefault(require("node:fs"));
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const zod_1 = require("zod");
-const components_js_1 = require("./components.js");
-const paths_js_1 = require("./paths.js");
-const search_js_1 = require("./search.js");
 const layout_tools_js_1 = require("./layout-tools.js");
-function resolveProjectRoot(workingDirectory) {
-    return workingDirectory ?? process.env.WM_PROJECT_ROOT?.trim() ?? process.cwd();
-}
-const MAX_READ_BYTES = 512 * 1024;
-const MAX_LINES_PREVIEW = 400;
-function readFileSlice(absolute, startLine, endLine) {
-    const buf = node_fs_1.default.readFileSync(absolute);
-    let text = buf.length > MAX_READ_BYTES ? buf.subarray(0, MAX_READ_BYTES).toString("utf8") : buf.toString("utf8");
-    let truncated = buf.length > MAX_READ_BYTES;
-    const lines = text.split(/\r?\n/);
-    if (startLine !== undefined || endLine !== undefined) {
-        const start = Math.max(1, startLine ?? 1) - 1;
-        const end = endLine === undefined ? lines.length : Math.min(lines.length, endLine);
-        const slice = lines.slice(start, end);
-        if (slice.length > MAX_LINES_PREVIEW) {
-            truncated = true;
-            return { text: slice.slice(0, MAX_LINES_PREVIEW).join("\n"), truncated };
-        }
-        return { text: slice.join("\n"), truncated };
-    }
-    if (lines.length > MAX_LINES_PREVIEW) {
-        return { text: lines.slice(0, MAX_LINES_PREVIEW).join("\n"), truncated: true };
-    }
-    return { text, truncated };
-}
-const workingDirSchema = zod_1.z
-    .string()
-    .optional()
-    .describe("Project root (directory containing node_modules). Defaults to process.cwd(). Set when the MCP process cwd is not your app root.");
+const loader_js_1 = require("./skills/loader.js");
 async function main() {
     const mcp = new mcp_js_1.McpServer({
         name: "wavemaker-dev-mcp",
-        version: "0.1.0",
+        version: "0.1.4",
         title: "WaveMaker React & Foundation CSS",
     });
-    mcp.registerTool("get_wavemaker_roots", {
-        title: "Resolve WaveMaker package paths",
-        description: "Returns resolved paths for react-runtime and foundation-css. Resolution order: WM_*_SOURCE (local clone) → WM_*_ROOT → node_modules. Call this first if searches fail.",
-        inputSchema: { workingDirectory: workingDirSchema },
-    }, async ({ workingDirectory }) => {
-        const roots = (0, paths_js_1.resolveRoots)(resolveProjectRoot(workingDirectory));
-        const lines = [
-            `projectRoot: ${roots.projectRoot}`,
-            roots.reactRuntime
-                ? `reactRuntime: ${roots.reactRuntime.path} [${roots.reactRuntime.resolution}]`
-                : "reactRuntime: NOT FOUND (set WM_REACT_RUNTIME_SOURCE or WM_REACT_RUNTIME_ROOT, or install @wavemaker/react-runtime under node_modules)",
-            roots.foundationCss
-                ? `foundationCss: ${roots.foundationCss.path} [${roots.foundationCss.resolution}, ${roots.foundationCss.packageName}]`
-                : "foundationCss: NOT FOUND (set WM_FOUNDATION_CSS_SOURCE or WM_FOUNDATION_CSS_ROOT, or install @wavemaker/foundation-css under node_modules)",
-        ];
-        return { content: [{ type: "text", text: lines.join("\n") }] };
-    });
-    mcp.registerTool("search_wavemaker_runtime", {
-        title: "Search @wavemaker/react-runtime sources",
-        description: "Ripgrep (or Node fallback) over the installed react-runtime package for symbols, props, or text. Use fileGlob like **/*.js or **/props.js to narrow scope.",
+    // ---------------------------------------------------------------------------
+    // Skill tools — no repo checkout required
+    // ---------------------------------------------------------------------------
+    mcp.registerTool("list_skills", {
+        title: "List available WaveMaker component skills",
+        description: "Returns the index of pre-built component and token skill documents. " +
+            "Call this at the start of a code generation session to see what skills are available, " +
+            "then use get_skill to load the full document for a specific component.",
         inputSchema: {
-            pattern: zod_1.z.string().describe("Regular expression or literal (Node fallback escapes if invalid regex)."),
-            maxResults: zod_1.z.number().optional().describe("Max matches (default 40)."),
-            fileGlob: zod_1.z.string().optional().describe("Optional glob relative to package root, e.g. **/props.js"),
-            workingDirectory: workingDirSchema,
+            category: zod_1.z
+                .string()
+                .optional()
+                .describe('Filter by category: "container", "input", "form", "data", "basic", "layout", "navigation". Omit for all.'),
         },
-    }, async ({ pattern, maxResults, fileGlob, workingDirectory }) => {
-        const roots = (0, paths_js_1.resolveRoots)(resolveProjectRoot(workingDirectory));
-        if (!roots.reactRuntime) {
-            return {
-                isError: true,
-                content: [{ type: "text", text: "react-runtime not found. Run get_wavemaker_roots or install @wavemaker/react-runtime." }],
-            };
-        }
-        const max = Math.min(200, Math.max(1, maxResults ?? 40));
-        const root = roots.reactRuntime.path;
-        let matches = (0, search_js_1.searchWithRipgrep)(root, pattern, max, fileGlob);
-        if (matches === null) {
-            matches = await (0, search_js_1.searchWithNode)(root, pattern, max, fileGlob);
-        }
-        return { content: [{ type: "text", text: (0, search_js_1.formatMatches)("react-runtime", root, matches) }] };
+    }, async ({ category }) => {
+        const index = (0, loader_js_1.loadIndex)();
+        const components = category
+            ? index.components.filter((c) => c.category === category)
+            : index.components;
+        const out = {
+            skills_version: index.version,
+            generated: index.generated,
+            components: components.map((c) => ({
+                name: c.name,
+                category: c.category,
+                summary: c.summary,
+                tags: c.tags,
+            })),
+            tokens: index.tokens.map((t) => ({
+                name: t.name,
+                summary: t.summary,
+                tags: t.tags,
+            })),
+        };
+        return { content: [{ type: "text", text: JSON.stringify(out, null, 2) }] };
     });
-    mcp.registerTool("read_wavemaker_runtime_file", {
-        title: "Read a file under @wavemaker/react-runtime",
-        description: "Read a file from the resolved react-runtime root (published package or local clone). Use components/... for npm installs or src/components/... when using WM_REACT_RUNTIME_SOURCE.",
+    mcp.registerTool("get_skill", {
+        title: "Get WaveMaker component or token skill document",
+        description: "Returns the full Markdown skill document for a component (e.g. WmSelect, WmLinearLayout) or token group (e.g. spacing, colors). " +
+            "Each document contains: usage examples, all key props with types and defaults, CSS token references, and common patterns. " +
+            "Case-insensitive; strips 'Wm' prefix automatically.",
         inputSchema: {
-            relativePath: zod_1.z
+            name: zod_1.z
                 .string()
-                .describe("Path under react-runtime root, e.g. components/input/select/props.js or src/components/input/select/props.ts"),
-            startLine: zod_1.z.number().optional().describe("1-based start line (optional)."),
-            endLine: zod_1.z.number().optional().describe("1-based end line inclusive (optional)."),
-            workingDirectory: workingDirSchema,
+                .describe('Component name (e.g. "WmSelect", "WmLinearLayout") or token group name (e.g. "spacing"). Case-insensitive.'),
         },
-    }, async ({ relativePath, startLine, endLine, workingDirectory }) => {
-        const roots = (0, paths_js_1.resolveRoots)(resolveProjectRoot(workingDirectory));
-        if (!roots.reactRuntime) {
-            return {
-                isError: true,
-                content: [{ type: "text", text: "react-runtime not found." }],
-            };
+    }, async ({ name }) => {
+        const component = (0, loader_js_1.findComponentSkill)(name);
+        if (component) {
+            const content = (0, loader_js_1.readSkillFile)(component.file);
+            return { content: [{ type: "text", text: content }] };
         }
-        const check = (0, paths_js_1.safeReadUnderRoot)(roots.reactRuntime.path, relativePath);
-        if (!check.ok) {
-            return { isError: true, content: [{ type: "text", text: check.error }] };
+        const token = (0, loader_js_1.findTokenSkill)(name);
+        if (token) {
+            const content = (0, loader_js_1.readSkillFile)(token.file);
+            return { content: [{ type: "text", text: content }] };
         }
-        if (!node_fs_1.default.existsSync(check.absolute) || !node_fs_1.default.statSync(check.absolute).isFile()) {
-            return { isError: true, content: [{ type: "text", text: `Not a file: ${relativePath}` }] };
-        }
-        const { text, truncated } = readFileSlice(check.absolute, startLine, endLine);
-        const header = `${check.absolute}${truncated ? "\n[truncated]" : ""}\n\n`;
-        return { content: [{ type: "text", text: header + text }] };
+        const index = (0, loader_js_1.loadIndex)();
+        const available = [
+            ...index.components.map((c) => c.name),
+            ...index.tokens.map((t) => t.name),
+        ].join(", ");
+        return {
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: `No skill found for "${name}". Available: ${available}\nUse list_skills to browse all, or search_skills to find by intent.`,
+                },
+            ],
+        };
     });
-    mcp.registerTool("search_foundation_css", {
-        title: "Search @wavemaker/foundation-css (or @wavemaker-ai/foundation-css)",
-        description: "Search tokens, LESS, and CSS under the foundation-css package for variables, classes, or snippets.",
+    mcp.registerTool("search_skills", {
+        title: "Search WaveMaker skills by intent or keyword",
+        description: "Searches skill documents by free-text query and returns the top matching components and token groups with summaries. " +
+            'Use when you are not sure which component to use (e.g. "I need a sortable table", "dropdown with search", "flex row layout"). ' +
+            "Returns component names you can then pass to get_skill.",
         inputSchema: {
-            pattern: zod_1.z.string(),
-            maxResults: zod_1.z.number().optional(),
-            fileGlob: zod_1.z.string().optional(),
-            workingDirectory: workingDirSchema,
+            query: zod_1.z
+                .string()
+                .describe('Free-text intent or keyword, e.g. "sortable data grid with pagination" or "dropdown select input".'),
+            topN: zod_1.z
+                .number()
+                .optional()
+                .describe("Max results to return (default 5)."),
         },
-    }, async ({ pattern, maxResults, fileGlob, workingDirectory }) => {
-        const roots = (0, paths_js_1.resolveRoots)(resolveProjectRoot(workingDirectory));
-        if (!roots.foundationCss) {
+    }, async ({ query, topN }) => {
+        const results = (0, loader_js_1.searchSkills)(query, topN ?? 5);
+        if (results.length === 0) {
             return {
-                isError: true,
                 content: [
                     {
                         type: "text",
-                        text: "foundation-css not found. Install @wavemaker/foundation-css or set WM_FOUNDATION_CSS_ROOT.",
+                        text: `No skills matched "${query}". Use list_skills to see all available components.`,
                     },
                 ],
             };
         }
-        const max = Math.min(200, Math.max(1, maxResults ?? 40));
-        const root = roots.foundationCss.path;
-        let matches = (0, search_js_1.searchWithRipgrep)(root, pattern, max, fileGlob);
-        if (matches === null) {
-            matches = await (0, search_js_1.searchWithNode)(root, pattern, max, fileGlob);
-        }
-        return { content: [{ type: "text", text: (0, search_js_1.formatMatches)("foundation-css", root, matches) }] };
-    });
-    mcp.registerTool("read_foundation_css_file", {
-        title: "Read a file under foundation-css",
-        description: "Read a file from the foundation-css package (tokens, LESS, CSS). Path is relative to package root.",
-        inputSchema: {
-            relativePath: zod_1.z.string(),
-            startLine: zod_1.z.number().optional(),
-            endLine: zod_1.z.number().optional(),
-            workingDirectory: workingDirSchema,
-        },
-    }, async ({ relativePath, startLine, endLine, workingDirectory }) => {
-        const roots = (0, paths_js_1.resolveRoots)(resolveProjectRoot(workingDirectory));
-        if (!roots.foundationCss) {
-            return {
-                isError: true,
-                content: [{ type: "text", text: "foundation-css not found." }],
-            };
-        }
-        const check = (0, paths_js_1.safeReadUnderRoot)(roots.foundationCss.path, relativePath);
-        if (!check.ok) {
-            return { isError: true, content: [{ type: "text", text: check.error }] };
-        }
-        if (!node_fs_1.default.existsSync(check.absolute) || !node_fs_1.default.statSync(check.absolute).isFile()) {
-            return { isError: true, content: [{ type: "text", text: `Not a file: ${relativePath}` }] };
-        }
-        const { text, truncated } = readFileSlice(check.absolute, startLine, endLine);
-        const header = `${check.absolute}${truncated ? "\n[truncated]" : ""}\n\n`;
-        return { content: [{ type: "text", text: header + text }] };
+        const out = results.map((r) => ({
+            type: r.type,
+            name: r.entry.name,
+            summary: r.entry.summary,
+            tags: r.entry.tags,
+            score: r.score,
+        }));
+        return { content: [{ type: "text", text: JSON.stringify(out, null, 2) }] };
     });
-    mcp.registerTool("find_wavemaker_component", {
-        title: "Find props / paths for a WaveMaker widget",
-        description: "Given a widget name like WmSelect or WmButton, list matching props.js/ts paths under components/, and optionally search for the name in source when path matching is ambiguous (e.g. charts).",
-        inputSchema: {
-            componentName: zod_1.z.string().describe('e.g. "WmSelect", "WmBarChart", or "select"'),
-            workingDirectory: workingDirSchema,
-        },
-    }, async ({ componentName, workingDirectory }) => {
-        const roots = (0, paths_js_1.resolveRoots)(resolveProjectRoot(workingDirectory));
-        if (!roots.reactRuntime) {
-            return {
-                isError: true,
-                content: [{ type: "text", text: "react-runtime not found." }],
-            };
-        }
-        const root = roots.reactRuntime.path;
-        const hints = await (0, components_js_1.findPropsPathsByHint)(root, componentName);
-        const wmName = (0, components_js_1.toWmComponentName)(componentName);
-        const refs = await (0, components_js_1.findComponentRefs)(root, wmName, 20);
-        const lines = [
-            `react-runtime: ${root}`,
-            `normalized name for source search: ${wmName}`,
-            "",
-            "Props files matching path hint (components/**/props.*):",
-            hints.length ? hints.map((p) => `  ${p}`).join("\n") : "  (none — charts and some widgets use non-obvious folder names; use refs below or search_wavemaker_runtime)",
-            "",
-            `References to "${wmName}" under components/ (sample):`,
-            refs.length ? (0, search_js_1.formatMatches)("refs", (0, paths_js_1.resolveRuntimeComponentsRoot)(root), refs) : "  (none)",
-        ];
-        return { content: [{ type: "text", text: lines.join("\n") }] };
+    mcp.registerTool("skills_meta", {
+        title: "Get skills index metadata",
+        description: "Returns metadata about the bundled skill documents: version, generation timestamp, " +
+            "source git commit hashes (runtimeCommit, cssCommit), and component/token counts. " +
+            "Use to check whether skills are up to date with your WaveMaker repo versions.",
+        inputSchema: {},
+    }, async () => {
+        const index = (0, loader_js_1.loadIndex)();
+        const meta = {
+            version: index.version,
+            generated: index.generated,
+            sources: index.sources ?? {},
+            componentCount: index.components.length,
+            tokenCount: index.tokens.length,
+        };
+        return { content: [{ type: "text", text: JSON.stringify(meta, null, 2) }] };
     });
+    // ---------------------------------------------------------------------------
+    // Layout / spacing tools
+    // ---------------------------------------------------------------------------
     mcp.registerTool("suggest_component", {
         title: "Suggest WaveMaker layout component",
         description: "Rule-based mapping from layout intent to a WaveMaker component name and import path. " +

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/skills/loader.d.ts

@@ -0,0 +1,36 @@
+export interface SkillEntry {
+    name: string;
+    file: string;
+    category?: string;
+    summary: string;
+    tags: string[];
+}
+export interface TokenEntry {
+    name: string;
+    file: string;
+    summary: string;
+    tags: string[];
+}
+export interface SkillIndex {
+    version: string;
+    generated: string;
+    sources?: {
+        runtimeCommit?: string;
+        cssCommit?: string;
+    };
+    components: SkillEntry[];
+    tokens: TokenEntry[];
+}
+export declare function loadIndex(): SkillIndex;
+export declare function readSkillFile(relativePath: string): string;
+/** Find a component skill by name (case-insensitive, strips "Wm" prefix for matching). */
+export declare function findComponentSkill(query: string): SkillEntry | undefined;
+/** Find a token skill by name. */
+export declare function findTokenSkill(query: string): TokenEntry | undefined;
+/** Search components and tokens by free-text query. Returns top matches. */
+export declare function searchSkills(query: string, topN?: number): Array<{
+    type: "component" | "token";
+    entry: SkillEntry | TokenEntry;
+    score: number;
+}>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/skills/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE;QACR,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,UAAU,EAAE,UAAU,EAAE,CAAC;IACzB,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAYD,wBAAgB,SAAS,IAAI,UAAU,CAMtC;AAED,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAW1D;AAED,0FAA0F;AAC1F,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CASxE;AAED,kCAAkC;AAClC,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAIpE;AAiBD,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,SAAI,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC;IAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAmB3I"}