@fragments-sdk/mcp 0.10.1 → 1.0.2

package/dist/init.js

@@ -1,175 +0,0 @@
-import {
-  generateRulesFiles
-} from "./chunk-WDQPNHZ2.js";
-import "./chunk-7D4SUZUM.js";
-
-// src/init.ts
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
-import { join, dirname, relative } from "path";
-var SERVER_ENTRY = {
-  command: "npx",
-  args: ["-y", "@fragments-sdk/mcp@latest"]
-};
-var CLIENT_TARGETS = [
-  {
-    name: "Claude Code",
-    key: "claude",
-    configPath: (root) => join(root, ".mcp.json"),
-    wrapperKey: "mcpServers",
-    serverEntry: SERVER_ENTRY
-    // Always offered — Claude Code uses a dotfile, no directory to detect.
-  },
-  {
-    name: "Cursor",
-    key: "cursor",
-    configPath: (root) => join(root, ".cursor", "mcp.json"),
-    wrapperKey: "mcpServers",
-    serverEntry: SERVER_ENTRY,
-    detectDir: (root) => join(root, ".cursor")
-  },
-  {
-    name: "VS Code",
-    key: "vscode",
-    configPath: (root) => join(root, ".vscode", "mcp.json"),
-    wrapperKey: "servers",
-    serverEntry: { type: "stdio", ...SERVER_ENTRY },
-    detectDir: (root) => join(root, ".vscode")
-  },
-  {
-    name: "Windsurf",
-    key: "windsurf",
-    configPath: (root) => join(root, ".windsurf", "mcp.json"),
-    wrapperKey: "mcpServers",
-    serverEntry: SERVER_ENTRY,
-    detectDir: (root) => join(root, ".windsurf")
-  }
-];
-function hasFragmentsMcp(servers) {
-  return Object.values(servers).some((server) => {
-    const s = server;
-    return s.args?.some((arg) => arg.includes("@fragments-sdk/mcp"));
-  });
-}
-function writeConfig(configPath, target) {
-  if (existsSync(configPath)) {
-    try {
-      const raw = readFileSync(configPath, "utf-8");
-      const config2 = JSON.parse(raw);
-      const servers = config2[target.wrapperKey] || {};
-      if (servers.fragments || hasFragmentsMcp(servers)) {
-        return "exists";
-      }
-      servers.fragments = target.serverEntry;
-      config2[target.wrapperKey] = servers;
-      writeFileSync(configPath, JSON.stringify(config2, null, 2) + "\n", "utf-8");
-      return "added";
-    } catch {
-      return "could not parse existing config";
-    }
-  }
-  mkdirSync(dirname(configPath), { recursive: true });
-  const config = { [target.wrapperKey]: { fragments: target.serverEntry } };
-  writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
-  return "created";
-}
-function runInit(options) {
-  const { projectRoot } = options;
-  let targets;
-  if (options.clients?.length) {
-    const valid = new Set(CLIENT_TARGETS.map((t) => t.key));
-    for (const c of options.clients) {
-      if (!valid.has(c)) {
-        console.error(`Unknown client "${c}". Valid: ${[...valid].join(", ")}`);
-        process.exit(1);
-      }
-    }
-    targets = CLIENT_TARGETS.filter((t) => options.clients.includes(t.key));
-  } else {
-    targets = CLIENT_TARGETS.filter((t) => {
-      if (t.key === "claude") return true;
-      return t.detectDir ? existsSync(t.detectDir(projectRoot)) : false;
-    });
-  }
-  if (targets.length === 0) {
-    console.log(
-      "No MCP clients detected. Use --client to specify: claude, cursor, vscode, windsurf"
-    );
-    process.exit(1);
-  }
-  console.log("\nFragments MCP \u2014 Init\n");
-  let configured = 0;
-  let skipped = 0;
-  for (const target of targets) {
-    const configPath = target.configPath(projectRoot);
-    const rel = relative(projectRoot, configPath) || configPath;
-    const result = writeConfig(configPath, target);
-    if (result === "created") {
-      console.log(`  + ${target.name}  \u2192  ${rel}  (created)`);
-      configured++;
-    } else if (result === "added") {
-      console.log(`  + ${target.name}  \u2192  ${rel}  (updated)`);
-      configured++;
-    } else if (result === "exists") {
-      console.log(`  \xB7 ${target.name}  \u2014  already configured`);
-      skipped++;
-    } else {
-      console.log(`  ! ${target.name}  \u2014  ${result}`);
-    }
-  }
-  let rulesWritten = [];
-  if (options.generateRules !== false) {
-    rulesWritten = generateRulesFiles({
-      data: emptyDesignSystemData(),
-      brandName: "Fragments",
-      outputDir: projectRoot,
-      formats: ["cursor", "claude", "copilot"],
-      force: false
-    });
-  }
-  const hasFragmentsJson = existsSync(join(projectRoot, "fragments.json"));
-  const hasTsConfig = existsSync(join(projectRoot, "tsconfig.json")) || existsSync(join(projectRoot, "tsconfig.app.json"));
-  console.log();
-  if (hasFragmentsJson) {
-    console.log("  Mode: fragments.json (compiled definitions)");
-  } else if (hasTsConfig) {
-    console.log("  Mode: auto-extraction (zero-config)");
-  } else {
-    console.log("  Mode: will auto-detect on first run");
-  }
-  console.log();
-  if (configured > 0) {
-    console.log(`  Done \u2014 configured ${configured} client(s).`);
-  } else {
-    console.log("  Already configured \u2014 no changes needed.");
-  }
-  if (rulesWritten.length > 0) {
-    console.log(`  Wrote ${rulesWritten.length} rules file(s) for the validation loop.`);
-  }
-  console.log();
-  console.log("  Next steps:");
-  console.log("    1. Restart your editor to activate the MCP server");
-  console.log('    2. Ask your AI assistant: "What components are available?"');
-  console.log("    3. After it generates UI, have it call the Fragments MCP govern tool");
-  console.log();
-}
-function emptyDesignSystemData() {
-  const capabilities = [];
-  return {
-    snapshot: {
-      schemaVersion: 1,
-      sourceType: "custom-json",
-      sourceLabel: "init",
-      capabilities,
-      metadata: {},
-      components: {},
-      packageMap: {}
-    },
-    components: {},
-    packageMap: {},
-    capabilities: new Set(capabilities)
-  };
-}
-export {
-  runInit
-};
-//# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/init.ts"],"sourcesContent":["/**\n * `fragments-mcp init` — write MCP config for detected AI clients.\n *\n * Auto-detects Claude Code, Cursor, VS Code, and Windsurf, then merges a\n * \"fragments\" server entry into each client's config file. Idempotent —\n * skips clients that already have the server configured.\n */\n\nimport { existsSync, readFileSync, writeFileSync, mkdirSync } from \"node:fs\";\nimport { join, dirname, relative } from \"node:path\";\nimport { generateRulesFiles } from \"./rules.js\";\nimport type { DesignSystemData } from \"./types.js\";\nimport type { McpCapability } from \"@fragments-sdk/core\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type Client = \"claude\" | \"cursor\" | \"vscode\" | \"windsurf\";\n\ninterface ClientTarget {\n  name: string;\n  key: Client;\n  /** Absolute path to the MCP config file. */\n  configPath: (root: string) => string;\n  /** Top-level key that holds server entries (\"mcpServers\" or \"servers\"). */\n  wrapperKey: string;\n  /** The server entry to write. */\n  serverEntry: Record<string, unknown>;\n  /** Directory whose existence signals the client is in use (optional). */\n  detectDir?: (root: string) => string;\n}\n\nexport interface InitOptions {\n  projectRoot: string;\n  /** Explicit client list — overrides auto-detection. */\n  clients?: Client[];\n  /** Write IDE rules files alongside MCP config (default: true). */\n  generateRules?: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Client definitions\n// ---------------------------------------------------------------------------\n\nconst SERVER_ENTRY = {\n  command: \"npx\",\n  args: [\"-y\", \"@fragments-sdk/mcp@latest\"],\n};\n\nconst CLIENT_TARGETS: ClientTarget[] = [\n  {\n    name: \"Claude Code\",\n    key: \"claude\",\n    configPath: (root) => join(root, \".mcp.json\"),\n    wrapperKey: \"mcpServers\",\n    serverEntry: SERVER_ENTRY,\n    // Always offered — Claude Code uses a dotfile, no directory to detect.\n  },\n  {\n    name: \"Cursor\",\n    key: \"cursor\",\n    configPath: (root) => join(root, \".cursor\", \"mcp.json\"),\n    wrapperKey: \"mcpServers\",\n    serverEntry: SERVER_ENTRY,\n    detectDir: (root) => join(root, \".cursor\"),\n  },\n  {\n    name: \"VS Code\",\n    key: \"vscode\",\n    configPath: (root) => join(root, \".vscode\", \"mcp.json\"),\n    wrapperKey: \"servers\",\n    serverEntry: { type: \"stdio\", ...SERVER_ENTRY },\n    detectDir: (root) => join(root, \".vscode\"),\n  },\n  {\n    name: \"Windsurf\",\n    key: \"windsurf\",\n    configPath: (root) => join(root, \".windsurf\", \"mcp.json\"),\n    wrapperKey: \"mcpServers\",\n    serverEntry: SERVER_ENTRY,\n    detectDir: (root) => join(root, \".windsurf\"),\n  },\n];\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction hasFragmentsMcp(servers: Record<string, unknown>): boolean {\n  return Object.values(servers).some((server) => {\n    const s = server as { args?: string[] };\n    return s.args?.some((arg: string) => arg.includes(\"@fragments-sdk/mcp\"));\n  });\n}\n\ntype WriteResult = \"created\" | \"added\" | \"exists\" | string;\n\nfunction writeConfig(configPath: string, target: ClientTarget): WriteResult {\n  if (existsSync(configPath)) {\n    try {\n      const raw = readFileSync(configPath, \"utf-8\");\n      const config = JSON.parse(raw);\n      const servers = config[target.wrapperKey] || {};\n\n      if (servers.fragments || hasFragmentsMcp(servers)) {\n        return \"exists\";\n      }\n\n      servers.fragments = target.serverEntry;\n      config[target.wrapperKey] = servers;\n      writeFileSync(configPath, JSON.stringify(config, null, 2) + \"\\n\", \"utf-8\");\n      return \"added\";\n    } catch {\n      return \"could not parse existing config\";\n    }\n  }\n\n  mkdirSync(dirname(configPath), { recursive: true });\n  const config = { [target.wrapperKey]: { fragments: target.serverEntry } };\n  writeFileSync(configPath, JSON.stringify(config, null, 2) + \"\\n\", \"utf-8\");\n  return \"created\";\n}\n\n// ---------------------------------------------------------------------------\n// Main\n// ---------------------------------------------------------------------------\n\nexport function runInit(options: InitOptions): void {\n  const { projectRoot } = options;\n\n  // Resolve targets --------------------------------------------------------\n  let targets: ClientTarget[];\n\n  if (options.clients?.length) {\n    const valid = new Set<string>(CLIENT_TARGETS.map((t) => t.key));\n    for (const c of options.clients) {\n      if (!valid.has(c)) {\n        console.error(`Unknown client \"${c}\". Valid: ${[...valid].join(\", \")}`);\n        process.exit(1);\n      }\n    }\n    targets = CLIENT_TARGETS.filter((t) => options.clients!.includes(t.key));\n  } else {\n    // Auto-detect: always include Claude Code + any editors with existing dirs\n    targets = CLIENT_TARGETS.filter((t) => {\n      if (t.key === \"claude\") return true;\n      return t.detectDir ? existsSync(t.detectDir(projectRoot)) : false;\n    });\n  }\n\n  if (targets.length === 0) {\n    console.log(\n      \"No MCP clients detected. Use --client to specify: claude, cursor, vscode, windsurf\",\n    );\n    process.exit(1);\n  }\n\n  // Write configs ----------------------------------------------------------\n  console.log(\"\\nFragments MCP \\u2014 Init\\n\");\n\n  let configured = 0;\n  let skipped = 0;\n\n  for (const target of targets) {\n    const configPath = target.configPath(projectRoot);\n    const rel = relative(projectRoot, configPath) || configPath;\n    const result = writeConfig(configPath, target);\n\n    if (result === \"created\") {\n      console.log(`  + ${target.name}  \\u2192  ${rel}  (created)`);\n      configured++;\n    } else if (result === \"added\") {\n      console.log(`  + ${target.name}  \\u2192  ${rel}  (updated)`);\n      configured++;\n    } else if (result === \"exists\") {\n      console.log(`  · ${target.name}  \\u2014  already configured`);\n      skipped++;\n    } else {\n      console.log(`  ! ${target.name}  \\u2014  ${result}`);\n    }\n  }\n\n  let rulesWritten: string[] = [];\n  if (options.generateRules !== false) {\n    rulesWritten = generateRulesFiles({\n      data: emptyDesignSystemData(),\n      brandName: \"Fragments\",\n      outputDir: projectRoot,\n      formats: [\"cursor\", \"claude\", \"copilot\"],\n      force: false,\n    });\n  }\n\n  // Detection mode ---------------------------------------------------------\n  const hasFragmentsJson = existsSync(join(projectRoot, \"fragments.json\"));\n  const hasTsConfig =\n    existsSync(join(projectRoot, \"tsconfig.json\")) ||\n    existsSync(join(projectRoot, \"tsconfig.app.json\"));\n\n  console.log();\n  if (hasFragmentsJson) {\n    console.log(\"  Mode: fragments.json (compiled definitions)\");\n  } else if (hasTsConfig) {\n    console.log(\"  Mode: auto-extraction (zero-config)\");\n  } else {\n    console.log(\"  Mode: will auto-detect on first run\");\n  }\n\n  // Summary ----------------------------------------------------------------\n  console.log();\n  if (configured > 0) {\n    console.log(`  Done \\u2014 configured ${configured} client(s).`);\n  } else {\n    console.log(\"  Already configured \\u2014 no changes needed.\");\n  }\n\n  if (rulesWritten.length > 0) {\n    console.log(`  Wrote ${rulesWritten.length} rules file(s) for the validation loop.`);\n  }\n\n  console.log();\n  console.log(\"  Next steps:\");\n  console.log(\"    1. Restart your editor to activate the MCP server\");\n  console.log('    2. Ask your AI assistant: \"What components are available?\"');\n  console.log('    3. After it generates UI, have it call the Fragments MCP govern tool');\n  console.log();\n}\n\nfunction emptyDesignSystemData(): DesignSystemData {\n  const capabilities: McpCapability[] = [];\n  return {\n    snapshot: {\n      schemaVersion: 1,\n      sourceType: \"custom-json\",\n      sourceLabel: \"init\",\n      capabilities,\n      metadata: {},\n      components: {},\n      packageMap: {},\n    },\n    components: {},\n    packageMap: {},\n    capabilities: new Set(capabilities),\n  };\n}\n"],"mappings":"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","names":["config"]}

package/dist/rules-JUZ3RABB.js

@@ -1,8 +0,0 @@
-import {
-  generateRulesFiles
-} from "./chunk-WDQPNHZ2.js";
-import "./chunk-7D4SUZUM.js";
-export {
-  generateRulesFiles
-};
-//# sourceMappingURL=rules-JUZ3RABB.js.map

package/dist/rules-JUZ3RABB.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}