rafters 0.0.7 → 0.0.8

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ezmode Games
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -2,32 +2,28 @@
 
 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
+## Quick Start
 
 ```bash
-npx rafters init
+pnpm dlx rafters init
 ```
 
-Or install globally:
-
-```bash
-pnpm add -g rafters
-```
+This detects your framework, scaffolds `.rafters/` with a complete token system, and generates output files.
 
 ## Commands
 
 ### `rafters init`
 
-Initialize a project with design tokens. Detects your framework, scaffolds `.rafters/` with a complete token system, and generates output files.
+Initialize a project with design tokens.
 
 ```bash
-rafters init              # Interactive setup
-rafters init --rebuild    # Regenerate output files from existing tokens
-rafters init --reset      # Re-run generators fresh, replacing persisted tokens
-rafters init --agent      # JSON output for CI/machine consumption
+pnpm dlx rafters init              # Interactive setup
+pnpm dlx rafters init --rebuild    # Regenerate output files from existing tokens
+pnpm dlx rafters init --reset      # Re-run generators fresh, replacing persisted tokens
+pnpm dlx rafters init --agent      # JSON output for CI/machine consumption
 ```
 
-**Supported frameworks:** Next.js, Vite, Remix, React Router, Astro
+**Detected frameworks:** Next.js, Vite, Remix, React Router, Astro
 
 **Export formats** (configured during init):
 
@@ -45,29 +41,27 @@ Automatically detects and migrates existing shadcn/ui color values. Requires Tai
 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
+pnpm dlx rafters add button dialog    # Add specific components
+pnpm dlx rafters add --list           # List all available components
+pnpm dlx 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`
+### `rafters mcp`
 
-Launch Studio for visual token editing.
+Start the MCP server for AI agent access via stdio transport.
 
 ```bash
-rafters studio
+pnpm dlx rafters mcp
 ```
 
-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`
+### `rafters studio`
 
-Start the MCP server for AI agent access via stdio transport.
+Launch Studio for visual token editing. Spawns a local Vite dev server from the `@rafters/studio` package.
 
 ```bash
-rafters mcp
+pnpm dlx rafters studio
 ```
 
 ## MCP Tools
@@ -96,13 +90,13 @@ Token dependency graph, derivation rules, and human override context. Returns ho
 
 ## 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.
+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
+- **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.
 

package/dist/index.js

@@ -12735,6 +12735,9 @@ var context = {
 function setAgentMode(agent) {
   context.agent = agent;
 }
+function isAgentMode() {
+  return context.agent;
+}
 function log(event) {
   if (context.agent) {
     console.log(JSON.stringify(event));
@@ -12888,6 +12891,20 @@ function error46(message) {
   context.spinner?.fail(message);
   context.spinner = null;
 }
+function withErrorHandler(action) {
+  return async (...args) => {
+    try {
+      await action(...args);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      error46(message);
+      if (process.env.DEBUG && err instanceof Error && err.stack) {
+        console.error(err.stack);
+      }
+      process.exitCode = 1;
+    }
+  };
+}
 
 // src/utils/update-dependencies.ts
 import { execa } from "execa";
@@ -13183,8 +13200,9 @@ async function add(components, options) {
 // src/commands/init.ts
 import { existsSync as existsSync2 } from "fs";
 import { copyFile, mkdir as mkdir3, readFile as readFile4, rm, writeFile as writeFile3 } from "fs/promises";
+import { createRequire } from "module";
 import { join as join8, relative } from "path";
-import { checkbox } from "@inquirer/prompts";
+import { checkbox, confirm } from "@inquirer/prompts";
 
 // ../design-tokens/src/plugins/scale.ts
 function scale(registry2, tokenName, dependencies) {
@@ -46488,8 +46506,8 @@ async function registryToCompiled(registry2, options = {}) {
   const { execFileSync } = await import("child_process");
   const { mkdtempSync, writeFileSync, readFileSync, rmSync } = await import("fs");
   const { join: join11, dirname: dirname4 } = await import("path");
-  const { createRequire } = await import("module");
-  const require2 = createRequire(import.meta.url);
+  const { createRequire: createRequire2 } = await import("module");
+  const require2 = createRequire2(import.meta.url);
   let pkgDir;
   try {
     const pkgJsonPath = require2.resolve("@tailwindcss/cli/package.json");
@@ -50634,7 +50652,39 @@ async function promptExportFormats(existingConfig) {
   });
   return selectionsToConfig(selections);
 }
-async function generateOutputs(paths, registry2, exports, shadcn) {
+function isTailwindCliInstalled() {
+  const require2 = createRequire(import.meta.url);
+  try {
+    require2.resolve("@tailwindcss/cli/package.json");
+    return true;
+  } catch (err) {
+    if (err instanceof Error && "code" in err && err.code === "MODULE_NOT_FOUND") {
+      return false;
+    }
+    throw err;
+  }
+}
+async function ensureTailwindCli(cwd) {
+  if (!isInteractive() || isAgentMode()) {
+    throw new Error(
+      "Standalone CSS export requires @tailwindcss/cli. Install it as a dev dependency in your project."
+    );
+  }
+  const shouldInstall = await confirm({
+    message: "Standalone CSS requires @tailwindcss/cli. Install it now?",
+    default: true
+  });
+  if (!shouldInstall) {
+    throw new Error("Standalone CSS export requires @tailwindcss/cli.");
+  }
+  await updateDependencies([], ["@tailwindcss/cli"], { cwd });
+  if (!isTailwindCliInstalled()) {
+    throw new Error(
+      "@tailwindcss/cli was installed but cannot be resolved. Try installing at the workspace root."
+    );
+  }
+}
+async function generateOutputs(cwd, paths, registry2, exports, shadcn) {
   const outputs = [];
   if (exports.tailwind) {
     const tailwindCss = registryToTailwind(registry2, { includeImport: !shadcn });
@@ -50652,6 +50702,9 @@ async function generateOutputs(paths, registry2, exports, shadcn) {
     outputs.push("rafters.json");
   }
   if (exports.compiled) {
+    if (!isTailwindCliInstalled()) {
+      await ensureTailwindCli(cwd);
+    }
     log({ event: "init:compiling_css" });
     const compiledCss = await registryToCompiled(registry2, { includeImport: !shadcn });
     await writeFile3(join8(paths.output, "rafters.standalone.css"), compiledCss);
@@ -50659,7 +50712,7 @@ async function generateOutputs(paths, registry2, exports, shadcn) {
   }
   return outputs;
 }
-async function regenerateFromExisting(cwd, paths, shadcn, isAgentMode) {
+async function regenerateFromExisting(cwd, paths, shadcn, isAgentMode2) {
   log({ event: "init:regenerate", cwd });
   let existingConfig = null;
   try {
@@ -50680,7 +50733,7 @@ async function regenerateFromExisting(cwd, paths, shadcn, isAgentMode) {
   });
   const registry2 = new TokenRegistry(allTokens);
   let exports;
-  if (isAgentMode) {
+  if (isAgentMode2) {
     exports = existingConfig?.exports ?? DEFAULT_EXPORTS;
     log({ event: "init:exports_default", exports });
   } else {
@@ -50691,7 +50744,7 @@ async function regenerateFromExisting(cwd, paths, shadcn, isAgentMode) {
     log({ event: "init:exports_selected", exports });
   }
   await mkdir3(paths.output, { recursive: true });
-  const outputs = await generateOutputs(paths, registry2, exports, shadcn);
+  const outputs = await generateOutputs(cwd, paths, registry2, exports, shadcn);
   if (existingConfig) {
     existingConfig.exports = exports;
     await writeFile3(paths.config, JSON.stringify(existingConfig, null, 2));
@@ -50702,7 +50755,7 @@ async function regenerateFromExisting(cwd, paths, shadcn, isAgentMode) {
     path: paths.output
   });
 }
-async function resetToDefaults(cwd, paths, shadcn, isAgentMode) {
+async function resetToDefaults(cwd, paths, shadcn, isAgentMode2) {
   log({ event: "init:reset", cwd });
   let existingConfig = null;
   try {
@@ -50735,7 +50788,7 @@ async function resetToDefaults(cwd, paths, shadcn, isAgentMode) {
     });
   }
   let exports;
-  if (isAgentMode) {
+  if (isAgentMode2) {
     exports = existingConfig?.exports ?? DEFAULT_EXPORTS;
     log({ event: "init:exports_default", exports });
   } else {
@@ -50768,7 +50821,7 @@ async function resetToDefaults(cwd, paths, shadcn, isAgentMode) {
     namespaceCount
   });
   await mkdir3(paths.output, { recursive: true });
-  const outputs = await generateOutputs(paths, registry2, exports, shadcn);
+  const outputs = await generateOutputs(cwd, paths, registry2, exports, shadcn);
   if (existingConfig) {
     existingConfig.exports = exports;
     await writeFile3(paths.config, JSON.stringify(existingConfig, null, 2));
@@ -50781,7 +50834,7 @@ async function resetToDefaults(cwd, paths, shadcn, isAgentMode) {
 }
 async function init(options) {
   setAgentMode(options.agent ?? false);
-  const isAgentMode = options.agent ?? false;
+  const isAgentMode2 = options.agent ?? false;
   const cwd = process.cwd();
   const paths = getRaftersPaths(cwd);
   log({ event: "init:start", cwd });
@@ -50800,7 +50853,7 @@ async function init(options) {
     throw new Error("Nothing to reset. No .rafters/ directory found.");
   }
   if (raftersExists && options.reset) {
-    await resetToDefaults(cwd, paths, shadcn, isAgentMode);
+    await resetToDefaults(cwd, paths, shadcn, isAgentMode2);
     return;
   }
   if (raftersExists && !options.rebuild) {
@@ -50809,7 +50862,7 @@ async function init(options) {
     );
   }
   if (raftersExists && options.rebuild) {
-    await regenerateFromExisting(cwd, paths, shadcn, isAgentMode);
+    await regenerateFromExisting(cwd, paths, shadcn, isAgentMode2);
     return;
   }
   let existingColors = null;
@@ -50833,7 +50886,7 @@ async function init(options) {
     }
   }
   let exports;
-  if (isAgentMode) {
+  if (isAgentMode2) {
     exports = DEFAULT_EXPORTS;
     log({ event: "init:exports_default", exports });
   } else {
@@ -50899,7 +50952,7 @@ async function init(options) {
     path: paths.tokens,
     namespaceCount
   });
-  const outputs = await generateOutputs(paths, registry2, exports, shadcn);
+  const outputs = await generateOutputs(cwd, paths, registry2, exports, shadcn);
   let detectedCssPath = null;
   if (!shadcn && exports.tailwind) {
     detectedCssPath = await findMainCssFile(cwd, framework);
@@ -51896,8 +51949,8 @@ async function studio() {
 // src/index.ts
 var program = new Command();
 program.name("rafters").description("Design system CLI - scaffold tokens and serve MCP").version("0.0.1");
-program.command("init").description("Initialize .rafters/ with default tokens and config").option("-r, --rebuild", "Regenerate output files from existing tokens").option("--reset", "Re-run generators fresh, replacing persisted tokens").option("--agent", "Output JSON for machine consumption").action(init);
-program.command("add").description("Add rafters components to the project").argument("[components...]", "Component names to add").option("--list", "List available components").option("--overwrite", "Overwrite existing component files").option("--registry-url <url>", "Custom registry URL").option("--agent", "Output JSON for machine consumption").action(add);
+program.command("init").description("Initialize .rafters/ with default tokens and config").option("-r, --rebuild", "Regenerate output files from existing tokens").option("--reset", "Re-run generators fresh, replacing persisted tokens").option("--agent", "Output JSON for machine consumption").action(withErrorHandler(init));
+program.command("add").description("Add rafters components to the project").argument("[components...]", "Component names to add").option("--list", "List available components").option("--overwrite", "Overwrite existing component files").option("--registry-url <url>", "Custom registry URL").option("--agent", "Output JSON for machine consumption").action(withErrorHandler(add));
 program.command("mcp").description("Start MCP server for AI agent access (stdio)").action(mcp);
 program.command("studio").description("Open Studio UI for visual token editing").action(studio);
 program.parse();

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "rafters",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "description": "CLI for Rafters design system - scaffold tokens and add components",
+  "license": "MIT",
   "type": "module",
   "bin": {
     "rafters": "./dist/index.js"
@@ -10,7 +11,8 @@
     ".": "./dist/index.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "LICENSE"
   ],
   "dependencies": {
     "@antfu/ni": "^28.1.0",