@cascivo/mcp 0.1.1 → 0.1.4

package/README.md

@@ -1,10 +1,20 @@
 <!-- generated by scripts/readme/generate.ts — edit readme.body.md, not this file -->
 
-# @cascivo/mcp
+<div align="center">
+  <a href="https://cascivo.com"><img src="https://cascivo.com/favicon.svg" width="72" height="72" alt="cascivo logo"></a>
+  <h1>@cascivo/mcp</h1>
+  <p><strong>MCP server exposing the cascivo component registry to AI agents</strong></p>
 
-> MCP server exposing the cascivo component registry to AI agents
+[![npm](https://img.shields.io/npm/v/%40cascivo%2Fmcp?style=flat-square&color=0079bf)](https://www.npmjs.com/package/@cascivo/mcp)
+[![downloads](https://img.shields.io/npm/dm/%40cascivo%2Fmcp?style=flat-square&color=0079bf)](https://www.npmjs.com/package/@cascivo/mcp)
+[![license](https://img.shields.io/npm/l/%40cascivo%2Fmcp?style=flat-square&color=0079bf)](https://github.com/cascivo/cascivo/blob/main/LICENSE)
+![types](https://img.shields.io/badge/types-included-0079bf?style=flat-square&logo=typescript&logoColor=white)
 
-[cascivo.com](https://cascivo.com) · [Docs](https://docs.cascivo.com) · [Storybook](https://storybook.cascivo.com) · [GitHub](https://github.com/urbanisierung/cascivo)
+[npm](https://www.npmjs.com/package/@cascivo/mcp) · [cascivo.com](https://cascivo.com) · [Docs](https://docs.cascivo.com) · [Storybook](https://storybook.cascivo.com) · [GitHub](https://github.com/cascivo/cascivo)
+
+</div>
+
+---
 
 ## Usage
 
@@ -25,17 +35,19 @@ The server speaks the MCP stdio transport. By default it reads the `registry.jso
 
 ## Tools
 
-| Tool                | Input                                 | Returns                                                                              |
-| ------------------- | ------------------------------------- | ------------------------------------------------------------------------------------ |
-| `list_components`   | `{ category? }`                       | All component manifests, optionally filtered by category                             |
-| `get_component`     | `{ name }`                            | The full manifest for one component                                                  |
-| `search_components` | `{ query }`                           | Components matching name, tags, or description                                       |
-| `add_to_project`    | `{ name, outputDir? }`                | Runs `cascivo add <name>` as a child process                                         |
-| `create_theme`      | `{ primary, neutral, accent, name? }` | A custom theme as CSS (semantic token layer)                                         |
-| `scaffold_page`     | `{ description, components? }`        | A JSX page layout string                                                             |
-| `scaffold_view`     | `{ description, components? }`        | A validated starter `ViewConfig` + the bound-vocabulary `grammar` for its components |
-| `validate_view`     | `{ config }`                          | Validation errors (component, prop type/enum, refs) with exact paths                 |
-| `get_view_grammar`  | `{ components? }`                     | Bound-vocabulary grammar + generation prompt for valid `ViewConfig` JSON             |
+| Tool                 | Input                                 | Returns                                                                                                                                 |
+| -------------------- | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
+| `list_components`    | `{ category? }`                       | All component manifests, optionally filtered by category                                                                                |
+| `get_component`      | `{ name }`                            | The full manifest for one component                                                                                                     |
+| `search_components`  | `{ query }`                           | Components matching name, tags, or description                                                                                          |
+| `add_to_project`     | `{ name, outputDir? }`                | Runs `cascivo add <name>` as a child process                                                                                            |
+| `create_theme`       | `{ primary, neutral, accent, name? }` | A custom theme as CSS (semantic token layer)                                                                                            |
+| `scaffold_page`      | `{ description, components? }`        | A JSX page layout string                                                                                                                |
+| `scaffold_view`      | `{ description, components? }`        | A validated starter `ViewConfig` + the bound-vocabulary `grammar` for its components                                                    |
+| `validate_view`      | `{ config }`                          | Validation errors (component, prop type/enum, refs) with exact paths                                                                    |
+| `get_view_grammar`   | `{ components? }`                     | Bound-vocabulary grammar + generation prompt for valid `ViewConfig` JSON                                                                |
+| `get_variant_matrix` | `{ role?, theme? }`                   | Deterministic intent→token map (role + state slot) + every token resolved per theme                                                     |
+| `validate_component` | `{ tsx?, css?, name? }`               | Static structural-invariant check of generated source (banned hooks, off-scale breakpoints, missing CSS fallbacks, hallucinated tokens) |
 
 `category` is one of `inputs`, `display`, `overlay`, `navigation`, `feedback`.
 
@@ -79,4 +91,6 @@ pnpm add @cascivo/mcp
 
 ---
 
-[cascivo.com](https://cascivo.com) · [Docs](https://docs.cascivo.com) · [Storybook](https://storybook.cascivo.com) · [GitHub](https://github.com/urbanisierung/cascivo) · AI agents: use [`@cascivo/mcp`](https://github.com/urbanisierung/cascivo/tree/main/packages/mcp) and [`registry.json`](https://github.com/urbanisierung/cascivo/blob/main/registry.json) · MIT
+[cascivo.com](https://cascivo.com) · [Docs](https://docs.cascivo.com) · [Storybook](https://storybook.cascivo.com) · [GitHub](https://github.com/cascivo/cascivo) · AI agents: use [`@cascivo/mcp`](https://github.com/cascivo/cascivo/tree/main/packages/mcp) and [`registry.json`](https://github.com/cascivo/cascivo/blob/main/registry.json) · MIT
+
+<div align="center"><a href="https://cascivo.com"><img src="https://cascivo.com/favicon.svg" width="28" height="28" alt="cascivo"></a></div>

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/server.ts","../src/theme.ts","../src/scaffold.ts","../src/registry.ts","../src/grammar.ts","../src/prompt.ts","../src/index.ts"],"mappings":";;;KAwBK,OAAA,IAAW,GAAA,UAAa,IAAA,GAAO,WAAA,KAAgB,OAAA,CAAQ,QAAA;AAAA,UAE3C,aAAA;EACf,YAAA;EACA,OAAA;;EAEA,OAAA,GAAU,OAAO;AAAA;;iBAeH,YAAA,CAAa,OAAA,GAAS,aAAA,GAAqB,SAAS;;;UC7CnD,WAAA;;EAEf,OAAA;EDsBG;ECpBH,OAAA;;EAEA,MAAA;AAAA;;;;;iBAiBc,gBAAA,CAAiB,MAAA,EAAQ,WAAW,EAAE,IAAA;;;UCvBrC,eAAA;EACf,WAAA;EACA,UAAU;AAAA;;;;;iBAgCI,YAAA,CAAa,OAAwB,EAAf,eAAe;;;UC9BpC,YAAA;EACf,IAAA;EACA,IAAA;EACA,QAAA;EACA,OAAA;EACA,WAAA;AAAA;AAAA,UAGe,iBAAA;EACf,IAAA;EACA,WAAA;EACA,QAAA;EACA,MAAA;EACA,QAAA;EACA,KAAA;EACA,KAAA,EAAO,YAAY;EACnB,MAAA;EACA,aAAA;IAAiB,IAAA;IAAc,IAAA;IAAc,QAAA;EAAA;EAC7C,QAAA;IAAY,KAAA;IAAe,IAAA;IAAc,WAAA;EAAA;EACzC,YAAA;EACA,IAAA;AAAA;AAAA,UAGe,iBAAA;EACf,IAAA;EACA,IAAA;EACA,WAAA;EACA,QAAA;EACA,OAAA;EACA,KAAA;EACA,YAAA;EACA,IAAA;EACA,IAAA,EAAM,iBAAiB;AAAA;AAAA,UAGR,QAAA;EACf,OAAA;EACA,WAAA;EACA,UAAA,EAAY,iBAAiB;AAAA;AAAA,iBAwBf,YAAA,CAAa,IAAA,YAAgB,QAAQ;;iBAUrC,cAAA,CACd,QAAA,EAAU,QAAA,EACV,QAAA,WACA,IAAA,YACC,iBAAiB;;iBAQJ,YAAA,CAAa,QAAA,EAAU,QAAA,EAAU,IAAA,WAAe,iBAAiB;;iBAoGjE,gBAAA,CAAiB,QAAA,EAAU,QAAA,EAAU,KAAA,WAAgB,iBAAiB;;;UChLrE,WAAA;EACf,IAAA;EACA,QAAA;EJUU;EIRV,IAAA;EJQkC;EINlC,IAAA;AAAA;AAAA,UAGe,gBAAA;EACf,IAAA;EACA,QAAA;EACA,KAAA,EAAO,WAAW;EAClB,QAAA;EACA,KAAA;AAAA;AAAA,UAGe,WAAA;EACf,UAAA,EAAY,gBAAgB;AAAA;;;;;;iBAQd,SAAA,CAAU,IAAY;AAAA,iBA8BtB,YAAA,CAAa,QAAA,EAAU,QAAA,EAAU,MAAA,cAAoB,WAAW;;AJtC7D;AAenB;;;;iBI8EgB,aAAA,CAAc,OAAoB,EAAX,WAAW;;;UChHjC,uBAAA;;EAEf,UAAU;AAAA;;;;;;iBAsCI,qBAAA,CACd,QAAA,EAAU,QAAA,EACV,OAAA,GAAS,uBAA4B;;;cChD1B,OAAA;;iBA0BS,IAAA,IAAQ,OAAO"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/server.ts","../src/theme.ts","../src/scaffold.ts","../src/registry.ts","../src/grammar.ts","../src/prompt.ts","../src/index.ts"],"mappings":";;;KA0BK,OAAA,IAAW,GAAA,UAAa,IAAA,GAAO,WAAA,KAAgB,OAAA,CAAQ,QAAA;AAAA,UAE3C,aAAA;EACf,YAAA;EACA,OAAA;;EAEA,OAAA,GAAU,OAAO;AAAA;;iBAeH,YAAA,CAAa,OAAA,GAAS,aAAA,GAAqB,SAAS;;;UC/CnD,WAAA;;EAEf,OAAA;EDwBG;ECtBH,OAAA;;EAEA,MAAA;AAAA;;;;;iBAiBc,gBAAA,CAAiB,MAAA,EAAQ,WAAW,EAAE,IAAA;;;UCvBrC,eAAA;EACf,WAAA;EACA,UAAU;AAAA;;;;;iBAgCI,YAAA,CAAa,OAAwB,EAAf,eAAe;;;UC9BpC,YAAA;EACf,IAAA;EACA,IAAA;EACA,QAAA;EACA,OAAA;EACA,WAAA;AAAA;AAAA,UAGe,iBAAA;EACf,IAAA;EACA,WAAA;EACA,QAAA;EACA,MAAA;EACA,QAAA;EACA,KAAA;EACA,KAAA,EAAO,YAAY;EACnB,MAAA;EACA,aAAA;IAAiB,IAAA;IAAc,IAAA;IAAc,QAAA;EAAA;EAC7C,QAAA;IAAY,KAAA;IAAe,IAAA;IAAc,WAAA;EAAA;EACzC,YAAA;EACA,IAAA;AAAA;AAAA,UAGe,iBAAA;EACf,IAAA;EACA,IAAA;EACA,WAAA;EACA,QAAA;EACA,OAAA;EACA,KAAA;EACA,YAAA;EACA,IAAA;EACA,IAAA,EAAM,iBAAiB;AAAA;AAAA,UAGR,QAAA;EACf,OAAA;EACA,WAAA;EACA,UAAA,EAAY,iBAAiB;AAAA;AAAA,iBAwBf,YAAA,CAAa,IAAA,YAAgB,QAAQ;;iBAUrC,cAAA,CACd,QAAA,EAAU,QAAA,EACV,QAAA,WACA,IAAA,YACC,iBAAiB;;iBAQJ,YAAA,CAAa,QAAA,EAAU,QAAA,EAAU,IAAA,WAAe,iBAAiB;;iBAoGjE,gBAAA,CAAiB,QAAA,EAAU,QAAA,EAAU,KAAA,WAAgB,iBAAiB;;;UChLrE,WAAA;EACf,IAAA;EACA,QAAA;EJYU;EIVV,IAAA;EJUkC;EIRlC,IAAA;AAAA;AAAA,UAGe,gBAAA;EACf,IAAA;EACA,QAAA;EACA,KAAA,EAAO,WAAW;EAClB,QAAA;EACA,KAAA;AAAA;AAAA,UAGe,WAAA;EACf,UAAA,EAAY,gBAAgB;AAAA;;;;;;iBAQd,SAAA,CAAU,IAAY;AAAA,iBA8BtB,YAAA,CAAa,QAAA,EAAU,QAAA,EAAU,MAAA,cAAoB,WAAW;;AJpC7D;AAenB;;;;iBI4EgB,aAAA,CAAc,OAAoB,EAAX,WAAW;;;UChHjC,uBAAA;;EAEf,UAAU;AAAA;;;;;;iBAsCI,qBAAA,CACd,QAAA,EAAU,QAAA,EACV,OAAA,GAAS,uBAA4B;;;cChD1B,OAAA;;iBA0BS,IAAA,IAAQ,OAAO"}

package/dist/index.mjs

@@ -8,7 +8,7 @@ import { z } from "zod";
 import { existsSync, readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 //#region src/registry.ts
-const HERE$2 = dirname(fileURLToPath(import.meta.url));
+const HERE$3 = dirname(fileURLToPath(import.meta.url));
 /**
 * Resolve the registry.json location. Checks, in order: an explicit path, the
 * `CASCIVO_REGISTRY_PATH` env var, a copy bundled next to the built server
@@ -18,9 +18,9 @@ function resolveRegistryPath(explicit) {
 	const candidates = [
 		explicit,
 		process.env.CASCIVO_REGISTRY_PATH,
-		join(HERE$2, "registry.json"),
-		join(HERE$2, "..", "..", "..", "registry.json"),
-		join(HERE$2, "..", "..", "registry.json")
+		join(HERE$3, "registry.json"),
+		join(HERE$3, "..", "..", "..", "registry.json"),
+		join(HERE$3, "..", "..", "registry.json")
 	].filter((p) => typeof p === "string" && p.length > 0);
 	return candidates.find((p) => existsSync(p)) ?? candidates[candidates.length - 1] ?? "registry.json";
 }
@@ -436,7 +436,7 @@ function scaffoldView(input, registry) {
 	const layout = pickLayout(input.description);
 	const componentNames = pickComponents(input.description, registry, input.components);
 	const config = {
-		$schema: "https://raw.githubusercontent.com/urbanisierung/cascivo/main/packages/render/schema/view.v1.json",
+		$schema: "https://raw.githubusercontent.com/cascivo/cascivo/main/packages/render/schema/view.v1.json",
 		version: 1,
 		view: {
 			...layout !== "none" ? { layout } : {},
@@ -496,16 +496,174 @@ function buildGenerationPrompt(registry, options = {}) {
 }
 //#endregion
 //#region src/tokens.ts
-const HERE$1 = dirname(fileURLToPath(import.meta.url));
+const HERE$2 = dirname(fileURLToPath(import.meta.url));
 const CATALOG_BASE_URL = "https://cascivo.com";
 async function loadTokenCatalog(fetchFn) {
-	const localPaths = [join(HERE$1, "..", "..", "..", "apps", "docs", "public", "tokens.catalog.json"), join(HERE$1, "tokens.catalog.json")];
+	const localPaths = [join(HERE$2, "..", "..", "..", "apps", "docs", "public", "tokens.catalog.json"), join(HERE$2, "tokens.catalog.json")];
 	for (const p of localPaths) if (existsSync(p)) return JSON.parse(readFileSync(p, "utf8"));
 	const res = await (fetchFn ?? fetch)(`${CATALOG_BASE_URL}/tokens.catalog.json`);
 	if (!res.ok) throw new Error(`Failed to fetch token catalog: ${res.status}`);
 	return res.json();
 }
 //#endregion
+//#region src/variants.ts
+const HERE$1 = dirname(fileURLToPath(import.meta.url));
+const BASE_URL = "https://cascivo.com";
+async function loadVariantMatrix(fetchFn) {
+	const localPaths = [join(HERE$1, "..", "..", "..", "apps", "docs", "public", "tokens.variants.json"), join(HERE$1, "tokens.variants.json")];
+	for (const p of localPaths) if (existsSync(p)) return JSON.parse(readFileSync(p, "utf8"));
+	const res = await (fetchFn ?? fetch)(`${BASE_URL}/tokens.variants.json`);
+	if (!res.ok) throw new Error(`Failed to fetch variant matrix: ${res.status}`);
+	return res.json();
+}
+//#endregion
+//#region src/validate-component.ts
+const BANNED_HOOKS = [
+	"useState",
+	"useEffect",
+	"useLayoutEffect",
+	"useContext",
+	"useReducer"
+];
+const CANONICAL_WIDTHS = new Set([
+	"30rem",
+	"40rem",
+	"64rem",
+	"80rem",
+	"480px",
+	"640px",
+	"1024px",
+	"1280px"
+]);
+function lineOf(source, index) {
+	let line = 1;
+	for (let i = 0; i < index && i < source.length; i++) if (source[i] === "\n") line++;
+	return line;
+}
+/** Detect banned React hooks in TSX (usage or import). */
+function checkBannedHooks(tsx) {
+	const violations = [];
+	for (const hook of BANNED_HOOKS) {
+		const re = new RegExp(`\\b${hook}\\b`, "g");
+		let m;
+		while ((m = re.exec(tsx)) !== null) violations.push({
+			rule: "banned-hook",
+			severity: "error",
+			line: lineOf(tsx, m.index),
+			detail: hook === "useEffect" ? `${hook} is banned — use useSignalEffect for DOM side effects` : `${hook} is banned — use useSignal/useComputed from @cascivo/core`
+		});
+	}
+	return violations;
+}
+/** Detect off-scale width literals in @media / @container conditions. */
+function checkBreakpoints(css) {
+	const violations = [];
+	const widthCondRe = /(?:min-width|max-width|width|min-inline-size|max-inline-size|inline-size)\s*:\s*([\d.]+(?:rem|px|em))/g;
+	const lines = css.split("\n");
+	for (let i = 0; i < lines.length; i++) {
+		const trimmed = (lines[i] ?? "").trim();
+		if (!trimmed.startsWith("@media") && !trimmed.startsWith("@container")) continue;
+		if (/prefers|forced|pointer|hover|aspect|color|resolution|orientation|print|screen/.test(trimmed)) continue;
+		let m;
+		widthCondRe.lastIndex = 0;
+		while ((m = widthCondRe.exec(trimmed)) !== null) {
+			const value = m[1] ?? "";
+			if (!CANONICAL_WIDTHS.has(value)) violations.push({
+				rule: "off-scale-breakpoint",
+				severity: "error",
+				line: i + 1,
+				detail: `Off-scale width "${value}" — use 30rem/40rem/64rem/80rem`
+			});
+		}
+	}
+	return violations;
+}
+const isFunctionCall = (value) => /--[\w-]+\(/.test(value);
+const isIfExpression = (value) => /\bif\s*\(/.test(value);
+/** Enforce the @function / if() static-fallback contract. */
+function checkFallbacks(css) {
+	const violations = [];
+	const lines = css.split("\n");
+	let inSupports = false;
+	let supportsDepth = 0;
+	let baseSupportsDepth = 0;
+	const stack = [];
+	for (let i = 0; i < lines.length; i++) {
+		const line = (lines[i] ?? "").trim();
+		if (/^@supports\b/.test(line)) {
+			inSupports = true;
+			baseSupportsDepth = supportsDepth;
+		}
+		const opens = (line.match(/\{/g) ?? []).length;
+		const closes = (line.match(/\}/g) ?? []).length;
+		for (let j = 0; j < opens; j++) {
+			stack.push({ properties: /* @__PURE__ */ new Map() });
+			supportsDepth++;
+		}
+		for (let j = 0; j < closes; j++) {
+			if (stack.length > 0) stack.pop();
+			supportsDepth--;
+			if (supportsDepth <= baseSupportsDepth) inSupports = false;
+		}
+		const declMatch = line.match(/^([\w-]+)\s*:\s*(.+?)\s*;?\s*$/);
+		if (!declMatch) continue;
+		const property = declMatch[1];
+		const value = declMatch[2];
+		if (isFunctionCall(value) || isIfExpression(value)) {
+			let hasFallback = inSupports;
+			if (!hasFallback) {
+				for (const block of stack) if (block.properties.get(property)) {
+					hasFallback = true;
+					break;
+				}
+			}
+			if (!hasFallback) violations.push({
+				rule: "missing-css-fallback",
+				severity: "error",
+				line: i + 1,
+				detail: `"${property}" uses @function/if() with no preceding static fallback`
+			});
+		} else if (stack.length > 0) stack[stack.length - 1].properties.set(property, true);
+	}
+	return violations;
+}
+/** Flag `var(--cascivo-…)` references that are not in the closed token set. */
+function checkTokens(css, tokenNames) {
+	if (tokenNames.size === 0) return [];
+	const violations = [];
+	const re = /var\(\s*(--cascivo-[\w-]+)/g;
+	let m;
+	const seen = /* @__PURE__ */ new Set();
+	while ((m = re.exec(css)) !== null) {
+		const token = m[1];
+		if (tokenNames.has(token) || seen.has(token)) continue;
+		seen.add(token);
+		violations.push({
+			rule: "unknown-token",
+			severity: "error",
+			line: lineOf(css, m.index),
+			detail: `"${token}" is not in the cascivo token catalog (hallucinated token)`
+		});
+	}
+	return violations;
+}
+/** Run all structural invariants over a candidate component's source. */
+function validateComponentSource(input, options = {}) {
+	const violations = [];
+	if (input.tsx) violations.push(...checkBannedHooks(input.tsx));
+	if (input.css) {
+		violations.push(...checkBreakpoints(input.css));
+		violations.push(...checkFallbacks(input.css));
+		if (options.tokenNames) violations.push(...checkTokens(input.css, options.tokenNames));
+	}
+	violations.sort((a, b) => a.line - b.line);
+	return {
+		valid: violations.every((v) => v.severity !== "error"),
+		...input.name ? { name: input.name } : {},
+		violations
+	};
+}
+//#endregion
 //#region src/context.ts
 const HERE = dirname(fileURLToPath(import.meta.url));
 const CONTEXT_BASE_URL = "https://cascivo.com";
@@ -798,6 +956,57 @@ function createServer(options = {}) {
 			return error(`Token catalog unavailable: ${e instanceof Error ? e.message : String(e)}`);
 		}
 	});
+	server.registerTool("get_variant_matrix", {
+		title: "Get variant matrix",
+		description: "Get the deterministic token variant matrix: a map from design intent (a colour role + state slot, e.g. accent + hover) to the exact token name, plus every semantic/component token resolved to a concrete value in each theme. Use this to answer \"what is the warm theme's accent-hover value?\" or \"which token is the active state of primary?\" without guessing how layered theme CSS resolves.",
+		inputSchema: {
+			role: z.string().optional().describe("Filter to one colour role, e.g. \"accent\", \"primary\", \"destructive\""),
+			theme: z.string().optional().describe("Restrict the per-theme values to a single theme, e.g. \"warm\"")
+		}
+	}, async ({ role, theme }) => {
+		try {
+			const matrix = await loadVariantMatrix(fetchFn);
+			if (theme && !matrix.themes.includes(theme)) return error(`Unknown theme "${theme}". Available: ${matrix.themes.join(", ")}`);
+			const pickTheme = (byTheme) => theme ? { [theme]: byTheme[theme] ?? null } : byTheme;
+			let tokens = matrix.tokens;
+			let families = matrix.families;
+			if (role) {
+				tokens = tokens.filter((t) => t.role === role);
+				families = matrix.families[role] ? { [role]: matrix.families[role] } : {};
+				if (tokens.length === 0) return error(`No colour role "${role}". Available roles: ${Object.keys(matrix.families).join(", ")}`);
+			}
+			return json({
+				themes: theme ? [theme] : matrix.themes,
+				families,
+				tokens: tokens.map((t) => ({
+					...t,
+					byTheme: pickTheme(t.byTheme)
+				}))
+			});
+		} catch (e) {
+			return error(`Variant matrix unavailable: ${e instanceof Error ? e.message : String(e)}`);
+		}
+	});
+	server.registerTool("validate_component", {
+		title: "Validate component (shadow sandbox)",
+		description: "Run cascivo's structural invariants over candidate component source (TSX and/or CSS) before writing it to disk. Catches banned React hooks, off-scale @media/@container breakpoints, missing static fallbacks for progressive CSS (@function/if()), and hallucinated --cascivo-* tokens. Use this to self-correct generated code in a loop until `valid` is true.",
+		inputSchema: {
+			tsx: z.string().optional().describe("Component TSX source"),
+			css: z.string().optional().describe("Component CSS (module or plain) source"),
+			name: z.string().optional().describe("Component name (for messages only)")
+		}
+	}, async ({ tsx, css, name }) => {
+		let tokenNames;
+		try {
+			const catalog = await loadTokenCatalog(fetchFn);
+			tokenNames = new Set(catalog.tokens.map((t) => t.name));
+		} catch {}
+		return json(validateComponentSource({
+			...tsx ? { tsx } : {},
+			...css ? { css } : {},
+			...name ? { name } : {}
+		}, tokenNames ? { tokenNames } : {}));
+	});
 	server.registerTool("get_context", {
 		title: "Get context",
 		description: "Get intent, whenToUse/whenNotToUse, and authoring guidance for one component by name.",
@@ -815,6 +1024,7 @@ function createServer(options = {}) {
 				description: component.description,
 				intent: component.intent,
 				contextUrl: component.contextUrl,
+				...component.aiPrompt ? { aiPrompt: component.aiPrompt } : {},
 				...md ? { markdown: md } : {}
 			});
 		} catch (e) {