@buoy-design/cli 0.6.1 → 0.7.0

package/dist/commands/index.d.ts

@@ -5,6 +5,7 @@ export { createAhoyCommand } from "./ahoy.js";
 export { createDesignMdCommand } from "./designmd/index.js";
 export { createSystemCommand } from "./system.js";
 export { createRescueCommand } from "./rescue.js";
+export { createMcpCommand } from "./mcp.js";
 export { createCheckCommand } from "./check.js";
 export { createIgnoreCommand, loadIgnoreList, filterIgnored, } from "./ignore.js";
 export { createFixCommand } from "./fix.js";

package/dist/commands/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAG5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/commands/index.js

@@ -5,6 +5,7 @@ export { createAhoyCommand } from "./ahoy.js";
 export { createDesignMdCommand } from "./designmd/index.js";
 export { createSystemCommand } from "./system.js";
 export { createRescueCommand } from "./rescue.js";
+export { createMcpCommand } from "./mcp.js";
 // Re-exports for internal use (subcommands within groups)
 export { createCheckCommand } from "./check.js";
 export { createIgnoreCommand, loadIgnoreList, filterIgnored, } from "./ignore.js";

package/dist/commands/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,0DAA0D;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,0DAA0D;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/commands/mcp.d.ts

@@ -0,0 +1,10 @@
+/**
+ * buoy mcp - Connect coding agents to this repo's design system.
+ *
+ *   buoy mcp serve            stdio MCP server (tokens, drift checks, context)
+ *   buoy mcp install [client] write .mcp.json / .cursor/mcp.json and the Claude Code hook
+ *   buoy mcp hook             Claude Code PostToolUse hook: check the edited file
+ */
+import { Command } from "commander";
+export declare function createMcpCommand(): Command;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/commands/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,wBAAgB,gBAAgB,IAAI,OAAO,CAoD1C"}

package/dist/commands/mcp.js

@@ -0,0 +1,71 @@
+/**
+ * buoy mcp - Connect coding agents to this repo's design system.
+ *
+ *   buoy mcp serve            stdio MCP server (tokens, drift checks, context)
+ *   buoy mcp install [client] write .mcp.json / .cursor/mcp.json and the Claude Code hook
+ *   buoy mcp hook             Claude Code PostToolUse hook: check the edited file
+ */
+import { Command } from "commander";
+import pkg from "../../package.json" with { type: "json" };
+import { installClient, MCP_CLIENTS } from "../mcp/install.js";
+import { filePathFromHookPayload, runHook } from "../mcp/hook.js";
+async function readStdin() {
+    if (process.stdin.isTTY)
+        return "";
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(chunk);
+    return Buffer.concat(chunks).toString("utf8");
+}
+export function createMcpCommand() {
+    const cmd = new Command("mcp").description("Connect coding agents (Claude Code, Cursor, Codex) to your design system");
+    cmd
+        .command("serve")
+        .description("Run the MCP server over stdio (agents start this for you)")
+        .action(async () => {
+        const { serveStdio } = await import("../mcp/server.js");
+        await serveStdio({ cwd: process.cwd(), version: pkg.version });
+    });
+    cmd
+        .command("install [client]")
+        .description(`Write agent config for ${MCP_CLIENTS.join(", ")} or "all" (default: claude)`)
+        .option("--no-hook", "Skip the Claude Code PostToolUse drift hook")
+        .action((client, options) => {
+        const wanted = client === "all" ? MCP_CLIENTS : [(client ?? "claude")];
+        for (const c of wanted) {
+            if (!MCP_CLIENTS.includes(c)) {
+                console.error(`Unknown client "${c}". Choose one of: ${MCP_CLIENTS.join(", ")}, all`);
+                process.exit(1);
+            }
+        }
+        for (const c of wanted) {
+            const result = installClient(c, process.cwd(), { hook: options.hook });
+            console.log(`${c}: wrote ${result.files.join(", ")}`);
+        }
+        console.log("");
+        console.log("Agents in this repo can now call list_design_tokens, find_token_for_value, check_design_drift and design_system_context.");
+        if (wanted.includes("claude") && options.hook !== false) {
+            console.log("Claude Code will also get drift feedback after every Edit/Write of a style file.");
+        }
+    });
+    cmd
+        .command("hook")
+        .description("PostToolUse hook: reads the Claude Code payload on stdin and reports drift in the edited file")
+        .option("--file <path>", "Check this file instead of reading stdin")
+        .action(async (options) => {
+        const file = options.file ?? filePathFromHookPayload(await readStdin());
+        try {
+            const result = await runHook(process.cwd(), file);
+            if (result.message)
+                console.error(result.message);
+            process.exit(result.exitCode);
+        }
+        catch (error) {
+            // A broken hook must never block the agent.
+            console.error(`Buoy hook skipped: ${error instanceof Error ? error.message : String(error)}`);
+            process.exit(0);
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=mcp.js.map

package/dist/commands/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,wBAAgB,SAAS,IAAI,OAAO,CAkDnC;AAGD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,wBAAgB,SAAS,IAAI,OAAO,CAqDnC;AAGD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 import { Command } from "commander";
 import pkg from "../package.json" with { type: "json" };
-import { createShowCommand, createDriftCommand, createDockCommand, createAhoyCommand, createDesignMdCommand, createSystemCommand, createRescueCommand, } from "./commands/index.js";
+import { createShowCommand, createDriftCommand, createDockCommand, createAhoyCommand, createDesignMdCommand, createSystemCommand, createRescueCommand, createMcpCommand, } from "./commands/index.js";
 export function createCli() {
     const program = new Command();
     program
@@ -39,6 +39,8 @@ Quick Start:
     program.addCommand(createAhoyCommand());
     // === Design ===
     program.addCommand(createDesignMdCommand());
+    // Agent integration: MCP server, client config, Claude Code hook
+    program.addCommand(createMcpCommand());
     return program;
 }
 // Re-export config utilities for user config files

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxD,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,UAAU,SAAS;IACvB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,MAAM,CAAC;SACZ,WAAW,CAAC,kDAAkD,CAAC;SAC/D,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;SACpB,aAAa,CAAC;QACb,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE;KACpC,CAAC;SACD,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;;;CAcL,CACI,CAAC;IAEJ,2BAA2B;IAC3B,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAE1C,mCAAmC;IACnC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAE1C,wBAAwB;IACxB,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAEzC,gBAAgB;IAChB,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAExC,gBAAgB;IAChB,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAExC,iBAAiB;IACjB,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAE5C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,mDAAmD;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxD,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,UAAU,SAAS;IACvB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,MAAM,CAAC;SACZ,WAAW,CAAC,kDAAkD,CAAC;SAC/D,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;SACpB,aAAa,CAAC;QACb,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE;KACpC,CAAC;SACD,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;;;CAcL,CACI,CAAC;IAEJ,2BAA2B;IAC3B,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAE1C,mCAAmC;IACnC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAE1C,wBAAwB;IACxB,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAEzC,gBAAgB;IAChB,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAExC,gBAAgB;IAChB,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAExC,iBAAiB;IACjB,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAE5C,iEAAiE;IACjE,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAEvC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,mDAAmD;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/mcp/file-check.d.ts

@@ -0,0 +1,20 @@
+import type { DesignToken } from "@buoy-design/core";
+import { type RawSignal } from "@buoy-design/scanners";
+/** Split a shorthand value on spaces, keeping function calls like rgb(...) intact. */
+export declare function splitCssValue(value: string): string[];
+/** Value-level signals for one file's content. Pure; `path` is only used for locations. */
+export declare function extractFileSignals(content: string, path: string): RawSignal[];
+export interface FileIssue {
+    file: string;
+    line: number;
+    type: string;
+    severity: "warning" | "info";
+    message: string;
+    current: string;
+    suggested?: string;
+    tokenSuggestions?: string[];
+}
+/** Turn raw signals into issues, attaching the token that has the same value when one exists. */
+export declare function issuesFromSignals(signals: RawSignal[], tokens: DesignToken[]): FileIssue[];
+export declare function checkFiles(files: string[], projectRoot: string, tokens: DesignToken[]): Promise<FileIssue[]>;
+//# sourceMappingURL=file-check.d.ts.map

package/dist/mcp/file-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-check.d.ts","sourceRoot":"","sources":["../../src/mcp/file-check.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAgBL,KAAK,SAAS,EAEf,MAAM,uBAAuB,CAAC;AAU/B,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBrD;AAgFD,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CAgC7E;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,SAAS,GAAG,MAAM,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAMD,iGAAiG;AACjG,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,EAAE,CAyB1F;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAclH"}

package/dist/mcp/file-check.js

@@ -0,0 +1,195 @@
+/**
+ * Line-level drift check for a handful of files.
+ *
+ * The repo-wide DriftAnalysisService reasons about components; it does not
+ * look at literal values inside plain CSS, and it reports a component's line,
+ * not the value's. Agents need "line 12: #fff -> var(--color-white)", so this
+ * runs the same value-level extractors the PR reviewer uses, per file, and
+ * looks each value up in the repo's tokens.
+ */
+import { readFile } from "node:fs/promises";
+import { isAbsolute, join, relative } from "node:path";
+import { extractBorderWidthSignals, extractColorSignals, extractDurationSignals, extractEasingSignals, extractFontFamilySignals, extractFontSizeSignals, extractFontWeightSignals, extractLetterSpacingSignals, extractLineHeightSignals, extractOpacitySignals, extractRadiusSignals, extractShadowSignals, extractSpacingSignals, extractTransitionShorthandSignals, extractZIndexSignals, } from "@buoy-design/scanners";
+import { findTokensByValue } from "./project.js";
+const COLOR_PART = /^(#[0-9a-f]{3,8}|rgba?\(|hsla?\(|oklch\(|oklab\(|color\()/i;
+/** Split a shorthand value on spaces, keeping function calls like rgb(...) intact. */
+export function splitCssValue(value) {
+    const parts = [];
+    let current = "";
+    let depth = 0;
+    for (const ch of value) {
+        if (ch === "(")
+            depth++;
+        if (ch === ")")
+            depth--;
+        if (ch === " " && depth === 0) {
+            if (current)
+                parts.push(current);
+            current = "";
+        }
+        else {
+            current += ch;
+        }
+    }
+    if (current)
+        parts.push(current);
+    return parts;
+}
+// Same routing as the cloud scanner container (containers/scanner/src/index.js).
+const CSS_PROPERTY_EXTRACTORS = {
+    color: "color", "background-color": "color", "border-color": "color", "outline-color": "color",
+    "text-decoration-color": "color", fill: "color", stroke: "color", "caret-color": "color", "accent-color": "color",
+    padding: "spacing", "padding-top": "spacing", "padding-right": "spacing", "padding-bottom": "spacing", "padding-left": "spacing",
+    "padding-inline": "spacing", "padding-block": "spacing",
+    margin: "spacing", "margin-top": "spacing", "margin-right": "spacing", "margin-bottom": "spacing", "margin-left": "spacing",
+    "margin-inline": "spacing", "margin-block": "spacing",
+    gap: "spacing", "row-gap": "spacing", "column-gap": "spacing",
+    top: "spacing", right: "spacing", bottom: "spacing", left: "spacing", inset: "spacing",
+    "font-size": "fontSize", "font-family": "fontFamily", "font-weight": "fontWeight",
+    "line-height": "lineHeight", "letter-spacing": "letterSpacing",
+    "border-radius": "radius", "border-top-left-radius": "radius", "border-top-right-radius": "radius",
+    "border-bottom-left-radius": "radius", "border-bottom-right-radius": "radius",
+    "box-shadow": "shadow", "text-shadow": "shadow",
+    "z-index": "zIndex", opacity: "opacity",
+    "transition-duration": "duration", "animation-duration": "duration",
+    "transition-timing-function": "easing", "animation-timing-function": "easing",
+    transition: "transitionShorthand",
+    "border-width": "borderWidth", "border-top-width": "borderWidth", "border-right-width": "borderWidth",
+    "border-bottom-width": "borderWidth", "border-left-width": "borderWidth",
+    background: "colorShorthand", border: "colorShorthand", "border-top": "colorShorthand",
+    "border-right": "colorShorthand", "border-bottom": "colorShorthand", "border-left": "colorShorthand", outline: "colorShorthand",
+};
+const JSX_PROPERTY_EXTRACTORS = Object.fromEntries(Object.entries(CSS_PROPERTY_EXTRACTORS).map(([prop, extractor]) => [
+    prop.replace(/-([a-z])/g, (_, c) => c.toUpperCase()),
+    extractor,
+]));
+// Signal type -> token category to search for a replacement.
+const SIGNAL_CATEGORY = {
+    "color-value": "color",
+    "spacing-value": "spacing",
+    "radius-value": "border",
+    "shadow-value": "shadow",
+    "border-width": "border",
+    "font-size": "typography",
+    "font-family": "typography",
+    "font-weight": "typography",
+    "line-height": "typography",
+    "letter-spacing": "typography",
+    "z-index": "zIndex",
+    "motion-duration": "motion",
+    "motion-easing": "motion",
+    "opacity-value": undefined,
+};
+const CSS_PROP = /([a-z-]+)\s*:\s*([^;{}]+)/g;
+const JSX_PROP = /(\w+)\s*:\s*(?:'([^']*)'|"([^"]*)"|(\d+\.?\d*)(?=[,}\s]))/g;
+function route(extractor, value, path, line, property, ctx) {
+    switch (extractor) {
+        case "color": return extractColorSignals(value, path, line, property, ctx);
+        case "spacing": return extractSpacingSignals(value, path, line, property, ctx);
+        case "fontSize": return extractFontSizeSignals(value, path, line, ctx);
+        case "fontFamily": return extractFontFamilySignals(value, path, line, ctx);
+        case "fontWeight": return extractFontWeightSignals(value, path, line, ctx);
+        case "lineHeight": return extractLineHeightSignals(value, path, line, ctx);
+        case "letterSpacing": return extractLetterSpacingSignals(value, path, line, ctx);
+        case "radius": return extractRadiusSignals(value, path, line, property, ctx);
+        case "shadow": return extractShadowSignals(value, path, line, property, ctx);
+        case "zIndex": return extractZIndexSignals(value, path, line, ctx);
+        case "opacity": return extractOpacitySignals(value, path, line, ctx);
+        case "duration": return extractDurationSignals(value, path, line, property, ctx);
+        case "easing": return extractEasingSignals(value, path, line, property, ctx);
+        case "borderWidth": return extractBorderWidthSignals(value, path, line, property, ctx);
+        case "transitionShorthand": return extractTransitionShorthandSignals(value, path, line, ctx);
+        case "colorShorthand":
+            // background / border shorthands: only the colour part is a token candidate.
+            return splitCssValue(value)
+                .filter((part) => COLOR_PART.test(part))
+                .flatMap((part) => extractColorSignals(part, path, line, `${property}-color`, ctx));
+    }
+}
+/** Value-level signals for one file's content. Pure; `path` is only used for locations. */
+export function extractFileSignals(content, path) {
+    const isCss = /\.(css|scss)$/.test(path);
+    const isJsx = /\.(tsx|jsx)$/.test(path);
+    if (!isCss && !isJsx)
+        return [];
+    const ctx = {
+        fileType: isCss ? "css" : "tsx",
+        framework: isJsx ? "react" : "css",
+        scope: "global",
+        isTokenized: false,
+    };
+    const signals = [];
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i] ?? "";
+        // Already tokenised: var(--x), theme.x, tokens.x, $scss-var
+        if (line.includes("var(--") || line.includes("theme.") || line.includes("tokens.") || line.includes("$"))
+            continue;
+        const pattern = isCss ? CSS_PROP : JSX_PROP;
+        const table = isCss ? CSS_PROPERTY_EXTRACTORS : JSX_PROPERTY_EXTRACTORS;
+        pattern.lastIndex = 0;
+        let m;
+        while ((m = pattern.exec(line)) !== null) {
+            const property = (m[1] ?? "").trim();
+            const extractor = table[property];
+            if (!extractor)
+                continue;
+            let value = isCss ? (m[2] ?? "").trim() : (m[2] ?? m[3] ?? m[4]);
+            if (value === undefined || value === "")
+                continue;
+            // Bare numbers in JSX style objects are pixels.
+            if (isJsx && m[4] !== undefined)
+                value = `${value}px`;
+            signals.push(...route(extractor, value, path, i + 1, property, ctx));
+        }
+    }
+    return signals;
+}
+function tokenRef(token) {
+    return token.name.startsWith("--") ? `var(${token.name})` : token.name;
+}
+/** Turn raw signals into issues, attaching the token that has the same value when one exists. */
+export function issuesFromSignals(signals, tokens) {
+    const seen = new Set();
+    const issues = [];
+    for (const s of signals) {
+        const current = String(s.value);
+        const key = `${s.location.path}:${s.location.line}:${s.type}:${current}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        const category = SIGNAL_CATEGORY[s.type];
+        const matches = findTokensByValue(tokens, current, category);
+        const first = matches[0];
+        const label = s.type.replace(/-value$/, "").replace(/-/g, " ");
+        issues.push({
+            file: s.location.path,
+            line: s.location.line,
+            type: `hardcoded-${s.type.replace(/-value$/, "")}`,
+            severity: first ? "warning" : "info",
+            message: first
+                ? `Hardcoded ${label} ${current} has a token: ${first.name}`
+                : `Hardcoded ${label} ${current} (no matching token)`,
+            current,
+            ...(first ? { suggested: tokenRef(first), tokenSuggestions: matches.map(tokenRef) } : {}),
+        });
+    }
+    return issues;
+}
+export async function checkFiles(files, projectRoot, tokens) {
+    const issues = [];
+    for (const file of files) {
+        const abs = isAbsolute(file) ? file : join(projectRoot, file);
+        const rel = relative(projectRoot, abs) || file;
+        let content;
+        try {
+            content = await readFile(abs, "utf8");
+        }
+        catch {
+            continue; // deleted or unreadable: nothing to check
+        }
+        issues.push(...issuesFromSignals(extractFileSignals(content, rel), tokens));
+    }
+    return issues;
+}
+//# sourceMappingURL=file-check.js.map

package/dist/mcp/file-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-check.js","sourceRoot":"","sources":["../../src/mcp/file-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEvD,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,EACxB,2BAA2B,EAC3B,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,iCAAiC,EACjC,oBAAoB,GAGrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAOjD,MAAM,UAAU,GAAG,4DAA4D,CAAC;AAEhF,sFAAsF;AACtF,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,EAAE,KAAK,GAAG;YAAE,KAAK,EAAE,CAAC;QACxB,IAAI,EAAE,KAAK,GAAG;YAAE,KAAK,EAAE,CAAC;QACxB,IAAI,EAAE,KAAK,GAAG,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAC9B,IAAI,OAAO;gBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACjC,OAAO,GAAG,EAAE,CAAC;QACf,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IACD,IAAI,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,iFAAiF;AACjF,MAAM,uBAAuB,GAA8B;IACzD,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO;IAC9F,uBAAuB,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO;IACjH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,gBAAgB,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS;IAChI,gBAAgB,EAAE,SAAS,EAAE,eAAe,EAAE,SAAS;IACvD,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS;IAC3H,eAAe,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS;IACrD,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS;IAC7D,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS;IACtF,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY;IACjF,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe;IAC9D,eAAe,EAAE,QAAQ,EAAE,wBAAwB,EAAE,QAAQ,EAAE,yBAAyB,EAAE,QAAQ;IAClG,2BAA2B,EAAE,QAAQ,EAAE,4BAA4B,EAAE,QAAQ;IAC7E,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ;IAC/C,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS;IACvC,qBAAqB,EAAE,UAAU,EAAE,oBAAoB,EAAE,UAAU;IACnE,4BAA4B,EAAE,QAAQ,EAAE,2BAA2B,EAAE,QAAQ;IAC7E,UAAU,EAAE,qBAAqB;IACjC,cAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAAE,oBAAoB,EAAE,aAAa;IACrG,qBAAqB,EAAE,aAAa,EAAE,mBAAmB,EAAE,aAAa;IACxE,UAAU,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,YAAY,EAAE,gBAAgB;IACtF,cAAc,EAAE,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,gBAAgB,EAAE,OAAO,EAAE,gBAAgB;CAChI,CAAC;AAEF,MAAM,uBAAuB,GAA8B,MAAM,CAAC,WAAW,CAC3E,MAAM,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC;IACjE,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5D,SAAS;CACV,CAAC,CACH,CAAC;AAEF,6DAA6D;AAC7D,MAAM,eAAe,GAAwD;IAC3E,aAAa,EAAE,OAAO;IACtB,eAAe,EAAE,SAAS;IAC1B,cAAc,EAAE,QAAQ;IACxB,cAAc,EAAE,QAAQ;IACxB,cAAc,EAAE,QAAQ;IACxB,WAAW,EAAE,YAAY;IACzB,aAAa,EAAE,YAAY;IAC3B,aAAa,EAAE,YAAY;IAC3B,aAAa,EAAE,YAAY;IAC3B,gBAAgB,EAAE,YAAY;IAC9B,SAAS,EAAE,QAAQ;IACnB,iBAAiB,EAAE,QAAQ;IAC3B,eAAe,EAAE,QAAQ;IACzB,eAAe,EAAE,SAAS;CAC3B,CAAC;AAEF,MAAM,QAAQ,GAAG,4BAA4B,CAAC;AAC9C,MAAM,QAAQ,GAAG,4DAA4D,CAAC;AAE9E,SAAS,KAAK,CAAC,SAAoB,EAAE,KAAa,EAAE,IAAY,EAAE,IAAY,EAAE,QAAgB,EAAE,GAAkB;IAClH,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,OAAO,CAAC,CAAC,OAAO,mBAAmB,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC3E,KAAK,SAAS,CAAC,CAAC,OAAO,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC/E,KAAK,UAAU,CAAC,CAAC,OAAO,sBAAsB,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;QACvE,KAAK,YAAY,CAAC,CAAC,OAAO,wBAAwB,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;QAC3E,KAAK,YAAY,CAAC,CAAC,OAAO,wBAAwB,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;QAC3E,KAAK,YAAY,CAAC,CAAC,OAAO,wBAAwB,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;QAC3E,KAAK,eAAe,CAAC,CAAC,OAAO,2BAA2B,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;QACjF,KAAK,QAAQ,CAAC,CAAC,OAAO,oBAAoB,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC7E,KAAK,QAAQ,CAAC,CAAC,OAAO,oBAAoB,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC7E,KAAK,QAAQ,CAAC,CAAC,OAAO,oBAAoB,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;QACnE,KAAK,SAAS,CAAC,CAAC,OAAO,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;QACrE,KAAK,UAAU,CAAC,CAAC,OAAO,sBAAsB,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QACjF,KAAK,QAAQ,CAAC,CAAC,OAAO,oBAAoB,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC7E,KAAK,aAAa,CAAC,CAAC,OAAO,yBAAyB,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QACvF,KAAK,qBAAqB,CAAC,CAAC,OAAO,iCAAiC,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;QAC7F,KAAK,gBAAgB;YACnB,6EAA6E;YAC7E,OAAO,aAAa,CAAC,KAAK,CAAC;iBACxB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;iBACvC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,QAAQ,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;IAC1F,CAAC;AACH,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,IAAY;IAC9D,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,GAAG,GAAkB;QACzB,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK;QAC/B,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;QAClC,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,KAAK;KACnB,CAAC;IACF,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5B,4DAA4D;QAC5D,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS;QACnH,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,uBAAuB,CAAC;QACxE,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC;QACtB,IAAI,CAAyB,CAAC;QAC9B,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACzC,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACrC,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;YAClC,IAAI,CAAC,SAAS;gBAAE,SAAS;YACzB,IAAI,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACjE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;gBAAE,SAAS;YAClD,gDAAgD;YAChD,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS;gBAAE,KAAK,GAAG,GAAG,KAAK,IAAI,CAAC;YACtD,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAaD,SAAS,QAAQ,CAAC,KAAuB;IACvC,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;AACzE,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,iBAAiB,CAAC,OAAoB,EAAE,MAAqB;IAC3E,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;QACzE,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,MAAM,QAAQ,GAAG,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC/D,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI;YACrB,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI;YACrB,IAAI,EAAE,aAAa,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE;YAClD,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;YACpC,OAAO,EAAE,KAAK;gBACZ,CAAC,CAAC,aAAa,KAAK,IAAI,OAAO,iBAAiB,KAAK,CAAC,IAAI,EAAE;gBAC5D,CAAC,CAAC,aAAa,KAAK,IAAI,OAAO,sBAAsB;YACvD,OAAO;YACP,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1F,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAe,EAAE,WAAmB,EAAE,MAAqB;IAC1F,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAC9D,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC;QAC/C,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,SAAS,CAAC,0CAA0C;QACtD,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,kBAAkB,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/mcp/hook.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Claude Code PostToolUse hook: after the agent edits a file, check that
+ * file for drift and hand the issues back as feedback (exit code 2). Other
+ * agents can call `buoy mcp hook --file <path>` the same way.
+ */
+import { type DriftCheck } from "./project.js";
+/** Pull the edited path out of a Claude Code hook payload. */
+export declare function filePathFromHookPayload(raw: string): string | null;
+export declare function isStyleFile(path: string): boolean;
+export declare function formatHookFeedback(file: string, check: DriftCheck): string;
+export interface HookResult {
+    exitCode: 0 | 2;
+    message: string | null;
+}
+export declare function runHook(cwd: string, file: string | null): Promise<HookResult>;
+//# sourceMappingURL=hook.d.ts.map

package/dist/mcp/hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../src/mcp/hook.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAA2B,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAIxE,8DAA8D;AAC9D,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOlE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAU1E;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAMnF"}

package/dist/mcp/hook.js

@@ -0,0 +1,42 @@
+/**
+ * Claude Code PostToolUse hook: after the agent edits a file, check that
+ * file for drift and hand the issues back as feedback (exit code 2). Other
+ * agents can call `buoy mcp hook --file <path>` the same way.
+ */
+import { checkDrift, loadProject } from "./project.js";
+const STYLE_FILE = /\.(tsx|jsx|vue|svelte|css|scss|html)$/;
+/** Pull the edited path out of a Claude Code hook payload. */
+export function filePathFromHookPayload(raw) {
+    try {
+        const payload = JSON.parse(raw);
+        return payload.tool_input?.file_path ?? payload.tool_input?.path ?? payload.tool_response?.filePath ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export function isStyleFile(path) {
+    return STYLE_FILE.test(path);
+}
+export function formatHookFeedback(file, check) {
+    const lines = [`Buoy: ${check.summary.total} design drift issue${check.summary.total === 1 ? "" : "s"} in ${file}`];
+    for (const issue of check.issues.slice(0, 15)) {
+        const where = issue.line ? `:${issue.line}` : "";
+        const fix = issue.suggested ? ` -> use ${issue.suggested}` : issue.tokenSuggestions?.[0] ? ` -> ${issue.tokenSuggestions[0]}` : "";
+        lines.push(`- ${issue.file}${where} ${issue.message}${fix}`);
+    }
+    if (check.issues.length > 15)
+        lines.push(`- ... and ${check.issues.length - 15} more`);
+    lines.push("Replace the literal values with the tokens above, then continue.");
+    return lines.join("\n");
+}
+export async function runHook(cwd, file) {
+    if (!file || !isStyleFile(file))
+        return { exitCode: 0, message: null };
+    const project = await loadProject(cwd);
+    const check = await checkDrift(project, [file]);
+    if (check.summary.total === 0)
+        return { exitCode: 0, message: null };
+    return { exitCode: 2, message: formatHookFeedback(file, check) };
+}
+//# sourceMappingURL=hook.js.map

package/dist/mcp/hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.js","sourceRoot":"","sources":["../../src/mcp/hook.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAmB,MAAM,cAAc,CAAC;AAExE,MAAM,UAAU,GAAG,uCAAuC,CAAC;AAE3D,8DAA8D;AAC9D,MAAM,UAAU,uBAAuB,CAAC,GAAW;IACjD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkG,CAAC;QACjI,OAAO,OAAO,CAAC,UAAU,EAAE,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE,IAAI,IAAI,OAAO,CAAC,aAAa,EAAE,QAAQ,IAAI,IAAI,CAAC;IAC9G,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,KAAiB;IAChE,MAAM,KAAK,GAAG,CAAC,SAAS,KAAK,CAAC,OAAO,CAAC,KAAK,sBAAsB,KAAK,CAAC,OAAO,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,EAAE,CAAC,CAAC;IACpH,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnI,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,GAAG,KAAK,IAAI,KAAK,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE,OAAO,CAAC,CAAC;IACvF,KAAK,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;IAC/E,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,IAAmB;IAC5D,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACvE,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAChD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,KAAK,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACrE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;AACnE,CAAC"}

package/dist/mcp/install.d.ts

@@ -0,0 +1,14 @@
+export type McpClient = "claude" | "cursor" | "codex" | "windsurf";
+export declare const MCP_CLIENTS: McpClient[];
+/** Merge Buoy into an `mcpServers` map without touching other servers. */
+export declare function mergeMcpServers(existing: Record<string, unknown>): Record<string, unknown>;
+/** Add the PostToolUse hook to Claude Code settings unless it is already there. */
+export declare function mergeClaudeHook(existing: Record<string, unknown>): Record<string, unknown>;
+export interface InstallResult {
+    client: McpClient;
+    files: string[];
+}
+export declare function installClient(client: McpClient, cwd: string, options?: {
+    hook?: boolean;
+}): InstallResult;
+//# sourceMappingURL=install.d.ts.map

package/dist/mcp/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/mcp/install.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AACnE,eAAO,MAAM,WAAW,EAAE,SAAS,EAA8C,CAAC;AAuBlF,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAG1F;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQ1F;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,aAAa,CAwB7G"}

package/dist/mcp/install.js

@@ -0,0 +1,67 @@
+/**
+ * Write the client-side config that connects an agent to `buoy mcp serve`.
+ * Every target is a JSON file in the project; existing entries are kept.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+export const MCP_CLIENTS = ["claude", "cursor", "codex", "windsurf"];
+const SERVER_ENTRY = { command: "npx", args: ["-y", "@buoy-design/cli", "mcp", "serve"] };
+const HOOK_ENTRY = {
+    matcher: "Edit|Write|MultiEdit",
+    hooks: [{ type: "command", command: "npx -y @buoy-design/cli mcp hook", timeout: 120 }],
+};
+function readJson(path) {
+    if (!existsSync(path))
+        return {};
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        throw new Error(`${path} is not valid JSON; fix or remove it and retry`);
+    }
+}
+function writeJson(path, value) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(value, null, 2) + "\n");
+}
+/** Merge Buoy into an `mcpServers` map without touching other servers. */
+export function mergeMcpServers(existing) {
+    const servers = (existing.mcpServers && typeof existing.mcpServers === "object" ? existing.mcpServers : {});
+    return { ...existing, mcpServers: { ...servers, buoy: SERVER_ENTRY } };
+}
+/** Add the PostToolUse hook to Claude Code settings unless it is already there. */
+export function mergeClaudeHook(existing) {
+    const hooks = (existing.hooks && typeof existing.hooks === "object" ? existing.hooks : {});
+    const post = Array.isArray(hooks.PostToolUse) ? hooks.PostToolUse : [];
+    const present = post.some((entry) => JSON.stringify(entry).includes("mcp hook"));
+    return {
+        ...existing,
+        hooks: { ...hooks, PostToolUse: present ? post : [...post, HOOK_ENTRY] },
+    };
+}
+export function installClient(client, cwd, options = {}) {
+    const files = [];
+    const upsert = (relative, merge) => {
+        const path = join(cwd, relative);
+        writeJson(path, merge(readJson(path)));
+        files.push(relative);
+    };
+    switch (client) {
+        case "claude":
+            upsert(".mcp.json", mergeMcpServers);
+            if (options.hook !== false)
+                upsert(".claude/settings.json", mergeClaudeHook);
+            break;
+        case "cursor":
+            upsert(".cursor/mcp.json", mergeMcpServers);
+            break;
+        case "windsurf":
+            upsert(".windsurf/mcp.json", mergeMcpServers);
+            break;
+        case "codex":
+            upsert(".codex/mcp.json", mergeMcpServers);
+            break;
+    }
+    return { client, files };
+}
+//# sourceMappingURL=install.js.map

package/dist/mcp/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/mcp/install.ts"],"names":[],"mappings":"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"}

package/dist/mcp/project.d.ts

@@ -0,0 +1,49 @@
+import type { BuoyConfig } from "../config/schema.js";
+import type { DesignToken, DriftSignal } from "@buoy-design/core";
+export interface ProjectContext {
+    config: BuoyConfig;
+    projectRoot: string;
+}
+export declare function loadProject(cwd: string): Promise<ProjectContext>;
+export interface TokenSummary {
+    name: string;
+    category: DesignToken["category"];
+    value: string;
+    source?: string;
+    deprecated?: boolean;
+}
+export declare function formatTokenValue(token: DesignToken): string;
+export declare function summarizeToken(token: DesignToken): TokenSummary;
+/** Normalise a CSS-ish value so `#FFF`, `#ffffff` and ` 8px ` compare equal. */
+export declare function normalizeValue(value: string): string;
+export declare function findTokensByValue(tokens: DesignToken[], value: string, category?: string): TokenSummary[];
+export declare function scanTokens(project: ProjectContext): Promise<DesignToken[]>;
+export interface DriftIssue {
+    file: string;
+    line?: number;
+    type: string;
+    severity: string;
+    message: string;
+    current?: unknown;
+    suggested?: string;
+    tokenSuggestions?: string[];
+}
+export declare function toIssue(drift: DriftSignal): DriftIssue;
+export interface DriftCheck {
+    issues: DriftIssue[];
+    summary: {
+        total: number;
+        critical: number;
+        warning: number;
+        info: number;
+        fixable: number;
+    };
+    tokenCount: number;
+}
+/**
+ * With `files`: line-level literal values in those files, each matched to a
+ * token (fast, what an agent needs right after an edit). Without: the full
+ * repo analysis, which also covers components, unused tokens and contrast.
+ */
+export declare function checkDrift(project: ProjectContext, files?: string[], tokens?: DesignToken[]): Promise<DriftCheck>;
+//# sourceMappingURL=project.d.ts.map

package/dist/mcp/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/mcp/project.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAOtD,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAElE,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAQtE;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAW3D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAS/D;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAMzG;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAIhF;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,UAAU,CActD;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7F,UAAU,EAAE,MAAM,CAAC;CACpB;AAgBD;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAUvH"}

package/dist/mcp/project.js

@@ -0,0 +1,110 @@
+/**
+ * Project snapshot for the MCP server and the agent hook.
+ *
+ * Both need the same thing: this repo's tokens, and drift for some files.
+ * Everything here reuses the CLI's scan pipeline; nothing is re-detected.
+ */
+import { dirname } from "node:path";
+import { loadConfig, getConfigPath } from "../config/loader.js";
+import { buildAutoConfig } from "../config/auto-detect.js";
+import { ScanOrchestrator } from "../scan/orchestrator.js";
+import { DriftAnalysisService } from "../services/drift-analysis.js";
+import { filterScannableFiles } from "../commands/check.js";
+import { checkFiles } from "./file-check.js";
+export async function loadProject(cwd) {
+    const configPath = getConfigPath(cwd);
+    if (configPath) {
+        const loaded = await loadConfig(cwd);
+        return { config: loaded.config, projectRoot: loaded.configPath ? dirname(loaded.configPath) : cwd };
+    }
+    const auto = await buildAutoConfig(cwd);
+    return { config: auto.config, projectRoot: cwd };
+}
+export function formatTokenValue(token) {
+    const v = token.value;
+    switch (v.type) {
+        case "color": return v.hex;
+        case "spacing": return `${v.value}${v.unit}`;
+        case "typography": return `${v.fontFamily} ${v.fontSize}`;
+        case "shadow": return `${v.x}px ${v.y}px ${v.blur}px ${v.spread}px ${v.color}`;
+        case "border": return `${v.width}px ${v.style} ${v.color}`;
+        case "raw": return String(v.value);
+        default: return "(complex)";
+    }
+}
+export function summarizeToken(token) {
+    const source = "path" in token.source ? token.source.path : undefined;
+    return {
+        name: token.name,
+        category: token.category,
+        value: formatTokenValue(token),
+        ...(source ? { source } : {}),
+        ...(token.metadata?.deprecated ? { deprecated: true } : {}),
+    };
+}
+/** Normalise a CSS-ish value so `#FFF`, `#ffffff` and ` 8px ` compare equal. */
+export function normalizeValue(value) {
+    let v = value.trim().toLowerCase().replace(/\s+/g, " ");
+    const shortHex = /^#([0-9a-f])([0-9a-f])([0-9a-f])$/.exec(v);
+    if (shortHex)
+        v = `#${shortHex[1]}${shortHex[1]}${shortHex[2]}${shortHex[2]}${shortHex[3]}${shortHex[3]}`;
+    v = v.replace(/(\d)\.0+(px|rem|em|%)?$/, "$1$2").replace(/^0(px|rem|em)$/, "0");
+    return v;
+}
+export function findTokensByValue(tokens, value, category) {
+    const wanted = normalizeValue(value);
+    return tokens
+        .filter((t) => !category || t.category === category)
+        .filter((t) => normalizeValue(formatTokenValue(t)) === wanted)
+        .map(summarizeToken);
+}
+export async function scanTokens(project) {
+    const orchestrator = new ScanOrchestrator(project.config, project.projectRoot);
+    const result = await orchestrator.scan();
+    return result.tokens;
+}
+export function toIssue(drift) {
+    const location = drift.source.location || "";
+    const [file, lineStr] = location.split(":");
+    const suggestions = drift.details?.suggestions;
+    return {
+        file: file || drift.source.entityName,
+        ...(lineStr ? { line: parseInt(lineStr, 10) } : {}),
+        type: drift.type,
+        severity: drift.severity,
+        message: drift.message,
+        ...(drift.details?.actual !== undefined ? { current: drift.details.actual } : {}),
+        ...(suggestions?.[0] ? { suggested: suggestions[0] } : typeof drift.details?.expected === "string" ? { suggested: drift.details.expected } : {}),
+        ...(drift.details?.tokenSuggestions?.length ? { tokenSuggestions: drift.details.tokenSuggestions } : {}),
+    };
+}
+function summarize(issues, tokenCount) {
+    return {
+        issues,
+        summary: {
+            total: issues.length,
+            critical: issues.filter((i) => i.severity === "critical").length,
+            warning: issues.filter((i) => i.severity === "warning").length,
+            info: issues.filter((i) => i.severity === "info").length,
+            fixable: issues.filter((i) => i.suggested || i.tokenSuggestions).length,
+        },
+        tokenCount,
+    };
+}
+/**
+ * With `files`: line-level literal values in those files, each matched to a
+ * token (fast, what an agent needs right after an edit). Without: the full
+ * repo analysis, which also covers components, unused tokens and contrast.
+ */
+export async function checkDrift(project, files, tokens) {
+    if (files && files.length > 0) {
+        const scannable = filterScannableFiles(files);
+        const known = tokens ?? (await scanTokens(project));
+        const issues = scannable.length ? await checkFiles(scannable, project.projectRoot, known) : [];
+        return summarize(issues, known.length);
+    }
+    const service = new DriftAnalysisService(project.config, project.projectRoot);
+    const result = await service.analyze({ includeIgnored: false });
+    return summarize(result.drifts.map(toIssue), result.tokenCount);
+}
+//# sourceMappingURL=project.js.map

package/dist/mcp/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/mcp/project.ts"],"names":[],"mappings":"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"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `buoy mcp serve`: a stdio MCP server that gives coding agents this repo's
+ * design tokens and drift checks, so hardcoded values are caught while the
+ * agent writes instead of on the PR.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export interface BuoyMcpOptions {
+    cwd: string;
+    version: string;
+}
+export declare function createBuoyMcpServer(options: BuoyMcpOptions): McpServer;
+export declare function serveStdio(options: BuoyMcpOptions): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiBpE,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,CA4GtE;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAGvE"}

package/dist/mcp/server.js

@@ -0,0 +1,98 @@
+/**
+ * `buoy mcp serve`: a stdio MCP server that gives coding agents this repo's
+ * design tokens and drift checks, so hardcoded values are caught while the
+ * agent writes instead of on the PR.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { generateContext } from "../services/context-generator.js";
+import { ScanOrchestrator } from "../scan/orchestrator.js";
+import { checkDrift, findTokensByValue, loadProject, scanTokens, summarizeToken, } from "./project.js";
+const TOKEN_CACHE_MS = 30_000;
+export function createBuoyMcpServer(options) {
+    const server = new McpServer({ name: "buoy", version: options.version });
+    let project = null;
+    let tokenCache = null;
+    const getProject = async () => (project ??= await loadProject(options.cwd));
+    const getTokens = async () => {
+        if (tokenCache && Date.now() - tokenCache.at < TOKEN_CACHE_MS)
+            return tokenCache.tokens;
+        const tokens = await scanTokens(await getProject());
+        tokenCache = { at: Date.now(), tokens };
+        return tokens;
+    };
+    const json = (value) => ({ content: [{ type: "text", text: JSON.stringify(value, null, 2) }] });
+    server.registerTool("list_design_tokens", {
+        title: "List design tokens",
+        description: "The design tokens defined in this repository (CSS custom properties, Tailwind theme, tokens.json, SCSS variables). Call this before writing any CSS, inline style or Tailwind class so you use an existing token instead of a literal value. Filter by category (color, spacing, typography, shadow, border, sizing, motion, zIndex) or a name substring.",
+        inputSchema: {
+            category: z.string().optional().describe("Only tokens in this category"),
+            query: z.string().optional().describe("Case-insensitive substring of the token name"),
+            limit: z.number().int().positive().max(500).optional().describe("Max tokens to return (default 200)"),
+        },
+    }, async ({ category, query, limit }) => {
+        const tokens = await getTokens();
+        const q = query?.toLowerCase();
+        const matched = tokens
+            .filter((t) => !category || t.category === category)
+            .filter((t) => !q || t.name.toLowerCase().includes(q));
+        const byCategory = {};
+        for (const t of tokens)
+            byCategory[t.category] = (byCategory[t.category] ?? 0) + 1;
+        return json({
+            total: tokens.length,
+            byCategory,
+            matched: matched.length,
+            tokens: matched.slice(0, limit ?? 200).map(summarizeToken),
+            ...(tokens.length === 0 ? { note: "No tokens found. Run `buoy dock tokens` to extract a token set from the values this codebase already uses." } : {}),
+        });
+    });
+    server.registerTool("find_token_for_value", {
+        title: "Find the token for a literal value",
+        description: "Given a literal CSS value you are about to write (for example '#1a73e8', '16px', '0.5rem'), return the design tokens in this repository that have exactly that value. Use the token instead of the literal. An empty result means there is no token for it; prefer the nearest token from list_design_tokens over inventing a new value.",
+        inputSchema: {
+            value: z.string().describe("The literal value, e.g. '#ffffff' or '8px'"),
+            category: z.string().optional().describe("Restrict to a category such as color or spacing"),
+        },
+    }, async ({ value, category }) => {
+        const matches = findTokensByValue(await getTokens(), value, category);
+        return json({ value, matches, suggestion: matches[0] ? `Use ${matches[0].name} instead of ${value}` : null });
+    });
+    server.registerTool("check_design_drift", {
+        title: "Check files for design drift",
+        description: "Run Buoy's drift analysis and return hardcoded values, unknown tokens and inconsistent components, each with the token to use instead when one exists. Pass the files you just edited to check only those; omit files for the whole repository. Run this after editing styles and fix every issue that has a suggestion.",
+        inputSchema: {
+            files: z.array(z.string()).optional().describe("Repository-relative or absolute paths to limit the check to"),
+        },
+    }, async ({ files }) => {
+        const result = await checkDrift(await getProject(), files, files?.length ? await getTokens() : undefined);
+        return json({
+            ...result,
+            instructions: result.issues.length === 0
+                ? "No design drift in the checked files."
+                : "Replace each `current` value with `suggested` (or one of `tokenSuggestions`), then run check_design_drift again.",
+        });
+    });
+    server.registerTool("design_system_context", {
+        title: "Design system overview",
+        description: "A Markdown summary of this repository's design system: token categories with example names, the component library, and the anti-patterns Buoy flags. Read it once at the start of a task that touches UI.",
+        inputSchema: {
+            detail: z.enum(["minimal", "standard", "comprehensive"]).optional().describe("How much to include (default standard)"),
+        },
+    }, async ({ detail }) => {
+        const proj = await getProject();
+        const orchestrator = new ScanOrchestrator(proj.config, proj.projectRoot);
+        const scan = await orchestrator.scan();
+        const { SemanticDiffEngine } = await import("@buoy-design/core/analysis");
+        const diff = new SemanticDiffEngine().analyzeComponents(scan.components, { availableTokens: scan.tokens });
+        const result = generateContext({ tokens: scan.tokens, components: scan.components, drifts: diff.drifts, projectName: proj.projectRoot.split("/").pop() || "project" }, { detailLevel: detail ?? "standard" });
+        return { content: [{ type: "text", text: result.content }] };
+    });
+    return server;
+}
+export async function serveStdio(options) {
+    const server = createBuoyMcpServer(options);
+    await server.connect(new StdioServerTransport());
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-design/cli",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "Catch design drift before it ships",
   "type": "module",
   "license": "MIT",
@@ -35,6 +35,7 @@
     "@anthropic-ai/sdk": "^0.71.2",
     "@google/design.md": "0.1.1",
     "@inquirer/prompts": "^8.1.0",
+    "@modelcontextprotocol/sdk": "^1.30.0",
     "@octokit/rest": "^21.0.0",
     "chalk": "^5.3.0",
     "cli-table3": "^0.6.5",
@@ -47,8 +48,8 @@
     "yaml": "^2.8.2",
     "zod": "^3.24.1",
     "zod-validation-error": "^5.0.0",
-    "@buoy-design/core": "0.6.1",
-    "@buoy-design/scanners": "0.6.1"
+    "@buoy-design/core": "0.7.0",
+    "@buoy-design/scanners": "0.7.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.2",