@getcoherent/cli 0.6.10 → 0.6.12

package/dist/index.js

@@ -1,6 +1,7 @@
 import {
   CORE_CONSTRAINTS,
   DESIGN_QUALITY,
+  DESIGN_QUALITY_COMMON,
   DESIGN_THINKING,
   INTERACTION_PATTERNS,
   VISUAL_DEPTH,
@@ -13,7 +14,7 @@ import {
   routeToKey,
   savePlan,
   selectContextualRules
-} from "./chunk-O7OA76D3.js";
+} from "./chunk-CLPILU3Z.js";
 import {
   __require
 } from "./chunk-3RG5ZIWI.js";
@@ -1369,10 +1370,10 @@ var ShadcnProvider = class {
     const componentPath = path.join(projectRoot, "components", "ui", `${name}.tsx`);
     if (!force && deps.existsSync(componentPath)) return;
     try {
-      await new Promise((resolve16, reject) => {
+      await new Promise((resolve17, reject) => {
         deps.exec(`npx shadcn@latest add ${name} --yes --overwrite`, { cwd: projectRoot, timeout: 15e3 }, (err) => {
           if (err) reject(err);
-          else resolve16();
+          else resolve17();
         });
       });
     } catch {
@@ -1413,13 +1414,13 @@ var ShadcnProvider = class {
     }
     if (toInstall.length === 0) return results;
     try {
-      await new Promise((resolve16, reject) => {
+      await new Promise((resolve17, reject) => {
         deps.exec(
           `npx shadcn@latest add ${toInstall.join(" ")} --yes --overwrite`,
           { cwd: projectRoot, timeout: 3e4 },
           (err) => {
             if (err) reject(err);
-            else resolve16();
+            else resolve17();
           }
         );
       });
@@ -1931,7 +1932,7 @@ function installPackages(projectRoot, packages) {
   if (packages.length === 0) return Promise.resolve(true);
   const safe = packages.filter((p) => SAFE_PKG_NAME.test(p));
   if (safe.length === 0) return Promise.resolve(true);
-  return new Promise((resolve16) => {
+  return new Promise((resolve17) => {
     try {
       const hasPnpm = existsSync4(join3(projectRoot, "pnpm-lock.yaml"));
       if (hasPnpm) {
@@ -1942,10 +1943,10 @@ function installPackages(projectRoot, packages) {
           stdio: "pipe"
         });
       }
-      resolve16(true);
+      resolve17(true);
     } catch (e) {
       if (process.env.COHERENT_DEBUG === "1") console.error("Failed to install packages:", e);
-      resolve16(false);
+      resolve17(false);
     }
   });
 }
@@ -3372,6 +3373,7 @@ function generateV4GlobalsCss(config2) {
   --color-accent-foreground: var(--accent-foreground);
   --color-destructive: var(--destructive);
   --color-destructive-foreground: var(--destructive-foreground);
+  --color-transparent: transparent;
   --color-border: var(--border);
   --color-input: var(--input);
   --color-ring: var(--ring);
@@ -3383,6 +3385,24 @@ function generateV4GlobalsCss(config2) {
   --color-warning: var(--warning);
   --color-error: var(--error);
   --color-info: var(--info);
+  --color-black: #000;
+  --color-white: #fff;
+  --color-sidebar-background: var(--sidebar-background);
+  --color-sidebar-foreground: var(--sidebar-foreground);
+  --color-sidebar-primary: var(--sidebar-primary);
+  --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);
+  --color-sidebar-accent: var(--sidebar-accent);
+  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
+  --color-sidebar-border: var(--sidebar-border);
+  --color-sidebar-ring: var(--sidebar-ring);
+  --color-sidebar-muted: var(--sidebar-muted);
+  --color-sidebar-muted-foreground: var(--sidebar-muted-foreground);
+  --color-chart-1: var(--chart-1);
+  --color-chart-2: var(--chart-2);
+  --color-chart-3: var(--chart-3);
+  --color-chart-4: var(--chart-4);
+  --color-chart-5: var(--chart-5);
+  --radius-xs: 0.125rem;
   --radius-sm: ${radius.sm || "0.25rem"};
   --radius-md: ${radius.md || "0.5rem"};
   --radius-lg: ${radius.lg || "0.75rem"};
@@ -3414,6 +3434,21 @@ function generateV4GlobalsCss(config2) {
   --warning: ${light.warning};
   --error: ${light.error};
   --info: ${light.info || light.primary};
+  --sidebar-background: ${light.background};
+  --sidebar-foreground: ${light.foreground};
+  --sidebar-primary: ${light.primary};
+  --sidebar-primary-foreground: ${contrastFg(light.primary)};
+  --sidebar-accent: ${light.accent || light.muted};
+  --sidebar-accent-foreground: ${light.foreground};
+  --sidebar-border: ${light.border};
+  --sidebar-ring: ${light.primary};
+  --sidebar-muted: ${light.muted};
+  --sidebar-muted-foreground: ${blendColors(light.foreground, light.background, 0.45)};
+  --chart-1: ${light.primary};
+  --chart-2: ${light.success};
+  --chart-3: ${light.warning};
+  --chart-4: ${light.error};
+  --chart-5: ${light.info || light.primary};
 }
 
 .dark {
@@ -3440,6 +3475,21 @@ function generateV4GlobalsCss(config2) {
   --warning: ${dark.warning};
   --error: ${dark.error};
   --info: ${dark.info || dark.primary};
+  --sidebar-background: ${dark.background};
+  --sidebar-foreground: ${dark.foreground};
+  --sidebar-primary: ${dark.primary};
+  --sidebar-primary-foreground: ${contrastFg(dark.primary)};
+  --sidebar-accent: ${dark.accent || dark.muted};
+  --sidebar-accent-foreground: ${dark.foreground};
+  --sidebar-border: ${dark.border};
+  --sidebar-ring: ${dark.primary};
+  --sidebar-muted: ${dark.muted};
+  --sidebar-muted-foreground: ${blendColors(dark.foreground, dark.background, 0.45)};
+  --chart-1: ${dark.primary};
+  --chart-2: ${dark.success};
+  --chart-3: ${dark.warning};
+  --chart-4: ${dark.error};
+  --chart-5: ${dark.info || dark.primary};
 }
 
 * {
@@ -3763,8 +3813,8 @@ async function createAppRouteGroupLayout(projectPath) {
 // src/commands/chat.ts
 import chalk14 from "chalk";
 import ora2 from "ora";
-import { resolve as resolve9, relative as relative2, join as join11 } from "path";
-import { existsSync as existsSync16, readFileSync as readFileSync11, mkdirSync as mkdirSync6, readdirSync as readdirSync3 } from "fs";
+import { resolve as resolve10, relative as relative2, join as join11 } from "path";
+import { existsSync as existsSync17, readFileSync as readFileSync12, mkdirSync as mkdirSync6, readdirSync as readdirSync4 } from "fs";
 import {
   DesignSystemManager as DesignSystemManager7,
   ComponentManager as ComponentManager5,
@@ -4919,6 +4969,17 @@ function needsGlobalsFix(projectRoot) {
   if (isTailwindV4(projectRoot)) {
     if (!content.includes("@theme inline")) return true;
     if (content.includes("@tailwind base")) return true;
+    const REQUIRED_V4_TOKENS = [
+      "--color-transparent",
+      "--color-sidebar-background",
+      "--color-chart-1",
+      "--color-black",
+      "--color-white",
+      "--radius-xs"
+    ];
+    for (const token of REQUIRED_V4_TOKENS) {
+      if (!content.includes(token)) return true;
+    }
     return false;
   }
   if (content.includes(":root {") || content.includes(".dark {")) return true;
@@ -6077,19 +6138,21 @@ ${selectImport}`
     /(<TabsTrigger\b[^>]*className=")([^"]*)(")/g,
     (_m, pre, classes, post) => {
       const cleaned = classes.replace(/\b(border-input|border\b|outline\b)\s*/g, "").trim();
-      const withBorder0 = cleaned.includes("border-0") ? cleaned : `${cleaned} border-0`.trim();
-      if (withBorder0 !== classes.trim()) return `${pre}${withBorder0}${post}`;
+      if (cleaned !== classes.trim()) return `${pre}${cleaned}${post}`;
       return _m;
     }
   );
-  fixed = fixed.replace(/<TabsTrigger\b(?![^>]*className=)(?![^>]*border-0)/g, '<TabsTrigger className="border-0"');
   if (fixed !== beforeTabsFix) {
-    fixes.push("added border-0 to TabsTrigger (Tailwind v4 border-transparent fix)");
+    fixes.push("stripped border from TabsTrigger (shadcn handles active state)");
   }
-  const beforeTabsListFix = fixed;
-  fixed = fixed.replace(/<TabsList\b(?![^>]*variant=)/g, '<TabsList variant="line"');
-  if (fixed !== beforeTabsListFix) {
-    fixes.push('added variant="line" to TabsList (clean underline style)');
+  const beforeJunkFix = fixed;
+  fixed = fixed.replace(/className="([^"]*)"/g, (_match, classes) => {
+    const cleaned = classes.split(/\s+/).filter((c) => c !== "-0").join(" ");
+    if (cleaned !== classes.trim()) return `className="${cleaned}"`;
+    return _match;
+  });
+  if (fixed !== beforeJunkFix) {
+    fixes.push("removed junk classes (-0)");
   }
   fixed = fixed.replace(/className="([^"]*)"/g, (_match, inner) => {
     const cleaned = inner.replace(/\s{2,}/g, " ").trim();
@@ -6810,6 +6873,8 @@ function applyDefaults(request) {
 }
 
 // src/commands/chat/split-generator.ts
+import { existsSync as existsSync14, readFileSync as readFileSync9, readdirSync as readdirSync2, statSync as statSync2 } from "fs";
+import { resolve as resolve6 } from "path";
 import { z } from "zod";
 import {
   loadManifest as loadManifest5,
@@ -7041,9 +7106,55 @@ ${groupLines.join("\n")}`];
   if (compLines.length > 0) {
     parts.push(`Shared Components:
 ${compLines.join("\n")}`);
+  }
+  const noteEntries = Object.entries(plan.pageNotes || {}).filter(
+    ([, note]) => note.sections && note.sections.length > 0
+  );
+  if (noteEntries.length > 0) {
+    const noteLines = noteEntries.map(([key, note]) => `  ${key}: ${note.sections.join(", ")}`);
+    parts.push(`Page Sections:
+${noteLines.join("\n")}`);
   }
   return parts.join("\n");
 }
+function readExistingAppPageForReference(projectRoot, plan) {
+  if (!projectRoot) return null;
+  if (plan?.pageNotes) {
+    for (const [key, note] of Object.entries(plan.pageNotes)) {
+      if (note.type !== "app") continue;
+      for (const group of ["(app)", "(admin)", "(dashboard)"]) {
+        const filePath = resolve6(projectRoot, "app", group, key, "page.tsx");
+        if (existsSync14(filePath)) {
+          const code = readFileSync9(filePath, "utf-8");
+          const lines = code.split("\n");
+          return lines.slice(0, 200).join("\n");
+        }
+      }
+    }
+  }
+  const appDir = resolve6(projectRoot, "app");
+  if (!existsSync14(appDir)) return null;
+  try {
+    const entries = readdirSync2(appDir);
+    for (const entry of entries) {
+      if (!entry.startsWith("(") || entry === "(auth)") continue;
+      const groupDir = resolve6(appDir, entry);
+      if (!statSync2(groupDir).isDirectory()) continue;
+      const subDirs = readdirSync2(groupDir);
+      for (const sub of subDirs) {
+        const pagePath = resolve6(groupDir, sub, "page.tsx");
+        if (existsSync14(pagePath)) {
+          const code = readFileSync9(pagePath, "utf-8");
+          const lines = code.split("\n");
+          return lines.slice(0, 200).join("\n");
+        }
+      }
+    }
+  } catch {
+    return null;
+  }
+  return null;
+}
 async function splitGeneratePages(spinner, message, modCtx, provider, parseOpts) {
   let pageNames = [];
   spinner.start("Phase 1/6 \u2014 Planning pages...");
@@ -7198,7 +7309,7 @@ async function splitGeneratePages(spinner, message, modCtx, provider, parseOpts)
     if (plan && plan.sharedComponents.length > 0) {
       spinner.start(`Phase 4.5/6 \u2014 Generating ${plan.sharedComponents.length} shared components from plan...`);
       try {
-        const { generateSharedComponentsFromPlan } = await import("./plan-generator-EWZYC45I.js");
+        const { generateSharedComponentsFromPlan } = await import("./plan-generator-QUESV7GS.js");
         const generated = await generateSharedComponentsFromPlan(
           plan,
           styleContext,
@@ -7245,6 +7356,13 @@ async function splitGeneratePages(spinner, message, modCtx, provider, parseOpts)
   const routeNote = `EXISTING ROUTES in this project: ${allRoutes}. All internal links MUST point to one of these routes. If a target doesn't exist, use href="#".`;
   const alignmentNote = 'CRITICAL LAYOUT RULE: Every <section> must wrap its content in a container div matching the header width. Use the EXACT same container classes as shown in the style context (e.g. className="container max-w-6xl px-4" or className="max-w-6xl mx-auto px-4"). Inner content can use narrower max-w for text centering, but the outer section container MUST match.';
   const planSummaryNote = plan ? formatPlanSummary(plan) : "";
+  const existingAppPageCode = readExistingAppPageForReference(parseOpts?.projectRoot ?? null, plan);
+  const existingAppPageNote = existingAppPageCode ? `
+EXISTING APP PAGE (match these UI patterns for consistency):
+\`\`\`
+${existingAppPageCode}
+\`\`\`
+` : "";
   const existingPagesContext = buildExistingPagesContext(modCtx.config);
   const AI_CONCURRENCY = 3;
   let phase5Done = 0;
@@ -7267,6 +7385,7 @@ async function splitGeneratePages(spinner, message, modCtx, provider, parseOpts)
         alignmentNote,
         authNote,
         planSummaryNote,
+        pageType !== "auth" ? existingAppPageNote : void 0,
         existingPagesContext,
         styleContext
       ].filter(Boolean).join("\n\n");
@@ -7427,7 +7546,7 @@ function extractAppNameFromPrompt(prompt) {
 }
 
 // src/commands/chat/modification-handler.ts
-import { resolve as resolve7 } from "path";
+import { resolve as resolve8 } from "path";
 import { mkdir as mkdir4 } from "fs/promises";
 import { dirname as dirname6 } from "path";
 import chalk12 from "chalk";
@@ -7441,8 +7560,8 @@ import {
 } from "@getcoherent/core";
 
 // src/commands/chat/code-generator.ts
-import { resolve as resolve6 } from "path";
-import { existsSync as existsSync14, readdirSync as readdirSync2, readFileSync as readFileSync9 } from "fs";
+import { resolve as resolve7 } from "path";
+import { existsSync as existsSync15, readdirSync as readdirSync3, readFileSync as readFileSync10 } from "fs";
 import { mkdir as mkdir3 } from "fs/promises";
 import { dirname as dirname5 } from "path";
 import {
@@ -7507,8 +7626,8 @@ async function ensureComponentsInstalled(componentIds, cm, dsm, pm, projectRoot)
   for (const componentId of ids) {
     const isRegistered = !!cm.read(componentId);
     const fileName = toKebabCase(componentId) + ".tsx";
-    const filePath = resolve6(projectRoot, "components", "ui", fileName);
-    const fileExists = existsSync14(filePath);
+    const filePath = resolve7(projectRoot, "components", "ui", fileName);
+    const fileExists = existsSync15(filePath);
     if (isRegistered && fileExists) continue;
     const result = await provider.installComponent(componentId, projectRoot);
     if (result.success && result.componentDef) {
@@ -7532,7 +7651,7 @@ async function regenerateComponent(componentId, config2, projectRoot) {
   const generator = new ComponentGenerator2(config2);
   const code = await generator.generate(component);
   const fileName = toKebabCase(component.name) + ".tsx";
-  const filePath = resolve6(projectRoot, "components", "ui", fileName);
+  const filePath = resolve7(projectRoot, "components", "ui", fileName);
   await writeFile(filePath, code);
 }
 async function regeneratePage(pageId, config2, projectRoot) {
@@ -7549,8 +7668,8 @@ async function regeneratePage(pageId, config2, projectRoot) {
   await writeFile(filePath, code);
 }
 async function canOverwriteShared(projectRoot, componentFile, storedHashes) {
-  const filePath = resolve6(projectRoot, componentFile);
-  if (!existsSync14(filePath)) return true;
+  const filePath = resolve7(projectRoot, componentFile);
+  if (!existsSync15(filePath)) return true;
   const storedHash = storedHashes[componentFile];
   if (!storedHash) return true;
   const edited = await isManuallyEdited(filePath, storedHash);
@@ -7567,7 +7686,7 @@ async function regenerateLayout(config2, projectRoot, options = { navChanged: fa
   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);
+    await writeFile(resolve7(projectRoot, "app", "layout.tsx"), code);
   }
   if (config2.navigation?.enabled && appType === "multi-page") {
     const navType = config2.navigation.type || "header";
@@ -7623,17 +7742,17 @@ async function regenerateLayout(config2, projectRoot, options = { navChanged: fa
   }
 }
 async function scanAndInstallSharedDeps(projectRoot) {
-  const sharedDir = resolve6(projectRoot, "components", "shared");
-  if (!existsSync14(sharedDir)) return [];
-  const files = readdirSync2(sharedDir).filter((f) => f.endsWith(".tsx") || f.endsWith(".ts"));
+  const sharedDir = resolve7(projectRoot, "components", "shared");
+  if (!existsSync15(sharedDir)) return [];
+  const files = readdirSync3(sharedDir).filter((f) => f.endsWith(".tsx") || f.endsWith(".ts"));
   const installed = [];
   const provider = getComponentProvider();
   for (const file of files) {
-    const code = readFileSync9(resolve6(sharedDir, file), "utf-8");
+    const code = readFileSync10(resolve7(sharedDir, file), "utf-8");
     const importMatches = [...code.matchAll(/@\/components\/ui\/([a-z0-9-]+)/g)];
     for (const [, componentId] of importMatches) {
-      const uiPath = resolve6(projectRoot, "components", "ui", `${componentId}.tsx`);
-      if (!existsSync14(uiPath) && provider.has(componentId)) {
+      const uiPath = resolve7(projectRoot, "components", "ui", `${componentId}.tsx`);
+      if (!existsSync15(uiPath) && provider.has(componentId)) {
         try {
           await provider.installComponent(componentId, projectRoot);
           installed.push(componentId);
@@ -7645,10 +7764,10 @@ async function scanAndInstallSharedDeps(projectRoot) {
   return [...new Set(installed)];
 }
 async function ensureAppRouteGroupLayout(projectRoot, navType, forceUpdate = false) {
-  const layoutPath = resolve6(projectRoot, "app", "(app)", "layout.tsx");
-  if (existsSync14(layoutPath) && !forceUpdate) return;
+  const layoutPath = resolve7(projectRoot, "app", "(app)", "layout.tsx");
+  if (existsSync15(layoutPath) && !forceUpdate) return;
   const { mkdir: mkdirAsync } = await import("fs/promises");
-  await mkdirAsync(resolve6(projectRoot, "app", "(app)"), { recursive: true });
+  await mkdirAsync(resolve7(projectRoot, "app", "(app)"), { recursive: true });
   const code = buildAppLayoutCode(navType);
   await writeFile(layoutPath, code);
 }
@@ -7736,9 +7855,9 @@ export default function GroupLayout({
 async function ensurePlanGroupLayouts(projectRoot, plan) {
   const { mkdir: mkdirAsync } = await import("fs/promises");
   for (const group of plan.groups) {
-    const groupDir = resolve6(projectRoot, "app", `(${group.id})`);
+    const groupDir = resolve7(projectRoot, "app", `(${group.id})`);
     await mkdirAsync(groupDir, { recursive: true });
-    const layoutPath = resolve6(groupDir, "layout.tsx");
+    const layoutPath = resolve7(groupDir, "layout.tsx");
     const code = buildGroupLayoutCode(group.layout, group.pages);
     await writeFile(layoutPath, code);
   }
@@ -7765,11 +7884,11 @@ async function regenerateFiles(modified, config2, projectRoot, options = { navCh
   }
   if (componentIds.size > 0) {
     const twGen = new TailwindConfigGenerator(config2);
-    const twPath = resolve6(projectRoot, "tailwind.config.ts");
-    const twCjsPath = resolve6(projectRoot, "tailwind.config.cjs");
-    if (existsSync14(twPath)) {
+    const twPath = resolve7(projectRoot, "tailwind.config.ts");
+    const twCjsPath = resolve7(projectRoot, "tailwind.config.cjs");
+    if (existsSync15(twPath)) {
       await writeFile(twPath, await twGen.generate());
-    } else if (existsSync14(twCjsPath)) {
+    } else if (existsSync15(twCjsPath)) {
       await writeFile(twCjsPath, await twGen.generateCjs());
     }
   }
@@ -8141,7 +8260,7 @@ async function applyModification(request, dsm, cm, pm, projectRoot, aiProvider,
           modified: []
         };
       }
-      const fullPath = resolve7(projectRoot, resolved.file);
+      const fullPath = resolve8(projectRoot, resolved.file);
       let currentCode;
       try {
         currentCode = await readFile(fullPath);
@@ -8215,7 +8334,7 @@ async function applyModification(request, dsm, cm, pm, projectRoot, aiProvider,
       } catch {
         return { success: false, message: `Could not read ${pageFilePath}`, modified: [] };
       }
-      const sharedPath = resolve7(projectRoot, resolved.file);
+      const sharedPath = resolve8(projectRoot, resolved.file);
       let sharedCode;
       try {
         sharedCode = await readFile(sharedPath);
@@ -8294,7 +8413,7 @@ async function applyModification(request, dsm, cm, pm, projectRoot, aiProvider,
       }
       let sourceCode;
       try {
-        sourceCode = await readFile(resolve7(projectRoot, sourcePath));
+        sourceCode = await readFile(resolve8(projectRoot, sourcePath));
       } catch {
         return { success: false, message: `Could not read ${sourcePath}`, modified: [] };
       }
@@ -8314,7 +8433,7 @@ async function applyModification(request, dsm, cm, pm, projectRoot, aiProvider,
         description: `Extracted from ${sourcePageName}: ${blockHint}`,
         usedIn: []
       });
-      const sharedPath = resolve7(projectRoot, created.file);
+      const sharedPath = resolve8(projectRoot, created.file);
       let sharedCode;
       try {
         sharedCode = await readFile(sharedPath);
@@ -8325,7 +8444,7 @@ async function applyModification(request, dsm, cm, pm, projectRoot, aiProvider,
       for (const pageName of allPagesToLink) {
         const relPath = routeToPath(pageName);
         if (!relPath) continue;
-        const fullPath = resolve7(projectRoot, relPath);
+        const fullPath = resolve8(projectRoot, relPath);
         let linkPageCode;
         try {
           linkPageCode = await readFile(fullPath);
@@ -8659,7 +8778,10 @@ Rules:
               if (ai.editPageCode) {
                 console.log(chalk12.dim("  \u270F\uFE0F  Applying changes to existing page..."));
                 const coreRules = CORE_CONSTRAINTS;
-                const qualityRules = DESIGN_QUALITY;
+                const pageRoute = pageDef.route || `/${pageDef.id}`;
+                const pageType = inferPageTypeFromRoute(pageRoute);
+                const qualityRules = `${DESIGN_QUALITY_COMMON}
+${getDesignQualityForType(pageType)}`;
                 const contextualRules = selectContextualRules(instruction);
                 const existingRoutes = dsm.getConfig().pages.map((p) => p.route).join(", ");
                 const routeRules = `
@@ -8949,8 +9071,8 @@ function hasNavChanged(before, after) {
 
 // src/commands/chat/interactive.ts
 import chalk13 from "chalk";
-import { resolve as resolve8 } from "path";
-import { existsSync as existsSync15, readFileSync as readFileSync10, writeFileSync as writeFileSync8, mkdirSync as mkdirSync5 } from "fs";
+import { resolve as resolve9 } from "path";
+import { existsSync as existsSync16, readFileSync as readFileSync11, writeFileSync as writeFileSync8, mkdirSync as mkdirSync5 } from "fs";
 import { DesignSystemManager as DesignSystemManager6, ComponentManager as ComponentManager4, loadManifest as loadManifest7 } from "@getcoherent/core";
 var DEBUG3 = process.env.COHERENT_DEBUG === "1";
 async function interactiveChat(options, chatCommandFn) {
@@ -8970,13 +9092,13 @@ async function interactiveChat(options, chatCommandFn) {
 \u274C Invalid provider: ${options.provider}`));
     process.exit(1);
   }
-  const historyDir = resolve8(homedir2(), ".coherent");
-  const historyFile = resolve8(historyDir, "history");
+  const historyDir = resolve9(homedir2(), ".coherent");
+  const historyFile = resolve9(historyDir, "history");
   let history = [];
   try {
     mkdirSync5(historyDir, { recursive: true });
-    if (existsSync15(historyFile)) {
-      history = readFileSync10(historyFile, "utf-8").split("\n").filter(Boolean).slice(-200);
+    if (existsSync16(historyFile)) {
+      history = readFileSync11(historyFile, "utf-8").split("\n").filter(Boolean).slice(-200);
     }
   } catch (e) {
     if (DEBUG3) console.error("Failed to load REPL history:", e);
@@ -9147,7 +9269,7 @@ async function chatCommand(message, options) {
   const projectRoot = project.root;
   const configPath = project.configPath;
   const migrationGuard = join11(projectRoot, ".coherent", "migration-in-progress");
-  if (existsSync16(migrationGuard)) {
+  if (existsSync17(migrationGuard)) {
     spinner.fail("Migration in progress");
     console.error(chalk14.red("\n\u274C A migration is in progress. Run `coherent migrate --rollback` to undo first."));
     bail("Migration in progress");
@@ -9207,7 +9329,7 @@ async function chatCommand(message, options) {
       }
       if (/switch to light mode|default to light|make.*light.*(default|theme)|light theme/i.test(message)) {
         spinner.start("Setting default theme to light...");
-        const layoutPath = resolve9(projectRoot, "app/layout.tsx");
+        const layoutPath = resolve10(projectRoot, "app/layout.tsx");
         try {
           let layout = await readFile(layoutPath);
           layout = layout.replace(/className="dark"/, "");
@@ -9246,8 +9368,8 @@ async function chatCommand(message, options) {
     spinner.start("Parsing your request...");
     let manifest = await loadManifest8(project.root);
     const validShared = manifest.shared.filter((s) => {
-      const fp = resolve9(project.root, s.file);
-      return existsSync16(fp);
+      const fp = resolve10(project.root, s.file);
+      return existsSync17(fp);
     });
     if (validShared.length !== manifest.shared.length) {
       const cleaned = manifest.shared.length - validShared.length;
@@ -9451,9 +9573,9 @@ async function chatCommand(message, options) {
     if (manifest.shared.length > 0) {
       for (const entry of manifest.shared) {
         try {
-          const sharedPath = resolve9(projectRoot, entry.file);
-          if (existsSync16(sharedPath)) {
-            const sharedCode = readFileSync11(sharedPath, "utf-8");
+          const sharedPath = resolve10(projectRoot, entry.file);
+          if (existsSync17(sharedPath)) {
+            const sharedCode = readFileSync12(sharedPath, "utf-8");
             const sharedImports = sharedCode.matchAll(/@\/components\/ui\/([a-z0-9-]+)/g);
             for (const m of sharedImports) {
               if (m[1]) allNeededComponentIds.add(m[1]);
@@ -9474,7 +9596,7 @@ async function chatCommand(message, options) {
     for (const componentId of allNeededComponentIds) {
       const isRegistered = !!cm.read(componentId);
       const filePath = join11(projectRoot, "components", "ui", `${componentId}.tsx`);
-      const fileExists = existsSync16(filePath);
+      const fileExists = existsSync17(filePath);
       if (DEBUG4) console.log(chalk14.gray(`    Checking ${componentId}: registered=${isRegistered} file=${fileExists}`));
       if (!isRegistered || !fileExists) {
         missingComponents.push(componentId);
@@ -9600,9 +9722,9 @@ async function chatCommand(message, options) {
         const route = page.route || `/${page.id || "page"}`;
         const pageFilePath = routeToFsPath(projectRoot, route, false);
         let pageCode = "";
-        if (existsSync16(pageFilePath)) {
+        if (existsSync17(pageFilePath)) {
           try {
-            pageCode = readFileSync11(pageFilePath, "utf-8");
+            pageCode = readFileSync12(pageFilePath, "utf-8");
           } catch {
           }
         }
@@ -9622,8 +9744,8 @@ async function chatCommand(message, options) {
       }
       const missingRoutes = [...allLinkedRoutes].filter((route) => {
         if (expandedExisting.has(route)) return false;
-        if (existsSync16(routeToFsPath(projectRoot, route, false))) return false;
-        if (existsSync16(routeToFsPath(projectRoot, route, true))) return false;
+        if (existsSync17(routeToFsPath(projectRoot, route, false))) return false;
+        if (existsSync17(routeToFsPath(projectRoot, route, true))) return false;
         return true;
       });
       const SCAFFOLD_AI_LIMIT = 10;
@@ -9687,8 +9809,8 @@ async function chatCommand(message, options) {
           const isAuth = isAuthRoute(linkedRoute);
           const filePath = routeToFsPath(projectRoot, linkedRoute, isAuth);
           if (isAuth) await ensureAuthRouteGroup(projectRoot);
-          const dir = resolve9(filePath, "..");
-          if (!existsSync16(dir)) {
+          const dir = resolve10(filePath, "..");
+          if (!existsSync17(dir)) {
             mkdirSync6(dir, { recursive: true });
           }
           const placeholderCode = `export default function ${pageName.replace(/\s/g, "")}Page() {
@@ -9721,7 +9843,7 @@ async function chatCommand(message, options) {
         for (const mod of result.modified) {
           if (mod.startsWith("app/") && mod.endsWith("/page.tsx")) {
             try {
-              const code = readFileSync11(resolve9(projectRoot, mod), "utf-8");
+              const code = readFileSync12(resolve10(projectRoot, mod), "utf-8");
               const issues = validatePageQuality(code, allRoutes).filter(
                 (i) => i.type === "BROKEN_INTERNAL_LINK"
               );
@@ -9751,7 +9873,7 @@ async function chatCommand(message, options) {
         dsm.updateConfig(latestConfig);
         if (DEBUG4) console.log(chalk14.dim(`  [theme] Set defaultMode to "${targetMode}"`));
       }
-      const layoutPath = resolve9(projectRoot, "app", "layout.tsx");
+      const layoutPath = resolve10(projectRoot, "app", "layout.tsx");
       try {
         let layoutCode = await readFile(layoutPath);
         if (targetMode === "dark" && !layoutCode.includes('className="dark"')) {
@@ -9801,16 +9923,16 @@ async function chatCommand(message, options) {
     }
     try {
       const updatedHashes = { ...storedHashes };
-      const sharedDir = resolve9(projectRoot, "components", "shared");
-      const layoutFile = resolve9(projectRoot, "app", "layout.tsx");
+      const sharedDir = resolve10(projectRoot, "components", "shared");
+      const layoutFile = resolve10(projectRoot, "app", "layout.tsx");
       const filesToHash = [layoutFile];
-      if (existsSync16(sharedDir)) {
-        for (const f of readdirSync3(sharedDir)) {
-          if (f.endsWith(".tsx")) filesToHash.push(resolve9(sharedDir, f));
+      if (existsSync17(sharedDir)) {
+        for (const f of readdirSync4(sharedDir)) {
+          if (f.endsWith(".tsx")) filesToHash.push(resolve10(sharedDir, f));
         }
       }
       for (const filePath of filesToHash) {
-        if (existsSync16(filePath)) {
+        if (existsSync17(filePath)) {
           const rel = relative2(projectRoot, filePath);
           updatedHashes[rel] = await computeFileHash(filePath);
         }
@@ -9842,7 +9964,7 @@ async function chatCommand(message, options) {
       console.log("");
     }
     if (uxRecommendations) {
-      const recPath = resolve9(projectRoot, "recommendations.md");
+      const recPath = resolve10(projectRoot, "recommendations.md");
       const section = `
 
 ---
@@ -9852,7 +9974,7 @@ async function chatCommand(message, options) {
 ${uxRecommendations}
 `;
       try {
-        if (!existsSync16(recPath)) {
+        if (!existsSync17(recPath)) {
           await writeFile(
             recPath,
             "# UX/UI Recommendations\n\nRecommendations are added here when you use `coherent chat` and the AI suggests improvements.\n"
@@ -9926,18 +10048,68 @@ ${uxRecommendations}
 import chalk15 from "chalk";
 import ora3 from "ora";
 import { spawn } from "child_process";
-import { existsSync as existsSync19, rmSync as rmSync3, readFileSync as readFileSync14, writeFileSync as writeFileSync10, readdirSync as readdirSync5 } from "fs";
-import { resolve as resolve10, join as join14 } from "path";
+import { existsSync as existsSync20, rmSync as rmSync3, readFileSync as readFileSync15, writeFileSync as writeFileSync10, readdirSync as readdirSync6 } from "fs";
+import { resolve as resolve11, join as join14 } from "path";
 import { readdir as readdir2 } from "fs/promises";
+
+// src/utils/css-validator.ts
+var REQUIRED_THEME_TOKENS = [
+  "--color-transparent",
+  "--color-black",
+  "--color-white",
+  "--color-sidebar-background",
+  "--color-sidebar-foreground",
+  "--color-sidebar-primary",
+  "--color-sidebar-primary-foreground",
+  "--color-sidebar-accent",
+  "--color-sidebar-accent-foreground",
+  "--color-sidebar-border",
+  "--color-sidebar-ring",
+  "--color-sidebar-muted",
+  "--color-sidebar-muted-foreground",
+  "--color-chart-1",
+  "--color-chart-2",
+  "--color-chart-3",
+  "--color-chart-4",
+  "--color-chart-5",
+  "--radius-xs"
+];
+var VAR_REFERENCE_RE = /var\(--([^)]+)\)/;
+function validateV4GlobalsCss(css) {
+  const issues = [];
+  if (css.includes("@tailwind base") || css.includes("@tailwind components")) {
+    issues.push("Stale v3 directive (@tailwind) found in v4 CSS \u2014 remove it");
+  }
+  const themeMatch = css.match(/@theme\s+inline\s*\{([^}]*(?:\{[^}]*\}[^}]*)*)\}/s);
+  const themeBlock = themeMatch ? themeMatch[1] : "";
+  for (const token of REQUIRED_THEME_TOKENS) {
+    if (!themeBlock.includes(token)) {
+      issues.push(`Missing @theme token: ${token}`);
+    }
+  }
+  const themeLines = themeBlock.split("\n");
+  for (const line of themeLines) {
+    const varMatch = line.match(VAR_REFERENCE_RE);
+    if (!varMatch) continue;
+    const referencedVar = `--${varMatch[1]}`;
+    const definedInRoot = css.includes(`${referencedVar}:`) || css.includes(`${referencedVar} :`);
+    if (!definedInRoot) {
+      issues.push(`@theme references var(${referencedVar}) but it is not defined in :root/.dark`);
+    }
+  }
+  return issues;
+}
+
+// src/commands/preview.ts
 import { DesignSystemManager as DesignSystemManager8, ComponentGenerator as ComponentGenerator3 } from "@getcoherent/core";
 
 // src/utils/file-watcher.ts
-import { readFileSync as readFileSync13, writeFileSync as writeFileSync9, existsSync as existsSync18 } from "fs";
+import { readFileSync as readFileSync14, writeFileSync as writeFileSync9, existsSync as existsSync19 } from "fs";
 import { relative as relative4, join as join13 } from "path";
 import { loadManifest as loadManifest9, saveManifest as saveManifest3 } from "@getcoherent/core";
 
 // src/utils/component-integrity.ts
-import { existsSync as existsSync17, readFileSync as readFileSync12, readdirSync as readdirSync4 } from "fs";
+import { existsSync as existsSync18, readFileSync as readFileSync13, readdirSync as readdirSync5 } from "fs";
 import { join as join12, relative as relative3 } from "path";
 function extractExportedComponentNames(code) {
   const names = [];
@@ -9965,13 +10137,13 @@ function arraysEqual(a, b) {
 function findPagesImporting(projectRoot, componentName, componentFile) {
   const results = [];
   const appDir = join12(projectRoot, "app");
-  if (!existsSync17(appDir)) return results;
+  if (!existsSync18(appDir)) return results;
   const pageFiles = collectFiles(appDir, (name) => name === "page.tsx" || name === "page.jsx");
   const componentImportPath = componentFile.replace(/\.tsx$/, "").replace(/\.jsx$/, "");
   for (const absPath of pageFiles) {
     if (absPath.includes("design-system")) continue;
     try {
-      const code = readFileSync12(absPath, "utf-8");
+      const code = readFileSync13(absPath, "utf-8");
       const hasNamedImport = new RegExp(`import\\s+\\{[^}]*\\b${componentName}\\b[^}]*\\}\\s+from\\s+['"]`).test(code);
       const hasDefaultImport = new RegExp(`import\\s+${componentName}\\s+from\\s+['"]`).test(code);
       const hasPathImport = code.includes(`@/${componentImportPath}`);
@@ -9985,9 +10157,9 @@ function findPagesImporting(projectRoot, componentName, componentFile) {
 }
 function isUsedInLayout(projectRoot, componentName) {
   const layoutPath = join12(projectRoot, "app", "layout.tsx");
-  if (!existsSync17(layoutPath)) return false;
+  if (!existsSync18(layoutPath)) return false;
   try {
-    const code = readFileSync12(layoutPath, "utf-8");
+    const code = readFileSync13(layoutPath, "utf-8");
     return code.includes(componentName);
   } catch {
     return false;
@@ -9996,7 +10168,7 @@ function isUsedInLayout(projectRoot, componentName) {
 function findUnregisteredComponents(projectRoot, manifest) {
   const results = [];
   const componentsDir = join12(projectRoot, "components");
-  if (!existsSync17(componentsDir)) return results;
+  if (!existsSync18(componentsDir)) return results;
   const registeredFiles = new Set(manifest.shared.map((s) => s.file));
   const registeredNames = new Set(manifest.shared.map((s) => s.name));
   const files = collectFiles(
@@ -10008,7 +10180,7 @@ function findUnregisteredComponents(projectRoot, manifest) {
     const relFile = relative3(projectRoot, absPath);
     if (registeredFiles.has(relFile)) continue;
     try {
-      const code = readFileSync12(absPath, "utf-8");
+      const code = readFileSync13(absPath, "utf-8");
       const exports = extractExportedComponentNames(code);
       for (const name of exports) {
         if (registeredNames.has(name)) continue;
@@ -10024,13 +10196,13 @@ function findUnregisteredComponents(projectRoot, manifest) {
 function findInlineDuplicates(projectRoot, manifest) {
   const results = [];
   const appDir = join12(projectRoot, "app");
-  if (!existsSync17(appDir)) return results;
+  if (!existsSync18(appDir)) return results;
   const pageFiles = collectFiles(appDir, (name) => name === "page.tsx" || name === "page.jsx");
   for (const absPath of pageFiles) {
     if (absPath.includes("design-system")) continue;
     let code;
     try {
-      code = readFileSync12(absPath, "utf-8");
+      code = readFileSync13(absPath, "utf-8");
     } catch {
       continue;
     }
@@ -10054,7 +10226,7 @@ function findInlineDuplicates(projectRoot, manifest) {
 }
 function findComponentFileByExportName(projectRoot, componentName) {
   const componentsDir = join12(projectRoot, "components");
-  if (!existsSync17(componentsDir)) return null;
+  if (!existsSync18(componentsDir)) return null;
   const files = collectFiles(
     componentsDir,
     (name) => (name.endsWith(".tsx") || name.endsWith(".jsx")) && !name.startsWith("."),
@@ -10062,7 +10234,7 @@ function findComponentFileByExportName(projectRoot, componentName) {
   );
   for (const absPath of files) {
     try {
-      const code = readFileSync12(absPath, "utf-8");
+      const code = readFileSync13(absPath, "utf-8");
       const exports = extractExportedComponentNames(code);
       if (exports.includes(componentName)) {
         return relative3(projectRoot, absPath);
@@ -10076,7 +10248,7 @@ function removeOrphanedEntries(projectRoot, manifest) {
   const removed = [];
   const valid = manifest.shared.filter((entry) => {
     const filePath = join12(projectRoot, entry.file);
-    if (existsSync17(filePath)) return true;
+    if (existsSync18(filePath)) return true;
     removed.push({ id: entry.id, name: entry.name });
     return false;
   });
@@ -10095,7 +10267,7 @@ function reconcileComponents(projectRoot, manifest) {
   const m = { ...manifest, shared: [...manifest.shared], nextId: manifest.nextId };
   m.shared = m.shared.filter((entry) => {
     const filePath = join12(projectRoot, entry.file);
-    if (!existsSync17(filePath)) {
+    if (!existsSync18(filePath)) {
       const newPath = findComponentFileByExportName(projectRoot, entry.name);
       if (newPath) {
         result.updated.push({ id: entry.id, field: "file", from: entry.file, to: newPath });
@@ -10107,7 +10279,7 @@ function reconcileComponents(projectRoot, manifest) {
     }
     let code;
     try {
-      code = readFileSync12(join12(projectRoot, entry.file), "utf-8");
+      code = readFileSync13(join12(projectRoot, entry.file), "utf-8");
     } catch {
       return true;
     }
@@ -10184,7 +10356,7 @@ function collectFiles(dir, filter, skipDirs = []) {
   function walk(d) {
     let entries;
     try {
-      entries = readdirSync4(d, { withFileTypes: true });
+      entries = readdirSync5(d, { withFileTypes: true });
     } catch {
       return;
     }
@@ -10229,8 +10401,8 @@ function findInlineDuplicatesOfShared(content, manifest) {
 function getWatcherConfig(projectRoot) {
   try {
     const pkgPath = join13(projectRoot, "package.json");
-    if (!existsSync18(pkgPath)) return defaultWatcherConfig();
-    const pkg = JSON.parse(readFileSync13(pkgPath, "utf-8"));
+    if (!existsSync19(pkgPath)) return defaultWatcherConfig();
+    const pkg = JSON.parse(readFileSync14(pkgPath, "utf-8"));
     const c = pkg?.coherent?.watcher ?? {};
     return {
       enabled: c.enabled !== false,
@@ -10258,7 +10430,7 @@ async function handleFileChange(projectRoot, filePath) {
   if (relativePath.includes("node_modules") || relativePath.includes(".next")) return;
   let content;
   try {
-    content = readFileSync13(filePath, "utf-8");
+    content = readFileSync14(filePath, "utf-8");
   } catch {
     return;
   }
@@ -10331,7 +10503,7 @@ async function detectNewComponent(projectRoot, filePath) {
     const manifest = await loadManifest9(projectRoot);
     const alreadyRegistered = manifest.shared.some((s) => s.file === relativePath);
     if (alreadyRegistered) return;
-    const code = readFileSync13(filePath, "utf-8");
+    const code = readFileSync14(filePath, "utf-8");
     const exports = extractExportedComponentNames(code);
     if (exports.length > 0) {
       const alreadyByName = exports.every((n) => manifest.shared.some((s) => s.name === n));
@@ -10371,7 +10543,7 @@ function startFileWatcher(projectRoot) {
     watcher.on("unlink", (fp) => handleFileDelete(projectRoot, fp));
   });
   const manifestPath = join13(projectRoot, "coherent.components.json");
-  if (existsSync18(manifestPath)) {
+  if (existsSync19(manifestPath)) {
     import("chokidar").then((chokidar) => {
       manifestWatcher = chokidar.default.watch(manifestPath, { ignoreInitial: true });
       manifestWatcher.on("change", () => handleManifestChange(projectRoot));
@@ -10385,7 +10557,7 @@ function startFileWatcher(projectRoot) {
 
 // src/commands/preview.ts
 function getPackageManager(projectRoot) {
-  const hasPnpm = existsSync19(resolve10(projectRoot, "pnpm-lock.yaml"));
+  const hasPnpm = existsSync20(resolve11(projectRoot, "pnpm-lock.yaml"));
   return hasPnpm ? "pnpm" : "npm";
 }
 function runInstall(projectRoot) {
@@ -10407,23 +10579,23 @@ function runInstall(projectRoot) {
   });
 }
 function checkProjectInitialized(projectRoot) {
-  const configPath = resolve10(projectRoot, "design-system.config.ts");
-  const packageJsonPath = resolve10(projectRoot, "package.json");
-  if (!existsSync19(configPath)) {
+  const configPath = resolve11(projectRoot, "design-system.config.ts");
+  const packageJsonPath = resolve11(projectRoot, "package.json");
+  if (!existsSync20(configPath)) {
     return false;
   }
-  if (!existsSync19(packageJsonPath)) {
+  if (!existsSync20(packageJsonPath)) {
     return false;
   }
   return true;
 }
 function checkDependenciesInstalled(projectRoot) {
-  const nodeModulesPath = resolve10(projectRoot, "node_modules");
-  return existsSync19(nodeModulesPath);
+  const nodeModulesPath = resolve11(projectRoot, "node_modules");
+  return existsSync20(nodeModulesPath);
 }
 function clearStaleCache(projectRoot) {
   const nextDir = join14(projectRoot, ".next");
-  if (existsSync19(nextDir)) {
+  if (existsSync20(nextDir)) {
     rmSync3(nextDir, { recursive: true, force: true });
     console.log(chalk15.dim("   \u2714 Cleared stale build cache"));
   }
@@ -10439,7 +10611,7 @@ async function preflightDependencyCheck(projectRoot) {
 }
 async function listPageFiles(appDir) {
   const out = [];
-  if (!existsSync19(appDir)) return out;
+  if (!existsSync20(appDir)) return out;
   async function walk(dir) {
     const entries = await readdir2(dir, { withFileTypes: true });
     for (const e of entries) {
@@ -10455,7 +10627,7 @@ async function validateSyntax(projectRoot) {
   const appDir = join14(projectRoot, "app");
   const pages = await listPageFiles(appDir);
   for (const file of pages) {
-    const content = readFileSync14(file, "utf-8");
+    const content = readFileSync15(file, "utf-8");
     const fixed = fixUnescapedLtInJsx(sanitizeMetadataStrings(ensureUseClientIfNeeded(content)));
     if (fixed !== content) {
       writeFileSync10(file, fixed, "utf-8");
@@ -10466,16 +10638,16 @@ async function validateSyntax(projectRoot) {
 async function fixMissingComponentExports(projectRoot) {
   const appDir = join14(projectRoot, "app");
   const uiDir = join14(projectRoot, "components", "ui");
-  if (!existsSync19(appDir) || !existsSync19(uiDir)) return;
+  if (!existsSync20(appDir) || !existsSync20(uiDir)) return;
   const pages = await listPageFiles(appDir);
   const sharedDir = join14(projectRoot, "components", "shared");
-  if (existsSync19(sharedDir)) {
-    const sharedFiles = readdirSync5(sharedDir).filter((f) => f.endsWith(".tsx") || f.endsWith(".ts")).map((f) => join14(sharedDir, f));
+  if (existsSync20(sharedDir)) {
+    const sharedFiles = readdirSync6(sharedDir).filter((f) => f.endsWith(".tsx") || f.endsWith(".ts")).map((f) => join14(sharedDir, f));
     pages.push(...sharedFiles);
   }
   const neededExports = /* @__PURE__ */ new Map();
   for (const file of pages) {
-    const content = readFileSync14(file, "utf-8");
+    const content = readFileSync15(file, "utf-8");
     const importRe = /import\s*\{([^}]+)\}\s*from\s*['"]@\/components\/ui\/([^'"]+)['"]/g;
     let m;
     while ((m = importRe.exec(content)) !== null) {
@@ -10496,7 +10668,7 @@ async function fixMissingComponentExports(projectRoot) {
   const provider = getComponentProvider();
   for (const [componentId, needed] of neededExports) {
     const componentFile = join14(uiDir, `${componentId}.tsx`);
-    if (!existsSync19(componentFile)) {
+    if (!existsSync20(componentFile)) {
       if (provider.has(componentId)) {
         try {
           const result = await provider.installComponent(componentId, projectRoot);
@@ -10519,7 +10691,7 @@ async function fixMissingComponentExports(projectRoot) {
       }
       continue;
     }
-    const content = readFileSync14(componentFile, "utf-8");
+    const content = readFileSync15(componentFile, "utf-8");
     const exportRe = /export\s+(?:const|function|class)\s+(\w+)|export\s*\{([^}]+)\}/g;
     const existingExports = /* @__PURE__ */ new Set();
     let em;
@@ -10554,7 +10726,7 @@ async function fixMissingComponentExports(projectRoot) {
 }
 async function backfillPageAnalysis(projectRoot) {
   const configPath = join14(projectRoot, "design-system.config.ts");
-  if (!existsSync19(configPath)) return;
+  if (!existsSync20(configPath)) return;
   try {
     const mgr = new DesignSystemManager8(configPath);
     const config2 = mgr.getConfig();
@@ -10571,8 +10743,8 @@ async function backfillPageAnalysis(projectRoot) {
       } else {
         filePath = join14(projectRoot, "app", route.slice(1), "page.tsx");
       }
-      if (!existsSync19(filePath)) continue;
-      const code = readFileSync14(filePath, "utf-8");
+      if (!existsSync20(filePath)) continue;
+      const code = readFileSync15(filePath, "utf-8");
       if (code.length < 50) continue;
       page.pageAnalysis = analyzePageCode(code);
       changed = true;
@@ -10722,12 +10894,12 @@ async function openBrowser(url) {
   }
 }
 function startDevServer(projectRoot) {
-  const packageJsonPath = resolve10(projectRoot, "package.json");
-  if (!existsSync19(packageJsonPath)) {
+  const packageJsonPath = resolve11(projectRoot, "package.json");
+  if (!existsSync20(packageJsonPath)) {
     throw new Error('package.json not found. Run "coherent init" first.');
   }
-  const hasPnpm = existsSync19(resolve10(projectRoot, "pnpm-lock.yaml"));
-  const hasNpm = existsSync19(resolve10(projectRoot, "package-lock.json"));
+  const hasPnpm = existsSync20(resolve11(projectRoot, "pnpm-lock.yaml"));
+  const hasNpm = existsSync20(resolve11(projectRoot, "package-lock.json"));
   const command = hasPnpm ? "pnpm" : hasNpm ? "npm" : "npx";
   const args = hasPnpm ? ["dev", "--turbo"] : hasNpm ? ["run", "dev", "--", "--turbo"] : ["next", "dev", "--turbo"];
   const child = spawn(command, args, {
@@ -10774,7 +10946,7 @@ async function previewCommand() {
     if (needsGlobalsFix(projectRoot)) {
       spinner.text = "Fixing globals.css...";
       try {
-        const dsm = new DesignSystemManager8(resolve10(projectRoot, "design-system.config.ts"));
+        const dsm = new DesignSystemManager8(resolve11(projectRoot, "design-system.config.ts"));
         await dsm.load();
         const config2 = dsm.getConfig();
         fixGlobalsCss(projectRoot, config2);
@@ -10783,6 +10955,20 @@ async function previewCommand() {
         spinner.warn("Could not auto-fix globals.css");
       }
     }
+    if (isTailwindV4(projectRoot)) {
+      const globalsPath = resolve11(projectRoot, "app", "globals.css");
+      if (existsSync20(globalsPath)) {
+        const globalsContent = readFileSync15(globalsPath, "utf-8");
+        const cssIssues = validateV4GlobalsCss(globalsContent);
+        if (cssIssues.length > 0) {
+          console.log(chalk15.yellow("\n\u26A0\uFE0F  globals.css validation warnings:"));
+          for (const issue of cssIssues) {
+            console.log(chalk15.yellow(`   \u2022 ${issue}`));
+          }
+          console.log(chalk15.dim('   Run "coherent chat" to regenerate globals.css\n'));
+        }
+      }
+    }
     spinner.text = "Pre-flight: dependencies and syntax...";
     await preflightDependencyCheck(projectRoot);
     clearStaleCache(projectRoot);
@@ -10813,8 +10999,8 @@ async function previewCommand() {
 import chalk16 from "chalk";
 import ora4 from "ora";
 import { spawn as spawn2 } from "child_process";
-import { existsSync as existsSync20, rmSync as rmSync4, readdirSync as readdirSync6 } from "fs";
-import { resolve as resolve11, join as join15, dirname as dirname7 } from "path";
+import { existsSync as existsSync21, rmSync as rmSync4, readdirSync as readdirSync7 } from "fs";
+import { resolve as resolve12, join as join15, 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",
@@ -10848,17 +11034,17 @@ async function copyDir(src, dest) {
   }
 }
 function checkProjectInitialized2(projectRoot) {
-  return existsSync20(resolve11(projectRoot, "design-system.config.ts")) && existsSync20(resolve11(projectRoot, "package.json"));
+  return existsSync21(resolve12(projectRoot, "design-system.config.ts")) && existsSync21(resolve12(projectRoot, "package.json"));
 }
 function getPackageManager2(projectRoot) {
-  if (existsSync20(resolve11(projectRoot, "pnpm-lock.yaml"))) return "pnpm";
-  if (existsSync20(resolve11(projectRoot, "package-lock.json"))) return "npm";
+  if (existsSync21(resolve12(projectRoot, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync21(resolve12(projectRoot, "package-lock.json"))) return "npm";
   return "npx";
 }
 async function patchNextConfigForExport(outRoot) {
   for (const name of ["next.config.ts", "next.config.mjs", "next.config.js"]) {
     const p = join15(outRoot, name);
-    if (!existsSync20(p)) continue;
+    if (!existsSync21(p)) continue;
     let content = await readFile6(p, "utf-8");
     if (content.includes("ignoreDuringBuilds")) return;
     content = content.replace(
@@ -10873,9 +11059,9 @@ async function buildProduction(projectRoot) {
   const pm = getPackageManager2(projectRoot);
   const command = pm === "pnpm" ? "pnpm" : pm === "npm" ? "npm" : "npx";
   const args = pm === "npx" ? ["next", "build"] : ["run", "build"];
-  return new Promise((resolve16, reject) => {
+  return new Promise((resolve17, reject) => {
     const child = spawn2(command, args, { cwd: projectRoot, stdio: "inherit", shell: true });
-    child.on("exit", (code) => code === 0 ? resolve16() : reject(new Error(`Build failed with exit code ${code}`)));
+    child.on("exit", (code) => code === 0 ? resolve17() : reject(new Error(`Build failed with exit code ${code}`)));
     child.on("error", (error) => reject(new Error(`Failed to start build: ${error.message}`)));
   });
 }
@@ -10900,7 +11086,7 @@ EXPOSE 3000
 `;
 async function ensureReadmeDeploySection(outRoot) {
   const readmePath = join15(outRoot, "README.md");
-  if (!existsSync20(readmePath)) return;
+  if (!existsSync21(readmePath)) return;
   try {
     let content = await readFile6(readmePath, "utf-8");
     if (/##\s+Deploy\b/m.test(content)) return;
@@ -10925,16 +11111,16 @@ async function countPages(outRoot) {
     }
   }
   const appDir = join15(outRoot, "app");
-  if (existsSync20(appDir)) await walk(appDir);
+  if (existsSync21(appDir)) await walk(appDir);
   return n;
 }
 function countComponents(outRoot) {
   let n = 0;
   for (const sub of ["ui", "shared"]) {
     const dir = join15(outRoot, "components", sub);
-    if (!existsSync20(dir)) continue;
+    if (!existsSync21(dir)) continue;
     try {
-      n += readdirSync6(dir).filter((f) => f.endsWith(".tsx") || f.endsWith(".jsx")).length;
+      n += readdirSync7(dir).filter((f) => f.endsWith(".tsx") || f.endsWith(".jsx")).length;
     } catch {
     }
   }
@@ -10943,7 +11129,7 @@ function countComponents(outRoot) {
 var IMPORT_FROM_REGEX2 = /from\s+['"]([^'"]+)['"]/g;
 async function collectImportedPackages2(dir, extensions) {
   const packages = /* @__PURE__ */ new Set();
-  if (!existsSync20(dir)) return packages;
+  if (!existsSync21(dir)) return packages;
   async function walk(d) {
     const entries = await readdir3(d, { withFileTypes: true });
     for (const e of entries) {
@@ -10971,7 +11157,7 @@ async function collectImportedPackages2(dir, extensions) {
 }
 async function findMissingDepsInExport(outRoot) {
   const pkgPath = join15(outRoot, "package.json");
-  if (!existsSync20(pkgPath)) return [];
+  if (!existsSync21(pkgPath)) return [];
   let pkg;
   try {
     pkg = JSON.parse(await readFile6(pkgPath, "utf-8"));
@@ -10992,25 +11178,25 @@ async function stripCoherentArtifacts(outputDir) {
   const removed = [];
   for (const p of ["app/design-system", "app/api/design-system"]) {
     const full = join15(outputDir, p);
-    if (existsSync20(full)) {
+    if (existsSync21(full)) {
       rmSync4(full, { recursive: true, force: true });
       removed.push(p);
     }
   }
   const appNavPath = join15(outputDir, "app", "AppNav.tsx");
-  if (existsSync20(appNavPath)) {
+  if (existsSync21(appNavPath)) {
     rmSync4(appNavPath, { force: true });
     removed.push("app/AppNav.tsx");
   }
   const layoutPath = join15(outputDir, "app", "layout.tsx");
-  if (existsSync20(layoutPath)) {
+  if (existsSync21(layoutPath)) {
     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 writeFile5(layoutPath, layout, "utf-8");
   }
   const sharedHeaderPath = join15(outputDir, "components", "shared", "header.tsx");
-  if (existsSync20(sharedHeaderPath)) {
+  if (existsSync21(sharedHeaderPath)) {
     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");
@@ -11018,7 +11204,7 @@ async function stripCoherentArtifacts(outputDir) {
     await writeFile5(sharedHeaderPath, header, "utf-8");
   }
   const guardPath2 = join15(outputDir, "app", "ShowWhenNotAuthRoute.tsx");
-  if (existsSync20(guardPath2)) {
+  if (existsSync21(guardPath2)) {
     let guard = await readFile6(guardPath2, "utf-8");
     guard = guard.replace(/['"],?\s*'\/design-system['"],?\s*/g, "");
     const pathsMatch = guard.match(/HIDDEN_PATHS\s*=\s*\[([^\]]*)\]/);
@@ -11026,7 +11212,7 @@ async function stripCoherentArtifacts(outputDir) {
     if (remaining.length === 0) {
       rmSync4(guardPath2, { force: true });
       removed.push("app/ShowWhenNotAuthRoute.tsx");
-      if (existsSync20(layoutPath)) {
+      if (existsSync21(layoutPath)) {
         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");
@@ -11047,14 +11233,14 @@ async function stripCoherentArtifacts(outputDir) {
     "recommendations.md"
   ]) {
     const full = join15(outputDir, name);
-    if (existsSync20(full)) {
+    if (existsSync21(full)) {
       rmSync4(full, { force: true });
       removed.push(name);
     }
   }
   for (const dir of [".claude", ".coherent"]) {
     const full = join15(outputDir, dir);
-    if (existsSync20(full)) {
+    if (existsSync21(full)) {
       rmSync4(full, { recursive: true, force: true });
       removed.push(dir + "/");
     }
@@ -11062,7 +11248,7 @@ async function stripCoherentArtifacts(outputDir) {
   return removed;
 }
 async function exportCommand(options = {}) {
-  const outputDir = resolve11(process.cwd(), options.output ?? "./export");
+  const outputDir = resolve12(process.cwd(), options.output ?? "./export");
   const doBuild = options.build !== false;
   const keepDs = options.keepDs === true;
   const spinner = ora4("Preparing export...").start();
@@ -11078,7 +11264,7 @@ async function exportCommand(options = {}) {
       process.exit(1);
     }
     spinner.text = "Copying project...";
-    if (existsSync20(outputDir)) rmSync4(outputDir, { recursive: true, force: true });
+    if (existsSync21(outputDir)) rmSync4(outputDir, { recursive: true, force: true });
     await copyDir(projectRoot, outputDir);
     spinner.succeed("Project copied");
     if (!keepDs) {
@@ -11253,8 +11439,8 @@ async function regenerateDocsCommand() {
 
 // src/commands/fix.ts
 import chalk19 from "chalk";
-import { readdirSync as readdirSync7, readFileSync as readFileSync15, existsSync as existsSync21, writeFileSync as writeFileSync11, rmSync as rmSync5, mkdirSync as mkdirSync7 } from "fs";
-import { resolve as resolve12, join as join16 } from "path";
+import { readdirSync as readdirSync8, readFileSync as readFileSync16, existsSync as existsSync22, writeFileSync as writeFileSync11, rmSync as rmSync5, mkdirSync as mkdirSync7 } from "fs";
+import { resolve as resolve13, join as join16 } from "path";
 import {
   DesignSystemManager as DesignSystemManager11,
   ComponentManager as ComponentManager6,
@@ -11278,7 +11464,7 @@ function extractComponentIdsFromCode2(code) {
 function listTsxFiles(dir) {
   const files = [];
   try {
-    const entries = readdirSync7(dir, { withFileTypes: true });
+    const entries = readdirSync8(dir, { withFileTypes: true });
     for (const e of entries) {
       const full = join16(dir, e.name);
       if (e.isDirectory() && e.name !== "node_modules" && !e.name.startsWith(".")) {
@@ -11310,7 +11496,7 @@ async function fixCommand(opts = {}) {
   }
   if (!skipCache) {
     const nextDir = join16(projectRoot, ".next");
-    if (existsSync21(nextDir)) {
+    if (existsSync22(nextDir)) {
       if (!dryRun) rmSync5(nextDir, { recursive: true, force: true });
       fixes.push("Cleared build cache");
       console.log(chalk19.green("  \u2714 Cleared build cache"));
@@ -11332,12 +11518,12 @@ async function fixCommand(opts = {}) {
       }
     }
   }
-  const appDir = resolve12(projectRoot, "app");
+  const appDir = resolve13(projectRoot, "app");
   const allTsxFiles = listTsxFiles(appDir);
-  const componentsTsxFiles = listTsxFiles(resolve12(projectRoot, "components"));
+  const componentsTsxFiles = listTsxFiles(resolve13(projectRoot, "components"));
   const allComponentIds = /* @__PURE__ */ new Set();
   for (const file of [...allTsxFiles, ...componentsTsxFiles]) {
-    const content = readFileSync15(file, "utf-8");
+    const content = readFileSync16(file, "utf-8");
     extractComponentIdsFromCode2(content).forEach((id) => allComponentIds.add(id));
   }
   let dsm = null;
@@ -11356,8 +11542,8 @@ async function fixCommand(opts = {}) {
         missingComponents.push(id);
       } else {
         const fileName = toKebabCase(id) + ".tsx";
-        const filePath = resolve12(projectRoot, "components", "ui", fileName);
-        if (!existsSync21(filePath)) missingFiles.push(id);
+        const filePath = resolve13(projectRoot, "components", "ui", fileName);
+        if (!existsSync22(filePath)) missingFiles.push(id);
       }
     }
     const provider = getComponentProvider();
@@ -11386,8 +11572,8 @@ async function fixCommand(opts = {}) {
                 const generator = new ComponentGenerator4(updatedConfig);
                 const code = await generator.generate(component);
                 const fileName = toKebabCase(component.name) + ".tsx";
-                const filePath = resolve12(projectRoot, "components", "ui", fileName);
-                mkdirSync7(resolve12(projectRoot, "components", "ui"), { recursive: true });
+                const filePath = resolve13(projectRoot, "components", "ui", fileName);
+                mkdirSync7(resolve13(projectRoot, "components", "ui"), { recursive: true });
                 await writeFile(filePath, code);
               }
             }
@@ -11409,7 +11595,7 @@ async function fixCommand(opts = {}) {
   const userTsxFiles = allTsxFiles.filter((f) => !f.includes("/design-system/"));
   let syntaxFixed = 0;
   for (const file of userTsxFiles) {
-    const content = readFileSync15(file, "utf-8");
+    const content = readFileSync16(file, "utf-8");
     const fixed = fixUnescapedLtInJsx(
       fixEscapedClosingQuotes(sanitizeMetadataStrings(ensureUseClientIfNeeded(content)))
     );
@@ -11427,7 +11613,7 @@ async function fixCommand(opts = {}) {
     let qualityFixCount = 0;
     const qualityFixDetails = [];
     for (const file of userTsxFiles) {
-      const content = readFileSync15(file, "utf-8");
+      const content = readFileSync16(file, "utf-8");
       const { code: autoFixed, fixes: fileFixes } = await autoFixCode(content);
       if (autoFixed !== content) {
         if (!dryRun) writeFileSync11(file, autoFixed, "utf-8");
@@ -11446,7 +11632,7 @@ async function fixCommand(opts = {}) {
   let totalWarnings = 0;
   const fileIssues = [];
   for (const file of allTsxFiles) {
-    const code = dryRun ? readFileSync15(file, "utf-8") : readFileSync15(file, "utf-8");
+    const code = dryRun ? readFileSync16(file, "utf-8") : readFileSync16(file, "utf-8");
     const relativePath = file.replace(projectRoot + "/", "");
     const baseName = file.split("/").pop() || "";
     const isAuthPage = relativePath.includes("(auth)");
@@ -11568,17 +11754,17 @@ async function fixCommand(opts = {}) {
 
 // src/commands/check.ts
 import chalk20 from "chalk";
-import { resolve as resolve13 } from "path";
-import { readdirSync as readdirSync8, readFileSync as readFileSync16, statSync as statSync2, existsSync as existsSync22 } from "fs";
+import { resolve as resolve14 } from "path";
+import { readdirSync as readdirSync9, readFileSync as readFileSync17, statSync as statSync3, existsSync as existsSync23 } from "fs";
 import { loadManifest as loadManifest11 } from "@getcoherent/core";
 var EXCLUDED_DIRS = /* @__PURE__ */ new Set(["node_modules", "design-system"]);
 function findTsxFiles(dir) {
   const results = [];
   try {
-    const entries = readdirSync8(dir);
+    const entries = readdirSync9(dir);
     for (const entry of entries) {
-      const full = resolve13(dir, entry);
-      const stat = statSync2(full);
+      const full = resolve14(dir, entry);
+      const stat = statSync3(full);
       if (stat.isDirectory() && !entry.startsWith(".") && !EXCLUDED_DIRS.has(entry)) {
         results.push(...findTsxFiles(full));
       } else if (entry.endsWith(".tsx")) {
@@ -11612,7 +11798,7 @@ async function checkCommand(opts = {}) {
   } catch {
   }
   if (!skipPages) {
-    const appDir = resolve13(projectRoot, "app");
+    const appDir = resolve14(projectRoot, "app");
     const files = findTsxFiles(appDir);
     result.pages.total = files.length;
     if (!opts.json) console.log(chalk20.cyan("\n  \u{1F4C4} Pages") + chalk20.dim(` (${files.length} scanned)
@@ -11626,7 +11812,7 @@ async function checkCommand(opts = {}) {
       "NATIVE_TABLE"
     ]);
     for (const file of files) {
-      const code = readFileSync16(file, "utf-8");
+      const code = readFileSync17(file, "utf-8");
       const relativePath = file.replace(projectRoot + "/", "");
       const baseName = file.split("/").pop() || "";
       const isAuthPage = relativePath.includes("(auth)");
@@ -11668,7 +11854,7 @@ async function checkCommand(opts = {}) {
     routeSet.add("/");
     routeSet.add("#");
     for (const file of files) {
-      const code = readFileSync16(file, "utf-8");
+      const code = readFileSync17(file, "utf-8");
       const relativePath = file.replace(projectRoot + "/", "");
       const lines = code.split("\n");
       const linkHrefRe = /href\s*=\s*["'](\/[a-z0-9/-]*)["']/gi;
@@ -11700,8 +11886,8 @@ async function checkCommand(opts = {}) {
       const manifest = await loadManifest11(project.root);
       if (manifest.shared.length > 0) {
         for (const entry of manifest.shared) {
-          const fullPath = resolve13(project.root, entry.file);
-          if (!existsSync22(fullPath)) {
+          const fullPath = resolve14(project.root, entry.file);
+          if (!existsSync23(fullPath)) {
             result.pages.withErrors++;
             if (!opts.json) console.log(chalk20.red(`
   \u2717 Missing shared component file: ${entry.id} (${entry.file})`));
@@ -11725,8 +11911,8 @@ async function checkCommand(opts = {}) {
       let _staleUsedIn = 0;
       let _nameMismatch = 0;
       for (const entry of manifest.shared) {
-        const filePath = resolve13(projectRoot, entry.file);
-        const fileExists = existsSync22(filePath);
+        const filePath = resolve14(projectRoot, entry.file);
+        const fileExists = existsSync23(filePath);
         if (!fileExists) {
           _orphaned++;
           if (!opts.json) {
@@ -11736,7 +11922,7 @@ async function checkCommand(opts = {}) {
           continue;
         }
         try {
-          const code = readFileSync16(filePath, "utf-8");
+          const code = readFileSync17(filePath, "utf-8");
           const actualExports = extractExportedComponentNames(code);
           if (actualExports.length > 0 && !actualExports.includes(entry.name)) {
             _nameMismatch++;
@@ -11804,7 +11990,7 @@ async function checkCommand(opts = {}) {
           id: e.id,
           name: e.name,
           type: e.type,
-          status: existsSync22(resolve13(projectRoot, e.file)) ? "ok" : "unused",
+          status: existsSync23(resolve14(projectRoot, e.file)) ? "ok" : "unused",
           message: "",
           suggestions: void 0
         }))
@@ -11899,8 +12085,8 @@ import {
   generateSharedComponent as generateSharedComponent5,
   integrateSharedLayoutIntoRootLayout as integrateSharedLayoutIntoRootLayout3
 } from "@getcoherent/core";
-import { existsSync as existsSync23 } from "fs";
-import { resolve as resolve14 } from "path";
+import { existsSync as existsSync24 } from "fs";
+import { resolve as resolve15 } from "path";
 
 // src/utils/ds-files.ts
 import { mkdir as mkdir6, writeFile as writeFile6 } from "fs/promises";
@@ -12030,8 +12216,8 @@ function createComponentsCommand() {
       const updated = await integrateSharedLayoutIntoRootLayout3(project.root);
       if (updated) console.log(chalk26.cyan("   Updated app/layout.tsx to use shared layout components.\n"));
     }
-    const sharedPagePath = resolve14(project.root, "app/design-system/shared/page.tsx");
-    if (!existsSync23(sharedPagePath)) {
+    const sharedPagePath = resolve15(project.root, "app/design-system/shared/page.tsx");
+    if (!existsSync24(sharedPagePath)) {
       try {
         const dsm = new DesignSystemManager12(project.configPath);
         await dsm.load();
@@ -12057,8 +12243,8 @@ function createComponentsCommand() {
 import chalk27 from "chalk";
 import ora6 from "ora";
 import { writeFile as writeFile7, mkdir as mkdir7 } from "fs/promises";
-import { resolve as resolve15, join as join18, dirname as dirname9 } from "path";
-import { existsSync as existsSync24 } from "fs";
+import { resolve as resolve16, join as join18, dirname as dirname9 } from "path";
+import { existsSync as existsSync25 } from "fs";
 import {
   FigmaClient,
   parseFigmaFileResponse,
@@ -12282,7 +12468,7 @@ async function importFigmaAction(urlOrKey, opts) {
     if (dryRun) stats.filesWritten.push(FIGMA_COMPONENT_MAP_FILENAME);
     else
       await writeFile7(
-        resolve15(projectRoot, FIGMA_COMPONENT_MAP_FILENAME),
+        resolve16(projectRoot, FIGMA_COMPONENT_MAP_FILENAME),
         JSON.stringify(componentMapObj, null, 2),
         "utf-8"
       );
@@ -12305,9 +12491,9 @@ async function importFigmaAction(urlOrKey, opts) {
     const fullConfig = buildFigmaImportConfig(mergedConfig, pageDefs, intermediate.fileName);
     if (!dryRun) {
       spinner.start("Updating design-system.config.ts...");
-      const configPath = resolve15(projectRoot, DESIGN_SYSTEM_CONFIG_PATH);
+      const configPath = resolve16(projectRoot, DESIGN_SYSTEM_CONFIG_PATH);
       const dsm = new DesignSystemManager13(configPath);
-      if (existsSync24(configPath)) {
+      if (existsSync25(configPath)) {
         await dsm.load();
         const existing = dsm.getConfig();
         dsm.updateConfig({
@@ -12337,7 +12523,7 @@ export const config = ${JSON.stringify(fullConfig, null, 2)} as const
       spinner.succeed("design-system.config.ts updated");
       spinner.start("Ensuring root layout...");
       const layoutPath = join18(projectRoot, "app/layout.tsx");
-      if (!existsSync24(layoutPath)) {
+      if (!existsSync25(layoutPath)) {
         await mkdir7(dirname9(layoutPath), { recursive: true });
         await writeFile7(layoutPath, MINIMAL_ROOT_LAYOUT, "utf-8");
         stats.filesWritten.push("app/layout.tsx");
@@ -12427,7 +12613,7 @@ async function dsRegenerateCommand() {
 // src/commands/update.ts
 import chalk29 from "chalk";
 import ora8 from "ora";
-import { readFileSync as readFileSync17, existsSync as existsSync25 } from "fs";
+import { readFileSync as readFileSync18, existsSync as existsSync26 } from "fs";
 import { join as join19 } from "path";
 import { DesignSystemManager as DesignSystemManager15, CLI_VERSION as CLI_VERSION4 } from "@getcoherent/core";
 
@@ -12598,9 +12784,9 @@ var EXPECTED_CSS_VARS = [
 ];
 function checkMissingCssVars(projectRoot) {
   const globalsPath = join19(projectRoot, "app", "globals.css");
-  if (!existsSync25(globalsPath)) return [];
+  if (!existsSync26(globalsPath)) return [];
   try {
-    const content = readFileSync17(globalsPath, "utf-8");
+    const content = readFileSync18(globalsPath, "utf-8");
     return EXPECTED_CSS_VARS.filter((v) => !content.includes(v));
   } catch {
     return [];
@@ -12608,9 +12794,9 @@ function checkMissingCssVars(projectRoot) {
 }
 function patchGlobalsCss(projectRoot, missingVars) {
   const globalsPath = join19(projectRoot, "app", "globals.css");
-  if (!existsSync25(globalsPath) || missingVars.length === 0) return;
+  if (!existsSync26(globalsPath) || missingVars.length === 0) return;
   const { writeFileSync: writeFileSync14 } = __require("fs");
-  let content = readFileSync17(globalsPath, "utf-8");
+  let content = readFileSync18(globalsPath, "utf-8");
   const defaultValues = {
     "--chart-1": "220 70% 50%",
     "--chart-2": "160 60% 45%",
@@ -12688,7 +12874,7 @@ async function undoCommand(options) {
 // src/commands/sync.ts
 import chalk31 from "chalk";
 import ora9 from "ora";
-import { existsSync as existsSync26, readFileSync as readFileSync18 } from "fs";
+import { existsSync as existsSync27, readFileSync as readFileSync19 } from "fs";
 import { join as join20, 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";
@@ -12697,8 +12883,8 @@ function extractTokensFromProject(projectRoot) {
   const lightColors = {};
   const darkColors = {};
   const globalsPath = join20(projectRoot, "app", "globals.css");
-  if (existsSync26(globalsPath)) {
-    const css = readFileSync18(globalsPath, "utf-8");
+  if (existsSync27(globalsPath)) {
+    const css = readFileSync19(globalsPath, "utf-8");
     const rootMatch = css.match(/:root\s*\{([^}]+)\}/s);
     if (rootMatch) parseVarsInto(rootMatch[1], lightColors);
     const darkMatch = css.match(/\.dark\s*\{([^}]+)\}/s);
@@ -12706,8 +12892,8 @@ function extractTokensFromProject(projectRoot) {
   }
   const layoutPath = join20(projectRoot, "app", "layout.tsx");
   let layoutCode = "";
-  if (existsSync26(layoutPath)) {
-    layoutCode = readFileSync18(layoutPath, "utf-8");
+  if (existsSync27(layoutPath)) {
+    layoutCode = readFileSync19(layoutPath, "utf-8");
     const rootInline = layoutCode.match(/:root\s*\{([^}]+)\}/s);
     if (rootInline && Object.keys(lightColors).length === 0) {
       parseVarsInto(rootInline[1], lightColors);
@@ -12725,7 +12911,7 @@ function extractTokensFromProject(projectRoot) {
     defaultMode = "dark";
   }
   let radius;
-  const allCss = [existsSync26(globalsPath) ? readFileSync18(globalsPath, "utf-8") : "", layoutCode].join("\n");
+  const allCss = [existsSync27(globalsPath) ? readFileSync19(globalsPath, "utf-8") : "", layoutCode].join("\n");
   const radiusMatch = allCss.match(/--radius:\s*([^;]+);/);
   if (radiusMatch) radius = radiusMatch[1].trim();
   return {
@@ -12749,7 +12935,7 @@ function parseVarsInto(block, target) {
 async function detectCustomComponents(projectRoot, allPageCode) {
   const results = [];
   const componentsDir = join20(projectRoot, "components");
-  if (!existsSync26(componentsDir)) return results;
+  if (!existsSync27(componentsDir)) return results;
   const files = [];
   await walkForTsx(componentsDir, files, ["ui"]);
   const fileResults = await Promise.all(
@@ -12928,7 +13114,7 @@ async function syncCommand(options = {}) {
   const spinner = ora9("Scanning project files...").start();
   try {
     const appDir = join20(project.root, "app");
-    if (!existsSync26(appDir)) {
+    if (!existsSync27(appDir)) {
       spinner.fail("No app/ directory found");
       process.exit(1);
     }
@@ -13155,7 +13341,7 @@ async function syncCommand(options = {}) {
 // src/commands/migrate.ts
 import chalk32 from "chalk";
 import ora10 from "ora";
-import { existsSync as existsSync27, mkdirSync as mkdirSync8, cpSync, rmSync as rmSync6, writeFileSync as writeFileSync12, readFileSync as readFileSync19, readdirSync as readdirSync9 } from "fs";
+import { existsSync as existsSync28, mkdirSync as mkdirSync8, cpSync, rmSync as rmSync6, writeFileSync as writeFileSync12, readFileSync as readFileSync20, readdirSync as readdirSync10 } from "fs";
 import { join as join21 } from "path";
 function backupDir(projectRoot) {
   const ts = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
@@ -13168,11 +13354,11 @@ function createBackup2(projectRoot) {
   const uiDir = join21(projectRoot, "components", "ui");
   const dest = backupDir(projectRoot);
   mkdirSync8(dest, { recursive: true });
-  if (existsSync27(uiDir)) {
+  if (existsSync28(uiDir)) {
     cpSync(uiDir, join21(dest, "components-ui"), { recursive: true });
   }
   const configPath = join21(projectRoot, "design-system.config.ts");
-  if (existsSync27(configPath)) {
+  if (existsSync28(configPath)) {
     cpSync(configPath, join21(dest, "design-system.config.ts"));
   }
   return dest;
@@ -13184,24 +13370,24 @@ function setGuard(projectRoot, backupPath) {
 }
 function clearGuard(projectRoot) {
   const guard = guardPath(projectRoot);
-  if (existsSync27(guard)) rmSync6(guard);
+  if (existsSync28(guard)) rmSync6(guard);
 }
 function rollback(projectRoot) {
   const guard = guardPath(projectRoot);
-  if (!existsSync27(guard)) return false;
+  if (!existsSync28(guard)) return false;
   try {
-    const data = JSON.parse(readFileSync19(guard, "utf-8"));
+    const data = JSON.parse(readFileSync20(guard, "utf-8"));
     const backup = data.backup;
-    if (!existsSync27(backup)) return false;
+    if (!existsSync28(backup)) return false;
     const uiBackup = join21(backup, "components-ui");
     const uiDir = join21(projectRoot, "components", "ui");
-    if (existsSync27(uiBackup)) {
-      if (existsSync27(uiDir)) rmSync6(uiDir, { recursive: true });
+    if (existsSync28(uiBackup)) {
+      if (existsSync28(uiDir)) rmSync6(uiDir, { recursive: true });
       cpSync(uiBackup, uiDir, { recursive: true });
     }
     const configBackup = join21(backup, "design-system.config.ts");
     const configDest = join21(projectRoot, "design-system.config.ts");
-    if (existsSync27(configBackup)) {
+    if (existsSync28(configBackup)) {
       cpSync(configBackup, configDest);
     }
     clearGuard(projectRoot);
@@ -13229,19 +13415,19 @@ async function migrateAction(options) {
     return;
   }
   const guard = guardPath(projectRoot);
-  if (existsSync27(guard)) {
+  if (existsSync28(guard)) {
     console.log(chalk32.yellow("A migration is already in progress."));
     console.log(chalk32.dim("Run `coherent migrate --rollback` to undo, or delete .coherent/migration-in-progress"));
     return;
   }
   const uiDir = join21(projectRoot, "components", "ui");
-  if (!existsSync27(uiDir)) {
+  if (!existsSync28(uiDir)) {
     console.log(chalk32.yellow("No components/ui directory found. Nothing to migrate."));
     return;
   }
   const provider = getComponentProvider();
   const managedIds = new Set(provider.listNames());
-  const files = readdirSync9(uiDir).filter((f) => f.endsWith(".tsx"));
+  const files = readdirSync10(uiDir).filter((f) => f.endsWith(".tsx"));
   const migratable = files.map((f) => f.replace(".tsx", "")).filter((id) => managedIds.has(id));
   if (migratable.length === 0) {
     console.log(chalk32.green("All components are already up to date."));
@@ -13262,7 +13448,7 @@ Found ${migratable.length} component(s) to migrate:`));
   try {
     for (const id of migratable) {
       const filePath = join21(uiDir, `${id}.tsx`);
-      if (existsSync27(filePath)) rmSync6(filePath);
+      if (existsSync28(filePath)) rmSync6(filePath);
     }
     const results = await provider.installBatch(migratable, projectRoot, { force: true });
     let migrated = 0;
@@ -13284,7 +13470,7 @@ Found ${migratable.length} component(s) to migrate:`));
 }
 
 // src/utils/update-notifier.ts
-import { existsSync as existsSync28, mkdirSync as mkdirSync9, readFileSync as readFileSync20, writeFileSync as writeFileSync13 } from "fs";
+import { existsSync as existsSync29, mkdirSync as mkdirSync9, readFileSync as readFileSync21, writeFileSync as writeFileSync13 } from "fs";
 import { join as join22 } from "path";
 import { homedir } from "os";
 import chalk33 from "chalk";
@@ -13296,8 +13482,8 @@ var CACHE_FILE = join22(CACHE_DIR, "update-check.json");
 var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
 function readCache() {
   try {
-    if (!existsSync28(CACHE_FILE)) return null;
-    const raw = readFileSync20(CACHE_FILE, "utf-8");
+    if (!existsSync29(CACHE_FILE)) return null;
+    const raw = readFileSync21(CACHE_FILE, "utf-8");
     return JSON.parse(raw);
   } catch (e) {
     if (DEBUG5) console.error("Failed to read update cache:", e);
@@ -13306,7 +13492,7 @@ function readCache() {
 }
 function writeCache(data) {
   try {
-    if (!existsSync28(CACHE_DIR)) mkdirSync9(CACHE_DIR, { recursive: true });
+    if (!existsSync29(CACHE_DIR)) mkdirSync9(CACHE_DIR, { recursive: true });
     writeFileSync13(CACHE_FILE, JSON.stringify(data), "utf-8");
   } catch (e) {
     if (DEBUG5) console.error("Failed to write update cache:", e);