@calibrate-ds/cli 0.1.6 → 0.1.8

package/dist/mcp/tools/component-tools.js

@@ -0,0 +1,105 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { z } from "zod";
+import { getComponentContext } from "@calibrate-ds/core";
+function toSlug(name) {
+    return name.toLowerCase().trim().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function findComponent(snapshot, query) {
+    const q = query.toLowerCase();
+    const slug = toSlug(query);
+    return snapshot.components.find((c) => c.name.toLowerCase() === q || toSlug(c.name) === slug || c.id === query);
+}
+export async function loadBridge(workspaceRoot) {
+    try {
+        const raw = await fs.readFile(path.join(workspaceRoot, "ptb-bridge.json"), "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return [];
+    }
+}
+export const componentTools = {
+    name: "component",
+    register(server, getContext) {
+        server.tool("get_component", "Get the full design context for a component by name. Returns variant axes, token bindings, state contract, interaction contract, implementation hints, and the render tree.", { name: z.string().describe("Component display name, e.g. 'Button' or 'Notification Item'") }, async ({ name }) => {
+            let ctx;
+            try {
+                ctx = await getContext();
+            }
+            catch (e) {
+                return { content: [{ type: "text", text: e.message }] };
+            }
+            const comp = findComponent(ctx.snapshot, name);
+            if (!comp) {
+                const available = ctx.snapshot.components.map((c) => c.name).slice(0, 15).join(", ");
+                return { content: [{ type: "text", text: `Component '${name}' not found.\nAvailable (first 15): ${available}` }] };
+            }
+            try {
+                const context = await getComponentContext(comp.id, ctx.snapshot, ctx.config);
+                if (!context)
+                    return { content: [{ type: "text", text: `Could not build context for '${name}'.` }] };
+                return { content: [{ type: "text", text: JSON.stringify(context, null, 2) }] };
+            }
+            catch (e) {
+                return { content: [{ type: "text", text: `Error building context: ${e.message}` }] };
+            }
+        });
+        server.tool("list_components", "List all components in the design system. Returns name, kind, category, variant axis count, and Figma node ID for each.", async () => {
+            let ctx;
+            try {
+                ctx = await getContext();
+            }
+            catch (e) {
+                return { content: [{ type: "text", text: e.message }] };
+            }
+            const items = ctx.snapshot.components.map((c) => ({
+                name: c.name,
+                slug: toSlug(c.name),
+                kind: c.kind?.value ?? "unknown",
+                category: c.categoryPath ?? "unclassified",
+                variantAxes: c.variantAxes?.map((a) => a.name) ?? [],
+                nodeId: c.designToolNodeId ?? null,
+            }));
+            return { content: [{ type: "text", text: JSON.stringify(items, null, 2) }] };
+        });
+        server.tool("find_component_by_figma_node", "Find a design system component by its Figma node ID. Returns the component definition plus Symbol Bridge export/file info if registered.", { nodeId: z.string().describe("Figma node ID, e.g. '123:456'") }, async ({ nodeId }) => {
+            let ctx;
+            try {
+                ctx = await getContext();
+            }
+            catch (e) {
+                return { content: [{ type: "text", text: e.message }] };
+            }
+            const comp = ctx.snapshot.components.find((c) => c.designToolNodeId === nodeId);
+            if (!comp) {
+                return { content: [{ type: "text", text: `No component found for Figma node '${nodeId}'.` }] };
+            }
+            const bridge = await loadBridge(ctx.workspaceRoot);
+            const entry = bridge.find((b) => b.nodeId === nodeId);
+            const result = {
+                componentName: comp.name,
+                nodeId,
+                kind: comp.kind?.value ?? "unknown",
+                category: comp.categoryPath ?? "unclassified",
+            };
+            if (entry) {
+                result.exportName = entry.componentName;
+                result.filePath = entry.filePath;
+            }
+            try {
+                const context = await getComponentContext(comp.id, ctx.snapshot, ctx.config);
+                if (context?.variantAxes?.length) {
+                    result.variantAxes = context.variantAxes.map((a) => ({
+                        name: a.name,
+                        options: a.options,
+                        default: context.component.defaultVariantSelection?.[a.name] ?? a.options[0],
+                    }));
+                }
+            }
+            catch { /* non-fatal */ }
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        });
+    },
+};
+//# sourceMappingURL=component-tools.js.map

package/dist/mcp/tools/component-tools.js.map

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

package/dist/mcp/tools/governance-tools.d.ts

@@ -0,0 +1,3 @@
+import type { MCPToolGroup } from "../registry.js";
+export declare const governanceTools: MCPToolGroup;
+//# sourceMappingURL=governance-tools.d.ts.map

package/dist/mcp/tools/governance-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance-tools.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/governance-tools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,gBAAgB,CAAC;AAgB/D,eAAO,MAAM,eAAe,EAAE,YAmL7B,CAAC"}

package/dist/mcp/tools/governance-tools.js

@@ -0,0 +1,180 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { z } from "zod";
+function toSlug(name) {
+    return name.toLowerCase().trim().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+async function loadLock(workspaceRoot) {
+    try {
+        const raw = await fs.readFile(path.join(workspaceRoot, "ptb.lock"), "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export const governanceTools = {
+    name: "governance",
+    register(server, getContext) {
+        server.tool("is_stale", "Check which components are stale (design changed since last stamp), ready (stamped and current), or unstamped (never implemented). Use this to understand the current health of the design system.", async () => {
+            let ctx;
+            try {
+                ctx = await getContext();
+            }
+            catch (e) {
+                return { content: [{ type: "text", text: e.message }] };
+            }
+            const lock = await loadLock(ctx.workspaceRoot);
+            if (!lock) {
+                return { content: [{ type: "text", text: "No ptb.lock found. Run 'ptb export context' first." }] };
+            }
+            const stale = [];
+            const ready = [];
+            const unstamped = [];
+            for (const [slug, entry] of Object.entries(lock.components)) {
+                if (!entry.stampedHash) {
+                    unstamped.push({ name: entry.displayName, slug, assignedTo: entry.assignedTo ?? null });
+                }
+                else if (entry.stampedHash !== entry.designHash) {
+                    stale.push({
+                        name: entry.displayName,
+                        slug,
+                        stampedAt: entry.stampedAt ?? null,
+                        stampedBy: entry.stampedBy ?? null,
+                        assignedTo: entry.assignedTo ?? null,
+                    });
+                }
+                else {
+                    ready.push({
+                        name: entry.displayName,
+                        slug,
+                        stampedAt: entry.stampedAt ?? null,
+                        stampedBy: entry.stampedBy ?? null,
+                    });
+                }
+            }
+            const summary = {
+                total: ready.length + stale.length + unstamped.length,
+                ready: ready.length,
+                stale: stale.length,
+                unstamped: unstamped.length,
+                components: { ready, stale, unstamped },
+            };
+            return { content: [{ type: "text", text: JSON.stringify(summary, null, 2) }] };
+        });
+        server.tool("what_uses", "Find all components that depend on a given component. Useful for understanding blast radius before changing a component.", { name: z.string().describe("Component name to search for usages, e.g. 'Toggle' or 'Avatar'") }, async ({ name }) => {
+            let ctx;
+            try {
+                ctx = await getContext();
+            }
+            catch (e) {
+                return { content: [{ type: "text", text: e.message }] };
+            }
+            const q = name.toLowerCase();
+            const slug = toSlug(name);
+            const target = ctx.snapshot.components.find((c) => c.name.toLowerCase() === q || toSlug(c.name) === slug || c.id === name);
+            if (!target) {
+                return { content: [{ type: "text", text: `Component '${name}' not found in snapshot.` }] };
+            }
+            // Check both the id and designToolNodeId for reverse-dependency lookup
+            const targetIds = new Set([target.id, target.designToolNodeId].filter(Boolean));
+            const users = ctx.snapshot.components
+                .filter((c) => {
+                if (c.id === target.id)
+                    return false;
+                const deps = c.dependencies ?? [];
+                if (deps.some((id) => targetIds.has(id)))
+                    return true;
+                const instances = c.dependencyInstances ?? [];
+                return instances.some((di) => targetIds.has(di.componentId));
+            })
+                .map((c) => ({
+                name: c.name,
+                kind: c.kind?.value ?? "unknown",
+                category: c.categoryPath ?? "unclassified",
+            }));
+            // Also check model-level dependency edges
+            const modelEdges = (ctx.snapshot.dependencies ?? [])
+                .filter((e) => targetIds.has(e.targetId))
+                .map((e) => {
+                const src = ctx.snapshot.components.find((c) => c.id === e.sourceId);
+                return src ? { name: src.name, kind: src.kind?.value ?? "unknown", via: e.type } : null;
+            })
+                .filter(Boolean);
+            const merged = [...users];
+            for (const edge of modelEdges) {
+                if (!merged.find((u) => u.name === edge.name))
+                    merged.push(edge);
+            }
+            if (merged.length === 0) {
+                return { content: [{ type: "text", text: `No other components depend on '${target.name}'.` }] };
+            }
+            return { content: [{ type: "text", text: JSON.stringify({ target: target.name, usedBy: merged }, null, 2) }] };
+        });
+        server.tool("coverage_summary", "Get a high-level coverage report for the whole design system: how many components are ready, stale, or unimplemented. Grouped by category.", async () => {
+            let ctx;
+            try {
+                ctx = await getContext();
+            }
+            catch (e) {
+                return { content: [{ type: "text", text: e.message }] };
+            }
+            const lock = await loadLock(ctx.workspaceRoot);
+            if (!lock) {
+                return { content: [{ type: "text", text: "No ptb.lock found. Run 'ptb export context' first." }] };
+            }
+            const byCategory = {};
+            const getOrCreate = (cat) => {
+                if (!byCategory[cat])
+                    byCategory[cat] = { ready: 0, stale: 0, unstamped: 0 };
+                return byCategory[cat];
+            };
+            for (const [slug, entry] of Object.entries(lock.components)) {
+                const comp = ctx.snapshot.components.find((c) => toSlug(c.name) === slug);
+                const cat = comp?.categoryPath ?? "unclassified";
+                const bucket = getOrCreate(cat);
+                if (!entry.stampedHash)
+                    bucket.unstamped++;
+                else if (entry.stampedHash !== entry.designHash)
+                    bucket.stale++;
+                else
+                    bucket.ready++;
+            }
+            const total = Object.values(lock.components);
+            const summary = {
+                total: total.length,
+                ready: total.filter((e) => e.stampedHash && e.stampedHash === e.designHash).length,
+                stale: total.filter((e) => e.stampedHash && e.stampedHash !== e.designHash).length,
+                unstamped: total.filter((e) => !e.stampedHash).length,
+                byCategory,
+            };
+            return { content: [{ type: "text", text: JSON.stringify(summary, null, 2) }] };
+        });
+        server.tool("token_impact", "Find all components that use a specific design token. Useful for understanding which components will be affected when a token value changes.", { tokenName: z.string().describe("Token name or CSS variable, e.g. 'colors.brand.900' or '--ptb-colors-brand-900'") }, async ({ tokenName }) => {
+            let ctx;
+            try {
+                ctx = await getContext();
+            }
+            catch (e) {
+                return { content: [{ type: "text", text: e.message }] };
+            }
+            const query = tokenName.replace(/^--/, "").toLowerCase();
+            const affected = [];
+            for (const comp of ctx.snapshot.components) {
+                const bindings = comp.tokenBindings ?? [];
+                const matches = bindings.filter((b) => {
+                    const name = (b.tokenName ?? b.cssVar ?? b.variableName ?? "").toLowerCase();
+                    return name.includes(query);
+                });
+                if (matches.length > 0) {
+                    affected.push({ component: comp.name, category: comp.categoryPath, bindings: matches });
+                }
+            }
+            if (affected.length === 0) {
+                return { content: [{ type: "text", text: `No components found using token '${tokenName}'.` }] };
+            }
+            return { content: [{ type: "text", text: JSON.stringify({ tokenName, affectedComponents: affected }, null, 2) }] };
+        });
+    },
+};
+//# sourceMappingURL=governance-tools.js.map

package/dist/mcp/tools/governance-tools.js.map

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

package/dist/mcp/tools/token-tools.d.ts

@@ -0,0 +1,3 @@
+import type { MCPToolGroup } from "../registry.js";
+export declare const tokenTools: MCPToolGroup;
+//# sourceMappingURL=token-tools.d.ts.map

package/dist/mcp/tools/token-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-tools.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/token-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,gBAAgB,CAAC;AAG/D,eAAO,MAAM,UAAU,EAAE,YAgExB,CAAC"}

package/dist/mcp/tools/token-tools.js

@@ -0,0 +1,60 @@
+import { z } from "zod";
+export const tokenTools = {
+    name: "token",
+    register(server, getContext) {
+        server.tool("list_themes", "List all token collections (themes) in the design system. Returns each collection's name and a sample of its tokens.", async () => {
+            let ctx;
+            try {
+                ctx = await getContext();
+            }
+            catch (e) {
+                return { content: [{ type: "text", text: e.message }] };
+            }
+            const collections = ctx.snapshot.tokens ?? [];
+            if (collections.length === 0) {
+                return { content: [{ type: "text", text: "No token collections found in snapshot." }] };
+            }
+            const summary = collections.map((col) => ({
+                name: col.name,
+                tokenCount: col.tokens?.length ?? 0,
+                sampleTokens: (col.tokens ?? []).slice(0, 5).map((t) => ({
+                    name: t.name,
+                    cssVar: t.cssVar ?? t.codeNames?.css ?? null,
+                    value: t.resolvedValue ?? t.value ?? null,
+                })),
+            }));
+            return { content: [{ type: "text", text: JSON.stringify(summary, null, 2) }] };
+        });
+        server.tool("get_token", "Look up a design token by name or path. Returns resolved value, CSS variable, and which collection it belongs to.", { path: z.string().describe("Token name or partial path, e.g. 'brand.900', 'spacing.4', or 'border-radius'") }, async ({ path: tokenPath }) => {
+            let ctx;
+            try {
+                ctx = await getContext();
+            }
+            catch (e) {
+                return { content: [{ type: "text", text: e.message }] };
+            }
+            const query = tokenPath.toLowerCase();
+            const matches = [];
+            for (const col of (ctx.snapshot.tokens ?? [])) {
+                for (const token of col.tokens ?? []) {
+                    const name = (token.name ?? "").toLowerCase();
+                    const cssVar = (token.cssVar ?? token.codeNames?.css ?? "").toLowerCase();
+                    if (name.includes(query) || cssVar.includes(query)) {
+                        matches.push({
+                            collection: col.name,
+                            name: token.name,
+                            cssVar: token.cssVar ?? token.codeNames?.css ?? null,
+                            resolvedValue: token.resolvedValue ?? token.value ?? null,
+                            valueType: token.valueType ?? null,
+                        });
+                    }
+                }
+            }
+            if (matches.length === 0) {
+                return { content: [{ type: "text", text: `No tokens found matching '${tokenPath}'.` }] };
+            }
+            return { content: [{ type: "text", text: JSON.stringify(matches, null, 2) }] };
+        });
+    },
+};
+//# sourceMappingURL=token-tools.js.map

package/dist/mcp/tools/token-tools.js.map

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

package/dist/mcp/tools/verify-tool.d.ts

@@ -0,0 +1,3 @@
+import type { MCPToolGroup } from "../registry.js";
+export declare const verifyTool: MCPToolGroup;
+//# sourceMappingURL=verify-tool.d.ts.map

package/dist/mcp/tools/verify-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-tool.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/verify-tool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,gBAAgB,CAAC;AAO/D,eAAO,MAAM,UAAU,EAAE,YA8ExB,CAAC"}

package/dist/mcp/tools/verify-tool.js

@@ -0,0 +1,82 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { z } from "zod";
+function toSlug(name) {
+    return name.toLowerCase().trim().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+export const verifyTool = {
+    name: "verify",
+    register(server, getContext) {
+        server.tool("get_verify_report", "Retrieve the latest visual verification report for a component. Shows pixel match score, AI-detected visual differences, and paths to screenshots. Run 'ptb verify component <name>' first to generate or refresh the report.", { name: z.string().describe("Component name, e.g. 'Button'") }, async ({ name }) => {
+            let ctx;
+            try {
+                ctx = await getContext();
+            }
+            catch (e) {
+                return { content: [{ type: "text", text: e.message }] };
+            }
+            const slug = toSlug(name);
+            const reportPath = path.join(ctx.metadataDir, "verify", slug, "report.json");
+            try {
+                const raw = await fs.readFile(reportPath, "utf-8");
+                const report = JSON.parse(raw);
+                const summary = {
+                    component: report.componentName,
+                    checkedAt: report.checkedAt,
+                    pixelMatchScore: report.pixelMatch?.score ?? null,
+                    assessment: report.aiFeedback?.overallAssessment ?? null,
+                    summary: report.aiFeedback?.summary ?? null,
+                    differences: report.aiFeedback?.differences ?? [],
+                    screenshots: report.screenshots,
+                };
+                return { content: [{ type: "text", text: JSON.stringify(summary, null, 2) }] };
+            }
+            catch {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `No verify report found for '${name}'.\nRun: ptb verify component ${name}`,
+                        }],
+                };
+            }
+        });
+        server.tool("list_verify_reports", "List all components that have been visually verified, with their latest pixel match scores and assessment.", async () => {
+            let ctx;
+            try {
+                ctx = await getContext();
+            }
+            catch (e) {
+                return { content: [{ type: "text", text: e.message }] };
+            }
+            const verifyDir = path.join(ctx.metadataDir, "verify");
+            let slugDirs;
+            try {
+                slugDirs = await fs.readdir(verifyDir);
+            }
+            catch {
+                return { content: [{ type: "text", text: "No verify reports found. Run 'ptb verify component <name>' to generate one." }] };
+            }
+            const reports = [];
+            for (const slug of slugDirs) {
+                const reportPath = path.join(verifyDir, slug, "report.json");
+                try {
+                    const raw = await fs.readFile(reportPath, "utf-8");
+                    const report = JSON.parse(raw);
+                    reports.push({
+                        component: report.componentName,
+                        slug,
+                        checkedAt: report.checkedAt,
+                        score: report.pixelMatch?.score ?? null,
+                        assessment: report.aiFeedback?.overallAssessment ?? null,
+                    });
+                }
+                catch { /* skip malformed */ }
+            }
+            if (reports.length === 0) {
+                return { content: [{ type: "text", text: "No valid verify reports found." }] };
+            }
+            return { content: [{ type: "text", text: JSON.stringify(reports, null, 2) }] };
+        });
+    },
+};
+//# sourceMappingURL=verify-tool.js.map

package/dist/mcp/tools/verify-tool.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@calibrate-ds/cli",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "license": "Apache-2.0",
   "type": "module",
   "main": "dist/index.js",
@@ -20,13 +20,14 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.39.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "commander": "^14.0.3",
     "openai": "^6.34.0",
     "zod": "^4.3.6",
-    "@calibrate-ds/figma-client": "^0.1.6",
-    "@calibrate-ds/shared-types": "^0.1.6",
-    "@calibrate-ds/core": "^0.1.6",
-    "@calibrate-ds/generator-react": "^0.1.6"
+    "@calibrate-ds/core": "^0.1.8",
+    "@calibrate-ds/figma-client": "^0.1.8",
+    "@calibrate-ds/shared-types": "^0.1.8",
+    "@calibrate-ds/generator-react": "^0.1.8"
   },
   "devDependencies": {
     "@types/node": "^22.13.5",