@fragments-sdk/mcp 0.9.0 → 0.10.1

package/README.md

@@ -2,11 +2,19 @@
 
 > **Source-available.** This package is distributed publicly on npm under FSL-1.1-MIT; source stays private. Contribute by filing an issue at https://github.com/fragments-sdk/fragments/issues.
 
-Standalone MCP server for the Fragments design system. Gives AI coding assistants (Claude Code, Cursor, etc.) intelligent component discovery over components, blocks, and tokens — no Playwright or build tools required.
+Standalone MCP server for Fragments. It helps AI coding assistants validate generated UI against your design system: check candidate specs, repair safe governance failures, suggest design tokens before hardcoded CSS is written, and triage real Fragments Cloud findings.
+
+The public MCP surface is intentionally small: `govern`, `validate_and_fix`, `tokens.suggest`, `findings_list`, `findings_summary`, `findings_for_file`, and `swap_to_canonical`.
 
 ## Setup
 
-Add a **project-level** MCP config to your workspace root. This ensures the server runs from your project directory and auto-discovers `fragments.json` via `node_modules`.
+The recommended setup writes both MCP config and IDE rules that teach agents the validator loop:
+
+```bash
+npx @fragments-sdk/mcp@latest init
+```
+
+You can also add a **project-level** MCP config to your workspace root manually. This ensures the server runs from your project directory and auto-discovers `fragments.json` via `node_modules`.
 
 ### Cursor
 
@@ -69,32 +77,38 @@ The server auto-discovers `fragments.json` through two layers:
 
 Once the project root is known, the server walks up from it, scans `package.json` dependencies for packages with a `"fragments"` field, and resolves through `node_modules` (supporting pnpm, Yarn, and npm).
 
+## Validator Loop
+
+Ask your AI assistant to follow this loop whenever it generates or edits JSX, class names, style props, or CSS:
+
+1. Draft the UI spec or code change.
+2. Call `govern({ spec })`.
+3. If the result asks for revision, call `validate_and_fix({ spec, applyFixes: true })`.
+4. Apply deterministic repairs and run `govern` again.
+5. Before writing hardcoded CSS values, call `tokens.suggest({ property, value })` and use the returned `cssValue` when present.
+
 ## Tools
 
 | Tool | Description |
 |------|-------------|
-| `discover` | List, search, or get AI-powered component suggestions |
-| `inspect` | Full component details — props, examples, guidelines |
-| `blocks` | Composition patterns (e.g. "Login Form", "Settings Page") |
-| `tokens` | CSS custom properties by category |
-| `implement` | One-shot: components + blocks + tokens for a use case |
-| `render` | Render a component screenshot (requires dev server) |
-| `fix` | Generate token-compliance patches (requires dev server) |
-| `graph` | Query the component relationship graph (dependencies, impact, composition, health) |
-| `a11y` | Run an accessibility audit on a component (requires dev server) |
-
-## How search works
+| `govern` | Validate an AI-generated UI spec and return violations/fix guidance |
+| `validate_and_fix` | Deterministically repair safe governance failures and return a fixed spec |
+| `tokens.suggest` | Suggest the right design token for a CSS property and optional raw value |
+| `findings_list` | List Cloud governance findings for agent planning |
+| `findings_summary` | Summarize Cloud findings by severity, category, rule, and file |
+| `findings_for_file` | Retrieve open Cloud findings for the file an agent is editing |
+| `swap_to_canonical` | Suggest swaps from raw HTML (`<button>`, `<input>`, `<dialog>`, …) to the project's canonical components when a mapping is at confidence `auto` or `overridden` |
 
-Queries use **keyword search** with synonym expansion, weighted multi-field scoring (name, description, tags, usage, category, variants), and category-aware ranking — all running locally against your `fragments.json`. No external API calls are made.
+## How Token Suggestions Work
 
-**Premium:** Pass `--api-key` to enable semantic vector search (Voyage-Code-3 embeddings) fused with keyword results via Reciprocal Rank Fusion for deeper, meaning-based discovery.
+Validator tools run locally against your `fragments.json` or against a Cloud catalog when configured. Token suggestions use property-family-aware matching so color properties receive color tokens, spacing properties receive spacing tokens, and unsupported properties return an honest `noSuggestion` result.
 
 ## Options
 
 ```
 -p, --project-root <path>  Project root (default: cwd)
--u, --viewer-url <url>     Dev server URL for render/fix/a11y tools
--k, --api-key <key>        Premium API key for semantic vector search
+--cloud-api-key <key>      Cloud API key for org-scoped catalog and findings
+--generate-rules           Generate IDE rules files and exit
 ```
 
 <img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=a02beb71-df11-498d-8e1f-39de2e64ce5b" />

package/dist/bin.js

@@ -4,9 +4,7 @@ import {
   resolveDataAdapter,
   resolveSearchApiKey,
   startMcpServer
-} from "./chunk-YSNIGHNU.js";
-import "./chunk-4SVS3AA3.js";
-import "./chunk-YSRGQDEB.js";
+} from "./chunk-KGFM5SCE.js";
 import "./chunk-7D4SUZUM.js";
 
 // src/bin.ts
@@ -46,8 +44,6 @@ Examples:
   process.exit(0);
 }
 var projectRoot = process.cwd();
-var viewerUrl;
-var apiKey;
 var cloudApiKey;
 var source = "auto";
 var generateRules = false;
@@ -57,12 +53,6 @@ for (let i = 0; i < args.length; i++) {
   const arg = args[i];
   if (arg === "--project-root" || arg === "-p") {
     projectRoot = args[++i] ?? projectRoot;
-  } else if (arg === "--viewer-url" || arg === "-u") {
-    viewerUrl = args[++i];
-  } else if (arg === "--api-key" || arg === "-k") {
-    apiKey = args[++i];
-  } else if (arg === "--search-api-key") {
-    apiKey = args[++i];
   } else if (arg === "--cloud-api-key") {
     cloudApiKey = args[++i];
   } else if (arg === "--source") {
@@ -86,16 +76,13 @@ for (let i = 0; i < args.length; i++) {
 Usage: fragments-mcp [command] [options]
 
 Standalone MCP server for design system intelligence.
-Provides component discovery, search, and governance \u2014 no CLI/Playwright needed.
+Provides UI validation, deterministic repair, token suggestions, and Cloud findings.
 
 Commands:
   init                       Write MCP config for your AI editor(s)
 
 Options:
   -p, --project-root <path>  Project root directory (default: cwd)
-  -u, --viewer-url <url>     Viewer URL for render/fix/a11y tools (optional)
-  -k, --api-key <key>        Premium API key for semantic vector search (optional)
-  --search-api-key <key>     Explicit premium vector search key (same as --api-key)
   --cloud-api-key <key>      Cloud API key for org-scoped catalog access
   --source <mode>            Source override: auto, fragments-json, cloud, bundle, extract
   --generate-rules           Generate IDE rules files and exit
@@ -112,8 +99,7 @@ Quick start:
 var fileConfig = loadConfigFile(projectRoot) ?? void 0;
 var serverConfig = {
   projectRoot,
-  viewerUrl,
-  searchApiKey: resolveSearchApiKey({ projectRoot, apiKey }, fileConfig),
+  searchApiKey: resolveSearchApiKey({ projectRoot }, fileConfig),
   cloudApiKey,
   source,
   fileConfig
@@ -126,7 +112,7 @@ if (mode === "extract") {
 }
 if (generateRules) {
   (async () => {
-    const { generateRulesFiles } = await import("./rules-TN4KHFFG.js");
+    const { generateRulesFiles } = await import("./rules-JUZ3RABB.js");
     const defaultFormats = ["cursor", "claude", "copilot"];
     const formats = rulesFormats ? rulesFormats.split(",").map((f) => f.trim()) : defaultFormats;
     const validFormats = /* @__PURE__ */ new Set(["cursor", "claude", "copilot"]);
@@ -137,7 +123,7 @@ if (generateRules) {
       }
     }
     const data = await adapter.load(projectRoot);
-    const { BRAND } = await import("./constants-BLN4SSNH.js");
+    const { BRAND } = await import("@fragments-sdk/core");
     const brandName = fileConfig?.brand?.name ?? BRAND.name;
     const files = generateRulesFiles({
       data,
@@ -162,9 +148,7 @@ if (generateRules) {
 } else {
   startMcpServer({
     projectRoot,
-    viewerUrl,
-    apiKey,
-    searchApiKey: resolveSearchApiKey({ projectRoot, apiKey }, fileConfig),
+    searchApiKey: resolveSearchApiKey({ projectRoot }, fileConfig),
     cloudApiKey,
     source,
     fileConfig,

package/dist/bin.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/bin.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { startMcpServer } from './server.js';\nimport { loadConfigFile } from './config.js';\nimport { resolveDataAdapter, resolveSearchApiKey } from './source-selection.js';\n\n// Parse command line arguments\nconst args = process.argv.slice(2);\n\n// ---------------------------------------------------------------------------\n// Subcommand: init\n// ---------------------------------------------------------------------------\nif (args[0] === 'init') {\n  const { runInit } = await import('./init.js');\n  const initArgs = args.slice(1);\n\n  let projectRoot = process.cwd();\n  let clients: string[] | undefined;\n\n  for (let i = 0; i < initArgs.length; i++) {\n    const arg = initArgs[i];\n    if (arg === '--project-root' || arg === '-p') {\n      projectRoot = initArgs[++i] ?? projectRoot;\n    } else if (arg === '--client' || arg === '-c') {\n      clients = (initArgs[++i] ?? '').split(',').map((s) => s.trim());\n    } else if (arg === '--help' || arg === '-h') {\n      console.log(`\nUsage: fragments-mcp init [options]\n\nWrite MCP server config for your AI editor(s).\nAuto-detects Claude Code, Cursor, VS Code, and Windsurf.\n\nOptions:\n  -p, --project-root <path>  Project root directory (default: cwd)\n  -c, --client <list>        Comma-separated clients: claude,cursor,vscode,windsurf\n                              (default: auto-detect)\n  -h, --help                 Show this help message\n\nExamples:\n  npx @fragments-sdk/mcp init\n  npx @fragments-sdk/mcp init --client cursor,claude\n`);\n      process.exit(0);\n    }\n  }\n\n  runInit({ projectRoot, clients: clients as import('./init.js').Client[] });\n  process.exit(0);\n}\n\n// ---------------------------------------------------------------------------\n// Main: MCP server mode\n// ---------------------------------------------------------------------------\nlet projectRoot = process.cwd();\nlet viewerUrl: string | undefined;\nlet apiKey: string | undefined;\nlet cloudApiKey: string | undefined;\nlet source: 'auto' | 'fragments-json' | 'cloud' | 'bundle' | 'extract' =\n  'auto';\nlet generateRules = false;\nlet rulesFormats: string | undefined;\nlet force = false;\n\nfor (let i = 0; i < args.length; i++) {\n  const arg = args[i];\n\n  if (arg === '--project-root' || arg === '-p') {\n    projectRoot = args[++i] ?? projectRoot;\n  } else if (arg === '--viewer-url' || arg === '-u') {\n    viewerUrl = args[++i];\n  } else if (arg === '--api-key' || arg === '-k') {\n    apiKey = args[++i];\n  } else if (arg === '--search-api-key') {\n    apiKey = args[++i];\n  } else if (arg === '--cloud-api-key') {\n    cloudApiKey = args[++i];\n  } else if (arg === '--source') {\n    const next = args[++i];\n    if (\n      next === 'auto' ||\n      next === 'fragments-json' ||\n      next === 'cloud' ||\n      next === 'bundle' ||\n      next === 'extract'\n    ) {\n      source = next;\n    } else {\n      console.error(\n        `Invalid source: \"${next}\". Valid values: auto, fragments-json, cloud, bundle, extract`,\n      );\n      process.exit(1);\n    }\n  } else if (arg === '--generate-rules') {\n    generateRules = true;\n  } else if (arg === '--formats') {\n    rulesFormats = args[++i];\n  } else if (arg === '--force') {\n    force = true;\n  } else if (arg === '--help' || arg === '-h') {\n    console.log(`\nUsage: fragments-mcp [command] [options]\n\nStandalone MCP server for design system intelligence.\nProvides component discovery, search, and governance — no CLI/Playwright needed.\n\nCommands:\n  init                       Write MCP config for your AI editor(s)\n\nOptions:\n  -p, --project-root <path>  Project root directory (default: cwd)\n  -u, --viewer-url <url>     Viewer URL for render/fix/a11y tools (optional)\n  -k, --api-key <key>        Premium API key for semantic vector search (optional)\n  --search-api-key <key>     Explicit premium vector search key (same as --api-key)\n  --cloud-api-key <key>      Cloud API key for org-scoped catalog access\n  --source <mode>            Source override: auto, fragments-json, cloud, bundle, extract\n  --generate-rules           Generate IDE rules files and exit\n  --formats <list>           Comma-separated formats: cursor,claude,copilot (default: all)\n  --force                    Overwrite existing rules files\n  -h, --help                 Show this help message\n\nQuick start:\n  npx @fragments-sdk/mcp init\n`);\n    process.exit(0);\n  }\n}\n\nconst fileConfig = loadConfigFile(projectRoot) ?? undefined;\nconst serverConfig = {\n  projectRoot,\n  viewerUrl,\n  searchApiKey: resolveSearchApiKey({ projectRoot, apiKey }, fileConfig),\n  cloudApiKey,\n  source,\n  fileConfig,\n};\nconst { adapter, mode } = resolveDataAdapter(serverConfig, fileConfig);\n\nif (mode === 'extract') {\n  console.error(\n    '[fragments-mcp] No fragments.json found — auto-extracting from source.',\n  );\n}\n\n// --generate-rules: generate IDE rules and exit\nif (generateRules) {\n  (async () => {\n    const { generateRulesFiles } = await import('./rules.js');\n    type RulesFormat = 'cursor' | 'claude' | 'copilot';\n\n    const defaultFormats: RulesFormat[] = ['cursor', 'claude', 'copilot'];\n    const formats: RulesFormat[] = rulesFormats\n      ? (rulesFormats.split(',').map(f => f.trim()) as RulesFormat[])\n      : defaultFormats;\n\n    // Validate formats\n    const validFormats = new Set(['cursor', 'claude', 'copilot']);\n    for (const fmt of formats) {\n      if (!validFormats.has(fmt)) {\n        console.error(`Invalid format: \"${fmt}\". Valid formats: cursor, claude, copilot`);\n        process.exit(1);\n      }\n    }\n\n    // Load data using the same adapter\n    const data = await adapter.load(projectRoot);\n\n    // Resolve brand name from config\n    const { BRAND } = await import('./constants.js');\n    const brandName = fileConfig?.brand?.name ?? BRAND.name;\n\n    // Generate rules\n    const files = generateRulesFiles({\n      data,\n      brandName,\n      outputDir: projectRoot,\n      formats,\n      force,\n    });\n\n    if (files.length === 0) {\n      console.log('No rules files generated.');\n    } else {\n      console.log(`Generated ${files.length} rules file(s):`);\n      for (const file of files) {\n        console.log(`  ${file}`);\n      }\n    }\n\n    process.exit(0);\n  })().catch((error) => {\n    console.error('Failed to generate rules:', error instanceof Error ? error.message : error);\n    process.exit(1);\n  });\n} else {\n  // Default: start MCP server\n  startMcpServer({\n    projectRoot,\n    viewerUrl,\n    apiKey,\n    searchApiKey: resolveSearchApiKey({ projectRoot, apiKey }, fileConfig),\n    cloudApiKey,\n    source,\n    fileConfig,\n    adapter,\n  }).catch((error) => {\n    console.error('Failed to start MCP server:', error);\n    process.exit(1);\n  });\n}\n"],"mappings":"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","names":["projectRoot"]}
+{"version":3,"sources":["../src/bin.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { startMcpServer } from './server.js';\nimport { loadConfigFile } from './config.js';\nimport { resolveDataAdapter, resolveSearchApiKey } from './source-selection.js';\n\n// Parse command line arguments\nconst args = process.argv.slice(2);\n\n// ---------------------------------------------------------------------------\n// Subcommand: init\n// ---------------------------------------------------------------------------\nif (args[0] === 'init') {\n  const { runInit } = await import('./init.js');\n  const initArgs = args.slice(1);\n\n  let projectRoot = process.cwd();\n  let clients: string[] | undefined;\n\n  for (let i = 0; i < initArgs.length; i++) {\n    const arg = initArgs[i];\n    if (arg === '--project-root' || arg === '-p') {\n      projectRoot = initArgs[++i] ?? projectRoot;\n    } else if (arg === '--client' || arg === '-c') {\n      clients = (initArgs[++i] ?? '').split(',').map((s) => s.trim());\n    } else if (arg === '--help' || arg === '-h') {\n      console.log(`\nUsage: fragments-mcp init [options]\n\nWrite MCP server config for your AI editor(s).\nAuto-detects Claude Code, Cursor, VS Code, and Windsurf.\n\nOptions:\n  -p, --project-root <path>  Project root directory (default: cwd)\n  -c, --client <list>        Comma-separated clients: claude,cursor,vscode,windsurf\n                              (default: auto-detect)\n  -h, --help                 Show this help message\n\nExamples:\n  npx @fragments-sdk/mcp init\n  npx @fragments-sdk/mcp init --client cursor,claude\n`);\n      process.exit(0);\n    }\n  }\n\n  runInit({ projectRoot, clients: clients as import('./init.js').Client[] });\n  process.exit(0);\n}\n\n// ---------------------------------------------------------------------------\n// Main: MCP server mode\n// ---------------------------------------------------------------------------\nlet projectRoot = process.cwd();\nlet cloudApiKey: string | undefined;\nlet source: 'auto' | 'fragments-json' | 'cloud' | 'bundle' | 'extract' =\n  'auto';\nlet generateRules = false;\nlet rulesFormats: string | undefined;\nlet force = false;\n\nfor (let i = 0; i < args.length; i++) {\n  const arg = args[i];\n\n  if (arg === '--project-root' || arg === '-p') {\n    projectRoot = args[++i] ?? projectRoot;\n  } else if (arg === '--cloud-api-key') {\n    cloudApiKey = args[++i];\n  } else if (arg === '--source') {\n    const next = args[++i];\n    if (\n      next === 'auto' ||\n      next === 'fragments-json' ||\n      next === 'cloud' ||\n      next === 'bundle' ||\n      next === 'extract'\n    ) {\n      source = next;\n    } else {\n      console.error(\n        `Invalid source: \"${next}\". Valid values: auto, fragments-json, cloud, bundle, extract`,\n      );\n      process.exit(1);\n    }\n  } else if (arg === '--generate-rules') {\n    generateRules = true;\n  } else if (arg === '--formats') {\n    rulesFormats = args[++i];\n  } else if (arg === '--force') {\n    force = true;\n  } else if (arg === '--help' || arg === '-h') {\n    console.log(`\nUsage: fragments-mcp [command] [options]\n\nStandalone MCP server for design system intelligence.\nProvides UI validation, deterministic repair, token suggestions, and Cloud findings.\n\nCommands:\n  init                       Write MCP config for your AI editor(s)\n\nOptions:\n  -p, --project-root <path>  Project root directory (default: cwd)\n  --cloud-api-key <key>      Cloud API key for org-scoped catalog access\n  --source <mode>            Source override: auto, fragments-json, cloud, bundle, extract\n  --generate-rules           Generate IDE rules files and exit\n  --formats <list>           Comma-separated formats: cursor,claude,copilot (default: all)\n  --force                    Overwrite existing rules files\n  -h, --help                 Show this help message\n\nQuick start:\n  npx @fragments-sdk/mcp init\n`);\n    process.exit(0);\n  }\n}\n\nconst fileConfig = loadConfigFile(projectRoot) ?? undefined;\nconst serverConfig = {\n  projectRoot,\n  searchApiKey: resolveSearchApiKey({ projectRoot }, fileConfig),\n  cloudApiKey,\n  source,\n  fileConfig,\n};\nconst { adapter, mode } = resolveDataAdapter(serverConfig, fileConfig);\n\nif (mode === 'extract') {\n  console.error(\n    '[fragments-mcp] No fragments.json found — auto-extracting from source.',\n  );\n}\n\n// --generate-rules: generate IDE rules and exit\nif (generateRules) {\n  (async () => {\n    const { generateRulesFiles } = await import('./rules.js');\n    type RulesFormat = 'cursor' | 'claude' | 'copilot';\n\n    const defaultFormats: RulesFormat[] = ['cursor', 'claude', 'copilot'];\n    const formats: RulesFormat[] = rulesFormats\n      ? (rulesFormats.split(',').map(f => f.trim()) as RulesFormat[])\n      : defaultFormats;\n\n    // Validate formats\n    const validFormats = new Set(['cursor', 'claude', 'copilot']);\n    for (const fmt of formats) {\n      if (!validFormats.has(fmt)) {\n        console.error(`Invalid format: \"${fmt}\". Valid formats: cursor, claude, copilot`);\n        process.exit(1);\n      }\n    }\n\n    // Load data using the same adapter\n    const data = await adapter.load(projectRoot);\n\n    // Resolve brand name from config\n    const { BRAND } = await import('@fragments-sdk/core');\n    const brandName = fileConfig?.brand?.name ?? BRAND.name;\n\n    // Generate rules\n    const files = generateRulesFiles({\n      data,\n      brandName,\n      outputDir: projectRoot,\n      formats,\n      force,\n    });\n\n    if (files.length === 0) {\n      console.log('No rules files generated.');\n    } else {\n      console.log(`Generated ${files.length} rules file(s):`);\n      for (const file of files) {\n        console.log(`  ${file}`);\n      }\n    }\n\n    process.exit(0);\n  })().catch((error) => {\n    console.error('Failed to generate rules:', error instanceof Error ? error.message : error);\n    process.exit(1);\n  });\n} else {\n  // Default: start MCP server\n  startMcpServer({\n    projectRoot,\n    searchApiKey: resolveSearchApiKey({ projectRoot }, fileConfig),\n    cloudApiKey,\n    source,\n    fileConfig,\n    adapter,\n  }).catch((error) => {\n    console.error('Failed to start MCP server:', error);\n    process.exit(1);\n  });\n}\n"],"mappings":"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","names":["projectRoot"]}