@fragments-sdk/cli 0.15.1 → 0.15.2

package/dist/doctor-BDPMYYE6.js

@@ -0,0 +1,385 @@
+import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
+import "./chunk-D2CDBRNU.js";
+import {
+  BRAND
+} from "./chunk-32LIWN2P.js";
+
+// src/commands/doctor.ts
+import { readFile, access } from "fs/promises";
+import { join, resolve } from "path";
+import pc from "picocolors";
+import { NEUTRAL_PALETTES } from "@fragments-sdk/viewer/docs-data";
+var VALID_NEUTRALS = NEUTRAL_PALETTES.map((p) => p.name);
+var VALID_DENSITIES = ["compact", "default", "relaxed"];
+var VALID_RADII = ["sharp", "subtle", "default", "rounded", "pill"];
+async function checkPackageInstalled(root) {
+  try {
+    const pkgPath = join(root, "package.json");
+    const content = await readFile(pkgPath, "utf-8");
+    const pkg = JSON.parse(content);
+    const allDeps = { ...pkg.dependencies, ...pkg.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 readFile(join(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 readFile(join(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 readFile(join(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 readFile(join(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 = join(root, "package.json");
+    const content = await readFile(pkgPath, "utf-8");
+    const pkg = JSON.parse(content);
+    const allDeps = { ...pkg.dependencies, ...pkg.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 = join(root, configPath);
+      const content = await readFile(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 = join(root, "tsconfig.json");
+    await access(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 = resolve(options.root ?? process.cwd());
+  const checks = [];
+  if (!options.json) {
+    console.log(pc.cyan(`
+${BRAND.name} Doctor
+`));
+    console.log(pc.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" ? pc.green("\u2713") : check.status === "warn" ? pc.yellow("!") : pc.red("\u2717");
+      const msg = check.status === "pass" ? check.message : check.status === "warn" ? pc.yellow(check.message) : pc.red(check.message);
+      console.log(`  ${icon} ${pc.bold(check.name)}: ${msg}`);
+      if (check.fix && check.status !== "pass") {
+        console.log(pc.dim(`    \u2192 ${check.fix}`));
+      }
+    }
+    console.log();
+    if (failed === 0 && warned === 0) {
+      console.log(pc.green(`\u2713 All ${passed} checks passed \u2014 your setup looks great!`));
+    } else if (failed === 0) {
+      console.log(pc.green(`\u2713 ${passed} passed`) + pc.yellow(`, ${warned} warning(s)`));
+    } else {
+      console.log(
+        pc.red(`\u2717 ${failed} failed`) + (warned > 0 ? pc.yellow(`, ${warned} warning(s)`) : "") + pc.dim(`, ${passed} passed`)
+      );
+    }
+    console.log();
+  }
+  return result;
+}
+export {
+  doctor
+};
+//# sourceMappingURL=doctor-BDPMYYE6.js.map

package/dist/doctor-BDPMYYE6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/doctor.ts"],"sourcesContent":["/**\n * fragments doctor - Diagnose design system configuration\n *\n * Checks a consumer project for common setup issues:\n * - Missing styles import\n * - ThemeProvider not found\n * - Invalid SCSS seed values\n * - Missing peer dependencies\n * - MCP configuration\n */\n\nimport { readFile, access } from 'node:fs/promises';\nimport { join, resolve } from 'node:path';\nimport pc from 'picocolors';\nimport { BRAND } from '../core/index.js';\nimport { NEUTRAL_PALETTES } from '@fragments-sdk/viewer/docs-data';\n\n// ============================================\n// Types\n// ============================================\n\nexport interface DoctorOptions {\n  /** Project root directory (defaults to cwd) */\n  root?: string;\n  /** Output JSON instead of formatted text */\n  json?: boolean;\n  /** Auto-fix issues where possible */\n  fix?: boolean;\n}\n\nexport interface DoctorCheck {\n  name: string;\n  status: 'pass' | 'warn' | 'fail';\n  message: string;\n  fix?: string;\n}\n\nexport interface DoctorResult {\n  success: boolean;\n  checks: DoctorCheck[];\n  passed: number;\n  warned: number;\n  failed: number;\n}\n\n// ============================================\n// Valid seed values — derived from canonical sources\n// ============================================\n\nconst VALID_NEUTRALS = NEUTRAL_PALETTES.map((p) => p.name);\nconst VALID_DENSITIES = ['compact', 'default', 'relaxed'];\nconst VALID_RADII = ['sharp', 'subtle', 'default', 'rounded', 'pill'];\n\n// ============================================\n// Individual Checks\n// ============================================\n\nasync function checkPackageInstalled(root: string): Promise<DoctorCheck> {\n  try {\n    const pkgPath = join(root, 'package.json');\n    const content = await readFile(pkgPath, 'utf-8');\n    const pkg = JSON.parse(content);\n    const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };\n\n    if (allDeps['@fragments-sdk/ui']) {\n      return {\n        name: 'Package installed',\n        status: 'pass',\n        message: `@fragments-sdk/ui ${allDeps['@fragments-sdk/ui']} found in dependencies`,\n      };\n    }\n\n    return {\n      name: 'Package installed',\n      status: 'fail',\n      message: '@fragments-sdk/ui not found in package.json',\n      fix: 'npm install @fragments-sdk/ui',\n    };\n  } catch {\n    return {\n      name: 'Package installed',\n      status: 'fail',\n      message: 'No package.json found',\n    };\n  }\n}\n\nasync function checkStylesImport(root: string): Promise<DoctorCheck> {\n  const entryPatterns = [\n    'src/main.tsx', 'src/main.ts', 'src/index.tsx', 'src/index.ts',\n    'src/App.tsx', 'src/App.ts',\n    'app/layout.tsx', 'app/layout.ts',\n    'src/app/layout.tsx', 'src/app/layout.ts',\n    'app/root.tsx',\n    'pages/_app.tsx', 'pages/_app.ts',\n  ];\n\n  for (const pattern of entryPatterns) {\n    try {\n      const content = await readFile(join(root, pattern), 'utf-8');\n\n      // Check for correct import\n      if (content.includes(\"@fragments-sdk/ui/styles\")) {\n        return {\n          name: 'Styles import',\n          status: 'pass',\n          message: `Found styles import in ${pattern}`,\n        };\n      }\n\n      // Check for deprecated ./globals import\n      if (content.includes(\"@fragments-sdk/ui/globals\")) {\n        return {\n          name: 'Styles import',\n          status: 'warn',\n          message: `${pattern} uses deprecated '@fragments-sdk/ui/globals'. Use '@fragments-sdk/ui/styles' instead`,\n          fix: `Replace '@fragments-sdk/ui/globals' with '@fragments-sdk/ui/styles' in ${pattern}`,\n        };\n      }\n    } catch {\n      // File doesn't exist, continue\n    }\n  }\n\n  // Also check SCSS files for @use import\n  const scssPatterns = [\n    'src/styles/globals.scss', 'src/globals.scss',\n    'styles/globals.scss', 'app/globals.scss',\n    'src/app/globals.scss',\n    'app/styles/globals.scss',\n  ];\n\n  for (const pattern of scssPatterns) {\n    try {\n      const content = await readFile(join(root, pattern), 'utf-8');\n      if (content.includes(\"@fragments-sdk/ui/styles\")) {\n        return {\n          name: 'Styles import',\n          status: 'pass',\n          message: `Found SCSS @use import in ${pattern}`,\n        };\n      }\n    } catch {\n      // File doesn't exist, continue\n    }\n  }\n\n  return {\n    name: 'Styles import',\n    status: 'fail',\n    message: 'No @fragments-sdk/ui/styles import found in entry files',\n    fix: \"Add `import '@fragments-sdk/ui/styles'` to your app's entry file\",\n  };\n}\n\nasync function checkThemeProvider(root: string): Promise<DoctorCheck> {\n  const providerPatterns = [\n    'src/main.tsx', 'src/App.tsx', 'src/providers.tsx',\n    'app/layout.tsx', 'app/providers.tsx',\n    'src/app/layout.tsx', 'src/app/providers.tsx',\n    'app/root.tsx',\n    'pages/_app.tsx',\n  ];\n\n  for (const pattern of providerPatterns) {\n    try {\n      const content = await readFile(join(root, pattern), 'utf-8');\n\n      if (content.includes('ThemeProvider')) {\n        // Check for deprecated defaultTheme prop\n        if (content.includes('defaultTheme=') || content.includes('defaultTheme =')) {\n          return {\n            name: 'ThemeProvider',\n            status: 'warn',\n            message: `${pattern} uses deprecated 'defaultTheme' prop. Use 'defaultMode' instead`,\n            fix: `Replace 'defaultTheme' with 'defaultMode' in ${pattern}`,\n          };\n        }\n\n        return {\n          name: 'ThemeProvider',\n          status: 'pass',\n          message: `ThemeProvider found in ${pattern}`,\n        };\n      }\n    } catch {\n      // File doesn't exist, continue\n    }\n  }\n\n  return {\n    name: 'ThemeProvider',\n    status: 'warn',\n    message: 'ThemeProvider not found in common entry files (optional but recommended)',\n    fix: \"Wrap your app with <ThemeProvider defaultMode=\\\"system\\\">\",\n  };\n}\n\nasync function checkScssSeeds(root: string): Promise<DoctorCheck[]> {\n  const checks: DoctorCheck[] = [];\n\n  const scssPatterns = [\n    'src/styles/globals.scss', 'src/globals.scss',\n    'styles/globals.scss', 'app/globals.scss',\n    'src/app/globals.scss',\n    'app/styles/globals.scss',\n  ];\n\n  for (const pattern of scssPatterns) {\n    try {\n      const content = await readFile(join(root, pattern), 'utf-8');\n      if (!content.includes(\"@fragments-sdk/ui/styles\")) continue;\n\n      // Check for standalone variable syntax (wrong)\n      const standalonePattern = /^\\$fui-\\w+:\\s*.+;$/m;\n      if (standalonePattern.test(content) && !content.includes('@use')) {\n        checks.push({\n          name: 'SCSS syntax',\n          status: 'fail',\n          message: `${pattern} uses standalone $fui- variables. Must use @use...with() syntax`,\n          fix: \"@use '@fragments-sdk/ui/styles' with ($fui-brand: #0066ff);\",\n        });\n      }\n\n      // Validate neutral value\n      const neutralMatch = content.match(/\\$fui-neutral:\\s*\"([^\"]+)\"/);\n      if (neutralMatch && !VALID_NEUTRALS.includes(neutralMatch[1])) {\n        checks.push({\n          name: 'SCSS seed: neutral',\n          status: 'fail',\n          message: `Invalid $fui-neutral: \"${neutralMatch[1]}\" in ${pattern}`,\n          fix: `Valid neutrals: ${VALID_NEUTRALS.join(', ')}`,\n        });\n      }\n\n      // Validate density value\n      const densityMatch = content.match(/\\$fui-density:\\s*\"([^\"]+)\"/);\n      if (densityMatch && !VALID_DENSITIES.includes(densityMatch[1])) {\n        checks.push({\n          name: 'SCSS seed: density',\n          status: 'fail',\n          message: `Invalid $fui-density: \"${densityMatch[1]}\" in ${pattern}`,\n          fix: `Valid densities: ${VALID_DENSITIES.join(', ')}`,\n        });\n      }\n\n      // Validate radius-style value\n      const radiusMatch = content.match(/\\$fui-radius-style:\\s*\"([^\"]+)\"/);\n      if (radiusMatch && !VALID_RADII.includes(radiusMatch[1])) {\n        checks.push({\n          name: 'SCSS seed: radius-style',\n          status: 'fail',\n          message: `Invalid $fui-radius-style: \"${radiusMatch[1]}\" in ${pattern}`,\n          fix: `Valid radius styles: ${VALID_RADII.join(', ')}`,\n        });\n      }\n\n      // Validate brand is a valid hex color\n      const brandMatch = content.match(/\\$fui-brand:\\s*(#[0-9a-fA-F]+)/);\n      if (brandMatch) {\n        const hex = brandMatch[1];\n        if (!/^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/.test(hex)) {\n          checks.push({\n            name: 'SCSS seed: brand',\n            status: 'fail',\n            message: `Invalid $fui-brand color: \"${hex}\" in ${pattern}`,\n            fix: 'Must be a valid hex color (e.g., #0066ff)',\n          });\n        }\n      }\n\n      // If we found the file and parsed it, and no seed issues, add a pass\n      if (checks.length === 0) {\n        checks.push({\n          name: 'SCSS seeds',\n          status: 'pass',\n          message: `Seed values in ${pattern} are valid`,\n        });\n      }\n\n      return checks;\n    } catch {\n      // File doesn't exist, continue\n    }\n  }\n\n  // No SCSS file found — not an error, just informational\n  checks.push({\n    name: 'SCSS seeds',\n    status: 'pass',\n    message: 'No custom SCSS seeds configured (using defaults)',\n  });\n\n  return checks;\n}\n\nasync function checkPeerDeps(root: string): Promise<DoctorCheck[]> {\n  const checks: DoctorCheck[] = [];\n\n  try {\n    const pkgPath = join(root, 'package.json');\n    const content = await readFile(pkgPath, 'utf-8');\n    const pkg = JSON.parse(content);\n    const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };\n\n    // React is required\n    if (!allDeps['react']) {\n      checks.push({\n        name: 'Peer dep: react',\n        status: 'fail',\n        message: 'react not found in dependencies (required)',\n        fix: 'npm install react react-dom',\n      });\n    } else {\n      checks.push({\n        name: 'Peer dep: react',\n        status: 'pass',\n        message: `react ${allDeps['react']} installed`,\n      });\n    }\n\n    // sass is needed for custom theming\n    if (!allDeps['sass']) {\n      checks.push({\n        name: 'Peer dep: sass',\n        status: 'warn',\n        message: 'sass not installed (needed for custom SCSS theming)',\n        fix: 'npm install -D sass',\n      });\n    }\n\n    // Check optional peer deps that components might need\n    const optionalPeers: Array<{ pkg: string; components: string }> = [\n      { pkg: 'recharts', components: 'Chart' },\n      { pkg: 'shiki', components: 'CodeBlock' },\n      { pkg: 'react-day-picker', components: 'DatePicker' },\n      { pkg: '@tanstack/react-table', components: 'DataTable' },\n    ];\n\n    for (const peer of optionalPeers) {\n      if (allDeps[peer.pkg]) {\n        checks.push({\n          name: `Optional dep: ${peer.pkg}`,\n          status: 'pass',\n          message: `${peer.pkg} installed (enables ${peer.components})`,\n        });\n      }\n    }\n  } catch {\n    checks.push({\n      name: 'Peer dependencies',\n      status: 'fail',\n      message: 'Could not read package.json',\n    });\n  }\n\n  return checks;\n}\n\nasync function checkMcpConfig(root: string): Promise<DoctorCheck> {\n  const mcpConfigPaths = [\n    '.mcp.json',\n    '.cursor/mcp.json',\n    '.vscode/mcp.json',\n  ];\n\n  for (const configPath of mcpConfigPaths) {\n    try {\n      const fullPath = join(root, configPath);\n      const content = await readFile(fullPath, 'utf-8');\n      const config = JSON.parse(content);\n\n      // Check if fragments MCP server is configured\n      const servers = config.mcpServers || config.servers || {};\n      const hasFragments = Object.values(servers).some((server: unknown) => {\n        const s = server as { command?: string; args?: string[] };\n        return (\n          s.args?.some((arg: string) => arg.includes('@fragments-sdk/mcp')) ||\n          s.command?.includes('fragments')\n        );\n      });\n\n      if (hasFragments) {\n        return {\n          name: 'MCP configuration',\n          status: 'pass',\n          message: `Fragments MCP server configured in ${configPath}`,\n        };\n      }\n    } catch {\n      // File doesn't exist or is invalid, continue\n    }\n  }\n\n  return {\n    name: 'MCP configuration',\n    status: 'warn',\n    message: 'No Fragments MCP server configuration found (optional)',\n    fix: 'Run `fragments init` or add @fragments-sdk/mcp to your MCP config',\n  };\n}\n\nasync function checkTypeScript(root: string): Promise<DoctorCheck> {\n  try {\n    const tsconfigPath = join(root, 'tsconfig.json');\n    await access(tsconfigPath);\n    return {\n      name: 'TypeScript',\n      status: 'pass',\n      message: 'tsconfig.json found',\n    };\n  } catch {\n    return {\n      name: 'TypeScript',\n      status: 'warn',\n      message: 'No tsconfig.json found (TypeScript recommended but not required)',\n    };\n  }\n}\n\n// ============================================\n// Main Doctor Function\n// ============================================\n\n/**\n * Run diagnostic checks on a consumer project\n */\nexport async function doctor(\n  options: DoctorOptions = {}\n): Promise<DoctorResult> {\n  const root = resolve(options.root ?? process.cwd());\n  const checks: DoctorCheck[] = [];\n\n  if (!options.json) {\n    console.log(pc.cyan(`\\n${BRAND.name} Doctor\\n`));\n    console.log(pc.dim(`Checking project at ${root}\\n`));\n  }\n\n  // Run all checks\n  checks.push(await checkPackageInstalled(root));\n  checks.push(await checkStylesImport(root));\n  checks.push(await checkThemeProvider(root));\n  checks.push(...await checkScssSeeds(root));\n  checks.push(...await checkPeerDeps(root));\n  checks.push(await checkMcpConfig(root));\n  checks.push(await checkTypeScript(root));\n\n  const passed = checks.filter(c => c.status === 'pass').length;\n  const warned = checks.filter(c => c.status === 'warn').length;\n  const failed = checks.filter(c => c.status === 'fail').length;\n\n  const result: DoctorResult = {\n    success: failed === 0,\n    checks,\n    passed,\n    warned,\n    failed,\n  };\n\n  if (options.json) {\n    console.log(JSON.stringify(result, null, 2));\n  } else {\n    // Print results\n    for (const check of checks) {\n      const icon =\n        check.status === 'pass' ? pc.green('✓') :\n        check.status === 'warn' ? pc.yellow('!') :\n        pc.red('✗');\n\n      const msg =\n        check.status === 'pass' ? check.message :\n        check.status === 'warn' ? pc.yellow(check.message) :\n        pc.red(check.message);\n\n      console.log(`  ${icon} ${pc.bold(check.name)}: ${msg}`);\n\n      if (check.fix && check.status !== 'pass') {\n        console.log(pc.dim(`    → ${check.fix}`));\n      }\n    }\n\n    // Summary\n    console.log();\n    if (failed === 0 && warned === 0) {\n      console.log(pc.green(`✓ All ${passed} checks passed — your setup looks great!`));\n    } else if (failed === 0) {\n      console.log(pc.green(`✓ ${passed} passed`) + pc.yellow(`, ${warned} warning(s)`));\n    } else {\n      console.log(\n        pc.red(`✗ ${failed} failed`) +\n        (warned > 0 ? pc.yellow(`, ${warned} warning(s)`) : '') +\n        pc.dim(`, ${passed} passed`)\n      );\n    }\n    console.log();\n  }\n\n  return result;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fragments-sdk/cli",
-  "version": "0.15.1",
+  "version": "0.15.2",
   "license": "FSL-1.1-MIT",
   "description": "CLI, MCP server, and dev tools for Fragments design system",
   "author": "Conan McNicholl",
@@ -50,16 +50,31 @@
     "dist",
     "src"
   ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
   "scarfSettings": {
     "defaultOptIn": true
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.71.2",
+    "@fragments-sdk/compiler": "workspace:*",
+    "@fragments-sdk/extract": "workspace:*",
     "@babel/generator": "^7.23.6",
     "@babel/parser": "^7.23.6",
     "@babel/traverse": "^7.23.6",
     "@babel/types": "^7.23.6",
     "@figma/rest-api-spec": "^0.35.0",
+    "@fragments-sdk/context": "workspace:*",
+    "@fragments-sdk/core": "workspace:*",
+    "@fragments-sdk/govern": "workspace:^",
+    "@fragments-sdk/viewer": "workspace:*",
+    "@fragments-sdk/webmcp": "workspace:*",
     "@inquirer/prompts": "^7.2.1",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "@phosphor-icons/react": "^2.1.10",
@@ -80,14 +95,7 @@
     "shiki": "^3.21.0",
     "vite": "^6.0.0",
     "vite-plugin-svgr": "^4.5.0",
-    "zod": "^3.24.1",
-    "@fragments-sdk/compiler": "0.2.0",
-    "@fragments-sdk/context": "0.6.0",
-    "@fragments-sdk/core": "2.0.0",
-    "@fragments-sdk/viewer": "0.2.8",
-    "@fragments-sdk/webmcp": "3.0.0",
-    "@fragments-sdk/extract": "0.1.0",
-    "@fragments-sdk/govern": "^0.3.0"
+    "zod": "^3.24.1"
   },
   "devDependencies": {
     "@types/babel__generator": "^7.6.8",
@@ -120,13 +128,5 @@
     "react-dom": {
       "optional": true
     }
-  },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "lint": "eslint src",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist"
   }
-}
+}

package/src/bin.ts

@@ -40,7 +40,9 @@ import { graph } from './commands/graph.js';
 import { inspect } from './commands/inspect.js';
 import { discover } from './commands/discover.js';
 import { perf } from './commands/perf.js';
-import { doctor } from './commands/doctor.js';
+// doctor is imported lazily — it pulls @fragments-sdk/viewer/docs-data which
+// ships as raw TS source and cannot be resolved by Node at startup.
+type DoctorFn = typeof import('./commands/doctor.js')['doctor'];
 import { setup } from './commands/setup.js';
 import { sync } from './commands/sync.js';
 import { governCheck, governInit, governReport, governConnect } from './commands/govern.js';
@@ -1296,6 +1298,7 @@ program
   .option('--fix', 'Auto-fix issues where possible')
   .action(async (options) => {
     try {
+      const { doctor } = await import('./commands/doctor.js');
       const result = await doctor({
         root: options.root,
         json: options.json,

package/src/commands/__fixtures__/shadcn-label-wrapper/src/components/ui/label.contract.json

@@ -37,6 +37,6 @@
     "source": "extracted",
     "verified": false,
     "frameworkSupport": "native",
-    "extractedAt": "2026-03-22T23:45:29.606Z"
+    "extractedAt": "2026-03-25T18:56:02.138Z"
   }
 }

package/src/commands/__fixtures__/shadcn-label-wrapper/src/components/ui/primitive.contract.json

@@ -15,6 +15,6 @@
     "source": "extracted",
     "verified": false,
     "frameworkSupport": "native",
-    "extractedAt": "2026-03-22T23:45:29.607Z"
+    "extractedAt": "2026-03-25T18:56:02.138Z"
   }
 }

package/src/commands/__tests__/init.test.ts

@@ -13,10 +13,18 @@ describe("init", () => {
   });
 
   afterAll(async () => {
-    await rm(tmpDir, { recursive: true, force: true });
+    // Retry cleanup — CI runners can race with async handles
+    for (let i = 0; i < 3; i++) {
+      try {
+        await rm(tmpDir, { recursive: true, force: true });
+        break;
+      } catch {
+        await new Promise((r) => setTimeout(r, 200));
+      }
+    }
   });
 
-  it("skips Fragments UI runtime injection for shadcn-style projects", { timeout: 10_000 }, async () => {
+  it("skips Fragments UI runtime injection for shadcn-style projects", async () => {
     const projectDir = join(tmpDir, "shadcn-app");
     await mkdir(join(projectDir, "src", "components", "ui"), { recursive: true });