rafters 0.0.49 → 0.0.52

package/dist/index.js

@@ -7100,8 +7100,8 @@ var require_util = __commonJS({
       }
       function fn() {
         var promiseResolve, promiseReject;
-        var promise = new Promise(function(resolve7, reject) {
-          promiseResolve = resolve7;
+        var promise = new Promise(function(resolve8, reject) {
+          promiseResolve = resolve8;
           promiseReject = reject;
         });
         var args = [];
@@ -10212,8 +10212,8 @@ var require_path = __commonJS({
     var win323 = {};
     function win32SplitPath(filename) {
       var result = splitDeviceRe.exec(filename), device = (result[1] || "") + (result[2] || ""), tail = result[3] || "";
-      var result2 = splitTailRe.exec(tail), dir = result2[1], basename3 = result2[2], ext2 = result2[3];
-      return [device, dir, basename3, ext2];
+      var result2 = splitTailRe.exec(tail), dir = result2[1], basename5 = result2[2], ext2 = result2[3];
+      return [device, dir, basename5, ext2];
     }
     function win32StatPath(path2) {
       var result = splitDeviceRe.exec(path2), device = result[1] || "", isUnc = !!device && device[1] !== ":";
@@ -11065,7 +11065,7 @@ var require_events = __commonJS({
       return ret;
     }
     function once(emitter, name2) {
-      return new Promise(function(resolve7, reject) {
+      return new Promise(function(resolve8, reject) {
         function errorListener(err) {
           emitter.removeListener(name2, resolver);
           reject(err);
@@ -11074,7 +11074,7 @@ var require_events = __commonJS({
           if (typeof emitter.removeListener === "function") {
             emitter.removeListener("error", errorListener);
           }
-          resolve7([].slice.call(arguments));
+          resolve8([].slice.call(arguments));
         }
         ;
         eventTargetAgnosticAddListener(emitter, name2, resolver, { once: true });
@@ -11784,11 +11784,11 @@ var require_util3 = __commonJS({
     var queueMicrotask_1 = require_queueMicrotask();
     exports.isWin = process2.platform === "win32";
     function promisify(fs22, fn, getResult = (input) => input) {
-      return (...args) => new Promise((resolve7, reject) => {
+      return (...args) => new Promise((resolve8, reject) => {
         fs22[fn].bind(fs22)(...args, (error3, result) => {
           if (error3)
             return reject(error3);
-          return resolve7(getResult(result));
+          return resolve8(getResult(result));
         });
       });
     }
@@ -11944,9 +11944,9 @@ var require_util3 = __commonJS({
     }
     function streamToBuffer(stream2) {
       const chunks = [];
-      return new Promise((resolve7, reject) => {
+      return new Promise((resolve8, reject) => {
         stream2.on("data", (chunk) => chunks.push(chunk));
-        stream2.on("end", () => resolve7(buffer_1.Buffer.concat(chunks)));
+        stream2.on("end", () => resolve8(buffer_1.Buffer.concat(chunks)));
         stream2.on("error", reject);
       });
     }
@@ -12327,11 +12327,11 @@ function __metadata(metadataKey, metadataValue) {
 }
 function __awaiter(thisArg, _arguments, P, generator) {
   function adopt(value2) {
-    return value2 instanceof P ? value2 : new P(function(resolve7) {
-      resolve7(value2);
+    return value2 instanceof P ? value2 : new P(function(resolve8) {
+      resolve8(value2);
     });
   }
-  return new (P || (P = Promise))(function(resolve7, reject) {
+  return new (P || (P = Promise))(function(resolve8, reject) {
     function fulfilled(value2) {
       try {
         step(generator.next(value2));
@@ -12347,7 +12347,7 @@ function __awaiter(thisArg, _arguments, P, generator) {
       }
     }
     function step(result) {
-      result.done ? resolve7(result.value) : adopt(result.value).then(fulfilled, rejected);
+      result.done ? resolve8(result.value) : adopt(result.value).then(fulfilled, rejected);
     }
     step((generator = generator.apply(thisArg, _arguments || [])).next());
   });
@@ -12530,14 +12530,14 @@ function __asyncValues(o) {
   }, i);
   function verb(n2) {
     i[n2] = o[n2] && function(v) {
-      return new Promise(function(resolve7, reject) {
-        v = o[n2](v), settle(resolve7, reject, v.done, v.value);
+      return new Promise(function(resolve8, reject) {
+        v = o[n2](v), settle(resolve8, reject, v.done, v.value);
       });
     };
   }
-  function settle(resolve7, reject, d2, v) {
+  function settle(resolve8, reject, d2, v) {
     Promise.resolve(v).then(function(v2) {
-      resolve7({ value: v2, done: d2 });
+      resolve8({ value: v2, done: d2 });
     }, reject);
   }
 }
@@ -12756,13 +12756,13 @@ var require_util4 = __commonJS({
       return Object.assign({ separator: "/", syncHandleAllowed: false, mode: "read" }, partial);
     };
     exports.ctx = ctx;
-    var basename3 = (path2, separator) => {
+    var basename5 = (path2, separator) => {
       if (path2[path2.length - 1] === separator)
         path2 = path2.slice(0, -1);
       const lastSlashIndex = path2.lastIndexOf(separator);
       return lastSlashIndex === -1 ? path2 : path2.slice(lastSlashIndex + 1);
     };
-    exports.basename = basename3;
+    exports.basename = basename5;
     var nameRegex = /^(\.{1,2})$|^(.*([\/\\]).*)$/;
     var assertName = (name2, method, klass) => {
       const isInvalid = !name2 || nameRegex.test(name2);
@@ -12955,12 +12955,12 @@ var require_Dir = __commonJS({
         return typeof x === "function";
       }
       promisify(obj, fn) {
-        return (...args) => new Promise((resolve7, reject) => {
+        return (...args) => new Promise((resolve8, reject) => {
           if (this.isFunction(obj[fn])) {
             obj[fn].bind(obj)(...args, (error3, result) => {
               if (error3)
                 reject(error3);
-              resolve7(result);
+              resolve8(result);
             });
           } else {
             reject("Not a function");
@@ -13084,7 +13084,7 @@ var require_volume = __commonJS({
     var Dir_1 = require_Dir();
     var resolveCrossPlatform = pathModule.resolve;
     var { O_RDONLY, O_WRONLY, O_RDWR, O_CREAT, O_EXCL, O_TRUNC, O_APPEND, O_DIRECTORY, O_SYMLINK, F_OK, COPYFILE_EXCL, COPYFILE_FICLONE_FORCE } = constants_1.constants;
-    var { sep: sep2, relative: relative4, join: join15, dirname: dirname5 } = pathModule.posix ? pathModule.posix : pathModule;
+    var { sep: sep2, relative: relative4, join: join16, dirname: dirname6 } = pathModule.posix ? pathModule.posix : pathModule;
     var kMinPoolSpace = 128;
     var EPERM = "EPERM";
     var ENOENT2 = "ENOENT";
@@ -13099,13 +13099,13 @@ var require_volume = __commonJS({
     var ENOSYS = "ENOSYS";
     var ERR_FS_EISDIR = "ERR_FS_EISDIR";
     var ERR_OUT_OF_RANGE = "ERR_OUT_OF_RANGE";
-    var resolve7 = (filename, base = process_1.default.cwd()) => resolveCrossPlatform(base, filename);
+    var resolve8 = (filename, base = process_1.default.cwd()) => resolveCrossPlatform(base, filename);
     if (util_1.isWin) {
-      const _resolve = resolve7;
-      resolve7 = (filename, base) => (0, util_1.unixify)(_resolve(filename, base));
+      const _resolve = resolve8;
+      resolve8 = (filename, base) => (0, util_1.unixify)(_resolve(filename, base));
     }
     function filenameToSteps(filename, base) {
-      const fullPath = resolve7(filename, base);
+      const fullPath = resolve8(filename, base);
       const fullPathSansSlash = fullPath.substring(1);
       if (!fullPathSansSlash)
         return [];
@@ -13150,7 +13150,7 @@ var require_volume = __commonJS({
       function flatten(pathPrefix, node) {
         for (const path2 in node) {
           const contentOrNode = node[path2];
-          const joinedPath = join15(pathPrefix, path2);
+          const joinedPath = join16(pathPrefix, path2);
           if (typeof contentOrNode === "string" || contentOrNode instanceof buffer_1.Buffer) {
             flatJSON[joinedPath] = contentOrNode;
           } else if (typeof contentOrNode === "object" && contentOrNode !== null && Object.keys(contentOrNode).length > 0) {
@@ -13307,7 +13307,7 @@ var require_volume = __commonJS({
               return null;
           node = curr === null || curr === void 0 ? void 0 : curr.getNode();
           if (resolveSymlinks && node.isSymlink()) {
-            const resolvedPath = pathModule.isAbsolute(node.symlink) ? node.symlink : join15(pathModule.dirname(curr.getPath()), node.symlink);
+            const resolvedPath = pathModule.isAbsolute(node.symlink) ? node.symlink : join16(pathModule.dirname(curr.getPath()), node.symlink);
             steps2 = filenameToSteps(resolvedPath).concat(steps2.slice(i + 1));
             curr = this.root;
             i = 0;
@@ -13466,9 +13466,9 @@ var require_volume = __commonJS({
       fromJSON(json2, cwd = process_1.default.cwd()) {
         for (let filename in json2) {
           const data = json2[filename];
-          filename = resolve7(filename, cwd);
+          filename = resolve8(filename, cwd);
           if (typeof data === "string" || data instanceof buffer_1.Buffer) {
-            const dir = dirname5(filename);
+            const dir = dirname6(filename);
             this.mkdirpBase(
               dir,
               511
@@ -19947,10 +19947,10 @@ var Minipass = class extends EventEmitter {
    * Return a void Promise that resolves once the stream ends.
    */
   async promise() {
-    return new Promise((resolve7, reject) => {
+    return new Promise((resolve8, reject) => {
       this.on(DESTROYED, () => reject(new Error("stream destroyed")));
       this.on("error", (er) => reject(er));
-      this.on("end", () => resolve7());
+      this.on("end", () => resolve8());
     });
   }
   /**
@@ -19974,7 +19974,7 @@ var Minipass = class extends EventEmitter {
         return Promise.resolve({ done: false, value: res });
       if (this[EOF])
         return stop();
-      let resolve7;
+      let resolve8;
       let reject;
       const onerr = (er) => {
         this.off("data", ondata);
@@ -19988,19 +19988,19 @@ var Minipass = class extends EventEmitter {
         this.off("end", onend);
         this.off(DESTROYED, ondestroy);
         this.pause();
-        resolve7({ value: value2, done: !!this[EOF] });
+        resolve8({ value: value2, done: !!this[EOF] });
       };
       const onend = () => {
         this.off("error", onerr);
         this.off("data", ondata);
         this.off(DESTROYED, ondestroy);
         stop();
-        resolve7({ done: true, value: void 0 });
+        resolve8({ done: true, value: void 0 });
       };
       const ondestroy = () => onerr(new Error("stream destroyed"));
       return new Promise((res2, rej) => {
         reject = rej;
-        resolve7 = res2;
+        resolve8 = res2;
         this.once(DESTROYED, ondestroy);
         this.once("error", onerr);
         this.once("end", onend);
@@ -20972,9 +20972,9 @@ var PathBase = class {
     if (this.#asyncReaddirInFlight) {
       await this.#asyncReaddirInFlight;
     } else {
-      let resolve7 = () => {
+      let resolve8 = () => {
       };
-      this.#asyncReaddirInFlight = new Promise((res) => resolve7 = res);
+      this.#asyncReaddirInFlight = new Promise((res) => resolve8 = res);
       try {
         for (const e of await this.#fs.promises.readdir(fullpath, {
           withFileTypes: true
@@ -20987,7 +20987,7 @@ var PathBase = class {
         children.provisional = 0;
       }
       this.#asyncReaddirInFlight = void 0;
-      resolve7();
+      resolve8();
     }
     return children.slice(0, children.provisional);
   }
@@ -24242,7 +24242,7 @@ function toBase64(buffer) {
   if (isNode) {
     return buffer.toString("base64");
   } else {
-    return new Promise((resolve7, reject) => {
+    return new Promise((resolve8, reject) => {
       const blob = new Blob([buffer], { type: "application/octet-stream" });
       const reader = new FileReader();
       reader.onloadend = () => {
@@ -24250,7 +24250,7 @@ function toBase64(buffer) {
           /** @type {string } */
           reader.result.split(",")[1]
         );
-        resolve7(base64String);
+        resolve8(base64String);
       };
       reader.onerror = reject;
       reader.readAsDataURL(blob);
@@ -27863,7 +27863,7 @@ var AESDecryptionStream = class extends TransformStream {
     super({
       start() {
         Object.assign(this, {
-          ready: new Promise((resolve7) => this.resolveReady = resolve7),
+          ready: new Promise((resolve8) => this.resolveReady = resolve8),
           password: encodePassword(password2, rawPassword),
           signed,
           strength: encryptionStrength - 1,
@@ -27931,7 +27931,7 @@ var AESEncryptionStream = class extends TransformStream {
     super({
       start() {
         Object.assign(this, {
-          ready: new Promise((resolve7) => this.resolveReady = resolve7),
+          ready: new Promise((resolve8) => this.resolveReady = resolve8),
           password: encodePassword(password2, rawPassword),
           strength: encryptionStrength - 1,
           pending: new Uint8Array()
@@ -35929,21 +35929,21 @@ async function registryToCompiled(registry, options = {}) {
   const { minify = true, includeImport = true } = options;
   const themeCss = registryToTailwind(registry, { includeImport });
   const { execFileSync } = await import("child_process");
-  const { mkdtempSync, writeFileSync, readFileSync, rmSync } = await import("fs");
-  const { join: join15, dirname: dirname5 } = await import("path");
+  const { mkdtempSync, writeFileSync, readFileSync: readFileSync2, rmSync } = await import("fs");
+  const { join: join16, dirname: dirname6 } = await import("path");
   const { createRequire: createRequire2 } = await import("module");
   const require2 = createRequire2(import.meta.url);
   let pkgDir;
   try {
     const pkgJsonPath = require2.resolve("@tailwindcss/cli/package.json");
-    pkgDir = dirname5(pkgJsonPath);
+    pkgDir = dirname6(pkgJsonPath);
   } 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 {
     writeFileSync(tempInput, themeCss);
     const args = [binPath, "-i", tempInput, "-o", tempOutput];
@@ -35951,7 +35951,7 @@ async function registryToCompiled(registry, options = {}) {
       args.push("--minify");
     }
     execFileSync("node", args, { stdio: "pipe", timeout: 3e4 });
-    return readFileSync(tempOutput, "utf-8");
+    return readFileSync2(tempOutput, "utf-8");
   } catch (error3) {
     const message = error3 instanceof Error ? error3.message : String(error3);
     throw new Error(`Failed to compile CSS: ${message}`);
@@ -46867,8 +46867,8 @@ async function maybeOnboardExisting(cwd, importPendingPath) {
 }
 
 // src/commands/mcp.ts
-import { existsSync as existsSync6 } from "fs";
-import { join as join13, resolve as resolve5 } from "path";
+import { existsSync as existsSync7 } from "fs";
+import { basename as basename4, join as join14, resolve as resolve6 } from "path";
 
 // src/mcp/server.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -46877,7 +46877,7 @@ import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprot
 
 // src/mcp/tools.ts
 import { readdir as readdir3 } from "fs/promises";
-import { join as join11 } from "path";
+import { join as join13 } from "path";
 
 // ../composites/src/built-in-rules/email.ts
 var email = external_exports.string().email();
@@ -46989,14 +46989,181 @@ function search(query) {
   }).filter((entry) => entry.score > 0).sort((a2, b2) => b2.score - a2.score).map((entry) => entry.c);
 }
 
+// src/utils/workspaces.ts
+import { existsSync as existsSync6, readdirSync as readdirSync2, readFileSync, statSync } from "fs";
+import { basename as basename3, dirname as dirname5, join as join12, resolve as resolve5 } from "path";
+
+// src/utils/discover.ts
+import { existsSync as existsSync5 } from "fs";
+import { dirname as dirname4, join as join11, resolve as resolve4 } from "path";
+function discoverProjectRoot(startDir) {
+  let current = resolve4(startDir);
+  for (; ; ) {
+    const configPath = join11(current, ".rafters", "config.rafters.json");
+    if (existsSync5(configPath)) {
+      return current;
+    }
+    const parent = dirname4(current);
+    if (parent === current) {
+      return null;
+    }
+    current = parent;
+  }
+}
+
+// src/utils/workspaces.ts
+function findMonorepoRoot(startDir, boundary) {
+  let current = resolve5(startDir);
+  const stopAt = boundary ? resolve5(boundary) : null;
+  for (; ; ) {
+    const pnpmWorkspace = join12(current, "pnpm-workspace.yaml");
+    if (existsSync6(pnpmWorkspace)) {
+      const patterns = parsePnpmWorkspaceYaml(readFileSync(pnpmWorkspace, "utf-8"));
+      if (patterns.length > 0) {
+        return { root: current, patterns };
+      }
+    }
+    const pkgJson = join12(current, "package.json");
+    if (existsSync6(pkgJson)) {
+      const patterns = parsePackageJsonWorkspaces(readFileSync(pkgJson, "utf-8"));
+      if (patterns.length > 0) {
+        return { root: current, patterns };
+      }
+    }
+    if (stopAt && current === stopAt) return null;
+    const parent = dirname5(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 = join12(monorepoRoot, parentRel);
+    if (!existsSync6(parent)) return [];
+    return readdirSync2(parent).map((entry) => join12(parent, entry)).filter((path2) => {
+      try {
+        return statSync(path2).isDirectory();
+      } catch {
+        return false;
+      }
+    });
+  }
+  const literal = join12(monorepoRoot, trimmed);
+  if (existsSync6(literal)) {
+    try {
+      if (statSync(literal).isDirectory()) return [literal];
+    } 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(resolve5(options.boundary))) return [];
+    return [{ name: basename3(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 = join12(dir, ".rafters", "config.rafters.json");
+      if (existsSync6(config2)) {
+        workspaces.push({ name: basename3(dir), root: dir });
+      }
+    }
+  }
+  const rootConfig = join12(layout.root, ".rafters", "config.rafters.json");
+  if (existsSync6(rootConfig) && !seen.has(layout.root)) {
+    workspaces.unshift({ name: basename3(layout.root), root: layout.root });
+  }
+  return workspaces;
+}
+function pickDefaultWorkspace(workspaces, startDir = process.cwd()) {
+  if (workspaces.length === 0) return null;
+  const cwd = resolve5(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, name2) {
+  if (name2) {
+    return workspaces.find((ws) => ws.name === name2) ?? null;
+  }
+  return defaultWorkspace;
+}
+
 // src/mcp/tools.ts
+var WORKSPACE_PARAM = {
+  workspace: {
+    type: "string",
+    description: "Workspace name (directory basename). Required when the MCP session has multiple workspaces and none matches cwd. Call rafters_workspaces to list options."
+  }
+};
 var TOOL_DEFINITIONS = [
+  {
+    name: "rafters_workspaces",
+    description: "List rafters workspaces visible to this MCP session. Returns name, path, and which one is the default for unscoped tool calls. Call this first when the project might be a monorepo.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: []
+    }
+  },
   {
     name: "rafters_composite",
     description: "Query composites by ID, search term, or category. Returns designer intent (solves, appliesWhen, do/never), I/O rules for chaining, and block structure.",
     inputSchema: {
       type: "object",
       properties: {
+        ...WORKSPACE_PARAM,
         id: { type: "string", description: "Get a specific composite by ID" },
         query: { type: "string", description: "Fuzzy search by name/keywords" },
         category: { type: "string", description: "Filter by category" }
@@ -47010,6 +47177,7 @@ var TOOL_DEFINITIONS = [
     inputSchema: {
       type: "object",
       properties: {
+        ...WORKSPACE_PARAM,
         name: { type: "string", description: "Get a specific rule by name" },
         query: { type: "string", description: "Search rules by name/description" },
         create: {
@@ -47032,6 +47200,7 @@ var TOOL_DEFINITIONS = [
     inputSchema: {
       type: "object",
       properties: {
+        ...WORKSPACE_PARAM,
         solves: {
           type: "string",
           description: "What problem the pattern solves (searches composite solves field)"
@@ -47050,6 +47219,7 @@ var TOOL_DEFINITIONS = [
     inputSchema: {
       type: "object",
       properties: {
+        ...WORKSPACE_PARAM,
         name: {
           type: "string",
           description: 'Component name (e.g., "button", "dialog", "card")'
@@ -47060,13 +47230,20 @@ var TOOL_DEFINITIONS = [
   }
 ];
 var RaftersToolHandler = class {
-  projectRoot;
-  compositesLoaded = false;
-  constructor(projectRoot) {
-    this.projectRoot = projectRoot;
+  workspaces;
+  defaultWorkspace;
+  /** Tracks per-workspace composite loading so we only read from disk once. */
+  compositesLoadedFor = /* @__PURE__ */ new Set();
+  /** Tracks built-in composite loading separately (loaded once globally). */
+  builtInCompositesLoaded = false;
+  constructor(workspaces, defaultWorkspace) {
+    this.workspaces = workspaces;
+    this.defaultWorkspace = defaultWorkspace;
   }
   async handleToolCall(name2, args) {
     switch (name2) {
+      case "rafters_workspaces":
+        return this.handleWorkspaces();
       case "rafters_composite":
         return this.handleComposite(args);
       case "rafters_rule":
@@ -47076,7 +47253,7 @@ var RaftersToolHandler = class {
       case "rafters_component":
         return this.handleComponent(args.name);
       default: {
-        const suggestion = name2 === "rafters_onboard" ? "rafters_onboard was removed. Token import is now a CLI operation: run `rafters init` (auto-detects and prompts) or `rafters import` (standalone)." : "Available tools: rafters_composite, rafters_rule, rafters_pattern, rafters_component.";
+        const suggestion = name2 === "rafters_onboard" ? "rafters_onboard was removed. Token import is now a CLI operation: run `rafters init` (auto-detects and prompts) or `rafters import` (standalone)." : "Available tools: rafters_workspaces, rafters_composite, rafters_rule, rafters_pattern, rafters_component.";
         return {
           content: [
             { type: "text", text: JSON.stringify({ error: `Unknown tool: ${name2}`, suggestion }) }
@@ -47085,6 +47262,54 @@ var RaftersToolHandler = class {
       }
     }
   }
+  /**
+   * Resolve the requested workspace, returning a structured error result when
+   * the agent didn't pick one and there's no default. Returns the default
+   * workspace (which may itself be null when no `.rafters/` exists at all)
+   * for tools that read agent-shipped data and can degrade gracefully.
+   */
+  resolve(name2) {
+    return resolveWorkspace(this.workspaces, this.defaultWorkspace, name2);
+  }
+  /**
+   * Build a structured error response listing the available workspaces.
+   * Use this when a tool requires a workspace and the agent didn't pick one.
+   */
+  workspaceRequiredError() {
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({
+            error: "workspace parameter required",
+            suggestion: "Multiple workspaces are available. Pass `workspace` with one of the names below.",
+            workspaces: this.workspaces.map((w) => ({ name: w.name, root: w.root }))
+          })
+        }
+      ]
+    };
+  }
+  async handleWorkspaces() {
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify(
+            {
+              workspaces: this.workspaces.map((w) => ({
+                name: w.name,
+                root: w.root,
+                isDefault: w.name === this.defaultWorkspace?.name
+              })),
+              defaultWorkspace: this.defaultWorkspace?.name ?? null
+            },
+            null,
+            2
+          )
+        }
+      ]
+    };
+  }
   async loadCompositesFromDir(dir) {
     try {
       const entries = await readdir3(dir);
@@ -47092,7 +47317,7 @@ var RaftersToolHandler = class {
       for (const file of files) {
         try {
           const { readFile: readFile9 } = await import("fs/promises");
-          const raw = await readFile9(join11(dir, file), "utf-8");
+          const raw = await readFile9(join13(dir, file), "utf-8");
           const parsed = JSON.parse(raw);
           const result = CompositeFileSchema.safeParse(parsed);
           if (result.success) {
@@ -47107,23 +47332,29 @@ var RaftersToolHandler = class {
     } catch {
     }
   }
-  async ensureCompositesLoaded() {
-    if (this.compositesLoaded) return;
-    const builtInDirs = ["typography"];
-    for (const dir of builtInDirs) {
-      await this.loadCompositesFromDir(
-        join11(process.cwd(), "node_modules/@rafters/composites/src", dir)
-      );
+  async ensureCompositesLoaded(workspace) {
+    if (!this.builtInCompositesLoaded) {
+      const builtInDirs = ["typography"];
+      for (const dir of builtInDirs) {
+        await this.loadCompositesFromDir(
+          join13(process.cwd(), "node_modules/@rafters/composites/src", dir)
+        );
+      }
+      this.builtInCompositesLoaded = true;
     }
-    if (this.projectRoot) {
-      const paths = getRaftersPaths(this.projectRoot);
-      await this.loadCompositesFromDir(join11(paths.root, "composites"));
+    if (workspace && !this.compositesLoadedFor.has(workspace.root)) {
+      const paths = getRaftersPaths(workspace.root);
+      await this.loadCompositesFromDir(join13(paths.root, "composites"));
+      this.compositesLoadedFor.add(workspace.root);
     }
-    this.compositesLoaded = true;
   }
   async handleComposite(args) {
-    await this.ensureCompositesLoaded();
-    const { id, query, category } = args;
+    const { id, query, category, workspace } = args;
+    const resolved = this.resolve(workspace);
+    if (workspace && !resolved) {
+      return this.workspaceRequiredError();
+    }
+    await this.ensureCompositesLoaded(resolved);
     let composites2;
     if (id) {
       const c4 = get2(id);
@@ -47190,8 +47421,12 @@ var RaftersToolHandler = class {
     return { content: [{ type: "text", text: JSON.stringify({ rules }, null, 2) }] };
   }
   async handlePattern(args) {
-    await this.ensureCompositesLoaded();
-    const { solves, query } = 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();
@@ -47268,8 +47503,8 @@ var RaftersToolHandler = class {
 };
 
 // src/mcp/server.ts
-async function startMcpServer(projectRoot) {
-  const toolHandler = new RaftersToolHandler(projectRoot);
+async function startMcpServer(workspaces, defaultWorkspace) {
+  const toolHandler = new RaftersToolHandler(workspaces, defaultWorkspace);
   const server = new Server(
     {
       name: "rafters",
@@ -47309,52 +47544,39 @@ async function startMcpServer(projectRoot) {
   });
 }
 
-// src/utils/discover.ts
-import { existsSync as existsSync5 } from "fs";
-import { dirname as dirname4, join as join12, resolve as resolve4 } from "path";
-function discoverProjectRoot(startDir) {
-  let current = resolve4(startDir);
-  for (; ; ) {
-    const configPath = join12(current, ".rafters", "config.rafters.json");
-    if (existsSync5(configPath)) {
-      return current;
-    }
-    const parent = dirname4(current);
-    if (parent === current) {
-      return null;
-    }
-    current = parent;
-  }
-}
-
 // src/commands/mcp.ts
 async function mcp(options) {
-  let projectRoot;
+  let workspaces;
+  let defaultWorkspace;
   if (options.projectRoot) {
-    const explicit = resolve5(options.projectRoot);
-    const configPath = join13(explicit, ".rafters", "config.rafters.json");
-    if (!existsSync6(configPath)) {
+    const explicit = resolve6(options.projectRoot);
+    const configPath = join14(explicit, ".rafters", "config.rafters.json");
+    if (!existsSync7(configPath)) {
       process.stderr.write(
         `--project-root ${explicit} does not contain .rafters/config.rafters.json
 `
       );
-      projectRoot = null;
+      workspaces = [];
+      defaultWorkspace = null;
     } else {
-      projectRoot = explicit;
+      const ws = { name: basename4(explicit), root: explicit };
+      workspaces = [ws];
+      defaultWorkspace = ws;
     }
   } else {
-    projectRoot = discoverProjectRoot(process.cwd());
+    workspaces = discoverWorkspaces(process.cwd());
+    defaultWorkspace = pickDefaultWorkspace(workspaces, process.cwd());
   }
-  await startMcpServer(projectRoot);
+  await startMcpServer(workspaces, defaultWorkspace);
 }
 
 // src/commands/studio.ts
-import { existsSync as existsSync7 } from "fs";
-import { resolve as resolve6 } from "path";
+import { existsSync as existsSync8 } from "fs";
+import { resolve as resolve7 } from "path";
 
 // ../studio/src/api/vite-plugin.ts
 import { writeFile as writeFile5 } from "fs/promises";
-import { join as join14 } from "path";
+import { join as join15 } from "path";
 var TokenResponseSchema = external_exports.object({
   ok: external_exports.literal(true),
   token: TokenSchema
@@ -47378,7 +47600,7 @@ 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 outputPath = join14(projectPath, ".rafters", "output", "rafters.vars.css");
+var outputPath = join15(projectPath, ".rafters", "output", "rafters.vars.css");
 var SetTokenMessageSchema = external_exports.object({
   name: external_exports.string().min(1),
   value: external_exports.union([external_exports.string(), ColorValueSchema, ColorReferenceSchema]),
@@ -47497,7 +47719,7 @@ function getNamespacePatchSchema(namespace) {
 }
 var MAX_BODY_SIZE = 1024 * 1024;
 function readJsonBody(req) {
-  return new Promise((resolve7, reject) => {
+  return new Promise((resolve8, reject) => {
     let body = "";
     let size = 0;
     req.on("data", (chunk) => {
@@ -47510,7 +47732,7 @@ function readJsonBody(req) {
     });
     req.on("end", () => {
       try {
-        resolve7(body ? JSON.parse(body) : {});
+        resolve8(body ? JSON.parse(body) : {});
       } catch {
         reject(new Error("Invalid JSON body"));
       }
@@ -47963,7 +48185,7 @@ import { createServer } from "vite";
 async function studio() {
   const cwd = process.cwd();
   const paths = getRaftersPaths(cwd);
-  if (!existsSync7(paths.root)) {
+  if (!existsSync8(paths.root)) {
     console.error('No .rafters/ directory found. Run "rafters init" first.');
     process.exit(1);
   }
@@ -47980,7 +48202,7 @@ async function studio() {
     },
     resolve: {
       alias: {
-        "@rafters-output": resolve6(cwd, ".rafters", "output")
+        "@rafters-output": resolve7(cwd, ".rafters", "output")
       }
     }
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rafters",
-  "version": "0.0.49",
+  "version": "0.0.52",
   "description": "CLI for Rafters design system - scaffold tokens and add components",
   "license": "MIT",
   "type": "module",
@@ -33,7 +33,6 @@
     "@antfu/ni": "^28.1.0",
     "@inquirer/prompts": "^8.2.0",
     "@modelcontextprotocol/sdk": "^1.25.1",
-    "@rafters/composites": "workspace:*",
     "commander": "^13.0.0",
     "css-tree": "^3.2.1",
     "execa": "^9.6.1",
@@ -43,6 +42,7 @@
   "devDependencies": {
     "@playwright/test": "catalog:",
     "@rafters/color-utils": "workspace:*",
+    "@rafters/composites": "workspace:*",
     "@rafters/design-tokens": "workspace:*",
     "@rafters/shared": "workspace:*",
     "@rafters/studio": "workspace:*",