rafters 0.0.4 → 0.0.6

package/README.md

@@ -0,0 +1,130 @@
+# rafters
+
+Design Intelligence CLI. Scaffold tokens, add components, and serve an MCP server so AI agents build UIs with designer-level judgment instead of guessing.
+
+## Install
+
+```bash
+npx rafters init
+```
+
+Or install globally:
+
+```bash
+pnpm add -g rafters
+```
+
+## Commands
+
+### `rafters init`
+
+Initialize a project with design tokens. Detects your framework, scaffolds `.rafters/` with a complete token system, and generates output files.
+
+```bash
+rafters init              # Interactive setup
+rafters init --force      # Regenerate output from existing config
+rafters init --agent      # JSON output for CI/machine consumption
+```
+
+**Supported frameworks:** Next.js, Vite, Remix, React Router, Astro
+
+**Export formats** (configured during init):
+
+| Format | File | Default | Description |
+|--------|------|---------|-------------|
+| Tailwind CSS | `rafters.css` | Yes | CSS custom properties with `@theme` |
+| TypeScript | `rafters.ts` | Yes | Type-safe constants with JSDoc intelligence |
+| DTCG JSON | `rafters.json` | No | W3C Design Tokens standard format |
+| Compiled CSS | `rafters.compiled.css` | No | Pre-processed, no build step needed |
+
+Automatically detects and migrates existing shadcn/ui color values. Requires Tailwind v4.
+
+### `rafters add [components...]`
+
+Add components from the Rafters registry to your project.
+
+```bash
+rafters add button dialog    # Add specific components
+rafters add --list           # List all available components
+rafters add --overwrite      # Replace existing files
+```
+
+Components include embedded design intelligence: cognitive load ratings (1-7), accessibility requirements, do/never guidance, and trust-building patterns. Dependencies are resolved automatically.
+
+### `rafters studio`
+
+Launch Studio for visual token editing.
+
+```bash
+rafters studio
+```
+
+Opens a Vite-powered UI where you design by doing: pick a primary color, explain why, watch the system paint your scale. Every decision is recorded with reasoning so AI agents read intent instead of guessing.
+
+### `rafters mcp`
+
+Start the MCP server for AI agent access via stdio transport.
+
+```bash
+rafters mcp
+```
+
+## MCP Tools
+
+Four tools give AI agents complete design system access:
+
+### `rafters_vocabulary`
+
+System overview. Colors, spacing, typography, components, cognitive loads, and available patterns. Call this first to orient.
+
+### `rafters_pattern`
+
+Deep guidance for specific UI scenarios. Returns which components to use, which tokens to apply, accessibility requirements, and do/never rules.
+
+**Available patterns:** `destructive-action`, `form-validation`, `empty-state`, `loading-state`, `navigation-hierarchy`, `data-table`, `modal-dialog`, `tooltip-guidance`, `card-layout`, `dropdown-actions`
+
+### `rafters_component`
+
+Full intelligence for a specific component. Cognitive load rating, attention economics, accessibility requirements, trust-building patterns, variants, sizes, and primitives.
+
+### `rafters_token`
+
+Token dependency graph, derivation rules, and human override context. Returns how a token is computed, what it depends on, and whether a designer manually overrode it (with their reasoning).
+
+**Derivation rules:** `calc()`, `state:hover`, `scale:600`, `contrast:auto`, `invert`
+
+## How It Works
+
+Rafters is a Design Intelligence Protocol. AI agents don't have taste - they guess at colors, spacing, hierarchy. Rafters encodes a designer's judgment into queryable data so AI reads decisions instead of guessing.
+
+Three layers:
+
+- **What** (Components) - 55 React components with embedded intelligence metadata
+- **Where** (Tokens) - 240+ tokens with dependency graph and human override tracking
+- **Why** (Decisions) - Do/never patterns, cognitive load scores, trust patterns, accessibility requirements
+
+The token system uses OKLCH color space, modular scales based on musical ratios, and a dependency engine that automatically derives related values. When a designer overrides a computed value, the system records the reason so AI agents respect the intent.
+
+## Project Structure
+
+```
+.rafters/
+  config.rafters.json         # Framework paths and export settings
+  tokens/
+    color.rafters.json        # Color tokens with OKLCH values
+    spacing.rafters.json      # Spacing scale
+    typography.rafters.json   # Type scale
+  output/
+    rafters.css               # Tailwind CSS export
+    rafters.ts                # TypeScript constants
+```
+
+## Requirements
+
+- Node.js >= 24.12.0
+- Tailwind CSS v4
+- React >= 19.0.0
+
+## License
+
+MIT

package/dist/index.js

@@ -9,7 +9,7 @@ import { Command } from "commander";
 
 // src/commands/add.ts
 import { existsSync } from "fs";
-import { access, mkdir, writeFile } from "fs/promises";
+import { access, mkdir, readFile, writeFile } from "fs/promises";
 import { dirname, join as join2 } from "path";
 
 // ../../node_modules/.pnpm/zod@4.1.12/node_modules/zod/v4/classic/external.js
@@ -12730,7 +12730,7 @@ function setAgentMode(agent) {
 }
 function log(event) {
   if (context.agent) {
-    console.log(event);
+    console.log(JSON.stringify(event));
     return;
   }
   const eventType = event.event;
@@ -12748,13 +12748,14 @@ function log(event) {
       }
       context.spinner = ora("Generating tokens...").start();
       break;
-    case "init:shadcn_detected":
+    case "init:shadcn_detected": {
       context.spinner?.info("Found existing shadcn colors");
       console.log(`  Backed up: ${event.backupPath}`);
       const colors = event.colorsFound;
       console.log(`  Colors: ${colors.light} light, ${colors.dark} dark`);
       context.spinner = ora("Generating tokens...").start();
       break;
+    }
     case "init:generated":
       context.spinner?.succeed(`Generated ${event.tokenCount} tokens`);
       context.spinner = ora("Saving registry...").start();
@@ -12782,7 +12783,18 @@ function log(event) {
     case "init:colors_imported":
       console.log(`  Imported ${event.count} existing colors`);
       break;
-    case "init:complete":
+    case "init:exports_default":
+      console.log("  Using default exports (agent mode)");
+      break;
+    case "init:exports_selected":
+      context.spinner = ora("Generating outputs...").start();
+      break;
+    case "init:compiling_css":
+      if (context.spinner) {
+        context.spinner.text = "Compiling CSS with Tailwind...";
+      }
+      break;
+    case "init:complete": {
       context.spinner?.succeed("Done!");
       console.log(`
   Output: ${event.path}`);
@@ -12792,12 +12804,14 @@ function log(event) {
       }
       console.log("");
       break;
+    }
     // Add events
-    case "add:start":
+    case "add:start": {
       const components = event.components;
       context.spinner = ora(`Adding ${components.join(", ")}...`).start();
       break;
-    case "add:installed":
+    }
+    case "add:installed": {
       context.spinner?.succeed(`Installed ${event.component}`);
       const files = event.files;
       for (const file2 of files) {
@@ -12805,6 +12819,7 @@ function log(event) {
       }
       context.spinner = ora("Installing...").start();
       break;
+    }
     case "add:skip":
       context.spinner?.warn(`Skipped ${event.component} (already exists)`);
       context.spinner = ora("Installing...").start();
@@ -12843,7 +12858,7 @@ function log(event) {
 }
 function error46(message) {
   if (context.agent) {
-    console.error({ event: "error", message });
+    console.error(JSON.stringify({ event: "error", message }));
     return;
   }
   context.spinner?.fail(message);
@@ -12927,39 +12942,77 @@ async function isInitialized(cwd) {
     return false;
   }
 }
+async function loadConfig(cwd) {
+  const paths = getRaftersPaths(cwd);
+  try {
+    const content = await readFile(paths.config, "utf-8");
+    return JSON.parse(content);
+  } catch (err) {
+    if (existsSync(paths.config)) {
+      const message = err instanceof Error ? err.message : String(err);
+      log({ event: "add:warning", message: `Failed to load config: ${message}` });
+    }
+    return null;
+  }
+}
+function transformPath(registryPath, config3) {
+  if (!config3) return registryPath;
+  if (registryPath.startsWith("components/ui/")) {
+    return registryPath.replace("components/ui/", `${config3.componentsPath}/`);
+  }
+  if (registryPath.startsWith("lib/primitives/")) {
+    return registryPath.replace("lib/primitives/", `${config3.primitivesPath}/`);
+  }
+  return registryPath;
+}
 function fileExists(cwd, relativePath) {
   return existsSync(join2(cwd, relativePath));
 }
-function transformFileContent(content) {
+function transformFileContent(content, config3) {
   let transformed = content;
+  const componentsPath = config3?.componentsPath ?? "components/ui";
+  const primitivesPath = config3?.primitivesPath ?? "lib/primitives";
   transformed = transformed.replace(
     /from\s+['"]\.\.\/\.\.\/primitives\/([^'"]+)['"]/g,
-    "from '@/lib/primitives/$1'"
+    `from '@/${primitivesPath}/$1'`
   );
   transformed = transformed.replace(
     /from\s+['"]\.\.\/primitives\/([^'"]+)['"]/g,
-    "from '@/lib/primitives/$1'"
+    `from '@/${primitivesPath}/$1'`
+  );
+  transformed = transformed.replace(
+    /from\s+['"]\.\/([^'"]+)['"]/g,
+    `from '@/${componentsPath}/$1'`
+  );
+  const libPath = dirname(primitivesPath);
+  transformed = transformed.replace(
+    /from\s+['"]\.\.\/lib\/([^'"]+)['"]/g,
+    `from '@/${libPath}/$1'`
+  );
+  const componentsMatch = componentsPath.match(/^(.*)components\/ui$/);
+  const hooksPath = componentsMatch ? `${componentsMatch[1]}hooks`.replace(/^\//, "") : "hooks";
+  transformed = transformed.replace(
+    /from\s+['"]\.\.\/hooks\/([^'"]+)['"]/g,
+    `from '@/${hooksPath}/$1'`
   );
-  transformed = transformed.replace(/from\s+['"]\.\/([^'"]+)['"]/g, "from '@/components/ui/$1'");
-  transformed = transformed.replace(/from\s+['"]\.\.\/lib\/([^'"]+)['"]/g, "from '@/lib/$1'");
-  transformed = transformed.replace(/from\s+['"]\.\.\/hooks\/([^'"]+)['"]/g, "from '@/hooks/$1'");
   transformed = transformed.replace(
     /from\s+['"]\.\.\/(?!lib\/|hooks\/)([^'"]+)['"]/g,
-    "from '@/components/ui/$1'"
+    `from '@/${componentsPath}/$1'`
   );
   return transformed;
 }
-async function installItem(cwd, item, options) {
+async function installItem(cwd, item, options, config3) {
   const installedFiles = [];
   let skipped = false;
   for (const file2 of item.files) {
-    const targetPath = join2(cwd, file2.path);
-    if (fileExists(cwd, file2.path)) {
+    const projectPath = transformPath(file2.path, config3);
+    const targetPath = join2(cwd, projectPath);
+    if (fileExists(cwd, projectPath)) {
       if (!options.overwrite) {
         log({
           event: "add:skip",
           component: item.name,
-          file: file2.path,
+          file: projectPath,
           reason: "exists"
         });
         skipped = true;
@@ -12967,9 +13020,9 @@ async function installItem(cwd, item, options) {
       }
     }
     await mkdir(dirname(targetPath), { recursive: true });
-    const transformedContent = transformFileContent(file2.content);
+    const transformedContent = transformFileContent(file2.content, config3);
     await writeFile(targetPath, transformedContent, "utf-8");
-    installedFiles.push(file2.path);
+    installedFiles.push(projectPath);
   }
   return {
     installed: installedFiles.length > 0,
@@ -13001,6 +13054,7 @@ async function add(components, options) {
     process.exitCode = 1;
     return;
   }
+  const config3 = await loadConfig(cwd);
   if (components.length === 0) {
     error46("No components specified. Usage: rafters add <component...>");
     process.exitCode = 1;
@@ -13033,7 +13087,7 @@ async function add(components, options) {
   const skipped = [];
   for (const item of allItems) {
     try {
-      const result = await installItem(cwd, item, options);
+      const result = await installItem(cwd, item, options, config3);
       if (result.installed) {
         installed.push(item.name);
         log({
@@ -13089,9 +13143,10 @@ async function add(components, options) {
 }
 
 // src/commands/init.ts
-import { existsSync as existsSync2 } from "fs";
-import { copyFile, mkdir as mkdir3, readFile as readFile3, writeFile as writeFile3 } from "fs/promises";
-import { join as join8, relative } from "path";
+import { checkbox } from "@inquirer/prompts";
+import { existsSync as existsSync3 } from "fs";
+import { copyFile, mkdir as mkdir3, readFile as readFile4, writeFile as writeFile3 } from "fs/promises";
+import { join as join9, relative } from "path";
 
 // ../design-tokens/src/generation-rules.ts
 var GenerationRuleParser = class {
@@ -24121,7 +24176,7 @@ var require_volume = __commonJS({
     var Dir_1 = require_Dir();
     var resolveCrossPlatform = pathModule.resolve;
     var { O_RDONLY, O_WRONLY, O_RDWR, O_CREAT, O_EXCL, O_TRUNC, O_APPEND, O_DIRECTORY, O_SYMLINK, F_OK, COPYFILE_EXCL, COPYFILE_FICLONE_FORCE } = constants_1.constants;
-    var { sep: sep2, relative: relative2, join: join11, dirname: dirname4 } = pathModule.posix ? pathModule.posix : pathModule;
+    var { sep: sep2, relative: relative2, join: join12, dirname: dirname4 } = pathModule.posix ? pathModule.posix : pathModule;
     var kMinPoolSpace = 128;
     var EPERM = "EPERM";
     var ENOENT2 = "ENOENT";
@@ -24187,7 +24242,7 @@ var require_volume = __commonJS({
       function flatten(pathPrefix, node) {
         for (const path2 in node) {
           const contentOrNode = node[path2];
-          const joinedPath = join11(pathPrefix, path2);
+          const joinedPath = join12(pathPrefix, path2);
           if (typeof contentOrNode === "string" || contentOrNode instanceof buffer_1.Buffer) {
             flatJSON[joinedPath] = contentOrNode;
           } else if (typeof contentOrNode === "object" && contentOrNode !== null && Object.keys(contentOrNode).length > 0) {
@@ -24344,7 +24399,7 @@ var require_volume = __commonJS({
               return null;
           node = curr === null || curr === void 0 ? void 0 : curr.getNode();
           if (resolveSymlinks && node.isSymlink()) {
-            const resolvedPath = pathModule.isAbsolute(node.symlink) ? node.symlink : join11(pathModule.dirname(curr.getPath()), node.symlink);
+            const resolvedPath = pathModule.isAbsolute(node.symlink) ? node.symlink : join12(pathModule.dirname(curr.getPath()), node.symlink);
             steps = filenameToSteps(resolvedPath).concat(steps.slice(i + 1));
             curr = this.root;
             i = 0;
@@ -48960,7 +49015,7 @@ function buildColorSystem(options = {}) {
 }
 
 // ../design-tokens/src/persistence/node-adapter.ts
-import { access as access2, mkdir as mkdir2, readdir as readdir2, readFile, writeFile as writeFile2 } from "fs/promises";
+import { access as access2, mkdir as mkdir2, readdir as readdir2, readFile as readFile2, writeFile as writeFile2 } from "fs/promises";
 import { join as join5 } from "path";
 
 // ../../node_modules/.pnpm/comment-parser@1.4.1/node_modules/comment-parser/es6/primitives.js
@@ -49099,7 +49154,7 @@ function tagTokenizer() {
 
 // ../../node_modules/.pnpm/comment-parser@1.4.1/node_modules/comment-parser/es6/parser/tokenizers/type.js
 function typeTokenizer(spacing = "compact") {
-  const join11 = getJoiner(spacing);
+  const join12 = getJoiner(spacing);
   return (spec) => {
     let curlies = 0;
     let lines = [];
@@ -49142,7 +49197,7 @@ function typeTokenizer(spacing = "compact") {
     }
     parts[0] = parts[0].slice(1);
     parts[parts.length - 1] = parts[parts.length - 1].slice(0, -1);
-    spec.type = join11(parts);
+    spec.type = join12(parts);
     return spec;
   };
 }
@@ -49240,9 +49295,9 @@ function nameTokenizer() {
 
 // ../../node_modules/.pnpm/comment-parser@1.4.1/node_modules/comment-parser/es6/parser/tokenizers/description.js
 function descriptionTokenizer(spacing = "compact", markers = Markers) {
-  const join11 = getJoiner2(spacing);
+  const join12 = getJoiner2(spacing);
   return (spec) => {
-    spec.description = join11(spec.source, markers);
+    spec.description = join12(spec.source, markers);
     return spec;
   };
 }
@@ -49925,7 +49980,7 @@ var NodePersistenceAdapter = class {
   }
   async loadNamespace(namespace) {
     const filePath = this.getFilePath(namespace);
-    const content = await readFile(filePath, "utf-8");
+    const content = await readFile2(filePath, "utf-8");
     const json3 = JSON.parse(content);
     const data = NamespaceFileSchema.parse(json3);
     return data.tokens;
@@ -49985,16 +50040,19 @@ var RuleContextSchema = external_exports.object({
 });
 
 // src/utils/detect.ts
-import { readFile as readFile2 } from "fs/promises";
+import { readFile as readFile3 } from "fs/promises";
 import { join as join7 } from "path";
 async function detectFramework(cwd) {
   try {
-    const content = await readFile2(join7(cwd, "package.json"), "utf-8");
+    const content = await readFile3(join7(cwd, "package.json"), "utf-8");
     const pkg = JSON.parse(content);
     const deps = { ...pkg.dependencies, ...pkg.devDependencies };
     if (deps.next) {
       return "next";
     }
+    if (deps["react-router"]) {
+      return "react-router";
+    }
     const hasRemix = Object.keys(deps).some((dep) => dep.startsWith("@remix-run/"));
     if (hasRemix) {
       return "remix";
@@ -50012,7 +50070,7 @@ async function detectFramework(cwd) {
 }
 async function detectTailwindVersion(cwd) {
   try {
-    const content = await readFile2(join7(cwd, "package.json"), "utf-8");
+    const content = await readFile3(join7(cwd, "package.json"), "utf-8");
     const pkg = JSON.parse(content);
     const deps = { ...pkg.dependencies, ...pkg.devDependencies };
     const tailwindVersion = deps.tailwindcss;
@@ -50033,7 +50091,7 @@ function isTailwindV3(version2) {
 }
 async function detectShadcn(cwd) {
   try {
-    const content = await readFile2(join7(cwd, "components.json"), "utf-8");
+    const content = await readFile3(join7(cwd, "components.json"), "utf-8");
     return JSON.parse(content);
   } catch {
     return null;
@@ -50095,6 +50153,79 @@ async function detectProject(cwd) {
   };
 }
 
+// src/utils/exports.ts
+import { execFileSync } from "child_process";
+import { existsSync as existsSync2 } from "fs";
+import { join as join8 } from "path";
+var DEFAULT_EXPORTS = {
+  tailwind: true,
+  typescript: true,
+  dtcg: false,
+  compiled: false
+};
+var EXPORT_CHOICES = [
+  {
+    name: "Tailwind CSS (web projects)",
+    value: "tailwind",
+    checked: true
+  },
+  {
+    name: "TypeScript (type-safe constants)",
+    value: "typescript",
+    checked: true
+  },
+  {
+    name: "DTCG JSON (Figma Tokens, Style Dictionary)",
+    value: "dtcg",
+    checked: false
+  },
+  {
+    name: "Compiled CSS (documentation, no build step)",
+    value: "compiled",
+    checked: false
+  }
+];
+var FUTURE_EXPORTS = [
+  {
+    name: "iOS (Swift/SwiftUI)",
+    value: "tailwind",
+    // placeholder
+    checked: false,
+    disabled: "coming soon"
+  },
+  {
+    name: "Android (Compose)",
+    value: "tailwind",
+    // placeholder
+    checked: false,
+    disabled: "coming soon"
+  }
+];
+async function generateCompiledCss(cwd, inputPath, outputPath) {
+  const nodeModulesBin = join8(cwd, "node_modules", ".bin", "tailwindcss");
+  const hasTailwindCli = existsSync2(nodeModulesBin);
+  const args = ["-i", inputPath, "-o", outputPath, "--minify"];
+  if (hasTailwindCli) {
+    execFileSync(nodeModulesBin, args, { cwd, stdio: "pipe" });
+  } else {
+    try {
+      execFileSync("pnpm", ["exec", "tailwindcss", ...args], { cwd, stdio: "pipe" });
+    } catch {
+      throw new Error(
+        "Tailwind CLI not found. Install it with: pnpm add -D @tailwindcss/cli"
+      );
+    }
+  }
+}
+function selectionsToConfig(selections) {
+  return {
+    tailwind: selections.includes("tailwind"),
+    typescript: selections.includes("typescript"),
+    dtcg: selections.includes("dtcg"),
+    compiled: selections.includes("compiled")
+  };
+}
+
 // src/commands/init.ts
 async function backupCss(cssPath) {
   const backupPath = cssPath.replace(/\.css$/, ".backup.css");
@@ -50106,25 +50237,34 @@ var CSS_LOCATIONS = {
   next: ["src/app/globals.css", "app/globals.css", "styles/globals.css"],
   vite: ["src/index.css", "src/main.css", "src/styles.css", "src/app.css"],
   remix: ["app/styles/global.css", "app/globals.css", "app/root.css"],
+  "react-router": ["app/app.css", "app/root.css", "app/styles.css", "app/globals.css"],
   unknown: ["src/styles/global.css", "src/index.css", "styles/globals.css"]
 };
+var COMPONENT_PATHS = {
+  astro: { components: "src/components/ui", primitives: "src/lib/primitives" },
+  next: { components: "components/ui", primitives: "lib/primitives" },
+  vite: { components: "src/components/ui", primitives: "src/lib/primitives" },
+  remix: { components: "app/components/ui", primitives: "app/lib/primitives" },
+  "react-router": { components: "app/components/ui", primitives: "app/lib/primitives" },
+  unknown: { components: "components/ui", primitives: "lib/primitives" }
+};
 async function findMainCssFile(cwd, framework) {
   const locations = CSS_LOCATIONS[framework] || CSS_LOCATIONS.unknown;
   for (const location of locations) {
-    const fullPath = join8(cwd, location);
-    if (existsSync2(fullPath)) {
+    const fullPath = join9(cwd, location);
+    if (existsSync3(fullPath)) {
       return location;
     }
   }
   return null;
 }
 async function updateMainCss(cwd, cssPath, themePath) {
-  const fullCssPath = join8(cwd, cssPath);
-  const cssContent = await readFile3(fullCssPath, "utf-8");
-  const cssDir = join8(cwd, cssPath, "..");
-  const themeFullPath = join8(cwd, themePath);
+  const fullCssPath = join9(cwd, cssPath);
+  const cssContent = await readFile4(fullCssPath, "utf-8");
+  const cssDir = join9(cwd, cssPath, "..");
+  const themeFullPath = join9(cwd, themePath);
   const relativeThemePath = relative(cssDir, themeFullPath);
-  if (cssContent.includes(".rafters/output/theme.css")) {
+  if (cssContent.includes(".rafters/output/rafters.css")) {
     log({ event: "init:css_already_imported", cssPath });
     return;
   }
@@ -50146,8 +50286,66 @@ ${cssContent}`;
     themePath: relativeThemePath
   });
 }
-async function regenerateFromExisting(cwd, paths, shadcn) {
+async function promptExportFormats(existingConfig) {
+  const choices = EXPORT_CHOICES.map((choice) => ({
+    name: choice.name,
+    value: choice.value,
+    checked: existingConfig ? existingConfig[choice.value] : choice.checked
+  }));
+  const allChoices = [
+    ...choices,
+    ...FUTURE_EXPORTS.map((choice) => ({
+      name: `${choice.name} (${choice.disabled})`,
+      value: choice.value,
+      checked: false,
+      disabled: true
+    }))
+  ];
+  const selections = await checkbox({
+    message: "What would you like to export?",
+    choices: allChoices,
+    required: true
+  });
+  return selectionsToConfig(selections);
+}
+async function generateOutputs(cwd, paths, registry2, exports, shadcn) {
+  const outputs = [];
+  if (exports.tailwind) {
+    const tailwindCss = registryToTailwind(registry2, { includeImport: !shadcn });
+    await writeFile3(join9(paths.output, "rafters.css"), tailwindCss);
+    outputs.push("rafters.css");
+  }
+  if (exports.typescript) {
+    const typescriptSrc = registryToTypeScript(registry2, { includeJSDoc: true });
+    await writeFile3(join9(paths.output, "rafters.ts"), typescriptSrc);
+    outputs.push("rafters.ts");
+  }
+  if (exports.dtcg) {
+    const dtcgJson = toDTCG(registry2.list());
+    await writeFile3(join9(paths.output, "rafters.json"), JSON.stringify(dtcgJson, null, 2));
+    outputs.push("rafters.json");
+  }
+  if (exports.compiled) {
+    if (!exports.tailwind) {
+      const tailwindCss = registryToTailwind(registry2, { includeImport: !shadcn });
+      await writeFile3(join9(paths.output, "rafters.css"), tailwindCss);
+    }
+    const inputPath = join9(paths.output, "rafters.css");
+    const outputPath = join9(paths.output, "rafters.compiled.css");
+    log({ event: "init:compiling_css" });
+    await generateCompiledCss(cwd, inputPath, outputPath);
+    outputs.push("rafters.compiled.css");
+  }
+  return outputs;
+}
+async function regenerateFromExisting(cwd, paths, shadcn, isAgentMode) {
   log({ event: "init:regenerate", cwd });
+  let existingConfig = null;
+  try {
+    const configContent = await readFile4(paths.config, "utf-8");
+    existingConfig = JSON.parse(configContent);
+  } catch {
+  }
   const adapter = new NodePersistenceAdapter(cwd);
   const namespaces = await adapter.listNamespaces();
   if (namespaces.length === 0) {
@@ -50164,21 +50362,27 @@ async function regenerateFromExisting(cwd, paths, shadcn) {
     namespaces
   });
   const registry2 = new TokenRegistry(allTokens);
-  const tailwindCss = registryToTailwind(registry2, { includeImport: !shadcn });
-  const typescriptSrc = registryToTypeScript(registry2, { includeJSDoc: true });
-  const dtcgJson = toDTCG(allTokens);
+  let exports;
+  if (isAgentMode) {
+    exports = existingConfig?.exports ?? DEFAULT_EXPORTS;
+  } else {
+    exports = await promptExportFormats(existingConfig?.exports);
+  }
   await mkdir3(paths.output, { recursive: true });
-  await writeFile3(join8(paths.output, "theme.css"), tailwindCss);
-  await writeFile3(join8(paths.output, "tokens.ts"), typescriptSrc);
-  await writeFile3(join8(paths.output, "tokens.json"), JSON.stringify(dtcgJson, null, 2));
+  const outputs = await generateOutputs(cwd, paths, registry2, exports, shadcn);
+  if (existingConfig) {
+    existingConfig.exports = exports;
+    await writeFile3(paths.config, JSON.stringify(existingConfig, null, 2));
+  }
   log({
     event: "init:complete",
-    outputs: ["theme.css", "tokens.ts", "tokens.json"],
+    outputs,
     path: paths.output
   });
 }
 async function init(options) {
   setAgentMode(options.agent ?? false);
+  const isAgentMode = options.agent ?? false;
   const cwd = process.cwd();
   const paths = getRaftersPaths(cwd);
   log({ event: "init:start", cwd });
@@ -50192,21 +50396,21 @@ async function init(options) {
   if (isTailwindV3(tailwindVersion)) {
     throw new Error("Tailwind v3 detected. Rafters requires Tailwind v4.");
   }
-  const raftersExists = existsSync2(paths.root);
+  const raftersExists = existsSync3(paths.root);
   if (raftersExists && !options.force) {
     throw new Error(
       ".rafters/ directory already exists. Use --force to regenerate output files from existing config."
     );
   }
   if (raftersExists && options.force) {
-    await regenerateFromExisting(cwd, paths, shadcn);
+    await regenerateFromExisting(cwd, paths, shadcn, isAgentMode);
     return;
   }
   let existingColors = null;
   if (shadcn?.tailwind?.css) {
-    const cssPath = join8(cwd, shadcn.tailwind.css);
+    const cssPath = join9(cwd, shadcn.tailwind.css);
     try {
-      const cssContent = await readFile3(cssPath, "utf-8");
+      const cssContent = await readFile4(cssPath, "utf-8");
       existingColors = parseCssVariables(cssContent);
       const backupPath = await backupCss(cssPath);
       log({
@@ -50222,6 +50426,14 @@ async function init(options) {
       log({ event: "init:shadcn_css_error", error: String(err) });
     }
   }
+  let exports;
+  if (isAgentMode) {
+    exports = DEFAULT_EXPORTS;
+    log({ event: "init:exports_default", exports });
+  } else {
+    exports = await promptExportFormats();
+    log({ event: "init:exports_selected", exports });
+  }
   const result = buildColorSystem({
     exports: {
       tailwind: { includeImport: !shadcn },
@@ -50285,27 +50497,34 @@ async function init(options) {
     path: paths.tokens,
     namespaceCount: tokensByNamespace.size
   });
-  const tailwindCss = registryToTailwind(registry2, { includeImport: !shadcn });
-  const typescriptSrc = registryToTypeScript(registry2, { includeJSDoc: true });
-  const dtcgJson = toDTCG(registry2.list());
-  await writeFile3(join8(paths.output, "theme.css"), tailwindCss);
-  await writeFile3(join8(paths.output, "tokens.ts"), typescriptSrc);
-  await writeFile3(join8(paths.output, "tokens.json"), JSON.stringify(dtcgJson, null, 2));
-  if (!shadcn) {
-    const mainCssPath = await findMainCssFile(cwd, framework);
-    if (mainCssPath) {
-      await updateMainCss(cwd, mainCssPath, ".rafters/output/theme.css");
+  const outputs = await generateOutputs(cwd, paths, registry2, exports, shadcn);
+  let detectedCssPath = null;
+  if (!shadcn && exports.tailwind) {
+    detectedCssPath = await findMainCssFile(cwd, framework);
+    if (detectedCssPath) {
+      await updateMainCss(cwd, detectedCssPath, ".rafters/output/rafters.css");
     } else {
       log({
         event: "init:css_not_found",
-        message: 'No main CSS file found. Add @import ".rafters/output/theme.css" manually.',
+        message: 'No main CSS file found. Add @import ".rafters/output/rafters.css" manually.',
         searchedLocations: CSS_LOCATIONS[framework] || CSS_LOCATIONS.unknown
       });
     }
+  } else if (shadcn?.tailwind?.css) {
+    detectedCssPath = shadcn.tailwind.css;
   }
+  const frameworkPaths = COMPONENT_PATHS[framework] || COMPONENT_PATHS.unknown;
+  const config3 = {
+    framework,
+    componentsPath: frameworkPaths.components,
+    primitivesPath: frameworkPaths.primitives,
+    cssPath: detectedCssPath,
+    exports
+  };
+  await writeFile3(paths.config, JSON.stringify(config3, null, 2));
   log({
     event: "init:complete",
-    outputs: ["theme.css", "tokens.ts", "tokens.json"],
+    outputs: [...outputs, "config.rafters.json"],
     path: paths.output
   });
 }
@@ -50316,8 +50535,8 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 
 // src/mcp/tools.ts
-import { readdir as readdir3, readFile as readFile4 } from "fs/promises";
-import { basename, join as join9 } from "path";
+import { readdir as readdir3, readFile as readFile5 } from "fs/promises";
+import { basename, join as join10 } from "path";
 var DESIGN_PATTERNS = {
   "destructive-action": {
     name: "Destructive Action",
@@ -50867,7 +51086,7 @@ var RaftersToolHandler = class {
    * Get path to UI components directory
    */
   getComponentsPath() {
-    const monorepoPath = join9(this.projectRoot, "packages/ui/src/components/ui");
+    const monorepoPath = join10(this.projectRoot, "packages/ui/src/components/ui");
     return monorepoPath;
   }
   /**
@@ -50875,9 +51094,9 @@ var RaftersToolHandler = class {
    */
   async loadComponentMetadata(name2) {
     const componentsPath = this.getComponentsPath();
-    const filePath = join9(componentsPath, `${name2}.tsx`);
+    const filePath = join10(componentsPath, `${name2}.tsx`);
     try {
-      const source = await readFile4(filePath, "utf-8");
+      const source = await readFile5(filePath, "utf-8");
       const intelligence = parseJSDocIntelligence(source);
       const description = parseDescription(source);
       const metadata = {
@@ -51227,22 +51446,22 @@ async function mcp() {
 }
 
 // src/commands/studio.ts
-import { existsSync as existsSync3 } from "fs";
-import { dirname as dirname3, join as join10 } from "path";
+import { existsSync as existsSync4 } from "fs";
+import { dirname as dirname3, join as join11 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import { execa as execa2 } from "execa";
 var __dirname2 = dirname3(fileURLToPath3(import.meta.url));
 async function studio() {
   const cwd = process.cwd();
   const paths = getRaftersPaths(cwd);
-  if (!existsSync3(paths.root)) {
+  if (!existsSync4(paths.root)) {
     console.error('No .rafters/ directory found. Run "rafters init" first.');
     process.exit(1);
   }
-  const devStudioPath = join10(__dirname2, "..", "..", "..", "studio");
-  const prodStudioPath = join10(__dirname2, "..", "node_modules", "@rafters", "studio");
-  const studioPath = existsSync3(devStudioPath) ? devStudioPath : prodStudioPath;
-  if (!existsSync3(studioPath)) {
+  const devStudioPath = join11(__dirname2, "..", "..", "..", "studio");
+  const prodStudioPath = join11(__dirname2, "..", "node_modules", "@rafters", "studio");
+  const studioPath = existsSync4(devStudioPath) ? devStudioPath : prodStudioPath;
+  if (!existsSync4(studioPath)) {
     console.error("Studio package not found. Please reinstall @rafters/cli.");
     process.exit(1);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rafters",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "CLI for Rafters design system - scaffold tokens and add components",
   "type": "module",
   "bin": {
@@ -14,6 +14,7 @@
   ],
   "dependencies": {
     "@antfu/ni": "^28.1.0",
+    "@inquirer/prompts": "^8.2.0",
     "@modelcontextprotocol/sdk": "^1.25.1",
     "commander": "^13.0.0",
     "execa": "^9.6.1",