@fragments-sdk/cli 0.8.1 → 0.9.1

package/dist/bin.js

@@ -1,5 +1,8 @@
 #!/usr/bin/env node
 import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
+import {
+  scan
+} from "./chunk-5GT62FCB.js";
 import {
   buildFragments,
   buildFragmentsDir,
@@ -12,14 +15,11 @@ import {
   validateCoverage,
   validateSchema,
   validateSnippets
-} from "./chunk-2JIKCJX3.js";
-import {
-  scan
-} from "./chunk-WI6SLMSO.js";
+} from "./chunk-D7372LQX.js";
 import {
   loadConfig,
   loadFragmentFile
-} from "./chunk-CJEGT3WD.js";
+} from "./chunk-BW3ZATBW.js";
 import {
   discoverFragmentFiles
 } from "./chunk-AWYCDRPG.js";
@@ -44,8 +44,9 @@ import {
   formatBytes,
   generateContext,
   resolvePerformanceConfig
-} from "./chunk-NGIMCIK2.js";
-import "./chunk-GOVI6COW.js";
+} from "./chunk-GF6OVPIN.js";
+import "./chunk-NVSPGSKB.js";
+import "./chunk-EZYXYWNF.js";
 import {
   BRAND
 } from "./chunk-EKLMXTWU.js";
@@ -53,10 +54,10 @@ import "./chunk-Z7EY4VHE.js";
 
 // src/bin.ts
 import { Command } from "commander";
-import pc22 from "picocolors";
+import pc23 from "picocolors";
 import { readFileSync } from "fs";
 import { fileURLToPath } from "url";
-import { dirname as dirname4, join as join10 } from "path";
+import { dirname as dirname4, join as join11 } from "path";
 
 // src/commands/validate.ts
 import pc from "picocolors";
@@ -176,9 +177,20 @@ ${BRAND.name} Build
     }
     fragmentCount = result.fragmentCount;
     outputPath = result.outputPath;
-    console.log(pc2.green(`\u2713 Built ${result.fragmentCount} fragment(s)`));
-    console.log(pc2.dim(`  Output: ${result.outputPath}
+    if (result.fragmentCount === 0 && result.errors.length === 0) {
+      console.log(pc2.dim("No compilable fragment files found. Falling back to source scan...\n"));
+      const scanResult = await scan({
+        config: options.config,
+        output: options.output,
+        verbose: options.verbose
+      });
+      fragmentCount = scanResult.componentCount;
+      outputPath = scanResult.outputPath;
+    } else {
+      console.log(pc2.green(`\u2713 Built ${result.fragmentCount} fragment(s)`));
+      console.log(pc2.dim(`  Output: ${result.outputPath}
 `));
+    }
   }
   if (options.registry || options.registryOnly) {
     console.log(pc2.dim("Generating registry and context...\n"));
@@ -602,6 +614,7 @@ function parseMeta(content, filePath, warnings) {
     );
     if (importMatch) {
       result.componentImport = importMatch[1];
+      result.isDefaultImport = false;
     } else {
       const defaultImportMatch = content.match(
         new RegExp(
@@ -610,6 +623,7 @@ function parseMeta(content, filePath, warnings) {
       );
       if (defaultImportMatch) {
         result.componentImport = defaultImportMatch[1];
+        result.isDefaultImport = true;
       }
     }
   }
@@ -1199,6 +1213,7 @@ function convertToFragment(parsed) {
   const code = generateFragmentCode({
     componentName,
     componentImport: parsed.meta.componentImport,
+    isDefaultImport: parsed.meta.isDefaultImport,
     description: parsed.meta.description,
     category,
     tags: parsed.meta.tags,
@@ -1434,6 +1449,7 @@ function generateFragmentCode(options) {
   const {
     componentName,
     componentImport,
+    isDefaultImport,
     description,
     category,
     tags,
@@ -1461,8 +1477,9 @@ ${generated.skippedVariants.map((sv) => `      { name: "${escapeString(sv.name)}
   },
 `;
   }
+  const componentImportStatement = isDefaultImport ? `import ${componentName} from "${componentImport}";` : `import { ${componentName} } from "${componentImport}";`;
   return `import { defineFragment } from "@fragments-sdk/cli/core";
-import { ${componentName} } from "${componentImport}";
+${componentImportStatement}
 
 export default defineFragment({
   component: ${componentName},
@@ -1717,27 +1734,48 @@ async function runSetup(options = {}) {
       const sbConfig = await detectStorybookConfig(configDir);
       if (sbConfig) {
         log(pc6.dim(`   Found Storybook at ${sbConfig.configPath}`));
-        log(pc6.dim("   Converting stories to fragments...\n"));
-        const storyFiles = await discoverStoryFiles(configDir, sbConfig.storyPatterns);
-        if (storyFiles.length > 0) {
-          let converted = 0;
-          for (const storyFile of storyFiles) {
-            try {
-              const parsed = await parseStoryFile(storyFile);
-              const fragmentResult = convertToFragment(parsed);
-              await fs2.mkdir(path.dirname(fragmentResult.outputFile), { recursive: true });
-              await fs2.writeFile(fragmentResult.outputFile, fragmentResult.code);
-              converted++;
-            } catch {
+        const hasStoryPatterns = config.include.some((p) => p.includes(".stories."));
+        if (hasStoryPatterns) {
+          log(pc6.dim("   Stories included in config \u2014 viewer will load them directly\n"));
+          fragmentFiles = await discoverFragmentFiles(config, configDir);
+          if (fragmentFiles.length > 0) {
+            log(pc6.green(`   Found ${fragmentFiles.length} story/fragment file(s)`));
+          }
+        } else {
+          log(pc6.dim("   Converting stories to fragments...\n"));
+          const storyFiles = await discoverStoryFiles(configDir, sbConfig.storyPatterns);
+          if (storyFiles.length > 0) {
+            let converted = 0;
+            for (const storyFile of storyFiles) {
+              try {
+                const parsed = await parseStoryFile(storyFile);
+                const fragmentResult = convertToFragment(parsed);
+                await fs2.mkdir(path.dirname(fragmentResult.outputFile), { recursive: true });
+                await fs2.writeFile(fragmentResult.outputFile, fragmentResult.code);
+                converted++;
+              } catch {
+              }
             }
+            result.fragmentFilesCreated = converted;
+            log(pc6.green(`   Generated ${converted} fragment file(s)`));
+            fragmentFiles = await discoverFragmentFiles(config, configDir);
           }
-          result.fragmentFilesCreated = converted;
-          log(pc6.green(`   Generated ${converted} fragment file(s)`));
-          fragmentFiles = await discoverFragmentFiles(config, configDir);
         }
       } else {
         log(pc6.dim("   No Storybook config found"));
-        log(pc6.dim(`   Run ${pc6.cyan(`${BRAND.cliCommand} add <ComponentName>`)} to create your first fragment`));
+        log(pc6.dim("   Auto-scanning source code...\n"));
+        try {
+          const scanResult = await scan({
+            config: options.configPath,
+            verbose: false
+          });
+          if (scanResult.componentCount > 0) {
+            result.fragmentsBuilt = scanResult.componentCount;
+            log(pc6.green(`   Scanned ${scanResult.componentCount} component(s) from source`));
+          }
+        } catch {
+          log(pc6.dim(`   Run ${pc6.cyan(`${BRAND.cliCommand} scan`)} to generate documentation from source`));
+        }
       }
     } else if (fragmentFiles.length > 0) {
       log(pc6.green(`   Found ${fragmentFiles.length} fragment file(s)`));
@@ -1757,7 +1795,19 @@ ${reason} ${BRAND.outFile}...`));
               result.errors.push(`${err.file}: ${err.error}`);
             }
           }
-          log(pc6.green(`   Built ${buildResult.fragmentCount} fragment(s)`));
+          if (buildResult.fragmentCount > 0) {
+            log(pc6.green(`   Built ${buildResult.fragmentCount} fragment(s)`));
+          } else {
+            log(pc6.dim("   No compilable fragments found, falling back to source scan..."));
+            try {
+              const scanResult = await scan({ verbose: false });
+              if (scanResult.componentCount > 0) {
+                result.fragmentsBuilt = scanResult.componentCount;
+                log(pc6.green(`   Scanned ${scanResult.componentCount} component(s) from source`));
+              }
+            } catch {
+            }
+          }
         } catch (error) {
           result.errors.push(`Build failed: ${error instanceof Error ? error.message : "Unknown error"}`);
         }
@@ -1811,7 +1861,7 @@ ${BRAND.name} Dev Server
       }
     }
   }
-  const { createDevServer } = await import("./viewer-HZK4BSDK.js");
+  const { createDevServer } = await import("./viewer-RFA2KVBG.js");
   console.log(pc7.dim("\nStarting dev server..."));
   const parsedPort = typeof port === "string" ? parseInt(port, 10) : port;
   try {
@@ -5363,9 +5413,384 @@ ${pc21.bold("Summary")}`);
   };
 }
 
+// src/commands/doctor.ts
+import { readFile as readFile8, access as access3 } from "fs/promises";
+import { join as join10, resolve as resolve8 } 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 readFile8(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 readFile8(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 readFile8(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 readFile8(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 readFile8(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 readFile8(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 readFile8(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 = resolve8(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/bin.ts
 var __dirname = dirname4(fileURLToPath(import.meta.url));
-var pkg = JSON.parse(readFileSync(join10(__dirname, "../package.json"), "utf-8"));
+var pkg = JSON.parse(readFileSync(join11(__dirname, "../package.json"), "utf-8"));
 var program = new Command();
 program.name(BRAND.cliCommand).description(`${BRAND.name} - Design system documentation and compliance tool`).version(pkg.version);
 program.command("validate").description("Validate fragment files").option("-c, --config <path>", "Path to config file").option("--schema", "Validate fragment schema only").option("--coverage", "Validate coverage only").option("--snippets", "Validate snippet/render policy only").option("--snippet-mode <mode>", "Override snippet policy mode (warn|error)").option("--component-start <name>", "Start component name for alphabetical snippet batch validation").option("--component-limit <n>", "Component count for alphabetical snippet batch validation", (value) => Number.parseInt(value, 10)).action(async (options) => {
@@ -5375,7 +5800,7 @@ program.command("validate").description("Validate fragment files").option("-c, -
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc22.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5395,7 +5820,7 @@ program.command("build").description(`Build compiled ${BRAND.outFile} and ${BRAN
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc22.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5414,7 +5839,7 @@ program.command("context").description("Generate AI-ready context for your desig
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc22.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5441,7 +5866,7 @@ program.command("ai").description("Generate context optimized for AI assistants
       }
     }
   } catch (error) {
-    console.error(pc22.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5449,7 +5874,7 @@ program.command("list").description("List all discovered fragment files").option
   try {
     await list(options);
   } catch (error) {
-    console.error(pc22.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5457,7 +5882,7 @@ program.command("reset").description("Reset to initial state (delete all generat
   try {
     await reset(options);
   } catch (error) {
-    console.error(pc22.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5471,7 +5896,7 @@ linkCommand.command("figma").argument("[figma-url]", "Figma file URL to link com
       variants: options.variants
     });
   } catch (error) {
-    console.error(pc22.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5486,7 +5911,7 @@ linkCommand.command("storybook").description("Bootstrap fragments from existing
       exclude: options.exclude
     });
   } catch (error) {
-    console.error(pc22.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5501,9 +5926,9 @@ program.command("dev").description("Start the development server with live compo
       skipBuild: options.skipBuild
     });
   } catch (error) {
-    console.error(pc22.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
     if (error instanceof Error && error.stack) {
-      console.error(pc22.dim(error.stack));
+      console.error(pc23.dim(error.stack));
     }
     process.exit(1);
   }
@@ -5524,7 +5949,7 @@ program.command("screenshot").description("Capture screenshots of component vari
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc22.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5543,7 +5968,7 @@ program.command("diff").argument("[component]", "Component name to diff (optiona
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc22.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5562,8 +5987,8 @@ program.command("compare").argument("[component]", "Component name to compare").
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc22.red("Error:"), error instanceof Error ? error.message : error);
-    console.log(pc22.dim(`
+    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
+    console.log(pc23.dim(`
 Make sure the dev server is running: ${BRAND.cliCommand} dev`));
     process.exit(1);
   }
@@ -5582,7 +6007,7 @@ program.command("analyze").description("Analyze design system and generate repor
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc22.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5601,7 +6026,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(pc22.red("Error:"), error instanceof Error ? error.message : error);
+      console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
     }
     process.exit(1);
   }
@@ -5618,7 +6043,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(pc22.red("Error:"), error instanceof Error ? error.message : error);
+      console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
     }
     process.exit(1);
   }
@@ -5640,7 +6065,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(pc22.red("Error:"), error instanceof Error ? error.message : error);
+      console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
     }
     process.exit(1);
   }
@@ -5663,7 +6088,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(pc22.red("Error:"), error instanceof Error ? error.message : error);
+      console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
     }
     process.exit(1);
   }
@@ -5684,7 +6109,7 @@ program.command("scan").description(`Zero-config ${BRAND.outFile} generation fro
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc22.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5697,7 +6122,7 @@ program.command("storygen").description("Generate Storybook stories from fragmen
       format: options.format
     });
   } catch (error) {
-    console.error(pc22.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5709,7 +6134,7 @@ program.command("metrics").argument("[component]", "Component name (optional, sh
       json: options.json
     });
   } catch (error) {
-    console.error(pc22.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5723,9 +6148,9 @@ program.command("baseline").description("Manage visual regression baselines").ar
       port: options.port
     });
   } catch (error) {
-    console.error(pc22.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
     if (action === "update") {
-      console.log(pc22.dim(`
+      console.log(pc23.dim(`
 Make sure the dev server is running: ${BRAND.cliCommand} dev`));
     }
     process.exit(1);
@@ -5733,27 +6158,27 @@ Make sure the dev server is running: ${BRAND.cliCommand} dev`));
 });
 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-NSODM5VX.js");
+    const { generateViewerFromJson } = await import("./static-viewer-XCS7UJTO.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(pc22.cyan(`
+    console.log(pc23.cyan(`
 ${BRAND.name} Viewer Generator
 `));
     try {
       await fs2.access(inputPath);
     } catch {
-      console.log(pc22.red(`Error: ${options.input} not found.`));
-      console.log(pc22.dim(`
-Run ${pc22.cyan(`${BRAND.cliCommand} build`)} first to generate ${BRAND.outFile}
+      console.log(pc23.red(`Error: ${options.input} not found.`));
+      console.log(pc23.dim(`
+Run ${pc23.cyan(`${BRAND.cliCommand} build`)} first to generate ${BRAND.outFile}
 `));
       process.exit(1);
     }
-    console.log(pc22.dim(`Reading: ${options.input}`));
+    console.log(pc23.dim(`Reading: ${options.input}`));
     const html = await generateViewerFromJson(inputPath);
     await fs2.writeFile(outputPath, html);
-    console.log(pc22.green(`
+    console.log(pc23.green(`
 \u2713 Generated: ${options.output}
 `));
     if (options.open) {
@@ -5762,7 +6187,7 @@ Run ${pc22.cyan(`${BRAND.cliCommand} build`)} first to generate ${BRAND.outFile}
       exec(`${openCmd} "${outputPath}"`);
     }
   } catch (error) {
-    console.error(pc22.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5775,33 +6200,33 @@ program.command("add").argument("[name]", 'Component name (e.g., "Button", "Text
       component: options.component
     });
   } catch (error) {
-    console.error(pc22.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
 program.command("init").description("Initialize fragments in a project (interactive by default)").option("--force", "Overwrite existing config").option("-y, --yes", "Non-interactive mode - auto-detect and use defaults").action(async (options) => {
   try {
-    const { init } = await import("./init-KFYN37ZY.js");
+    const { init } = await import("./init-2GEGVIUQ.js");
     const result = await init({
       projectRoot: process.cwd(),
       force: options.force,
       yes: options.yes
     });
     if (!result.success) {
-      console.error(pc22.red("\nInit failed with errors:"));
+      console.error(pc23.red("\nInit failed with errors:"));
       for (const error of result.errors) {
-        console.error(pc22.red(`  - ${error}`));
+        console.error(pc23.red(`  - ${error}`));
       }
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc22.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
 program.command("tokens").description("Discover and list design tokens from CSS/SCSS 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-NIXSZRX7.js");
+    const { tokens } = await import("./tokens-2EXPCVP3.js");
     const result = await tokens({
       config: options.config,
       json: options.json,
@@ -5814,13 +6239,13 @@ program.command("tokens").description("Discover and list design tokens from CSS/
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc22.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc23.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-35OIMW4Y.js");
+    const { generate } = await import("./generate-LQA2R7FN.js");
     const result = await generate({
       projectRoot: process.cwd(),
       component,
@@ -5828,11 +6253,11 @@ program.command("generate").description("Generate fragment files from component
       componentPattern: options.pattern
     });
     if (!result.success) {
-      console.error(pc22.red("\nGenerate completed with errors"));
+      console.error(pc23.red("\nGenerate completed with errors"));
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc22.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5840,7 +6265,7 @@ program.command("graph").description("Query the component relationship graph").a
   try {
     await graph(component, options);
   } catch (error) {
-    console.error(pc22.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -5858,14 +6283,14 @@ program.command("perf").description("Profile component bundle sizes and performa
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc22.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc23.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-RPWZAYSJ.js");
+    const { runTestCommand, listTests } = await import("./test-TD6TJNVY.js");
     if (options.list) {
       await listTests(config, configDir, {
         component: options.component,
@@ -5898,7 +6323,22 @@ program.command("test").description("Run interaction tests for fragments with pl
     });
     process.exit(exitCode);
   } catch (error) {
-    console.error(pc22.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc23.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 result = await doctor({
+      root: options.root,
+      json: options.json,
+      fix: options.fix
+    });
+    if (!result.success) {
+      process.exit(1);
+    }
+  } catch (error) {
+    console.error(pc23.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });