@fragments-sdk/cli 0.15.0 → 0.15.2

package/dist/bin.js

@@ -1,43 +1,26 @@
 #!/usr/bin/env node
 import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
+import {
+  setup
+} from "./chunk-BJE3425I.js";
 import {
   scan
-} from "./chunk-CZD3AD4Q.js";
+} from "./chunk-ONUP6Z4W.js";
 import {
   createAIClient,
   detectProvider,
   getApiKey
 } from "./chunk-SXTKFDCR.js";
 import {
-  setup
-} from "./chunk-BJE3425I.js";
-import {
-  buildFragments,
-  buildFragmentsDir,
-  measureBundleSizes,
-  resolveComponentSourcePath,
   runAnalyzeCommand,
   runDiffCommand,
   runScreenshotCommand,
-  toPerformanceData,
   validateAll,
   validateCoverage,
   validateDrift,
   validateSchema,
   validateSnippets
-} from "./chunk-7WHVW72L.js";
-import {
-  createComponentExtractor
-} from "./chunk-MN3TJ3D5.js";
-import {
-  discoverFragmentFiles,
-  loadConfig,
-  loadFragmentFile,
-  parseFragmentFile
-} from "./chunk-65WSVDV5.js";
-import {
-  projectFields
-} from "./chunk-T47OLCSF.js";
+} from "./chunk-5JF26E55.js";
 import {
   FigmaClient,
   StorageManager,
@@ -51,28 +34,38 @@ import {
   parseAllStories,
   renderAllComponentVariants,
   shutdownSharedPool
-} from "./chunk-XJQ5BIWI.js";
+} from "./chunk-6SQPP47U.js";
+import {
+  projectFields
+} from "./chunk-T47OLCSF.js";
 import "./chunk-D2CDBRNU.js";
+import {
+  discoverFragmentFiles,
+  loadConfig,
+  loadFragmentFile,
+  parseFragmentFile
+} from "./chunk-HQ6A6DTV.js";
 import {
   BRAND,
   budgetBar,
+  classifyComplexity,
   formatBytes,
   generateContext,
   resolvePerformanceConfig
 } from "./chunk-32LIWN2P.js";
+import "./chunk-MHIBEEW4.js";
 import {
   getScanStats,
   scanCodebase
 } from "./chunk-QCN35LJU.js";
 import "./chunk-7DZC4YEV.js";
-import "./chunk-Z7EY4VHE.js";
 
 // src/bin.ts
 import { Command } from "commander";
-import pc26 from "picocolors";
+import pc25 from "picocolors";
 import { readFileSync } from "fs";
 import { fileURLToPath } from "url";
-import { dirname as dirname5, join as join11 } from "path";
+import { dirname as dirname6, join as join11 } from "path";
 
 // src/commands/validate.ts
 import pc from "picocolors";
@@ -168,6 +161,7 @@ function printDriftReport(result) {
 
 // src/commands/build.ts
 import pc2 from "picocolors";
+import { buildFragments, buildFragmentsDir, getFragmentsJsonStatus } from "@fragments-sdk/compiler";
 async function build(options = {}) {
   if (options.fromSource) {
     console.log(pc2.cyan(`
@@ -202,6 +196,50 @@ ${BRAND.name} Build
   let registryPath;
   let contextPath;
   if (!options.registryOnly) {
+    const status = await getFragmentsJsonStatus(config, configDir, {
+      output: config.outFile,
+      configPath: options.config
+    });
+    if (options.check) {
+      if (status.missing || status.stale) {
+        const message = status.missing ? `${BRAND.outFile} is missing` : `${BRAND.outFile} is stale${status.reason ? ` (${status.reason})` : ""}`;
+        console.log(pc2.red(`\u2717 ${message}
+`));
+        errors.push({
+          file: status.outputPath,
+          error: message
+        });
+        return {
+          success: false,
+          outputPath: status.outputPath,
+          errors
+        };
+      }
+      console.log(pc2.green(`\u2713 ${BRAND.outFile} is up to date`));
+      console.log(pc2.dim(`  Output: ${status.outputPath}
+`));
+      if (!options.registry) {
+        return {
+          success: true,
+          fragmentCount: Object.keys(status.data?.fragments ?? {}).length,
+          outputPath: status.outputPath,
+          errors
+        };
+      }
+    }
+    if (options.ifNeeded && !status.missing && !status.stale) {
+      console.log(pc2.green(`\u2713 ${BRAND.outFile} is up to date`));
+      console.log(pc2.dim(`  Output: ${status.outputPath}
+`));
+      if (!options.registry) {
+        return {
+          success: true,
+          fragmentCount: Object.keys(status.data?.fragments ?? {}).length,
+          outputPath: status.outputPath,
+          errors
+        };
+      }
+    }
     console.log(pc2.dim("Compiling fragments...\n"));
     const result = await buildFragments(config, configDir);
     if (result.errors.length > 0) {
@@ -277,6 +315,7 @@ ${BRAND.name} Build
 import { readFile } from "fs/promises";
 import { resolve } from "path";
 import pc3 from "picocolors";
+import { buildFragments as buildFragments2 } from "@fragments-sdk/compiler";
 async function context(options = {}) {
   const {
     format = "markdown",
@@ -293,7 +332,7 @@ async function context(options = {}) {
     fragments = Object.values(data.fragments);
   } else {
     const { config, configDir } = await loadConfig(options.config);
-    const result = await buildFragments(config, configDir);
+    const result = await buildFragments2(config, configDir);
     if (result.errors.length > 0 && result.fragmentCount === 0) {
       console.error(pc3.red("Error: No fragments found. Run `fragments build` first or fix errors."));
       return { success: false, tokenEstimate: 0 };
@@ -5488,13 +5527,259 @@ ${BRAND.name} Components (${fragments.length})
 // src/commands/perf.ts
 import pc21 from "picocolors";
 import { readFile as readFile10, writeFile as writeFile8 } from "fs/promises";
-import { resolve as resolve10 } from "path";
+import { resolve as resolve11 } from "path";
+
+// src/core/bundle-measurer.ts
+import { build as build2 } from "esbuild";
+import { gzipSync } from "zlib";
+import { resolve as resolve10, dirname as dirname4, join as join10, basename } from "path";
+import { existsSync as existsSync3 } from "fs";
+function resolveEntryPoint(fragmentFilePath, configDir) {
+  const absPath = resolve10(configDir, fragmentFilePath);
+  const dir = dirname4(absPath);
+  const candidates = ["index.tsx", "index.ts", "index.jsx", "index.js"];
+  for (const candidate of candidates) {
+    const path = join10(dir, candidate);
+    if (existsSync3(path)) return path;
+  }
+  return null;
+}
+function labelForPath(filePath) {
+  const lastNmIdx = filePath.lastIndexOf("node_modules/");
+  if (lastNmIdx >= 0) {
+    const afterNm = filePath.slice(lastNmIdx + "node_modules/".length);
+    if (afterNm.startsWith("@")) {
+      const parts = afterNm.split("/");
+      return parts.slice(0, 2).join("/");
+    }
+    return afterNm.split("/")[0];
+  }
+  const componentsIdx = filePath.indexOf("components/");
+  if (componentsIdx >= 0) {
+    const afterComponents = filePath.slice(componentsIdx + "components/".length);
+    const componentName = afterComponents.split("/")[0];
+    return componentName;
+  }
+  const srcIdx = filePath.indexOf("src/");
+  if (srcIdx >= 0) return filePath.slice(srcIdx);
+  return filePath;
+}
+function groupImportsByDirectDep(metafile, entryPoint) {
+  const inputs = metafile.inputs;
+  const outputKey = Object.keys(metafile.outputs)[0];
+  const outputMeta = outputKey ? metafile.outputs[outputKey] : void 0;
+  if (!outputMeta?.inputs) return [];
+  const bytesMap = /* @__PURE__ */ new Map();
+  for (const [path, info] of Object.entries(outputMeta.inputs)) {
+    if (info.bytesInOutput > 0) {
+      bytesMap.set(path, info.bytesInOutput);
+    }
+  }
+  let entryKey;
+  for (const key of Object.keys(inputs)) {
+    if (key === entryPoint || entryPoint.endsWith(key) || key.endsWith(basename(entryPoint))) {
+      const entryDir = dirname4(entryPoint);
+      if (key.includes(basename(entryDir))) {
+        entryKey = key;
+        break;
+      }
+    }
+  }
+  if (!entryKey) {
+    const entryBasename = basename(dirname4(entryPoint));
+    for (const key of Object.keys(inputs)) {
+      if (key.includes(`/${entryBasename}/index.`)) {
+        entryKey = key;
+        break;
+      }
+    }
+  }
+  if (!entryKey || !inputs[entryKey]) {
+    return groupByPackage(bytesMap);
+  }
+  const directImports = inputs[entryKey].imports.map((imp) => imp.path).filter((p) => inputs[p]);
+  const claimed = /* @__PURE__ */ new Set();
+  claimed.add(entryKey);
+  const groupMap = /* @__PURE__ */ new Map();
+  for (const directPath of directImports) {
+    if (claimed.has(directPath)) continue;
+    const queue = [directPath];
+    const reachable = /* @__PURE__ */ new Set();
+    while (queue.length > 0) {
+      const current = queue.pop();
+      if (reachable.has(current) || claimed.has(current)) continue;
+      reachable.add(current);
+      claimed.add(current);
+      const entry = inputs[current];
+      if (entry?.imports) {
+        for (const imp of entry.imports) {
+          if (inputs[imp.path] && !claimed.has(imp.path)) {
+            queue.push(imp.path);
+          }
+        }
+      }
+    }
+    let totalBytes = 0;
+    for (const path of reachable) {
+      totalBytes += bytesMap.get(path) ?? 0;
+    }
+    if (totalBytes > 0) {
+      const label = labelForPath(directPath);
+      const existing = groupMap.get(label);
+      if (existing) {
+        existing.bytes += totalBytes;
+      } else {
+        const entry = { path: label, bytes: totalBytes };
+        groupMap.set(label, entry);
+      }
+    }
+  }
+  const entryLabel = labelForPath(entryKey);
+  const selfLabel = entryLabel + " (self)";
+  let selfBytes = bytesMap.get(entryKey) ?? 0;
+  const siblingGroup = groupMap.get(entryLabel);
+  if (siblingGroup) {
+    selfBytes += siblingGroup.bytes;
+    groupMap.delete(entryLabel);
+  }
+  if (selfBytes > 0) {
+    groupMap.set(selfLabel, { path: selfLabel, bytes: selfBytes });
+  }
+  let unclaimedBytes = 0;
+  for (const [path, bytes] of bytesMap) {
+    if (!claimed.has(path)) unclaimedBytes += bytes;
+  }
+  if (unclaimedBytes > 0) {
+    groupMap.set("(other)", { path: "(other)", bytes: unclaimedBytes });
+  }
+  return [...groupMap.values()].sort((a, b) => b.bytes - a.bytes);
+}
+function groupByPackage(bytesMap) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const [path, bytes] of bytesMap) {
+    const label = labelForPath(path);
+    const key = label.includes("/") && !label.startsWith("components/") ? label.split("/").slice(0, label.startsWith("@") ? 2 : 1).join("/") : label;
+    groups.set(key, (groups.get(key) ?? 0) + bytes);
+  }
+  return [...groups.entries()].map(([path, bytes]) => ({ path, bytes })).sort((a, b) => b.bytes - a.bytes);
+}
+async function measureSingleComponent(entryPoint, name) {
+  const result = await build2({
+    entryPoints: [entryPoint],
+    bundle: true,
+    write: false,
+    minify: true,
+    metafile: true,
+    format: "esm",
+    target: "es2020",
+    platform: "browser",
+    treeShaking: true,
+    external: [
+      "react",
+      "react-dom",
+      "react/jsx-runtime",
+      "react/jsx-dev-runtime",
+      // Optional peer deps — excluded from measurement
+      "recharts",
+      "shiki",
+      "react-day-picker",
+      "@tanstack/react-table",
+      "date-fns",
+      "@base-ui-components/*",
+      "@base-ui/react/*"
+    ],
+    loader: {
+      ".scss": "empty",
+      ".css": "empty",
+      ".svg": "empty",
+      ".png": "empty",
+      ".jpg": "empty",
+      ".gif": "empty",
+      ".woff": "empty",
+      ".woff2": "empty",
+      ".ttf": "empty",
+      ".eot": "empty"
+    },
+    logLevel: "silent"
+  });
+  const output = result.outputFiles[0];
+  const rawBytes = output.contents.byteLength;
+  const gzipBytes = gzipSync(output.contents).byteLength;
+  const imports = result.metafile ? groupImportsByDirectDep(result.metafile, entryPoint) : void 0;
+  return { name, rawBytes, gzipBytes, imports };
+}
+async function measureBundleSizes(fragments, configDir, options = {}) {
+  const concurrency = options.concurrency ?? 4;
+  const measurements = /* @__PURE__ */ new Map();
+  const errors = [];
+  const start = Date.now();
+  const entries = [];
+  for (const [name, fragment] of Object.entries(fragments)) {
+    const entryPoint = resolveEntryPoint(fragment.filePath, configDir);
+    if (entryPoint) {
+      entries.push({ name, entryPoint });
+    } else {
+      errors.push({
+        name,
+        error: `Could not resolve entry point from ${fragment.filePath}`
+      });
+    }
+  }
+  let completed = 0;
+  for (let i = 0; i < entries.length; i += concurrency) {
+    const batch = entries.slice(i, i + concurrency);
+    const results = await Promise.allSettled(
+      batch.map(
+        ({ name, entryPoint }) => measureSingleComponent(entryPoint, name)
+      )
+    );
+    for (let j = 0; j < results.length; j++) {
+      const result = results[j];
+      const { name } = batch[j];
+      completed++;
+      if (result.status === "fulfilled") {
+        measurements.set(name, result.value);
+      } else {
+        errors.push({
+          name,
+          error: result.reason instanceof Error ? result.reason.message : String(result.reason)
+        });
+      }
+      options.onProgress?.(completed, entries.length, name);
+    }
+  }
+  return {
+    measurements,
+    errors,
+    elapsed: Date.now() - start
+  };
+}
+function toPerformanceData(measurement, config, contractBudget) {
+  const budget = contractBudget ?? config.budgets.bundleSize;
+  const budgetPercent = Math.round(measurement.gzipBytes / budget * 100);
+  const imports = measurement.imports?.slice(0, 10).map((imp) => ({
+    path: imp.path,
+    bytes: imp.bytes,
+    percent: Math.round(imp.bytes / measurement.rawBytes * 100)
+  }));
+  return {
+    bundleSize: measurement.gzipBytes,
+    rawSize: measurement.rawBytes,
+    complexity: classifyComplexity(measurement.gzipBytes),
+    budgetPercent,
+    overBudget: budgetPercent > 100,
+    measuredAt: (/* @__PURE__ */ new Date()).toISOString(),
+    ...imports && imports.length > 0 ? { imports } : {}
+  };
+}
+
+// src/commands/perf.ts
 async function perf(options) {
   const { config: configPath, json, component, concurrency, detail } = options;
   const shouldWrite = options.write !== false;
   const { config, configDir } = await loadConfig(configPath);
   const perfConfig = resolvePerformanceConfig(config.performance ?? "standard");
-  const outFile = resolve10(configDir, config.outFile ?? BRAND.outFile);
+  const outFile = resolve11(configDir, config.outFile ?? BRAND.outFile);
   let data;
   try {
     data = JSON.parse(await readFile10(outFile, "utf-8"));
@@ -5636,418 +5921,45 @@ ${pc21.bold("Summary")}`);
   };
 }
 
-// src/commands/doctor.ts
-import { readFile as readFile11, access as access3 } from "fs/promises";
-import { join as join10, resolve as resolve11 } from "path";
-import pc22 from "picocolors";
-var VALID_NEUTRALS = ["stone", "ice", "earth", "sand", "fire"];
-var VALID_DENSITIES = ["compact", "default", "relaxed"];
-var VALID_RADII = ["sharp", "subtle", "default", "rounded", "pill"];
-async function checkPackageInstalled(root) {
-  try {
-    const pkgPath = join10(root, "package.json");
-    const content = await readFile11(pkgPath, "utf-8");
-    const pkg2 = JSON.parse(content);
-    const allDeps = { ...pkg2.dependencies, ...pkg2.devDependencies };
-    if (allDeps["@fragments-sdk/ui"]) {
-      return {
-        name: "Package installed",
-        status: "pass",
-        message: `@fragments-sdk/ui ${allDeps["@fragments-sdk/ui"]} found in dependencies`
-      };
-    }
-    return {
-      name: "Package installed",
-      status: "fail",
-      message: "@fragments-sdk/ui not found in package.json",
-      fix: "npm install @fragments-sdk/ui"
-    };
-  } catch {
-    return {
-      name: "Package installed",
-      status: "fail",
-      message: "No package.json found"
-    };
-  }
-}
-async function checkStylesImport(root) {
-  const entryPatterns = [
-    "src/main.tsx",
-    "src/main.ts",
-    "src/index.tsx",
-    "src/index.ts",
-    "src/App.tsx",
-    "src/App.ts",
-    "app/layout.tsx",
-    "app/layout.ts",
-    "src/app/layout.tsx",
-    "src/app/layout.ts",
-    "app/root.tsx",
-    "pages/_app.tsx",
-    "pages/_app.ts"
-  ];
-  for (const pattern of entryPatterns) {
-    try {
-      const content = await readFile11(join10(root, pattern), "utf-8");
-      if (content.includes("@fragments-sdk/ui/styles")) {
-        return {
-          name: "Styles import",
-          status: "pass",
-          message: `Found styles import in ${pattern}`
-        };
-      }
-      if (content.includes("@fragments-sdk/ui/globals")) {
-        return {
-          name: "Styles import",
-          status: "warn",
-          message: `${pattern} uses deprecated '@fragments-sdk/ui/globals'. Use '@fragments-sdk/ui/styles' instead`,
-          fix: `Replace '@fragments-sdk/ui/globals' with '@fragments-sdk/ui/styles' in ${pattern}`
-        };
-      }
-    } catch {
-    }
-  }
-  const scssPatterns = [
-    "src/styles/globals.scss",
-    "src/globals.scss",
-    "styles/globals.scss",
-    "app/globals.scss",
-    "src/app/globals.scss",
-    "app/styles/globals.scss"
-  ];
-  for (const pattern of scssPatterns) {
-    try {
-      const content = await readFile11(join10(root, pattern), "utf-8");
-      if (content.includes("@fragments-sdk/ui/styles")) {
-        return {
-          name: "Styles import",
-          status: "pass",
-          message: `Found SCSS @use import in ${pattern}`
-        };
-      }
-    } catch {
-    }
-  }
-  return {
-    name: "Styles import",
-    status: "fail",
-    message: "No @fragments-sdk/ui/styles import found in entry files",
-    fix: "Add `import '@fragments-sdk/ui/styles'` to your app's entry file"
-  };
-}
-async function checkThemeProvider(root) {
-  const providerPatterns = [
-    "src/main.tsx",
-    "src/App.tsx",
-    "src/providers.tsx",
-    "app/layout.tsx",
-    "app/providers.tsx",
-    "src/app/layout.tsx",
-    "src/app/providers.tsx",
-    "app/root.tsx",
-    "pages/_app.tsx"
-  ];
-  for (const pattern of providerPatterns) {
-    try {
-      const content = await readFile11(join10(root, pattern), "utf-8");
-      if (content.includes("ThemeProvider")) {
-        if (content.includes("defaultTheme=") || content.includes("defaultTheme =")) {
-          return {
-            name: "ThemeProvider",
-            status: "warn",
-            message: `${pattern} uses deprecated 'defaultTheme' prop. Use 'defaultMode' instead`,
-            fix: `Replace 'defaultTheme' with 'defaultMode' in ${pattern}`
-          };
-        }
-        return {
-          name: "ThemeProvider",
-          status: "pass",
-          message: `ThemeProvider found in ${pattern}`
-        };
-      }
-    } catch {
-    }
-  }
-  return {
-    name: "ThemeProvider",
-    status: "warn",
-    message: "ThemeProvider not found in common entry files (optional but recommended)",
-    fix: 'Wrap your app with <ThemeProvider defaultMode="system">'
-  };
-}
-async function checkScssSeeds(root) {
-  const checks = [];
-  const scssPatterns = [
-    "src/styles/globals.scss",
-    "src/globals.scss",
-    "styles/globals.scss",
-    "app/globals.scss",
-    "src/app/globals.scss",
-    "app/styles/globals.scss"
-  ];
-  for (const pattern of scssPatterns) {
-    try {
-      const content = await readFile11(join10(root, pattern), "utf-8");
-      if (!content.includes("@fragments-sdk/ui/styles")) continue;
-      const standalonePattern = /^\$fui-\w+:\s*.+;$/m;
-      if (standalonePattern.test(content) && !content.includes("@use")) {
-        checks.push({
-          name: "SCSS syntax",
-          status: "fail",
-          message: `${pattern} uses standalone $fui- variables. Must use @use...with() syntax`,
-          fix: "@use '@fragments-sdk/ui/styles' with ($fui-brand: #0066ff);"
-        });
-      }
-      const neutralMatch = content.match(/\$fui-neutral:\s*"([^"]+)"/);
-      if (neutralMatch && !VALID_NEUTRALS.includes(neutralMatch[1])) {
-        checks.push({
-          name: "SCSS seed: neutral",
-          status: "fail",
-          message: `Invalid $fui-neutral: "${neutralMatch[1]}" in ${pattern}`,
-          fix: `Valid neutrals: ${VALID_NEUTRALS.join(", ")}`
-        });
-      }
-      const densityMatch = content.match(/\$fui-density:\s*"([^"]+)"/);
-      if (densityMatch && !VALID_DENSITIES.includes(densityMatch[1])) {
-        checks.push({
-          name: "SCSS seed: density",
-          status: "fail",
-          message: `Invalid $fui-density: "${densityMatch[1]}" in ${pattern}`,
-          fix: `Valid densities: ${VALID_DENSITIES.join(", ")}`
-        });
-      }
-      const radiusMatch = content.match(/\$fui-radius-style:\s*"([^"]+)"/);
-      if (radiusMatch && !VALID_RADII.includes(radiusMatch[1])) {
-        checks.push({
-          name: "SCSS seed: radius-style",
-          status: "fail",
-          message: `Invalid $fui-radius-style: "${radiusMatch[1]}" in ${pattern}`,
-          fix: `Valid radius styles: ${VALID_RADII.join(", ")}`
-        });
-      }
-      const brandMatch = content.match(/\$fui-brand:\s*(#[0-9a-fA-F]+)/);
-      if (brandMatch) {
-        const hex = brandMatch[1];
-        if (!/^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/.test(hex)) {
-          checks.push({
-            name: "SCSS seed: brand",
-            status: "fail",
-            message: `Invalid $fui-brand color: "${hex}" in ${pattern}`,
-            fix: "Must be a valid hex color (e.g., #0066ff)"
-          });
-        }
-      }
-      if (checks.length === 0) {
-        checks.push({
-          name: "SCSS seeds",
-          status: "pass",
-          message: `Seed values in ${pattern} are valid`
-        });
-      }
-      return checks;
-    } catch {
-    }
-  }
-  checks.push({
-    name: "SCSS seeds",
-    status: "pass",
-    message: "No custom SCSS seeds configured (using defaults)"
-  });
-  return checks;
-}
-async function checkPeerDeps(root) {
-  const checks = [];
-  try {
-    const pkgPath = join10(root, "package.json");
-    const content = await readFile11(pkgPath, "utf-8");
-    const pkg2 = JSON.parse(content);
-    const allDeps = { ...pkg2.dependencies, ...pkg2.devDependencies };
-    if (!allDeps["react"]) {
-      checks.push({
-        name: "Peer dep: react",
-        status: "fail",
-        message: "react not found in dependencies (required)",
-        fix: "npm install react react-dom"
-      });
-    } else {
-      checks.push({
-        name: "Peer dep: react",
-        status: "pass",
-        message: `react ${allDeps["react"]} installed`
-      });
-    }
-    if (!allDeps["sass"]) {
-      checks.push({
-        name: "Peer dep: sass",
-        status: "warn",
-        message: "sass not installed (needed for custom SCSS theming)",
-        fix: "npm install -D sass"
-      });
-    }
-    const optionalPeers = [
-      { pkg: "recharts", components: "Chart" },
-      { pkg: "shiki", components: "CodeBlock" },
-      { pkg: "react-day-picker", components: "DatePicker" },
-      { pkg: "@tanstack/react-table", components: "DataTable" }
-    ];
-    for (const peer of optionalPeers) {
-      if (allDeps[peer.pkg]) {
-        checks.push({
-          name: `Optional dep: ${peer.pkg}`,
-          status: "pass",
-          message: `${peer.pkg} installed (enables ${peer.components})`
-        });
-      }
-    }
-  } catch {
-    checks.push({
-      name: "Peer dependencies",
-      status: "fail",
-      message: "Could not read package.json"
-    });
-  }
-  return checks;
-}
-async function checkMcpConfig(root) {
-  const mcpConfigPaths = [
-    ".mcp.json",
-    ".cursor/mcp.json",
-    ".vscode/mcp.json"
-  ];
-  for (const configPath of mcpConfigPaths) {
-    try {
-      const fullPath = join10(root, configPath);
-      const content = await readFile11(fullPath, "utf-8");
-      const config = JSON.parse(content);
-      const servers = config.mcpServers || config.servers || {};
-      const hasFragments = Object.values(servers).some((server) => {
-        const s = server;
-        return s.args?.some((arg) => arg.includes("@fragments-sdk/mcp")) || s.command?.includes("fragments");
-      });
-      if (hasFragments) {
-        return {
-          name: "MCP configuration",
-          status: "pass",
-          message: `Fragments MCP server configured in ${configPath}`
-        };
-      }
-    } catch {
-    }
-  }
-  return {
-    name: "MCP configuration",
-    status: "warn",
-    message: "No Fragments MCP server configuration found (optional)",
-    fix: "Run `fragments init` or add @fragments-sdk/mcp to your MCP config"
-  };
-}
-async function checkTypeScript(root) {
-  try {
-    const tsconfigPath = join10(root, "tsconfig.json");
-    await access3(tsconfigPath);
-    return {
-      name: "TypeScript",
-      status: "pass",
-      message: "tsconfig.json found"
-    };
-  } catch {
-    return {
-      name: "TypeScript",
-      status: "warn",
-      message: "No tsconfig.json found (TypeScript recommended but not required)"
-    };
-  }
-}
-async function doctor(options = {}) {
-  const root = resolve11(options.root ?? process.cwd());
-  const checks = [];
-  if (!options.json) {
-    console.log(pc22.cyan(`
-${BRAND.name} Doctor
-`));
-    console.log(pc22.dim(`Checking project at ${root}
-`));
-  }
-  checks.push(await checkPackageInstalled(root));
-  checks.push(await checkStylesImport(root));
-  checks.push(await checkThemeProvider(root));
-  checks.push(...await checkScssSeeds(root));
-  checks.push(...await checkPeerDeps(root));
-  checks.push(await checkMcpConfig(root));
-  checks.push(await checkTypeScript(root));
-  const passed = checks.filter((c) => c.status === "pass").length;
-  const warned = checks.filter((c) => c.status === "warn").length;
-  const failed = checks.filter((c) => c.status === "fail").length;
-  const result = {
-    success: failed === 0,
-    checks,
-    passed,
-    warned,
-    failed
-  };
-  if (options.json) {
-    console.log(JSON.stringify(result, null, 2));
-  } else {
-    for (const check of checks) {
-      const icon = check.status === "pass" ? pc22.green("\u2713") : check.status === "warn" ? pc22.yellow("!") : pc22.red("\u2717");
-      const msg = check.status === "pass" ? check.message : check.status === "warn" ? pc22.yellow(check.message) : pc22.red(check.message);
-      console.log(`  ${icon} ${pc22.bold(check.name)}: ${msg}`);
-      if (check.fix && check.status !== "pass") {
-        console.log(pc22.dim(`    \u2192 ${check.fix}`));
-      }
-    }
-    console.log();
-    if (failed === 0 && warned === 0) {
-      console.log(pc22.green(`\u2713 All ${passed} checks passed \u2014 your setup looks great!`));
-    } else if (failed === 0) {
-      console.log(pc22.green(`\u2713 ${passed} passed`) + pc22.yellow(`, ${warned} warning(s)`));
-    } else {
-      console.log(
-        pc22.red(`\u2717 ${failed} failed`) + (warned > 0 ? pc22.yellow(`, ${warned} warning(s)`) : "") + pc22.dim(`, ${passed} passed`)
-      );
-    }
-    console.log();
-  }
-  return result;
-}
-
 // src/commands/sync.ts
-import pc23 from "picocolors";
-import { readFile as readFile12, writeFile as writeFile9 } from "fs/promises";
+import pc22 from "picocolors";
+import { readFile as readFile11, writeFile as writeFile9 } from "fs/promises";
+import { resolveComponentSourcePath } from "@fragments-sdk/extract";
+import { createComponentExtractor } from "@fragments-sdk/extract";
 async function sync(options = {}) {
   const { config, configDir } = await loadConfig(options.config);
-  console.log(pc23.cyan(`
+  console.log(pc22.cyan(`
 ${BRAND.name} Sync
 `));
   if (options.dryRun) {
-    console.log(pc23.dim("Dry run \u2014 no files will be modified.\n"));
+    console.log(pc22.dim("Dry run \u2014 no files will be modified.\n"));
   }
   const result = await runSync(config, configDir, options);
   if (result.updated.length > 0) {
     const verb = options.dryRun ? "Would update" : "Updated";
-    console.log(pc23.bold(`${verb} ${result.updated.length} fragment(s):
+    console.log(pc22.bold(`${verb} ${result.updated.length} fragment(s):
 `));
     for (const comp of result.updated) {
-      console.log(`  ${pc23.green("\u2713")} ${pc23.bold(comp.name)} ${pc23.dim(`(${comp.file})`)}`);
+      console.log(`  ${pc22.green("\u2713")} ${pc22.bold(comp.name)} ${pc22.dim(`(${comp.file})`)}`);
       for (const change of comp.changes) {
-        console.log(`    ${pc23.dim("\u2022")} ${change}`);
+        console.log(`    ${pc22.dim("\u2022")} ${change}`);
       }
     }
     console.log();
   }
   if (result.skipped.length > 0) {
-    console.log(pc23.dim(`Skipped ${result.skipped.length}: ${result.skipped.map((s) => s.name).join(", ")}
+    console.log(pc22.dim(`Skipped ${result.skipped.length}: ${result.skipped.map((s) => s.name).join(", ")}
 `));
   }
   if (result.errors.length > 0) {
-    console.log(pc23.red(pc23.bold("Errors:")));
+    console.log(pc22.red(pc22.bold("Errors:")));
     for (const err of result.errors) {
-      console.log(`  ${pc23.red("\u2717")} ${pc23.bold(err.file)}: ${err.message}`);
+      console.log(`  ${pc22.red("\u2717")} ${pc22.bold(err.file)}: ${err.message}`);
     }
     console.log();
   }
   if (result.updated.length === 0 && result.errors.length === 0) {
-    console.log(pc23.green("All fragments are in sync \u2014 nothing to update.\n"));
+    console.log(pc22.green("All fragments are in sync \u2014 nothing to update.\n"));
   }
   return result;
 }
@@ -6066,7 +5978,7 @@ async function runSync(config, configDir, options) {
         const fragment = await loadFragmentFile(file.absolutePath);
         if (!fragment?.meta?.name) continue;
         if (options.component && fragment.meta.name !== options.component) continue;
-        const fileContent = await readFile12(file.absolutePath, "utf-8");
+        const fileContent = await readFile11(file.absolutePath, "utf-8");
         const parsed = parseFragmentFile(fileContent, file.absolutePath);
         if (!parsed.componentImport) {
           skipped.push({ name: fragment.meta.name, reason: "No component import found" });
@@ -6228,9 +6140,9 @@ function escapeRegex(str) {
 }
 
 // src/commands/govern.ts
-import pc24 from "picocolors";
+import pc23 from "picocolors";
 async function governCheck(options = {}) {
-  console.log(pc24.cyan(`
+  console.log(pc23.cyan(`
 ${BRAND.name} Governance Check
 `));
   const { cliCheck, formatVerdict } = await import("@fragments-sdk/govern");
@@ -6241,42 +6153,89 @@ ${BRAND.name} Governance Check
     console.log();
   }
   if (result.verdict.passed) {
-    console.log(pc24.green(`\u2713 Governance check passed (score: ${result.verdict.score}/100)
+    console.log(pc23.green(`\u2713 Governance check passed (score: ${result.verdict.score}/100)
 `));
   } else {
-    console.log(pc24.red(`\u2717 Governance check failed (score: ${result.verdict.score}/100)
+    console.log(pc23.red(`\u2717 Governance check failed (score: ${result.verdict.score}/100)
 `));
   }
   return { exitCode: result.exitCode };
 }
 async function governInit(options = {}) {
   const { writeFile: writeFile11 } = await import("fs/promises");
+  const { existsSync: existsSync4 } = await import("fs");
   const { resolve: resolve14 } = await import("path");
   const { generateConfigTemplate } = await import("@fragments-sdk/govern");
+  const { findTailwindConfig } = await import("./token-normalizer-TEPOVBPV.js");
+  const cwd = process.cwd();
+  const detected = {
+    tokenIncludes: [],
+    projectType: "unknown"
+  };
+  const tailwindPath = findTailwindConfig(cwd);
+  if (tailwindPath) {
+    const { relative: relative9 } = await import("path");
+    detected.tokenIncludes.push(relative9(cwd, tailwindPath));
+    detected.projectType = "tailwind";
+    console.log(pc23.dim(`  Detected Tailwind config: ${detected.tokenIncludes[0]}`));
+  }
+  if (detected.tokenIncludes.length === 0) {
+    const candidates = [
+      "src/styles/tokens.scss",
+      "src/styles/variables.scss",
+      "src/styles/theme.scss",
+      "src/tokens.css",
+      "src/styles/tokens.css",
+      "src/styles/variables.css",
+      "styles/tokens.scss",
+      "styles/variables.scss",
+      "tokens.json",
+      "src/tokens.json"
+    ];
+    for (const candidate of candidates) {
+      if (existsSync4(resolve14(cwd, candidate))) {
+        detected.tokenIncludes.push(candidate);
+        detected.projectType = candidate.endsWith(".scss") ? "scss" : candidate.endsWith(".json") ? "dtcg" : "css";
+        console.log(pc23.dim(`  Detected token source: ${candidate}`));
+      }
+    }
+  }
+  if (detected.tokenIncludes.length === 0) {
+    console.log(pc23.dim("  No token sources auto-detected. You can add them manually."));
+  }
   const outputPath = resolve14(options.output ?? "fragments.config.ts");
-  const template = generateConfigTemplate();
+  const template = generateConfigTemplate({ tokenIncludes: detected.tokenIncludes });
   await writeFile11(outputPath, template, "utf-8");
-  console.log(pc24.green(`\u2713 Created ${outputPath}
+  console.log(pc23.green(`
+\u2713 Created ${outputPath}
 `));
+  if (detected.tokenIncludes.length > 0) {
+    console.log(
+      pc23.dim(`  Token sources configured: ${detected.tokenIncludes.join(", ")}`)
+    );
+  }
+  console.log(
+    pc23.dim("  Run ") + pc23.cyan("fragments govern scan") + pc23.dim(" to check your project.\n")
+  );
 }
 async function governConnect() {
-  const { readFile: readFile14, writeFile: writeFile11, appendFile } = await import("fs/promises");
-  const { existsSync: existsSync3 } = await import("fs");
+  const { readFile: readFile13, writeFile: writeFile11, appendFile } = await import("fs/promises");
+  const { existsSync: existsSync4 } = await import("fs");
   const { resolve: resolve14 } = await import("path");
   const { platform } = await import("os");
   const { exec } = await import("child_process");
   const { password, confirm } = await import("@inquirer/prompts");
   const cloudUrl = process.env.FRAGMENTS_URL ?? "https://app.usefragments.com";
-  console.log(pc24.cyan(`
+  console.log(pc23.cyan(`
   ${BRAND.name} \u2014 Connect to Cloud
 `));
   console.log(
-    pc24.dim("  This will connect your project to the Fragments dashboard\n") + pc24.dim("  for centralized audit tracking and team visibility.\n")
+    pc23.dim("  This will connect your project to the Fragments dashboard\n") + pc23.dim("  for centralized audit tracking and team visibility.\n")
   );
-  console.log(pc24.bold("  Step 1 of 3: Get your API key\n"));
+  console.log(pc23.bold("  Step 1 of 3: Get your API key\n"));
   const dashboardUrl = `${cloudUrl}/api-keys`;
-  console.log(pc24.dim(`  \u2192 Opening the dashboard in your browser...`));
-  console.log(pc24.dim(`    Copy your API key from Settings \u2192 API Keys
+  console.log(pc23.dim(`  \u2192 Opening the dashboard in your browser...`));
+  console.log(pc23.dim(`    Copy your API key from Settings \u2192 API Keys
 `));
   const os = platform();
   const openCmd = os === "darwin" ? `open "${dashboardUrl}"` : os === "win32" ? `start "" "${dashboardUrl}"` : `xdg-open "${dashboardUrl}"`;
@@ -6289,42 +6248,42 @@ async function governConnect() {
       mask: "*"
     });
     if (!apiKey.trim()) {
-      console.log(pc24.yellow("\n  API key cannot be empty. Please try again.\n"));
+      console.log(pc23.yellow("\n  API key cannot be empty. Please try again.\n"));
       continue;
     }
-    console.log(pc24.dim("\n  Verifying..."));
+    console.log(pc23.dim("\n  Verifying..."));
     try {
       const response = await fetch(`${cloudUrl}/api/verify`, {
         headers: { Authorization: `Bearer ${apiKey.trim()}` }
       });
       if (!response.ok) {
-        console.log(pc24.red(`
+        console.log(pc23.red(`
   \u2717 Invalid API key (HTTP ${response.status}). Please try again.
 `));
         continue;
       }
       const data = await response.json();
       if (!data.valid) {
-        console.log(pc24.red("\n  \u2717 API key not recognized. Please try again.\n"));
+        console.log(pc23.red("\n  \u2717 API key not recognized. Please try again.\n"));
         continue;
       }
       orgName = data.orgName ?? "your organization";
-      console.log(pc24.green(`
+      console.log(pc23.green(`
   \u2713 Connected to "${orgName}" (verified)
 `));
       break;
     } catch (error) {
       console.log(
-        pc24.red("\n  \u2717 Could not reach the dashboard.")
+        pc23.red("\n  \u2717 Could not reach the dashboard.")
       );
       console.log(
-        pc24.dim(`    ${error instanceof Error ? error.message : "Network error"}
+        pc23.dim(`    ${error instanceof Error ? error.message : "Network error"}
 `)
       );
       continue;
     }
   }
-  console.log(pc24.bold("  Step 2 of 3: Save configuration\n"));
+  console.log(pc23.bold("  Step 2 of 3: Save configuration\n"));
   const saveToEnv = await confirm({
     message: "Save API key to .env file?",
     default: true
@@ -6332,77 +6291,77 @@ async function governConnect() {
   if (saveToEnv) {
     const envPath = resolve14(".env");
     const envEntry = `FRAGMENTS_API_KEY=${apiKey.trim()}`;
-    if (existsSync3(envPath)) {
-      const envContent = await readFile14(envPath, "utf-8");
+    if (existsSync4(envPath)) {
+      const envContent = await readFile13(envPath, "utf-8");
       if (envContent.includes("FRAGMENTS_API_KEY=")) {
         const updated = envContent.replace(
           /^FRAGMENTS_API_KEY=.*$/m,
           envEntry
         );
         await writeFile11(envPath, updated, "utf-8");
-        console.log(pc24.green("  \u2713 Updated FRAGMENTS_API_KEY in .env"));
+        console.log(pc23.green("  \u2713 Updated FRAGMENTS_API_KEY in .env"));
       } else {
         await appendFile(envPath, `
 ${envEntry}
 `, "utf-8");
-        console.log(pc24.green("  \u2713 Added FRAGMENTS_API_KEY to .env"));
+        console.log(pc23.green("  \u2713 Added FRAGMENTS_API_KEY to .env"));
       }
     } else {
       await writeFile11(envPath, `${envEntry}
 `, "utf-8");
-      console.log(pc24.green("  \u2713 Created .env with FRAGMENTS_API_KEY"));
+      console.log(pc23.green("  \u2713 Created .env with FRAGMENTS_API_KEY"));
     }
     if (cloudUrl !== "https://app.usefragments.com") {
-      const envContent = await readFile14(envPath, "utf-8");
+      const envContent = await readFile13(envPath, "utf-8");
       if (!envContent.includes("FRAGMENTS_URL=")) {
         await appendFile(envPath, `FRAGMENTS_URL=${cloudUrl}
 `, "utf-8");
-        console.log(pc24.green(`  \u2713 Added FRAGMENTS_URL to .env`));
+        console.log(pc23.green(`  \u2713 Added FRAGMENTS_URL to .env`));
       }
     }
     const gitignorePath = resolve14(".gitignore");
-    if (existsSync3(gitignorePath)) {
-      const gitignore = await readFile14(gitignorePath, "utf-8");
+    if (existsSync4(gitignorePath)) {
+      const gitignore = await readFile13(gitignorePath, "utf-8");
       if (!gitignore.split("\n").some((line) => line.trim() === ".env")) {
         await appendFile(gitignorePath, "\n.env\n", "utf-8");
-        console.log(pc24.green("  \u2713 Added .env to .gitignore"));
+        console.log(pc23.green("  \u2713 Added .env to .gitignore"));
       }
     } else {
       await writeFile11(gitignorePath, ".env\n", "utf-8");
-      console.log(pc24.green("  \u2713 Created .gitignore with .env entry"));
+      console.log(pc23.green("  \u2713 Created .gitignore with .env entry"));
     }
   }
-  console.log(pc24.bold("\n  Step 3 of 3: Config check\n"));
+  console.log(pc23.bold("\n  Step 3 of 3: Config check\n"));
   const { findGovernConfig } = await import("@fragments-sdk/govern");
   const configPath = findGovernConfig();
   if (configPath) {
-    console.log(pc24.green(`  \u2713 Found govern config: ${configPath}`));
+    console.log(pc23.green(`  \u2713 Found govern config: ${configPath}`));
   } else {
     console.log(
-      pc24.yellow("  No govern config found \u2014 run `fragments govern init` to create one")
+      pc23.yellow("  No govern config found \u2014 run `fragments govern init` to create one")
     );
   }
-  console.log(pc24.dim("\n  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n"));
-  console.log(pc24.green("  \u2713 All set!") + " Run `fragments govern check` to send your first audit.\n");
-  console.log(pc24.dim(`  Dashboard: ${cloudUrl}/overview
+  console.log(pc23.dim("\n  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n"));
+  console.log(pc23.green("  \u2713 All set!") + " Run `fragments govern check` to send your first audit.\n");
+  console.log(pc23.dim(`  Dashboard: ${cloudUrl}/overview
 `));
 }
 async function governReport() {
-  const { readFile: readFile14 } = await import("fs/promises");
-  console.log(pc24.cyan(`
+  const { readFile: readFile13 } = await import("fs/promises");
+  console.log(pc23.cyan(`
 ${BRAND.name} Governance Report
 `));
   let raw;
   try {
-    raw = await readFile14(".govern-audit.jsonl", "utf-8");
+    raw = await readFile13(".govern-audit.jsonl", "utf-8");
   } catch {
-    console.log(pc24.yellow("No audit log found (.govern-audit.jsonl)\n"));
-    console.log(pc24.dim("Run `fragments govern check` to generate audit data.\n"));
+    console.log(pc23.yellow("No audit log found (.govern-audit.jsonl)\n"));
+    console.log(pc23.dim("Run `fragments govern check` to generate audit data.\n"));
     return;
   }
   const lines = raw.trim().split("\n").filter(Boolean);
   if (lines.length === 0) {
-    console.log(pc24.yellow("Audit log is empty.\n"));
+    console.log(pc23.yellow("Audit log is empty.\n"));
     return;
   }
   let totalScore = 0;
@@ -6427,13 +6386,15 @@ ${BRAND.name} Governance Report
 }
 
 // src/commands/migrate-contract.ts
-import pc25 from "picocolors";
+import pc24 from "picocolors";
 import fg4 from "fast-glob";
 import { resolve as resolve13 } from "path";
 
 // src/migrate/fragment-to-contract.ts
-import { readFile as readFile13, writeFile as writeFile10 } from "fs/promises";
-import { resolve as resolve12, dirname as dirname4, relative as relative8 } from "path";
+import { readFile as readFile12, writeFile as writeFile10 } from "fs/promises";
+import { resolve as resolve12, dirname as dirname5, relative as relative8 } from "path";
+import { createComponentExtractor as createComponentExtractor2 } from "@fragments-sdk/extract";
+import { resolveComponentSourcePath as resolveComponentSourcePath2 } from "@fragments-sdk/extract";
 function compilePropsSummaryFromExtracted(props) {
   return Object.entries(props).filter(([, p]) => p.source === "local").map(([name, prop]) => {
     let summary = name + ": ";
@@ -6471,17 +6432,17 @@ function compilePropsSummaryFromDocs(props) {
 async function migrateFragmentToContract(fragmentPath, configDir, options) {
   const warnings = [];
   const absFragmentPath = resolve12(fragmentPath);
-  const content = await readFile13(absFragmentPath, "utf-8");
+  const content = await readFile12(absFragmentPath, "utf-8");
   const parsed = parseFragmentFile(content, fragmentPath);
   warnings.push(...parsed.warnings);
   if (!parsed.meta.name) {
     throw new Error(`Fragment file ${fragmentPath} has no meta.name`);
   }
   let extractedMeta = null;
-  const extractor = createComponentExtractor(options?.tsconfigPath);
+  const extractor = createComponentExtractor2(options?.tsconfigPath);
   try {
     const componentExportName = parsed.componentName ?? parsed.meta.name;
-    const componentSourcePath = resolveComponentSourcePath(
+    const componentSourcePath = resolveComponentSourcePath2(
       absFragmentPath,
       parsed.componentImport
     );
@@ -6497,7 +6458,7 @@ async function migrateFragmentToContract(fragmentPath, configDir, options) {
   }
   let sourcePath;
   if (parsed.componentImport) {
-    const absSource = resolveComponentSourcePath(absFragmentPath, parsed.componentImport);
+    const absSource = resolveComponentSourcePath2(absFragmentPath, parsed.componentImport);
     if (absSource) {
       sourcePath = relative8(configDir, absSource);
     } else {
@@ -6505,7 +6466,7 @@ async function migrateFragmentToContract(fragmentPath, configDir, options) {
       warnings.push(`Could not resolve component source path: ${parsed.componentImport}`);
     }
   } else {
-    const fragDir = dirname4(absFragmentPath);
+    const fragDir = dirname5(absFragmentPath);
     sourcePath = relative8(configDir, resolve12(fragDir, "index.tsx"));
     warnings.push("No component import found; assuming ./index.tsx");
   }
@@ -6609,16 +6570,16 @@ async function migrateFragmentToContract(fragmentPath, configDir, options) {
 async function migrateContract(options) {
   const { config, configDir } = await loadConfig(options.config);
   const pattern = options.glob ?? "src/**/*.fragment.tsx";
-  console.log(pc25.blue(`Migrating fragment files matching: ${pattern}`));
+  console.log(pc24.blue(`Migrating fragment files matching: ${pattern}`));
   if (options.dryRun) {
-    console.log(pc25.yellow("(dry run \u2014 no files will be written)"));
+    console.log(pc24.yellow("(dry run \u2014 no files will be written)"));
   }
   const files = await fg4(pattern, { cwd: configDir, absolute: true });
   if (files.length === 0) {
-    console.log(pc25.yellow("No fragment files found matching pattern."));
+    console.log(pc24.yellow("No fragment files found matching pattern."));
     return { migrated: 0, failed: 0, warnings: 0 };
   }
-  console.log(pc25.dim(`Found ${files.length} fragment file(s)`));
+  console.log(pc24.dim(`Found ${files.length} fragment file(s)`));
   let migrated = 0;
   let failed = 0;
   let totalWarnings = 0;
@@ -6631,31 +6592,31 @@ async function migrateContract(options) {
       });
       migrated++;
       const verb = options.dryRun ? "Would migrate" : "Migrated";
-      console.log(pc25.green(`  \u2713 ${verb}: ${result.contractPath}`));
+      console.log(pc24.green(`  \u2713 ${verb}: ${result.contractPath}`));
       if (result.warnings.length > 0) {
         totalWarnings += result.warnings.length;
         for (const w of result.warnings) {
-          console.log(pc25.yellow(`    \u26A0 ${w}`));
+          console.log(pc24.yellow(`    \u26A0 ${w}`));
         }
       }
     } catch (error) {
       failed++;
-      console.log(pc25.red(`  \u2717 Failed: ${file}`));
-      console.log(pc25.dim(`    ${error instanceof Error ? error.message : String(error)}`));
+      console.log(pc24.red(`  \u2717 Failed: ${file}`));
+      console.log(pc24.dim(`    ${error instanceof Error ? error.message : String(error)}`));
     }
   }
   console.log("");
-  console.log(pc25.bold("Migration summary:"));
-  console.log(`  ${pc25.green(`${migrated} migrated`)}  ${pc25.red(`${failed} failed`)}  ${pc25.yellow(`${totalWarnings} warnings`)}`);
+  console.log(pc24.bold("Migration summary:"));
+  console.log(`  ${pc24.green(`${migrated} migrated`)}  ${pc24.red(`${failed} failed`)}  ${pc24.yellow(`${totalWarnings} warnings`)}`);
   if (!options.dryRun && migrated > 0) {
     console.log("");
-    console.log(pc25.dim("Run `fragments build` to verify migrated contracts compile correctly."));
+    console.log(pc24.dim("Run `fragments build` to verify migrated contracts compile correctly."));
   }
   return { migrated, failed, warnings: totalWarnings };
 }
 
 // src/bin.ts
-var __dirname = dirname5(fileURLToPath(import.meta.url));
+var __dirname = dirname6(fileURLToPath(import.meta.url));
 var pkg = JSON.parse(readFileSync(join11(__dirname, "../package.json"), "utf-8"));
 var EXPERIMENTAL = process.env.FRAGMENTS_EXPERIMENTAL === "1";
 var program = new Command();
@@ -6667,7 +6628,7 @@ program.command("validate").description("Validate fragment files").option("-c, -
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6683,11 +6644,11 @@ program.command("sync").description("Auto-update fragment files from component s
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
-program.command("build").description(`Build compiled ${BRAND.outFile} and ${BRAND.dataDir}/ directory`).option("-c, --config <path>", "Path to config file").option("-o, --output <path>", "Output file path").option("--registry", `Also generate ${BRAND.dataDir}/${BRAND.registryFile} and ${BRAND.contextFile}`).option("--registry-only", `Only generate ${BRAND.dataDir}/ directory (skip ${BRAND.outFile})`).option("--from-source", "Build from source code (zero-config, no fragment files needed)").option("--skip-usage", "Skip usage analysis when building from source").option("--skip-storybook", "Skip Storybook parsing when building from source").option("-v, --verbose", "Verbose output").action(async (options) => {
+program.command("build").description(`Build compiled ${BRAND.outFile} and ${BRAND.dataDir}/ directory`).option("-c, --config <path>", "Path to config file").option("-o, --output <path>", "Output file path").option("--registry", `Also generate ${BRAND.dataDir}/${BRAND.registryFile} and ${BRAND.contextFile}`).option("--registry-only", `Only generate ${BRAND.dataDir}/ directory (skip ${BRAND.outFile})`).option("--from-source", "Build from source code (zero-config, no fragment files needed)").option("--if-needed", `Skip rebuilding when ${BRAND.outFile} is already fresh`).option("--check", `Check whether ${BRAND.outFile} is fresh and exit non-zero if it is stale`).option("--skip-usage", "Skip usage analysis when building from source").option("--skip-storybook", "Skip Storybook parsing when building from source").option("-v, --verbose", "Verbose output").action(async (options) => {
   try {
     const result = await build({
       config: options.config,
@@ -6695,6 +6656,8 @@ program.command("build").description(`Build compiled ${BRAND.outFile} and ${BRAN
       registry: options.registry,
       registryOnly: options.registryOnly,
       fromSource: options.fromSource,
+      ifNeeded: options.ifNeeded,
+      check: options.check,
       skipUsage: options.skipUsage,
       skipStorybook: options.skipStorybook,
       verbose: options.verbose
@@ -6703,7 +6666,7 @@ program.command("build").description(`Build compiled ${BRAND.outFile} and ${BRAN
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6722,7 +6685,7 @@ program.command("context").description("Generate AI-ready context for your desig
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6749,7 +6712,7 @@ program.command("ai").description("Generate context optimized for AI assistants
       }
     }
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6757,7 +6720,7 @@ program.command("list").description("List all discovered fragment files").option
   try {
     await list(options);
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6765,7 +6728,7 @@ program.command("reset").description("Reset to initial state (delete all generat
   try {
     await reset(options);
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6779,7 +6742,7 @@ linkCommand.command("figma").argument("[figma-url]", "Figma file URL to link com
       variants: options.variants
     });
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6794,7 +6757,7 @@ linkCommand.command("storybook").description("Bootstrap fragments from existing
       exclude: options.exclude
     });
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6814,7 +6777,7 @@ program.command("screenshot").description("Capture screenshots of component vari
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6833,7 +6796,7 @@ program.command("diff").argument("[component]", "Component name to diff (optiona
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6852,8 +6815,8 @@ program.command("compare").argument("[component]", "Component name to compare").
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
-    console.log(pc26.dim(`
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
+    console.log(pc25.dim(`
 Make sure a dev server is running on the expected port.`));
     process.exit(1);
   }
@@ -6872,7 +6835,7 @@ program.command("analyze").description("Analyze design system and generate repor
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6891,7 +6854,7 @@ program.command("verify").argument("[component]", "Component name to verify (opt
     if (options.ci) {
       console.log(JSON.stringify({ error: error instanceof Error ? error.message : "Verification failed" }));
     } else {
-      console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+      console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     }
     process.exit(1);
   }
@@ -6908,7 +6871,7 @@ program.command("audit").description("Scan all fragments and show compliance met
     if (options.json) {
       console.log(JSON.stringify({ error: error instanceof Error ? error.message : "Audit failed" }));
     } else {
-      console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+      console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     }
     process.exit(1);
   }
@@ -6930,7 +6893,7 @@ program.command("a11y").description("Run accessibility checks on all component v
     if (options.json) {
       console.log(JSON.stringify({ error: error instanceof Error ? error.message : "A11y check failed" }));
     } else {
-      console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+      console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     }
     process.exit(1);
   }
@@ -6953,7 +6916,7 @@ program.command("enhance").description("AI-powered documentation generation from
     if (options.format === "json") {
       console.log(JSON.stringify({ success: false, error: error instanceof Error ? error.message : "Enhance failed" }));
     } else {
-      console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+      console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     }
     process.exit(1);
   }
@@ -6974,7 +6937,7 @@ program.command("scan").description(`Zero-config ${BRAND.outFile} generation fro
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6990,7 +6953,7 @@ program.command("migrate-contract").description("Migrate .fragment.tsx files to
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -7003,7 +6966,7 @@ program.command("storygen").description("Generate Storybook stories from fragmen
       format: options.format
     });
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -7015,7 +6978,7 @@ program.command("metrics").argument("[component]", "Component name (optional, sh
       json: options.json
     });
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -7029,9 +6992,9 @@ program.command("baseline").description("Manage visual regression baselines").ar
       port: options.port
     });
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     if (action === "update") {
-      console.log(pc26.dim(`
+      console.log(pc25.dim(`
 Make sure a dev server is running on the expected port.`));
     }
     process.exit(1);
@@ -7039,27 +7002,27 @@ Make sure a dev server is running on the expected port.`));
 });
 program.command("view").description(`Generate a static HTML viewer for ${BRAND.outFile}`).option("-i, --input <path>", `Path to ${BRAND.outFile}`, BRAND.outFile).option("-o, --output <path>", "Output HTML file path", BRAND.viewerHtmlFile).option("--open", "Open in browser after generation").action(async (options) => {
   try {
-    const { generateViewerFromJson } = await import("./static-viewer-63PG6FWY.js");
+    const { generateViewerFromJson } = await import("./static-viewer-7QIBQZRC.js");
     const fs2 = await import("fs/promises");
     const path = await import("path");
     const inputPath = path.resolve(process.cwd(), options.input);
     const outputPath = path.resolve(process.cwd(), options.output);
-    console.log(pc26.cyan(`
+    console.log(pc25.cyan(`
 ${BRAND.name} Viewer Generator
 `));
     try {
       await fs2.access(inputPath);
     } catch {
-      console.log(pc26.red(`Error: ${options.input} not found.`));
-      console.log(pc26.dim(`
-Run ${pc26.cyan(`${BRAND.cliCommand} build`)} first to generate ${BRAND.outFile}
+      console.log(pc25.red(`Error: ${options.input} not found.`));
+      console.log(pc25.dim(`
+Run ${pc25.cyan(`${BRAND.cliCommand} build`)} first to generate ${BRAND.outFile}
 `));
       process.exit(1);
     }
-    console.log(pc26.dim(`Reading: ${options.input}`));
+    console.log(pc25.dim(`Reading: ${options.input}`));
     const html = await generateViewerFromJson(inputPath);
     await fs2.writeFile(outputPath, html);
-    console.log(pc26.green(`
+    console.log(pc25.green(`
 \u2713 Generated: ${options.output}
 `));
     if (options.open) {
@@ -7068,7 +7031,7 @@ Run ${pc26.cyan(`${BRAND.cliCommand} build`)} first to generate ${BRAND.outFile}
       exec(`${openCmd} "${outputPath}"`);
     }
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -7081,7 +7044,31 @@ program.command("add").argument("[name]", 'Component name (e.g., "Button", "Text
       component: options.component
     });
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+});
+program.command("create").argument("[name]", "Project name").description("Create a new project with Fragments UI and your custom theme").option("-t, --template <template>", "Framework template (nextjs, vite)", "nextjs").option("--pm <manager>", "Package manager (npm, pnpm, yarn, bun)").option("--theme <encoded>", "Encoded theme string").option("--preset <id>", "Theme preset ID from usefragments.com/create").option("--brand <color>", "Brand color hex (e.g., #6366f1)").option("--scss", "Use SCSS output (installs sass)").option("--mcp", "Configure MCP server for AI tooling").option("-y, --yes", "Skip interactive prompts").option("--no-git", "Skip git initialization").action(async (name, options) => {
+  try {
+    const { create } = await import("./create-JVAU3YKN.js");
+    const result = await create({
+      name,
+      template: options.template,
+      packageManager: options.pm,
+      theme: options.theme,
+      preset: options.preset,
+      brand: options.brand,
+      scss: options.scss,
+      mcp: options.mcp,
+      yes: options.yes,
+      noGit: !options.git
+    });
+    if (!result.success) {
+      if (result.error) console.error(pc25.red(`Error: ${result.error}`));
+      process.exit(1);
+    }
+  } catch (error) {
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -7098,7 +7085,7 @@ program.command("setup").description("Configure @fragments-sdk/ui in a consumer
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -7110,13 +7097,13 @@ initCmd.action(async (options) => {
   try {
     if (options.cloud) {
       if (!EXPERIMENTAL) {
-        console.log(pc26.yellow(`
+        console.log(pc25.yellow(`
   Fragments Cloud is not yet publicly available.`));
-        console.log(pc26.dim(`  Set FRAGMENTS_EXPERIMENTAL=1 to enable preview features.
+        console.log(pc25.dim(`  Set FRAGMENTS_EXPERIMENTAL=1 to enable preview features.
 `));
         process.exit(1);
       }
-      const { initCloud } = await import("./init-cloud-MQ6GRJAZ.js");
+      const { initCloud } = await import("./init-cloud-3DNKPWFB.js");
       await initCloud({
         url: options.cloudUrl,
         port: options.port ? Number(options.port) : void 0,
@@ -7125,7 +7112,7 @@ initCmd.action(async (options) => {
       });
       return;
     }
-    const { init } = await import("./init-HGSM35XA.js");
+    const { init } = await import("./init-SSGUSP7Z.js");
     const result = await init({
       projectRoot: process.cwd(),
       force: options.force,
@@ -7141,20 +7128,20 @@ initCmd.action(async (options) => {
       govern: options.govern
     });
     if (!result.success) {
-      console.error(pc26.red("\nInit failed with errors:"));
+      console.error(pc25.red("\nInit failed with errors:"));
       for (const error of result.errors) {
-        console.error(pc26.red(`  - ${error}`));
+        console.error(pc25.red(`  - ${error}`));
       }
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
 program.command("snapshot").description("Run visual snapshot tests per component variant").option("-p, --port <port>", "Port of running dev server (skips starting one)").option("--update", "Update existing snapshots instead of comparing").option("--component <name>", "Filter to a specific component").option("--spec <path>", "Path to snapshot spec file").option("--ci", "CI mode - exit 1 on mismatch").action(async (options) => {
   try {
-    const { snapshot } = await import("./snapshot-KQEQ6XHL.js");
+    const { snapshot } = await import("./snapshot-WIJMEIFT.js");
     const result = await snapshot({
       port: options.port,
       update: options.update,
@@ -7166,14 +7153,14 @@ program.command("snapshot").description("Run visual snapshot tests per component
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
 var tokensCmd = program.command("tokens").description("Design token discovery, listing, and generation");
 tokensCmd.command("list", { isDefault: true }).description("Discover and list design tokens from CSS/SCSS/DTCG files").option("-c, --config <path>", "Path to config file").option("--json", "Output as JSON").option("--categories", "Group tokens by category").option("--theme <theme>", "Filter by theme name").option("--category <category>", "Filter by category (color, spacing, typography, etc.)").option("--verbose", "Show all tokens (no truncation)").action(async (options) => {
   try {
-    const { tokens } = await import("./tokens-6GYKDV6U.js");
+    const { tokens } = await import("./tokens-NZWFQIAB.js");
     const result = await tokens({
       config: options.config,
       json: options.json,
@@ -7186,13 +7173,13 @@ tokensCmd.command("list", { isDefault: true }).description("Discover and list de
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
 tokensCmd.command("generate").description("Generate CSS, SCSS, Tailwind, or Figma output from a DTCG .tokens.json file").requiredOption("--from <path>", "Path to DTCG .tokens.json source file").requiredOption("--format <formats>", "Output formats (comma-separated: css, scss, tailwind, figma)").option("--out <dir>", "Output directory (default: same directory as source)").option("--prefix <prefix>", "Token name prefix").option("--selector <selector>", "CSS selector for custom properties (default: :root)").option("--verbose", "Verbose output").action(async (options) => {
   try {
-    const { tokensGenerate } = await import("./tokens-generate-VTZV5EEW.js");
+    const { tokensGenerate } = await import("./tokens-generate-5JQSJ27E.js");
     await tokensGenerate({
       from: options.from,
       format: options.format,
@@ -7202,13 +7189,27 @@ tokensCmd.command("generate").description("Generate CSS, SCSS, Tailwind, or Figm
       verbose: options.verbose
     });
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+});
+tokensCmd.command("push").description("Push code tokens to Fragments Cloud for drift comparison").option("-c, --config <path>", "Path to fragments config file").option("--tailwind-v4 <path>", "Path to Tailwind v4 CSS file with @theme block").option("--dry-run", "Parse and display tokens without pushing").option("--verbose", "Show detailed output").action(async (options) => {
+  try {
+    const { tokensPush } = await import("./tokens-push-HY3KO36V.js");
+    await tokensPush({
+      config: options.config,
+      tailwindV4: options.tailwindV4,
+      dryRun: options.dryRun,
+      verbose: options.verbose
+    });
+  } catch (error) {
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
 program.command("generate").description("Generate fragment files from component source code").argument("[component]", "Specific component name to generate (optional)").option("--force", "Overwrite existing fragment files").option("--pattern <glob>", "Pattern for component files", "src/components/**/*.tsx").action(async (component, options) => {
   try {
-    const { generate } = await import("./generate-A4FP5426.js");
+    const { generate } = await import("./generate-PVOLUAAC.js");
     const result = await generate({
       projectRoot: process.cwd(),
       component,
@@ -7216,11 +7217,11 @@ program.command("generate").description("Generate fragment files from component
       componentPattern: options.pattern
     });
     if (!result.success) {
-      console.error(pc26.red("\nGenerate completed with errors"));
+      console.error(pc25.red("\nGenerate completed with errors"));
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -7228,7 +7229,7 @@ program.command("graph").description("Query the component relationship graph").a
   try {
     await graph(component, options);
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -7246,7 +7247,7 @@ program.command("inspect").description("Inspect a single component from compiled
     if (options.json) {
       console.log(JSON.stringify({ error: error instanceof Error ? error.message : "Inspect failed" }));
     } else {
-      console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+      console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     }
     process.exit(1);
   }
@@ -7265,7 +7266,7 @@ program.command("discover").description("List and filter components from compile
     if (options.json) {
       console.log(JSON.stringify({ error: error instanceof Error ? error.message : "Discover failed" }));
     } else {
-      console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+      console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     }
     process.exit(1);
   }
@@ -7284,14 +7285,14 @@ program.command("perf").description("Profile component bundle sizes and performa
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
 program.command("test").description("Run interaction tests for fragments with play functions").option("-c, --config <path>", "Path to config file").option("--component <name>", "Filter by component name").option("--tags <tags>", "Filter by tags (comma-separated)").option("--grep <pattern>", "Filter by variant name pattern").option("--exclude <pattern>", "Exclude tests matching pattern").option("--parallel <count>", "Number of parallel browser contexts", parseInt, 4).option("--timeout <ms>", "Timeout per test in milliseconds", parseInt, 3e4).option("--retries <count>", "Number of retries for failed tests", parseInt, 0).option("--bail", "Stop on first failure").option("--browser <name>", "Browser to use (chromium, firefox, webkit)", "chromium").option("--headed", "Run in headed mode (show browser)").option("--a11y", "Run accessibility checks with axe-core").option("--visual", "Capture screenshots for visual regression").option("--update-snapshots", "Update visual snapshots").option("--watch", "Watch mode - re-run on file changes").option("--reporters <names>", "Reporters to use (console, junit, json)", "console").option("-o, --output <dir>", "Output directory for results", "./test-results").option("--server-url <url>", "URL of running dev server (skips starting server)").option("-p, --port <port>", "Port for dev server", parseInt, 6006).option("--ci", "CI mode - non-interactive, exit with code 1 on failure").option("--list", "List available tests without running them").action(async (options) => {
   try {
     const { config, configDir } = await loadConfig(options.config);
-    const { runTestCommand, listTests } = await import("./test-UQYUCZIS.js");
+    const { runTestCommand, listTests } = await import("./test-64Z5BKBA.js");
     if (options.list) {
       await listTests(config, configDir, {
         component: options.component,
@@ -7324,12 +7325,13 @@ program.command("test").description("Run interaction tests for fragments with pl
     });
     process.exit(exitCode);
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
 program.command("doctor").description("Diagnose design system configuration issues").option("--root <dir>", "Project root directory", process.cwd()).option("--json", "Output results as JSON").option("--fix", "Auto-fix issues where possible").action(async (options) => {
   try {
+    const { doctor } = await import("./doctor-BDPMYYE6.js");
     const result = await doctor({
       root: options.root,
       json: options.json,
@@ -7339,15 +7341,15 @@ program.command("doctor").description("Diagnose design system configuration issu
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
 var governCmd = program.command("govern").description(EXPERIMENTAL ? "AI UI governance checks" : "AI UI governance checks (preview \u2014 set FRAGMENTS_EXPERIMENTAL=1)").hook("preAction", () => {
   if (!EXPERIMENTAL) {
-    console.log(pc26.yellow(`
+    console.log(pc25.yellow(`
   Fragments governance is not yet publicly available.`));
-    console.log(pc26.dim(`  Set FRAGMENTS_EXPERIMENTAL=1 to enable preview features.
+    console.log(pc25.dim(`  Set FRAGMENTS_EXPERIMENTAL=1 to enable preview features.
 `));
     process.exit(1);
   }
@@ -7362,7 +7364,7 @@ governCmd.command("check").description("Validate a UISpec against governance pol
     });
     process.exit(exitCode);
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -7370,7 +7372,7 @@ governCmd.command("init").description("Generate a fragments.config.ts with gover
   try {
     await governInit({ output: options.output });
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -7378,7 +7380,7 @@ governCmd.command("report").description("Summarize governance audit log").action
   try {
     await governReport();
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -7386,13 +7388,13 @@ governCmd.command("connect").description("Connect your project to the Fragments
   try {
     await governConnect();
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
 governCmd.command("scan").description("Scan JSX/TSX codebase for governance violations").option("-d, --dir <path>", "Root directory (default: auto-detect)").option("-c, --config <path>", "Path to govern.config.ts").option("-f, --format <format>", "Output format: summary, json, sarif", "summary").option("-q, --quiet", "Suppress non-error output").action(async (options) => {
   try {
-    const { governScan } = await import("./govern-scan-UCBZR6D6.js");
+    const { governScan } = await import("./govern-scan-OYFZYOQW.js");
     const { exitCode } = await governScan({
       dir: options.dir,
       config: options.config,
@@ -7401,13 +7403,13 @@ governCmd.command("scan").description("Scan JSX/TSX codebase for governance viol
     });
     process.exit(exitCode);
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
 governCmd.command("watch").description("Watch JSX/TSX files and re-check on changes").option("-d, --dir <path>", "Root directory (default: auto-detect)").option("-c, --config <path>", "Path to govern.config.ts").option("-q, --quiet", "Suppress non-error output").option("--debounce <ms>", "Debounce interval in ms", "300").action(async (options) => {
   try {
-    const { governWatch } = await import("./govern-scan-UCBZR6D6.js");
+    const { governWatch } = await import("./govern-scan-OYFZYOQW.js");
     await governWatch({
       dir: options.dir,
       config: options.config,
@@ -7415,7 +7417,22 @@ governCmd.command("watch").description("Watch JSX/TSX files and re-check on chan
       debounce: parseInt(options.debounce, 10)
     });
   } catch (error) {
-    console.error(pc26.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+});
+governCmd.command("push-contracts").description("Push component contracts to Fragments Cloud").option("-i, --input <path>", "Path to fragments.json (default: ./fragments.json)").option("--url <url>", "Fragments Cloud URL").option("--api-key <key>", "API key (default: FRAGMENTS_API_KEY env var)").option("-q, --quiet", "Suppress non-error output").action(async (options) => {
+  try {
+    const { pushContracts } = await import("./push-contracts-WY32TFP6.js");
+    const { exitCode } = await pushContracts({
+      input: options.input,
+      url: options.url,
+      apiKey: options.apiKey,
+      quiet: options.quiet
+    });
+    process.exit(exitCode);
+  } catch (error) {
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });