@getcoherent/cli 0.5.1 → 0.5.3

package/dist/index.js

@@ -362,6 +362,7 @@ function createMinimalConfig() {
       }
     },
     settings: {
+      initialized: false,
       appType: "multi-page",
       framework: "next",
       typescript: true,
@@ -2427,8 +2428,8 @@ async function createAppRouteGroupLayout(projectPath) {
 // src/commands/chat.ts
 import chalk13 from "chalk";
 import ora2 from "ora";
-import { resolve as resolve9 } from "path";
-import { existsSync as existsSync16, readFileSync as readFileSync10, mkdirSync as mkdirSync6 } from "fs";
+import { resolve as resolve9, relative as relative2 } from "path";
+import { existsSync as existsSync16, readFileSync as readFileSync10, mkdirSync as mkdirSync6, readdirSync as readdirSync2 } from "fs";
 import {
   DesignSystemManager as DesignSystemManager7,
   ComponentManager as ComponentManager4,
@@ -4605,6 +4606,26 @@ FEW-SHOT EXAMPLE \u2014 correct stat card in pageCode (follow this pattern exact
 \`\`\`
 Key: CardTitle is text-sm font-medium (NOT text-lg). Metric is text-2xl font-bold. Subtext is text-xs text-muted-foreground. Icon is size-4 text-muted-foreground.
 
+SURGICAL MODIFICATION RULES (CRITICAL for incremental edits):
+- When modifying an existing page, return the COMPLETE page code
+- Change ONLY the specific section, component, or element the user requested
+- Do NOT modify imports unless the change requires new imports
+- Do NOT change state variables, event handlers, or data in unrelated sections
+- Do NOT restyle sections the user did not mention
+- Preserve all existing className values on unchanged elements
+- If the user asks to change a "section" or "block", identify it by heading, content, or position
+
+Component Promotion Rules:
+- When the user asks to "make X a shared component" or "reuse X across pages":
+  - Use request type "promote-and-link"
+  - Extract the JSX block into a separate component file
+  - Replace inline code with the component import on all specified pages
+
+Global Component Change Rules:
+- When the user asks to change "all cards" or "every button" or similar:
+  - If the pattern is already a shared component, modify the shared component file
+  - If the pattern is inline across pages, first promote it to a shared component, then modify it
+
 OPTIONAL UX RECOMMENDATIONS:
 If you see opportunities to improve UX (accessibility, layout, consistency, responsiveness, visual hierarchy), add a short markdown block in "uxRecommendations". Otherwise omit it.
 
@@ -4712,8 +4733,8 @@ async function ensureAuthRouteGroup(projectRoot) {
   const guardPath = join6(projectRoot, "app", "ShowWhenNotAuthRoute.tsx");
   const rootLayoutPath = join6(projectRoot, "app", "layout.tsx");
   if (!existsSync9(authLayoutPath)) {
-    const { mkdir: mkdir7 } = await import("fs/promises");
-    await mkdir7(join6(projectRoot, "app", "(auth)"), { recursive: true });
+    const { mkdir: mkdir8 } = await import("fs/promises");
+    await mkdir8(join6(projectRoot, "app", "(auth)"), { recursive: true });
     await writeFile2(authLayoutPath, AUTH_LAYOUT, "utf-8");
   }
   if (!existsSync9(guardPath)) {
@@ -5885,7 +5906,7 @@ async function splitGeneratePages(spinner, message, modCtx, provider, parseOpts)
 
 // src/commands/chat/modification-handler.ts
 import { resolve as resolve7 } from "path";
-import { mkdir as mkdir3 } from "fs/promises";
+import { mkdir as mkdir4 } from "fs/promises";
 import { dirname as dirname6 } from "path";
 import chalk11 from "chalk";
 import {
@@ -6673,11 +6694,68 @@ function formatIssues(issues) {
   }
   return lines.join("\n");
 }
+function checkDesignConsistency(code) {
+  const warnings = [];
+  const hexPattern = /\[#[0-9a-fA-F]{3,8}\]/g;
+  for (const match of code.matchAll(hexPattern)) {
+    warnings.push({
+      type: "hardcoded-color",
+      message: `Hardcoded color ${match[0]} \u2014 use a design token (e.g., bg-primary) instead`
+    });
+  }
+  const spacingPattern = /[pm][trblxy]?-\[\d+px\]/g;
+  for (const match of code.matchAll(spacingPattern)) {
+    warnings.push({
+      type: "arbitrary-spacing",
+      message: `Arbitrary spacing ${match[0]} \u2014 use Tailwind spacing scale instead`
+    });
+  }
+  return warnings;
+}
+function verifyIncrementalEdit(before, after) {
+  const issues = [];
+  const hookPattern = /\buse[A-Z]\w+\s*\(/;
+  if (hookPattern.test(after) && !after.includes("'use client'") && !after.includes('"use client"')) {
+    issues.push({
+      type: "missing-use-client",
+      message: 'Code uses React hooks but missing "use client" directive'
+    });
+  }
+  if (!after.includes("export default")) {
+    issues.push({
+      type: "missing-default-export",
+      message: "Missing default export \u2014 page component must have a default export"
+    });
+  }
+  const importRegex = /import\s+\{([^}]+)\}\s+from/g;
+  const beforeImports = /* @__PURE__ */ new Set();
+  const afterImports = /* @__PURE__ */ new Set();
+  for (const match of before.matchAll(importRegex)) {
+    match[1].split(",").forEach((s) => beforeImports.add(s.trim()));
+  }
+  for (const match of after.matchAll(importRegex)) {
+    match[1].split(",").forEach((s) => afterImports.add(s.trim()));
+  }
+  for (const symbol of beforeImports) {
+    if (!afterImports.has(symbol) && symbol.length > 0) {
+      const codeWithoutImports = after.replace(/^import\s+.*$/gm, "");
+      const symbolRegex = new RegExp(`\\b${symbol}\\b`);
+      if (symbolRegex.test(codeWithoutImports)) {
+        issues.push({
+          type: "missing-import",
+          symbol,
+          message: `Import for "${symbol}" was removed but symbol is still used in code`
+        });
+      }
+    }
+  }
+  return issues;
+}
 
 // src/commands/chat/code-generator.ts
 import { resolve as resolve6 } from "path";
 import { existsSync as existsSync14 } from "fs";
-import { mkdir as mkdir2 } from "fs/promises";
+import { mkdir as mkdir3 } from "fs/promises";
 import { dirname as dirname5 } from "path";
 import {
   ComponentGenerator as ComponentGenerator2,
@@ -6686,6 +6764,39 @@ import {
 } from "@getcoherent/core";
 import { integrateSharedLayoutIntoRootLayout as integrateSharedLayoutIntoRootLayout2, generateSharedComponent as generateSharedComponent2 } from "@getcoherent/core";
 import chalk9 from "chalk";
+
+// src/utils/file-hashes.ts
+import { createHash } from "crypto";
+import { readFile as readFile5, writeFile as writeFile4, mkdir as mkdir2 } from "fs/promises";
+import { join as join9 } from "path";
+var HASHES_FILE = ".coherent/file-hashes.json";
+async function computeFileHash(filePath) {
+  const content = await readFile5(filePath, "utf-8");
+  return createHash("sha256").update(content).digest("hex");
+}
+async function loadHashes(projectRoot) {
+  try {
+    const raw = await readFile5(join9(projectRoot, HASHES_FILE), "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+async function saveHashes(projectRoot, hashes) {
+  const dir = join9(projectRoot, ".coherent");
+  await mkdir2(dir, { recursive: true });
+  await writeFile4(join9(projectRoot, HASHES_FILE), JSON.stringify(hashes, null, 2) + "\n");
+}
+async function isManuallyEdited(filePath, storedHash) {
+  try {
+    const currentHash = await computeFileHash(filePath);
+    return currentHash !== storedHash;
+  } catch {
+    return false;
+  }
+}
+
+// src/commands/chat/code-generator.ts
 async function validateAndFixGeneratedCode(projectRoot, code, options = {}) {
   const fixes = [];
   let fixed = fixEscapedClosingQuotes(code);
@@ -6748,48 +6859,71 @@ async function regeneratePage(pageId, config2, projectRoot) {
   const route = page.route || "/";
   const isAuth = isAuthRoute(route) || isAuthRoute(page.name || page.id || "");
   const filePath = routeToFsPath(projectRoot, route, isAuth);
-  await mkdir2(dirname5(filePath), { recursive: true });
+  await mkdir3(dirname5(filePath), { recursive: true });
   await writeFile(filePath, code);
 }
-async function regenerateLayout(config2, projectRoot) {
-  const layout = config2.pages[0]?.layout || "centered";
+async function canOverwriteShared(projectRoot, componentFile, storedHashes) {
+  const filePath = resolve6(projectRoot, componentFile);
+  if (!existsSync14(filePath)) return true;
+  const storedHash = storedHashes[componentFile];
+  if (!storedHash) return true;
+  const edited = await isManuallyEdited(filePath, storedHash);
+  if (edited) {
+    console.log(chalk9.yellow(`  \u26A0 Skipping ${componentFile} \u2014 manually edited since last generation`));
+  }
+  return !edited;
+}
+async function regenerateLayout(config2, projectRoot, options = { navChanged: false }) {
   const appType = config2.settings.appType || "multi-page";
   const generator = new PageGenerator(config2);
-  const code = await generator.generateLayout(layout, appType, { skipNav: true });
-  const layoutPath = resolve6(projectRoot, "app", "layout.tsx");
-  await writeFile(layoutPath, code);
+  const initialized = config2.settings.initialized !== false;
+  const hashes = options.storedHashes ?? {};
+  if (!initialized) {
+    const layout = config2.pages[0]?.layout || "centered";
+    const code = await generator.generateLayout(layout, appType, { skipNav: true });
+    await writeFile(resolve6(projectRoot, "app", "layout.tsx"), code);
+  }
   if (config2.navigation?.enabled && appType === "multi-page") {
     const navType = config2.navigation.type || "header";
-    if (navType === "header" || navType === "both") {
-      const headerCode = generator.generateSharedHeaderCode();
-      await generateSharedComponent2(projectRoot, {
-        name: "Header",
-        type: "layout",
-        code: headerCode,
-        description: "Main site header with navigation and theme toggle",
-        usedIn: ["app/layout.tsx"],
-        overwrite: true
-      });
-    }
-    const footerCode = generator.generateSharedFooterCode();
-    await generateSharedComponent2(projectRoot, {
-      name: "Footer",
-      type: "layout",
-      code: footerCode,
-      description: "Site footer",
-      usedIn: ["app/layout.tsx"],
-      overwrite: true
-    });
-    if (navType === "sidebar" || navType === "both") {
-      const sidebarCode = generator.generateSharedSidebarCode();
-      await generateSharedComponent2(projectRoot, {
-        name: "Sidebar",
-        type: "layout",
-        code: sidebarCode,
-        description: "Vertical sidebar navigation with collapsible sections",
-        usedIn: ["app/(app)/layout.tsx"],
-        overwrite: true
-      });
+    const shouldRegenShared = !initialized || options.navChanged;
+    if (shouldRegenShared) {
+      if (navType === "header" || navType === "both") {
+        if (await canOverwriteShared(projectRoot, "components/shared/header.tsx", hashes)) {
+          const headerCode = generator.generateSharedHeaderCode();
+          await generateSharedComponent2(projectRoot, {
+            name: "Header",
+            type: "layout",
+            code: headerCode,
+            description: "Main site header with navigation and theme toggle",
+            usedIn: ["app/layout.tsx"],
+            overwrite: true
+          });
+        }
+      }
+      if (await canOverwriteShared(projectRoot, "components/shared/footer.tsx", hashes)) {
+        const footerCode = generator.generateSharedFooterCode();
+        await generateSharedComponent2(projectRoot, {
+          name: "Footer",
+          type: "layout",
+          code: footerCode,
+          description: "Site footer",
+          usedIn: ["app/layout.tsx"],
+          overwrite: true
+        });
+      }
+      if (navType === "sidebar" || navType === "both") {
+        if (await canOverwriteShared(projectRoot, "components/shared/sidebar.tsx", hashes)) {
+          const sidebarCode = generator.generateSharedSidebarCode();
+          await generateSharedComponent2(projectRoot, {
+            name: "Sidebar",
+            type: "layout",
+            code: sidebarCode,
+            description: "Vertical sidebar navigation with collapsible sections",
+            usedIn: ["app/(app)/layout.tsx"],
+            overwrite: true
+          });
+        }
+      }
     }
   }
   try {
@@ -6844,7 +6978,7 @@ export default function AppLayout({
 }
 `;
 }
-async function regenerateFiles(modified, config2, projectRoot) {
+async function regenerateFiles(modified, config2, projectRoot, options = { navChanged: false }) {
   const componentIds = /* @__PURE__ */ new Set();
   const pageIds = /* @__PURE__ */ new Set();
   for (const item of modified) {
@@ -6855,7 +6989,10 @@ async function regenerateFiles(modified, config2, projectRoot) {
     }
   }
   if (config2.navigation?.enabled && modified.length > 0) {
-    await regenerateLayout(config2, projectRoot);
+    await regenerateLayout(config2, projectRoot, {
+      navChanged: options.navChanged,
+      storedHashes: options.storedHashes
+    });
   }
   if (componentIds.size > 0) {
     const twGen = new TailwindConfigGenerator(config2);
@@ -7582,7 +7719,7 @@ async function applyModification(request, dsm, cm, pm, projectRoot, aiProvider,
             await ensureAuthRouteGroup(projectRoot);
           }
           const filePath = routeToFsPath(projectRoot, route, isAuth);
-          await mkdir3(dirname6(filePath), { recursive: true });
+          await mkdir4(dirname6(filePath), { recursive: true });
           const { fixedCode, fixes: postFixes } = await validateAndFixGeneratedCode(projectRoot, finalPageCode, {
             isPage: true
           });
@@ -7672,6 +7809,12 @@ Rules:
 \u{1F50D} Quality check for ${page.name || page.id}:`));
             console.log(chalk11.dim(report));
           }
+          const consistency = checkDesignConsistency(codeToWrite);
+          if (consistency.length > 0) {
+            console.log(chalk11.yellow(`
+\u{1F3A8} Design consistency for ${page.name || page.id}:`));
+            consistency.forEach((w) => console.log(chalk11.dim(`   \u26A0 [${w.type}] ${w.message}`)));
+          }
         }
       }
       return {
@@ -7737,6 +7880,12 @@ ${routeRules}
 ${pagesCtx}`
                 );
                 if (DEBUG2) console.log(chalk11.dim(`  [update-page] AI returned ${resolvedPageCode.length} chars`));
+                const editIssues = verifyIncrementalEdit(currentCode, resolvedPageCode);
+                if (editIssues.length > 0) {
+                  console.log(chalk11.yellow(`
+\u26A0 Incremental edit issues for ${pageDef.name || pageDef.id}:`));
+                  editIssues.forEach((issue) => console.log(chalk11.dim(`   [${issue.type}] ${issue.message}`)));
+                }
               } else {
                 console.log(chalk11.yellow("  \u26A0 AI provider does not support editPageCode"));
               }
@@ -7761,7 +7910,7 @@ ${pagesCtx}`
             if (installed.length > 0) {
               result.modified = [...result.modified, ...installed.map((id) => `component:${id}`)];
             }
-            await mkdir3(dirname6(absPath), { recursive: true });
+            await mkdir4(dirname6(absPath), { recursive: true });
             const { fixedCode, fixes: postFixes } = await validateAndFixGeneratedCode(projectRoot, resolvedPageCode, {
               isPage: true
             });
@@ -7823,6 +7972,12 @@ ${pagesCtx}`
 \u{1F50D} Quality check for ${pageDef.name || pageDef.id}:`));
               console.log(chalk11.dim(report));
             }
+            const consistency = checkDesignConsistency(codeToWrite);
+            if (consistency.length > 0) {
+              console.log(chalk11.yellow(`
+\u{1F3A8} Design consistency for ${pageDef.name || pageDef.id}:`));
+              consistency.forEach((w) => console.log(chalk11.dim(`   \u26A0 [${w.type}] ${w.message}`)));
+            }
           } else {
             try {
               let code = await readFile(absPath);
@@ -7879,6 +8034,15 @@ ${pagesCtx}`
   }
 }
 
+// src/utils/nav-snapshot.ts
+function takeNavSnapshot(items) {
+  if (!items || items.length === 0) return "[]";
+  return JSON.stringify(items.map((i) => `${i.label}:${i.href}`).sort());
+}
+function hasNavChanged(before, after) {
+  return before !== after;
+}
+
 // src/commands/chat/interactive.ts
 import chalk12 from "chalk";
 import { resolve as resolve8 } from "path";
@@ -8111,6 +8275,7 @@ async function chatCommand(message, options) {
       }
       spinner.text = "Loading design system configuration...";
     }
+    const storedHashes = await loadHashes(projectRoot);
     const dsm = new DesignSystemManager7(configPath);
     await dsm.load();
     const cm = new ComponentManager4(config2);
@@ -8461,6 +8626,9 @@ async function chatCommand(message, options) {
       if (DEBUG4) console.log(chalk13.dim("[backup] Created snapshot"));
     } catch {
     }
+    const navBefore = takeNavSnapshot(
+      config2.navigation?.items?.map((i) => ({ label: i.label, href: i.route || `/${i.label.toLowerCase()}` }))
+    );
     spinner.start("Applying modifications...");
     const results = [];
     for (const request of normalizedRequests) {
@@ -8608,6 +8776,10 @@ async function chatCommand(message, options) {
       } catch {
       }
     }
+    if (updatedConfig.settings.initialized === false) {
+      updatedConfig.settings.initialized = true;
+      dsm.updateConfig(updatedConfig);
+    }
     spinner.text = "Saving configuration...";
     await dsm.save();
     spinner.succeed("Configuration saved");
@@ -8617,15 +8789,42 @@ async function chatCommand(message, options) {
     scaffoldedPages.forEach(({ route }) => {
       allModified.add(`page:${route.slice(1) || "home"}`);
     });
+    const navAfter = takeNavSnapshot(
+      updatedConfig.navigation?.items?.map((i) => ({
+        label: i.label,
+        href: i.route || `/${i.label.toLowerCase()}`
+      }))
+    );
+    const navChanged = hasNavChanged(navBefore, navAfter);
     if (allModified.size > 0) {
       spinner.start("Regenerating affected files...");
-      await regenerateFiles(Array.from(allModified), updatedConfig, projectRoot);
+      await regenerateFiles(Array.from(allModified), updatedConfig, projectRoot, { navChanged, storedHashes });
       spinner.succeed("Files regenerated");
     }
     try {
       fixGlobalsCss(projectRoot, updatedConfig);
     } catch {
     }
+    try {
+      const updatedHashes = { ...storedHashes };
+      const sharedDir = resolve9(projectRoot, "components", "shared");
+      const layoutFile = resolve9(projectRoot, "app", "layout.tsx");
+      const filesToHash = [layoutFile];
+      if (existsSync16(sharedDir)) {
+        for (const f of readdirSync2(sharedDir)) {
+          if (f.endsWith(".tsx")) filesToHash.push(resolve9(sharedDir, f));
+        }
+      }
+      for (const filePath of filesToHash) {
+        if (existsSync16(filePath)) {
+          const rel = relative2(projectRoot, filePath);
+          updatedHashes[rel] = await computeFileHash(filePath);
+        }
+      }
+      await saveHashes(projectRoot, updatedHashes);
+    } catch {
+      if (DEBUG4) console.log(chalk13.dim("[hashes] Could not save file hashes"));
+    }
     const successfulPairs = normalizedRequests.map((request, index) => ({ request, result: results[index] })).filter(({ result }) => result.success);
     if (successfulPairs.length > 0) {
       const changes = successfulPairs.map(({ request }) => ({
@@ -8733,18 +8932,18 @@ import chalk14 from "chalk";
 import ora3 from "ora";
 import { spawn } from "child_process";
 import { existsSync as existsSync19, rmSync as rmSync3, readFileSync as readFileSync13, writeFileSync as writeFileSync10 } from "fs";
-import { resolve as resolve10, join as join11 } from "path";
+import { resolve as resolve10, join as join12 } from "path";
 import { readdir as readdir2 } from "fs/promises";
 import { DesignSystemManager as DesignSystemManager8, ComponentGenerator as ComponentGenerator3 } from "@getcoherent/core";
 
 // src/utils/file-watcher.ts
 import { readFileSync as readFileSync12, writeFileSync as writeFileSync9, existsSync as existsSync18 } from "fs";
-import { relative as relative3, join as join10 } from "path";
+import { relative as relative4, join as join11 } from "path";
 import { loadManifest as loadManifest8, saveManifest as saveManifest3 } from "@getcoherent/core";
 
 // src/utils/component-integrity.ts
-import { existsSync as existsSync17, readFileSync as readFileSync11, readdirSync as readdirSync2 } from "fs";
-import { join as join9, relative as relative2 } from "path";
+import { existsSync as existsSync17, readFileSync as readFileSync11, readdirSync as readdirSync3 } from "fs";
+import { join as join10, relative as relative3 } from "path";
 function extractExportedComponentNames(code) {
   const names = [];
   let m;
@@ -8770,7 +8969,7 @@ function arraysEqual(a, b) {
 }
 function findPagesImporting(projectRoot, componentName, componentFile) {
   const results = [];
-  const appDir = join9(projectRoot, "app");
+  const appDir = join10(projectRoot, "app");
   if (!existsSync17(appDir)) return results;
   const pageFiles = collectFiles(appDir, (name) => name === "page.tsx" || name === "page.jsx");
   const componentImportPath = componentFile.replace(/\.tsx$/, "").replace(/\.jsx$/, "");
@@ -8782,7 +8981,7 @@ function findPagesImporting(projectRoot, componentName, componentFile) {
       const hasDefaultImport = new RegExp(`import\\s+${componentName}\\s+from\\s+['"]`).test(code);
       const hasPathImport = code.includes(`@/${componentImportPath}`);
       if (hasNamedImport || hasDefaultImport || hasPathImport) {
-        results.push(relative2(projectRoot, absPath));
+        results.push(relative3(projectRoot, absPath));
       }
     } catch {
     }
@@ -8790,7 +8989,7 @@ function findPagesImporting(projectRoot, componentName, componentFile) {
   return results;
 }
 function isUsedInLayout(projectRoot, componentName) {
-  const layoutPath = join9(projectRoot, "app", "layout.tsx");
+  const layoutPath = join10(projectRoot, "app", "layout.tsx");
   if (!existsSync17(layoutPath)) return false;
   try {
     const code = readFileSync11(layoutPath, "utf-8");
@@ -8801,7 +9000,7 @@ function isUsedInLayout(projectRoot, componentName) {
 }
 function findUnregisteredComponents(projectRoot, manifest) {
   const results = [];
-  const componentsDir = join9(projectRoot, "components");
+  const componentsDir = join10(projectRoot, "components");
   if (!existsSync17(componentsDir)) return results;
   const registeredFiles = new Set(manifest.shared.map((s) => s.file));
   const registeredNames = new Set(manifest.shared.map((s) => s.name));
@@ -8811,7 +9010,7 @@ function findUnregisteredComponents(projectRoot, manifest) {
     ["ui", "node_modules"]
   );
   for (const absPath of files) {
-    const relFile = relative2(projectRoot, absPath);
+    const relFile = relative3(projectRoot, absPath);
     if (registeredFiles.has(relFile)) continue;
     try {
       const code = readFileSync11(absPath, "utf-8");
@@ -8829,7 +9028,7 @@ function findUnregisteredComponents(projectRoot, manifest) {
 }
 function findInlineDuplicates(projectRoot, manifest) {
   const results = [];
-  const appDir = join9(projectRoot, "app");
+  const appDir = join10(projectRoot, "app");
   if (!existsSync17(appDir)) return results;
   const pageFiles = collectFiles(appDir, (name) => name === "page.tsx" || name === "page.jsx");
   for (const absPath of pageFiles) {
@@ -8840,7 +9039,7 @@ function findInlineDuplicates(projectRoot, manifest) {
     } catch {
       continue;
     }
-    const relPath = relative2(projectRoot, absPath);
+    const relPath = relative3(projectRoot, absPath);
     for (const shared of manifest.shared) {
       const importPath = shared.file.replace(/\.tsx$/, "").replace(/\.jsx$/, "");
       const isImported = code.includes(`@/${importPath}`) || code.includes(`from './${importPath}'`) || code.includes(`from "../${importPath}"`);
@@ -8859,7 +9058,7 @@ function findInlineDuplicates(projectRoot, manifest) {
   return results;
 }
 function findComponentFileByExportName(projectRoot, componentName) {
-  const componentsDir = join9(projectRoot, "components");
+  const componentsDir = join10(projectRoot, "components");
   if (!existsSync17(componentsDir)) return null;
   const files = collectFiles(
     componentsDir,
@@ -8871,7 +9070,7 @@ function findComponentFileByExportName(projectRoot, componentName) {
       const code = readFileSync11(absPath, "utf-8");
       const exports = extractExportedComponentNames(code);
       if (exports.includes(componentName)) {
-        return relative2(projectRoot, absPath);
+        return relative3(projectRoot, absPath);
       }
     } catch {
     }
@@ -8881,7 +9080,7 @@ function findComponentFileByExportName(projectRoot, componentName) {
 function removeOrphanedEntries(projectRoot, manifest) {
   const removed = [];
   const valid = manifest.shared.filter((entry) => {
-    const filePath = join9(projectRoot, entry.file);
+    const filePath = join10(projectRoot, entry.file);
     if (existsSync17(filePath)) return true;
     removed.push({ id: entry.id, name: entry.name });
     return false;
@@ -8900,7 +9099,7 @@ function reconcileComponents(projectRoot, manifest) {
   };
   const m = { ...manifest, shared: [...manifest.shared], nextId: manifest.nextId };
   m.shared = m.shared.filter((entry) => {
-    const filePath = join9(projectRoot, entry.file);
+    const filePath = join10(projectRoot, entry.file);
     if (!existsSync17(filePath)) {
       const newPath = findComponentFileByExportName(projectRoot, entry.name);
       if (newPath) {
@@ -8913,7 +9112,7 @@ function reconcileComponents(projectRoot, manifest) {
     }
     let code;
     try {
-      code = readFileSync11(join9(projectRoot, entry.file), "utf-8");
+      code = readFileSync11(join10(projectRoot, entry.file), "utf-8");
     } catch {
       return true;
     }
@@ -8990,12 +9189,12 @@ function collectFiles(dir, filter, skipDirs = []) {
   function walk(d) {
     let entries;
     try {
-      entries = readdirSync2(d, { withFileTypes: true });
+      entries = readdirSync3(d, { withFileTypes: true });
     } catch {
       return;
     }
     for (const e of entries) {
-      const full = join9(d, e.name);
+      const full = join10(d, e.name);
       if (e.isDirectory()) {
         if (skipDirs.includes(e.name) || e.name.startsWith(".")) continue;
         walk(full);
@@ -9034,7 +9233,7 @@ function findInlineDuplicatesOfShared(content, manifest) {
 }
 function getWatcherConfig(projectRoot) {
   try {
-    const pkgPath = join10(projectRoot, "package.json");
+    const pkgPath = join11(projectRoot, "package.json");
     if (!existsSync18(pkgPath)) return defaultWatcherConfig();
     const pkg = JSON.parse(readFileSync12(pkgPath, "utf-8"));
     const c = pkg?.coherent?.watcher ?? {};
@@ -9059,7 +9258,7 @@ function defaultWatcherConfig() {
   };
 }
 async function handleFileChange(projectRoot, filePath) {
-  const relativePath = relative3(projectRoot, filePath).replace(/\\/g, "/");
+  const relativePath = relative4(projectRoot, filePath).replace(/\\/g, "/");
   if (!relativePath.endsWith(".tsx") && !relativePath.endsWith(".ts")) return;
   if (relativePath.includes("node_modules") || relativePath.includes(".next")) return;
   let content;
@@ -9109,7 +9308,7 @@ async function handleFileChange(projectRoot, filePath) {
   }
 }
 async function handleFileDelete(projectRoot, filePath) {
-  const relativePath = relative3(projectRoot, filePath).replace(/\\/g, "/");
+  const relativePath = relative4(projectRoot, filePath).replace(/\\/g, "/");
   if (!relativePath.startsWith("components/") || relativePath.startsWith("components/ui/")) return;
   try {
     const chalk32 = (await import("chalk")).default;
@@ -9129,7 +9328,7 @@ async function handleFileDelete(projectRoot, filePath) {
   }
 }
 async function detectNewComponent(projectRoot, filePath) {
-  const relativePath = relative3(projectRoot, filePath).replace(/\\/g, "/");
+  const relativePath = relative4(projectRoot, filePath).replace(/\\/g, "/");
   if (!relativePath.startsWith("components/") || relativePath.startsWith("components/ui/")) return;
   if (!relativePath.endsWith(".tsx") && !relativePath.endsWith(".jsx")) return;
   try {
@@ -9163,8 +9362,8 @@ function startFileWatcher(projectRoot) {
   let watcher = null;
   let manifestWatcher = null;
   import("chokidar").then((chokidar) => {
-    const appGlob = join10(projectRoot, "app", "**", "*.tsx");
-    const compGlob = join10(projectRoot, "components", "**", "*.tsx");
+    const appGlob = join11(projectRoot, "app", "**", "*.tsx");
+    const compGlob = join11(projectRoot, "components", "**", "*.tsx");
     watcher = chokidar.default.watch([appGlob, compGlob], {
       ignoreInitial: true,
       awaitWriteFinish: { stabilityThreshold: 500 }
@@ -9176,7 +9375,7 @@ function startFileWatcher(projectRoot) {
     });
     watcher.on("unlink", (fp) => handleFileDelete(projectRoot, fp));
   });
-  const manifestPath = join10(projectRoot, "coherent.components.json");
+  const manifestPath = join11(projectRoot, "coherent.components.json");
   if (existsSync18(manifestPath)) {
     import("chokidar").then((chokidar) => {
       manifestWatcher = chokidar.default.watch(manifestPath, { ignoreInitial: true });
@@ -9228,7 +9427,7 @@ function checkDependenciesInstalled(projectRoot) {
   return existsSync19(nodeModulesPath);
 }
 function clearStaleCache(projectRoot) {
-  const nextDir = join11(projectRoot, ".next");
+  const nextDir = join12(projectRoot, ".next");
   if (existsSync19(nextDir)) {
     rmSync3(nextDir, { recursive: true, force: true });
     console.log(chalk14.dim("   \u2714 Cleared stale build cache"));
@@ -9249,7 +9448,7 @@ async function listPageFiles(appDir) {
   async function walk(dir) {
     const entries = await readdir2(dir, { withFileTypes: true });
     for (const e of entries) {
-      const full = join11(dir, e.name);
+      const full = join12(dir, e.name);
       if (e.isDirectory() && !e.name.startsWith(".") && e.name !== "api" && e.name !== "design-system") await walk(full);
       else if (e.isFile() && e.name === "page.tsx") out.push(full);
     }
@@ -9258,7 +9457,7 @@ async function listPageFiles(appDir) {
   return out;
 }
 async function validateSyntax(projectRoot) {
-  const appDir = join11(projectRoot, "app");
+  const appDir = join12(projectRoot, "app");
   const pages = await listPageFiles(appDir);
   for (const file of pages) {
     const content = readFileSync13(file, "utf-8");
@@ -9270,8 +9469,8 @@ async function validateSyntax(projectRoot) {
   }
 }
 async function fixMissingComponentExports(projectRoot) {
-  const appDir = join11(projectRoot, "app");
-  const uiDir = join11(projectRoot, "components", "ui");
+  const appDir = join12(projectRoot, "app");
+  const uiDir = join12(projectRoot, "components", "ui");
   if (!existsSync19(appDir) || !existsSync19(uiDir)) return;
   const pages = await listPageFiles(appDir);
   const neededExports = /* @__PURE__ */ new Map();
@@ -9286,7 +9485,7 @@ async function fixMissingComponentExports(projectRoot) {
       for (const name of names) neededExports.get(componentId).add(name);
     }
   }
-  const configPath = join11(projectRoot, "design-system.config.ts");
+  const configPath = join12(projectRoot, "design-system.config.ts");
   let config2 = null;
   try {
     const mgr = new DesignSystemManager8(configPath);
@@ -9295,7 +9494,7 @@ async function fixMissingComponentExports(projectRoot) {
   }
   const generator = new ComponentGenerator3(config2 || { components: [], pages: [], tokens: {} });
   for (const [componentId, needed] of neededExports) {
-    const componentFile = join11(uiDir, `${componentId}.tsx`);
+    const componentFile = join12(uiDir, `${componentId}.tsx`);
     const def = getShadcnComponent(componentId);
     if (!existsSync19(componentFile)) {
       if (!def) continue;
@@ -9332,7 +9531,7 @@ async function fixMissingComponentExports(projectRoot) {
   }
 }
 async function backfillPageAnalysis(projectRoot) {
-  const configPath = join11(projectRoot, "design-system.config.ts");
+  const configPath = join12(projectRoot, "design-system.config.ts");
   if (!existsSync19(configPath)) return;
   try {
     const mgr = new DesignSystemManager8(configPath);
@@ -9344,11 +9543,11 @@ async function backfillPageAnalysis(projectRoot) {
       const isAuth = route.includes("login") || route.includes("register") || route.includes("signup") || route.includes("sign-up");
       let filePath;
       if (route === "/") {
-        filePath = join11(projectRoot, "app", "page.tsx");
+        filePath = join12(projectRoot, "app", "page.tsx");
       } else if (isAuth) {
-        filePath = join11(projectRoot, "app", "(auth)", route.slice(1), "page.tsx");
+        filePath = join12(projectRoot, "app", "(auth)", route.slice(1), "page.tsx");
       } else {
-        filePath = join11(projectRoot, "app", route.slice(1), "page.tsx");
+        filePath = join12(projectRoot, "app", route.slice(1), "page.tsx");
       }
       if (!existsSync19(filePath)) continue;
       const code = readFileSync13(filePath, "utf-8");
@@ -9378,7 +9577,7 @@ async function autoInstallShadcnComponent(componentId, projectRoot) {
   const def = getShadcnComponent(componentId);
   if (!def) return false;
   try {
-    const configPath = join11(projectRoot, "design-system.config.ts");
+    const configPath = join12(projectRoot, "design-system.config.ts");
     let config2 = null;
     try {
       const mgr = new DesignSystemManager8(configPath);
@@ -9387,10 +9586,10 @@ async function autoInstallShadcnComponent(componentId, projectRoot) {
     }
     const generator = new ComponentGenerator3(config2 || { components: [], pages: [], tokens: {} });
     const code = await generator.generate(def);
-    const uiDir = join11(projectRoot, "components", "ui");
+    const uiDir = join12(projectRoot, "components", "ui");
     const { mkdirSync: mkdirSync9 } = await import("fs");
     mkdirSync9(uiDir, { recursive: true });
-    writeFileSync10(join11(uiDir, `${componentId}.tsx`), code, "utf-8");
+    writeFileSync10(join12(uiDir, `${componentId}.tsx`), code, "utf-8");
     return true;
   } catch {
     return false;
@@ -9604,9 +9803,9 @@ async function previewCommand() {
 import chalk15 from "chalk";
 import ora4 from "ora";
 import { spawn as spawn2 } from "child_process";
-import { existsSync as existsSync20, rmSync as rmSync4, readdirSync as readdirSync3 } from "fs";
-import { resolve as resolve11, join as join12, dirname as dirname7 } from "path";
-import { readdir as readdir3, readFile as readFile5, writeFile as writeFile4, mkdir as mkdir4, copyFile as copyFile2 } from "fs/promises";
+import { existsSync as existsSync20, rmSync as rmSync4, readdirSync as readdirSync4 } from "fs";
+import { resolve as resolve11, join as join13, dirname as dirname7 } from "path";
+import { readdir as readdir3, readFile as readFile6, writeFile as writeFile5, mkdir as mkdir5, copyFile as copyFile2 } from "fs/promises";
 var COPY_EXCLUDE = /* @__PURE__ */ new Set([
   "node_modules",
   ".next",
@@ -9624,16 +9823,16 @@ var COPY_EXCLUDE = /* @__PURE__ */ new Set([
   ".env.local"
 ]);
 async function copyDir(src, dest) {
-  await mkdir4(dest, { recursive: true });
+  await mkdir5(dest, { recursive: true });
   const entries = await readdir3(src, { withFileTypes: true });
   for (const e of entries) {
-    const srcPath = join12(src, e.name);
-    const destPath = join12(dest, e.name);
+    const srcPath = join13(src, e.name);
+    const destPath = join13(dest, e.name);
     if (COPY_EXCLUDE.has(e.name)) continue;
     if (e.isDirectory()) {
       await copyDir(srcPath, destPath);
     } else {
-      await mkdir4(dirname7(destPath), { recursive: true });
+      await mkdir5(dirname7(destPath), { recursive: true });
       await copyFile2(srcPath, destPath);
     }
   }
@@ -9648,15 +9847,15 @@ function getPackageManager2(projectRoot) {
 }
 async function patchNextConfigForExport(outRoot) {
   for (const name of ["next.config.ts", "next.config.mjs", "next.config.js"]) {
-    const p = join12(outRoot, name);
+    const p = join13(outRoot, name);
     if (!existsSync20(p)) continue;
-    let content = await readFile5(p, "utf-8");
+    let content = await readFile6(p, "utf-8");
     if (content.includes("ignoreDuringBuilds")) return;
     content = content.replace(
       /(const\s+nextConfig\s*(?::\s*\w+)?\s*=\s*\{)/,
       "$1\n  eslint: { ignoreDuringBuilds: true },\n  typescript: { ignoreBuildErrors: true },"
     );
-    await writeFile4(p, content, "utf-8");
+    await writeFile5(p, content, "utf-8");
     return;
   }
 }
@@ -9690,13 +9889,13 @@ EXPOSE 3000
 \`\`\`
 `;
 async function ensureReadmeDeploySection(outRoot) {
-  const readmePath = join12(outRoot, "README.md");
+  const readmePath = join13(outRoot, "README.md");
   if (!existsSync20(readmePath)) return;
   try {
-    let content = await readFile5(readmePath, "utf-8");
+    let content = await readFile6(readmePath, "utf-8");
     if (/##\s+Deploy\b/m.test(content)) return;
     content = content.trimEnd() + DEPLOY_SECTION + "\n";
-    await writeFile4(readmePath, content);
+    await writeFile5(readmePath, content);
   } catch {
   }
 }
@@ -9710,22 +9909,22 @@ async function countPages(outRoot) {
       return;
     }
     for (const e of entries) {
-      const full = join12(dir, e.name);
+      const full = join13(dir, e.name);
       if (e.isFile() && e.name === "page.tsx") n++;
       else if (e.isDirectory() && !e.name.startsWith(".") && e.name !== "api") await walk(full);
     }
   }
-  const appDir = join12(outRoot, "app");
+  const appDir = join13(outRoot, "app");
   if (existsSync20(appDir)) await walk(appDir);
   return n;
 }
 function countComponents(outRoot) {
   let n = 0;
   for (const sub of ["ui", "shared"]) {
-    const dir = join12(outRoot, "components", sub);
+    const dir = join13(outRoot, "components", sub);
     if (!existsSync20(dir)) continue;
     try {
-      n += readdirSync3(dir).filter((f) => f.endsWith(".tsx") || f.endsWith(".jsx")).length;
+      n += readdirSync4(dir).filter((f) => f.endsWith(".tsx") || f.endsWith(".jsx")).length;
     } catch {
     }
   }
@@ -9738,7 +9937,7 @@ async function collectImportedPackages2(dir, extensions) {
   async function walk(d) {
     const entries = await readdir3(d, { withFileTypes: true });
     for (const e of entries) {
-      const full = join12(d, e.name);
+      const full = join13(d, e.name);
       if (e.isDirectory() && !e.name.startsWith(".") && e.name !== "node_modules") {
         await walk(full);
         continue;
@@ -9746,7 +9945,7 @@ async function collectImportedPackages2(dir, extensions) {
       if (!e.isFile()) continue;
       const ext = e.name.replace(/^.*\./, "");
       if (!extensions.has(ext)) continue;
-      const content = await readFile5(full, "utf-8").catch(() => "");
+      const content = await readFile6(full, "utf-8").catch(() => "");
       let m;
       IMPORT_FROM_REGEX2.lastIndex = 0;
       while ((m = IMPORT_FROM_REGEX2.exec(content)) !== null) {
@@ -9761,16 +9960,16 @@ async function collectImportedPackages2(dir, extensions) {
   return packages;
 }
 async function findMissingDepsInExport(outRoot) {
-  const pkgPath = join12(outRoot, "package.json");
+  const pkgPath = join13(outRoot, "package.json");
   if (!existsSync20(pkgPath)) return [];
   let pkg;
   try {
-    pkg = JSON.parse(await readFile5(pkgPath, "utf-8"));
+    pkg = JSON.parse(await readFile6(pkgPath, "utf-8"));
   } catch {
     return [];
   }
   const inDeps = /* @__PURE__ */ new Set([...Object.keys(pkg.dependencies ?? {}), ...Object.keys(pkg.devDependencies ?? {})]);
-  const codeDirs = [join12(outRoot, "app"), join12(outRoot, "components")];
+  const codeDirs = [join13(outRoot, "app"), join13(outRoot, "components")];
   const extensions = /* @__PURE__ */ new Set(["ts", "tsx", "js", "jsx"]);
   const imported = /* @__PURE__ */ new Set();
   for (const dir of codeDirs) {
@@ -9782,35 +9981,35 @@ async function findMissingDepsInExport(outRoot) {
 async function stripCoherentArtifacts(outputDir) {
   const removed = [];
   for (const p of ["app/design-system", "app/api/design-system"]) {
-    const full = join12(outputDir, p);
+    const full = join13(outputDir, p);
     if (existsSync20(full)) {
       rmSync4(full, { recursive: true, force: true });
       removed.push(p);
     }
   }
-  const appNavPath = join12(outputDir, "app", "AppNav.tsx");
+  const appNavPath = join13(outputDir, "app", "AppNav.tsx");
   if (existsSync20(appNavPath)) {
     rmSync4(appNavPath, { force: true });
     removed.push("app/AppNav.tsx");
   }
-  const layoutPath = join12(outputDir, "app", "layout.tsx");
+  const layoutPath = join13(outputDir, "app", "layout.tsx");
   if (existsSync20(layoutPath)) {
-    let layout = await readFile5(layoutPath, "utf-8");
+    let layout = await readFile6(layoutPath, "utf-8");
     layout = layout.replace(/import\s*\{?\s*AppNav\s*\}?\s*from\s*['"][^'"]+['"]\s*\n?/g, "");
     layout = layout.replace(/\s*<AppNav\s*\/?\s*>\s*/g, "\n");
-    await writeFile4(layoutPath, layout, "utf-8");
+    await writeFile5(layoutPath, layout, "utf-8");
   }
-  const sharedHeaderPath = join12(outputDir, "components", "shared", "header.tsx");
+  const sharedHeaderPath = join13(outputDir, "components", "shared", "header.tsx");
   if (existsSync20(sharedHeaderPath)) {
-    let header = await readFile5(sharedHeaderPath, "utf-8");
+    let header = await readFile6(sharedHeaderPath, "utf-8");
     header = header.replace(/<Link\s[^>]*href="\/design-system"[^>]*>[\s\S]*?<\/Link>/g, "");
     header = header.replace(/\n\s*<>\s*\n/, "\n");
     header = header.replace(/\n\s*<\/>\s*\n/, "\n");
-    await writeFile4(sharedHeaderPath, header, "utf-8");
+    await writeFile5(sharedHeaderPath, header, "utf-8");
   }
-  const guardPath = join12(outputDir, "app", "ShowWhenNotAuthRoute.tsx");
+  const guardPath = join13(outputDir, "app", "ShowWhenNotAuthRoute.tsx");
   if (existsSync20(guardPath)) {
-    let guard = await readFile5(guardPath, "utf-8");
+    let guard = await readFile6(guardPath, "utf-8");
     guard = guard.replace(/['"],?\s*'\/design-system['"],?\s*/g, "");
     const pathsMatch = guard.match(/HIDDEN_PATHS\s*=\s*\[([^\]]*)\]/);
     const remaining = pathsMatch ? pathsMatch[1].replace(/['"]/g, "").split(",").map((s) => s.trim()).filter(Boolean) : [];
@@ -9818,14 +10017,14 @@ async function stripCoherentArtifacts(outputDir) {
       rmSync4(guardPath, { force: true });
       removed.push("app/ShowWhenNotAuthRoute.tsx");
       if (existsSync20(layoutPath)) {
-        let layout = await readFile5(layoutPath, "utf-8");
+        let layout = await readFile6(layoutPath, "utf-8");
         layout = layout.replace(/import\s+\w+\s+from\s*['"]\.\/ShowWhenNotAuthRoute['"]\s*\n?/g, "");
         layout = layout.replace(/\s*<ShowWhenNotAuthRoute>\s*\n?/g, "\n");
         layout = layout.replace(/\s*<\/ShowWhenNotAuthRoute>\s*\n?/g, "\n");
-        await writeFile4(layoutPath, layout, "utf-8");
+        await writeFile5(layoutPath, layout, "utf-8");
       }
     } else {
-      await writeFile4(guardPath, guard, "utf-8");
+      await writeFile5(guardPath, guard, "utf-8");
     }
   }
   for (const name of [
@@ -9837,14 +10036,14 @@ async function stripCoherentArtifacts(outputDir) {
     ".env.local",
     "recommendations.md"
   ]) {
-    const full = join12(outputDir, name);
+    const full = join13(outputDir, name);
     if (existsSync20(full)) {
       rmSync4(full, { force: true });
       removed.push(name);
     }
   }
   for (const dir of [".claude", ".coherent"]) {
-    const full = join12(outputDir, dir);
+    const full = join13(outputDir, dir);
     if (existsSync20(full)) {
       rmSync4(full, { recursive: true, force: true });
       removed.push(dir + "/");
@@ -10044,8 +10243,8 @@ async function regenerateDocsCommand() {
 
 // src/commands/fix.ts
 import chalk18 from "chalk";
-import { readdirSync as readdirSync4, readFileSync as readFileSync14, existsSync as existsSync21, writeFileSync as writeFileSync11, rmSync as rmSync5, mkdirSync as mkdirSync7 } from "fs";
-import { resolve as resolve12, join as join13 } from "path";
+import { readdirSync as readdirSync5, readFileSync as readFileSync14, existsSync as existsSync21, writeFileSync as writeFileSync11, rmSync as rmSync5, mkdirSync as mkdirSync7 } from "fs";
+import { resolve as resolve12, join as join14 } from "path";
 import {
   DesignSystemManager as DesignSystemManager11,
   ComponentManager as ComponentManager5,
@@ -10069,9 +10268,9 @@ function extractComponentIdsFromCode2(code) {
 function listTsxFiles(dir) {
   const files = [];
   try {
-    const entries = readdirSync4(dir, { withFileTypes: true });
+    const entries = readdirSync5(dir, { withFileTypes: true });
     for (const e of entries) {
-      const full = join13(dir, e.name);
+      const full = join14(dir, e.name);
       if (e.isDirectory() && e.name !== "node_modules" && !e.name.startsWith(".")) {
         files.push(...listTsxFiles(full));
       } else if (e.isFile() && e.name.endsWith(".tsx")) {
@@ -10100,7 +10299,7 @@ async function fixCommand(opts = {}) {
     console.log(chalk18.cyan("\ncoherent fix\n"));
   }
   if (!skipCache) {
-    const nextDir = join13(projectRoot, ".next");
+    const nextDir = join14(projectRoot, ".next");
     if (existsSync21(nextDir)) {
       if (!dryRun) rmSync5(nextDir, { recursive: true, force: true });
       fixes.push("Cleared build cache");
@@ -10357,13 +10556,13 @@ async function fixCommand(opts = {}) {
 // src/commands/check.ts
 import chalk19 from "chalk";
 import { resolve as resolve13 } from "path";
-import { readdirSync as readdirSync5, readFileSync as readFileSync15, statSync as statSync2, existsSync as existsSync22 } from "fs";
+import { readdirSync as readdirSync6, readFileSync as readFileSync15, statSync as statSync2, existsSync as existsSync22 } from "fs";
 import { loadManifest as loadManifest10 } from "@getcoherent/core";
 var EXCLUDED_DIRS = /* @__PURE__ */ new Set(["node_modules", "design-system"]);
 function findTsxFiles(dir) {
   const results = [];
   try {
-    const entries = readdirSync5(dir);
+    const entries = readdirSync6(dir);
     for (const entry of entries) {
       const full = resolve13(dir, entry);
       const stat = statSync2(full);
@@ -10691,8 +10890,8 @@ import { existsSync as existsSync23 } from "fs";
 import { resolve as resolve14 } from "path";
 
 // src/utils/ds-files.ts
-import { mkdir as mkdir5, writeFile as writeFile5 } from "fs/promises";
-import { join as join14, dirname as dirname8 } from "path";
+import { mkdir as mkdir6, writeFile as writeFile6 } from "fs/promises";
+import { join as join15, dirname as dirname8 } from "path";
 import { DesignSystemGenerator } from "@getcoherent/core";
 var SHARED_DS_KEYS = [
   "app/design-system/shared/page.tsx",
@@ -10706,9 +10905,9 @@ async function writeDesignSystemFiles(projectRoot, config2, options) {
   const toWrite = options?.sharedOnly ? new Map([...files].filter(([path3]) => SHARED_DS_KEYS.includes(path3))) : files;
   const written = [];
   for (const [relativePath, content] of toWrite) {
-    const fullPath = join14(projectRoot, relativePath);
-    await mkdir5(dirname8(fullPath), { recursive: true });
-    await writeFile5(fullPath, content, "utf-8");
+    const fullPath = join15(projectRoot, relativePath);
+    await mkdir6(dirname8(fullPath), { recursive: true });
+    await writeFile6(fullPath, content, "utf-8");
     written.push(relativePath);
   }
   return written;
@@ -10844,8 +11043,8 @@ function createComponentsCommand() {
 // src/commands/import-cmd.ts
 import chalk26 from "chalk";
 import ora6 from "ora";
-import { writeFile as writeFile6, mkdir as mkdir6 } from "fs/promises";
-import { resolve as resolve15, join as join15, dirname as dirname9 } from "path";
+import { writeFile as writeFile7, mkdir as mkdir7 } from "fs/promises";
+import { resolve as resolve15, join as join16, dirname as dirname9 } from "path";
 import { existsSync as existsSync24 } from "fs";
 import {
   FigmaClient,
@@ -10993,9 +11192,9 @@ async function importFigmaAction(urlOrKey, opts) {
       stats.filesWritten.push(filePath);
       return;
     }
-    const fullPath = join15(projectRoot, filePath);
-    await mkdir6(dirname9(fullPath), { recursive: true });
-    await writeFile6(fullPath, content, "utf-8");
+    const fullPath = join16(projectRoot, filePath);
+    await mkdir7(dirname9(fullPath), { recursive: true });
+    await writeFile7(fullPath, content, "utf-8");
     stats.filesWritten.push(filePath);
   };
   try {
@@ -11069,7 +11268,7 @@ async function importFigmaAction(urlOrKey, opts) {
     });
     if (dryRun) stats.filesWritten.push(FIGMA_COMPONENT_MAP_FILENAME);
     else
-      await writeFile6(
+      await writeFile7(
         resolve15(projectRoot, FIGMA_COMPONENT_MAP_FILENAME),
         JSON.stringify(componentMapObj, null, 2),
         "utf-8"
@@ -11109,7 +11308,7 @@ async function importFigmaAction(urlOrKey, opts) {
         });
         await dsm.save();
       } else {
-        await writeFile6(
+        await writeFile7(
           configPath,
           `/**
  * Design System Configuration
@@ -11124,10 +11323,10 @@ export const config = ${JSON.stringify(fullConfig, null, 2)} as const
       stats.configUpdated = true;
       spinner.succeed("design-system.config.ts updated");
       spinner.start("Ensuring root layout...");
-      const layoutPath = join15(projectRoot, "app/layout.tsx");
+      const layoutPath = join16(projectRoot, "app/layout.tsx");
       if (!existsSync24(layoutPath)) {
-        await mkdir6(dirname9(layoutPath), { recursive: true });
-        await writeFile6(layoutPath, MINIMAL_ROOT_LAYOUT, "utf-8");
+        await mkdir7(dirname9(layoutPath), { recursive: true });
+        await writeFile7(layoutPath, MINIMAL_ROOT_LAYOUT, "utf-8");
         stats.filesWritten.push("app/layout.tsx");
       }
       spinner.succeed("Root layout OK");
@@ -11216,7 +11415,7 @@ async function dsRegenerateCommand() {
 import chalk28 from "chalk";
 import ora8 from "ora";
 import { readFileSync as readFileSync16, existsSync as existsSync25 } from "fs";
-import { join as join16 } from "path";
+import { join as join17 } from "path";
 import { DesignSystemManager as DesignSystemManager15, CLI_VERSION as CLI_VERSION4 } from "@getcoherent/core";
 
 // src/utils/migrations.ts
@@ -11385,7 +11584,7 @@ var EXPECTED_CSS_VARS = [
   "--sidebar-ring"
 ];
 function checkMissingCssVars(projectRoot) {
-  const globalsPath = join16(projectRoot, "app", "globals.css");
+  const globalsPath = join17(projectRoot, "app", "globals.css");
   if (!existsSync25(globalsPath)) return [];
   try {
     const content = readFileSync16(globalsPath, "utf-8");
@@ -11395,7 +11594,7 @@ function checkMissingCssVars(projectRoot) {
   }
 }
 function patchGlobalsCss(projectRoot, missingVars) {
-  const globalsPath = join16(projectRoot, "app", "globals.css");
+  const globalsPath = join17(projectRoot, "app", "globals.css");
   if (!existsSync25(globalsPath) || missingVars.length === 0) return;
   const { writeFileSync: writeFileSync13 } = __require("fs");
   let content = readFileSync16(globalsPath, "utf-8");
@@ -11477,14 +11676,14 @@ async function undoCommand(options) {
 import chalk30 from "chalk";
 import ora9 from "ora";
 import { existsSync as existsSync26, readFileSync as readFileSync17 } from "fs";
-import { join as join17, relative as relative4, dirname as dirname10 } from "path";
-import { readdir as readdir4, readFile as readFile6 } from "fs/promises";
+import { join as join18, relative as relative5, dirname as dirname10 } from "path";
+import { readdir as readdir4, readFile as readFile7 } from "fs/promises";
 import { DesignSystemManager as DesignSystemManager16 } from "@getcoherent/core";
 import { loadManifest as loadManifest12, saveManifest as saveManifest5, findSharedComponent } from "@getcoherent/core";
 function extractTokensFromProject(projectRoot) {
   const lightColors = {};
   const darkColors = {};
-  const globalsPath = join17(projectRoot, "app", "globals.css");
+  const globalsPath = join18(projectRoot, "app", "globals.css");
   if (existsSync26(globalsPath)) {
     const css = readFileSync17(globalsPath, "utf-8");
     const rootMatch = css.match(/:root\s*\{([^}]+)\}/s);
@@ -11492,7 +11691,7 @@ function extractTokensFromProject(projectRoot) {
     const darkMatch = css.match(/\.dark\s*\{([^}]+)\}/s);
     if (darkMatch) parseVarsInto(darkMatch[1], darkColors);
   }
-  const layoutPath = join17(projectRoot, "app", "layout.tsx");
+  const layoutPath = join18(projectRoot, "app", "layout.tsx");
   let layoutCode = "";
   if (existsSync26(layoutPath)) {
     layoutCode = readFileSync17(layoutPath, "utf-8");
@@ -11536,14 +11735,14 @@ function parseVarsInto(block, target) {
 }
 async function detectCustomComponents(projectRoot, allPageCode) {
   const results = [];
-  const componentsDir = join17(projectRoot, "components");
+  const componentsDir = join18(projectRoot, "components");
   if (!existsSync26(componentsDir)) return results;
   const files = [];
   await walkForTsx(componentsDir, files, ["ui"]);
   const fileResults = await Promise.all(
     files.map(async (filePath) => {
-      const code = await readFile6(filePath, "utf-8");
-      const relFile = relative4(projectRoot, filePath);
+      const code = await readFile7(filePath, "utf-8");
+      const relFile = relative5(projectRoot, filePath);
       const exportedNames = extractExportedComponentNames2(code);
       return exportedNames.map((name) => ({
         name,
@@ -11564,7 +11763,7 @@ async function walkForTsx(dir, files, skipDirs) {
     return;
   }
   for (const e of entries) {
-    const full = join17(dir, e.name);
+    const full = join18(dir, e.name);
     if (e.isDirectory()) {
       if (skipDirs.includes(e.name) || e.name.startsWith(".")) continue;
       await walkForTsx(full, files, skipDirs);
@@ -11638,14 +11837,14 @@ async function discoverPages(appDir) {
       return;
     }
     for (const entry of entries) {
-      const full = join17(dir, entry.name);
+      const full = join18(dir, entry.name);
       if (entry.isDirectory()) {
         if (["design-system", "api", "_not-found"].includes(entry.name)) continue;
         if (entry.name.startsWith(".")) continue;
         await walk(full);
       } else if (entry.name === "page.tsx" || entry.name === "page.jsx") {
-        const code = await readFile6(full, "utf-8");
-        const routeDir = dirname10(relative4(appDir, full));
+        const code = await readFile7(full, "utf-8");
+        const routeDir = dirname10(relative5(appDir, full));
         let route = routeDir === "." ? "/" : "/" + routeDir;
         route = route.replace(/\/\([^)]+\)/g, "");
         if (!route.startsWith("/")) route = "/" + route;
@@ -11715,7 +11914,7 @@ async function syncCommand(options = {}) {
   if (dryRun) console.log(chalk30.yellow("  [dry-run] No files will be written\n"));
   const spinner = ora9("Scanning project files...").start();
   try {
-    const appDir = join17(project.root, "app");
+    const appDir = join18(project.root, "app");
     if (!existsSync26(appDir)) {
       spinner.fail("No app/ directory found");
       process.exit(1);
@@ -11942,14 +12141,14 @@ async function syncCommand(options = {}) {
 
 // src/utils/update-notifier.ts
 import { existsSync as existsSync27, mkdirSync as mkdirSync8, readFileSync as readFileSync18, writeFileSync as writeFileSync12 } from "fs";
-import { join as join18 } from "path";
+import { join as join19 } from "path";
 import { homedir } from "os";
 import chalk31 from "chalk";
 import { CLI_VERSION as CLI_VERSION5 } from "@getcoherent/core";
 var DEBUG5 = process.env.COHERENT_DEBUG === "1";
 var PACKAGE_NAME = "@getcoherent/cli";
-var CACHE_DIR = join18(homedir(), ".coherent");
-var CACHE_FILE = join18(CACHE_DIR, "update-check.json");
+var CACHE_DIR = join19(homedir(), ".coherent");
+var CACHE_FILE = join19(CACHE_DIR, "update-check.json");
 var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
 function readCache() {
   try {

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.5.1",
+  "version": "0.5.3",
   "description": "CLI interface for Coherent Design Method",
   "type": "module",
   "main": "./dist/index.js",
@@ -43,7 +43,7 @@
     "ora": "^7.0.1",
     "prompts": "^2.4.2",
     "zod": "^3.22.4",
-    "@getcoherent/core": "0.5.1"
+    "@getcoherent/core": "0.5.3"
   },
   "devDependencies": {
     "@types/node": "^20.11.0",