@fragments-sdk/cli 0.8.1 → 0.9.0

package/dist/bin.js

@@ -53,10 +53,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";
@@ -1811,7 +1811,7 @@ ${BRAND.name} Dev Server
       }
     }
   }
-  const { createDevServer } = await import("./viewer-HZK4BSDK.js");
+  const { createDevServer } = await import("./viewer-SBTJDMP7.js");
   console.log(pc7.dim("\nStarting dev server..."));
   const parsedPort = typeof port === "string" ? parseInt(port, 10) : port;
   try {
@@ -5363,9 +5363,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 +5750,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 +5770,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 +5789,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 +5816,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 +5824,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 +5832,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 +5846,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 +5861,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 +5876,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 +5899,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 +5918,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 +5937,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 +5957,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 +5976,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 +5993,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 +6015,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 +6038,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 +6059,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 +6072,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 +6084,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 +6098,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);
@@ -5738,22 +6113,22 @@ program.command("view").description(`Generate a static HTML viewer for ${BRAND.o
     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 +6137,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,27 +6150,27 @@ 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-KSAAS7X3.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);
   }
 });
@@ -5814,7 +6189,7 @@ 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);
   }
 });
@@ -5828,11 +6203,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 +6215,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,7 +6233,7 @@ 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);
   }
 });
@@ -5898,7 +6273,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);
   }
 });