@bridge-ds/mcp 0.7.0 → 0.7.1

package/dist/{chunk-MFV5WHB5.js → chunk-YCKNSKPW.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 } };
@@ -12783,7 +12811,7 @@ async function pushFigmaComponentOp(ctx, a) {
 }
 
 // src/server.ts
-var VERSION = true ? "0.7.0" : "dev";
+var VERSION = true ? "0.7.1" : "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-YCKNSKPW.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-YCKNSKPW.js";
 import {
   CONFIG_FILE,
   loadConfig,

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.1",
   "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.11.0",
+    "@bridge-ds/visual": "^0.3.5",
     "@modelcontextprotocol/sdk": "1.31.0",
     "typescript": "5.9.3",
     "zod": "3.25.76"