rafters 0.0.85 → 0.2.3

package/dist/index.js

@@ -80,9 +80,9 @@ var require_escape_html = __commonJS({
 import { Command } from "commander";
 
 // src/commands/add.ts
-import { existsSync as existsSync4 } from "fs";
-import { access, mkdir as mkdir3, readFile as readFile4, writeFile as writeFile3 } from "fs/promises";
-import { dirname, join as join8 } from "path";
+import { existsSync as existsSync3 } from "fs";
+import { access, mkdir as mkdir2, readFile as readFile3, writeFile as writeFile2 } from "fs/promises";
+import { dirname, join as join7 } from "path";
 
 // ../design-tokens/src/exporters/dtcg.ts
 function categoryToDTCGType(category, token) {
@@ -1021,7 +1021,7 @@ ${sourceDirectives}
 ${themeBody}`;
   const { execFileSync } = await import("child_process");
   const { mkdtempSync, writeFileSync: writeFileSync2, readFileSync: readFileSync4, rmSync } = await import("fs");
-  const { join: join15, dirname: dirname4 } = await import("path");
+  const { join: join16, dirname: dirname4 } = await import("path");
   const { createRequire: createRequire2 } = await import("module");
   const require2 = createRequire2(import.meta.url);
   let pkgDir;
@@ -1031,10 +1031,10 @@ ${themeBody}`;
   } catch {
     throw new Error("Failed to resolve @tailwindcss/cli");
   }
-  const binPath = join15(pkgDir, "dist", "index.mjs");
-  const tempDir = mkdtempSync(join15(pkgDir, ".tmp-compile-"));
-  const tempInput = join15(tempDir, "input.css");
-  const tempOutput = join15(tempDir, "output.css");
+  const binPath = join16(pkgDir, "dist", "index.mjs");
+  const tempDir = mkdtempSync(join16(pkgDir, ".tmp-compile-"));
+  const tempInput = join16(tempDir, "input.css");
+  const tempOutput = join16(tempDir, "output.css");
   try {
     writeFileSync2(tempInput, input);
     const args = [binPath, "-i", tempInput, "-o", tempOutput];
@@ -1218,7 +1218,7 @@ async function registryToDocumentation(registry2, options = {}) {
   const themeBody = registryToTailwind(registry2, { includeImport: false });
   const candidates = deriveCandidates(themeBody);
   const { mkdtempSync, writeFileSync: writeFileSync2, rmSync } = await import("fs");
-  const { join: join15, dirname: dirname4 } = await import("path");
+  const { join: join16, dirname: dirname4 } = await import("path");
   const { createRequire: createRequire2 } = await import("module");
   const require2 = createRequire2(import.meta.url);
   let pkgDir;
@@ -1230,8 +1230,8 @@ async function registryToDocumentation(registry2, options = {}) {
       "Failed to resolve @tailwindcss/cli -- install it to generate documentation CSS"
     );
   }
-  const tempDir = mkdtempSync(join15(pkgDir, ".tmp-doc-compile-"));
-  const candidateFile = join15(tempDir, "candidates.txt");
+  const tempDir = mkdtempSync(join16(pkgDir, ".tmp-doc-compile-"));
+  const candidateFile = join16(tempDir, "candidates.txt");
   writeFileSync2(candidateFile, candidates.join("\n"));
   const sourceDirectives = [
     `@source "${candidateFile}";`,
@@ -1240,12 +1240,12 @@ async function registryToDocumentation(registry2, options = {}) {
   const input = `@import "tailwindcss" source(none);
 ${sourceDirectives}
 ${themeBody}`;
-  const tempInput = join15(tempDir, "input.css");
-  const tempOutput = join15(tempDir, "output.css");
+  const tempInput = join16(tempDir, "input.css");
+  const tempOutput = join16(tempDir, "output.css");
   try {
     writeFileSync2(tempInput, input);
     const { execFileSync } = await import("child_process");
-    const binPath = join15(pkgDir, "dist", "index.mjs");
+    const binPath = join16(pkgDir, "dist", "index.mjs");
     const args = [binPath, "-i", tempInput, "-o", tempOutput];
     if (minify) args.push("--minify");
     execFileSync("node", args, { stdio: "pipe", timeout: 6e4, cwd: pkgDir });
@@ -6319,7 +6319,7 @@ function $constructor(name, initializer3, params) {
   Object.defineProperty(_, "name", { value: name });
   return _;
 }
-var $brand = Symbol("zod_brand");
+var $brand = /* @__PURE__ */ Symbol("zod_brand");
 var $ZodAsyncError = class extends Error {
   constructor() {
     super(`Encountered Promise during synchronous parse. Use .parseAsync() instead.`);
@@ -6464,7 +6464,7 @@ function floatSafeRemainder(val, step) {
   const stepInt = Number.parseInt(step.toFixed(decCount).replace(".", ""));
   return valInt % stepInt / 10 ** decCount;
 }
-var EVALUATING = Symbol("evaluating");
+var EVALUATING = /* @__PURE__ */ Symbol("evaluating");
 function defineLazy(object2, key, getter) {
   let value = void 0;
   Object.defineProperty(object2, key, {
@@ -15446,8 +15446,8 @@ function yo_default() {
 }
 
 // ../../node_modules/.pnpm/zod@4.1.12/node_modules/zod/v4/core/registries.js
-var $output = Symbol("ZodOutput");
-var $input = Symbol("ZodInput");
+var $output = /* @__PURE__ */ Symbol("ZodOutput");
+var $input = /* @__PURE__ */ Symbol("ZodInput");
 var $ZodRegistry = class {
   constructor() {
     this._map = /* @__PURE__ */ new WeakMap();
@@ -21728,9 +21728,6 @@ var RESERVED_FILL_SEGMENTS = ["to", "via", "from"];
 var SEPARATOR = `-${RESERVED_FILL_SEGMENTS[0]}-`;
 
 // ../shared/src/types.ts
-var COMPUTED = Symbol.for(
-  "rafters.computed"
-);
 var OKLCHSchema = external_exports.object({
   /** Lightness: 0 (black) to 1 (white) */
   l: external_exports.number().min(0).max(1),
@@ -29559,101 +29556,7 @@ function isPathField(value) {
   return typeof value === "string" || Array.isArray(value);
 }
 
-// src/commands/init.ts
-import { existsSync as existsSync3 } from "fs";
-import { copyFile, mkdir as mkdir2, readFile as readFile3, rm, writeFile as writeFile2 } from "fs/promises";
-import { createRequire } from "module";
-import { join as join7, relative as relative2 } from "path";
-import { checkbox, confirm, select } from "@inquirer/prompts";
-var REGISTRY_PLUGINS = [scalePlugin, contrastPlugin, statePlugin, invertPlugin];
-async function backupCss(cssPath) {
-  const backupPath = cssPath.replace(/\.css$/, ".backup.css");
-  await copyFile(cssPath, backupPath);
-  return backupPath;
-}
-function cleanSourceCssBlocks(content) {
-  function parseBlocks(src) {
-    const blocks = [];
-    let depth = 0;
-    const headerStack = [];
-    let segmentStart = 0;
-    for (let i = 0; i < src.length; i++) {
-      const ch = src.charAt(i);
-      if (ch === "{") {
-        headerStack.push(segmentStart);
-        depth++;
-        if (depth >= 1) {
-          blocks.push({
-            headerStart: segmentStart,
-            bodyStart: i + 1,
-            end: -1,
-            header: src.slice(segmentStart, i).trim()
-          });
-        }
-        segmentStart = i + 1;
-      } else if (ch === "}") {
-        depth--;
-        const open = blocks.slice().reverse().find((b2) => b2.end === -1);
-        if (open) open.end = i + 1;
-        headerStack.pop();
-        segmentStart = i + 1;
-      } else if (ch === ";") {
-        segmentStart = i + 1;
-      }
-    }
-    return blocks.filter((b2) => b2.end !== -1);
-  }
-  function isContentEmpty(body) {
-    return body.replace(/\/\*[\s\S]*?\*\//g, "").trim().length === 0;
-  }
-  let out = content;
-  for (let pass = 0; pass < 10; pass++) {
-    const blocks = parseBlocks(out);
-    let edited = false;
-    for (const block of blocks.sort((a2, b2) => b2.headerStart - a2.headerStart)) {
-      const header = block.header;
-      if (/^@theme\s+inline$/.test(header)) {
-        out = out.slice(0, block.headerStart) + out.slice(block.end);
-        edited = true;
-        break;
-      }
-      if (header === ":root" || /(^|,)\s*:root\s*$/.test(header)) {
-        const body = out.slice(block.bodyStart, block.end - 1);
-        const cleanedBody = body.replace(/--[\w-]+\s*:[^;{}]*;?/g, "");
-        if (isContentEmpty(cleanedBody)) {
-          out = out.slice(0, block.headerStart) + out.slice(block.end);
-          edited = true;
-          break;
-        }
-        if (cleanedBody !== body) {
-          out = out.slice(0, block.bodyStart) + cleanedBody + out.slice(block.end - 1);
-          edited = true;
-          break;
-        }
-        continue;
-      }
-      if (header.startsWith("@media") || header.startsWith("@supports")) {
-        const body = out.slice(block.bodyStart, block.end - 1);
-        if (isContentEmpty(body)) {
-          out = out.slice(0, block.headerStart) + out.slice(block.end);
-          edited = true;
-          break;
-        }
-      }
-    }
-    if (!edited) break;
-  }
-  return out.replace(/[ \t]+$/gm, "").replace(/\n{3,}/g, "\n\n");
-}
-async function stripImportedDeclarations(cwd, cssPath, importedNames) {
-  if (importedNames.length === 0) return;
-  const fullPath = join7(cwd, cssPath);
-  const content = await readFile3(fullPath, "utf-8");
-  const pattern = new RegExp(importedNames.map((n2) => `^\\s*--${n2}[^;]*;\\s*$`).join("|"), "gm");
-  const cleaned = cleanSourceCssBlocks(content.replace(pattern, ""));
-  const collapsed = cleaned.replace(/\n{3,}/g, "\n\n");
-  await writeFile2(fullPath, collapsed);
-}
+// src/config/rafters-config.ts
 function migrateConfig(raw) {
   if ("shadcn" in raw && !("source" in raw)) {
     if (raw.shadcn === true) {
@@ -29663,2058 +29566,1247 @@ function migrateConfig(raw) {
   }
   return raw;
 }
-async function updateMainCss(cwd, cssPath, themePath) {
-  const fullCssPath = join7(cwd, cssPath);
-  const cssContent = await readFile3(fullCssPath, "utf-8");
-  const cssDir = join7(cwd, cssPath, "..");
-  const themeFullPath = join7(cwd, themePath);
-  const relativeThemePath = relative2(cssDir, themeFullPath);
-  if (cssContent.includes(".rafters/output/rafters.css")) {
-    log({ event: "init:css_already_imported", cssPath });
-    return;
-  }
-  await backupCss(fullCssPath);
-  let newContent;
-  if (cssContent.includes('@import "tailwindcss"')) {
-    newContent = cssContent.replace('@import "tailwindcss";', `@import "${relativeThemePath}";`);
-  } else if (cssContent.includes("@import 'tailwindcss'")) {
-    newContent = cssContent.replace("@import 'tailwindcss';", `@import "${relativeThemePath}";`);
-  } else {
-    newContent = `@import "${relativeThemePath}";
 
-${cssContent}`;
+// src/commands/add.ts
+var REGISTRY_PLUGINS = [scalePlugin, contrastPlugin, statePlugin, invertPlugin];
+async function regenerateAfterInstall(cwd, config2) {
+  const paths = getRaftersPaths(cwd);
+  let registry2;
+  try {
+    registry2 = loadRegistryFromDir(paths.tokens, REGISTRY_PLUGINS);
+  } catch {
+    return;
   }
-  await writeFile2(fullCssPath, newContent);
-  log({
-    event: "init:css_updated",
-    cssPath,
-    themePath: relativeThemePath
-  });
-}
-function isInteractive() {
-  return Boolean(process.stdin.isTTY && process.stdout.isTTY);
-}
-function resolveSourceCssPath(cwd, framework, detectedFramework, projectCssPath, shadcnCssPath, emit) {
-  if (shadcnCssPath) {
-    if (existsSync3(join7(cwd, shadcnCssPath))) return shadcnCssPath;
-    const fallback = framework === detectedFramework ? projectCssPath : findCssPath(cwd, framework);
-    emit({
-      event: "init:shadcn_css_missing",
-      configuredPath: shadcnCssPath,
-      fallbackPath: fallback,
-      message: "components.json points at a CSS file that does not exist. Falling back to the framework canonical location."
+  if (registry2.size() === 0) return;
+  try {
+    await regenerateOutputs(registry2, {
+      outputDir: paths.output,
+      exports: config2.exports,
+      contentSources: resolveContentSources(cwd, config2),
+      darkMode: config2.darkMode ?? "class",
+      includeImport: config2.source !== "shadcn"
+    });
+  } catch (err) {
+    log({
+      event: "add:regen-failed",
+      message: `Output regeneration failed: ${err instanceof Error ? err.message : String(err)}`
     });
-    return fallback;
-  }
-  return framework === detectedFramework ? projectCssPath : findCssPath(cwd, framework);
-}
-function slugifyFontName(name) {
-  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
-}
-function isFontStackValue(value) {
-  if (typeof value !== "string") return false;
-  if (value.startsWith("var(")) return false;
-  if (/[,'"]/.test(value)) return true;
-  return /\b(sans-serif|serif|monospace|cursive|fantasy|system-ui|ui-(?:sans-serif|serif|monospace|rounded))\b/.test(
-    value
-  );
-}
-async function resolveFramework(detected, flag, agentMode) {
-  if (flag) {
-    if (!isSelectableFramework(flag)) {
-      throw new Error(
-        `Unknown --framework "${flag}". Valid values: ${SELECTABLE_FRAMEWORKS.join(", ")}.`
-      );
-    }
-    return flag;
   }
-  if (detected !== "unknown") return detected;
-  if (agentMode || !isInteractive()) return "unknown";
-  const picked = await select({
-    message: "Couldn't auto-detect your framework. Which one is this?",
-    choices: SELECTABLE_FRAMEWORKS.map((value) => ({
-      name: FRAMEWORK_SPECS[value].label ?? value,
-      value
-    }))
-  });
-  return picked;
 }
-async function promptExportFormats(existingConfig) {
-  if (!isInteractive()) {
-    return existingConfig ?? DEFAULT_EXPORTS;
+async function isInitialized(cwd) {
+  const paths = getRaftersPaths(cwd);
+  try {
+    await access(paths.root);
+    return true;
+  } catch {
+    return false;
   }
-  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);
 }
-function isTailwindCliInstalled() {
-  const require2 = createRequire(import.meta.url);
+async function loadConfig(cwd) {
+  const paths = getRaftersPaths(cwd);
   try {
-    require2.resolve("@tailwindcss/cli/package.json");
-    return true;
+    const content = await readFile3(paths.config, "utf-8");
+    return migrateConfig(
+      JSON.parse(content)
+    );
   } catch (err) {
-    if (err instanceof Error && "code" in err && err.code === "MODULE_NOT_FOUND") {
-      return false;
+    if (existsSync3(paths.config)) {
+      const message = err instanceof Error ? err.message : String(err);
+      log({
+        event: "add:warning",
+        message: `Failed to load config: ${message}`
+      });
     }
-    throw err;
+    return null;
   }
 }
-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."
-    );
-  }
+function resolveRegistryUrl(options, config2) {
+  return options.registryUrl ?? config2?.registryUrl;
 }
-async function generateOutputs(cwd, paths, registry2, exports, source, darkMode = "class", config2) {
-  const contentSources = config2 ? resolveContentSources(cwd, config2) : [];
-  if (exports.compiled && !isTailwindCliInstalled()) {
-    log({ event: "init:prompting_exports" });
-    await ensureTailwindCli(cwd);
-  }
-  if (exports.compiled) {
-    log({ event: "init:compiling_css" });
-  }
-  return regenerateOutputs(registry2, {
-    outputDir: paths.output,
-    exports,
-    contentSources,
-    darkMode,
-    includeImport: source !== "shadcn"
-  });
+async function saveConfig(cwd, config2) {
+  const paths = getRaftersPaths(cwd);
+  await writeFile2(paths.config, JSON.stringify(config2, null, 2));
 }
-async function regenerateFromExisting(cwd, paths, source, isAgentMode2, framework) {
-  log({ event: "init:regenerate", cwd });
-  let existingConfig = null;
+function getInstalledNames(config2) {
+  if (!config2?.installed) return [];
+  const names = /* @__PURE__ */ new Set([
+    ...config2.installed.components,
+    ...config2.installed.primitives,
+    ...config2.installed.composites ?? [],
+    ...config2.installed.rules ?? [],
+    ...config2.installed.substrate ?? []
+  ]);
+  return [...names].sort();
+}
+async function discoverUntrackedNames(cwd, config2, client, tracked) {
+  let index = null;
   try {
-    const configContent = await readFile3(paths.config, "utf-8");
-    existingConfig = migrateConfig(
-      JSON.parse(configContent)
-    );
-  } catch {
+    index = await client.fetchIndex();
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    log({
+      event: "add:warning",
+      message: `Could not read the registry index to reconcile on-disk components (${message}). Updating tracked components only.`
+    });
   }
-  if (framework !== "unknown" && existingConfig) {
-    const frameworkPaths = FRAMEWORK_SPECS[framework].components;
-    existingConfig.framework = framework;
-    existingConfig.componentsPath = frameworkPaths.components;
-    existingConfig.primitivesPath = frameworkPaths.primitives;
-    existingConfig.compositesPath = frameworkPaths.composites;
-    existingConfig.rulesPath = frameworkPaths.rules;
+  const { untracked } = buildUpdateCandidates(tracked, index, readInstallRoots(cwd, config2));
+  return untracked;
+}
+function getComponentTarget(config2) {
+  return resolveComponentTarget(config2);
+}
+var SHARED_EXTENSIONS = /* @__PURE__ */ new Set([".behavior.ts", ".classes.ts"]);
+function isSharedFile(path) {
+  for (const ext of SHARED_EXTENSIONS) {
+    if (path.endsWith(ext)) return true;
   }
-  await rm(join7(paths.tokens, "elevation.rafters.json"), { force: true });
-  await rm(join7(paths.tokens, "fill.rafters.json"), { force: true });
-  const registry2 = loadRegistryFromDir(paths.tokens, REGISTRY_PLUGINS);
-  if (registry2.size() === 0) {
-    throw new Error("No tokens found. Cannot regenerate without existing tokens.");
+  return false;
+}
+var REACT_FALLBACK_TARGETS = /* @__PURE__ */ new Set(["astro", "vue", "svelte"]);
+function selectFilesForFramework(files, target) {
+  const preferredExt = targetToExtension(target);
+  const shared = files.filter((f) => isSharedFile(f.path));
+  const matched = files.filter((f) => f.path.endsWith(preferredExt));
+  if (matched.length > 0) {
+    return { files: [...matched, ...shared], fallback: false };
   }
-  const namespaces = [...new Set(registry2.list().map((t) => t.namespace))];
-  log({
-    event: "init:loaded",
-    tokenCount: registry2.size(),
-    namespaces
-  });
-  let exports;
-  if (isAgentMode2) {
-    exports = existingConfig?.exports ?? DEFAULT_EXPORTS;
-    log({ event: "init:exports_default", exports });
-  } else {
-    if (isInteractive()) {
-      log({ event: "init:prompting_exports" });
+  if (REACT_FALLBACK_TARGETS.has(target)) {
+    const fallbackFiles = files.filter((f) => f.path.endsWith(".tsx"));
+    if (fallbackFiles.length > 0) {
+      return { files: [...fallbackFiles, ...shared], fallback: true };
     }
-    exports = await promptExportFormats(existingConfig?.exports);
-    log({ event: "init:exports_selected", exports });
   }
-  await mkdir2(paths.output, { recursive: true });
-  const outputs = await generateOutputs(
-    cwd,
-    paths,
-    registry2,
-    exports,
-    source,
-    "class",
-    existingConfig
-  );
-  if (existingConfig) {
-    existingConfig.exports = exports;
-    await writeFile2(paths.config, JSON.stringify(existingConfig, null, 2));
-  } else {
-    const frameworkPaths = FRAMEWORK_SPECS[framework].components;
-    const newConfig = {
-      framework,
-      componentsPath: frameworkPaths.components,
-      primitivesPath: frameworkPaths.primitives,
-      compositesPath: frameworkPaths.composites,
-      rulesPath: frameworkPaths.rules,
-      cssPath: null,
-      ...source ? { source } : {},
-      intent: "efficient",
-      fonts: { path: null, imports: [] },
-      exports,
-      installed: { components: [], primitives: [], composites: [], rules: [] }
-    };
-    await writeFile2(paths.config, JSON.stringify(newConfig, null, 2));
+  if (target !== "react" && !REACT_FALLBACK_TARGETS.has(target)) {
+    return { files: shared, fallback: false };
   }
-  log({
-    event: "init:complete",
-    outputs,
-    path: paths.output
+  return { files, fallback: false };
+}
+var TARGET_GATED_COMPOSITE_FILES = [{ suffix: "Composite.astro", target: "astro" }];
+function selectCompositeFiles(files, target) {
+  return files.filter((file2) => {
+    const gate = TARGET_GATED_COMPOSITE_FILES.find((g2) => file2.path.endsWith(g2.suffix));
+    return gate ? gate.target === target : true;
   });
 }
-async function resetToDefaults(cwd, paths, source, isAgentMode2, framework) {
-  log({ event: "init:reset", cwd });
-  let existingConfig = null;
-  try {
-    const configContent = await readFile3(paths.config, "utf-8");
-    existingConfig = migrateConfig(
-      JSON.parse(configContent)
-    );
-  } catch {
-  }
-  if (framework !== "unknown" && existingConfig) {
-    const frameworkPaths = FRAMEWORK_SPECS[framework].components;
-    existingConfig.framework = framework;
-    existingConfig.componentsPath = frameworkPaths.components;
-    existingConfig.primitivesPath = frameworkPaths.primitives;
-    existingConfig.compositesPath = frameworkPaths.composites;
-    existingConfig.rulesPath = frameworkPaths.rules;
-  }
-  let existingTokens = [];
-  try {
-    existingTokens = loadRegistryFromDir(paths.tokens, REGISTRY_PLUGINS).list();
-  } catch {
+var FOLDER_NAMES = /* @__PURE__ */ new Set(["composites"]);
+function isAlreadyInstalled(config2, item) {
+  if (!config2?.installed) return false;
+  const { components, primitives, composites: composites2, rules, substrate } = config2.installed;
+  const bucketByType = {
+    ui: components,
+    primitive: primitives,
+    composite: composites2 ?? [],
+    rule: rules ?? [],
+    substrate: substrate ?? []
+  };
+  return bucketByType[item.type].includes(item.name);
+}
+function isInstalledOnDisk(config2, item, cwd) {
+  if (!isAlreadyInstalled(config2, item)) return false;
+  const filesToCheck = item.type === "ui" ? selectFilesForFramework(item.files, getComponentTarget(config2)).files : item.files;
+  for (const file2 of filesToCheck) {
+    if (fileExists(cwd, transformPath(file2.path, config2, cwd))) return true;
   }
-  const overriddenTokens = existingTokens.filter((t) => t.userOverride);
-  if (overriddenTokens.length > 0) {
-    const backup = {
-      resetAt: (/* @__PURE__ */ new Date()).toISOString(),
-      reason: "rafters init --reset",
-      overrides: overriddenTokens.map((t) => ({
-        name: t.name,
-        value: t.value,
-        userOverride: t.userOverride,
-        namespace: t.namespace
-      }))
+  return false;
+}
+function trackInstalled(config2, items) {
+  if (!config2.installed) {
+    config2.installed = {
+      components: [],
+      primitives: [],
+      composites: [],
+      rules: []
     };
-    await mkdir2(paths.output, { recursive: true });
-    const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-    const backupPath = join7(paths.output, `reset-${timestamp}.json`);
-    await writeFile2(backupPath, JSON.stringify(backup, null, 2));
-    log({
-      event: "init:reset_backup",
-      path: backupPath,
-      overrideCount: overriddenTokens.length
-    });
   }
-  let exports;
-  if (isAgentMode2) {
-    exports = existingConfig?.exports ?? DEFAULT_EXPORTS;
-    log({ event: "init:exports_default", exports });
-  } else {
-    if (isInteractive()) {
-      log({ event: "init:prompting_exports" });
+  const installed = config2.installed;
+  if (!installed.composites) installed.composites = [];
+  if (!installed.rules) installed.rules = [];
+  if (!installed.substrate) installed.substrate = [];
+  const bucketByType = {
+    ui: installed.components,
+    primitive: installed.primitives,
+    composite: installed.composites,
+    rule: installed.rules,
+    substrate: installed.substrate
+  };
+  for (const item of items) {
+    const bucket = bucketByType[item.type];
+    if (!bucket.includes(item.name)) bucket.push(item.name);
+  }
+  installed.components.sort();
+  installed.primitives.sort();
+  installed.composites.sort();
+  installed.rules.sort();
+  installed.substrate.sort();
+}
+function rootFor(field, cwd, fallback) {
+  return field === void 0 ? fallback : resolveRoot(field, cwd, fallback);
+}
+function transformPath(registryPath, config2, cwd = process.cwd()) {
+  if (!config2) return registryPath;
+  const replacements = [
+    ["components/ui/", config2.componentsPath, "components/ui"],
+    ["lib/primitives/", config2.primitivesPath, "lib/primitives"],
+    ["composites/", config2.compositesPath, "composites"],
+    ["rules/", config2.rulesPath, "lib/rules"]
+  ];
+  for (const [prefix, field, fallback] of replacements) {
+    if (registryPath.startsWith(prefix)) {
+      return registryPath.replace(prefix, `${rootFor(field, cwd, fallback)}/`);
     }
-    exports = await promptExportFormats(existingConfig?.exports);
-    log({ event: "init:exports_selected", exports });
   }
-  const system = generateBaseSystem({});
-  const registry2 = new TokenRegistry(system.allTokens, REGISTRY_PLUGINS);
-  log({
-    event: "init:reset_generated",
-    tokenCount: registry2.size()
-  });
-  await rm(paths.tokens, { recursive: true, force: true });
-  await mkdir2(paths.tokens, { recursive: true });
-  saveRegistryToDir(paths.tokens, registry2);
-  const allTokensToSave = registry2.list();
-  const namespaceCount = new Set(allTokensToSave.map((t) => t.namespace)).size;
-  log({
-    event: "init:registry_saved",
-    path: paths.tokens,
-    namespaceCount
-  });
-  await mkdir2(paths.output, { recursive: true });
-  const outputs = await generateOutputs(
-    cwd,
-    paths,
-    registry2,
-    exports,
-    source,
-    "class",
-    existingConfig
-  );
-  if (existingConfig) {
-    existingConfig.exports = exports;
-    await writeFile2(paths.config, JSON.stringify(existingConfig, null, 2));
-  } else {
-    const frameworkPaths = FRAMEWORK_SPECS[framework].components;
-    const newConfig = {
-      framework,
-      componentsPath: frameworkPaths.components,
-      primitivesPath: frameworkPaths.primitives,
-      compositesPath: frameworkPaths.composites,
-      rulesPath: frameworkPaths.rules,
-      cssPath: null,
-      ...source ? { source } : {},
-      intent: "efficient",
-      fonts: { path: null, imports: [] },
-      exports,
-      installed: { components: [], primitives: [], composites: [], rules: [] }
-    };
-    await writeFile2(paths.config, JSON.stringify(newConfig, null, 2));
+  return registryPath;
+}
+function substrateProjectPath(registryPath, config2, cwd = process.cwd()) {
+  const componentsResolved = rootFor(config2?.componentsPath, cwd, "components/ui");
+  const sourceRoot = componentsResolved.replace(/\/?components\/ui$/, "");
+  return sourceRoot ? join7(sourceRoot, registryPath) : registryPath;
+}
+function fileExists(cwd, relativePath) {
+  return existsSync3(join7(cwd, relativePath));
+}
+function transformFileContent(content, config2, fileType = "component", cwd = process.cwd(), opts = {}) {
+  const { substrateKinds = [], installPath } = opts;
+  let transformed = content;
+  const componentsPath = rootFor(config2?.componentsPath, cwd, "components/ui");
+  const primitivesPath = rootFor(config2?.primitivesPath, cwd, "lib/primitives");
+  const stripSourceRoot = (p2) => p2.replace(/^(src|app)\//, "");
+  const aliasComponents = stripSourceRoot(componentsPath);
+  const aliasPrimitives = stripSourceRoot(primitivesPath);
+  transformed = transformed.replace(
+    /from\s+['"]\.\.\/\.\.\/primitives\/([^'"]+)['"]/g,
+    `from '@/${aliasPrimitives}/$1'`
+  );
+  transformed = transformed.replace(
+    /from\s+['"]\.\.\/primitives\/([^'"]+)['"]/g,
+    `from '@/${aliasPrimitives}/$1'`
+  );
+  const substrateOwnDir = fileType === "substrate" && installPath ? stripSourceRoot(dirname(installPath)) : null;
+  const aliasSibling = fileType === "primitive" ? aliasPrimitives : substrateOwnDir ?? aliasComponents;
+  transformed = transformed.replace(/from\s+['"]\.\/([^'"]+)['"]/g, `from '@/${aliasSibling}/$1'`);
+  if (substrateKinds.length > 0) {
+    const kindAlternation = substrateKinds.join("|");
+    transformed = transformed.replace(
+      new RegExp(`from\\s+['"](?:\\.\\./){1,2}(${kindAlternation})/([^'"]+)['"]`, "g"),
+      "from '@/$1/$2'"
+    );
   }
-  log({
-    event: "init:complete",
-    outputs,
-    path: paths.output
-  });
+  transformed = transformed.replace(
+    /from\s+['"]\.\.\/([^/'"]+)\/\1([^'"]*)['"]/g,
+    `from '@/${aliasComponents}/$1$2'`
+  );
+  transformed = transformed.replace(
+    /from\s+['"]\.\.\/([^'"]+)['"]/g,
+    `from '@/${aliasComponents}/$1'`
+  );
+  return transformed;
 }
-async function init(options) {
-  setAgentMode(options.agent ?? false);
-  const isAgentMode2 = options.agent ?? false;
-  const cwd = process.cwd();
-  const paths = getRaftersPaths(cwd);
-  log({ event: "init:start", cwd });
-  const project = await detectProject(cwd);
-  const { framework: detectedFramework, shadcn, tailwindVersion, astroHasReact } = project;
-  const source = shadcn ? "shadcn" : void 0;
-  log({
-    event: "init:detected",
-    framework: detectedFramework,
-    tailwindVersion,
-    hasShadcn: !!shadcn
-  });
-  const framework = await resolveFramework(detectedFramework, options.framework, isAgentMode2);
-  if (framework !== detectedFramework) {
-    log({
-      event: "init:framework_resolved",
-      detected: detectedFramework,
-      resolved: framework,
-      source: options.framework ? "flag" : "prompt"
-    });
+async function installItem(cwd, item, options, config2, substrateKinds = []) {
+  const installedFiles = [];
+  let skipped = false;
+  let filesToInstall = item.files;
+  if (item.type === "ui") {
+    const target = getComponentTarget(config2);
+    const selection = selectFilesForFramework(item.files, target);
+    filesToInstall = selection.files;
+    if (selection.fallback) {
+      log({
+        event: "add:fallback",
+        component: item.name,
+        target,
+        message: `No ${targetToExtension(target)} version available for ${item.name}. Installing React version.`
+      });
+    }
+    const hasComponentFile = selection.files.some((f) => !isSharedFile(f.path));
+    if (!hasComponentFile) {
+      throw new Error(
+        `No ${targetToExtension(target)} version available for "${item.name}" and no compatible fallback exists.`
+      );
+    }
+  } else if (item.type === "composite") {
+    filesToInstall = selectCompositeFiles(item.files, getComponentTarget(config2));
   }
-  if (isTailwindV3(tailwindVersion)) {
-    throw new Error("Tailwind v3 detected. Rafters requires Tailwind v4.");
+  for (const file2 of filesToInstall) {
+    const projectPath2 = item.type === "substrate" ? substrateProjectPath(file2.path, config2, cwd) : transformPath(file2.path, config2, cwd);
+    const targetPath = join7(cwd, projectPath2);
+    if (fileExists(cwd, projectPath2)) {
+      if (!options.overwrite) {
+        log({
+          event: "add:skip",
+          component: item.name,
+          file: projectPath2,
+          reason: "exists"
+        });
+        skipped = true;
+        continue;
+      }
+    }
+    await mkdir2(dirname(targetPath), { recursive: true });
+    const fileType = item.type === "primitive" ? "primitive" : item.type === "substrate" ? "substrate" : "component";
+    const transformedContent = transformFileContent(file2.content, config2, fileType, cwd, {
+      substrateKinds,
+      installPath: file2.path
+    });
+    await writeFile2(targetPath, transformedContent, "utf-8");
+    installedFiles.push(projectPath2);
   }
-  const raftersExists = existsSync3(paths.root);
-  if (options.reset && !raftersExists) {
-    throw new Error("Nothing to reset. No .rafters/ directory found.");
+  return {
+    installed: installedFiles.length > 0,
+    skipped,
+    files: installedFiles
+  };
+}
+async function add(componentArgs, options) {
+  setAgentMode(options.agent ?? false);
+  let components = componentArgs;
+  const cwd = process.cwd();
+  const config2 = await loadConfig(cwd);
+  const client = new RegistryClient(resolveRegistryUrl(options, config2));
+  let folder;
+  const firstArg = components[0];
+  if (firstArg && FOLDER_NAMES.has(firstArg)) {
+    folder = firstArg;
+    components = components.slice(1);
   }
-  if (raftersExists && options.reset) {
-    await resetToDefaults(cwd, paths, source, isAgentMode2, framework);
+  if (options.list) {
+    const availableComponents = await client.listComponents();
+    const availableComposites = await client.listComposites();
+    if (options.agent) {
+      log({
+        event: "add:list",
+        components: availableComponents,
+        composites: availableComposites
+      });
+    } else {
+      console.log("Available components:\n");
+      for (const comp of availableComponents) {
+        console.log(`  ${comp.name}  ${comp.description ?? ""}`);
+      }
+      if (availableComposites.length > 0) {
+        console.log("\nAvailable composites:\n");
+        for (const comp of availableComposites) {
+          console.log(`  ${comp.name}  ${comp.description ?? ""}`);
+        }
+      }
+    }
     return;
   }
-  if (raftersExists && !options.rebuild) {
-    throw new Error(
-      ".rafters/ directory already exists. Use --rebuild to regenerate output files, or --reset to start from defaults."
-    );
-  }
-  if (raftersExists && options.rebuild) {
-    await regenerateFromExisting(cwd, paths, source, isAgentMode2, framework);
+  const initialized = await isInitialized(cwd);
+  if (!initialized) {
+    error46("Project not initialized. Run `rafters init` first.");
+    process.exitCode = 1;
     return;
   }
-  let exports;
-  if (isAgentMode2) {
-    exports = DEFAULT_EXPORTS;
-    log({ event: "init:exports_default", exports });
-  } else {
-    if (isInteractive()) {
-      log({ event: "init:prompting_exports" });
+  if (options.update) {
+    options.overwrite = true;
+  }
+  let untrackedNames = [];
+  if (options.updateAll) {
+    options.overwrite = true;
+    if (!config2) {
+      error46("No rafters config found. Run 'rafters init' first.");
+      process.exitCode = 1;
+      return;
     }
-    exports = await promptExportFormats();
-    log({ event: "init:exports_selected", exports });
+    const trackedNames = getInstalledNames(config2);
+    untrackedNames = await discoverUntrackedNames(cwd, config2, client, trackedNames);
+    const candidates = [.../* @__PURE__ */ new Set([...trackedNames, ...untrackedNames])].sort();
+    if (candidates.length === 0) {
+      error46("No installed components found. Use 'rafters add <component>' to install first.");
+      process.exitCode = 1;
+      return;
+    }
+    if (untrackedNames.length > 0) {
+      log({
+        event: "add:untracked",
+        components: untrackedNames,
+        message: `Found ${untrackedNames.length} component(s) on disk the config never tracked: ${untrackedNames.join(", ")}. Refreshing and tracking them.`
+      });
+    }
+    components = candidates;
   }
-  const adapter = getAdapter(source ?? "tailwind");
-  const baseConfig = {};
-  const sourceCssPathForBase = resolveSourceCssPath(
+  if (folder === "composites" && components.length === 0) {
+    components = ["composites"];
+  }
+  if (components.length === 0) {
+    error46("No components specified. Usage: rafters add <component...>");
+    process.exitCode = 1;
+    return;
+  }
+  log({
+    event: "add:start",
     cwd,
-    framework,
-    detectedFramework,
-    project.cssPath,
-    shadcn?.tailwind?.css,
-    log
-  );
-  if (sourceCssPathForBase !== null) {
+    components,
+    overwrite: options.overwrite ?? false
+  });
+  const allItems = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const itemName of components) {
     try {
-      const cssForBase = await readFile3(join7(cwd, sourceCssPathForBase), "utf-8");
-      const baseSlots = [
-        {
-          detect: () => adapter.detectSpacing(cssForBase).base,
-          field: "baseSpacingUnit",
-          event: "init:import_spacing_applied",
-          eventKey: "baseSpacingUnit"
-        },
-        {
-          detect: () => adapter.detectRadius(cssForBase).base,
-          field: "baseRadiusOverride",
-          event: "init:import_radius_applied",
-          eventKey: "baseRadius"
-        },
-        {
-          detect: () => adapter.detectFontSize(cssForBase).base,
-          field: "baseFontSizeOverride",
-          event: "init:import_font_size_applied",
-          eventKey: "baseFontSize"
-        },
-        {
-          detect: () => adapter.detectFocusRing(cssForBase).width,
-          field: "focusRingWidthOverride",
-          event: "init:import_focus_ring_applied",
-          eventKey: "focusRingWidth"
+      if (folder === "composites") {
+        if (!seen.has(itemName)) {
+          const composite = await client.fetchComposite(itemName);
+          seen.add(itemName);
+          allItems.push(composite);
+          for (const dep of composite.primitives) {
+            if (!seen.has(dep)) {
+              const depItems = await client.resolveDependencies(dep, seen);
+              allItems.push(...depItems);
+            }
+          }
         }
-        // Motion duration is intentionally not imported -- rafters' motion
-        // system is research-backed and most projects' `--duration-base`
-        // values are unresearched defaults. See importers/bases.ts for the
-        // policy note; designers can `rafters set motion-duration-base ...`
-        // after init to override explicitly.
-      ];
-      for (const slot of baseSlots) {
-        const value = slot.detect();
-        if (value === void 0) continue;
-        baseConfig[slot.field] = value;
-        log({
-          event: slot.event,
-          cssPath: sourceCssPathForBase,
-          [slot.eventKey]: value
-        });
+      } else {
+        const items = await client.resolveDependencies(itemName, seen);
+        allItems.push(...items);
       }
     } catch (err) {
-      if (!(err instanceof Error && "code" in err && err.code === "ENOENT")) throw err;
+      if (err instanceof Error) {
+        error46(err.message);
+      } else {
+        error46(`Failed to fetch "${itemName}"`);
+      }
+      process.exitCode = 1;
+      return;
     }
   }
-  const system = generateBaseSystem(baseConfig);
-  const registry2 = new TokenRegistry(system.allTokens, REGISTRY_PLUGINS);
-  log({
-    event: "init:generated",
-    tokenCount: registry2.size()
-  });
-  await mkdir2(paths.tokens, { recursive: true });
-  await mkdir2(paths.output, { recursive: true });
-  saveRegistryToDir(paths.tokens, registry2);
-  const allTokensToSave = registry2.list();
-  const namespaceCount = new Set(allTokensToSave.map((t) => t.namespace)).size;
-  log({
-    event: "init:registry_saved",
-    path: paths.tokens,
-    namespaceCount
-  });
-  const outputs = await generateOutputs(cwd, paths, registry2, exports, source);
-  let detectedCssPath = null;
-  detectedCssPath = resolveSourceCssPath(
-    cwd,
-    framework,
-    detectedFramework,
-    project.cssPath,
-    shadcn?.tailwind?.css,
-    log
-  );
-  if (source !== "shadcn" && exports.tailwind) {
-    if (detectedCssPath) {
-      await updateMainCss(cwd, detectedCssPath, ".rafters/output/rafters.css");
-    } else {
+  const substrateKinds = [
+    ...new Set(
+      allItems.filter((item) => item.type === "substrate").map((item) => item.files[0]?.path.split("/")[0]).filter((segment) => Boolean(segment))
+    )
+  ];
+  const written = [];
+  const skipped = [];
+  const failed = [];
+  const installedItems = [];
+  const filteredItems = [];
+  const target = getComponentTarget(config2);
+  for (const item of allItems) {
+    if (!options.overwrite && isAlreadyInstalled(config2, item)) {
+      if (isInstalledOnDisk(config2, item, cwd)) {
+        log({
+          event: "add:skip",
+          component: item.name,
+          reason: "already installed"
+        });
+        skipped.push(item.name);
+        continue;
+      }
       log({
-        event: "init:css_not_found",
-        message: 'No main CSS file found. Add @import ".rafters/output/rafters.css" manually.',
-        searchedLocations: FRAMEWORK_SPECS[framework].cssLocations
+        event: "add:warning",
+        component: item.name,
+        message: "Config tracks this as installed but no files found on disk -- reinstalling."
       });
     }
-  }
-  let componentTarget = frameworkToTarget(framework);
-  if (framework === "astro" && astroHasReact && isInteractive() && !isAgentMode2) {
-    componentTarget = await select({
-      message: "This Astro project has React integration. Install components as:",
-      choices: [
-        {
-          name: "Astro components (zero client JS, server-rendered)",
-          value: "astro"
-        },
-        {
-          name: "React components (client islands with client:load)",
-          value: "react"
-        }
-      ]
-    });
-  }
-  const frameworkPaths = FRAMEWORK_SPECS[framework].components;
-  const config2 = {
-    framework,
-    ...source ? { source } : {},
-    componentTarget,
-    componentsPath: frameworkPaths.components,
-    primitivesPath: frameworkPaths.primitives,
-    compositesPath: frameworkPaths.composites,
-    rulesPath: frameworkPaths.rules,
-    cssPath: detectedCssPath,
-    exports,
-    intent: "efficient",
-    fonts: { path: null, imports: [] },
-    installed: {
-      components: [],
-      primitives: [],
-      composites: [],
-      rules: []
-    }
-  };
-  await writeFile2(paths.config, JSON.stringify(config2, null, 2));
-  if (detectedCssPath) {
-    let sourceCss = null;
     try {
-      sourceCss = await readFile3(join7(cwd, detectedCssPath), "utf-8");
+      const result = await installItem(cwd, item, options, config2, substrateKinds);
+      if (result.installed) {
+        written.push(item.name);
+        installedItems.push(item);
+        if (item.type === "ui") {
+          const selection = selectFilesForFramework(item.files, target);
+          filteredItems.push({ ...item, files: selection.files });
+        } else {
+          filteredItems.push(item);
+        }
+        log({
+          event: "add:installed",
+          component: item.name,
+          type: item.type,
+          files: result.files
+        });
+      }
+      if (result.skipped && !result.installed) {
+        skipped.push(item.name);
+        installedItems.push(item);
+      }
     } catch (err) {
-      if (!(err instanceof Error && "code" in err && err.code === "ENOENT")) throw err;
-    }
-    if (sourceCss !== null) {
-      const summary = senseShadcnCss(sourceCss);
-      if (summary.totalDeclarations > 0) {
+      failed.push(item.name);
+      if (err instanceof Error) {
         log({
-          event: "init:import_sensed",
-          cssPath: detectedCssPath,
-          ...summary
+          event: "add:warning",
+          component: item.name,
+          message: err.message
         });
-        const classification = classifyDeclarations(extractShadcnRoot(sourceCss));
-        const colorDecls = adapter.detectColors(sourceCss);
-        const nonColorDecls = [
-          ...classification.byNamespace.typography,
-          ...classification.byNamespace.spacing,
-          ...classification.byNamespace.radius,
-          ...classification.byNamespace.shadow
-        ];
-        const toImportColors = [];
-        for (const color of colorDecls) {
-          const accept = isAgentMode2 ? true : await confirm({
-            message: `Import --${color.name}: ${color.value}?`,
-            default: true
-          });
-          if (accept) toImportColors.push(color);
-        }
-        const toImportNonColors = [];
-        for (const decl of nonColorDecls) {
-          const accept = isAgentMode2 ? true : await confirm({
-            message: `Import --${decl.name}: ${decl.value}?`,
-            default: true
-          });
-          if (accept) toImportNonColors.push(decl);
-        }
-        if (toImportColors.length + toImportNonColors.length > 0) {
-          for (const color of toImportColors) {
-            const familyName = `imported-${color.name}`;
-            const reason = `imported from --${color.name} in ${detectedCssPath}`;
-            for (const t of importColorFamily(familyName, "500", color.oklch)) {
-              registry2.define(t);
-            }
-            if (color.namespace === "semantic") {
-              registry2.set(color.name, { family: familyName, position: "500" }, { reason });
-            }
-          }
-          const skipped = [];
-          for (const decl of toImportNonColors) {
-            const reason = `imported from --${decl.name} in ${detectedCssPath}`;
-            if (registry2.has(decl.name)) {
-              registry2.set(decl.name, decl.value, { reason });
-            } else {
-              skipped.push(decl.name);
-            }
-          }
-          saveRegistryToDir(paths.tokens, registry2);
-          await generateOutputs(cwd, paths, registry2, exports, source);
-          const importedNames = [
-            ...toImportColors.map((c4) => c4.name),
-            ...toImportNonColors.map((d2) => d2.name)
-          ];
-          await stripImportedDeclarations(cwd, detectedCssPath, importedNames);
-          log({
-            event: "init:import_applied",
-            count: toImportColors.length + toImportNonColors.length - skipped.length,
-            cssPath: detectedCssPath,
-            ...skipped.length > 0 ? { skipped } : {}
-          });
-        }
-      }
-      {
-        const themeDecls = extractThemeBlocks2(sourceCss);
-        if (themeDecls.length > 0) {
-          const POSITION_SUFFIX = new RegExp(`^(.+)-(${SCALE_POSITIONS.join("|")})$`);
-          const familySeeds = /* @__PURE__ */ new Map();
-          for (const decl of themeDecls) {
-            if (!decl.name.startsWith("color-")) continue;
-            const oklch2 = tryParseColor(decl.value);
-            if (oklch2 === null) continue;
-            const m3 = decl.name.match(POSITION_SUFFIX);
-            const baseName = ((m3 ? m3[1] : decl.name) ?? decl.name).replace(/^color-/, "");
-            if (!baseName) continue;
-            const seedPosition = m3?.[2] ?? "500";
-            const existing = familySeeds.get(baseName);
-            if (!existing || seedPosition === "500") {
-              familySeeds.set(baseName, { seed: oklch2, seedPosition });
-            }
-          }
-          const families = Array.from(familySeeds, ([name, info]) => ({
-            name,
-            ...info
-          }));
-          if (families.length > 0) {
-            for (const family of families) {
-              for (const t of importColorFamily(family.name, family.seedPosition, family.seed)) {
-                registry2.define(t);
-              }
-            }
-            const ALL_ROLES = [
-              "primary",
-              "secondary",
-              "tertiary",
-              "accent",
-              "highlight",
-              "neutral",
-              "muted",
-              "success",
-              "warning",
-              "destructive",
-              "info"
-            ];
-            const ROLES = ALL_ROLES.filter((r) => {
-              const tok = registry2.get(r);
-              return tok !== void 0 && tok.namespace === "semantic";
-            });
-            const assignments = [];
-            for (const [i, role] of ROLES.entries()) {
-              let familyChoice;
-              if (isAgentMode2) {
-                familyChoice = families[i]?.name ?? null;
-              } else {
-                familyChoice = await select({
-                  message: `Which palette is "${role}"?`,
-                  choices: [
-                    ...families.map((f) => ({ name: f.name, value: f.name })),
-                    { name: "(skip -- keep rafters default)", value: null }
-                  ]
-                });
-              }
-              if (familyChoice === null) continue;
-              const family = families.find((f) => f.name === familyChoice);
-              if (!family) continue;
-              const position = isAgentMode2 ? family.seedPosition : await select({
-                message: `Which position in "${familyChoice}" for "${role}"?`,
-                choices: SCALE_POSITIONS.map((p2) => ({
-                  name: p2,
-                  value: p2
-                })),
-                default: family.seedPosition
-              });
-              registry2.set(
-                role,
-                { family: familyChoice, position },
-                {
-                  reason: `assigned ${familyChoice}@${position} as ${role} during import from ${detectedCssPath}`
-                }
-              );
-              assignments.push({ role, family: familyChoice, position });
-            }
-            saveRegistryToDir(paths.tokens, registry2);
-            await generateOutputs(cwd, paths, registry2, exports, source);
-            const themeImportedNames = families.flatMap(
-              (f) => SCALE_POSITIONS.map((p2) => `color-${f.name}-${p2}`).concat([`color-${f.name}`])
-            );
-            await stripImportedDeclarations(cwd, detectedCssPath, themeImportedNames);
-            log({
-              event: "init:import_palettes_applied",
-              cssPath: detectedCssPath,
-              palettesDefined: families.map((f) => f.name),
-              assignments
-            });
-          }
-        }
-      }
-    }
-    if (sourceCss !== null) {
-      const detectedFonts = adapter.detectFonts(sourceCss);
-      if (detectedFonts.length > 0) {
-        const typographyTokens = registry2.list({ namespace: "typography" });
-        const baseFamilyNames = new Set(
-          typographyTokens.filter((t) => (!t.dependsOn || t.dependsOn.length === 0) && isFontStackValue(t.value)).map((t) => t.name)
-        );
-        const fontRoles = [];
-        for (const tok of typographyTokens) {
-          const base = tok.dependsOn?.[0];
-          if (base === void 0 || !baseFamilyNames.has(base)) continue;
-          if (typeof tok.value !== "string" || !tok.value.includes(`var(--${base})`)) continue;
-          fontRoles.push({ role: tok.name, base });
-        }
-        const roleTokenNames = new Set(fontRoles.map((r) => r.role));
-        const canonicalTokenNames = /* @__PURE__ */ new Set([...baseFamilyNames, ...roleTokenNames]);
-        const definedFonts = [];
-        for (const font of detectedFonts) {
-          if (font.sourceDeclName && canonicalTokenNames.has(font.sourceDeclName)) continue;
-          const tokenName = font.sourceDeclName ?? `font-${slugifyFontName(font.name)}`;
-          if (registry2.has(tokenName)) continue;
-          registry2.define({
-            name: tokenName,
-            namespace: "typography",
-            category: "typography",
-            value: font.stack,
-            description: `Imported from ${detectedCssPath}. ${font.sourceDeclName ? `Declared as --${font.sourceDeclName}.` : "Loaded via @font-face or @import."}`,
-            userOverride: null,
-            containerQueryAware: false
-          });
-          definedFonts.push(tokenName);
-        }
-        const fontAssignments = [];
-        const declaredByBase = /* @__PURE__ */ new Map();
-        for (const font of detectedFonts) {
-          if (font.sourceDeclName && baseFamilyNames.has(font.sourceDeclName)) {
-            if (!declaredByBase.has(font.sourceDeclName)) {
-              declaredByBase.set(font.sourceDeclName, font);
-            }
-          }
-        }
-        for (const { role, base } of fontRoles) {
-          let choice;
-          if (isAgentMode2) {
-            const declared = declaredByBase.get(base);
-            if (declared !== void 0) {
-              choice = declared.name;
-            } else if (/mono/.test(base)) {
-              choice = detectedFonts.find((f) => /mono/i.test(f.name))?.name ?? null;
-            } else {
-              const sansLike = detectedFonts.find((f) => !/mono/i.test(f.name));
-              choice = sansLike?.name ?? null;
-            }
-          } else {
-            const prompt = role.replace(/^font-/, "");
-            choice = await select({
-              message: `Which font is "${prompt}"?`,
-              choices: [
-                ...detectedFonts.map((f) => ({ name: f.name, value: f.name })),
-                { name: "(skip -- keep rafters default)", value: null }
-              ]
-            });
-          }
-          if (choice === null) continue;
-          const font = detectedFonts.find((f) => f.name === choice);
-          if (font === void 0) continue;
-          const reason = `assigned ${font.name} as ${role} during import from ${detectedCssPath}`;
-          if (registry2.has(role)) {
-            registry2.set(role, font.stack, { reason });
-          }
-          if (registry2.has(base)) {
-            const current = registry2.get(base);
-            if (current?.value !== font.stack) {
-              registry2.set(base, font.stack, { reason });
-            }
-          }
-          fontAssignments.push({ role, family: font.name });
-        }
-        if (fontAssignments.length > 0 || definedFonts.length > 0) {
-          saveRegistryToDir(paths.tokens, registry2);
-          await generateOutputs(cwd, paths, registry2, exports, source);
-          log({
-            event: "init:import_fonts_applied",
-            cssPath: detectedCssPath,
-            fontsDetected: detectedFonts.map((f) => f.name),
-            assignments: fontAssignments,
-            ...definedFonts.length > 0 ? { definedFonts } : {}
-          });
-        }
       }
     }
   }
-  log({
-    event: "init:complete",
-    outputs: [...outputs, "config.rafters.json"],
-    path: paths.output
-  });
-}
-
-// src/commands/add.ts
-var REGISTRY_PLUGINS2 = [scalePlugin, contrastPlugin, statePlugin, invertPlugin];
-async function regenerateAfterInstall(cwd, config2) {
-  const paths = getRaftersPaths(cwd);
-  let registry2;
-  try {
-    registry2 = loadRegistryFromDir(paths.tokens, REGISTRY_PLUGINS2);
-  } catch {
-    return;
-  }
-  if (registry2.size() === 0) return;
+  const emptyDeps = {
+    installed: [],
+    skipped: [],
+    devInstalled: [],
+    failed: []
+  };
+  let depsResult = emptyDeps;
   try {
-    await regenerateOutputs(registry2, {
-      outputDir: paths.output,
-      exports: config2.exports,
-      contentSources: resolveContentSources(cwd, config2),
-      darkMode: config2.darkMode ?? "class",
-      includeImport: config2.source !== "shadcn"
+    depsResult = await installRegistryDependencies(filteredItems, cwd, {
+      target
     });
   } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
     log({
-      event: "add:regen-failed",
-      message: `Output regeneration failed: ${err instanceof Error ? err.message : String(err)}`
+      event: "add:deps:install-failed",
+      message: `Failed to process dependencies: ${message}`,
+      dependencies: [],
+      suggestion: "Check package.json and try installing dependencies manually."
     });
   }
-}
-async function isInitialized(cwd) {
-  const paths = getRaftersPaths(cwd);
-  try {
-    await access(paths.root);
-    return true;
-  } catch {
-    return false;
+  if (depsResult.installed.length > 0 || depsResult.skipped.length > 0) {
+    log({
+      event: "add:dependencies",
+      dependencies: depsResult.installed,
+      devDependencies: depsResult.devInstalled,
+      skipped: depsResult.skipped
+    });
   }
-}
-async function loadConfig(cwd) {
-  const paths = getRaftersPaths(cwd);
-  try {
-    const content = await readFile4(paths.config, "utf-8");
-    return migrateConfig(
-      JSON.parse(content)
-    );
-  } catch (err) {
-    if (existsSync4(paths.config)) {
-      const message = err instanceof Error ? err.message : String(err);
-      log({
-        event: "add:warning",
-        message: `Failed to load config: ${message}`
-      });
-    }
-    return null;
+  if (installedItems.length > 0 && config2) {
+    trackInstalled(config2, installedItems);
+    await saveConfig(cwd, config2);
+    await regenerateAfterInstall(cwd, config2);
+  } else if (installedItems.length > 0 && !config2) {
+    const newConfig = {
+      framework: "unknown",
+      componentsPath: "components/ui",
+      primitivesPath: "lib/primitives",
+      compositesPath: "composites",
+      rulesPath: "lib/rules",
+      cssPath: null,
+      intent: "efficient",
+      fonts: { path: null, imports: [] },
+      exports: DEFAULT_EXPORTS,
+      installed: { components: [], primitives: [], composites: [], rules: [] }
+    };
+    trackInstalled(newConfig, installedItems);
+    await saveConfig(cwd, newConfig);
+    await regenerateAfterInstall(cwd, newConfig);
   }
-}
-function resolveRegistryUrl(options, config2) {
-  return options.registryUrl ?? config2?.registryUrl;
-}
-async function saveConfig(cwd, config2) {
-  const paths = getRaftersPaths(cwd);
-  await writeFile3(paths.config, JSON.stringify(config2, null, 2));
-}
-function getInstalledNames(config2) {
-  if (!config2?.installed) return [];
-  const names = /* @__PURE__ */ new Set([
-    ...config2.installed.components,
-    ...config2.installed.primitives,
-    ...config2.installed.composites ?? [],
-    ...config2.installed.rules ?? [],
-    ...config2.installed.substrate ?? []
-  ]);
-  return [...names].sort();
-}
-async function discoverUntrackedNames(cwd, config2, client, tracked) {
-  let index = null;
-  try {
-    index = await client.fetchIndex();
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
+  log({
+    event: "add:complete",
+    written: written.length,
+    skipped: skipped.length,
+    untracked: untrackedNames.length,
+    failed: failed.length,
+    components: written,
+    skippedComponents: skipped,
+    untrackedComponents: untrackedNames,
+    failedComponents: failed
+  });
+  if (failed.length > 0) {
+    process.exitCode = 1;
+  }
+  if (!options.updateAll && skipped.length > 0 && written.length === 0) {
     log({
-      event: "add:warning",
-      message: `Could not read the registry index to reconcile on-disk components (${message}). Updating tracked components only.`
+      event: "add:hint",
+      message: "Some components were skipped. Use --update to re-fetch, or --update-all to refresh everything.",
+      skipped
     });
+    error46("Component already exists. Use --update to re-fetch from registry.");
+    process.exitCode = 1;
   }
-  const { untracked } = buildUpdateCandidates(tracked, index, readInstallRoots(cwd, config2));
-  return untracked;
 }
-function getComponentTarget(config2) {
-  return resolveComponentTarget(config2);
-}
-var SHARED_EXTENSIONS = /* @__PURE__ */ new Set([".behavior.ts", ".classes.ts"]);
-function isSharedFile(path) {
-  for (const ext of SHARED_EXTENSIONS) {
-    if (path.endsWith(ext)) return true;
+
+// src/commands/agents.ts
+import { existsSync as existsSync6 } from "fs";
+import { readFile as readFile6, writeFile as writeFile4 } from "fs/promises";
+import { join as join12 } from "path";
+
+// src/mcp/tools.ts
+import { readFile as readFile5, writeFile as writeFile3 } from "fs/promises";
+import { isAbsolute as isAbsolute3, join as join11 } from "path";
+
+// ../composites/src/built-in-rules/email.ts
+var email3 = external_exports.string().email();
+
+// ../composites/src/built-in-rules/credentials.ts
+var credentials = external_exports.object({ email: email3, password: external_exports.string().min(8) });
+
+// ../composites/src/built-in-rules/password.ts
+var password = external_exports.string().min(8);
+
+// ../composites/src/built-in-rules/required.ts
+var required2 = external_exports.string().min(1);
+
+// ../composites/src/built-in-rules/url.ts
+var url2 = external_exports.string().url();
+
+// ../composites/src/manifest.ts
+var CompositeCategorySchema = external_exports.string().min(1);
+var AppliedRuleSchema = external_exports.union([
+  external_exports.string(),
+  external_exports.object({
+    name: external_exports.string().min(1),
+    config: external_exports.record(external_exports.string(), external_exports.unknown())
+  })
+]);
+var CompositeBlockSchema = external_exports.object({
+  id: external_exports.string().min(1),
+  type: external_exports.string().min(1),
+  /** Signatures this block consumes / produces (rule names) -- the typed I/O edges.
+   * Within a composite, an output named X feeds any block input named X. */
+  input: external_exports.array(external_exports.string()).optional(),
+  output: external_exports.array(external_exports.string()).optional(),
+  content: external_exports.unknown().optional(),
+  children: external_exports.array(external_exports.string()).optional(),
+  parentId: external_exports.string().optional(),
+  meta: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
+  rules: external_exports.array(AppliedRuleSchema).optional()
+});
+var UsagePatternsSchema2 = external_exports.object({
+  do: external_exports.array(external_exports.string()),
+  never: external_exports.array(external_exports.string())
+});
+var CompositeManifestSchema = external_exports.object({
+  id: external_exports.string().min(1).regex(/^[a-z0-9-]+$/),
+  name: external_exports.string().min(1),
+  category: CompositeCategorySchema,
+  description: external_exports.string(),
+  keywords: external_exports.array(external_exports.string()),
+  cognitiveLoad: external_exports.number().int().min(1).max(10),
+  // Designer intent fields (optional for backwards compatibility)
+  solves: external_exports.string().optional(),
+  appliesWhen: external_exports.array(external_exports.string()).optional(),
+  usagePatterns: UsagePatternsSchema2.optional()
+});
+var CompositeFileSchema = external_exports.object({
+  manifest: CompositeManifestSchema,
+  input: external_exports.array(external_exports.string()).default([]),
+  output: external_exports.array(external_exports.string()).default([]),
+  blocks: external_exports.array(CompositeBlockSchema).min(1)
+});
+
+// ../composites/src/discovery.ts
+function discoverComposites(entries) {
+  const registry2 = /* @__PURE__ */ new Map();
+  const errors = [];
+  for (const entry of entries) {
+    let parsed;
+    try {
+      parsed = JSON.parse(entry.raw);
+    } catch (e) {
+      errors.push({
+        source: entry.source,
+        error: `Invalid JSON: ${e instanceof Error ? e.message : String(e)}`
+      });
+      continue;
+    }
+    const result = CompositeFileSchema.safeParse(parsed);
+    if (!result.success) {
+      errors.push({ source: entry.source, error: result.error.message });
+      continue;
+    }
+    const { id } = result.data.manifest;
+    if (registry2.has(id)) {
+      errors.push({
+        source: entry.source,
+        error: `Duplicate composite id "${id}" (already registered)`
+      });
+      continue;
+    }
+    registry2.set(id, result.data);
   }
-  return false;
+  reportUnresolvedReferences(registry2, errors);
+  return { registry: registry2, errors };
 }
-var REACT_FALLBACK_TARGETS = /* @__PURE__ */ new Set(["astro", "vue", "svelte"]);
-function selectFilesForFramework(files, target) {
-  const preferredExt = targetToExtension(target);
-  const shared = files.filter((f) => isSharedFile(f.path));
-  const matched = files.filter((f) => f.path.endsWith(preferredExt));
-  if (matched.length > 0) {
-    return { files: [...matched, ...shared], fallback: false };
+var COMPOSITE_PREFIX = "composite:";
+function reportUnresolvedReferences(registry2, errors) {
+  for (const [id, composite] of registry2) {
+    const missing = /* @__PURE__ */ new Set();
+    for (const block of composite.blocks) {
+      if (block.type.startsWith(COMPOSITE_PREFIX)) {
+        const refId = block.type.slice(COMPOSITE_PREFIX.length);
+        if (!registry2.has(refId)) {
+          missing.add(refId);
+        }
+      }
+    }
+    if (missing.size > 0) {
+      errors.push({
+        source: id,
+        error: `Unresolved composite reference(s): ${[...missing].map((m3) => `composite:${m3}`).join(", ")}`
+      });
+    }
   }
-  if (REACT_FALLBACK_TARGETS.has(target)) {
-    const fallbackFiles = files.filter((f) => f.path.endsWith(".tsx"));
-    if (fallbackFiles.length > 0) {
-      return { files: [...fallbackFiles, ...shared], fallback: true };
+}
+
+// ../ui/src/primitives/typeahead.ts
+function fuzzyScore(query, target) {
+  if (query.length === 0) return 1;
+  if (query.length > target.length) return 0;
+  const q = query.toLowerCase();
+  const t = target.toLowerCase();
+  let score = 0;
+  let qi = 0;
+  let prevMatchIndex = -2;
+  for (let ti = 0; ti < t.length && qi < q.length; ti++) {
+    if (t[ti] === q[qi]) {
+      score += 1;
+      if (ti === prevMatchIndex + 1) {
+        score += 2;
+      }
+      if (ti === 0 || t[ti - 1] === " " || t[ti - 1] === "-") {
+        score += 3;
+      }
+      prevMatchIndex = ti;
+      qi++;
     }
   }
-  if (target !== "react" && !REACT_FALLBACK_TARGETS.has(target)) {
-    return { files: shared, fallback: false };
+  return qi === q.length ? score : 0;
+}
+
+// ../composites/src/registry.ts
+var composites = /* @__PURE__ */ new Map();
+function register3(composite) {
+  const { id } = composite.manifest;
+  if (composites.has(id)) {
+    throw new Error(`Composite "${id}" is already registered`);
   }
-  return { files, fallback: false };
+  composites.set(id, composite);
 }
-var TARGET_GATED_COMPOSITE_FILES = [{ suffix: "Composite.astro", target: "astro" }];
-function selectCompositeFiles(files, target) {
-  return files.filter((file2) => {
-    const gate = TARGET_GATED_COMPOSITE_FILES.find((g2) => file2.path.endsWith(g2.suffix));
-    return gate ? gate.target === target : true;
-  });
+function getAll2() {
+  return Array.from(composites.values());
 }
-var FOLDER_NAMES = /* @__PURE__ */ new Set(["composites"]);
-function isAlreadyInstalled(config2, item) {
-  if (!config2?.installed) return false;
-  const { components, primitives, composites: composites2, rules, substrate } = config2.installed;
-  const bucketByType = {
-    ui: components,
-    primitive: primitives,
-    composite: composites2 ?? [],
-    rule: rules ?? [],
-    substrate: substrate ?? []
-  };
-  return bucketByType[item.type].includes(item.name);
+function getByCategory(category) {
+  return getAll2().filter((c4) => c4.manifest.category === category);
 }
-function isInstalledOnDisk(config2, item, cwd) {
-  if (!isAlreadyInstalled(config2, item)) return false;
-  const filesToCheck = item.type === "ui" ? selectFilesForFramework(item.files, getComponentTarget(config2)).files : item.files;
-  for (const file2 of filesToCheck) {
-    if (fileExists(cwd, transformPath(file2.path, config2, cwd))) return true;
+function search(query) {
+  if (query.length === 0) {
+    return getAll2();
   }
-  return false;
+  return getAll2().map((c4) => {
+    const { name, keywords } = c4.manifest;
+    const score = Math.max(fuzzyScore(query, name), ...keywords.map((k) => fuzzyScore(query, k)));
+    return { c: c4, score };
+  }).filter((entry) => entry.score > 0).sort((a2, b2) => b2.score - a2.score).map((entry) => entry.c);
 }
-function trackInstalled(config2, items) {
-  if (!config2.installed) {
-    config2.installed = {
-      components: [],
-      primitives: [],
-      composites: [],
-      rules: []
-    };
-  }
-  const installed = config2.installed;
-  if (!installed.composites) installed.composites = [];
-  if (!installed.rules) installed.rules = [];
-  if (!installed.substrate) installed.substrate = [];
-  const bucketByType = {
-    ui: installed.components,
-    primitive: installed.primitives,
-    composite: installed.composites,
-    rule: installed.rules,
-    substrate: installed.substrate
-  };
-  for (const item of items) {
-    const bucket = bucketByType[item.type];
-    if (!bucket.includes(item.name)) bucket.push(item.name);
+
+// ../composites/src/to-mdx.ts
+var import_escape_html = __toESM(require_escape_html(), 1);
+
+// ../composites/src/discovery-node.ts
+import { readdir, readFile as readFile4 } from "fs/promises";
+import { join as join8 } from "path";
+var COMPOSITE_SUFFIX = ".composite.json";
+async function readDir(directory) {
+  const entries = [];
+  let dirents;
+  try {
+    dirents = await readdir(directory, { withFileTypes: true });
+  } catch {
+    return entries;
   }
-  installed.components.sort();
-  installed.primitives.sort();
-  installed.composites.sort();
-  installed.rules.sort();
-  installed.substrate.sort();
-}
-function rootFor(field, cwd, fallback) {
-  return field === void 0 ? fallback : resolveRoot(field, cwd, fallback);
-}
-function transformPath(registryPath, config2, cwd = process.cwd()) {
-  if (!config2) return registryPath;
-  const replacements = [
-    ["components/ui/", config2.componentsPath, "components/ui"],
-    ["lib/primitives/", config2.primitivesPath, "lib/primitives"],
-    ["composites/", config2.compositesPath, "composites"],
-    ["rules/", config2.rulesPath, "lib/rules"]
-  ];
-  for (const [prefix, field, fallback] of replacements) {
-    if (registryPath.startsWith(prefix)) {
-      return registryPath.replace(prefix, `${rootFor(field, cwd, fallback)}/`);
+  for (const dirent of dirents) {
+    const fullPath = join8(directory, dirent.name);
+    if (dirent.isDirectory()) {
+      entries.push(...await readDir(fullPath));
+      continue;
+    }
+    if (dirent.isFile() && dirent.name.endsWith(COMPOSITE_SUFFIX)) {
+      const raw = await readFile4(fullPath, "utf-8");
+      entries.push({ raw, source: fullPath });
     }
   }
-  return registryPath;
+  return entries;
 }
-function substrateProjectPath(registryPath, config2, cwd = process.cwd()) {
-  const componentsResolved = rootFor(config2?.componentsPath, cwd, "components/ui");
-  const sourceRoot = componentsResolved.replace(/\/?components\/ui$/, "");
-  return sourceRoot ? join8(sourceRoot, registryPath) : registryPath;
+function nodeFsAdapter(...directories) {
+  return async () => {
+    const entries = [];
+    for (const directory of directories) {
+      entries.push(...await readDir(directory));
+    }
+    return entries;
+  };
 }
-function fileExists(cwd, relativePath) {
-  return existsSync4(join8(cwd, relativePath));
+async function discoverFromDirs(...directories) {
+  const adapter = nodeFsAdapter(...directories);
+  return discoverComposites(await adapter());
 }
-function transformFileContent(content, config2, fileType = "component", cwd = process.cwd(), opts = {}) {
-  const { substrateKinds = [], installPath } = opts;
-  let transformed = content;
-  const componentsPath = rootFor(config2?.componentsPath, cwd, "components/ui");
-  const primitivesPath = rootFor(config2?.primitivesPath, cwd, "lib/primitives");
-  const stripSourceRoot = (p2) => p2.replace(/^(src|app)\//, "");
-  const aliasComponents = stripSourceRoot(componentsPath);
-  const aliasPrimitives = stripSourceRoot(primitivesPath);
-  transformed = transformed.replace(
-    /from\s+['"]\.\.\/\.\.\/primitives\/([^'"]+)['"]/g,
-    `from '@/${aliasPrimitives}/$1'`
-  );
-  transformed = transformed.replace(
-    /from\s+['"]\.\.\/primitives\/([^'"]+)['"]/g,
-    `from '@/${aliasPrimitives}/$1'`
-  );
-  const substrateOwnDir = fileType === "substrate" && installPath ? stripSourceRoot(dirname(installPath)) : null;
-  const aliasSibling = fileType === "primitive" ? aliasPrimitives : substrateOwnDir ?? aliasComponents;
-  transformed = transformed.replace(/from\s+['"]\.\/([^'"]+)['"]/g, `from '@/${aliasSibling}/$1'`);
-  if (substrateKinds.length > 0) {
-    const kindAlternation = substrateKinds.join("|");
-    transformed = transformed.replace(
-      new RegExp(`from\\s+['"](?:\\.\\./){1,2}(${kindAlternation})/([^'"]+)['"]`, "g"),
-      "from '@/$1/$2'"
-    );
+
+// src/utils/workspaces.ts
+import { existsSync as existsSync5, readdirSync as readdirSync3, readFileSync as readFileSync2, statSync as statSync2 } from "fs";
+import { basename, dirname as dirname3, join as join10, resolve as resolve4 } from "path";
+
+// src/utils/discover.ts
+import { existsSync as existsSync4 } from "fs";
+import { dirname as dirname2, join as join9, resolve as resolve3 } from "path";
+function discoverProjectRoot(startDir) {
+  let current = resolve3(startDir);
+  for (; ; ) {
+    const configPath2 = join9(current, ".rafters", "config.rafters.json");
+    if (existsSync4(configPath2)) {
+      return current;
+    }
+    const parent = dirname2(current);
+    if (parent === current) {
+      return null;
+    }
+    current = parent;
   }
-  transformed = transformed.replace(
-    /from\s+['"]\.\.\/([^/'"]+)\/\1([^'"]*)['"]/g,
-    `from '@/${aliasComponents}/$1$2'`
-  );
-  transformed = transformed.replace(
-    /from\s+['"]\.\.\/([^'"]+)['"]/g,
-    `from '@/${aliasComponents}/$1'`
-  );
-  return transformed;
 }
-async function installItem(cwd, item, options, config2, substrateKinds = []) {
-  const installedFiles = [];
-  let skipped = false;
-  let filesToInstall = item.files;
-  if (item.type === "ui") {
-    const target = getComponentTarget(config2);
-    const selection = selectFilesForFramework(item.files, target);
-    filesToInstall = selection.files;
-    if (selection.fallback) {
-      log({
-        event: "add:fallback",
-        component: item.name,
-        target,
-        message: `No ${targetToExtension(target)} version available for ${item.name}. Installing React version.`
-      });
+
+// src/utils/workspaces.ts
+function findMonorepoRoot(startDir, boundary) {
+  let current = resolve4(startDir);
+  const stopAt = boundary ? resolve4(boundary) : null;
+  for (; ; ) {
+    const pnpmWorkspace = join10(current, "pnpm-workspace.yaml");
+    if (existsSync5(pnpmWorkspace)) {
+      const patterns = parsePnpmWorkspaceYaml(readFileSync2(pnpmWorkspace, "utf-8"));
+      if (patterns.length > 0) {
+        return { root: current, patterns };
+      }
     }
-    const hasComponentFile = selection.files.some((f) => !isSharedFile(f.path));
-    if (!hasComponentFile) {
-      throw new Error(
-        `No ${targetToExtension(target)} version available for "${item.name}" and no compatible fallback exists.`
-      );
+    const pkgJson = join10(current, "package.json");
+    if (existsSync5(pkgJson)) {
+      const patterns = parsePackageJsonWorkspaces(readFileSync2(pkgJson, "utf-8"));
+      if (patterns.length > 0) {
+        return { root: current, patterns };
+      }
     }
-  } else if (item.type === "composite") {
-    filesToInstall = selectCompositeFiles(item.files, getComponentTarget(config2));
+    if (stopAt && current === stopAt) return null;
+    const parent = dirname3(current);
+    if (parent === current) return null;
+    current = parent;
   }
-  for (const file2 of filesToInstall) {
-    const projectPath2 = item.type === "substrate" ? substrateProjectPath(file2.path, config2, cwd) : transformPath(file2.path, config2, cwd);
-    const targetPath = join8(cwd, projectPath2);
-    if (fileExists(cwd, projectPath2)) {
-      if (!options.overwrite) {
-        log({
-          event: "add:skip",
-          component: item.name,
-          file: projectPath2,
-          reason: "exists"
-        });
-        skipped = true;
+}
+function parsePnpmWorkspaceYaml(content) {
+  const lines = content.split("\n");
+  const patterns = [];
+  let inPackages = false;
+  for (const rawLine of lines) {
+    const line = rawLine.replace(/#.*$/, "").trimEnd();
+    if (!line.trim()) continue;
+    if (/^packages\s*:/.test(line)) {
+      inPackages = true;
+      continue;
+    }
+    if (inPackages) {
+      const itemMatch = line.match(/^\s*-\s*(?:["']?)([^"'\s]+)(?:["']?)\s*$/);
+      if (itemMatch?.[1]) {
+        patterns.push(itemMatch[1]);
         continue;
       }
+      if (!/^\s/.test(line)) {
+        inPackages = false;
+      }
     }
-    await mkdir3(dirname(targetPath), { recursive: true });
-    const fileType = item.type === "primitive" ? "primitive" : item.type === "substrate" ? "substrate" : "component";
-    const transformedContent = transformFileContent(file2.content, config2, fileType, cwd, {
-      substrateKinds,
-      installPath: file2.path
-    });
-    await writeFile3(targetPath, transformedContent, "utf-8");
-    installedFiles.push(projectPath2);
   }
-  return {
-    installed: installedFiles.length > 0,
-    skipped,
-    files: installedFiles
-  };
+  return patterns;
 }
-async function add(componentArgs, options) {
-  setAgentMode(options.agent ?? false);
-  let components = componentArgs;
-  const cwd = process.cwd();
-  const config2 = await loadConfig(cwd);
-  const client = new RegistryClient(resolveRegistryUrl(options, config2));
-  let folder;
-  const firstArg = components[0];
-  if (firstArg && FOLDER_NAMES.has(firstArg)) {
-    folder = firstArg;
-    components = components.slice(1);
+function parsePackageJsonWorkspaces(content) {
+  try {
+    const pkg = JSON.parse(content);
+    const ws = pkg.workspaces;
+    if (Array.isArray(ws)) {
+      return ws.filter((p2) => typeof p2 === "string");
+    }
+    if (ws && typeof ws === "object" && Array.isArray(ws.packages)) {
+      return ws.packages.filter((p2) => typeof p2 === "string");
+    }
+    return [];
+  } catch {
+    return [];
   }
-  if (options.list) {
-    const availableComponents = await client.listComponents();
-    const availableComposites = await client.listComposites();
-    if (options.agent) {
-      log({
-        event: "add:list",
-        components: availableComponents,
-        composites: availableComposites
-      });
-    } else {
-      console.log("Available components:\n");
-      for (const comp of availableComponents) {
-        console.log(`  ${comp.name}  ${comp.description ?? ""}`);
+}
+function expandPattern(monorepoRoot, pattern) {
+  const trimmed = pattern.replace(/\/+$/, "");
+  if (trimmed.endsWith("/*")) {
+    const parentRel = trimmed.slice(0, -2);
+    const parent = join10(monorepoRoot, parentRel);
+    if (!existsSync5(parent)) return [];
+    return readdirSync3(parent).map((entry) => join10(parent, entry)).filter((path) => {
+      try {
+        return statSync2(path).isDirectory();
+      } catch {
+        return false;
       }
-      if (availableComposites.length > 0) {
-        console.log("\nAvailable composites:\n");
-        for (const comp of availableComposites) {
-          console.log(`  ${comp.name}  ${comp.description ?? ""}`);
-        }
+    });
+  }
+  const literal2 = join10(monorepoRoot, trimmed);
+  if (existsSync5(literal2)) {
+    try {
+      if (statSync2(literal2).isDirectory()) return [literal2];
+    } catch {
+      return [];
+    }
+  }
+  return [];
+}
+function discoverWorkspaces(startDir = process.cwd(), options = {}) {
+  const layout = findMonorepoRoot(startDir, options.boundary);
+  if (!layout) {
+    const single = discoverProjectRoot(startDir);
+    if (!single) return [];
+    if (options.boundary && !single.startsWith(resolve4(options.boundary))) return [];
+    return [{ name: basename(single), root: single }];
+  }
+  const seen = /* @__PURE__ */ new Set();
+  const workspaces = [];
+  for (const pattern of layout.patterns) {
+    for (const dir of expandPattern(layout.root, pattern)) {
+      if (seen.has(dir)) continue;
+      seen.add(dir);
+      const config2 = join10(dir, ".rafters", "config.rafters.json");
+      if (existsSync5(config2)) {
+        workspaces.push({ name: basename(dir), root: dir });
       }
     }
-    return;
   }
-  const initialized = await isInitialized(cwd);
-  if (!initialized) {
-    error46("Project not initialized. Run `rafters init` first.");
-    process.exitCode = 1;
-    return;
+  const rootConfig = join10(layout.root, ".rafters", "config.rafters.json");
+  if (existsSync5(rootConfig) && !seen.has(layout.root)) {
+    workspaces.unshift({ name: basename(layout.root), root: layout.root });
   }
-  if (options.update) {
-    options.overwrite = true;
+  return workspaces;
+}
+function pickDefaultWorkspace(workspaces, startDir = process.cwd()) {
+  if (workspaces.length === 0) return null;
+  const cwd = resolve4(startDir);
+  const containing = workspaces.find((ws) => cwd === ws.root || cwd.startsWith(`${ws.root}/`));
+  if (containing) return containing;
+  if (workspaces.length === 1) return workspaces[0] ?? null;
+  return null;
+}
+function resolveWorkspace(workspaces, defaultWorkspace, name) {
+  if (name) {
+    return workspaces.find((ws) => ws.name === name) ?? null;
   }
-  let untrackedNames = [];
-  if (options.updateAll) {
-    options.overwrite = true;
-    if (!config2) {
-      error46("No rafters config found. Run 'rafters init' first.");
-      process.exitCode = 1;
-      return;
-    }
-    const trackedNames = getInstalledNames(config2);
-    untrackedNames = await discoverUntrackedNames(cwd, config2, client, trackedNames);
-    const candidates = [.../* @__PURE__ */ new Set([...trackedNames, ...untrackedNames])].sort();
-    if (candidates.length === 0) {
-      error46("No installed components found. Use 'rafters add <component>' to install first.");
-      process.exitCode = 1;
-      return;
+  return defaultWorkspace;
+}
+
+// src/mcp/graph.ts
+var EXPAND_OP = "*";
+var PROBE_OP = "?";
+function assembleGraph(items) {
+  const nodes = /* @__PURE__ */ new Map();
+  for (const item of items) {
+    const kind = kindOf(item.type);
+    if (kind === null) continue;
+    const src = item.intelligence;
+    const intel = {
+      dos: src?.usagePatterns?.dos ?? [],
+      nevers: src?.usagePatterns?.nevers ?? []
+    };
+    if (src?.cognitiveLoad !== void 0) intel.cognitiveLoad = src.cognitiveLoad;
+    if (src?.semanticMeaning !== void 0) intel.semanticMeaning = src.semanticMeaning;
+    if (src?.accessibility !== void 0) intel.accessibility = src.accessibility;
+    if (src?.attentionEconomics !== void 0) intel.attentionEconomics = src.attentionEconomics;
+    if (src?.trustBuilding !== void 0) intel.trustBuilding = src.trustBuilding;
+    const gn = {
+      id: item.name,
+      kind,
+      intel,
+      facets: item.facets ?? {},
+      composesWith: item.composites,
+      parts: []
+    };
+    if (item.parent !== void 0) gn.parent = item.parent;
+    nodes.set(item.name, gn);
+  }
+  for (const node of nodes.values()) {
+    if (node.parent === void 0) continue;
+    if (node.parent === node.id) {
+      throw new Error(`graph: node "${node.id}" parent references itself`);
     }
-    if (untrackedNames.length > 0) {
-      log({
-        event: "add:untracked",
-        components: untrackedNames,
-        message: `Found ${untrackedNames.length} component(s) on disk the config never tracked: ${untrackedNames.join(", ")}. Refreshing and tracking them.`
-      });
+    if (!nodes.has(node.parent)) {
+      throw new Error(`graph: node "${node.id}" parent names unknown id "${node.parent}"`);
     }
-    components = candidates;
-  }
-  if (folder === "composites" && components.length === 0) {
-    components = ["composites"];
-  }
-  if (components.length === 0) {
-    error46("No components specified. Usage: rafters add <component...>");
-    process.exitCode = 1;
-    return;
   }
-  log({
-    event: "add:start",
-    cwd,
-    components,
-    overwrite: options.overwrite ?? false
-  });
-  const allItems = [];
-  const seen = /* @__PURE__ */ new Set();
-  for (const itemName of components) {
-    try {
-      if (folder === "composites") {
-        if (!seen.has(itemName)) {
-          const composite = await client.fetchComposite(itemName);
-          seen.add(itemName);
-          allItems.push(composite);
-          for (const dep of composite.primitives) {
-            if (!seen.has(dep)) {
-              const depItems = await client.resolveDependencies(dep, seen);
-              allItems.push(...depItems);
-            }
-          }
-        }
-      } else {
-        const items = await client.resolveDependencies(itemName, seen);
-        allItems.push(...items);
-      }
-    } catch (err) {
-      if (err instanceof Error) {
-        error46(err.message);
-      } else {
-        error46(`Failed to fetch "${itemName}"`);
+  for (const node of nodes.values()) {
+    if (node.parent === void 0) continue;
+    const visited = /* @__PURE__ */ new Set();
+    visited.add(node.id);
+    let current = node.parent;
+    while (current !== void 0) {
+      if (visited.has(current)) {
+        throw new Error(
+          `graph: node "${node.id}" has a circular parent chain through "${current}"`
+        );
       }
-      process.exitCode = 1;
-      return;
+      visited.add(current);
+      current = nodes.get(current)?.parent;
     }
   }
-  const substrateKinds = [
-    ...new Set(
-      allItems.filter((item) => item.type === "substrate").map((item) => item.files[0]?.path.split("/")[0]).filter((segment) => Boolean(segment))
-    )
-  ];
-  const written = [];
-  const skipped = [];
-  const failed = [];
-  const installedItems = [];
-  const filteredItems = [];
-  const target = getComponentTarget(config2);
-  for (const item of allItems) {
-    if (!options.overwrite && isAlreadyInstalled(config2, item)) {
-      if (isInstalledOnDisk(config2, item, cwd)) {
-        log({
-          event: "add:skip",
-          component: item.name,
-          reason: "already installed"
-        });
-        skipped.push(item.name);
-        continue;
+  for (const node of nodes.values()) {
+    if (node.parent === void 0) continue;
+    const parentNode = nodes.get(node.parent);
+    if (parentNode) parentNode.parts.push(node.id);
+  }
+  for (const node of nodes.values()) {
+    for (const target of node.composesWith) {
+      if (!nodes.has(target)) {
+        throw new Error(`graph: node "${node.id}" composesWith unknown id "${target}"`);
       }
-      log({
-        event: "add:warning",
-        component: item.name,
-        message: "Config tracks this as installed but no files found on disk -- reinstalling."
-      });
     }
-    try {
-      const result = await installItem(cwd, item, options, config2, substrateKinds);
-      if (result.installed) {
-        written.push(item.name);
-        installedItems.push(item);
-        if (item.type === "ui") {
-          const selection = selectFilesForFramework(item.files, target);
-          filteredItems.push({ ...item, files: selection.files });
-        } else {
-          filteredItems.push(item);
-        }
-        log({
-          event: "add:installed",
-          component: item.name,
-          type: item.type,
-          files: result.files
-        });
-      }
-      if (result.skipped && !result.installed) {
-        skipped.push(item.name);
-        installedItems.push(item);
-      }
-    } catch (err) {
-      failed.push(item.name);
-      if (err instanceof Error) {
-        log({
-          event: "add:warning",
-          component: item.name,
-          message: err.message
-        });
-      }
+  }
+  return { nodes };
+}
+function kindOf(type2) {
+  if (type2 === "composite") return "composite";
+  if (type2 === "ui" || type2 === "primitive") return "component";
+  return null;
+}
+function describe(addr, graph, target) {
+  const parts = addr === "" ? [] : addr.split(".");
+  if (parts.length === 0) {
+    return {
+      kinds: [
+        { addr: "components", type: "edge" },
+        { addr: "composites", type: "edge" }
+      ],
+      nodeCount: graph.nodes.size
+    };
+  }
+  const [head, ...rest] = parts;
+  if (head === void 0) return { error: `cannot resolve: ${addr}` };
+  if (head === "components" || head === "composites") {
+    if (rest.length > 0) return { error: `cannot expand: ${addr}` };
+    const kind = head === "components" ? "component" : "composite";
+    const roster = [];
+    for (const node2 of graph.nodes.values()) {
+      if (node2.kind === kind) roster.push({ id: node2.id });
     }
+    return roster;
   }
-  const emptyDeps = {
-    installed: [],
-    skipped: [],
-    devInstalled: [],
-    failed: []
-  };
-  let depsResult = emptyDeps;
-  try {
-    depsResult = await installRegistryDependencies(filteredItems, cwd, {
-      target
-    });
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    log({
-      event: "add:deps:install-failed",
-      message: `Failed to process dependencies: ${message}`,
-      dependencies: [],
-      suggestion: "Check package.json and try installing dependencies manually."
-    });
+  if (parts[parts.length - 1] === PROBE_OP) {
+    const baseAddr = parts.slice(0, -1).join(".");
+    const result = describe(baseAddr, graph, target);
+    if (typeof result === "object" && result !== null && "error" in result) return null;
+    return result;
   }
-  if (depsResult.installed.length > 0 || depsResult.skipped.length > 0) {
-    log({
-      event: "add:dependencies",
-      dependencies: depsResult.installed,
-      devDependencies: depsResult.devInstalled,
-      skipped: depsResult.skipped
-    });
+  if (head === EXPAND_OP || head === PROBE_OP) {
+    return { error: `cannot expand at root: use 'components' or 'composites'` };
   }
-  if (installedItems.length > 0 && config2) {
-    trackInstalled(config2, installedItems);
-    await saveConfig(cwd, config2);
-    await regenerateAfterInstall(cwd, config2);
-  } else if (installedItems.length > 0 && !config2) {
-    const newConfig = {
-      framework: "unknown",
-      componentsPath: "components/ui",
-      primitivesPath: "lib/primitives",
-      compositesPath: "composites",
-      rulesPath: "lib/rules",
-      cssPath: null,
-      intent: "efficient",
-      fonts: { path: null, imports: [] },
-      exports: DEFAULT_EXPORTS,
-      installed: { components: [], primitives: [], composites: [], rules: [] }
-    };
-    trackInstalled(newConfig, installedItems);
-    await saveConfig(cwd, newConfig);
-    await regenerateAfterInstall(cwd, newConfig);
+  const node = graph.nodes.get(head);
+  if (!node) return { error: `unknown node: ${head}` };
+  if (rest.length === 0) return layer0(node, graph, target);
+  if (rest[rest.length - 1] === EXPAND_OP) {
+    const prefix = rest.slice(0, -1);
+    if (prefix.length === 0) return expandNode(node, target);
+    if (prefix.length === 1 && prefix[0] === "props") return expandProps(node, target);
+    return { error: `cannot expand: ${addr}` };
   }
-  log({
-    event: "add:complete",
-    written: written.length,
-    skipped: skipped.length,
-    untracked: untrackedNames.length,
-    failed: failed.length,
-    components: written,
-    skippedComponents: skipped,
-    untrackedComponents: untrackedNames,
-    failedComponents: failed
-  });
-  if (failed.length > 0) {
-    process.exitCode = 1;
+  if (rest.length === 1 && rest[0] === "composesWith") {
+    return resolveEdges(node, graph, target);
   }
-  if (!options.updateAll && skipped.length > 0 && written.length === 0) {
-    log({
-      event: "add:hint",
-      message: "Some components were skipped. Use --update to re-fetch, or --update-all to refresh everything.",
-      skipped
-    });
-    error46("Component already exists. Use --update to re-fetch from registry.");
-    process.exitCode = 1;
+  if (rest[0] === "props") {
+    const facet = target === void 0 ? void 0 : node.facets[target];
+    const propName = rest[1];
+    const prop = facet && propName !== void 0 ? facet.props[propName] : void 0;
+    if (!prop) return { error: `cannot resolve: ${addr}` };
+    if (rest.length === 2) return toAgentProp(prop);
+    return { error: `cannot resolve: ${addr}` };
   }
+  return { error: `cannot resolve: ${addr}` };
 }
-
-// src/commands/mcp.ts
-import { existsSync as existsSync7 } from "fs";
-import { basename as basename2, join as join13, resolve as resolve5 } from "path";
-
-// src/mcp/server.ts
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
-
-// src/version.ts
-import { readFileSync as readFileSync2 } from "fs";
-var UNKNOWN_VERSION = "0.0.0-unknown";
-function readVersion() {
-  try {
-    const parsed = JSON.parse(
-      readFileSync2(new URL("../package.json", import.meta.url), "utf-8")
-    );
-    if (parsed !== null && typeof parsed === "object" && "version" in parsed) {
-      const { version: version2 } = parsed;
-      if (typeof version2 === "string" && version2.length > 0) return version2;
-    }
-  } catch {
+function toAgentProp(prop) {
+  if (prop.type === "grammar") {
+    const { vocab: _vocab, ...agentView } = prop;
+    return agentView;
   }
-  return UNKNOWN_VERSION;
+  return prop;
 }
-var VERSION = readVersion();
-
-// src/mcp/tools.ts
-import { readFile as readFile6, writeFile as writeFile4 } from "fs/promises";
-import { isAbsolute as isAbsolute3, join as join12 } from "path";
-
-// ../composites/src/built-in-rules/email.ts
-var email3 = external_exports.string().email();
-
-// ../composites/src/built-in-rules/credentials.ts
-var credentials = external_exports.object({ email: email3, password: external_exports.string().min(8) });
-
-// ../composites/src/built-in-rules/password.ts
-var password = external_exports.string().min(8);
-
-// ../composites/src/built-in-rules/required.ts
-var required2 = external_exports.string().min(1);
-
-// ../composites/src/built-in-rules/url.ts
-var url2 = external_exports.string().url();
-
-// ../composites/src/manifest.ts
-var CompositeCategorySchema = external_exports.string().min(1);
-var AppliedRuleSchema = external_exports.union([
-  external_exports.string(),
-  external_exports.object({
-    name: external_exports.string().min(1),
-    config: external_exports.record(external_exports.string(), external_exports.unknown())
-  })
-]);
-var CompositeBlockSchema = external_exports.object({
-  id: external_exports.string().min(1),
-  type: external_exports.string().min(1),
-  /** Signatures this block consumes / produces (rule names) -- the typed I/O edges.
-   * Within a composite, an output named X feeds any block input named X. */
-  input: external_exports.array(external_exports.string()).optional(),
-  output: external_exports.array(external_exports.string()).optional(),
-  content: external_exports.unknown().optional(),
-  children: external_exports.array(external_exports.string()).optional(),
-  parentId: external_exports.string().optional(),
-  meta: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
-  rules: external_exports.array(AppliedRuleSchema).optional()
-});
-var UsagePatternsSchema2 = external_exports.object({
-  do: external_exports.array(external_exports.string()),
-  never: external_exports.array(external_exports.string())
-});
-var CompositeManifestSchema = external_exports.object({
-  id: external_exports.string().min(1).regex(/^[a-z0-9-]+$/),
-  name: external_exports.string().min(1),
-  category: CompositeCategorySchema,
-  description: external_exports.string(),
-  keywords: external_exports.array(external_exports.string()),
-  cognitiveLoad: external_exports.number().int().min(1).max(10),
-  // Designer intent fields (optional for backwards compatibility)
-  solves: external_exports.string().optional(),
-  appliesWhen: external_exports.array(external_exports.string()).optional(),
-  usagePatterns: UsagePatternsSchema2.optional()
-});
-var CompositeFileSchema = external_exports.object({
-  manifest: CompositeManifestSchema,
-  input: external_exports.array(external_exports.string()).default([]),
-  output: external_exports.array(external_exports.string()).default([]),
-  blocks: external_exports.array(CompositeBlockSchema).min(1)
-});
-
-// ../composites/src/discovery.ts
-function discoverComposites(entries) {
-  const registry2 = /* @__PURE__ */ new Map();
-  const errors = [];
-  for (const entry of entries) {
-    let parsed;
-    try {
-      parsed = JSON.parse(entry.raw);
-    } catch (e) {
-      errors.push({
-        source: entry.source,
-        error: `Invalid JSON: ${e instanceof Error ? e.message : String(e)}`
-      });
-      continue;
-    }
-    const result = CompositeFileSchema.safeParse(parsed);
-    if (!result.success) {
-      errors.push({ source: entry.source, error: result.error.message });
-      continue;
+function layer0(node, graph, target) {
+  const facet = target === void 0 ? void 0 : node.facets[target];
+  const children = [];
+  if (facet) {
+    for (const [name, prop] of Object.entries(facet.props)) {
+      const child = { addr: `${node.id}.props.${name}`, type: prop.type };
+      if (prop.type === "deprecated") child.deprecatedFor = prop.deprecatedFor;
+      children.push(child);
     }
-    const { id } = result.data.manifest;
-    if (registry2.has(id)) {
-      errors.push({
-        source: entry.source,
-        error: `Duplicate composite id "${id}" (already registered)`
-      });
-      continue;
+  }
+  if (node.composesWith.length > 0) {
+    children.push({ addr: `${node.id}.composesWith`, type: "edge" });
+  }
+  for (const partId of node.parts) {
+    children.push({ addr: partId, type: "part" });
+  }
+  const result = { id: node.id, kind: node.kind, intel: node.intel, children };
+  if (facet) {
+    result.snippet = facet.snippet;
+    if (facet.slots !== void 0) result.slots = facet.slots;
+    if (facet.events !== void 0) result.events = facet.events;
+  }
+  if (node.parent !== void 0) {
+    result.parent = node.parent;
+    const parentNode = graph.nodes.get(node.parent);
+    if (parentNode) {
+      const siblings = parentNode.parts.filter((id) => id !== node.id);
+      if (siblings.length > 0) result.siblings = siblings;
     }
-    registry2.set(id, result.data);
   }
-  reportUnresolvedReferences(registry2, errors);
-  return { registry: registry2, errors };
+  return result;
 }
-var COMPOSITE_PREFIX = "composite:";
-function reportUnresolvedReferences(registry2, errors) {
-  for (const [id, composite] of registry2) {
-    const missing = /* @__PURE__ */ new Set();
-    for (const block of composite.blocks) {
-      if (block.type.startsWith(COMPOSITE_PREFIX)) {
-        const refId = block.type.slice(COMPOSITE_PREFIX.length);
-        if (!registry2.has(refId)) {
-          missing.add(refId);
-        }
-      }
-    }
-    if (missing.size > 0) {
-      errors.push({
-        source: id,
-        error: `Unresolved composite reference(s): ${[...missing].map((m3) => `composite:${m3}`).join(", ")}`
-      });
+function resolveEdges(node, graph, target) {
+  const seen = /* @__PURE__ */ new Set();
+  const results = [];
+  for (const edgeId of node.composesWith) {
+    if (seen.has(edgeId)) continue;
+    seen.add(edgeId);
+    const edgeNode = graph.nodes.get(edgeId);
+    if (edgeNode) results.push(layer0(edgeNode, graph, target));
+  }
+  return results;
+}
+function expandProps(node, target) {
+  const facet = target === void 0 ? void 0 : node.facets[target];
+  const props = {};
+  if (facet) {
+    for (const [name, prop] of Object.entries(facet.props)) {
+      props[name] = toAgentProp(prop);
     }
   }
+  return { expanded: true, props };
 }
-
-// ../ui/src/primitives/typeahead.ts
-function fuzzyScore(query, target) {
-  if (query.length === 0) return 1;
-  if (query.length > target.length) return 0;
-  const q = query.toLowerCase();
-  const t = target.toLowerCase();
-  let score = 0;
-  let qi = 0;
-  let prevMatchIndex = -2;
-  for (let ti = 0; ti < t.length && qi < q.length; ti++) {
-    if (t[ti] === q[qi]) {
-      score += 1;
-      if (ti === prevMatchIndex + 1) {
-        score += 2;
-      }
-      if (ti === 0 || t[ti - 1] === " " || t[ti - 1] === "-") {
-        score += 3;
-      }
-      prevMatchIndex = ti;
-      qi++;
+function expandNode(node, target) {
+  const facet = target === void 0 ? void 0 : node.facets[target];
+  const props = {};
+  if (facet) {
+    for (const [name, prop] of Object.entries(facet.props)) {
+      props[name] = toAgentProp(prop);
     }
   }
-  return qi === q.length ? score : 0;
+  const result = {
+    id: node.id,
+    kind: node.kind,
+    intel: node.intel,
+    props
+  };
+  if (node.composesWith.length > 0) result.composesWith = node.composesWith;
+  if (node.parts.length > 0) result.parts = node.parts;
+  if (facet) {
+    result.snippet = facet.snippet;
+    if (facet.slots !== void 0) result.slots = facet.slots;
+    if (facet.events !== void 0) result.events = facet.events;
+  }
+  return result;
 }
 
-// ../composites/src/registry.ts
-var composites = /* @__PURE__ */ new Map();
-function register3(composite) {
-  const { id } = composite.manifest;
-  if (composites.has(id)) {
-    throw new Error(`Composite "${id}" is already registered`);
+// src/mcp/intent.ts
+var INTENT_TAGS = {
+  modal: ["attention", "blocking", "above-all", "focus-trap"],
+  alert: ["attention", "inline", "passive"],
+  tooltip: ["hint", "passive", "inline", "hover"]
+};
+var INTENT_AXES = [
+  {
+    tag: "above-all",
+    keywords: [
+      "above everything",
+      "above all",
+      "on top of everything",
+      "sits on top",
+      "on top",
+      "over everything",
+      "over all",
+      "topmost",
+      "highest layer"
+    ]
+  },
+  {
+    tag: "blocking",
+    keywords: [
+      "above everything",
+      "on top of everything",
+      "over everything",
+      "block",
+      "blocking",
+      "must dismiss",
+      "interrupt",
+      "take over",
+      "stops everything",
+      "requires a response",
+      "can't ignore",
+      "cannot ignore"
+    ]
+  },
+  {
+    tag: "inline",
+    keywords: ["inline", "in place", "in the flow", "within the page", "non-blocking"]
+  },
+  {
+    tag: "passive",
+    keywords: ["passive", "non-intrusive", "subtle", "quietly", "in the background"]
+  },
+  {
+    tag: "attention",
+    keywords: ["attention", "notice", "get noticed", "important message"]
+  },
+  {
+    tag: "hint",
+    keywords: ["hint", "a tip", "explain", "extra info", "more info"]
+  },
+  {
+    tag: "hover",
+    keywords: ["hover", "on hover", "mouse over"]
   }
-  composites.set(id, composite);
-}
-function getAll2() {
-  return Array.from(composites.values());
+];
+function isNaturalLanguageQuery(input) {
+  return input.includes(" ");
 }
-function getByCategory(category) {
-  return getAll2().filter((c4) => c4.manifest.category === category);
+function matchIntent(query, graph) {
+  const normalized = query.toLowerCase();
+  const matchedTags = collectMatchedTags(normalized);
+  if (matchedTags.size === 0) return noMatch();
+  const winner = selectUse(matchedTags, graph);
+  if (winner === void 0) return noMatch();
+  const winningTags = winner.tags.filter((tag) => matchedTags.has(tag));
+  const decisive = new Set(winningTags);
+  const nearMiss = selectNearMiss(winner, decisive, matchedTags, graph);
+  if (nearMiss === void 0) return noMatch();
+  const use = describeNode(winner.id, graph);
+  const not = describeNode(nearMiss.id, graph);
+  if (use === void 0 || not === void 0) return noMatch();
+  const divergingTags = nearMiss.tags.filter((tag) => !winner.tags.includes(tag));
+  const because = `${winner.id} is ${winningTags.join("/")}; ${nearMiss.id} is ${divergingTags.join("/")}`;
+  return { use, not, because };
 }
-function search(query) {
-  if (query.length === 0) {
-    return getAll2();
+function collectMatchedTags(normalizedQuery) {
+  const matched = /* @__PURE__ */ new Set();
+  for (const axis of INTENT_AXES) {
+    for (const keyword of axis.keywords) {
+      if (normalizedQuery.includes(keyword)) {
+        matched.add(axis.tag);
+        break;
+      }
+    }
   }
-  return getAll2().map((c4) => {
-    const { name, keywords } = c4.manifest;
-    const score = Math.max(fuzzyScore(query, name), ...keywords.map((k) => fuzzyScore(query, k)));
-    return { c: c4, score };
-  }).filter((entry) => entry.score > 0).sort((a2, b2) => b2.score - a2.score).map((entry) => entry.c);
+  return matched;
 }
-
-// ../composites/src/to-mdx.ts
-var import_escape_html = __toESM(require_escape_html(), 1);
-
-// ../composites/src/discovery-node.ts
-import { readdir, readFile as readFile5 } from "fs/promises";
-import { join as join9 } from "path";
-var COMPOSITE_SUFFIX = ".composite.json";
-async function readDir(directory) {
-  const entries = [];
-  let dirents;
-  try {
-    dirents = await readdir(directory, { withFileTypes: true });
-  } catch {
-    return entries;
-  }
-  for (const dirent of dirents) {
-    const fullPath = join9(directory, dirent.name);
-    if (dirent.isDirectory()) {
-      entries.push(...await readDir(fullPath));
-      continue;
-    }
-    if (dirent.isFile() && dirent.name.endsWith(COMPOSITE_SUFFIX)) {
-      const raw = await readFile5(fullPath, "utf-8");
-      entries.push({ raw, source: fullPath });
+function selectUse(matchedTags, graph) {
+  let best;
+  let bestScore = 0;
+  for (const [id, tags] of Object.entries(INTENT_TAGS)) {
+    if (!graph.nodes.has(id)) continue;
+    const score = tags.reduce((sum, tag) => matchedTags.has(tag) ? sum + 1 : sum, 0);
+    if (score > bestScore) {
+      bestScore = score;
+      best = { id, tags };
     }
   }
-  return entries;
+  return best;
 }
-function nodeFsAdapter(...directories) {
-  return async () => {
-    const entries = [];
-    for (const directory of directories) {
-      entries.push(...await readDir(directory));
+function selectNearMiss(use, decisive, matchedTags, graph) {
+  let best;
+  let bestOverlap = 0;
+  for (const [id, tags] of Object.entries(INTENT_TAGS)) {
+    if (id === use.id || !graph.nodes.has(id)) continue;
+    if (tags.some((tag) => decisive.has(tag))) continue;
+    const overlap = tags.filter((tag) => use.tags.includes(tag));
+    const sharesOutsideMatched = overlap.some((tag) => !matchedTags.has(tag));
+    if (!sharesOutsideMatched) continue;
+    if (overlap.length > bestOverlap) {
+      bestOverlap = overlap.length;
+      best = { id, tags };
     }
-    return entries;
-  };
+  }
+  return best;
 }
-async function discoverFromDirs(...directories) {
-  const adapter = nodeFsAdapter(...directories);
-  return discoverComposites(await adapter());
+function describeNode(id, graph) {
+  const result = describe(id, graph);
+  if (result !== null && !Array.isArray(result) && "children" in result) return result;
+  return void 0;
 }
-
-// src/utils/workspaces.ts
-import { existsSync as existsSync6, readdirSync as readdirSync3, readFileSync as readFileSync3, statSync as statSync2 } from "fs";
-import { basename, dirname as dirname3, join as join11, resolve as resolve4 } from "path";
-
-// src/utils/discover.ts
-import { existsSync as existsSync5 } from "fs";
-import { dirname as dirname2, join as join10, resolve as resolve3 } from "path";
-function discoverProjectRoot(startDir) {
-  let current = resolve3(startDir);
-  for (; ; ) {
-    const configPath2 = join10(current, ".rafters", "config.rafters.json");
-    if (existsSync5(configPath2)) {
-      return current;
-    }
-    const parent = dirname2(current);
-    if (parent === current) {
-      return null;
-    }
-    current = parent;
-  }
-}
-
-// src/utils/workspaces.ts
-function findMonorepoRoot(startDir, boundary) {
-  let current = resolve4(startDir);
-  const stopAt = boundary ? resolve4(boundary) : null;
-  for (; ; ) {
-    const pnpmWorkspace = join11(current, "pnpm-workspace.yaml");
-    if (existsSync6(pnpmWorkspace)) {
-      const patterns = parsePnpmWorkspaceYaml(readFileSync3(pnpmWorkspace, "utf-8"));
-      if (patterns.length > 0) {
-        return { root: current, patterns };
-      }
-    }
-    const pkgJson = join11(current, "package.json");
-    if (existsSync6(pkgJson)) {
-      const patterns = parsePackageJsonWorkspaces(readFileSync3(pkgJson, "utf-8"));
-      if (patterns.length > 0) {
-        return { root: current, patterns };
-      }
-    }
-    if (stopAt && current === stopAt) return null;
-    const parent = dirname3(current);
-    if (parent === current) return null;
-    current = parent;
-  }
-}
-function parsePnpmWorkspaceYaml(content) {
-  const lines = content.split("\n");
-  const patterns = [];
-  let inPackages = false;
-  for (const rawLine of lines) {
-    const line = rawLine.replace(/#.*$/, "").trimEnd();
-    if (!line.trim()) continue;
-    if (/^packages\s*:/.test(line)) {
-      inPackages = true;
-      continue;
-    }
-    if (inPackages) {
-      const itemMatch = line.match(/^\s*-\s*(?:["']?)([^"'\s]+)(?:["']?)\s*$/);
-      if (itemMatch?.[1]) {
-        patterns.push(itemMatch[1]);
-        continue;
-      }
-      if (!/^\s/.test(line)) {
-        inPackages = false;
-      }
-    }
-  }
-  return patterns;
-}
-function parsePackageJsonWorkspaces(content) {
-  try {
-    const pkg = JSON.parse(content);
-    const ws = pkg.workspaces;
-    if (Array.isArray(ws)) {
-      return ws.filter((p2) => typeof p2 === "string");
-    }
-    if (ws && typeof ws === "object" && Array.isArray(ws.packages)) {
-      return ws.packages.filter((p2) => typeof p2 === "string");
-    }
-    return [];
-  } catch {
-    return [];
-  }
-}
-function expandPattern(monorepoRoot, pattern) {
-  const trimmed = pattern.replace(/\/+$/, "");
-  if (trimmed.endsWith("/*")) {
-    const parentRel = trimmed.slice(0, -2);
-    const parent = join11(monorepoRoot, parentRel);
-    if (!existsSync6(parent)) return [];
-    return readdirSync3(parent).map((entry) => join11(parent, entry)).filter((path) => {
-      try {
-        return statSync2(path).isDirectory();
-      } catch {
-        return false;
-      }
-    });
-  }
-  const literal2 = join11(monorepoRoot, trimmed);
-  if (existsSync6(literal2)) {
-    try {
-      if (statSync2(literal2).isDirectory()) return [literal2];
-    } catch {
-      return [];
-    }
-  }
-  return [];
-}
-function discoverWorkspaces(startDir = process.cwd(), options = {}) {
-  const layout = findMonorepoRoot(startDir, options.boundary);
-  if (!layout) {
-    const single = discoverProjectRoot(startDir);
-    if (!single) return [];
-    if (options.boundary && !single.startsWith(resolve4(options.boundary))) return [];
-    return [{ name: basename(single), root: single }];
-  }
-  const seen = /* @__PURE__ */ new Set();
-  const workspaces = [];
-  for (const pattern of layout.patterns) {
-    for (const dir of expandPattern(layout.root, pattern)) {
-      if (seen.has(dir)) continue;
-      seen.add(dir);
-      const config2 = join11(dir, ".rafters", "config.rafters.json");
-      if (existsSync6(config2)) {
-        workspaces.push({ name: basename(dir), root: dir });
-      }
-    }
-  }
-  const rootConfig = join11(layout.root, ".rafters", "config.rafters.json");
-  if (existsSync6(rootConfig) && !seen.has(layout.root)) {
-    workspaces.unshift({ name: basename(layout.root), root: layout.root });
-  }
-  return workspaces;
-}
-function pickDefaultWorkspace(workspaces, startDir = process.cwd()) {
-  if (workspaces.length === 0) return null;
-  const cwd = resolve4(startDir);
-  const containing = workspaces.find((ws) => cwd === ws.root || cwd.startsWith(`${ws.root}/`));
-  if (containing) return containing;
-  if (workspaces.length === 1) return workspaces[0] ?? null;
-  return null;
-}
-function resolveWorkspace(workspaces, defaultWorkspace, name) {
-  if (name) {
-    return workspaces.find((ws) => ws.name === name) ?? null;
-  }
-  return defaultWorkspace;
-}
-
-// src/mcp/graph.ts
-var EXPAND_OP = "*";
-var PROBE_OP = "?";
-function assembleGraph(items) {
-  const nodes = /* @__PURE__ */ new Map();
-  for (const item of items) {
-    const kind = kindOf(item.type);
-    if (kind === null) continue;
-    const src = item.intelligence;
-    const intel = {
-      dos: src?.usagePatterns?.dos ?? [],
-      nevers: src?.usagePatterns?.nevers ?? []
-    };
-    if (src?.cognitiveLoad !== void 0) intel.cognitiveLoad = src.cognitiveLoad;
-    if (src?.semanticMeaning !== void 0) intel.semanticMeaning = src.semanticMeaning;
-    if (src?.accessibility !== void 0) intel.accessibility = src.accessibility;
-    if (src?.attentionEconomics !== void 0) intel.attentionEconomics = src.attentionEconomics;
-    if (src?.trustBuilding !== void 0) intel.trustBuilding = src.trustBuilding;
-    const gn = {
-      id: item.name,
-      kind,
-      intel,
-      facets: item.facets ?? {},
-      composesWith: item.composites,
-      parts: []
-    };
-    if (item.parent !== void 0) gn.parent = item.parent;
-    nodes.set(item.name, gn);
-  }
-  for (const node of nodes.values()) {
-    if (node.parent === void 0) continue;
-    if (node.parent === node.id) {
-      throw new Error(`graph: node "${node.id}" parent references itself`);
-    }
-    if (!nodes.has(node.parent)) {
-      throw new Error(`graph: node "${node.id}" parent names unknown id "${node.parent}"`);
-    }
-  }
-  for (const node of nodes.values()) {
-    if (node.parent === void 0) continue;
-    const visited = /* @__PURE__ */ new Set();
-    visited.add(node.id);
-    let current = node.parent;
-    while (current !== void 0) {
-      if (visited.has(current)) {
-        throw new Error(
-          `graph: node "${node.id}" has a circular parent chain through "${current}"`
-        );
-      }
-      visited.add(current);
-      current = nodes.get(current)?.parent;
-    }
-  }
-  for (const node of nodes.values()) {
-    if (node.parent === void 0) continue;
-    const parentNode = nodes.get(node.parent);
-    if (parentNode) parentNode.parts.push(node.id);
-  }
-  for (const node of nodes.values()) {
-    for (const target of node.composesWith) {
-      if (!nodes.has(target)) {
-        throw new Error(`graph: node "${node.id}" composesWith unknown id "${target}"`);
-      }
-    }
-  }
-  return { nodes };
-}
-function kindOf(type2) {
-  if (type2 === "composite") return "composite";
-  if (type2 === "ui" || type2 === "primitive") return "component";
-  return null;
-}
-function describe(addr, graph, target) {
-  const parts = addr === "" ? [] : addr.split(".");
-  if (parts.length === 0) {
-    return {
-      kinds: [
-        { addr: "components", type: "edge" },
-        { addr: "composites", type: "edge" }
-      ],
-      nodeCount: graph.nodes.size
-    };
-  }
-  const [head, ...rest] = parts;
-  if (head === void 0) return { error: `cannot resolve: ${addr}` };
-  if (head === "components" || head === "composites") {
-    if (rest.length > 0) return { error: `cannot expand: ${addr}` };
-    const kind = head === "components" ? "component" : "composite";
-    const roster = [];
-    for (const node2 of graph.nodes.values()) {
-      if (node2.kind === kind) roster.push({ id: node2.id });
-    }
-    return roster;
-  }
-  if (parts[parts.length - 1] === PROBE_OP) {
-    const baseAddr = parts.slice(0, -1).join(".");
-    const result = describe(baseAddr, graph, target);
-    if (typeof result === "object" && result !== null && "error" in result) return null;
-    return result;
-  }
-  if (head === EXPAND_OP || head === PROBE_OP) {
-    return { error: `cannot expand at root: use 'components' or 'composites'` };
-  }
-  const node = graph.nodes.get(head);
-  if (!node) return { error: `unknown node: ${head}` };
-  if (rest.length === 0) return layer0(node, graph, target);
-  if (rest[rest.length - 1] === EXPAND_OP) {
-    const prefix = rest.slice(0, -1);
-    if (prefix.length === 0) return expandNode(node, target);
-    if (prefix.length === 1 && prefix[0] === "props") return expandProps(node, target);
-    return { error: `cannot expand: ${addr}` };
-  }
-  if (rest.length === 1 && rest[0] === "composesWith") {
-    return resolveEdges(node, graph, target);
-  }
-  if (rest[0] === "props") {
-    const facet = target === void 0 ? void 0 : node.facets[target];
-    const propName = rest[1];
-    const prop = facet && propName !== void 0 ? facet.props[propName] : void 0;
-    if (!prop) return { error: `cannot resolve: ${addr}` };
-    if (rest.length === 2) return toAgentProp(prop);
-    return { error: `cannot resolve: ${addr}` };
-  }
-  return { error: `cannot resolve: ${addr}` };
-}
-function toAgentProp(prop) {
-  if (prop.type === "grammar") {
-    const { vocab: _vocab, ...agentView } = prop;
-    return agentView;
-  }
-  return prop;
-}
-function layer0(node, graph, target) {
-  const facet = target === void 0 ? void 0 : node.facets[target];
-  const children = [];
-  if (facet) {
-    for (const [name, prop] of Object.entries(facet.props)) {
-      const child = { addr: `${node.id}.props.${name}`, type: prop.type };
-      if (prop.type === "deprecated") child.deprecatedFor = prop.deprecatedFor;
-      children.push(child);
-    }
-  }
-  if (node.composesWith.length > 0) {
-    children.push({ addr: `${node.id}.composesWith`, type: "edge" });
-  }
-  for (const partId of node.parts) {
-    children.push({ addr: partId, type: "part" });
-  }
-  const result = { id: node.id, kind: node.kind, intel: node.intel, children };
-  if (facet) {
-    result.snippet = facet.snippet;
-    if (facet.slots !== void 0) result.slots = facet.slots;
-    if (facet.events !== void 0) result.events = facet.events;
-  }
-  if (node.parent !== void 0) {
-    result.parent = node.parent;
-    const parentNode = graph.nodes.get(node.parent);
-    if (parentNode) {
-      const siblings = parentNode.parts.filter((id) => id !== node.id);
-      if (siblings.length > 0) result.siblings = siblings;
-    }
-  }
-  return result;
-}
-function resolveEdges(node, graph, target) {
-  const seen = /* @__PURE__ */ new Set();
-  const results = [];
-  for (const edgeId of node.composesWith) {
-    if (seen.has(edgeId)) continue;
-    seen.add(edgeId);
-    const edgeNode = graph.nodes.get(edgeId);
-    if (edgeNode) results.push(layer0(edgeNode, graph, target));
-  }
-  return results;
-}
-function expandProps(node, target) {
-  const facet = target === void 0 ? void 0 : node.facets[target];
-  const props = {};
-  if (facet) {
-    for (const [name, prop] of Object.entries(facet.props)) {
-      props[name] = toAgentProp(prop);
-    }
-  }
-  return { expanded: true, props };
-}
-function expandNode(node, target) {
-  const facet = target === void 0 ? void 0 : node.facets[target];
-  const props = {};
-  if (facet) {
-    for (const [name, prop] of Object.entries(facet.props)) {
-      props[name] = toAgentProp(prop);
-    }
-  }
-  const result = {
-    id: node.id,
-    kind: node.kind,
-    intel: node.intel,
-    props
-  };
-  if (node.composesWith.length > 0) result.composesWith = node.composesWith;
-  if (node.parts.length > 0) result.parts = node.parts;
-  if (facet) {
-    result.snippet = facet.snippet;
-    if (facet.slots !== void 0) result.slots = facet.slots;
-    if (facet.events !== void 0) result.events = facet.events;
-  }
-  return result;
-}
-
-// src/mcp/intent.ts
-var INTENT_TAGS = {
-  modal: ["attention", "blocking", "above-all", "focus-trap"],
-  alert: ["attention", "inline", "passive"],
-  tooltip: ["hint", "passive", "inline", "hover"]
-};
-var INTENT_AXES = [
-  {
-    tag: "above-all",
-    keywords: [
-      "above everything",
-      "above all",
-      "on top of everything",
-      "sits on top",
-      "on top",
-      "over everything",
-      "over all",
-      "topmost",
-      "highest layer"
-    ]
-  },
-  {
-    tag: "blocking",
-    keywords: [
-      "above everything",
-      "on top of everything",
-      "over everything",
-      "block",
-      "blocking",
-      "must dismiss",
-      "interrupt",
-      "take over",
-      "stops everything",
-      "requires a response",
-      "can't ignore",
-      "cannot ignore"
-    ]
-  },
-  {
-    tag: "inline",
-    keywords: ["inline", "in place", "in the flow", "within the page", "non-blocking"]
-  },
-  {
-    tag: "passive",
-    keywords: ["passive", "non-intrusive", "subtle", "quietly", "in the background"]
-  },
-  {
-    tag: "attention",
-    keywords: ["attention", "notice", "get noticed", "important message"]
-  },
-  {
-    tag: "hint",
-    keywords: ["hint", "a tip", "explain", "extra info", "more info"]
-  },
-  {
-    tag: "hover",
-    keywords: ["hover", "on hover", "mouse over"]
-  }
-];
-function isNaturalLanguageQuery(input) {
-  return input.includes(" ");
-}
-function matchIntent(query, graph) {
-  const normalized = query.toLowerCase();
-  const matchedTags = collectMatchedTags(normalized);
-  if (matchedTags.size === 0) return noMatch();
-  const winner = selectUse(matchedTags, graph);
-  if (winner === void 0) return noMatch();
-  const winningTags = winner.tags.filter((tag) => matchedTags.has(tag));
-  const decisive = new Set(winningTags);
-  const nearMiss = selectNearMiss(winner, decisive, matchedTags, graph);
-  if (nearMiss === void 0) return noMatch();
-  const use = describeNode(winner.id, graph);
-  const not = describeNode(nearMiss.id, graph);
-  if (use === void 0 || not === void 0) return noMatch();
-  const divergingTags = nearMiss.tags.filter((tag) => !winner.tags.includes(tag));
-  const because = `${winner.id} is ${winningTags.join("/")}; ${nearMiss.id} is ${divergingTags.join("/")}`;
-  return { use, not, because };
-}
-function collectMatchedTags(normalizedQuery) {
-  const matched = /* @__PURE__ */ new Set();
-  for (const axis of INTENT_AXES) {
-    for (const keyword of axis.keywords) {
-      if (normalizedQuery.includes(keyword)) {
-        matched.add(axis.tag);
-        break;
-      }
-    }
-  }
-  return matched;
-}
-function selectUse(matchedTags, graph) {
-  let best;
-  let bestScore = 0;
-  for (const [id, tags] of Object.entries(INTENT_TAGS)) {
-    if (!graph.nodes.has(id)) continue;
-    const score = tags.reduce((sum, tag) => matchedTags.has(tag) ? sum + 1 : sum, 0);
-    if (score > bestScore) {
-      bestScore = score;
-      best = { id, tags };
-    }
-  }
-  return best;
-}
-function selectNearMiss(use, decisive, matchedTags, graph) {
-  let best;
-  let bestOverlap = 0;
-  for (const [id, tags] of Object.entries(INTENT_TAGS)) {
-    if (id === use.id || !graph.nodes.has(id)) continue;
-    if (tags.some((tag) => decisive.has(tag))) continue;
-    const overlap = tags.filter((tag) => use.tags.includes(tag));
-    const sharesOutsideMatched = overlap.some((tag) => !matchedTags.has(tag));
-    if (!sharesOutsideMatched) continue;
-    if (overlap.length > bestOverlap) {
-      bestOverlap = overlap.length;
-      best = { id, tags };
-    }
-  }
-  return best;
-}
-function describeNode(id, graph) {
-  const result = describe(id, graph);
-  if (result !== null && !Array.isArray(result) && "children" in result) return result;
-  return void 0;
-}
-function noMatch() {
-  return { note: "no route matched; describe(components) or describe(composites) to browse" };
+function noMatch() {
+  return { note: "no route matched; describe(components) or describe(composites) to browse" };
 }
 
 // src/mcp/overlay.ts
@@ -32130,7 +31222,7 @@ var RaftersToolHandler = class {
   async ensureCompositesLoaded(workspace) {
     if (!this.builtInCompositesLoaded) {
       await this.loadCompositesFromDirs(
-        join12(process.cwd(), "node_modules/@rafters/composites/src/typography")
+        join11(process.cwd(), "node_modules/@rafters/composites/src/typography")
       );
       this.builtInCompositesLoaded = true;
     }
@@ -32148,7 +31240,7 @@ var RaftersToolHandler = class {
     const paths = getRaftersPaths(workspaceRoot);
     try {
       return migrateConfig(
-        JSON.parse(await readFile6(paths.config, "utf-8"))
+        JSON.parse(await readFile5(paths.config, "utf-8"))
       );
     } catch {
       return null;
@@ -32157,7 +31249,7 @@ var RaftersToolHandler = class {
   /** Persist a workspace's config back to `.rafters/config.rafters.json`. */
   async writeConfig(workspaceRoot, config2) {
     const paths = getRaftersPaths(workspaceRoot);
-    await writeFile4(paths.config, `${JSON.stringify(config2, null, 2)}
+    await writeFile3(paths.config, `${JSON.stringify(config2, null, 2)}
 `);
   }
   /**
@@ -32352,123 +31444,1137 @@ var RaftersToolHandler = class {
     const paths = getRaftersPaths(workspaceRoot);
     const config2 = await this.readConfig(workspaceRoot);
     if (!config2?.compositesPath) {
-      return [join12(paths.root, "composites")];
+      return [join11(paths.root, "composites")];
+    }
+    return resolveReadSet(config2.compositesPath, workspaceRoot);
+  }
+  async handleComposite(args) {
+    const { id, query, category, workspace } = args;
+    if (id) {
+      return this.describeById(id, workspace);
+    }
+    const resolved = this.resolve(workspace);
+    if (workspace && !resolved) {
+      return this.workspaceRequiredError();
+    }
+    await this.ensureCompositesLoaded(resolved);
+    let composites2;
+    if (query) {
+      composites2 = search(query);
+    } else if (category) {
+      composites2 = getByCategory(category);
+    } else {
+      composites2 = getAll2();
+    }
+    const result = composites2.map((c4) => ({
+      id: c4.manifest.id,
+      name: c4.manifest.name,
+      category: c4.manifest.category,
+      description: c4.manifest.description,
+      cognitiveLoad: c4.manifest.cognitiveLoad,
+      solves: c4.manifest.solves,
+      appliesWhen: c4.manifest.appliesWhen,
+      usagePatterns: c4.manifest.usagePatterns,
+      input: c4.input,
+      output: c4.output,
+      blockCount: c4.blocks.length,
+      // Surface which blocks carry which validation rules. Rules compile to
+      // native HTML5 constraint attributes at build, so agents need to see
+      // them to reason about a composite's behavior. Only blocks with rules
+      // are listed -- the array is empty when nothing is constrained.
+      blockRules: c4.blocks.filter((b2) => b2.rules && b2.rules.length > 0).map((b2) => ({ id: b2.id, type: b2.type, rules: b2.rules }))
+    }));
+    return this.jsonResult({ composites: result, deprecated: DEPRECATED_MSG });
+  }
+  async handlePattern(args) {
+    const { solves, query, workspace } = args;
+    const resolved = this.resolve(workspace);
+    if (workspace && !resolved) {
+      return this.workspaceRequiredError();
+    }
+    await this.ensureCompositesLoaded(resolved);
+    let composites2;
+    if (solves) {
+      const all = getAll2();
+      const solvesLower = solves.toLowerCase();
+      composites2 = all.filter(
+        (c4) => c4.manifest.solves?.toLowerCase().includes(solvesLower) || c4.manifest.appliesWhen?.some((a2) => a2.toLowerCase().includes(solvesLower))
+      );
+    } else if (query) {
+      composites2 = search(query);
+    } else {
+      composites2 = getAll2().filter((c4) => c4.manifest.usagePatterns);
+    }
+    if (composites2.length === 0) {
+      const all = getAll2();
+      const available = all.filter((c4) => c4.manifest.solves || c4.manifest.usagePatterns).map((c4) => ({
+        id: c4.manifest.id,
+        solves: c4.manifest.solves
+      }));
+      return this.errorResult("No patterns found matching query", {
+        available,
+        deprecated: DEPRECATED_MSG
+      });
+    }
+    const patterns = composites2.map((c4) => ({
+      id: c4.manifest.id,
+      name: c4.manifest.name,
+      solves: c4.manifest.solves,
+      appliesWhen: c4.manifest.appliesWhen,
+      cognitiveLoad: c4.manifest.cognitiveLoad,
+      usagePatterns: c4.manifest.usagePatterns
+    }));
+    return this.jsonResult({ patterns, deprecated: DEPRECATED_MSG });
+  }
+  /**
+   * DEPRECATED alias for `rafters_describe`. A component resolves by id through
+   * the overlay exactly as `describe(<id>)` does (#2072's resolver has no
+   * separate component/composite address form -- `describe(<id>)` resolves either
+   * kind), so this is a direct, lossless forward with the deprecated marker added.
+   */
+  async handleComponent(componentName, workspaceName) {
+    return this.describeById(componentName, workspaceName);
+  }
+  /**
+   * Shared by the deprecated `rafters_component` and `rafters_composite({id})`
+   * paths: resolve one id through the overlay, stamp the deprecated marker.
+   */
+  async describeById(id, workspaceName) {
+    const resolved = this.resolve(workspaceName);
+    if (workspaceName && !resolved) {
+      return this.workspaceRequiredError();
+    }
+    let graph;
+    try {
+      graph = await this.ensureGraph(resolved);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Unknown error";
+      return this.errorResult(`failed to build intel graph: ${message}`, {
+        deprecated: DEPRECATED_MSG
+      });
+    }
+    const ctx = await this.overlayContext(resolved);
+    if ("configError" in ctx) {
+      return this.errorResult(ctx.configError, { deprecated: DEPRECATED_MSG });
+    }
+    const out = describeWithOverlay(id, graph, ctx);
+    return this.jsonResult(this.withDeprecated(out));
+  }
+};
+
+// src/mcp/agent-contract.ts
+function liveTools() {
+  return TOOL_DEFINITIONS.filter((t) => !t.description.startsWith("[DEPRECATED"));
+}
+function generateAgentContract() {
+  const roster = liveTools().map((t) => `- \`${t.name}\`: ${t.description}`).join("\n");
+  return `# Rafters agent contract
+
+You are working in a Rafters-powered frontend project. The design system owns
+every visual decision -- color, spacing, size, weight, radius, shadow, hierarchy,
+and layout rhythm are already decided. Your job is to assemble the pre-made piece
+that fits the content and intent, never to author a visual choice. A write-time
+hook denies any edit that hand-authors a visual decision.
+
+## Assembly model -- follow this order every time
+
+1. Query the design system before writing any UI. You do not know this system
+   from training; read it from the MCP tools below, every time. Read the project's
+   recorded intent from \`.rafters/config.rafters.json\` first.
+2. Prefer a composite or pattern that solves the whole problem (authentication,
+   data entry, navigation, pricing) over assembling lone components by hand.
+   Render its blocks verbatim -- the manifest is the decision.
+3. Drop to a single component only for a lone affordance no composite covers.
+4. Author a custom component only when the served design system genuinely does not
+   ship the affordance -- the last resort, not the first.
+5. Prose and content (headings, paragraphs, lists, quotes) render as bare native
+   HTML inside \`<Container as="article">\` -- no classes, no imports.
+
+## Never
+
+- Never write flex, grid, gap, padding, or margin utilities directly. Container
+  and Grid own all layout.
+- Never use raw \`<h1>\`/\`<p>\`/\`<span>\` with class attributes for styled text.
+  Use the typography components with token props (size, weight, color).
+- Never use hex colors, arbitrary values, or \`var()\`. Use semantic color tokens
+  (bg-primary, text-accent).
+- Never pass \`class\` or \`className\` to a served component. Use token props for
+  overrides.
+
+If you do not know what to build or how it should look, get a design direction
+before writing code. The pre-edit hook WILL block violations. Consult the design
+system BEFORE writing, not after.
+
+## MCP tools
+
+Query these before writing UI:
+
+${roster}
+
+## Running the rafters MCP server
+
+Non-Claude-Code hosts wire the server manually. Invoke the \`rafters\` binary that
+is installed in your project, through your package manager:
+
+- \`pnpm exec rafters mcp\`
+- \`npx rafters mcp\`
+- \`yarn rafters mcp\`
+
+Run the copy pinned in your own lockfile. Do NOT use \`pnpx rafters@latest\`,
+\`npx rafters@latest\`, \`pnpm dlx rafters\`, or any \`@latest\` pin: these resolve
+outside your lockfile and can drift from the version your project installed --
+the exact staleness that strands you on an old rafters after a new one ships.
+`;
+}
+
+// src/commands/agents.ts
+var START_MARKER = "<!-- rafters:agent-contract:start -->";
+var END_MARKER = "<!-- rafters:agent-contract:end -->";
+function mergeAgentContract(existing, contract) {
+  const block = `${START_MARKER}
+${contract}
+${END_MARKER}`;
+  if (existing === null) {
+    return `${block}
+`;
+  }
+  const startIdx = existing.indexOf(START_MARKER);
+  const endIdx = existing.indexOf(END_MARKER);
+  if (startIdx !== -1 && endIdx !== -1 && startIdx < endIdx) {
+    const before = existing.slice(0, startIdx);
+    const after = existing.slice(endIdx + END_MARKER.length);
+    return `${before}${block}${after}`;
+  }
+  return `${existing.trimEnd()}
+
+${block}
+`;
+}
+async function agents() {
+  const cwd = process.cwd();
+  const paths = getRaftersPaths(cwd);
+  if (!existsSync6(paths.config)) {
+    throw new Error(
+      `No rafters project found: ${paths.config} is missing. Run \`rafters init\` first.`
+    );
+  }
+  const agentsPath = join12(cwd, "AGENTS.md");
+  const existing = existsSync6(agentsPath) ? await readFile6(agentsPath, "utf-8") : null;
+  const merged = mergeAgentContract(existing, generateAgentContract());
+  await writeFile4(agentsPath, merged);
+}
+
+// src/commands/init.ts
+import { existsSync as existsSync7 } from "fs";
+import { copyFile, mkdir as mkdir3, readFile as readFile7, rm, writeFile as writeFile5 } from "fs/promises";
+import { createRequire } from "module";
+import { join as join13, relative as relative2 } from "path";
+import { checkbox, confirm, select } from "@inquirer/prompts";
+var REGISTRY_PLUGINS2 = [scalePlugin, contrastPlugin, statePlugin, invertPlugin];
+async function backupCss(cssPath) {
+  const backupPath = cssPath.replace(/\.css$/, ".backup.css");
+  await copyFile(cssPath, backupPath);
+  return backupPath;
+}
+function cleanSourceCssBlocks(content) {
+  function parseBlocks(src) {
+    const blocks = [];
+    let depth = 0;
+    const headerStack = [];
+    let segmentStart = 0;
+    for (let i = 0; i < src.length; i++) {
+      const ch = src.charAt(i);
+      if (ch === "{") {
+        headerStack.push(segmentStart);
+        depth++;
+        if (depth >= 1) {
+          blocks.push({
+            headerStart: segmentStart,
+            bodyStart: i + 1,
+            end: -1,
+            header: src.slice(segmentStart, i).trim()
+          });
+        }
+        segmentStart = i + 1;
+      } else if (ch === "}") {
+        depth--;
+        const open = blocks.slice().reverse().find((b2) => b2.end === -1);
+        if (open) open.end = i + 1;
+        headerStack.pop();
+        segmentStart = i + 1;
+      } else if (ch === ";") {
+        segmentStart = i + 1;
+      }
+    }
+    return blocks.filter((b2) => b2.end !== -1);
+  }
+  function isContentEmpty(body) {
+    return body.replace(/\/\*[\s\S]*?\*\//g, "").trim().length === 0;
+  }
+  let out = content;
+  for (let pass = 0; pass < 10; pass++) {
+    const blocks = parseBlocks(out);
+    let edited = false;
+    for (const block of blocks.sort((a2, b2) => b2.headerStart - a2.headerStart)) {
+      const header = block.header;
+      if (/^@theme\s+inline$/.test(header)) {
+        out = out.slice(0, block.headerStart) + out.slice(block.end);
+        edited = true;
+        break;
+      }
+      if (header === ":root" || /(^|,)\s*:root\s*$/.test(header)) {
+        const body = out.slice(block.bodyStart, block.end - 1);
+        const cleanedBody = body.replace(/--[\w-]+\s*:[^;{}]*;?/g, "");
+        if (isContentEmpty(cleanedBody)) {
+          out = out.slice(0, block.headerStart) + out.slice(block.end);
+          edited = true;
+          break;
+        }
+        if (cleanedBody !== body) {
+          out = out.slice(0, block.bodyStart) + cleanedBody + out.slice(block.end - 1);
+          edited = true;
+          break;
+        }
+        continue;
+      }
+      if (header.startsWith("@media") || header.startsWith("@supports")) {
+        const body = out.slice(block.bodyStart, block.end - 1);
+        if (isContentEmpty(body)) {
+          out = out.slice(0, block.headerStart) + out.slice(block.end);
+          edited = true;
+          break;
+        }
+      }
+    }
+    if (!edited) break;
+  }
+  return out.replace(/[ \t]+$/gm, "").replace(/\n{3,}/g, "\n\n");
+}
+async function stripImportedDeclarations(cwd, cssPath, importedNames) {
+  if (importedNames.length === 0) return;
+  const fullPath = join13(cwd, cssPath);
+  const content = await readFile7(fullPath, "utf-8");
+  const pattern = new RegExp(importedNames.map((n2) => `^\\s*--${n2}[^;]*;\\s*$`).join("|"), "gm");
+  const cleaned = cleanSourceCssBlocks(content.replace(pattern, ""));
+  const collapsed = cleaned.replace(/\n{3,}/g, "\n\n");
+  await writeFile5(fullPath, collapsed);
+}
+async function updateMainCss(cwd, cssPath, themePath) {
+  const fullCssPath = join13(cwd, cssPath);
+  const cssContent = await readFile7(fullCssPath, "utf-8");
+  const cssDir = join13(cwd, cssPath, "..");
+  const themeFullPath = join13(cwd, themePath);
+  const relativeThemePath = relative2(cssDir, themeFullPath);
+  if (cssContent.includes(".rafters/output/rafters.css")) {
+    log({ event: "init:css_already_imported", cssPath });
+    return;
+  }
+  await backupCss(fullCssPath);
+  let newContent;
+  if (cssContent.includes('@import "tailwindcss"')) {
+    newContent = cssContent.replace('@import "tailwindcss";', `@import "${relativeThemePath}";`);
+  } else if (cssContent.includes("@import 'tailwindcss'")) {
+    newContent = cssContent.replace("@import 'tailwindcss';", `@import "${relativeThemePath}";`);
+  } else {
+    newContent = `@import "${relativeThemePath}";
+
+${cssContent}`;
+  }
+  await writeFile5(fullCssPath, newContent);
+  log({
+    event: "init:css_updated",
+    cssPath,
+    themePath: relativeThemePath
+  });
+}
+function isInteractive() {
+  return Boolean(process.stdin.isTTY && process.stdout.isTTY);
+}
+function resolveSourceCssPath(cwd, framework, detectedFramework, projectCssPath, shadcnCssPath, emit) {
+  if (shadcnCssPath) {
+    if (existsSync7(join13(cwd, shadcnCssPath))) return shadcnCssPath;
+    const fallback = framework === detectedFramework ? projectCssPath : findCssPath(cwd, framework);
+    emit({
+      event: "init:shadcn_css_missing",
+      configuredPath: shadcnCssPath,
+      fallbackPath: fallback,
+      message: "components.json points at a CSS file that does not exist. Falling back to the framework canonical location."
+    });
+    return fallback;
+  }
+  return framework === detectedFramework ? projectCssPath : findCssPath(cwd, framework);
+}
+function slugifyFontName(name) {
+  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function isFontStackValue(value) {
+  if (typeof value !== "string") return false;
+  if (value.startsWith("var(")) return false;
+  if (/[,'"]/.test(value)) return true;
+  return /\b(sans-serif|serif|monospace|cursive|fantasy|system-ui|ui-(?:sans-serif|serif|monospace|rounded))\b/.test(
+    value
+  );
+}
+async function resolveFramework(detected, flag, agentMode) {
+  if (flag) {
+    if (!isSelectableFramework(flag)) {
+      throw new Error(
+        `Unknown --framework "${flag}". Valid values: ${SELECTABLE_FRAMEWORKS.join(", ")}.`
+      );
+    }
+    return flag;
+  }
+  if (detected !== "unknown") return detected;
+  if (agentMode || !isInteractive()) return "unknown";
+  const picked = await select({
+    message: "Couldn't auto-detect your framework. Which one is this?",
+    choices: SELECTABLE_FRAMEWORKS.map((value) => ({
+      name: FRAMEWORK_SPECS[value].label ?? value,
+      value
+    }))
+  });
+  return picked;
+}
+async function promptExportFormats(existingConfig) {
+  if (!isInteractive()) {
+    return existingConfig ?? DEFAULT_EXPORTS;
+  }
+  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);
+}
+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, source, darkMode = "class", config2) {
+  const contentSources = config2 ? resolveContentSources(cwd, config2) : [];
+  if (exports.compiled && !isTailwindCliInstalled()) {
+    log({ event: "init:prompting_exports" });
+    await ensureTailwindCli(cwd);
+  }
+  if (exports.compiled) {
+    log({ event: "init:compiling_css" });
+  }
+  return regenerateOutputs(registry2, {
+    outputDir: paths.output,
+    exports,
+    contentSources,
+    darkMode,
+    includeImport: source !== "shadcn"
+  });
+}
+async function regenerateFromExisting(cwd, paths, source, isAgentMode2, framework) {
+  log({ event: "init:regenerate", cwd });
+  let existingConfig = null;
+  try {
+    const configContent = await readFile7(paths.config, "utf-8");
+    existingConfig = migrateConfig(
+      JSON.parse(configContent)
+    );
+  } catch {
+  }
+  if (framework !== "unknown" && existingConfig) {
+    const frameworkPaths = FRAMEWORK_SPECS[framework].components;
+    existingConfig.framework = framework;
+    existingConfig.componentsPath = frameworkPaths.components;
+    existingConfig.primitivesPath = frameworkPaths.primitives;
+    existingConfig.compositesPath = frameworkPaths.composites;
+    existingConfig.rulesPath = frameworkPaths.rules;
+  }
+  await rm(join13(paths.tokens, "elevation.rafters.json"), { force: true });
+  await rm(join13(paths.tokens, "fill.rafters.json"), { force: true });
+  const registry2 = loadRegistryFromDir(paths.tokens, REGISTRY_PLUGINS2);
+  if (registry2.size() === 0) {
+    throw new Error("No tokens found. Cannot regenerate without existing tokens.");
+  }
+  const namespaces = [...new Set(registry2.list().map((t) => t.namespace))];
+  log({
+    event: "init:loaded",
+    tokenCount: registry2.size(),
+    namespaces
+  });
+  let exports;
+  if (isAgentMode2) {
+    exports = existingConfig?.exports ?? DEFAULT_EXPORTS;
+    log({ event: "init:exports_default", exports });
+  } else {
+    if (isInteractive()) {
+      log({ event: "init:prompting_exports" });
+    }
+    exports = await promptExportFormats(existingConfig?.exports);
+    log({ event: "init:exports_selected", exports });
+  }
+  await mkdir3(paths.output, { recursive: true });
+  const outputs = await generateOutputs(
+    cwd,
+    paths,
+    registry2,
+    exports,
+    source,
+    "class",
+    existingConfig
+  );
+  if (existingConfig) {
+    existingConfig.exports = exports;
+    await writeFile5(paths.config, JSON.stringify(existingConfig, null, 2));
+  } else {
+    const frameworkPaths = FRAMEWORK_SPECS[framework].components;
+    const newConfig = {
+      framework,
+      componentsPath: frameworkPaths.components,
+      primitivesPath: frameworkPaths.primitives,
+      compositesPath: frameworkPaths.composites,
+      rulesPath: frameworkPaths.rules,
+      cssPath: null,
+      ...source ? { source } : {},
+      intent: "efficient",
+      fonts: { path: null, imports: [] },
+      exports,
+      installed: { components: [], primitives: [], composites: [], rules: [] }
+    };
+    await writeFile5(paths.config, JSON.stringify(newConfig, null, 2));
+  }
+  log({
+    event: "init:complete",
+    outputs,
+    path: paths.output
+  });
+}
+async function resetToDefaults(cwd, paths, source, isAgentMode2, framework) {
+  log({ event: "init:reset", cwd });
+  let existingConfig = null;
+  try {
+    const configContent = await readFile7(paths.config, "utf-8");
+    existingConfig = migrateConfig(
+      JSON.parse(configContent)
+    );
+  } catch {
+  }
+  if (framework !== "unknown" && existingConfig) {
+    const frameworkPaths = FRAMEWORK_SPECS[framework].components;
+    existingConfig.framework = framework;
+    existingConfig.componentsPath = frameworkPaths.components;
+    existingConfig.primitivesPath = frameworkPaths.primitives;
+    existingConfig.compositesPath = frameworkPaths.composites;
+    existingConfig.rulesPath = frameworkPaths.rules;
+  }
+  let existingTokens = [];
+  try {
+    existingTokens = loadRegistryFromDir(paths.tokens, REGISTRY_PLUGINS2).list();
+  } catch {
+  }
+  const overriddenTokens = existingTokens.filter((t) => t.userOverride);
+  if (overriddenTokens.length > 0) {
+    const backup = {
+      resetAt: (/* @__PURE__ */ new Date()).toISOString(),
+      reason: "rafters init --reset",
+      overrides: overriddenTokens.map((t) => ({
+        name: t.name,
+        value: t.value,
+        userOverride: t.userOverride,
+        namespace: t.namespace
+      }))
+    };
+    await mkdir3(paths.output, { recursive: true });
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+    const backupPath = join13(paths.output, `reset-${timestamp}.json`);
+    await writeFile5(backupPath, JSON.stringify(backup, null, 2));
+    log({
+      event: "init:reset_backup",
+      path: backupPath,
+      overrideCount: overriddenTokens.length
+    });
+  }
+  let exports;
+  if (isAgentMode2) {
+    exports = existingConfig?.exports ?? DEFAULT_EXPORTS;
+    log({ event: "init:exports_default", exports });
+  } else {
+    if (isInteractive()) {
+      log({ event: "init:prompting_exports" });
+    }
+    exports = await promptExportFormats(existingConfig?.exports);
+    log({ event: "init:exports_selected", exports });
+  }
+  const system = generateBaseSystem({});
+  const registry2 = new TokenRegistry(system.allTokens, REGISTRY_PLUGINS2);
+  log({
+    event: "init:reset_generated",
+    tokenCount: registry2.size()
+  });
+  await rm(paths.tokens, { recursive: true, force: true });
+  await mkdir3(paths.tokens, { recursive: true });
+  saveRegistryToDir(paths.tokens, registry2);
+  const allTokensToSave = registry2.list();
+  const namespaceCount = new Set(allTokensToSave.map((t) => t.namespace)).size;
+  log({
+    event: "init:registry_saved",
+    path: paths.tokens,
+    namespaceCount
+  });
+  await mkdir3(paths.output, { recursive: true });
+  const outputs = await generateOutputs(
+    cwd,
+    paths,
+    registry2,
+    exports,
+    source,
+    "class",
+    existingConfig
+  );
+  if (existingConfig) {
+    existingConfig.exports = exports;
+    await writeFile5(paths.config, JSON.stringify(existingConfig, null, 2));
+  } else {
+    const frameworkPaths = FRAMEWORK_SPECS[framework].components;
+    const newConfig = {
+      framework,
+      componentsPath: frameworkPaths.components,
+      primitivesPath: frameworkPaths.primitives,
+      compositesPath: frameworkPaths.composites,
+      rulesPath: frameworkPaths.rules,
+      cssPath: null,
+      ...source ? { source } : {},
+      intent: "efficient",
+      fonts: { path: null, imports: [] },
+      exports,
+      installed: { components: [], primitives: [], composites: [], rules: [] }
+    };
+    await writeFile5(paths.config, JSON.stringify(newConfig, null, 2));
+  }
+  log({
+    event: "init:complete",
+    outputs,
+    path: paths.output
+  });
+}
+async function init(options) {
+  setAgentMode(options.agent ?? false);
+  const isAgentMode2 = options.agent ?? false;
+  const cwd = process.cwd();
+  const paths = getRaftersPaths(cwd);
+  log({ event: "init:start", cwd });
+  const project = await detectProject(cwd);
+  const { framework: detectedFramework, shadcn, tailwindVersion, astroHasReact } = project;
+  const source = shadcn ? "shadcn" : void 0;
+  log({
+    event: "init:detected",
+    framework: detectedFramework,
+    tailwindVersion,
+    hasShadcn: !!shadcn
+  });
+  const framework = await resolveFramework(detectedFramework, options.framework, isAgentMode2);
+  if (framework !== detectedFramework) {
+    log({
+      event: "init:framework_resolved",
+      detected: detectedFramework,
+      resolved: framework,
+      source: options.framework ? "flag" : "prompt"
+    });
+  }
+  if (isTailwindV3(tailwindVersion)) {
+    throw new Error("Tailwind v3 detected. Rafters requires Tailwind v4.");
+  }
+  const raftersExists = existsSync7(paths.root);
+  if (options.reset && !raftersExists) {
+    throw new Error("Nothing to reset. No .rafters/ directory found.");
+  }
+  if (raftersExists && options.reset) {
+    await resetToDefaults(cwd, paths, source, isAgentMode2, framework);
+    return;
+  }
+  if (raftersExists && !options.rebuild) {
+    throw new Error(
+      ".rafters/ directory already exists. Use --rebuild to regenerate output files, or --reset to start from defaults."
+    );
+  }
+  if (raftersExists && options.rebuild) {
+    await regenerateFromExisting(cwd, paths, source, isAgentMode2, framework);
+    return;
+  }
+  let exports;
+  if (isAgentMode2) {
+    exports = DEFAULT_EXPORTS;
+    log({ event: "init:exports_default", exports });
+  } else {
+    if (isInteractive()) {
+      log({ event: "init:prompting_exports" });
     }
-    return resolveReadSet(config2.compositesPath, workspaceRoot);
+    exports = await promptExportFormats();
+    log({ event: "init:exports_selected", exports });
   }
-  async handleComposite(args) {
-    const { id, query, category, workspace } = args;
-    if (id) {
-      return this.describeById(id, workspace);
-    }
-    const resolved = this.resolve(workspace);
-    if (workspace && !resolved) {
-      return this.workspaceRequiredError();
-    }
-    await this.ensureCompositesLoaded(resolved);
-    let composites2;
-    if (query) {
-      composites2 = search(query);
-    } else if (category) {
-      composites2 = getByCategory(category);
-    } else {
-      composites2 = getAll2();
+  const adapter = getAdapter(source ?? "tailwind");
+  const baseConfig = {};
+  const sourceCssPathForBase = resolveSourceCssPath(
+    cwd,
+    framework,
+    detectedFramework,
+    project.cssPath,
+    shadcn?.tailwind?.css,
+    log
+  );
+  if (sourceCssPathForBase !== null) {
+    try {
+      const cssForBase = await readFile7(join13(cwd, sourceCssPathForBase), "utf-8");
+      const baseSlots = [
+        {
+          detect: () => adapter.detectSpacing(cssForBase).base,
+          field: "baseSpacingUnit",
+          event: "init:import_spacing_applied",
+          eventKey: "baseSpacingUnit"
+        },
+        {
+          detect: () => adapter.detectRadius(cssForBase).base,
+          field: "baseRadiusOverride",
+          event: "init:import_radius_applied",
+          eventKey: "baseRadius"
+        },
+        {
+          detect: () => adapter.detectFontSize(cssForBase).base,
+          field: "baseFontSizeOverride",
+          event: "init:import_font_size_applied",
+          eventKey: "baseFontSize"
+        },
+        {
+          detect: () => adapter.detectFocusRing(cssForBase).width,
+          field: "focusRingWidthOverride",
+          event: "init:import_focus_ring_applied",
+          eventKey: "focusRingWidth"
+        }
+        // Motion duration is intentionally not imported -- rafters' motion
+        // system is research-backed and most projects' `--duration-base`
+        // values are unresearched defaults. See importers/bases.ts for the
+        // policy note; designers can `rafters set motion-duration-base ...`
+        // after init to override explicitly.
+      ];
+      for (const slot of baseSlots) {
+        const value = slot.detect();
+        if (value === void 0) continue;
+        baseConfig[slot.field] = value;
+        log({
+          event: slot.event,
+          cssPath: sourceCssPathForBase,
+          [slot.eventKey]: value
+        });
+      }
+    } catch (err) {
+      if (!(err instanceof Error && "code" in err && err.code === "ENOENT")) throw err;
     }
-    const result = composites2.map((c4) => ({
-      id: c4.manifest.id,
-      name: c4.manifest.name,
-      category: c4.manifest.category,
-      description: c4.manifest.description,
-      cognitiveLoad: c4.manifest.cognitiveLoad,
-      solves: c4.manifest.solves,
-      appliesWhen: c4.manifest.appliesWhen,
-      usagePatterns: c4.manifest.usagePatterns,
-      input: c4.input,
-      output: c4.output,
-      blockCount: c4.blocks.length,
-      // Surface which blocks carry which validation rules. Rules compile to
-      // native HTML5 constraint attributes at build, so agents need to see
-      // them to reason about a composite's behavior. Only blocks with rules
-      // are listed -- the array is empty when nothing is constrained.
-      blockRules: c4.blocks.filter((b2) => b2.rules && b2.rules.length > 0).map((b2) => ({ id: b2.id, type: b2.type, rules: b2.rules }))
-    }));
-    return this.jsonResult({ composites: result, deprecated: DEPRECATED_MSG });
   }
-  async handlePattern(args) {
-    const { solves, query, workspace } = args;
-    const resolved = this.resolve(workspace);
-    if (workspace && !resolved) {
-      return this.workspaceRequiredError();
-    }
-    await this.ensureCompositesLoaded(resolved);
-    let composites2;
-    if (solves) {
-      const all = getAll2();
-      const solvesLower = solves.toLowerCase();
-      composites2 = all.filter(
-        (c4) => c4.manifest.solves?.toLowerCase().includes(solvesLower) || c4.manifest.appliesWhen?.some((a2) => a2.toLowerCase().includes(solvesLower))
-      );
-    } else if (query) {
-      composites2 = search(query);
+  const system = generateBaseSystem(baseConfig);
+  const registry2 = new TokenRegistry(system.allTokens, REGISTRY_PLUGINS2);
+  log({
+    event: "init:generated",
+    tokenCount: registry2.size()
+  });
+  await mkdir3(paths.tokens, { recursive: true });
+  await mkdir3(paths.output, { recursive: true });
+  saveRegistryToDir(paths.tokens, registry2);
+  const allTokensToSave = registry2.list();
+  const namespaceCount = new Set(allTokensToSave.map((t) => t.namespace)).size;
+  log({
+    event: "init:registry_saved",
+    path: paths.tokens,
+    namespaceCount
+  });
+  const outputs = await generateOutputs(cwd, paths, registry2, exports, source);
+  let detectedCssPath = null;
+  detectedCssPath = resolveSourceCssPath(
+    cwd,
+    framework,
+    detectedFramework,
+    project.cssPath,
+    shadcn?.tailwind?.css,
+    log
+  );
+  if (source !== "shadcn" && exports.tailwind) {
+    if (detectedCssPath) {
+      await updateMainCss(cwd, detectedCssPath, ".rafters/output/rafters.css");
     } else {
-      composites2 = getAll2().filter((c4) => c4.manifest.usagePatterns);
-    }
-    if (composites2.length === 0) {
-      const all = getAll2();
-      const available = all.filter((c4) => c4.manifest.solves || c4.manifest.usagePatterns).map((c4) => ({
-        id: c4.manifest.id,
-        solves: c4.manifest.solves
-      }));
-      return this.errorResult("No patterns found matching query", {
-        available,
-        deprecated: DEPRECATED_MSG
+      log({
+        event: "init:css_not_found",
+        message: 'No main CSS file found. Add @import ".rafters/output/rafters.css" manually.',
+        searchedLocations: FRAMEWORK_SPECS[framework].cssLocations
       });
     }
-    const patterns = composites2.map((c4) => ({
-      id: c4.manifest.id,
-      name: c4.manifest.name,
-      solves: c4.manifest.solves,
-      appliesWhen: c4.manifest.appliesWhen,
-      cognitiveLoad: c4.manifest.cognitiveLoad,
-      usagePatterns: c4.manifest.usagePatterns
-    }));
-    return this.jsonResult({ patterns, deprecated: DEPRECATED_MSG });
   }
-  /**
-   * DEPRECATED alias for `rafters_describe`. A component resolves by id through
-   * the overlay exactly as `describe(<id>)` does (#2072's resolver has no
-   * separate component/composite address form -- `describe(<id>)` resolves either
-   * kind), so this is a direct, lossless forward with the deprecated marker added.
-   */
-  async handleComponent(componentName, workspaceName) {
-    return this.describeById(componentName, workspaceName);
+  let componentTarget = frameworkToTarget(framework);
+  if (framework === "astro" && astroHasReact && isInteractive() && !isAgentMode2) {
+    componentTarget = await select({
+      message: "This Astro project has React integration. Install components as:",
+      choices: [
+        {
+          name: "Astro components (zero client JS, server-rendered)",
+          value: "astro"
+        },
+        {
+          name: "React components (client islands with client:load)",
+          value: "react"
+        }
+      ]
+    });
   }
-  /**
-   * Shared by the deprecated `rafters_component` and `rafters_composite({id})`
-   * paths: resolve one id through the overlay, stamp the deprecated marker.
-   */
-  async describeById(id, workspaceName) {
-    const resolved = this.resolve(workspaceName);
-    if (workspaceName && !resolved) {
-      return this.workspaceRequiredError();
+  const frameworkPaths = FRAMEWORK_SPECS[framework].components;
+  const config2 = {
+    framework,
+    ...source ? { source } : {},
+    componentTarget,
+    componentsPath: frameworkPaths.components,
+    primitivesPath: frameworkPaths.primitives,
+    compositesPath: frameworkPaths.composites,
+    rulesPath: frameworkPaths.rules,
+    cssPath: detectedCssPath,
+    exports,
+    intent: "efficient",
+    fonts: { path: null, imports: [] },
+    installed: {
+      components: [],
+      primitives: [],
+      composites: [],
+      rules: []
     }
-    let graph;
+  };
+  await writeFile5(paths.config, JSON.stringify(config2, null, 2));
+  if (detectedCssPath) {
+    let sourceCss = null;
     try {
-      graph = await this.ensureGraph(resolved);
+      sourceCss = await readFile7(join13(cwd, detectedCssPath), "utf-8");
     } catch (err) {
-      const message = err instanceof Error ? err.message : "Unknown error";
-      return this.errorResult(`failed to build intel graph: ${message}`, {
-        deprecated: DEPRECATED_MSG
-      });
+      if (!(err instanceof Error && "code" in err && err.code === "ENOENT")) throw err;
     }
-    const ctx = await this.overlayContext(resolved);
-    if ("configError" in ctx) {
-      return this.errorResult(ctx.configError, { deprecated: DEPRECATED_MSG });
+    if (sourceCss !== null) {
+      const summary = senseShadcnCss(sourceCss);
+      if (summary.totalDeclarations > 0) {
+        log({
+          event: "init:import_sensed",
+          cssPath: detectedCssPath,
+          ...summary
+        });
+        const classification = classifyDeclarations(extractShadcnRoot(sourceCss));
+        const colorDecls = adapter.detectColors(sourceCss);
+        const nonColorDecls = [
+          ...classification.byNamespace.typography,
+          ...classification.byNamespace.spacing,
+          ...classification.byNamespace.radius,
+          ...classification.byNamespace.shadow
+        ];
+        const toImportColors = [];
+        for (const color of colorDecls) {
+          const accept = isAgentMode2 ? true : await confirm({
+            message: `Import --${color.name}: ${color.value}?`,
+            default: true
+          });
+          if (accept) toImportColors.push(color);
+        }
+        const toImportNonColors = [];
+        for (const decl of nonColorDecls) {
+          const accept = isAgentMode2 ? true : await confirm({
+            message: `Import --${decl.name}: ${decl.value}?`,
+            default: true
+          });
+          if (accept) toImportNonColors.push(decl);
+        }
+        if (toImportColors.length + toImportNonColors.length > 0) {
+          for (const color of toImportColors) {
+            const familyName = `imported-${color.name}`;
+            const reason = `imported from --${color.name} in ${detectedCssPath}`;
+            for (const t of importColorFamily(familyName, "500", color.oklch)) {
+              registry2.define(t);
+            }
+            if (color.namespace === "semantic") {
+              registry2.set(color.name, { family: familyName, position: "500" }, { reason });
+            }
+          }
+          const skipped = [];
+          for (const decl of toImportNonColors) {
+            const reason = `imported from --${decl.name} in ${detectedCssPath}`;
+            if (registry2.has(decl.name)) {
+              registry2.set(decl.name, decl.value, { reason });
+            } else {
+              skipped.push(decl.name);
+            }
+          }
+          saveRegistryToDir(paths.tokens, registry2);
+          await generateOutputs(cwd, paths, registry2, exports, source);
+          const importedNames = [
+            ...toImportColors.map((c4) => c4.name),
+            ...toImportNonColors.map((d2) => d2.name)
+          ];
+          await stripImportedDeclarations(cwd, detectedCssPath, importedNames);
+          log({
+            event: "init:import_applied",
+            count: toImportColors.length + toImportNonColors.length - skipped.length,
+            cssPath: detectedCssPath,
+            ...skipped.length > 0 ? { skipped } : {}
+          });
+        }
+      }
+      {
+        const themeDecls = extractThemeBlocks2(sourceCss);
+        if (themeDecls.length > 0) {
+          const POSITION_SUFFIX = new RegExp(`^(.+)-(${SCALE_POSITIONS.join("|")})$`);
+          const familySeeds = /* @__PURE__ */ new Map();
+          for (const decl of themeDecls) {
+            if (!decl.name.startsWith("color-")) continue;
+            const oklch2 = tryParseColor(decl.value);
+            if (oklch2 === null) continue;
+            const m3 = decl.name.match(POSITION_SUFFIX);
+            const baseName = ((m3 ? m3[1] : decl.name) ?? decl.name).replace(/^color-/, "");
+            if (!baseName) continue;
+            const seedPosition = m3?.[2] ?? "500";
+            const existing = familySeeds.get(baseName);
+            if (!existing || seedPosition === "500") {
+              familySeeds.set(baseName, { seed: oklch2, seedPosition });
+            }
+          }
+          const families = Array.from(familySeeds, ([name, info]) => ({
+            name,
+            ...info
+          }));
+          if (families.length > 0) {
+            for (const family of families) {
+              for (const t of importColorFamily(family.name, family.seedPosition, family.seed)) {
+                registry2.define(t);
+              }
+            }
+            const ALL_ROLES = [
+              "primary",
+              "secondary",
+              "tertiary",
+              "accent",
+              "highlight",
+              "neutral",
+              "muted",
+              "success",
+              "warning",
+              "destructive",
+              "info"
+            ];
+            const ROLES = ALL_ROLES.filter((r) => {
+              const tok = registry2.get(r);
+              return tok !== void 0 && tok.namespace === "semantic";
+            });
+            const assignments = [];
+            for (const [i, role] of ROLES.entries()) {
+              let familyChoice;
+              if (isAgentMode2) {
+                familyChoice = families[i]?.name ?? null;
+              } else {
+                familyChoice = await select({
+                  message: `Which palette is "${role}"?`,
+                  choices: [
+                    ...families.map((f) => ({ name: f.name, value: f.name })),
+                    { name: "(skip -- keep rafters default)", value: null }
+                  ]
+                });
+              }
+              if (familyChoice === null) continue;
+              const family = families.find((f) => f.name === familyChoice);
+              if (!family) continue;
+              const position = isAgentMode2 ? family.seedPosition : await select({
+                message: `Which position in "${familyChoice}" for "${role}"?`,
+                choices: SCALE_POSITIONS.map((p2) => ({
+                  name: p2,
+                  value: p2
+                })),
+                default: family.seedPosition
+              });
+              registry2.set(
+                role,
+                { family: familyChoice, position },
+                {
+                  reason: `assigned ${familyChoice}@${position} as ${role} during import from ${detectedCssPath}`
+                }
+              );
+              assignments.push({ role, family: familyChoice, position });
+            }
+            saveRegistryToDir(paths.tokens, registry2);
+            await generateOutputs(cwd, paths, registry2, exports, source);
+            const themeImportedNames = families.flatMap(
+              (f) => SCALE_POSITIONS.map((p2) => `color-${f.name}-${p2}`).concat([`color-${f.name}`])
+            );
+            await stripImportedDeclarations(cwd, detectedCssPath, themeImportedNames);
+            log({
+              event: "init:import_palettes_applied",
+              cssPath: detectedCssPath,
+              palettesDefined: families.map((f) => f.name),
+              assignments
+            });
+          }
+        }
+      }
+    }
+    if (sourceCss !== null) {
+      const detectedFonts = adapter.detectFonts(sourceCss);
+      if (detectedFonts.length > 0) {
+        const typographyTokens = registry2.list({ namespace: "typography" });
+        const baseFamilyNames = new Set(
+          typographyTokens.filter((t) => (!t.dependsOn || t.dependsOn.length === 0) && isFontStackValue(t.value)).map((t) => t.name)
+        );
+        const fontRoles = [];
+        for (const tok of typographyTokens) {
+          const base = tok.dependsOn?.[0];
+          if (base === void 0 || !baseFamilyNames.has(base)) continue;
+          if (typeof tok.value !== "string" || !tok.value.includes(`var(--${base})`)) continue;
+          fontRoles.push({ role: tok.name, base });
+        }
+        const roleTokenNames = new Set(fontRoles.map((r) => r.role));
+        const canonicalTokenNames = /* @__PURE__ */ new Set([...baseFamilyNames, ...roleTokenNames]);
+        const definedFonts = [];
+        for (const font of detectedFonts) {
+          if (font.sourceDeclName && canonicalTokenNames.has(font.sourceDeclName)) continue;
+          const tokenName = font.sourceDeclName ?? `font-${slugifyFontName(font.name)}`;
+          if (registry2.has(tokenName)) continue;
+          registry2.define({
+            name: tokenName,
+            namespace: "typography",
+            category: "typography",
+            value: font.stack,
+            description: `Imported from ${detectedCssPath}. ${font.sourceDeclName ? `Declared as --${font.sourceDeclName}.` : "Loaded via @font-face or @import."}`,
+            userOverride: null,
+            containerQueryAware: false
+          });
+          definedFonts.push(tokenName);
+        }
+        const fontAssignments = [];
+        const declaredByBase = /* @__PURE__ */ new Map();
+        for (const font of detectedFonts) {
+          if (font.sourceDeclName && baseFamilyNames.has(font.sourceDeclName)) {
+            if (!declaredByBase.has(font.sourceDeclName)) {
+              declaredByBase.set(font.sourceDeclName, font);
+            }
+          }
+        }
+        for (const { role, base } of fontRoles) {
+          let choice;
+          if (isAgentMode2) {
+            const declared = declaredByBase.get(base);
+            if (declared !== void 0) {
+              choice = declared.name;
+            } else if (/mono/.test(base)) {
+              choice = detectedFonts.find((f) => /mono/i.test(f.name))?.name ?? null;
+            } else {
+              const sansLike = detectedFonts.find((f) => !/mono/i.test(f.name));
+              choice = sansLike?.name ?? null;
+            }
+          } else {
+            const prompt = role.replace(/^font-/, "");
+            choice = await select({
+              message: `Which font is "${prompt}"?`,
+              choices: [
+                ...detectedFonts.map((f) => ({ name: f.name, value: f.name })),
+                { name: "(skip -- keep rafters default)", value: null }
+              ]
+            });
+          }
+          if (choice === null) continue;
+          const font = detectedFonts.find((f) => f.name === choice);
+          if (font === void 0) continue;
+          const reason = `assigned ${font.name} as ${role} during import from ${detectedCssPath}`;
+          if (registry2.has(role)) {
+            registry2.set(role, font.stack, { reason });
+          }
+          if (registry2.has(base)) {
+            const current = registry2.get(base);
+            if (current?.value !== font.stack) {
+              registry2.set(base, font.stack, { reason });
+            }
+          }
+          fontAssignments.push({ role, family: font.name });
+        }
+        if (fontAssignments.length > 0 || definedFonts.length > 0) {
+          saveRegistryToDir(paths.tokens, registry2);
+          await generateOutputs(cwd, paths, registry2, exports, source);
+          log({
+            event: "init:import_fonts_applied",
+            cssPath: detectedCssPath,
+            fontsDetected: detectedFonts.map((f) => f.name),
+            assignments: fontAssignments,
+            ...definedFonts.length > 0 ? { definedFonts } : {}
+          });
+        }
+      }
     }
-    const out = describeWithOverlay(id, graph, ctx);
-    return this.jsonResult(this.withDeprecated(out));
   }
-};
+  log({
+    event: "init:complete",
+    outputs: [...outputs, "config.rafters.json"],
+    path: paths.output
+  });
+}
+
+// src/commands/mcp.ts
+import { existsSync as existsSync8 } from "fs";
+import { basename as basename2, join as join14, resolve as resolve5 } from "path";
+
+// src/mcp/server.ts
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+
+// src/version.ts
+import { readFileSync as readFileSync3 } from "fs";
+var UNKNOWN_VERSION = "0.0.0-unknown";
+function readVersion() {
+  try {
+    const parsed = JSON.parse(
+      readFileSync3(new URL("../package.json", import.meta.url), "utf-8")
+    );
+    if (parsed !== null && typeof parsed === "object" && "version" in parsed) {
+      const { version: version2 } = parsed;
+      if (typeof version2 === "string" && version2.length > 0) return version2;
+    }
+  } catch {
+  }
+  return UNKNOWN_VERSION;
+}
+var VERSION = readVersion();
 
 // src/mcp/server.ts
 async function startMcpServer(workspaces, defaultWorkspace) {
@@ -32518,8 +32624,8 @@ async function mcp(options) {
   let defaultWorkspace;
   if (options.projectRoot) {
     const explicit = resolve5(options.projectRoot);
-    const configPath2 = join13(explicit, ".rafters", "config.rafters.json");
-    if (!existsSync7(configPath2)) {
+    const configPath2 = join14(explicit, ".rafters", "config.rafters.json");
+    if (!existsSync8(configPath2)) {
       process.stderr.write(
         `--project-root ${explicit} does not contain .rafters/config.rafters.json
 `
@@ -32539,12 +32645,12 @@ async function mcp(options) {
 }
 
 // src/commands/studio.ts
-import { existsSync as existsSync8 } from "fs";
+import { existsSync as existsSync9 } from "fs";
 import { resolve as resolve6 } from "path";
 
 // ../studio/src/api/vite-plugin.ts
-import { readFile as readFile7, writeFile as writeFile5 } from "fs/promises";
-import { isAbsolute as isAbsolute4, join as join14 } from "path";
+import { readFile as readFile8, writeFile as writeFile6 } from "fs/promises";
+import { isAbsolute as isAbsolute4, join as join15 } from "path";
 var REGISTRY_PLUGINS3 = [scalePlugin, contrastPlugin, statePlugin, invertPlugin];
 var STUDIO_REASON_DEFAULT = "studio interactive edit";
 var TokenResponseSchema = external_exports.object({
@@ -32570,8 +32676,8 @@ var ColorBuildOptionsSchema = external_exports.object({
   states: external_exports.record(external_exports.string(), external_exports.string()).optional()
 });
 var projectPath = process.env.RAFTERS_PROJECT_PATH || process.cwd();
-var outputDir = join14(projectPath, ".rafters", "output");
-var configPath = join14(projectPath, ".rafters", "config.rafters.json");
+var outputDir = join15(projectPath, ".rafters", "output");
+var configPath = join15(projectPath, ".rafters", "config.rafters.json");
 var FontsConfigSchema = external_exports.object({
   path: external_exports.union([external_exports.string(), external_exports.null()]).optional(),
   imports: external_exports.array(external_exports.string()).optional()
@@ -32588,7 +32694,7 @@ var RaftersConfigSchema = external_exports.object({
 var KNOWN_INTENTS = ["efficient"];
 async function readRaftersConfig() {
   try {
-    const raw = JSON.parse(await readFile7(configPath, "utf8"));
+    const raw = JSON.parse(await readFile8(configPath, "utf8"));
     if ("shadcn" in raw && !("source" in raw)) {
       if (raw.shadcn === true) raw.source = "shadcn";
       delete raw.shadcn;
@@ -32998,7 +33104,7 @@ function studioApiPlugin() {
   return {
     name: "rafters-studio-api",
     async configureServer(server) {
-      const tokensDir = join14(projectPath, ".rafters", "tokens");
+      const tokensDir = join15(projectPath, ".rafters", "tokens");
       try {
         registry2 = loadRegistryFromDir(tokensDir, REGISTRY_PLUGINS3);
         initialized = true;
@@ -33061,11 +33167,11 @@ function studioApiPlugin() {
           const classDirs = watchConfig ? resolveContentSources(projectPath, watchConfig) : [];
           const newDirs = classDirs.filter((d2) => !trackedClassDirs.has(d2));
           if (newDirs.length > 0) {
-            server.watcher.add(newDirs.map((dir) => join14(dir, "**/*.classes.ts")));
+            server.watcher.add(newDirs.map((dir) => join15(dir, "**/*.classes.ts")));
             for (const d2 of newDirs) trackedClassDirs.add(d2);
           }
         };
-        server.watcher.add([join14(tokensDir, "*.rafters.json"), configPath]);
+        server.watcher.add([join15(tokensDir, "*.rafters.json"), configPath]);
         await syncWatchTargets();
         let debounce = null;
         const onChange = (changed) => {
@@ -33193,7 +33299,7 @@ function studioApiPlugin() {
           updated.fonts = merged;
         }
         try {
-          await writeFile5(configPath, `${JSON.stringify(updated, null, 2)}
+          await writeFile6(configPath, `${JSON.stringify(updated, null, 2)}
 `);
           reply({ ok: true, config: updated });
         } catch (error47) {
@@ -33351,7 +33457,7 @@ import { createServer } from "vite";
 async function studio() {
   const cwd = process.cwd();
   const paths = getRaftersPaths(cwd);
-  if (!existsSync8(paths.root)) {
+  if (!existsSync9(paths.root)) {
     console.error('No .rafters/ directory found. Run "rafters init" first.');
     process.exit(1);
   }
@@ -33386,6 +33492,9 @@ program.command("init").description("Initialize .rafters/ with default tokens an
 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("--update", "Re-fetch named components from registry").option("--update-all", "Re-fetch all installed components from registry").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)").option("--project-root <path>", "Explicit project root (skips .rafters/ discovery)").action(mcp);
 program.command("studio").description("Open Studio UI for visual token editing").action(studio);
+program.command("agents").description(
+  "Write or update the rafters contract block in AGENTS.md for non-Claude-Code agent hosts"
+).action(withErrorHandler(agents));
 program.parse();
 /*! Bundled license information: