@bridge-ds/mcp 0.4.0 → 0.4.1

package/dist/branches.d.ts

@@ -154,11 +154,8 @@ export declare function listProducts(ctx: BridgeContext): Promise<{
  * Throws with the list when the name is unknown.
  */
 export declare function resolveProduct(ctx: BridgeContext, name?: string | undefined): Promise<ProductConfig>;
-/** Labels and a body line for a branch that starts work for a product (the default product adds nothing). */
-export declare function productMarks(products: ProductConfig[], p: ProductConfig): {
-    labels: string[];
-    line: string;
-};
+/** Labels and a body line for a branch that starts work for a product: the core rule Studio writes too. */
+export { productMarks } from '@bridge-ds/core';
 /**
  * Try it in a product and share it with a product team: the preview of each product Vercel reported for this branch
  * (opened with the Bridge toolbar on it), and the install command product teams use in a staging branch, with a

package/dist/{chunk-NYFH322K.js → chunk-MXMMPO7F.js}

@@ -52,7 +52,7 @@ import {
   previewUrl,
   previewsSettled,
   productForPlace,
-  productLabel,
+  productMarks,
   productOfBranch,
   productsOf,
   protectedBranchesOf,
@@ -72,7 +72,7 @@ import {
   unreadableTeams,
   validateLayered,
   whoCanShipSentence
-} from "./chunk-7DBLDJIL.js";
+} from "./chunk-QTO4EP6V.js";
 
 // src/lib.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -4084,7 +4084,7 @@ Exploration: never merged as is. Promote it to review or close it.`,
   const ctx = { owner: gh.owner, repo: gh.name, packages: s.packages, apps: s.apps, ...s.requests?.length ? { requests: s.requests } : {} };
   const title = full.jira ? `${full.jira.trim().toUpperCase()} ${explorationPrTitle(full)}` : explorationPrTitle(full);
   const pr = await x.createPullRequest({ title, head: branch, base: s.base, body: explorationPrBody(full, ctx), draft: true });
-  await x.addLabels(pr.number, [EXPLORATION_LABEL]);
+  await x.addLabels(pr.number, [EXPLORATION_LABEL, ...s.labels ?? []]);
   await x.updatePullRequest(pr.number, { body: explorationPrBody(full, { ...ctx, pr: pr.number }) }).catch(() => void 0);
   return {
     branch,
@@ -4606,7 +4606,7 @@ function branchWithJiraKey(branch, key) {
 // ../core/src/docs-proposal.ts
 var DOCS_EDITOR_ORIGIN = {
   where: "in the Bridge docs editor",
-  footer: 'Proposed with the Bridge docs editor by a person (no AI involved in this text unless the docs say "draftedBy").',
+  footer: "Written by a person in the Bridge docs editor. No AI involved in this text.",
   label: "source: bridge-web"
 };
 var DOCS_MCP_ORIGIN = {
@@ -4642,13 +4642,55 @@ function cleanDocs(d) {
 }
 var docsFileText = (d, original) => patchDocsJson(original, cleanDocs(d));
 var slugDate = (d) => d.toISOString().slice(0, 10).replace(/-/g, "");
+var docsSlug = (nameOrSlug) => nameOrSlug.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase().replace(/[^a-z0-9-]+/g, "-").slice(0, 40);
+function defaultDocsFooter(edits, origin) {
+  if (origin.label !== DOCS_EDITOR_ORIGIN.label) return origin.footer;
+  const claude = edits.some((e) => {
+    try {
+      return JSON.parse(e.after).draftedBy === "claude";
+    } catch {
+      return false;
+    }
+  });
+  return claude ? `Drafted by Claude AI (the docs say "draftedBy": "claude"), sent by a person ${origin.where}.` : origin.footer;
+}
+function withAuthorLine(body, line) {
+  const i = body.lastIndexOf("\n---\n");
+  return i < 0 ? `${body.trimEnd()}
+
+---
+${line}` : `${body.slice(0, i + 5)}${line}`;
+}
+var escapeRe = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+function isDocsProposalBranch(branch, component) {
+  const slugs = /* @__PURE__ */ new Set([docsSlug(component.slug ?? component.name), docsSlug(component.name), docsSlug(component.name.toLowerCase())]);
+  return [...slugs].some((s) => new RegExp(`^docs/(?:[A-Z][A-Z0-9]*-\\d+-)?${escapeRe(s)}-\\d{8}-[a-z0-9]+$`).test(branch));
+}
+function findOpenDocsProposal(pulls, component, base) {
+  const hit = pulls.filter((p) => p.state === "open" && isDocsProposalBranch(p.headRef, component) && (!base || !p.baseRef || p.baseRef === base)).sort((a, b) => b.updatedAt.localeCompare(a.updatedAt))[0];
+  return hit ? { number: hit.number, url: hit.url, branch: hit.headRef, author: hit.author, title: hit.title, updatedAt: hit.updatedAt } : null;
+}
+async function findOpenDocsProposalOnGitHub(gh, component, base) {
+  return findOpenDocsProposal(await gh.listPullRequests("open"), component, base);
+}
+async function continueDocsProposalOnGitHub(gh, open, edit, opts = {}) {
+  const message = opts.message ?? `docs(${docsSlug(edit.component)}): edit usage guidance in the Bridge docs editor`;
+  const cur = await gh.getFile(edit.path, open.branch);
+  if (cur?.text === edit.after) return "";
+  const sha = await gh.putFile({ path: edit.path, content: edit.after, branch: open.branch, message, sha: cur?.sha });
+  if (opts.authorLine) {
+    const line = opts.authorLine;
+    await gh.getPullRequest(open.number).then((pr) => gh.updatePullRequest(open.number, { body: withAuthorLine(pr.body, line) })).catch(() => void 0);
+  }
+  return sha;
+}
 function docsProposal(edits, opts) {
   const origin = opts.origin ?? DOCS_EDITOR_ORIGIN;
   if (!edits.length) throw new Error("No docs edits in the draft.");
   const names2 = edits.map((e) => e.component);
   const list = names2.length === 1 ? names2[0] : `${names2.slice(0, -1).join(", ")} and ${names2[names2.length - 1]}`;
   const title = opts.title?.trim() || `docs(${names2.length === 1 ? edits[0].slug : "components"}): usage guidance for ${list}`;
-  const slug2 = `${names2.length === 1 ? edits[0].slug : `${edits[0].slug}-and-${names2.length - 1}-more`}`.toLowerCase().replace(/[^a-z0-9-]+/g, "-").slice(0, 40);
+  const slug2 = docsSlug(names2.length === 1 ? edits[0].slug : `${edits[0].slug}-and-${names2.length - 1}-more`);
   const branch = `docs/${slug2}-${slugDate(opts.date)}-${opts.date.getTime().toString(36).slice(-4)}`;
   const csPath = `${opts.changesetDir ?? ".changeset"}/docs-${slug2}-${opts.date.getTime().toString(36)}.md`;
   const pkg = opts.packageName ?? "@bridge-ds/react";
@@ -4685,12 +4727,20 @@ Usage guidance for ${list}.
 ${opts.notes.trim()}
 ` : "",
     "---",
-    origin.footer
+    opts.authorLine?.trim() || defaultDocsFooter(edits, origin)
   ].filter((x, i, a) => !(x === "" && a[i - 1] === "")).join("\n");
   return { branch, title, body, files, risk, bump: "patch", labels: ["docs", origin.label, `tier-${risk.tier}`] };
 }
 async function proposeDocsOnGitHub(gh, edits, opts) {
-  const p = docsProposal(edits, { title: opts.title, notes: opts.notes, date: opts.date ?? /* @__PURE__ */ new Date(), origin: opts.origin });
+  if (opts.continueOpen !== false && edits.length === 1) {
+    const e = edits[0];
+    const open = await findOpenDocsProposalOnGitHub(gh, { name: e.component, slug: e.slug }, opts.base).catch(() => null);
+    if (open) {
+      const sha = await continueDocsProposalOnGitHub(gh, open, e, { authorLine: opts.authorLine?.trim() || defaultDocsFooter(edits, opts.origin ?? DOCS_EDITOR_ORIGIN) });
+      return { number: open.number, url: open.url, branch: open.branch, title: open.title, continued: true, unchanged: !sha };
+    }
+  }
+  const p = docsProposal(edits, { title: opts.title, notes: opts.notes, date: opts.date ?? /* @__PURE__ */ new Date(), origin: opts.origin, authorLine: opts.authorLine });
   const prTitle = titleWithJiraKey(p.title, opts.jira ?? null);
   const branch = branchWithJiraKey(p.branch, opts.jira ?? null);
   const mainSha = await gh.getBranchSha(opts.base);
@@ -4702,7 +4752,7 @@ ${opts.commitNote ?? "Proposed with the Bridge docs editor."}`, tree, [mainSha])
   await gh.createBranch(branch, commit);
   const pr = await gh.createPullRequest({ title: prTitle, head: branch, base: opts.base, body: p.body, draft: false });
   await gh.addLabels(pr.number, [...p.labels, ...opts.extraLabels ?? []]).catch(() => false);
-  return { number: pr.number, url: pr.url, branch, title: prTitle };
+  return { number: pr.number, url: pr.url, branch, title: prTitle, continued: false, unchanged: false };
 }
 async function commitFileOnGitHub(gh, input) {
   const cur = await gh.getFile(input.path, input.branch);
@@ -7803,10 +7853,6 @@ async function resolveProduct(ctx, name) {
   }
   return (await productHere(ctx, config)).product;
 }
-function productMarks(products, p) {
-  if (p.key === defaultProduct(products).key) return { labels: [], line: "" };
-  return { labels: [productLabel(p.key)], line: `**Product:** ${p.name}` };
-}
 async function tryBranch(ctx, a) {
   const n = branchNumber(a.pr);
   const gh = await reader(ctx);
@@ -8087,8 +8133,7 @@ async function startExploration(ctx, a) {
   if (a.dryRun) return { status: "dry-run", ...preview };
   const work = `Work on it: \`git fetch origin && git switch ${branch}\`. Token edits: bridge_propose_token_change with "branch": "${branch}". Requests: bridge_create_request with "exploration": "${branch}", then bridge_get_request with "branch": "${branch}". It is never merged as is: promote it (\`bridge explore promote ${slug2}\`) or close it.`;
   if (gh && ctx.canWriteRemote) {
-    const r = await startExplorationOnGitHub(gh, e, s);
-    if (marks.labels.length) await gh.addLabels(r.pr, marks.labels);
+    const r = await startExplorationOnGitHub(gh, e, { ...s, labels: marks.labels });
     return {
       status: "started",
       ...preview,
@@ -8819,7 +8864,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) : join4(ctx.root, "visual-impact");
-  const runImpact = run2 ?? (await import("./src-2YRRAUUM.js")).runImpact;
+  const runImpact = run2 ?? (await import("./src-DHJOM5PQ.js")).runImpact;
   const r = await runImpact({
     root: ctx.root,
     base: a.base ?? "main",
@@ -9486,8 +9531,10 @@ async function saveDocs(ctx, a) {
     return docsFileText(cleanDocs(merged), current);
   };
   const gh = await ctx.github();
-  if (a.pr !== void 0) {
-    const n = branchNumber(a.pr);
+  const open = a.pr === void 0 && gh ? await findOpenDocsProposalOnGitHub(gh, { name, slug: docsSlug(name) }, ctx.ref ?? baseBranchOf(config)).catch(() => null) : null;
+  const target = a.pr ?? open?.number;
+  if (target !== void 0) {
+    const n = branchNumber(target);
     if (!gh) throw new Error('No GitHub repo known: set "repo" in bridge.config.json or add an origin remote.');
     const pr = await gh.getPullRequest(n);
     if (pr.state !== "open") throw new Error(`#${n} is ${pr.state}: save the docs on a new branch instead (leave pr out).`);
@@ -9495,14 +9542,23 @@ async function saveDocs(ctx, a) {
     if (current === null) throw new Error(`${path} is not on #${n}. Save the docs on a new branch instead (leave pr out), or check the component name.`);
     const text2 = next(current);
     if (a.dryRun) return { status: "dry-run", pr: n, path, content: text2 };
+    if (!ctx.canWriteRemote && open) return { status: "preview", pr: n, path, content: text2, said: `Nothing sent: the ${name} docs have an open proposal (#${n}) and adding to it needs a GitHub token with ${RIGHTS.docs}. Set GITHUB_TOKEN.` };
     if (!ctx.canWriteRemote) throw new Error(`Saving docs on #${n} needs a GitHub token with ${RIGHTS.docs}. Set GITHUB_TOKEN where the Bridge MCP server runs, or save it in the Library edit mode.`);
     const sha = await commitFileOnGitHub(gh.withBranchPrefix(void 0), { path, branch: pr.headRef, message: `docs(${name.toLowerCase()}): edit usage guidance with Claude (Bridge MCP)`, next });
-    return { status: sha ? "committed" : "unchanged", pr: n, path, commit: sha || null, said: sha ? `Saved the ${name} docs on #${n}. Reviewers see them now.` : "The docs on that branch already say this." };
+    const joined = open ? ` It continues the open ${name} docs proposal by @${open.author} (one open proposal per component).` : "";
+    return {
+      status: sha ? "committed" : "unchanged",
+      pr: n,
+      path,
+      commit: sha || null,
+      ...open ? { continued: true } : {},
+      said: (sha ? `Saved the ${name} docs on #${n}. Reviewers see them now.` : "The docs on that branch already say this.") + joined
+    };
   }
   const original = await ctx.source.read(path);
   const text = next(original);
   if (original === text) return { status: "unchanged", path, said: `The ${name} docs on main already say this.` };
-  const edit = { path, component: name, slug: name.toLowerCase(), before: original, after: text };
+  const edit = { path, component: name, slug: docsSlug(name), before: original, after: text };
   const marks = productMarks(productsOf(config), product);
   const notes = [a.notes?.trim(), marks.line].filter(Boolean).join("\n\n");
   if (a.dryRun || !gh || !ctx.canWriteRemote) {
@@ -9577,7 +9633,7 @@ async function figmaCoverage(ctx, a = {}) {
 }
 
 // src/server.ts
-var VERSION = true ? "0.4.0" : "dev";
+var VERSION = true ? "0.4.1" : "dev";
 var ok = (data) => ({ content: [{ type: "text", text: typeof data === "string" ? data : JSON.stringify(data, null, 2) }] });
 var fail = (e) => ({ content: [{ type: "text", text: `Error: ${e.message ?? String(e)}` }], isError: true });
 var run = (fn) => async (a) => {

package/dist/{chunk-7DBLDJIL.js → chunk-QTO4EP6V.js}

@@ -464,6 +464,10 @@ var DEFAULT_PRODUCTS = [
 ];
 var PRODUCT_LABEL_PREFIX = "product: ";
 var productLabel = (key) => `${PRODUCT_LABEL_PREFIX}${key}`;
+function productMarks(products, p) {
+  if (p.key === defaultProduct(products).key) return { labels: [], line: "" };
+  return { labels: [productLabel(p.key)], line: `**Product:** ${p.name}` };
+}
 function productsOf(config) {
   const list2 = config?.products;
   return Array.isArray(list2) && list2.length ? list2 : DEFAULT_PRODUCTS;
@@ -1987,7 +1991,7 @@ export {
   unreadableShipTeams,
   canShip,
   whoCanShipSentence,
-  productLabel,
+  productMarks,
   productsOf,
   defaultProduct,
   findProduct,

package/dist/index.js

@@ -3,8 +3,8 @@ import {
   VERSION,
   optionsFromArgv,
   serveStdio
-} from "./chunk-NYFH322K.js";
-import "./chunk-7DBLDJIL.js";
+} from "./chunk-MXMMPO7F.js";
+import "./chunk-QTO4EP6V.js";
 
 // src/index.ts
 var argv = process.argv.slice(2);

package/dist/lib.js

@@ -25,12 +25,12 @@ import {
   requests_exports,
   serveStdio,
   studio_exports
-} from "./chunk-NYFH322K.js";
+} from "./chunk-MXMMPO7F.js";
 import {
   CONFIG_FILE,
   loadConfig,
   toConfigJson
-} from "./chunk-7DBLDJIL.js";
+} from "./chunk-QTO4EP6V.js";
 export {
   BridgeContext,
   CONFIG_FILE,

package/dist/{src-2YRRAUUM.js → src-DHJOM5PQ.js}

@@ -11,7 +11,7 @@ import {
   referenceImagePath,
   selectTokenFiles,
   showFile
-} from "./chunk-7DBLDJIL.js";
+} from "./chunk-QTO4EP6V.js";
 
 // ../visual/src/run.ts
 import { existsSync as existsSync3 } from "node:fs";

package/dist/studio.d.ts

@@ -18,17 +18,26 @@ export declare function saveDocs(ctx: BridgeContext, a: {
     pr: number;
     path: string;
     content: string;
-    commit?: undefined;
     said?: undefined;
     url?: undefined;
     title?: undefined;
     product?: undefined;
 } | {
-    status: "committed" | "unchanged";
+    status: "preview";
     pr: number;
     path: string;
-    commit: string | null;
+    content: string;
+    said: string;
+    url?: undefined;
+    title?: undefined;
+    product?: undefined;
+} | {
     said: string;
+    continued?: boolean | undefined;
+    status: "unchanged" | "committed";
+    pr: number;
+    path: string;
+    commit: string | null;
     content?: undefined;
     url?: undefined;
     title?: undefined;
@@ -39,7 +48,6 @@ export declare function saveDocs(ctx: BridgeContext, a: {
     said: string;
     pr?: undefined;
     content?: undefined;
-    commit?: undefined;
     url?: undefined;
     title?: undefined;
     product?: undefined;
@@ -50,7 +58,6 @@ export declare function saveDocs(ctx: BridgeContext, a: {
     content: string;
     product: string;
     pr?: undefined;
-    commit?: undefined;
     url?: undefined;
     title?: undefined;
 } | {
@@ -62,7 +69,6 @@ export declare function saveDocs(ctx: BridgeContext, a: {
     product: string;
     said: string;
     content?: undefined;
-    commit?: undefined;
 }>;
 /** The settings a designer reads in Studio Settings, safe to show: roles, who ships, the owner override, protection, products, previews. */
 export declare function getSettings(ctx: BridgeContext): Promise<{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bridge-ds/mcp",
-  "version": "0.4.0",
+  "version": "0.4.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.7.0",
-    "@bridge-ds/visual": "^0.3.1",
+    "@bridge-ds/core": "^0.8.0",
+    "@bridge-ds/visual": "^0.3.2",
     "@modelcontextprotocol/sdk": "1.31.0",
     "typescript": "5.9.3",
     "zod": "3.25.76"