@buoy-design/cli 0.4.1 → 0.5.0

package/dist/services/drift-analysis.js

@@ -10,7 +10,7 @@
  */
 import { ScanOrchestrator } from "../scan/orchestrator.js";
 import { getSeverityWeight } from "@buoy-design/core";
-import { TailwindScanner, extractStaticClassStrings } from "@buoy-design/scanners";
+import { TailwindScanner, extractStaticClassStrings, } from "@buoy-design/scanners";
 import { detectRepeatedPatterns, checkVariantConsistency, checkExampleCompliance, detectTokenUtilities, checkTokenUtilityUsage, } from "@buoy-design/core";
 import { glob } from "glob";
 import { minimatch } from "minimatch";
@@ -94,7 +94,10 @@ export function applyPromoteRules(drifts, rules, onWarning) {
 export function applyEnforceRules(drifts, rules, onWarning) {
     if (rules.length === 0)
         return drifts;
-    const promoteRules = rules.map((rule) => ({ ...rule, to: "critical" }));
+    const promoteRules = rules.map((rule) => ({
+        ...rule,
+        to: "critical",
+    }));
     return applyPromoteRules(drifts, promoteRules, onWarning);
 }
 function ruleMatches(d, rule, onWarning) {
@@ -313,11 +316,11 @@ const ENTRY_POINT_PATTERNS = [
 function isEntryPointComponent(component) {
     const source = component.source;
     // Only file-based sources (react, vue, svelte) have a path field
-    if (source.type === 'figma' || source.type === 'storybook')
+    if (source.type === "figma" || source.type === "storybook")
         return false;
     // Prefix with "/" so regexes match both "app/foo/page.tsx" and "/app/foo/page.tsx"
-    const location = `/${source.path || ''}`;
-    return ENTRY_POINT_PATTERNS.some(pattern => pattern.test(location));
+    const location = `/${source.path || ""}`;
+    return ENTRY_POINT_PATTERNS.some((pattern) => pattern.test(location));
 }
 /**
  * Known CSS variable prefixes that are framework-internal implementation details.
@@ -327,37 +330,25 @@ function isEntryPointComponent(component) {
 const FRAMEWORK_INTERNAL_PREFIXES = {
     // Tailwind CSS — utility internals and plugin variables
     tailwind: [
-        '--tw-', // all Tailwind internals (ring, shadow, gradient, transform, filter, prose, etc.)
+        "--tw-", // all Tailwind internals (ring, shadow, gradient, transform, filter, prose, etc.)
     ],
     // Radix UI — component internal sizing/animation variables
-    radix: [
-        '--radix-',
-    ],
+    radix: ["--radix-"],
     // Chakra UI — generated theme CSS variables
-    chakra: [
-        '--chakra-',
-    ],
+    chakra: ["--chakra-"],
     // Mantine — theme system variables
-    mantine: [
-        '--mantine-',
-    ],
+    mantine: ["--mantine-"],
     // Material UI — theme CSS variables
-    mui: [
-        '--mui-',
-        '--md-',
-        '--joy-',
-    ],
+    mui: ["--mui-", "--md-", "--joy-"],
     // Ant Design — component theme variables
-    antd: [
-        '--ant-',
-    ],
+    antd: ["--ant-"],
 };
 /**
  * Check if a token name matches a known framework-internal CSS variable prefix.
  * These tokens are consumed by the framework itself, not by user components.
  */
 function isFrameworkInternalToken(tokenName, detectedFrameworks) {
-    const name = tokenName.startsWith('--') ? tokenName : `--${tokenName}`;
+    const name = tokenName.startsWith("--") ? tokenName : `--${tokenName}`;
     for (const [framework, prefixes] of Object.entries(FRAMEWORK_INTERNAL_PREFIXES)) {
         // Match detected framework names loosely (e.g., "tailwindcss" matches "tailwind")
         const isDetected = [...detectedFrameworks].some((f) => f.includes(framework) || framework.includes(f));
@@ -395,7 +386,9 @@ export class DriftAnalysisService {
         });
         // Step 2: Scan tokens (before analysis, so suggestions can be generated)
         onProgress?.("Scanning tokens...");
-        const { tokens: scannedTokens } = await orchestrator.scanTokens({ onProgress });
+        const { tokens: scannedTokens } = await orchestrator.scanTokens({
+            onProgress,
+        });
         // Step 2.1: Run semantic diff analysis
         onProgress?.("Analyzing drift...");
         const { SemanticDiffEngine } = await import("@buoy-design/core/analysis");
@@ -414,7 +407,10 @@ export class DriftAnalysisService {
         const detector = new ProjectDetector(this.projectRoot);
         const projectInfo = await detector.detect();
         if (projectInfo.frameworks.length > 0) {
-            const sprawlDrift = engine.checkFrameworkSprawl(projectInfo.frameworks.map((f) => ({ name: f.name, version: f.version })));
+            const sprawlDrift = engine.checkFrameworkSprawl(projectInfo.frameworks.map((f) => ({
+                name: f.name,
+                version: f.version,
+            })));
             if (sprawlDrift) {
                 drifts.push(...applySeverityOverrides([sprawlDrift], this.config.drift.severity));
                 onProgress?.(`Framework sprawl detected: ${projectInfo.frameworks.map((f) => f.name).join(", ")}`);
@@ -482,7 +478,7 @@ export class DriftAnalysisService {
         await this.scanComponentAsValueUsages(componentUsageMap, componentNames);
         // Fix 1: Exempt entry point components (pages, routes, layouts)
         // These are rendered by the framework router, not imported by other components
-        const nonEntryPointComponents = components.filter(c => !isEntryPointComponent(c));
+        const nonEntryPointComponents = components.filter((c) => !isEntryPointComponent(c));
         // Check for unused components (excluding entry points)
         const unusedComponentDrifts = engine.checkUnusedComponents(nonEntryPointComponents, componentUsageMap);
         if (unusedComponentDrifts.length > 0) {
@@ -496,7 +492,7 @@ export class DriftAnalysisService {
         const detectedNames = new Set(projectInfo.frameworks.map((f) => f.name.toLowerCase()));
         // Tailwind and CSS libraries are source configs, not component frameworks — detect from config/deps/tokens
         if (this.config.sources.tailwind?.enabled)
-            detectedNames.add('tailwind');
+            detectedNames.add("tailwind");
         for (const tokenFile of projectInfo.tokens) {
             detectedNames.add(tokenFile.type.toLowerCase());
         }
@@ -515,7 +511,8 @@ export class DriftAnalysisService {
         const canonicalPatterns = this.config.sources.tokens?.canonical ?? [];
         const classifiedComponents = classifyComponents(components);
         const classifiedTokens = classifyTokens(scannedTokens, canonicalPatterns);
-        if (classifiedComponents.canonical.length > 0 && classifiedComponents.code.length > 0) {
+        if (classifiedComponents.canonical.length > 0 &&
+            classifiedComponents.code.length > 0) {
             onProgress?.(`Comparing ${classifiedComponents.code.length} code components against ${classifiedComponents.canonical.length} design components...`);
             const componentDiff = engine.compareComponents(classifiedComponents.code, classifiedComponents.canonical);
             if (componentDiff.drifts.length > 0) {
@@ -523,7 +520,8 @@ export class DriftAnalysisService {
                 onProgress?.(`Found ${componentDiff.drifts.length} cross-source component issues`);
             }
         }
-        if (classifiedTokens.canonical.length > 0 && classifiedTokens.code.length > 0) {
+        if (classifiedTokens.canonical.length > 0 &&
+            classifiedTokens.code.length > 0) {
             onProgress?.(`Comparing ${classifiedTokens.code.length} code tokens against ${classifiedTokens.canonical.length} design tokens...`);
             const tokenDiff = engine.compareTokens(classifiedTokens.code, classifiedTokens.canonical);
             if (tokenDiff.drifts.length > 0) {
@@ -560,7 +558,8 @@ export class DriftAnalysisService {
             }
         }
         // Step 2.7: Phase 4.1 - Cross-Variant Consistency Checking
-        const variantCheckEnabled = checkVariants ?? this.config.drift?.types?.["value-divergence"]?.checkVariants;
+        const variantCheckEnabled = checkVariants ??
+            this.config.drift?.types?.["value-divergence"]?.checkVariants;
         if (variantCheckEnabled) {
             onProgress?.("Checking variant consistency...");
             const variantDrifts = checkVariantConsistency(components);
@@ -570,7 +569,8 @@ export class DriftAnalysisService {
             }
         }
         // Step 2.8: Phase 4.2 - Token Utility Function Detection
-        const tokenUtilityCheckEnabled = checkTokenUtilities ?? this.config.drift?.types?.["hardcoded-value"]?.checkUtilities;
+        const tokenUtilityCheckEnabled = checkTokenUtilities ??
+            this.config.drift?.types?.["hardcoded-value"]?.checkUtilities;
         if (tokenUtilityCheckEnabled) {
             onProgress?.("Detecting token utility functions...");
             const utilityAnalysis = detectTokenUtilities(components);
@@ -584,7 +584,8 @@ export class DriftAnalysisService {
             }
         }
         // Step 2.9: Phase 4.3 - Example Code vs Production Code Analysis
-        const exampleCheckEnabled = checkExamples ?? this.config.drift?.types?.["missing-documentation"]?.checkExamples;
+        const exampleCheckEnabled = checkExamples ??
+            this.config.drift?.types?.["missing-documentation"]?.checkExamples;
         if (exampleCheckEnabled) {
             onProgress?.("Analyzing example code compliance...");
             const exampleDrifts = checkExampleCompliance(components);
@@ -621,7 +622,7 @@ export class DriftAnalysisService {
         let ignoredCount = 0;
         if (!includeIgnored) {
             const { loadIgnoreList, filterIgnored } = await import("../commands/ignore.js");
-            const ignoreList = await loadIgnoreList();
+            const ignoreList = await loadIgnoreList(this.projectRoot);
             const filtered = filterIgnored(drifts, ignoreList);
             drifts = filtered.newDrifts;
             ignoredCount = filtered.ignoredCount;
@@ -633,6 +634,7 @@ export class DriftAnalysisService {
             drifts,
             components,
             tokenCount: scannedTokens.length,
+            tokens: scannedTokens,
             ignoredCount,
             summary: calculateDriftSummary(drifts),
         };
@@ -649,7 +651,15 @@ export class DriftAnalysisService {
             }
         };
         const { react, nextjs, vue, svelte, angular, webcomponent, templates, tailwind, tokens, } = this.config.sources;
-        for (const source of [react, nextjs, vue, svelte, angular, webcomponent, templates]) {
+        for (const source of [
+            react,
+            nextjs,
+            vue,
+            svelte,
+            angular,
+            webcomponent,
+            templates,
+        ]) {
             if (!source?.enabled)
                 continue;
             addMany(include, source.include);
@@ -674,8 +684,15 @@ export class DriftAnalysisService {
         if (aliasMap.size === 0)
             return;
         const usageGlobs = this.getUsageCollectorGlobs();
-        const include = usageGlobs.include ?? ["**/*.{ts,tsx,js,jsx,vue,svelte,astro,html,mdx,md}"];
-        const exclude = usageGlobs.exclude ?? ["**/node_modules/**", "**/dist/**", "**/build/**", "**/.next/**"];
+        const include = usageGlobs.include ?? [
+            "**/*.{ts,tsx,js,jsx,vue,svelte,astro,html,mdx,md}",
+        ];
+        const exclude = usageGlobs.exclude ?? [
+            "**/node_modules/**",
+            "**/dist/**",
+            "**/build/**",
+            "**/.next/**",
+        ];
         const files = await glob(include, {
             cwd: this.projectRoot,
             ignore: exclude,
@@ -826,24 +843,32 @@ export class DriftAnalysisService {
      */
     async scanBarrelReExports(componentUsageMap) {
         const cwd = this.projectRoot;
-        const barrelFiles = await glob('**/index.{ts,tsx,js,jsx}', {
+        const barrelFiles = await glob("**/index.{ts,tsx,js,jsx}", {
             cwd,
-            ignore: ['**/node_modules/**', '**/dist/**', '**/build/**', '**/.next/**'],
+            ignore: [
+                "**/node_modules/**",
+                "**/dist/**",
+                "**/build/**",
+                "**/.next/**",
+            ],
             nodir: true,
             maxDepth: 6,
         });
         for (const barrelFile of barrelFiles.slice(0, 200)) {
             try {
-                const content = await readFile(resolve(cwd, barrelFile), 'utf-8');
+                const content = await readFile(resolve(cwd, barrelFile), "utf-8");
                 // Check for named re-exports: export { Button, Card } from './components'
                 const namedPattern = /export\s*\{\s*([^}]+)\s*\}\s*from/g;
                 let match;
                 while ((match = namedPattern.exec(content)) !== null) {
-                    const names = match[1].split(',').map(n => {
+                    const names = match[1]
+                        .split(",")
+                        .map((n) => {
                         // Handle "default as Name" and "Name as Alias"
                         const parts = n.trim().split(/\s+as\s+/);
-                        return (parts[1] || parts[0] || '').trim();
-                    }).filter(n => n && /^[A-Z]/.test(n)); // Only PascalCase (component names)
+                        return (parts[1] || parts[0] || "").trim();
+                    })
+                        .filter((n) => n && /^[A-Z]/.test(n)); // Only PascalCase (component names)
                     for (const name of names) {
                         componentUsageMap.set(name, (componentUsageMap.get(name) || 0) + 1);
                     }
@@ -859,8 +884,8 @@ export class DriftAnalysisService {
                 const wildcardPattern = /export\s*\*\s*from\s*['"]\.\/([^'"]+)['"]/g;
                 while ((match = wildcardPattern.exec(content)) !== null) {
                     const moduleName = match[1];
-                    const segments = moduleName.split('/');
-                    const last = segments[segments.length - 1] || '';
+                    const segments = moduleName.split("/");
+                    const last = segments[segments.length - 1] || "";
                     if (/^[A-Z]/.test(last)) {
                         componentUsageMap.set(last, (componentUsageMap.get(last) || 0) + 1);
                     }
@@ -877,23 +902,30 @@ export class DriftAnalysisService {
      */
     async scanDynamicImports(componentUsageMap) {
         const cwd = this.projectRoot;
-        const sourceFiles = await glob('**/*.{tsx,jsx,ts,js}', {
+        const sourceFiles = await glob("**/*.{tsx,jsx,ts,js}", {
             cwd,
-            ignore: ['**/node_modules/**', '**/dist/**', '**/build/**', '**/.next/**', '**/*.test.*', '**/*.spec.*'],
+            ignore: [
+                "**/node_modules/**",
+                "**/dist/**",
+                "**/build/**",
+                "**/.next/**",
+                "**/*.test.*",
+                "**/*.spec.*",
+            ],
             nodir: true,
             maxDepth: 6,
         });
         for (const file of sourceFiles.slice(0, 200)) {
             try {
-                const content = await readFile(resolve(cwd, file), 'utf-8');
-                if (!content.includes('import('))
+                const content = await readFile(resolve(cwd, file), "utf-8");
+                if (!content.includes("import("))
                     continue; // Quick check before regex
                 const dynamicPattern = /import\(\s*['"]([^'"]+)['"]\s*\)/g;
                 let match;
                 while ((match = dynamicPattern.exec(content)) !== null) {
                     const modulePath = match[1];
-                    const segments = modulePath.split('/');
-                    const last = (segments[segments.length - 1] || '').replace(/\.(tsx?|jsx?)$/, '');
+                    const segments = modulePath.split("/");
+                    const last = (segments[segments.length - 1] || "").replace(/\.(tsx?|jsx?)$/, "");
                     if (/^[A-Z]/.test(last)) {
                         componentUsageMap.set(last, (componentUsageMap.get(last) || 0) + 1);
                     }
@@ -914,9 +946,14 @@ export class DriftAnalysisService {
         if (knownComponents.length === 0)
             return;
         const cwd = this.projectRoot;
-        const templateFiles = await glob('**/*.{vue,svelte,html}', {
+        const templateFiles = await glob("**/*.{vue,svelte,html}", {
             cwd,
-            ignore: ['**/node_modules/**', '**/dist/**', '**/build/**', '**/.next/**'],
+            ignore: [
+                "**/node_modules/**",
+                "**/dist/**",
+                "**/build/**",
+                "**/.next/**",
+            ],
             nodir: true,
             maxDepth: 8,
         });
@@ -924,15 +961,15 @@ export class DriftAnalysisService {
         // Build a kebab-case lookup for Vue/Angular (MyComponent -> my-component)
         const kebabMap = new Map();
         for (const name of knownComponents) {
-            const kebab = name.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();
+            const kebab = name.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
             kebabMap.set(kebab, name);
             // Angular selectors often use app- prefix: ButtonComponent -> app-button
-            const angularSelector = `app-${kebab.replace(/-component$/, '')}`;
+            const angularSelector = `app-${kebab.replace(/-component$/, "")}`;
             kebabMap.set(angularSelector, name);
         }
         for (const file of templateFiles.slice(0, 300)) {
             try {
-                const content = await readFile(resolve(cwd, file), 'utf-8');
+                const content = await readFile(resolve(cwd, file), "utf-8");
                 // Match PascalCase component tags: <MyComponent or <MyComponent>
                 const pascalPattern = /<([A-Z][a-zA-Z0-9]*)\s*/g;
                 let match;
@@ -963,16 +1000,21 @@ export class DriftAnalysisService {
      */
     async scanAutoRegistration(componentUsageMap) {
         const cwd = this.projectRoot;
-        const sourceFiles = await glob('**/*.{ts,js,tsx,jsx}', {
+        const sourceFiles = await glob("**/*.{ts,js,tsx,jsx}", {
             cwd,
-            ignore: ['**/node_modules/**', '**/dist/**', '**/build/**', '**/.next/**'],
+            ignore: [
+                "**/node_modules/**",
+                "**/dist/**",
+                "**/build/**",
+                "**/.next/**",
+            ],
             nodir: true,
             maxDepth: 4,
         });
         for (const file of sourceFiles.slice(0, 100)) {
             try {
-                const content = await readFile(resolve(cwd, file), 'utf-8');
-                if (!content.includes('.component('))
+                const content = await readFile(resolve(cwd, file), "utf-8");
+                if (!content.includes(".component("))
                     continue;
                 // Match: app.component('Name', ...) or Vue.component('Name', ...)
                 const pattern = /\.component\(\s*['"]([A-Z][a-zA-Z0-9]*)['"]/g;
@@ -993,16 +1035,16 @@ export class DriftAnalysisService {
      */
     async scanNgModuleDeclarations(componentUsageMap) {
         const cwd = this.projectRoot;
-        const moduleFiles = await glob('**/*.module.ts', {
+        const moduleFiles = await glob("**/*.module.ts", {
             cwd,
-            ignore: ['**/node_modules/**', '**/dist/**', '**/build/**'],
+            ignore: ["**/node_modules/**", "**/dist/**", "**/build/**"],
             nodir: true,
             maxDepth: 8,
         });
         for (const file of moduleFiles.slice(0, 50)) {
             try {
-                const content = await readFile(resolve(cwd, file), 'utf-8');
-                if (!content.includes('declarations'))
+                const content = await readFile(resolve(cwd, file), "utf-8");
+                if (!content.includes("declarations"))
                     continue;
                 // Match declarations: [Component1, Component2, ...]
                 const declMatch = content.match(/declarations\s*:\s*\[([\s\S]*?)\]/);
@@ -1015,7 +1057,7 @@ export class DriftAnalysisService {
                     }
                 }
                 // Also match imports: [...] and exports: [...] arrays
-                for (const key of ['imports', 'exports']) {
+                for (const key of ["imports", "exports"]) {
                     const match = content.match(new RegExp(`${key}\\s*:\\s*\\[([\\s\\S]*?)\\]`));
                     if (match) {
                         const names = match[1].match(/\b([A-Z][a-zA-Z]+(?:Component|Module))\b/g);
@@ -1038,23 +1080,26 @@ export class DriftAnalysisService {
      */
     async scanStoryFileUsages(componentUsageMap) {
         const cwd = this.projectRoot;
-        const storyFiles = await glob('**/*.stories.{ts,tsx,js,jsx}', {
+        const storyFiles = await glob("**/*.stories.{ts,tsx,js,jsx}", {
             cwd,
-            ignore: ['**/node_modules/**', '**/dist/**', '**/build/**'],
+            ignore: ["**/node_modules/**", "**/dist/**", "**/build/**"],
             nodir: true,
             maxDepth: 8,
         });
         for (const file of storyFiles.slice(0, 200)) {
             try {
-                const content = await readFile(resolve(cwd, file), 'utf-8');
+                const content = await readFile(resolve(cwd, file), "utf-8");
                 // Match named imports: import { Button, Card } from '...'
                 const importPattern = /import\s*\{\s*([^}]+)\s*\}\s*from/g;
                 let match;
                 while ((match = importPattern.exec(content)) !== null) {
-                    const names = match[1].split(',').map(n => {
+                    const names = match[1]
+                        .split(",")
+                        .map((n) => {
                         const parts = n.trim().split(/\s+as\s+/);
-                        return (parts[0] || '').trim();
-                    }).filter(n => n && /^[A-Z]/.test(n));
+                        return (parts[0] || "").trim();
+                    })
+                        .filter((n) => n && /^[A-Z]/.test(n));
                     for (const name of names) {
                         componentUsageMap.set(name, (componentUsageMap.get(name) || 0) + 1);
                     }
@@ -1084,15 +1129,22 @@ export class DriftAnalysisService {
      */
     async scanWebComponentRegistrations(componentUsageMap) {
         const cwd = this.projectRoot;
-        const files = await glob('**/*.{ts,js}', {
+        const files = await glob("**/*.{ts,js}", {
             cwd,
-            ignore: ['**/node_modules/**', '**/dist/**', '**/build/**', '**/*.d.ts', '**/*.spec.*', '**/*.test.*'],
+            ignore: [
+                "**/node_modules/**",
+                "**/dist/**",
+                "**/build/**",
+                "**/*.d.ts",
+                "**/*.spec.*",
+                "**/*.test.*",
+            ],
             nodir: true,
             maxDepth: 8,
         });
         for (const file of files.slice(0, 500)) {
             try {
-                const content = await readFile(resolve(cwd, file), 'utf-8');
+                const content = await readFile(resolve(cwd, file), "utf-8");
                 // Match customElements.define('tag-name', ClassName)
                 const definePattern = /customElements\.define\s*\(\s*['"][^'"]+['"]\s*,\s*([A-Z][a-zA-Z0-9]*)/g;
                 let match;
@@ -1121,7 +1173,10 @@ export class DriftAnalysisService {
     async scanNuxtAutoImports(componentUsageMap, componentNames) {
         const cwd = this.projectRoot;
         // Check for Nuxt config
-        const nuxtConfigs = await glob('nuxt.config.{ts,js,mjs}', { cwd, nodir: true });
+        const nuxtConfigs = await glob("nuxt.config.{ts,js,mjs}", {
+            cwd,
+            nodir: true,
+        });
         if (nuxtConfigs.length === 0)
             return;
         // In Nuxt, all components in components/ are auto-imported
@@ -1136,23 +1191,26 @@ export class DriftAnalysisService {
      */
     async scanTestFileUsages(componentUsageMap) {
         const cwd = this.projectRoot;
-        const testFiles = await glob('**/*.{test,spec}.{ts,tsx,js,jsx}', {
+        const testFiles = await glob("**/*.{test,spec}.{ts,tsx,js,jsx}", {
             cwd,
-            ignore: ['**/node_modules/**', '**/dist/**', '**/build/**'],
+            ignore: ["**/node_modules/**", "**/dist/**", "**/build/**"],
             nodir: true,
             maxDepth: 8,
         });
         for (const file of testFiles.slice(0, 300)) {
             try {
-                const content = await readFile(resolve(cwd, file), 'utf-8');
+                const content = await readFile(resolve(cwd, file), "utf-8");
                 // Match named imports: import { Button, Card } from '...'
                 const importPattern = /import\s*\{\s*([^}]+)\s*\}\s*from/g;
                 let match;
                 while ((match = importPattern.exec(content)) !== null) {
-                    const names = match[1].split(',').map(n => {
+                    const names = match[1]
+                        .split(",")
+                        .map((n) => {
                         const parts = n.trim().split(/\s+as\s+/);
-                        return (parts[0] || '').trim();
-                    }).filter(n => n && /^[A-Z]/.test(n));
+                        return (parts[0] || "").trim();
+                    })
+                        .filter((n) => n && /^[A-Z]/.test(n));
                     for (const name of names) {
                         componentUsageMap.set(name, (componentUsageMap.get(name) || 0) + 1);
                     }
@@ -1177,15 +1235,21 @@ export class DriftAnalysisService {
      */
     async scanHOCWrapperUsages(componentUsageMap) {
         const cwd = this.projectRoot;
-        const sourceFiles = await glob('**/*.{ts,tsx,js,jsx}', {
+        const sourceFiles = await glob("**/*.{ts,tsx,js,jsx}", {
             cwd,
-            ignore: ['**/node_modules/**', '**/dist/**', '**/build/**', '**/.next/**', '**/*.d.ts'],
+            ignore: [
+                "**/node_modules/**",
+                "**/dist/**",
+                "**/build/**",
+                "**/.next/**",
+                "**/*.d.ts",
+            ],
             nodir: true,
             maxDepth: 8,
         });
         for (const file of sourceFiles.slice(0, 500)) {
             try {
-                const content = await readFile(resolve(cwd, file), 'utf-8');
+                const content = await readFile(resolve(cwd, file), "utf-8");
                 // forwardRef(Component) / React.forwardRef(Component)
                 const forwardRefPattern = /(?:React\.)?forwardRef\s*[(<]\s*(?:function\s+)?([A-Z][a-zA-Z0-9]*)/g;
                 let match;
@@ -1251,31 +1315,37 @@ export class DriftAnalysisService {
     async scanPackageExports(componentUsageMap) {
         const cwd = this.projectRoot;
         try {
-            const pkgContent = await readFile(resolve(cwd, 'package.json'), 'utf-8');
+            const pkgContent = await readFile(resolve(cwd, "package.json"), "utf-8");
             const pkg = JSON.parse(pkgContent);
             // Detect if this is a component library by checking for:
             // - exports field with ./ entries
             // - main/module pointing to index file
             // - "react" or "vue" in peerDependencies (library pattern)
             const hasPeerReact = pkg.peerDependencies?.react || pkg.peerDependencies?.vue;
-            const hasExports = pkg.exports && typeof pkg.exports === 'object';
-            const mainEntry = pkg.main || pkg.module || '';
+            const hasExports = pkg.exports && typeof pkg.exports === "object";
+            const mainEntry = pkg.main || pkg.module || "";
             const isLibraryPattern = hasPeerReact && (hasExports || mainEntry);
             if (!isLibraryPattern)
                 return;
             // Scan the root barrel file(s) for exports — these are the public API
-            const rootBarrels = await glob('src/index.{ts,tsx,js,jsx}', { cwd, nodir: true });
+            const rootBarrels = await glob("src/index.{ts,tsx,js,jsx}", {
+                cwd,
+                nodir: true,
+            });
             for (const barrel of rootBarrels) {
                 try {
-                    const content = await readFile(resolve(cwd, barrel), 'utf-8');
+                    const content = await readFile(resolve(cwd, barrel), "utf-8");
                     // Named exports: export { Button, Card } from '...'
                     const namedPattern = /export\s*\{\s*([^}]+)\s*\}\s*from/g;
                     let match;
                     while ((match = namedPattern.exec(content)) !== null) {
-                        const names = match[1].split(',').map(n => {
+                        const names = match[1]
+                            .split(",")
+                            .map((n) => {
                             const parts = n.trim().split(/\s+as\s+/);
-                            return (parts[1] || parts[0] || '').trim();
-                        }).filter(n => n && /^[A-Z]/.test(n));
+                            return (parts[1] || parts[0] || "").trim();
+                        })
+                            .filter((n) => n && /^[A-Z]/.test(n));
                         for (const name of names) {
                             componentUsageMap.set(name, (componentUsageMap.get(name) || 0) + 1);
                         }
@@ -1289,8 +1359,8 @@ export class DriftAnalysisService {
                     const wildcardPattern = /export\s*\*\s*from\s*['"]\.\/([^'"]+)['"]/g;
                     while ((match = wildcardPattern.exec(content)) !== null) {
                         const moduleName = match[1];
-                        const segments = moduleName.split('/');
-                        const last = segments[segments.length - 1] || '';
+                        const segments = moduleName.split("/");
+                        const last = segments[segments.length - 1] || "";
                         if (/^[A-Z]/.test(last)) {
                             componentUsageMap.set(last, (componentUsageMap.get(last) || 0) + 1);
                         }
@@ -1321,9 +1391,15 @@ export class DriftAnalysisService {
         if (knownComponents.length === 0)
             return;
         const cwd = this.projectRoot;
-        const sourceFiles = await glob('**/*.{tsx,jsx,ts,js}', {
+        const sourceFiles = await glob("**/*.{tsx,jsx,ts,js}", {
             cwd,
-            ignore: ['**/node_modules/**', '**/dist/**', '**/build/**', '**/.next/**', '**/*.d.ts'],
+            ignore: [
+                "**/node_modules/**",
+                "**/dist/**",
+                "**/build/**",
+                "**/.next/**",
+                "**/*.d.ts",
+            ],
             nodir: true,
             maxDepth: 8,
         });
@@ -1331,7 +1407,7 @@ export class DriftAnalysisService {
         const knownSet = new Set(knownComponents);
         for (const file of sourceFiles.slice(0, 500)) {
             try {
-                const content = await readFile(resolve(cwd, file), 'utf-8');
+                const content = await readFile(resolve(cwd, file), "utf-8");
                 // Match component names used as values in these contexts:
                 // 1. JSX prop value:  ={ComponentName}  or ={ComponentName}
                 // 2. Object property: : ComponentName, or : ComponentName}
@@ -1361,7 +1437,12 @@ export class DriftAnalysisService {
         const cwd = this.projectRoot;
         // Find all source files
         const patterns = ["**/*.tsx", "**/*.jsx", "**/*.vue", "**/*.svelte"];
-        const ignore = ["**/node_modules/**", "**/dist/**", "**/.next/**", "**/build/**"];
+        const ignore = [
+            "**/node_modules/**",
+            "**/dist/**",
+            "**/.next/**",
+            "**/build/**",
+        ];
         const files = await glob(patterns, { cwd, ignore, absolute: true });
         for (const file of files) {
             try {