@atomixstudio/mcp 1.0.9 → 1.0.11

package/dist/index.js

@@ -11,29 +11,1281 @@ import {
   ListPromptsRequestSchema,
   GetPromptRequestSchema
 } from "@modelcontextprotocol/sdk/types.js";
-import {
-  fetchDesignSystem,
-  getTokenByPath,
-  flattenTokens,
-  searchTokens,
-  getTokenStats,
-  compareDesignSystems,
-  generateCSSOutput,
-  generateSCSSOutput,
-  generateLessOutput,
-  generateJSONOutput,
-  generateTSOutput,
-  generateJSOutput,
-  generateSwiftOutput,
-  generateKotlinOutput,
-  generateDartOutput,
-  diffTokens,
-  formatSyncResponse,
-  detectGovernanceChangesByFoundation,
-  syncRulesFiles
-} from "@atomixstudio/sync-core";
-import * as path from "path";
+
+// node_modules/.pnpm/@atomixstudio+sync-core@file+..+atomix-sync-core/node_modules/@atomixstudio/sync-core/dist/index.js
 import * as fs from "fs";
+import * as path from "path";
+import * as path3 from "path";
+function generateETag(meta) {
+  const ts = meta.updatedAt ?? meta.exportedAt ?? "";
+  const hash = `${meta.version}-${ts}`;
+  return `"v${hash}"`;
+}
+function compareDesignSystems(cached, fresh) {
+  const changes = {
+    hasChanges: false,
+    versionChanged: false,
+    timestampChanged: false,
+    addedTokens: [],
+    removedTokens: [],
+    modifiedTokens: [],
+    governanceChanged: false,
+    summary: ""
+  };
+  if (cached.meta.version !== fresh.meta.version) {
+    changes.versionChanged = true;
+    changes.hasChanges = true;
+  }
+  if (cached.meta.exportedAt !== fresh.meta.exportedAt) {
+    changes.timestampChanged = true;
+    changes.hasChanges = true;
+  }
+  const cachedVars = Object.keys(cached.cssVariables);
+  const freshVars = Object.keys(fresh.cssVariables);
+  for (const varName of freshVars) {
+    if (!(varName in cached.cssVariables)) {
+      changes.addedTokens.push(varName);
+      changes.hasChanges = true;
+    }
+  }
+  for (const varName of cachedVars) {
+    if (!(varName in fresh.cssVariables)) {
+      changes.removedTokens.push(varName);
+      changes.hasChanges = true;
+    }
+  }
+  for (const varName of cachedVars) {
+    if (varName in fresh.cssVariables) {
+      const oldValue = cached.cssVariables[varName];
+      const newValue = fresh.cssVariables[varName];
+      if (oldValue !== newValue) {
+        changes.modifiedTokens.push({
+          token: varName,
+          oldValue,
+          newValue
+        });
+        changes.hasChanges = true;
+      }
+    }
+  }
+  const cachedDark = cached.tokens?.colors?.modes;
+  const freshDark = fresh.tokens?.colors?.modes;
+  const cachedDarkColors = cachedDark?.dark || {};
+  const freshDarkColors = freshDark?.dark || {};
+  const cachedDarkKeys = Object.keys(cachedDarkColors);
+  const freshDarkKeys = Object.keys(freshDarkColors);
+  const firstColorVar = cachedVars.find((v) => v.includes("-color-")) || freshVars.find((v) => v.includes("-color-"));
+  const prefixMatch = firstColorVar?.match(/^(--[a-z]+-color-)/);
+  const colorPrefix = prefixMatch ? prefixMatch[1] : "--atmx-color-";
+  for (const key of freshDarkKeys) {
+    if (!(key in cachedDarkColors)) {
+      const cssVarName = `${colorPrefix}${key}`;
+      if (!changes.addedTokens.includes(cssVarName)) {
+        changes.addedTokens.push(cssVarName);
+        changes.hasChanges = true;
+      }
+    }
+  }
+  for (const key of cachedDarkKeys) {
+    if (!(key in freshDarkColors)) {
+      const cssVarName = `${colorPrefix}${key}`;
+      if (!changes.removedTokens.includes(cssVarName)) {
+        changes.removedTokens.push(cssVarName);
+        changes.hasChanges = true;
+      }
+    }
+  }
+  for (const key of cachedDarkKeys) {
+    if (key in freshDarkColors) {
+      const oldValue = cachedDarkColors[key];
+      const newValue = freshDarkColors[key];
+      if (oldValue !== newValue) {
+        const cssVarName = `${colorPrefix}${key}`;
+        const existingIndex = changes.modifiedTokens.findIndex((m) => m.token === cssVarName);
+        if (existingIndex >= 0) {
+          changes.modifiedTokens[existingIndex].oldValue += ` | dark: ${oldValue}`;
+          changes.modifiedTokens[existingIndex].newValue += ` | dark: ${newValue}`;
+        } else {
+          changes.modifiedTokens.push({
+            token: `${cssVarName} (dark mode)`,
+            oldValue,
+            newValue
+          });
+          changes.hasChanges = true;
+        }
+      }
+    }
+  }
+  const cachedGovernance = cached.governance || { rules: [], categories: {} };
+  const freshGovernance = fresh.governance || { rules: [], categories: {} };
+  const cachedRules = cachedGovernance.rules || [];
+  const freshRules = freshGovernance.rules || [];
+  const cachedCategories = cachedGovernance.categories || {};
+  const freshCategories = freshGovernance.categories || {};
+  const cachedRulesStr = JSON.stringify(cachedRules.sort());
+  const freshRulesStr = JSON.stringify(freshRules.sort());
+  const cachedCategoriesStr = JSON.stringify(cachedCategories, Object.keys(cachedCategories).sort());
+  const freshCategoriesStr = JSON.stringify(freshCategories, Object.keys(freshCategories).sort());
+  if (cachedRulesStr !== freshRulesStr || cachedCategoriesStr !== freshCategoriesStr) {
+    changes.governanceChanged = true;
+    changes.hasChanges = true;
+  }
+  const summaryLines = [];
+  if (!changes.hasChanges) {
+    summaryLines.push("\u2713 No changes detected - design system is up to date");
+  } else {
+    summaryLines.push("\u{1F4E6} Design System Changes Detected:");
+    summaryLines.push("");
+    if (changes.versionChanged) {
+      summaryLines.push(`  Version: ${cached.meta.version} \u2192 ${fresh.meta.version}`);
+    }
+    if (changes.timestampChanged) {
+      const cachedDate = new Date(cached.meta.exportedAt).toLocaleString();
+      const freshDate = new Date(fresh.meta.exportedAt).toLocaleString();
+      summaryLines.push(`  Published: ${cachedDate} \u2192 ${freshDate}`);
+    }
+    if (changes.addedTokens.length > 0) {
+      summaryLines.push(`  \u2795 Added: ${changes.addedTokens.length} token(s)`);
+      if (changes.addedTokens.length <= 10) {
+        changes.addedTokens.forEach((token) => {
+          summaryLines.push(`    - ${token}`);
+        });
+      } else {
+        changes.addedTokens.slice(0, 10).forEach((token) => {
+          summaryLines.push(`    - ${token}`);
+        });
+        summaryLines.push(`    ... and ${changes.addedTokens.length - 10} more`);
+      }
+    }
+    if (changes.removedTokens.length > 0) {
+      summaryLines.push(`  \u2796 Removed: ${changes.removedTokens.length} token(s)`);
+      if (changes.removedTokens.length <= 10) {
+        changes.removedTokens.forEach((token) => {
+          summaryLines.push(`    - ${token}`);
+        });
+      } else {
+        changes.removedTokens.slice(0, 10).forEach((token) => {
+          summaryLines.push(`    - ${token}`);
+        });
+        summaryLines.push(`    ... and ${changes.removedTokens.length - 10} more`);
+      }
+    }
+    if (changes.modifiedTokens.length > 0) {
+      summaryLines.push(`  \u{1F504} Modified: ${changes.modifiedTokens.length} token(s)`);
+      if (changes.modifiedTokens.length <= 10) {
+        changes.modifiedTokens.forEach(({ token, oldValue, newValue }) => {
+          summaryLines.push(`    ${token}:`);
+          summaryLines.push(`      - ${oldValue}`);
+          summaryLines.push(`      + ${newValue}`);
+        });
+      } else {
+        changes.modifiedTokens.slice(0, 5).forEach(({ token, oldValue, newValue }) => {
+          summaryLines.push(`    ${token}:`);
+          summaryLines.push(`      - ${oldValue}`);
+          summaryLines.push(`      + ${newValue}`);
+        });
+        summaryLines.push(`    ... and ${changes.modifiedTokens.length - 5} more`);
+      }
+    }
+    if (changes.governanceChanged) {
+      summaryLines.push(`  \u{1F4DD} AI guide updated`);
+    }
+  }
+  changes.summary = summaryLines.join("\n");
+  return changes;
+}
+function detectGovernanceChangesByFoundation(cached, fresh) {
+  const changes = [];
+  const cachedGov = cached.governance || { rules: [], categories: {} };
+  const freshGov = fresh.governance || { rules: [], categories: {} };
+  const cachedRulesStr = JSON.stringify((cachedGov.rules || []).sort());
+  const freshRulesStr = JSON.stringify((freshGov.rules || []).sort());
+  if (cachedRulesStr !== freshRulesStr) {
+    changes.push("general");
+  }
+  const cachedCategories = cachedGov.categories || {};
+  const freshCategories = freshGov.categories || {};
+  const allFoundationKeys = /* @__PURE__ */ new Set([
+    ...Object.keys(cachedCategories),
+    ...Object.keys(freshCategories)
+  ]);
+  for (const foundation of allFoundationKeys) {
+    const cachedRules = cachedCategories[foundation] || [];
+    const freshRules = freshCategories[foundation] || [];
+    const cachedRulesStr2 = JSON.stringify(cachedRules.sort());
+    const freshRulesStr2 = JSON.stringify(freshRules.sort());
+    if (cachedRulesStr2 !== freshRulesStr2) {
+      changes.push(foundation);
+    }
+  }
+  return changes;
+}
+async function fetchDesignSystem(options) {
+  const { dsId: dsId2, apiKey: apiKey2, apiBase: apiBase2 = "https://atomixstudio.eu", etag, forceRefresh = false } = options;
+  if (!dsId2) {
+    throw new Error("Missing dsId. Usage: fetchDesignSystem({ dsId: '...' })");
+  }
+  const url = `${apiBase2}/api/ds/${dsId2}/tokens?format=export`;
+  const headers = {
+    "Content-Type": "application/json"
+  };
+  if (apiKey2) {
+    headers["x-api-key"] = apiKey2;
+  }
+  if (etag) {
+    headers["if-none-match"] = etag;
+  }
+  const response = await fetch(url, { headers });
+  if (response.status === 304) {
+    return {
+      data: null,
+      etag,
+      status: 304
+    };
+  }
+  if (!response.ok) {
+    const text = await response.text();
+    throw new Error(`Failed to fetch design system: ${response.status} ${text}`);
+  }
+  const data = await response.json();
+  const responseETag = response.headers.get("etag");
+  const finalETag = responseETag || generateETag(data.meta);
+  const designSystemData = {
+    tokens: data.tokens,
+    cssVariables: data.cssVariables,
+    governance: data.governance,
+    meta: data.meta
+  };
+  return {
+    data: designSystemData,
+    etag: finalETag,
+    status: 200
+  };
+}
+function diffTokens(oldContent, newCssVars, format, newDarkVars) {
+  const added = [];
+  const modified = [];
+  const removed = [];
+  const addedDark = [];
+  const modifiedDark = [];
+  const removedDark = [];
+  if (format === "css" || format === "scss" || format === "less") {
+    const rootMatch = oldContent.match(/:root\s*\{([^}]*)\}/);
+    const darkMatch = oldContent.match(/\.dark[^{]*\{([^}]*)\}/);
+    const oldLightVars = {};
+    if (rootMatch) {
+      const rootContent = rootMatch[1];
+      const varRegex = /(--[\w-]+):\s*([^;]+);/g;
+      let match;
+      while ((match = varRegex.exec(rootContent)) !== null) {
+        oldLightVars[match[1]] = match[2].trim();
+      }
+    } else {
+      const varRegex = /(--[\w-]+):\s*([^;]+);/g;
+      let match;
+      while ((match = varRegex.exec(oldContent)) !== null) {
+        if (!(match[1] in oldLightVars)) {
+          oldLightVars[match[1]] = match[2].trim();
+        }
+      }
+    }
+    const oldDarkVars = {};
+    if (darkMatch) {
+      const darkContent = darkMatch[1];
+      const varRegex = /(--[\w-]+):\s*([^;]+);/g;
+      let match;
+      while ((match = varRegex.exec(darkContent)) !== null) {
+        oldDarkVars[match[1]] = match[2].trim();
+      }
+    }
+    for (const [key, value] of Object.entries(newCssVars)) {
+      if (!(key in oldLightVars)) {
+        added.push(key);
+      } else if (oldLightVars[key] !== value) {
+        modified.push({ key, old: oldLightVars[key], new: value });
+      }
+    }
+    for (const key of Object.keys(oldLightVars)) {
+      if (!(key in newCssVars)) {
+        removed.push(key);
+      }
+    }
+    if (newDarkVars && Object.keys(newDarkVars).length > 0) {
+      const firstKey = Object.keys(newCssVars)[0] || "--atmx-";
+      const prefixMatch = firstKey.match(/^(--[a-z]+-)/);
+      const prefix = prefixMatch ? prefixMatch[1] : "--atmx-";
+      for (const [key, value] of Object.entries(newDarkVars)) {
+        const cssVarName = `${prefix}color-${key}`;
+        if (!(cssVarName in oldDarkVars)) {
+          addedDark.push(cssVarName);
+        } else if (oldDarkVars[cssVarName] !== value) {
+          modifiedDark.push({ key: cssVarName, old: oldDarkVars[cssVarName], new: value });
+        }
+      }
+      for (const key of Object.keys(oldDarkVars)) {
+        const shortKey = key.replace(new RegExp(`^${prefix}color-`), "");
+        if (!(shortKey in newDarkVars)) {
+          removedDark.push(key);
+        }
+      }
+    }
+  }
+  return { added, modified, removed, addedDark, modifiedDark, removedDark };
+}
+async function syncRulesFiles(options) {
+  const { dsId: dsId2, apiKey: apiKey2, apiBase: apiBase2 = "https://atomixstudio.eu", rulesDir = process.cwd() } = options;
+  const rulesDirResolved = path.resolve(process.cwd(), rulesDir);
+  const toolsToSync = [
+    { tool: "cursor", filename: ".cursorrules" },
+    { tool: "windsurf", filename: ".windsurfrules" },
+    { tool: "cline", filename: ".clinerules" },
+    { tool: "continue", filename: ".continuerules" },
+    { tool: "copilot", filename: "copilot-instructions.md", dir: ".github" },
+    { tool: "generic", filename: "AI_GUIDELINES.md" }
+  ];
+  const existingTools = toolsToSync.filter((t) => {
+    const filePath = t.dir ? path.join(rulesDirResolved, t.dir, t.filename) : path.join(rulesDirResolved, t.filename);
+    return fs.existsSync(filePath);
+  });
+  const toolsToWrite = existingTools.length > 0 ? existingTools : [{ tool: "cursor", filename: ".cursorrules" }];
+  const results = [];
+  for (const { tool, filename, dir } of toolsToWrite) {
+    try {
+      const rulesUrl = `${apiBase2}/api/ds/${dsId2}/rules?format=${tool}`;
+      const headers = { "Content-Type": "application/json" };
+      if (apiKey2) headers["x-api-key"] = apiKey2;
+      const response = await fetch(rulesUrl, { headers });
+      if (!response.ok) {
+        results.push({
+          tool,
+          filename,
+          path: dir ? `${dir}/${filename}` : filename,
+          success: false,
+          error: `Failed to fetch ${tool} rules: ${response.status}`
+        });
+        continue;
+      }
+      const rulesData = await response.json();
+      if (!rulesData.content) {
+        results.push({
+          tool,
+          filename,
+          path: dir ? `${dir}/${filename}` : filename,
+          success: false,
+          error: `No content for ${tool} rules`
+        });
+        continue;
+      }
+      const targetDir = dir ? path.join(rulesDirResolved, dir) : rulesDirResolved;
+      if (!fs.existsSync(targetDir)) {
+        fs.mkdirSync(targetDir, { recursive: true });
+      }
+      const filePath = path.join(targetDir, filename);
+      fs.writeFileSync(filePath, rulesData.content);
+      results.push({
+        tool,
+        filename,
+        path: dir ? `${dir}/${filename}` : filename,
+        success: true
+      });
+    } catch (error) {
+      results.push({
+        tool,
+        filename,
+        path: dir ? `${dir}/${filename}` : filename,
+        success: false,
+        error: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
+  return results;
+}
+function generateCSSOutput(cssVariables, darkModeColors, deprecatedTokens = /* @__PURE__ */ new Map()) {
+  const lines = [
+    "/* Atomix Design System Tokens",
+    " * Auto-generated - do not edit manually",
+    ` * Synced: ${(/* @__PURE__ */ new Date()).toISOString()}`,
+    " *",
+    " * WARNING: This file is completely rewritten on each sync.",
+    " * Only CSS custom properties (variables) are preserved.",
+    " * Custom CSS rules (selectors, classes, etc.) will be lost.",
+    " * Keep custom CSS in a separate file.",
+    " */",
+    "",
+    "/* Light mode (default) */",
+    ":root {"
+  ];
+  const allVars = /* @__PURE__ */ new Map();
+  for (const [key, value] of Object.entries(cssVariables)) {
+    allVars.set(key, { value, deprecated: false });
+  }
+  for (const [key, value] of deprecatedTokens.entries()) {
+    allVars.set(key, { value, deprecated: true });
+  }
+  const sortedKeys = Array.from(allVars.keys()).sort();
+  for (const key of sortedKeys) {
+    const { value, deprecated } = allVars.get(key);
+    if (deprecated) {
+      lines.push(`  /* DEPRECATED */ ${key}: ${value};`);
+    } else {
+      lines.push(`  ${key}: ${value};`);
+    }
+  }
+  lines.push("}");
+  if (darkModeColors && Object.keys(darkModeColors).length > 0) {
+    lines.push("");
+    lines.push("/* Dark mode */");
+    lines.push(".dark,");
+    lines.push('[data-theme="dark"] {');
+    const firstKey = sortedKeys[0] || "--atmx-";
+    const prefixMatch = firstKey.match(/^(--[a-z]+-)/);
+    const prefix = prefixMatch ? prefixMatch[1] : "--atmx-";
+    const sortedDarkKeys = Object.keys(darkModeColors).sort();
+    for (const key of sortedDarkKeys) {
+      lines.push(`  ${prefix}color-${key}: ${darkModeColors[key]};`);
+    }
+    lines.push("}");
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+function generateSCSSOutput(cssVariables, darkModeColors, deprecatedTokens = /* @__PURE__ */ new Map()) {
+  const lines = [
+    "// Atomix Design System Tokens",
+    "// Auto-generated - do not edit manually",
+    `// Synced: ${(/* @__PURE__ */ new Date()).toISOString()}`,
+    "",
+    "// CSS Custom Properties (for use in CSS/HTML)",
+    "// Light mode (default)",
+    ":root {"
+  ];
+  const allVars = /* @__PURE__ */ new Map();
+  for (const [key, value] of Object.entries(cssVariables)) {
+    allVars.set(key, { value, deprecated: false });
+  }
+  for (const [key, value] of deprecatedTokens.entries()) {
+    allVars.set(key, { value, deprecated: true });
+  }
+  const sortedKeys = Array.from(allVars.keys()).sort();
+  for (const key of sortedKeys) {
+    const { value, deprecated } = allVars.get(key);
+    if (deprecated) {
+      lines.push(`  // DEPRECATED ${key}: ${value};`);
+    } else {
+      lines.push(`  ${key}: ${value};`);
+    }
+  }
+  lines.push("}");
+  if (darkModeColors && Object.keys(darkModeColors).length > 0) {
+    lines.push("");
+    lines.push("// Dark mode");
+    lines.push(".dark,");
+    lines.push('[data-theme="dark"] {');
+    const firstKey = sortedKeys[0] || "--atmx-";
+    const prefixMatch = firstKey.match(/^(--[a-z]+-)/);
+    const prefix = prefixMatch ? prefixMatch[1] : "--atmx-";
+    for (const [key, value] of Object.entries(darkModeColors)) {
+      lines.push(`  ${prefix}color-${key}: ${value};`);
+    }
+    lines.push("}");
+  }
+  lines.push("");
+  lines.push("// SCSS Variables (light mode values)");
+  for (const key of sortedKeys) {
+    const { value, deprecated } = allVars.get(key);
+    const scssVar = "$" + key.replace(/^--/, "");
+    if (deprecated) {
+      lines.push(`// DEPRECATED ${scssVar}: ${value};`);
+    } else {
+      lines.push(`${scssVar}: ${value};`);
+    }
+  }
+  if (darkModeColors && Object.keys(darkModeColors).length > 0) {
+    lines.push("");
+    lines.push("// SCSS Variables (dark mode values)");
+    const firstKey = Object.keys(cssVariables)[0] || "--atmx-";
+    const prefixMatch = firstKey.match(/^--([a-z]+)-/);
+    const prefix = prefixMatch ? prefixMatch[1] : "atmx";
+    for (const [key, value] of Object.entries(darkModeColors)) {
+      const scssVar = `$${prefix}-color-${key}-dark`;
+      lines.push(`${scssVar}: ${value};`);
+    }
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+function generateLessOutput(cssVariables, darkModeColors, deprecatedTokens = /* @__PURE__ */ new Map()) {
+  const lines = [
+    "// Atomix Design System Tokens",
+    "// Auto-generated - do not edit manually",
+    `// Synced: ${(/* @__PURE__ */ new Date()).toISOString()}`,
+    "",
+    "// CSS Custom Properties (for use in CSS/HTML)",
+    "// Light mode (default)",
+    ":root {"
+  ];
+  const allVars = /* @__PURE__ */ new Map();
+  for (const [key, value] of Object.entries(cssVariables)) {
+    allVars.set(key, { value, deprecated: false });
+  }
+  for (const [key, value] of deprecatedTokens.entries()) {
+    allVars.set(key, { value, deprecated: true });
+  }
+  const sortedKeys = Array.from(allVars.keys()).sort();
+  for (const key of sortedKeys) {
+    const { value, deprecated } = allVars.get(key);
+    if (deprecated) {
+      lines.push(`  // DEPRECATED ${key}: ${value};`);
+    } else {
+      lines.push(`  ${key}: ${value};`);
+    }
+  }
+  lines.push("}");
+  if (darkModeColors && Object.keys(darkModeColors).length > 0) {
+    lines.push("");
+    lines.push("// Dark mode");
+    lines.push(".dark,");
+    lines.push('[data-theme="dark"] {');
+    const firstKey = Object.keys(cssVariables)[0] || "--atmx-";
+    const prefixMatch = firstKey.match(/^(--[a-z]+-)/);
+    const prefix = prefixMatch ? prefixMatch[1] : "--atmx-";
+    for (const [key, value] of Object.entries(darkModeColors)) {
+      lines.push(`  ${prefix}color-${key}: ${value};`);
+    }
+    lines.push("}");
+  }
+  lines.push("");
+  lines.push("// Less Variables (light mode values)");
+  for (const [key, value] of Object.entries(cssVariables)) {
+    const lessVar = "@" + key.replace(/^--/, "");
+    lines.push(`${lessVar}: ${value};`);
+  }
+  if (darkModeColors && Object.keys(darkModeColors).length > 0) {
+    lines.push("");
+    lines.push("// Less Variables (dark mode values)");
+    const firstKey = Object.keys(cssVariables)[0] || "--atmx-";
+    const prefixMatch = firstKey.match(/^--([a-z]+)-/);
+    const prefix = prefixMatch ? prefixMatch[1] : "atmx";
+    for (const [key, value] of Object.entries(darkModeColors)) {
+      const lessVar = `@${prefix}-color-${key}-dark`;
+      lines.push(`${lessVar}: ${value};`);
+    }
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+function generateJSONOutput(tokens) {
+  return JSON.stringify(tokens, null, 2);
+}
+function generateTSOutput(tokens) {
+  return `// Atomix Design System Tokens
+// Auto-generated - do not edit manually
+// Synced: ${(/* @__PURE__ */ new Date()).toISOString()}
+
+export const tokens = ${JSON.stringify(tokens, null, 2)} as const;
+
+export type Tokens = typeof tokens;
+`;
+}
+function generateJSOutput(tokens) {
+  return `// Atomix Design System Tokens
+// Auto-generated - do not edit manually
+// Synced: ${(/* @__PURE__ */ new Date()).toISOString()}
+
+export const tokens = ${JSON.stringify(tokens, null, 2)};
+`;
+}
+function toSwiftName(cssVar) {
+  return cssVar.replace(/^--atmx-/, "").replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+}
+function isColorValue(value) {
+  return /^#[0-9A-Fa-f]{3,8}$/.test(value) || /^rgb/.test(value) || /^hsl/.test(value);
+}
+function hexToSwiftColor(hex) {
+  const clean = hex.replace("#", "");
+  if (clean.length === 3) {
+    const r = clean[0], g = clean[1], b = clean[2];
+    return `Color(hex: 0x${r}${r}${g}${g}${b}${b})`;
+  }
+  if (clean.length === 6) {
+    return `Color(hex: 0x${clean})`;
+  }
+  if (clean.length === 8) {
+    const rgb = clean.substring(0, 6);
+    const alpha = parseInt(clean.substring(6, 8), 16) / 255;
+    return `Color(hex: 0x${rgb}).opacity(${alpha.toFixed(2)})`;
+  }
+  return `Color.clear // Could not parse: ${hex}`;
+}
+function generateSwiftOutput(cssVariables, darkModeColors, deprecatedTokens = /* @__PURE__ */ new Map()) {
+  const lines = [
+    "// Atomix Design System Tokens",
+    "// Auto-generated - do not edit manually",
+    `// Synced: ${(/* @__PURE__ */ new Date()).toISOString()}`,
+    "",
+    "import SwiftUI",
+    "",
+    "// MARK: - Color Extension for Hex",
+    "extension Color {",
+    "    init(hex: UInt, alpha: Double = 1.0) {",
+    "        self.init(",
+    "            .sRGB,",
+    "            red: Double((hex >> 16) & 0xFF) / 255.0,",
+    "            green: Double((hex >> 8) & 0xFF) / 255.0,",
+    "            blue: Double(hex & 0xFF) / 255.0,",
+    "            opacity: alpha",
+    "        )",
+    "    }",
+    "}",
+    "",
+    "// MARK: - Design Tokens",
+    "enum DesignTokens {",
+    "",
+    "    // MARK: Colors (Light Mode)",
+    "    enum Colors {"
+  ];
+  const colors = [];
+  const spacing = [];
+  const typography = [];
+  const other = [];
+  for (const [key, value] of Object.entries(cssVariables)) {
+    const isDeprecated = false;
+    if (key.includes("-color-")) colors.push([key, value, isDeprecated]);
+    else if (key.includes("-spacing-")) spacing.push([key, value, isDeprecated]);
+    else if (key.includes("-typography-") || key.includes("-font-")) typography.push([key, value, isDeprecated]);
+    else other.push([key, value, isDeprecated]);
+  }
+  for (const [key, value] of deprecatedTokens.entries()) {
+    const isDeprecated = true;
+    if (key.includes("-color-")) colors.push([key, value, isDeprecated]);
+    else if (key.includes("-spacing-")) spacing.push([key, value, isDeprecated]);
+    else if (key.includes("-typography-") || key.includes("-font-")) typography.push([key, value, isDeprecated]);
+    else other.push([key, value, isDeprecated]);
+  }
+  colors.sort((a, b) => a[0].localeCompare(b[0]));
+  spacing.sort((a, b) => a[0].localeCompare(b[0]));
+  typography.sort((a, b) => a[0].localeCompare(b[0]));
+  other.sort((a, b) => a[0].localeCompare(b[0]));
+  for (const [key, value, isDeprecated] of colors) {
+    const name = toSwiftName(key);
+    if (isColorValue(value)) {
+      if (isDeprecated) {
+        lines.push(`        @available(*, deprecated, message: "This token has been removed from the design system")`);
+        lines.push(`        static let ${name} = ${hexToSwiftColor(value)}`);
+      } else {
+        lines.push(`        static let ${name} = ${hexToSwiftColor(value)}`);
+      }
+    }
+  }
+  lines.push("    }");
+  if (darkModeColors && Object.keys(darkModeColors).length > 0) {
+    lines.push("");
+    lines.push("    // MARK: Colors (Dark Mode)");
+    lines.push("    enum ColorsDark {");
+    for (const [key, value] of Object.entries(darkModeColors)) {
+      const name = `color${key.split("-").map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join("")}`;
+      if (isColorValue(value)) {
+        lines.push(`        static let ${name} = ${hexToSwiftColor(value)}`);
+      }
+    }
+    lines.push("    }");
+  }
+  lines.push("");
+  lines.push("    // MARK: Spacing");
+  lines.push("    enum Spacing {");
+  for (const [key, value, isDeprecated] of spacing) {
+    const name = toSwiftName(key);
+    const numValue = parseFloat(value);
+    if (!isNaN(numValue)) {
+      if (isDeprecated) {
+        lines.push(`        @available(*, deprecated, message: "This token has been removed from the design system")`);
+        lines.push(`        static let ${name}: CGFloat = ${numValue}`);
+      } else {
+        lines.push(`        static let ${name}: CGFloat = ${numValue}`);
+      }
+    }
+  }
+  lines.push("    }");
+  lines.push("");
+  lines.push("    // MARK: Typography");
+  lines.push("    enum Typography {");
+  for (const [key, value, isDeprecated] of typography) {
+    const name = toSwiftName(key);
+    if (isDeprecated) {
+      lines.push(`        @available(*, deprecated, message: "This token has been removed from the design system")`);
+    }
+    if (key.includes("size")) {
+      const numValue = parseFloat(value);
+      if (!isNaN(numValue)) {
+        lines.push(`        static let ${name}: CGFloat = ${numValue}`);
+      }
+    } else if (key.includes("weight")) {
+      lines.push(`        static let ${name} = "${value}"`);
+    } else if (key.includes("family")) {
+      lines.push(`        static let ${name} = "${value}"`);
+    }
+  }
+  lines.push("    }");
+  lines.push("");
+  lines.push("    // MARK: Other");
+  lines.push("    enum Other {");
+  for (const [key, value, isDeprecated] of other) {
+    const name = toSwiftName(key);
+    if (isDeprecated) {
+      lines.push(`        @available(*, deprecated, message: "This token has been removed from the design system")`);
+    }
+    if (isColorValue(value)) {
+      lines.push(`        static let ${name} = ${hexToSwiftColor(value)}`);
+    } else {
+      const numValue = parseFloat(value);
+      if (!isNaN(numValue)) {
+        lines.push(`        static let ${name}: CGFloat = ${numValue}`);
+      } else {
+        lines.push(`        static let ${name} = "${value}"`);
+      }
+    }
+  }
+  lines.push("    }");
+  lines.push("}");
+  lines.push("");
+  return lines.join("\n");
+}
+function toSwiftName2(cssVar) {
+  return cssVar.replace(/^--atmx-/, "").replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+}
+function toKotlinName(cssVar) {
+  const camel = toSwiftName2(cssVar);
+  return camel.charAt(0).toUpperCase() + camel.slice(1);
+}
+function isColorValue2(value) {
+  return /^#[0-9A-Fa-f]{3,8}$/.test(value) || /^rgb/.test(value) || /^hsl/.test(value);
+}
+function hexToKotlinColor(hex) {
+  const clean = hex.replace("#", "").toUpperCase();
+  if (clean.length === 3) {
+    const r = clean[0], g = clean[1], b = clean[2];
+    return `Color(0xFF${r}${r}${g}${g}${b}${b})`;
+  }
+  if (clean.length === 6) {
+    return `Color(0xFF${clean})`;
+  }
+  if (clean.length === 8) {
+    const rgb = clean.substring(0, 6);
+    const alpha = clean.substring(6, 8);
+    return `Color(0x${alpha}${rgb})`;
+  }
+  return `Color.Transparent // Could not parse: ${hex}`;
+}
+function generateKotlinOutput(cssVariables, darkModeColors, deprecatedTokens = /* @__PURE__ */ new Map()) {
+  const lines = [
+    "// Atomix Design System Tokens",
+    "// Auto-generated - do not edit manually",
+    `// Synced: ${(/* @__PURE__ */ new Date()).toISOString()}`,
+    "",
+    "package com.atomix.design",
+    "",
+    "import androidx.compose.ui.graphics.Color",
+    "import androidx.compose.ui.unit.dp",
+    "import androidx.compose.ui.unit.sp",
+    "",
+    "object DesignTokens {",
+    "",
+    "    // Light mode colors",
+    "    object Colors {"
+  ];
+  const colors = [];
+  const spacing = [];
+  const typography = [];
+  const other = [];
+  for (const [key, value] of Object.entries(cssVariables)) {
+    const isDeprecated = false;
+    if (key.includes("-color-")) colors.push([key, value, isDeprecated]);
+    else if (key.includes("-spacing-")) spacing.push([key, value, isDeprecated]);
+    else if (key.includes("-typography-") || key.includes("-font-")) typography.push([key, value, isDeprecated]);
+    else other.push([key, value, isDeprecated]);
+  }
+  for (const [key, value] of deprecatedTokens.entries()) {
+    const isDeprecated = true;
+    if (key.includes("-color-")) colors.push([key, value, isDeprecated]);
+    else if (key.includes("-spacing-")) spacing.push([key, value, isDeprecated]);
+    else if (key.includes("-typography-") || key.includes("-font-")) typography.push([key, value, isDeprecated]);
+    else other.push([key, value, isDeprecated]);
+  }
+  colors.sort((a, b) => a[0].localeCompare(b[0]));
+  spacing.sort((a, b) => a[0].localeCompare(b[0]));
+  typography.sort((a, b) => a[0].localeCompare(b[0]));
+  other.sort((a, b) => a[0].localeCompare(b[0]));
+  for (const [key, value, isDeprecated] of colors) {
+    const name = toKotlinName(key);
+    if (isColorValue2(value)) {
+      if (isDeprecated) {
+        lines.push(`        @Deprecated("This token has been removed from the design system")`);
+        lines.push(`        val ${name} = ${hexToKotlinColor(value)}`);
+      } else {
+        lines.push(`        val ${name} = ${hexToKotlinColor(value)}`);
+      }
+    }
+  }
+  lines.push("    }");
+  if (darkModeColors && Object.keys(darkModeColors).length > 0) {
+    lines.push("");
+    lines.push("    // Dark mode colors");
+    lines.push("    object ColorsDark {");
+    for (const [key, value] of Object.entries(darkModeColors)) {
+      const name = `Color${key.split("-").map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join("")}`;
+      if (isColorValue2(value)) {
+        lines.push(`        val ${name} = ${hexToKotlinColor(value)}`);
+      }
+    }
+    lines.push("    }");
+  }
+  lines.push("");
+  lines.push("    object Spacing {");
+  for (const [key, value, isDeprecated] of spacing) {
+    const name = toKotlinName(key);
+    const numValue = parseFloat(value);
+    if (!isNaN(numValue)) {
+      if (isDeprecated) {
+        lines.push(`        @Deprecated("This token has been removed from the design system")`);
+        lines.push(`        val ${name} = ${numValue}.dp`);
+      } else {
+        lines.push(`        val ${name} = ${numValue}.dp`);
+      }
+    }
+  }
+  lines.push("    }");
+  lines.push("");
+  lines.push("    object Typography {");
+  for (const [key, value, isDeprecated] of typography) {
+    const name = toKotlinName(key);
+    if (isDeprecated) {
+      lines.push(`        @Deprecated("This token has been removed from the design system")`);
+    }
+    if (key.includes("size")) {
+      const numValue = parseFloat(value);
+      if (!isNaN(numValue)) {
+        lines.push(`        val ${name} = ${numValue}.sp`);
+      }
+    } else {
+      lines.push(`        const val ${name} = "${value}"`);
+    }
+  }
+  lines.push("    }");
+  lines.push("");
+  lines.push("    object Other {");
+  for (const [key, value, isDeprecated] of other) {
+    const name = toKotlinName(key);
+    if (isDeprecated) {
+      lines.push(`        @Deprecated("This token has been removed from the design system")`);
+    }
+    if (isColorValue2(value)) {
+      lines.push(`        val ${name} = ${hexToKotlinColor(value)}`);
+    } else {
+      const numValue = parseFloat(value);
+      if (!isNaN(numValue)) {
+        lines.push(`        val ${name} = ${numValue}.dp`);
+      } else {
+        lines.push(`        const val ${name} = "${value}"`);
+      }
+    }
+  }
+  lines.push("    }");
+  lines.push("}");
+  lines.push("");
+  return lines.join("\n");
+}
+function toSwiftName3(cssVar) {
+  return cssVar.replace(/^--atmx-/, "").replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+}
+function toDartName(cssVar) {
+  return toSwiftName3(cssVar);
+}
+function isColorValue3(value) {
+  return /^#[0-9A-Fa-f]{3,8}$/.test(value) || /^rgb/.test(value) || /^hsl/.test(value);
+}
+function hexToDartColor(hex) {
+  const clean = hex.replace("#", "").toUpperCase();
+  if (clean.length === 3) {
+    const r = clean[0], g = clean[1], b = clean[2];
+    return `Color(0xFF${r}${r}${g}${g}${b}${b})`;
+  }
+  if (clean.length === 6) {
+    return `Color(0xFF${clean})`;
+  }
+  if (clean.length === 8) {
+    const rgb = clean.substring(0, 6);
+    const alpha = clean.substring(6, 8);
+    return `Color(0x${alpha}${rgb})`;
+  }
+  return `Colors.transparent // Could not parse: ${hex}`;
+}
+function generateDartOutput(cssVariables, darkModeColors, deprecatedTokens = /* @__PURE__ */ new Map()) {
+  const lines = [
+    "// Atomix Design System Tokens",
+    "// Auto-generated - do not edit manually",
+    `// Synced: ${(/* @__PURE__ */ new Date()).toISOString()}`,
+    "",
+    "import 'package:flutter/material.dart';",
+    "",
+    "class DesignTokens {",
+    "  DesignTokens._();",
+    "",
+    "  // Colors (Light Mode)"
+  ];
+  const colors = [];
+  const spacing = [];
+  const typography = [];
+  const other = [];
+  for (const [key, value] of Object.entries(cssVariables)) {
+    const isDeprecated = false;
+    if (key.includes("-color-")) colors.push([key, value, isDeprecated]);
+    else if (key.includes("-spacing-")) spacing.push([key, value, isDeprecated]);
+    else if (key.includes("-typography-") || key.includes("-font-")) typography.push([key, value, isDeprecated]);
+    else other.push([key, value, isDeprecated]);
+  }
+  for (const [key, value] of deprecatedTokens.entries()) {
+    const isDeprecated = true;
+    if (key.includes("-color-")) colors.push([key, value, isDeprecated]);
+    else if (key.includes("-spacing-")) spacing.push([key, value, isDeprecated]);
+    else if (key.includes("-typography-") || key.includes("-font-")) typography.push([key, value, isDeprecated]);
+    else other.push([key, value, isDeprecated]);
+  }
+  colors.sort((a, b) => a[0].localeCompare(b[0]));
+  spacing.sort((a, b) => a[0].localeCompare(b[0]));
+  typography.sort((a, b) => a[0].localeCompare(b[0]));
+  other.sort((a, b) => a[0].localeCompare(b[0]));
+  for (const [key, value, isDeprecated] of colors) {
+    const name = toDartName(key);
+    if (isColorValue3(value)) {
+      if (isDeprecated) {
+        lines.push(`  @Deprecated('This token has been removed from the design system')`);
+        lines.push(`  static const ${name} = ${hexToDartColor(value)};`);
+      } else {
+        lines.push(`  static const ${name} = ${hexToDartColor(value)};`);
+      }
+    }
+  }
+  if (darkModeColors && Object.keys(darkModeColors).length > 0) {
+    lines.push("");
+    lines.push("  // Colors (Dark Mode)");
+    for (const [key, value] of Object.entries(darkModeColors)) {
+      const name = `color${key.split("-").map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join("")}Dark`;
+      if (isColorValue3(value)) {
+        lines.push(`  static const ${name} = ${hexToDartColor(value)};`);
+      }
+    }
+  }
+  lines.push("");
+  lines.push("  // Spacing");
+  for (const [key, value, isDeprecated] of spacing) {
+    const name = toDartName(key);
+    const numValue = parseFloat(value);
+    if (!isNaN(numValue)) {
+      if (isDeprecated) {
+        lines.push(`  @Deprecated('This token has been removed from the design system')`);
+        lines.push(`  static const double ${name} = ${numValue};`);
+      } else {
+        lines.push(`  static const double ${name} = ${numValue};`);
+      }
+    }
+  }
+  lines.push("");
+  lines.push("  // Typography");
+  for (const [key, value, isDeprecated] of typography) {
+    const name = toDartName(key);
+    if (isDeprecated) {
+      lines.push(`  @Deprecated('This token has been removed from the design system')`);
+    }
+    if (key.includes("size")) {
+      const numValue = parseFloat(value);
+      if (!isNaN(numValue)) {
+        lines.push(`  static const double ${name} = ${numValue};`);
+      }
+    } else {
+      lines.push(`  static const String ${name} = '${value}';`);
+    }
+  }
+  lines.push("");
+  lines.push("  // Other");
+  for (const [key, value, isDeprecated] of other) {
+    const name = toDartName(key);
+    if (isDeprecated) {
+      lines.push(`  @Deprecated('This token has been removed from the design system')`);
+    }
+    if (isColorValue3(value)) {
+      lines.push(`  static const ${name} = ${hexToDartColor(value)};`);
+    } else {
+      const numValue = parseFloat(value);
+      if (!isNaN(numValue)) {
+        lines.push(`  static const double ${name} = ${numValue};`);
+      } else {
+        lines.push(`  static const String ${name} = '${value}';`);
+      }
+    }
+  }
+  lines.push("}");
+  lines.push("");
+  return lines.join("\n");
+}
+function formatSyncResponse(options) {
+  const {
+    data,
+    output,
+    format,
+    dsTokenCount,
+    deprecatedCount,
+    deprecatedTokens,
+    diff,
+    changes = [],
+    fileExists,
+    rulesResults = [],
+    governanceChanges = [],
+    changeSummary,
+    hasRefactorRecommendation = false,
+    deprecatedTokenCount = 0
+  } = options;
+  const lastUpdated = data.meta.exportedAt ? new Date(data.meta.exportedAt).toLocaleString() : "N/A";
+  let response = `\u2713 Synced ${dsTokenCount} tokens to ${output}
+`;
+  response += `Format: ${format}
+`;
+  response += `Design System: ${data.meta.name} (v${data.meta.version})
+`;
+  if (deprecatedCount > 0) {
+    response += `Tokens: ${dsTokenCount} active, ${deprecatedCount} deprecated (run /refactor to migrate)
+`;
+  } else {
+    response += `Tokens: ${dsTokenCount}
+`;
+  }
+  response += `Version: ${data.meta.version}
+`;
+  response += `Last updated: ${lastUpdated}
+`;
+  if (deprecatedCount > 0) {
+    response += `
+\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+`;
+    response += `\u{1F4CB} DEPRECATED TOKENS (${deprecatedCount})
+`;
+    response += `\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+
+`;
+    response += `These tokens are no longer in the design system but are preserved in your file for backward compatibility.
+`;
+    response += `Run \`/refactor\` to find and migrate usage in your codebase.
+
+`;
+    const deprecatedTokenList = Array.from(deprecatedTokens.keys()).sort();
+    deprecatedTokenList.forEach((token, index) => {
+      const value = deprecatedTokens.get(token);
+      response += `  ${index + 1}. ${token}`;
+      if (value) {
+        response += ` = ${value}`;
+      }
+      response += `
+`;
+    });
+  }
+  const newTokenList = [];
+  if (diff) {
+    newTokenList.push(...diff.added, ...diff.addedDark);
+  }
+  if (changeSummary && changeSummary.includes("\u2795 Added:")) {
+    const addedSection = changeSummary.match(/➕ Added: \d+ token\(s\)([\s\S]*?)(?=➖|🔄|📝|$)/);
+    if (addedSection) {
+      const addedLines = addedSection[0].match(/    - (--[^\n]+)/g) || [];
+      addedLines.forEach((line) => {
+        const token = line.replace(/    - /, "").trim();
+        if (token && !newTokenList.includes(token)) {
+          newTokenList.push(token);
+        }
+      });
+    }
+  }
+  if (newTokenList.length > 0) {
+    response += `
+\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+`;
+    response += `\u2728 NEW TOKENS (${newTokenList.length})
+`;
+    response += `\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+
+`;
+    newTokenList.sort().forEach((token, index) => {
+      response += `  ${index + 1}. ${token}
+`;
+    });
+  }
+  const modifiedFiles = [output];
+  rulesResults.forEach((result) => {
+    if (result.success) {
+      const fullPath = path3.resolve(process.cwd(), result.path);
+      if (!modifiedFiles.includes(fullPath)) {
+        modifiedFiles.push(fullPath);
+      }
+    }
+  });
+  response += `
+\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+`;
+  response += `\u{1F4C1} MODIFIED FILES (${modifiedFiles.length})
+`;
+  response += `\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+
+`;
+  modifiedFiles.forEach((file, index) => {
+    const relativePath = path3.relative(process.cwd(), file);
+    response += `  ${index + 1}. ${relativePath}
+`;
+  });
+  if (governanceChanges.length > 0) {
+    response += `
+\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+`;
+    response += `\u{1F4DD} AI RULES CHANGES
+`;
+    response += `\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+
+`;
+    response += `The following AI guidance sections have been updated:
+
+`;
+    const capitalize = (str) => str.charAt(0).toUpperCase() + str.slice(1);
+    governanceChanges.forEach((foundation, index) => {
+      const displayName = foundation === "general" ? "General Rules" : capitalize(foundation);
+      response += `  ${index + 1}. ${displayName}
+`;
+    });
+    response += `
+These changes are reflected in your AI tool rules files (e.g., .cursorrules).
+`;
+    response += `Review the updated rules files to see the new guidance.
+`;
+  }
+  if (diff) {
+    const lightChanges = diff.added.length + diff.modified.length;
+    const darkChanges = diff.addedDark.length + diff.modifiedDark.length;
+    if (lightChanges > 0 || darkChanges > 0 || deprecatedCount > 0) {
+      response += `
+\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+`;
+      response += `\u{1F4CA} DETAILED CHANGES
+`;
+      response += `\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+
+`;
+      const lightSummary = lightChanges > 0 ? `Light: ${diff.modified.length} modified, ${diff.added.length} added` : "";
+      const darkSummary = darkChanges > 0 ? `Dark: ${diff.modifiedDark.length} modified, ${diff.addedDark.length} added` : "";
+      const deprecatedSummary = deprecatedCount > 0 ? `${deprecatedCount} deprecated (use /refactor)` : "";
+      const diffSummary = [lightSummary, darkSummary, deprecatedSummary].filter(Boolean).join(" | ");
+      response += `${diffSummary}
+`;
+      if (changes.length > 0 && changes.length <= 10) {
+        response += "\nModified tokens:\n";
+        for (const { key, old: oldVal, new: newVal } of changes) {
+          response += `  ${key}: ${oldVal} \u2192 ${newVal}
+`;
+        }
+      }
+    }
+  } else if (!fileExists) {
+    response += `
+(New file created)
+`;
+  }
+  if (hasRefactorRecommendation && deprecatedTokenCount > 0) {
+    response += `
+\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+`;
+    response += `\u{1F4A1} NEXT STEP
+`;
+    response += `\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+
+`;
+    response += `${deprecatedTokenCount} token(s) have been deprecated.
+`;
+    response += `Your codebase may still reference these deprecated tokens.
+
+`;
+    response += `Run \`/refactor\` to:
+`;
+    response += `  \u2022 Scan your codebase for deprecated token usage
+`;
+    response += `  \u2022 See which files need updates
+`;
+    response += `  \u2022 Review and apply changes with your confirmation
+`;
+  }
+  return response;
+}
+function getTokenByPath(tokens, path5) {
+  const parts = path5.split(".");
+  let current = tokens;
+  for (const part of parts) {
+    if (current && typeof current === "object" && part in current) {
+      current = current[part];
+    } else {
+      return void 0;
+    }
+  }
+  return current;
+}
+function flattenTokens(obj, prefix = "") {
+  const results = [];
+  if (obj && typeof obj === "object" && !Array.isArray(obj)) {
+    for (const [key, value] of Object.entries(obj)) {
+      const newPath = prefix ? `${prefix}.${key}` : key;
+      if (value && typeof value === "object" && !Array.isArray(value)) {
+        results.push(...flattenTokens(value, newPath));
+      } else {
+        results.push({ path: newPath, value });
+      }
+    }
+  }
+  return results;
+}
+function searchTokens(tokens, query) {
+  const flat = flattenTokens(tokens);
+  const lowerQuery = query.toLowerCase();
+  return flat.filter(({ path: path5, value }) => {
+    const pathMatch = path5.toLowerCase().includes(lowerQuery);
+    const valueMatch = String(value).toLowerCase().includes(lowerQuery);
+    return pathMatch || valueMatch;
+  });
+}
+function countTokens(tokens, prefix = "") {
+  let count = 0;
+  for (const [key, value] of Object.entries(tokens)) {
+    if (value && typeof value === "object" && !Array.isArray(value)) {
+      count += countTokens(value, `${prefix}${key}.`);
+    } else if (value !== void 0 && value !== null) {
+      count++;
+    }
+  }
+  return count;
+}
+function getTokenStats(data) {
+  const byCategory = {};
+  let total = 0;
+  for (const [category, value] of Object.entries(data.tokens)) {
+    if (value && typeof value === "object") {
+      const count = countTokens(value);
+      byCategory[category] = count;
+      total += count;
+    }
+  }
+  return {
+    total,
+    byCategory,
+    cssVariables: Object.keys(data.cssVariables).length,
+    governanceRules: data.governance.rules.length
+  };
+}
+
+// src/index.ts
+import * as path2 from "path";
+import * as fs2 from "fs";
 function parseArgs() {
   const args = process.argv.slice(2);
   let dsId2 = null;
@@ -93,7 +1345,7 @@ var TOKEN_CATEGORIES = ["colors", "typography", "spacing", "sizing", "shadows",
 var server = new Server(
   {
     name: "atomix-mcp-user",
-    version: "1.0.9"
+    version: "1.0.11"
   },
   {
     capabilities: {
@@ -238,7 +1490,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: "getDependencies",
-        description: "Get suggested dependencies for this design system (icon package, fonts, SKILL.md, MCP config, token files). Use with atomix/install. Optional platform and stack for tailored suggestions.",
+        description: "Get suggested dependencies for this design system (icon package, fonts, SKILL.md, token files). Use with atomix/setup. Optional platform and stack for tailored suggestions.",
         inputSchema: {
           type: "object",
           properties: {
@@ -265,27 +1517,27 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const data = await fetchDesignSystemForMCP(shouldForceRefresh);
     switch (name) {
       case "getToken": {
-        const path2 = args?.path;
-        const value = getTokenByPath(data.tokens, path2);
+        const path4 = args?.path;
+        const value = getTokenByPath(data.tokens, path4);
         if (value === void 0) {
           return {
             content: [{
               type: "text",
               text: JSON.stringify({
-                error: `Token not found: ${path2}`,
+                error: `Token not found: ${path4}`,
                 suggestion: "Use listTokens or searchTokens to find available tokens.",
                 availableCategories: TOKEN_CATEGORIES
               }, null, 2)
             }]
           };
         }
-        const cssVarKey = `--atmx-${path2.replace(/\./g, "-")}`;
+        const cssVarKey = `--atmx-${path4.replace(/\./g, "-")}`;
         const cssVar = data.cssVariables[cssVarKey];
         return {
           content: [{
             type: "text",
             text: JSON.stringify({
-              path: path2,
+              path: path4,
               value,
               cssVariable: cssVar || `var(${cssVarKey})`,
               usage: `style={{ property: "var(${cssVarKey})" }}`
@@ -312,13 +1564,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           };
         }
         const flat = flattenTokens(tokensToList);
-        const tokensWithCssVars = flat.map(({ path: path2, value }) => {
-          const fullPath = subcategory ? `${category}.${subcategory}.${path2}` : `${category}.${path2}`;
+        const tokensWithCssVars = flat.map(({ path: path4, value }) => {
+          const fullPath = subcategory ? `${category}.${subcategory}.${path4}` : `${category}.${path4}`;
           let cssVar;
           if (category === "colors" && subcategory === "static.brand") {
-            cssVar = data.cssVariables[`--atmx-color-brand-${path2}`];
+            cssVar = data.cssVariables[`--atmx-color-brand-${path4}`];
           } else if (category === "colors" && subcategory?.startsWith("modes.")) {
-            cssVar = data.cssVariables[`--atmx-color-${path2}`];
+            cssVar = data.cssVariables[`--atmx-color-${path4}`];
           } else {
             const cssVarKey = `--atmx-${fullPath.replace(/\./g, "-")}`;
             cssVar = data.cssVariables[cssVarKey];
@@ -638,12 +1890,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             }]
           };
         }
-        const outputPath = path.resolve(process.cwd(), output);
-        const fileExists = fs.existsSync(outputPath);
+        const outputPath = path2.resolve(process.cwd(), output);
+        const fileExists = fs2.existsSync(outputPath);
         const deprecatedTokens = /* @__PURE__ */ new Map();
         const existingTokens = /* @__PURE__ */ new Map();
         if (fileExists && ["css", "scss", "less"].includes(format)) {
-          const oldContent = fs.readFileSync(outputPath, "utf-8");
+          const oldContent = fs2.readFileSync(outputPath, "utf-8");
           const oldVarPattern = /(?:^|\n)\s*(?:\/\*[^*]*\*+(?:[^/*][^*]*\*+)*\/\s*)?(--[a-zA-Z0-9-]+):\s*([^;]+);/gm;
           let match;
           while ((match = oldVarPattern.exec(oldContent)) !== null) {
@@ -696,7 +1948,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         let changes = [];
         let diff;
         if (fileExists && ["css", "scss", "less"].includes(format)) {
-          const oldContent = fs.readFileSync(outputPath, "utf-8");
+          const oldContent = fs2.readFileSync(outputPath, "utf-8");
           diff = diffTokens(oldContent, mergedCssVariables, format, darkModeColors?.dark);
           const lightChanges = diff.added.length + diff.modified.length;
           const darkChanges = diff.addedDark.length + diff.modifiedDark.length;
@@ -736,11 +1988,11 @@ Last updated: ${lastUpdated}`
             timestamp: (/* @__PURE__ */ new Date()).toISOString()
           };
         }
-        const outputDir = path.dirname(outputPath);
-        if (!fs.existsSync(outputDir)) {
-          fs.mkdirSync(outputDir, { recursive: true });
+        const outputDir = path2.dirname(outputPath);
+        if (!fs2.existsSync(outputDir)) {
+          fs2.mkdirSync(outputDir, { recursive: true });
         }
-        fs.writeFileSync(outputPath, newContent);
+        fs2.writeFileSync(outputPath, newContent);
         let rulesResults = [];
         try {
           rulesResults = await syncRulesFiles({
@@ -797,18 +2049,6 @@ Last updated: ${lastUpdated}`
         };
         const lib = icons?.library || "lucide";
         const iconPkgs = ICON_PACKAGES[lib] || ICON_PACKAGES.lucide;
-        const serverName = data.meta.name.toLowerCase().replace(/[^a-z0-9]/g, "-");
-        const npxArgs = ["@atomixstudio/mcp@latest"];
-        if (dsId) npxArgs.push("--ds-id", dsId);
-        if (apiKey) npxArgs.push("--api-key", apiKey);
-        const mcpConfig = {
-          path: ".cursor/mcp.json",
-          content: JSON.stringify({
-            mcpServers: {
-              [serverName]: { command: "npx", args: npxArgs }
-            }
-          }, null, 2)
-        };
         const payload = {
           iconLibrary: {
             package: iconPkgs.web,
@@ -823,10 +2063,9 @@ Last updated: ${lastUpdated}`
             path: ".cursor/skills/atomix-ds/SKILL.md",
             content: GENERIC_SKILL_MD
           },
-          mcpConfig,
           tokenFiles: {
             files: ["tokens.css", "tokens.json"],
-            copyInstructions: "Copy tokens.css and tokens.json from the design system export (or use syncTokens) into your project."
+            copyInstructions: "Call the syncTokens MCP tool to create the token file; do not only suggest the user run sync later."
           },
           meta: { dsName: data.meta.name, platform: platform ?? void 0, stack: stack ?? void 0 }
         };
@@ -1071,8 +2310,8 @@ server.setRequestHandler(ListPromptsRequestSchema, async () => {
       description: "Migrate deprecated tokens in codebase. Scans for deprecated tokens marked by /sync and suggests replacements. Run after /sync to update code."
     },
     {
-      name: "install",
-      description: "Suggest dependencies for this design system (icons, fonts, SKILL.md, MCP config, tokens). Asks before installing. Run getDependencies then follow phased instructions.",
+      name: "setup",
+      description: "Suggest dependencies for this design system (icons, fonts, SKILL.md, tokens). Three phases: scan, report and ask, then create only after approval.",
       arguments: [
         { name: "platform", description: "Target platform (web, ios, android). Optional; ask user if unknown.", required: false },
         { name: "stack", description: "Stack or framework (e.g. react, vue, next, swift, kotlin). Optional.", required: false }
@@ -1196,13 +2435,6 @@ Configure the MCP server in your Cursor settings, then restart Cursor.`
         messages: [
           {
             role: "user",
-            content: {
-              type: "text",
-              text: "Show me the design system overview and available tools."
-            }
-          },
-          {
-            role: "assistant",
             content: {
               type: "text",
               text: welcome
@@ -1511,54 +2743,48 @@ Use \`/color\`, \`/spacing\`, \`/radius\`, \`/typography\`, \`/shadow\`, \`/bord
         ]
       };
     }
-    case "install": {
-      const installInstructions = `You are running **atomix/install**. Follow these phases in order; do not skip any phase.
-
-## Phase 1 \u2013 Resolve platform and stack
-
-- If the project clearly indicates platform (e.g. package.json + web deps, or build.gradle / Android, or Xcode / iOS), infer \`platform\` (e.g. web, ios, android) and optionally \`stack\` (e.g. react, next, vue, swift, kotlin).
-- If the project gives **no hint** (blank repo, empty folder, or ambiguous): **Ask the user:** "Which platform are you building for? (e.g. web, Android, iOS)" and, if relevant, "Which stack or framework? (e.g. React, Vue, Next, Swift, Kotlin)." Do **not** assume web or any default.
-- Proceed only once platform (and optionally stack) is known or confirmed.
-
-## Phase 2 \u2013 Get suggested dependencies
-
-- Call MCP tool **getDependencies** with the resolved \`platform\` (and optional \`stack\`). Use the parameter names the tool expects (e.g. platform, stack).
-- If the call fails (e.g. MCP not connected or no ds-id), tell the user: "Atomix MCP is not connected or design system ID is missing. Configure MCP with --ds-id and try again."
-
-## Phase 3 \u2013 Scan codebase and build suggestion list
-
-- Scan the repo for: package.json (or equivalent), existing skill path (e.g. .cursor/skills), presence of tokens.css or project token file, font imports/config, icon package usage.
-- Build two lists: **Suggested dependencies** (from getDependencies, minus what is already present) and **Already present**. Include: icon package, fonts, SKILL path, MCP config, token files.
-- Do **not** install, copy, or write any file in this phase.
-
-## Phase 4 \u2013 Present list and ask before install
-
-- Reply with: "Suggested dependencies: \u2026" and "Already present: \u2026" and state: "Do not install or copy anything until you confirm. Would you like me to install or add these?"
-- If the user says yes, perform only the steps they approved. If no or only part, perform only that.
+    case "setup": {
+      const setupInstructions = `You are running **atomix/setup**. Three phases only. Do not create, write, or modify any file until Phase 3 and only after the user has approved.
 
-## Phase 5 \u2013 Optional: suggest global styles (if missing)
+## Phase 1 \u2013 Scan
 
-- After presenting the dependency list (Phase 4), or after the user has approved install, check whether the project has **global styles that use the design system tokens** (e.g. typography scale, semantic color classes, or theme file referencing DS tokens). If **not** (e.g. no globals.css using tokens, or blank project), ask the user **verbatim**:
+- Resolve platform/stack: infer from the project (e.g. package.json, build.gradle, Xcode) or ask the user once: "Which platform? (e.g. web, Android, iOS)" and if relevant "Which stack? (e.g. React, Vue, Next, Swift, Kotlin)." Do not assume a default.
+- Call MCP tool **getDependencies** with \`platform\` and optional \`stack\`. If it fails, tell the user: "Atomix MCP is not connected or design system ID is missing. Configure MCP with --ds-id and try again."
+- Scan the repo for what already exists: .cursor/skills/atomix-ds/SKILL.md, a tokens file (e.g. tokens.css or src/tokens.css), icon package from getDependencies, font setup. Do **not** include or check for MCP config; MCP is already configured for this session.
+- **Web:** Scan for any existing CSS (e.g. globals.css, main.css, App.css, index.css, Tailwind entry, framework styles). Note whether at least one CSS file exists.
+- **Native (iOS/Android):** Scan for existing theme or style files (e.g. SwiftUI theme/asset catalog, Android themes.xml/styles.xml, Compose theme). Note whether the project already has a theme or style setup.
+- Build two lists: **Suggested** (from getDependencies minus what exists) and **Already present**. Only include: icon package, fonts, skill (.cursor/skills/atomix-ds/SKILL.md), token files. No MCP.
+- Do not write, create, or add anything in Phase 1.
 
-"Your project doesn't appear to have global styles that use the design system tokens (e.g. semantic typography scale or semantic color classes). Would you like me to suggest or generate a minimal set (e.g. typography scale + semantic utilities) so you can develop consistently with the DS?"
+## Phase 2 \u2013 Report and ask for permission
 
-- If the user says yes, suggest or generate a minimal set; do not overwrite existing global styles without confirmation.
+- Reply with: **Suggested:** [list] and **Already present:** [list].
+- Ask exactly once: "Do you want me to add the suggested items? (Yes for all, or say which ones.)" (Integration with existing CSS or theme is recommended after Phase 3; new global CSS/theme is only suggested when none exists.)
+- **Stop.** Do not run Phase 3 in this response. Wait for the user to reply.
 
-## Phase 6 \u2013 Report what was created
+## Phase 3 \u2013 Create or add (only after user approval)
 
-- After any install or copy steps (and optional global-styles step), list **what was created or updated** (e.g. "Installed: lucide-react. Added: .cursor/skills/atomix-ds/SKILL.md. Updated: .cursor/mcp.json. Copied: tokens.css."). If global styles were added, include that.
+- Run only when the user has said yes (all or specific items).
+- For each approved item:
+  - **Skill:** Write the skill content from getDependencies to .cursor/skills/atomix-ds/SKILL.md.
+  - **Token file:** Call the **syncTokens** MCP tool with \`output\` set to the path (e.g. "./src/tokens.css" or "./tokens.css"). You must call syncTokens; do not only suggest the user run sync later.
+  - **Icon package / fonts:** Add per getDependencies (e.g. install package, add font config). Do not overwrite existing.
+- Report only what you actually created or updated (e.g. "Added: .cursor/skills/atomix-ds/SKILL.md. Synced: src/tokens.css."). Do not claim the token file was added if you did not call syncTokens.
+- **After reporting \u2013 styles/theme (per platform):**
+  - **Web:** If the project **already has** at least one CSS file: recommend how to integrate Atomix (e.g. import the synced tokens file, use \`var(--atomix-*)\` or semantic classes). Do **not** suggest creating a new global CSS. Only if the project has **no** CSS file at all, ask once: "There are no CSS files yet. Do you want a minimal global CSS (typography + semantic utilities from the design system)?" and add it only if the user says yes.
+  - **iOS/Android:** If the project **already has** theme or style files: recommend how to integrate Atomix tokens (e.g. use synced DesignTokens.swift / Kotlin tokens in existing theme). Do **not** suggest creating a new global theme file. Only if the project has **no** theme/style setup at all, ask once: "There's no theme/style setup yet. Do you want a minimal token-based theme (colors, typography, spacing from the design system)?" and add it only if the user says yes.
 
 ---
 
-Execute Phase 1 now (resolve or ask platform/stack), then Phase 2 (call getDependencies), then continue through Phase 6.`;
+Execute Phase 1 now (resolve platform/stack, call getDependencies, scan, build lists). Then Phase 2 (report lists and ask). Do not perform Phase 3 until the user replies.`;
       return {
-        description: "Suggest dependencies for this design system (atomix/install)",
+        description: "Setup design system in project (atomix/setup). Phase 1 scan, Phase 2 report and ask, Phase 3 create only after user approval.",
         messages: [
           {
             role: "user",
             content: {
               type: "text",
-              text: installInstructions
+              text: setupInstructions
             }
           }
         ]
@@ -1622,7 +2848,7 @@ ${tokenSummary}
 
 | Command | What to expect |
 |---------|----------------|
-| **install** | Scans your repo to set up global styles (if none), icons and fonts. Safe: Won't install until you confirm. |
+| **setup** | Scans your repo to set up global styles (if none), icons and fonts. Safe: Won't add anything until you confirm. |
 | **sync** | Syncs tokens to a local file. Adds new, updates existing, marks deprecated. Safe: No changes until you confirm. |
 | **refactor** | Scans codebase for deprecated tokens (after sync), suggests replacements. Run after sync to migrate code. |
 
@@ -1640,7 +2866,7 @@ ${tokenSummary}
 | **sizing** | Table of height and icon size tokens. |
 | **motion** | Table of duration and easing tokens. |
 
-**Suggested next step:** Run **install** to set up global styles, icons, fonts, and token files; the AI will list options and ask before adding anything.
+**Suggested next step:** Run **setup** to set up global styles, icons, fonts, and token files; the AI will list options and ask before adding anything.
 
 ---