@bridge-ds/mcp 0.7.0 → 0.7.2

package/dist/{chunk-MFV5WHB5.js → chunk-FAB4HMPJ.js}

@@ -4916,6 +4916,7 @@ function figmaDraftBrief(d, ctx) {
     ...d.reasons?.length ? ["Why this needs code:", ...d.reasons.map((r) => `- ${r}`), ""] : [],
     `Spec: ${ctx.specPath} ${suggested ? "in the suggestion" : "on the branch"} has the bound variables of every variant (token paths), the layers of every variant and what code gave Figma before.`,
     ...d.figma?.url ? [`Design: ${d.figma.url}`] : [],
+    ...suggested && d.figma?.fileKey && d.figma.nodeId ? [`Read the design straight from Figma: Figma MCP get_design_context { fileKey: "${d.figma.fileKey}", nodeId: "${d.figma.nodeId}" }${d.figma.before?.nodeId ? ` (before: node ${d.figma.before.nodeId})` : ""}, or the REST API GET https://api.figma.com/v1/files/${d.figma.fileKey}/nodes?ids=${encodeURIComponent(d.figma.nodeId)}.`] : [],
     ...d.images?.length ? ["Screenshot:", ...d.images.map((u) => `- ${u}`)] : [],
     "",
     "Steps:",
@@ -5224,6 +5225,7 @@ var SUGGESTION_STATUS_LABEL = {
   declined: "Declined",
   outdated: "Outdated"
 };
+var figmaNodeUrl = (fileKey, nodeId) => `https://www.figma.com/design/${fileKey}/?node-id=${encodeURIComponent(nodeId.replace(/:/g, "-"))}`;
 var SUGGESTION_LIMITS = {
   body: 65536,
   /** The readable part of the body (tables are cut with "and N more"). */
@@ -5530,6 +5532,19 @@ function linksSection(p) {
   const out = [];
   if (l.neededBy) out.push(`- Needed by ${l.neededBy.productName}: [#${l.neededBy.pr} ${cell3(l.neededBy.title)}](${l.neededBy.url})`);
   if (l.figma?.url) out.push(`- Design: [Open in Figma](${l.figma.url})`);
+  const key = l.figma?.fileKey;
+  const nodes = (l.figma?.nodes ?? []).filter((n) => n && typeof n.nodeId === "string");
+  for (const n of nodes) {
+    const url = n.url ?? (key ? figmaNodeUrl(key, n.nodeId) : void 0);
+    const what = `${n.state === "before" ? "Before" : n.state === "after" ? "After" : "Node"}${n.name ? ` (${cell3(n.name)})` : ""}`;
+    out.push(`- ${what}: ${url ? `[node ${n.nodeId}](${url})` : `node ${n.nodeId}`}`);
+  }
+  if (key && (nodes.length || l.figma?.nodeId)) {
+    const ids = nodes.length ? nodes.map((n) => n.nodeId) : [l.figma.nodeId];
+    out.push(
+      `- Claude Code reads this design straight from Figma: the Figma MCP server (\`get_design_context\` with file key \`${key}\` and node ${ids.map((i) => `\`${i}\``).join(", ")}) or the REST API (\`GET https://api.figma.com/v1/files/${key}/nodes?ids=${ids.map(encodeURIComponent).join(",")}\`). No image hosting is needed.`
+    );
+  }
   if (l.exploration) out.push(`- Exploration: \`${l.exploration}\``);
   if (l.supersedes) out.push(`- Replaces suggestion #${l.supersedes}`);
   for (const v of p.previews ?? []) out.push(`- ${cell3(v.label)}: ${v.url}`);
@@ -5768,6 +5783,8 @@ function suggestionShapeProblems(raw) {
   if (p.docs !== void 0 && !(Array.isArray(p.docs) && p.docs.every((d) => d && typeof d.component === "string" && typeof d.path === "string"))) out.push('"docs" must be a list of { "component", "path", "after" }.');
   const spec = p.componentSpec;
   if (spec !== void 0 && (!spec || typeof spec.component !== "string" || typeof spec.specPath !== "string" || typeof spec.brief !== "string")) out.push('"componentSpec" must be { "component", "specPath", "spec", "brief" }.');
+  const nodes = p.links?.figma?.nodes;
+  if (nodes !== void 0 && !(Array.isArray(nodes) && nodes.every((n) => n && typeof n.nodeId === "string"))) out.push('"links.figma.nodes" must be a list of { "nodeId", "url"?, "name"?, "state"? }.');
   if (p.files !== void 0) {
     if (!Array.isArray(p.files)) out.push('"files" must be a list.');
     else {
@@ -6564,7 +6581,8 @@ function componentSpecSuggestionPayload(d, plan, ctx) {
   const spec = JSON.parse(formatFigmaSpec(d, plan));
   const brief = figmaDraftBrief({ ...d, tokenEdits: plan.edits, reasons: plan.reasons }, { suggestion: true, specPath, componentsDir: ctx.componentsDir });
   const by = (ctx.suggestedBy ?? d.requestedBy)?.replace(/^@/, "");
-  const figma = d.figma?.fileKey || d.figma?.nodeId || d.figma?.url ? { ...d.figma.fileKey ? { fileKey: d.figma.fileKey } : {}, ...d.figma.nodeId ? { nodeId: d.figma.nodeId } : {}, ...d.figma.url ? { url: d.figma.url } : {} } : void 0;
+  const figma = d.figma?.fileKey || d.figma?.nodeId || d.figma?.url ? { ...d.figma.fileKey ? { fileKey: d.figma.fileKey } : {}, ...d.figma.nodeId ? { nodeId: d.figma.nodeId } : {}, ...d.figma.url ? { url: d.figma.url } : {}, ...figmaNodes(d) } : void 0;
+  const previews = (d.images ?? []).map((url, i) => ({ label: `${d.component} in Figma${(d.images?.length ?? 0) > 1 ? ` ${i + 1}` : ""}`, url }));
   return {
     schema: SUGGESTION_SCHEMA,
     kind: "component-spec",
@@ -6577,9 +6595,19 @@ function componentSpecSuggestionPayload(d, plan, ctx) {
     tier: specTier(d),
     componentSpec: { component: d.component, specPath, spec, brief },
     checks: { newErrors: 0, contrast: [], blocked: null, impact: 0 },
-    ...figma ? { links: { figma } } : {}
+    ...figma ? { links: { figma } } : {},
+    ...previews.length ? { previews } : {}
   };
 }
+function figmaNodes(d) {
+  const f = d.figma;
+  if (!f) return {};
+  const url = (id, given) => given ?? (f.fileKey ? figmaNodeUrl(f.fileKey, id) : void 0);
+  const nodes = [];
+  if (f.before?.nodeId) nodes.push({ nodeId: f.before.nodeId, state: "before", ...url(f.before.nodeId, f.before.url) ? { url: url(f.before.nodeId, f.before.url) } : {}, ...f.before.nodeName ? { name: f.before.nodeName } : {} });
+  if (f.nodeId) nodes.push({ nodeId: f.nodeId, state: "after", ...url(f.nodeId, f.url) ? { url: url(f.nodeId, f.url) } : {}, ...f.nodeName ? { name: f.nodeName } : {} });
+  return nodes.length ? { nodes } : {};
+}
 async function openComponentPushOnGitHub(gh, input) {
   const d = input.diff;
   if (!input.plan && !input.tokens) throw new Error("Route the change first: pass the token facts or the plan.");
@@ -6600,7 +6628,7 @@ async function openComponentPushOnGitHub(gh, input) {
   };
   if (plan.route === "token-change") {
     if (!input.writeTokens) throw new GitHubError(422, "This change is a token change: send it where the token files are read (the DS Bridge plugin, bridge_push_figma_component or `bridge figma push`).");
-    const figma = { ...origin.fileKey ? { fileKey: origin.fileKey } : {}, ...origin.nodeId ? { nodeId: origin.nodeId } : {}, ...origin.url ? { url: origin.url } : {} };
+    const figma = { ...origin.fileKey ? { fileKey: origin.fileKey } : {}, ...origin.nodeId ? { nodeId: origin.nodeId } : {}, ...origin.url ? { url: origin.url } : {}, ...figmaNodes(d) };
     const r = await input.writeTokens({ edits: plan.edits, title: figmaBranchTitle(d), summary: d.summary.trim() || d.title, bodyExtra: [figmaOriginSection(origin)], mode, figma });
     await gh.addLabels(r.number, [FROM_FIGMA_LABEL]);
     if (r.status === "suggested") return { status: "suggested", plan, link: null, suggestion: { route: "token-change", number: r.number, url: r.url } };
@@ -11717,7 +11745,7 @@ async function visualImpact(ctx, a, run2) {
   if (ctx.mode !== "local" || !ctx.root) throw new Error("Visual impact needs a local checkout (start Bridge with --root): it builds Storybook and the app at both refs.");
   if (!ctx.isGit) throw new Error(`${ctx.root} is not a git repository.`);
   const out = a.out ? resolve3(ctx.root, a.out) : join5(ctx.root, "visual-impact");
-  const runImpact = run2 ?? (await import("./src-ABI7LARD.js")).runImpact;
+  const runImpact = run2 ?? (await import("./src-D6YUOJC7.js")).runImpact;
   const r = await runImpact({
     root: ctx.root,
     base: a.base ?? "main",
@@ -12783,7 +12811,7 @@ async function pushFigmaComponentOp(ctx, a) {
 }
 
 // src/server.ts
-var VERSION = true ? "0.7.0" : "dev";
+var VERSION = true ? "0.7.2" : "dev";
 var ok = (data) => ({ content: [{ type: "text", text: typeof data === "string" ? data : JSON.stringify(data, null, 2) }] });
 var fail2 = (e) => ({ content: [{ type: "text", text: `Error: ${e.message ?? String(e)}` }], isError: true });
 var run = (fn) => async (a) => {

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   VERSION,
   optionsFromArgv,
   serveStdio
-} from "./chunk-MFV5WHB5.js";
+} from "./chunk-FAB4HMPJ.js";
 import "./chunk-BZ3KXXMM.js";
 
 // src/index.ts

package/dist/lib.js

@@ -28,7 +28,7 @@ import {
   serveStdio,
   studio_exports,
   suggestions_exports
-} from "./chunk-MFV5WHB5.js";
+} from "./chunk-FAB4HMPJ.js";
 import {
   CONFIG_FILE,
   loadConfig,

package/dist/{src-ABI7LARD.js → src-D6YUOJC7.js}

@@ -127,6 +127,81 @@ function impactedModules(index, input) {
   return { modules, globalHits };
 }
 
+// ../core/src/storybook.ts
+var StorybookIndexError = class extends Error {
+  constructor(code, message, status) {
+    super(message);
+    this.code = code;
+    this.status = status;
+    this.name = "StorybookIndexError";
+  }
+  code;
+  status;
+};
+var isObj = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var str = (v) => typeof v === "string" && v.trim() ? v : void 0;
+function entryFrom(key, raw, v3) {
+  if (!isObj(raw)) return null;
+  const id = str(raw.id) ?? key;
+  const title = str(raw.title) ?? str(raw.kind);
+  const name = str(raw.name) ?? str(raw.story);
+  if (!id || !title || !name) return null;
+  const params = isObj(raw.parameters) ? raw.parameters : {};
+  const type = raw.type === "docs" || raw.type === "story" ? raw.type : v3 && params.docsOnly === true ? "docs" : "story";
+  const e = {
+    id,
+    title,
+    name,
+    type,
+    importPath: str(raw.importPath) ?? str(params.fileName) ?? "",
+    tags: Array.isArray(raw.tags) ? raw.tags.filter((t) => typeof t === "string") : []
+  };
+  const subtype = str(raw.subtype);
+  if (subtype) e.subtype = subtype;
+  const exportName = str(raw.exportName);
+  if (exportName) e.exportName = exportName;
+  const componentPath = str(raw.componentPath);
+  if (componentPath) e.componentPath = componentPath;
+  return e;
+}
+function groupStorybookComponents(entries) {
+  const byTitle = /* @__PURE__ */ new Map();
+  for (const e of entries) {
+    let c = byTitle.get(e.title);
+    if (!c) {
+      const parts = e.title.split("/").map((p) => p.trim()).filter(Boolean);
+      c = { title: e.title, name: parts[parts.length - 1] ?? e.title, group: parts.slice(0, -1), stories: [], docs: [], tags: [] };
+      byTitle.set(e.title, c);
+    }
+    if (e.type === "docs") c.docs.push(e);
+    else if (e.subtype !== "test") c.stories.push(e);
+    for (const t of e.tags) if (!c.tags.includes(t)) c.tags.push(t);
+  }
+  const out = [...byTitle.values()].filter((c) => c.stories.length || c.docs.length);
+  for (const c of out) c.tags.sort();
+  return out.sort((a, b) => a.title.localeCompare(b.title));
+}
+function parseStorybookIndex(json, source) {
+  if (!isObj(json)) throw new StorybookIndexError("not-json", "The Storybook index is not a JSON object.");
+  if (typeof json.loginUrl === "string" && !("entries" in json) && !("stories" in json)) {
+    throw new StorybookIndexError("private", "This Storybook is private: it asks for a sign-in before showing its index.");
+  }
+  const map = isObj(json.entries) ? json.entries : isObj(json.stories) ? json.stories : null;
+  if (!map) throw new StorybookIndexError("empty", "This file has no Storybook entries.");
+  const v3 = !isObj(json.entries);
+  const entries = Object.entries(map).map(([k, raw]) => entryFrom(k, raw, v3)).filter((e) => e !== null);
+  if (!entries.length) throw new StorybookIndexError("empty", "This Storybook index lists no stories or docs.");
+  const version = typeof json.v === "number" ? json.v : v3 ? 3 : 4;
+  return { version, source: source ?? (v3 ? "stories.json" : "index.json"), entries, components: groupStorybookComponents(entries) };
+}
+var pairs = (o) => Object.entries(o).map(([k, v]) => `${encodeURIComponent(k)}:${encodeURIComponent(v)}`).join(";");
+function storybookIframeUrl(base, id, o = {}) {
+  let url = `${base.replace(/\/+$/, "")}/iframe.html?id=${encodeURIComponent(id)}&viewMode=${o.viewMode ?? "story"}`;
+  if (o.globals && Object.keys(o.globals).length) url += `&globals=${pairs(o.globals)}`;
+  if (o.args && Object.keys(o.args).length) url += `&args=${pairs(o.args)}`;
+  return url;
+}
+
 // ../visual/src/capture.ts
 import { mkdir, writeFile } from "node:fs/promises";
 import { dirname } from "node:path";
@@ -521,7 +596,7 @@ function routeUrl(base, route, tenant, theme) {
   return `${base.replace(/\/$/, "")}/?tenant=${encodeURIComponent(tenant)}&theme=${encodeURIComponent(theme)}&density=comfortable&lang=en#${route.pathByTenant?.[tenant] ?? route.path}`;
 }
 function storyUrl(base, id, brand, theme) {
-  return `${base.replace(/\/$/, "")}/iframe.html?id=${encodeURIComponent(id)}&viewMode=story&globals=brand:${brand};theme:${theme};density:comfortable`;
+  return storybookIframeUrl(base, id, { globals: { brand, theme, density: "comfortable" } });
 }
 var shotKey = (...parts) => parts.map((p) => p.toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-|-$/g, "")).join("__");
 
@@ -812,8 +887,8 @@ function changedTokens(before, after) {
   return [...modes.entries()].map(([path, m]) => ({ path, kind: direct.has(path) ? "direct" : "alias", modes: m })).sort((a, b) => Number(a.kind === "alias") - Number(b.kind === "alias") || a.path.localeCompare(b.path));
 }
 async function readIndexJson(dir) {
-  const raw = JSON.parse(await readFile3(join3(dir, "index.json"), "utf8"));
-  return Object.values(raw.entries).filter((e) => e.type === "story").map(({ id, title, name, importPath }) => ({ id, title, name, importPath }));
+  const index = parseStorybookIndex(JSON.parse(await readFile3(join3(dir, "index.json"), "utf8")), "index.json");
+  return index.entries.filter((e) => e.type === "story").map(({ id, title, name, importPath }) => ({ id, title, name, importPath }));
 }
 async function planImpact(o) {
   const root = resolve(o.root);

package/dist/suggestions.d.ts

@@ -154,6 +154,7 @@ export declare function getSuggestionOp(ctx: BridgeContext, a: {
             fileKey?: string | undefined;
             nodeId?: string | undefined;
             url?: string | undefined;
+            nodes?: import("@bridge-ds/core").SuggestionFigmaNode[] | undefined;
         } | undefined;
         exploration?: string | undefined;
         supersedes?: number | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bridge-ds/mcp",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "type": "module",
   "description": "Bridge MCP server: lets Claude (Claude Code, Claude Desktop or any MCP client) read, check and propose changes to a DTCG design system repo through pull requests.",
   "license": "MIT",
@@ -54,8 +54,8 @@
     "build:package": "node ../../scripts/build-packages.mjs mcp"
   },
   "dependencies": {
-    "@bridge-ds/core": "^0.10.0",
-    "@bridge-ds/visual": "^0.3.4",
+    "@bridge-ds/core": "^0.12.0",
+    "@bridge-ds/visual": "^0.3.6",
     "@modelcontextprotocol/sdk": "1.31.0",
     "typescript": "5.9.3",
     "zod": "3.25.76"