@bridge-ds/core 0.5.1 → 0.7.0

package/dist/index.js

@@ -1,7 +1,7 @@
-import { n as modeDisplayName, o as modesOf$1, q as isMultiMode, T as TIER_NAMES, s as TIER_AXIS, u as findReferenceProblems, w as evaluatePairs, x as contrastScope, y as contextLabel, S as SINGLE_MODE, z as pathId, A as flattenTokens, B as serializeTokenFile, D as removeToken, E as upsertToken, F as threeWayDiff, G as emptyTokenFile, H as parseTokenFile, I as EXT_ID, J as EXT_SCOPES, K as resolve, L as moveToken, M as effectiveScopes, N as sameScopes, O as defaultScopes, P as readTokenAt, Q as modeFile, R as defaultFile, U as DEFAULT_PROTECTED_BRANCHES, a as assertSafeBranch, V as ProtectedBranchError, f as CONFIG_FILE, l as loadConfig, W as ConfigError, X as DEFAULT_TOKEN_PATHS, c as collectHistory, p as packageDirCandidates, b as parseChangelog, r as releasesFromTags, m as mergeReleases, d as buildReport, Y as applyTokenEdits, Z as buildHistoryEntry, _ as resolveBranchPreviews, $ as tokensPath, a0 as coerceValue, a1 as toConfigJson, a2 as parseContrastChecks, a3 as checkLayeredPair, a4 as classifyRisk, a5 as formatChangeset, a6 as RISK_LABELS, a7 as parseJson, a8 as serializeJson, a9 as plainEqual, aa as toPlain, ab as getEntry, ac as fromPlain, ad as previewLinks, ae as slugify, af as readPreviewComment, ag as findPreviewComment, ah as previewsSettled } from "./component-spec-cvrSvIZj.js";
-import { ai, aj, ak, k, C, al, am, an, ao, ap, aq, ar, as, at, au, av, aw, ax, ay, az, aA, aB, aC, aD, aE, aF, aG, aH, aI, aJ, aK, aL, aM, aN, aO, i, aP, aQ, aR, aS, aT, aU, aV, aW, aX, aY, aZ, a_, a$, b0, b1, b2, b3, b4, b5, b6, b7, b8, b9, ba, bb, bc, bd, be, bf, bg, bh, bi, bj, bk, bl, bm, bn, bo, h, bp, j, bq, br, bs, bt, bu, bv, bw, bx, by, bz, g, bA, bB, bC, bD, bE, bF, bG, bH, bI, bJ, bK, bL, bM, bN, e, bO, bP, bQ, bR, bS, bT, bU, bV, bW, bX, bY, bZ, b_, b$, c0, c1, c2, c3, c4, c5, c6, c7, c8, t, c9, ca, cb, cc, cd, v, ce, cf, cg, ch } from "./component-spec-cvrSvIZj.js";
+import { u as modeDisplayName, w as modesOf$1, x as isMultiMode, T as TIER_NAMES, y as TIER_AXIS, z as findReferenceProblems, A as evaluatePairs, B as contrastScope, D as contextLabel, S as SINGLE_MODE, E as pathId, F as flattenTokens, G as serializeTokenFile, H as removeToken, I as upsertToken, J as threeWayDiff, K as emptyTokenFile, L as parseTokenFile, M as EXT_ID, N as EXT_SCOPES, n as resolve, O as moveToken, P as effectiveScopes, Q as sameScopes, R as defaultScopes, U as readTokenAt, V as modeFile, W as defaultFile, X as DEFAULT_PROTECTED_BRANCHES, a as assertSafeBranch, Y as ProtectedBranchError, C as CONFIG_FILE, l as loadConfig, Z as ConfigError, _ as DEFAULT_TOKEN_PATHS, c as collectHistory, p as packageDirCandidates, b as parseChangelog, r as releasesFromTags, m as mergeReleases, d as buildReport, $ as applyTokenEdits, a0 as buildHistoryEntry, a1 as resolveBranchPreviews, a2 as tokensPath, a3 as coerceValue, a4 as toConfigJson, a5 as parseContrastChecks, a6 as checkLayeredPair, a7 as classifyRisk, a8 as formatChangeset, a9 as RISK_LABELS, aa as parseJson, ab as serializeJson, ac as plainEqual, ad as toPlain, ae as getEntry, af as fromPlain, ag as previewLinks, ah as slugify, ai as readPreviewComment, aj as findPreviewComment, ak as previewsSettled, f as variantKeyOf, al as canShip, am as whoCanShipSentence, an as unreadableShipTeams, g as layoutOptions, j as buildTokenSet } from "./component-spec-1z2ih4E3.js";
+import { ao, ap, aq, q, o, ar, as, at, au, av, aw, ax, ay, az, aA, aB, aC, aD, aE, aF, aG, aH, aI, aJ, aK, aL, aM, aN, aO, aP, aQ, aR, aS, aT, aU, aV, aW, aX, aY, aZ, a_, a$, b0, b1, b2, b3, b4, b5, b6, b7, b8, b9, ba, bb, bc, bd, be, bf, bg, bh, k, bi, bj, bk, bl, bm, bn, bo, bp, bq, br, bs, bt, bu, bv, bw, bx, by, bz, bA, bB, bC, h, bD, i, bE, bF, bG, bH, bI, bJ, bK, bL, bM, bN, bO, bP, bQ, bR, bS, bT, bU, bV, bW, bX, bY, bZ, b_, b$, e, c0, c1, c2, c3, c4, c5, c6, c7, c8, c9, ca, cb, cc, cd, ce, cf, cg, s, ch, ci, cj, ck, cl, cm, cn, co, cp, cq, cr, t, cs, ct, cu, v, cv, cw, cx, cy } from "./component-spec-1z2ih4E3.js";
 import { a as collectRefs, i as isAlias, b as aliasTarget, v as valuesEqual, p as parseColor, e as rgbaToHex, f as formatValue, s as selectTokenFiles, L as LayeredTokenSet, j as validateLayered } from "./layered-BnbmToGs.js";
-import { D, d, k as k2, l, c, m, n, g as g2, h as h2, o, q, r, t as t2, u } from "./layered-BnbmToGs.js";
+import { D, d, k as k2, l, c, m, n, g, h as h2, o as o2, q as q2, r, t as t2, u } from "./layered-BnbmToGs.js";
 const issueKey = (i2) => `${i2.code}|${i2.path ?? ""}|${i2.mode ?? ""}|${i2.code === "file-problem" ? i2.message : ""}`;
 const modeName = (mode) => mode === SINGLE_MODE ? "all modes" : modeDisplayName(mode);
 const isPalette = (t3) => t3.tier === "brand" && t3.path.startsWith("palette.");
@@ -82,23 +82,23 @@ function validateSet(set, pairs) {
       checkValue(set, t3, v2, mode, modeName(mode), issues);
     }
   }
-  for (const o2 of set.overrides) {
-    const mode = `${o2.brand}.${o2.theme}`;
-    const where = `${modeDisplayName(o2.brand)} ${o2.theme} (${o2.file})`;
-    const base = set.byPath.get(o2.path);
+  for (const o3 of set.overrides) {
+    const mode = `${o3.brand}.${o3.theme}`;
+    const where = `${modeDisplayName(o3.brand)} ${o3.theme} (${o3.file})`;
+    const base = set.byPath.get(o3.path);
     if (!base || base.tier !== "semantic") {
       issues.push({
         code: "override-orphan",
         severity: "error",
-        path: o2.path,
+        path: o3.path,
         mode,
-        message: `${o2.file} overrides ${o2.path}, which is not a semantic token. Remove the override or restore the token.`
+        message: `${o3.file} overrides ${o3.path}, which is not a semantic token. Remove the override or restore the token.`
       });
       continue;
     }
-    checkValue(set, { path: o2.path, tier: "semantic", type: base.type }, o2.value, mode, where, issues);
-    for (const ref of collectRefs(o2.value)) {
-      if (!set.byPath.has(ref)) issues.push({ code: "broken-reference", severity: "error", path: o2.path, mode, message: `${o2.path} points to ${ref}, which does not exist (${where}).` });
+    checkValue(set, { path: o3.path, tier: "semantic", type: base.type }, o3.value, mode, where, issues);
+    for (const ref of collectRefs(o3.value)) {
+      if (!set.byPath.has(ref)) issues.push({ code: "broken-reference", severity: "error", path: o3.path, mode, message: `${o3.path} points to ${ref}, which does not exist (${where}).` });
     }
   }
   const axes = { brand: modesOf$1(set.layout, "brand"), theme: modesOf$1(set.layout, "semantic"), density: modesOf$1(set.layout, "density") };
@@ -141,14 +141,14 @@ function shadowedEdits(set, edits) {
   const out = [];
   for (const e2 of edits) {
     if (e2.tier !== "semantic") continue;
-    for (const o2 of set.overrides) {
-      if (o2.path !== e2.path || !e2.modes.includes(o2.theme)) continue;
+    for (const o3 of set.overrides) {
+      if (o3.path !== e2.path || !e2.modes.includes(o3.theme)) continue;
       out.push({
         code: "override-shadowed",
         severity: "warning",
         path: e2.path,
-        mode: `${o2.brand}.${o2.theme}`,
-        message: `${e2.path} is overridden for ${modeDisplayName(o2.brand)} in ${o2.theme} (${o2.file}), so this edit does not change ${modeDisplayName(o2.brand)} ${o2.theme}. Brand overrides stay code-only.`
+        mode: `${o3.brand}.${o3.theme}`,
+        message: `${e2.path} is overridden for ${modeDisplayName(o3.brand)} in ${o3.theme} (${o3.file}), so this edit does not change ${modeDisplayName(o3.brand)} ${o3.theme}. Brand overrides stay code-only.`
       });
     }
   }
@@ -180,9 +180,9 @@ function levenshtein(a, b) {
   for (let i2 = 1; i2 <= a.length; i2++) {
     let diag = prev[0];
     prev[0] = i2;
-    for (let j2 = 1; j2 <= b.length; j2++) {
-      const tmp = prev[j2];
-      prev[j2] = Math.min(prev[j2] + 1, prev[j2 - 1] + 1, diag + (a[i2 - 1] === b[j2 - 1] ? 0 : 1));
+    for (let j = 1; j <= b.length; j++) {
+      const tmp = prev[j];
+      prev[j] = Math.min(prev[j] + 1, prev[j - 1] + 1, diag + (a[i2 - 1] === b[j - 1] ? 0 : 1));
       diag = tmp;
     }
   }
@@ -221,29 +221,29 @@ function reconcileIds(figma, git) {
     }
   }
   const suggestions = [];
-  const unclaimedGit = [...gitById.values()].filter((g3) => !claimed.has(g3.id));
+  const unclaimedGit = [...gitById.values()].filter((g2) => !claimed.has(g2.id));
   for (const t3 of tokens) {
     if (gitById.has(t3.id)) continue;
     let best;
-    for (const g3 of unclaimedGit) {
-      if (!sameContent(t3, g3)) continue;
-      const similarity = pathSimilarity(t3.path, g3.path);
+    for (const g2 of unclaimedGit) {
+      if (!sameContent(t3, g2)) continue;
+      const similarity = pathSimilarity(t3.path, g2.path);
       if (similarity < SIMILARITY_THRESHOLD) continue;
       if (!best || similarity > best.similarity) {
-        best = { figmaId: t3.id, gitId: g3.id, fromPath: g3.path, toPath: t3.path, similarity: Math.round(similarity * 100) / 100 };
+        best = { figmaId: t3.id, gitId: g2.id, fromPath: g2.path, toPath: t3.path, similarity: Math.round(similarity * 100) / 100 };
       }
     }
     if (best) suggestions.push(best);
   }
   const byGit = /* @__PURE__ */ new Map();
-  for (const s of suggestions) {
-    const prev = byGit.get(s.gitId);
-    if (!prev || s.similarity > prev.similarity) byGit.set(s.gitId, s);
+  for (const s2 of suggestions) {
+    const prev = byGit.get(s2.gitId);
+    if (!prev || s2.similarity > prev.similarity) byGit.set(s2.gitId, s2);
   }
   return { tokens, adoptedByName, suggestions: [...byGit.values()] };
 }
 function applyConfirmedRenames(tokens, confirmed) {
-  const map = new Map(confirmed.map((s) => [s.figmaId, s.gitId]));
+  const map = new Map(confirmed.map((s2) => [s2.figmaId, s2.gitId]));
   return tokens.map((t3) => map.has(t3.id) ? { ...t3, id: map.get(t3.id) } : t3);
 }
 function idExtensionFor(t3) {
@@ -389,11 +389,11 @@ function optionsOf(edits) {
   const out = [];
   for (const e2 of edits) {
     const l2 = look(e2.token);
-    const hit = out.find((o2) => o2.look === l2);
+    const hit = out.find((o3) => o3.look === l2);
     if (hit) hit.option.changes.push(e2.change);
     else out.push({ look: l2, option: { changes: [e2.change], token: e2.token } });
   }
-  return out.map((o2) => o2.option);
+  return out.map((o3) => o3.option);
 }
 function combineConflicts(changes) {
   const out = [];
@@ -405,7 +405,7 @@ function combineConflicts(changes) {
 }
 function pickedOption(c10, picks) {
   const n2 = picks[c10.key];
-  return n2 === void 0 ? null : c10.options.find((o2) => o2.changes.includes(n2)) ?? null;
+  return n2 === void 0 ? null : c10.options.find((o3) => o3.changes.includes(n2)) ?? null;
 }
 const unpicked = (conflicts, picks) => conflicts.filter((c10) => !pickedOption(c10, picks));
 function combineChanges(latest, changes, picks = {}, opts = {}) {
@@ -664,8 +664,8 @@ function protectionSentence(state) {
     case "unprotected":
       return "Your library can be changed without review.";
     case "partial": {
-      const s = joinAnd(state.missing.map((p) => PROTECTION_PART_PHRASE[p]));
-      return `Partly protected: ${s}.`;
+      const s2 = joinAnd(state.missing.map((p) => PROTECTION_PART_PHRASE[p]));
+      return `Partly protected: ${s2}.`;
     }
     default:
       return "Protection status unknown: GitHub did not let this token read it.";
@@ -903,12 +903,12 @@ class GitHubClient {
   // --- History (read only) ----------------------------------------------------------------------
   /** Commits on a ref, newest first, optionally only those touching `path` (a file or directory). */
   async listCommits(opts = {}) {
-    const q2 = new URLSearchParams();
-    if (opts.sha) q2.set("sha", opts.sha);
-    if (opts.path) q2.set("path", opts.path);
-    q2.set("per_page", String(Math.min(100, opts.perPage ?? 30)));
-    if (opts.page) q2.set("page", String(opts.page));
-    const r2 = await this.request("GET", `${this.repoPath}/commits?${q2}`);
+    const q3 = new URLSearchParams();
+    if (opts.sha) q3.set("sha", opts.sha);
+    if (opts.path) q3.set("path", opts.path);
+    q3.set("per_page", String(Math.min(100, opts.perPage ?? 30)));
+    if (opts.page) q3.set("page", String(opts.page));
+    const r2 = await this.request("GET", `${this.repoPath}/commits?${q3}`);
     return r2.map(toCommitSummary);
   }
   /** One commit: message, author, date and parents. */
@@ -1068,9 +1068,9 @@ class GitHubClient {
   }
   /** Issues (not pull requests) with a label, newest first. */
   async listIssues(opts = {}) {
-    const q2 = new URLSearchParams({ state: opts.state ?? "all", per_page: String(opts.perPage ?? 50), sort: "created", direction: "desc" });
-    if (opts.label) q2.set("labels", opts.label);
-    const r2 = await this.request("GET", `${this.repoPath}/issues?${q2}`);
+    const q3 = new URLSearchParams({ state: opts.state ?? "all", per_page: String(opts.perPage ?? 50), sort: "created", direction: "desc" });
+    if (opts.label) q3.set("labels", opts.label);
+    const r2 = await this.request("GET", `${this.repoPath}/issues?${q3}`);
     return r2.filter((i2) => !i2.pull_request).map(toIssue);
   }
   async getIssue(n2) {
@@ -1151,8 +1151,8 @@ class GitHubClient {
   /** Text of one file at a ref (branch, tag or sha), or undefined when it does not exist. */
   async getFileText(path, ref) {
     try {
-      const q2 = ref ? `?ref=${encodeURIComponent(ref)}` : "";
-      const r2 = await this.request("GET", `${this.repoPath}/contents/${encodeRef(path)}${q2}`);
+      const q3 = ref ? `?ref=${encodeURIComponent(ref)}` : "";
+      const r2 = await this.request("GET", `${this.repoPath}/contents/${encodeRef(path)}${q3}`);
       if (r2.type !== "file") return void 0;
       if (r2.encoding === "base64" && r2.content !== void 0) return base64ToUtf8(r2.content);
       return r2.content;
@@ -1167,8 +1167,8 @@ class GitHubClient {
    */
   async getFile(path, ref) {
     try {
-      const q2 = ref ? `?ref=${encodeURIComponent(ref)}` : "";
-      const r2 = await this.request("GET", `${this.repoPath}/contents/${encodeRef(path)}${q2}`);
+      const q3 = ref ? `?ref=${encodeURIComponent(ref)}` : "";
+      const r2 = await this.request("GET", `${this.repoPath}/contents/${encodeRef(path)}${q3}`);
       if (r2.type !== "file") return void 0;
       const text = r2.encoding === "base64" && r2.content !== void 0 ? base64ToUtf8(r2.content) : r2.content ?? "";
       return { text, sha: r2.sha };
@@ -1183,8 +1183,8 @@ class GitHubClient {
    */
   async getFileBase64(path, ref) {
     try {
-      const q2 = ref ? `?ref=${encodeURIComponent(ref)}` : "";
-      const r2 = await this.request("GET", `${this.repoPath}/contents/${encodeRef(path)}${q2}`);
+      const q3 = ref ? `?ref=${encodeURIComponent(ref)}` : "";
+      const r2 = await this.request("GET", `${this.repoPath}/contents/${encodeRef(path)}${q3}`);
       if (r2.type !== "file" || r2.encoding !== "base64" || !r2.content) return void 0;
       return { base64: r2.content.replace(/\s+/g, ""), size: r2.size ?? 0 };
     } catch (err) {
@@ -1195,8 +1195,8 @@ class GitHubClient {
   /** Entries of one folder at a ref (contents API), or an empty list when the folder does not exist. */
   async listDirectory(path, ref) {
     try {
-      const q2 = ref ? `?ref=${encodeURIComponent(ref)}` : "";
-      const r2 = await this.request("GET", `${this.repoPath}/contents/${encodeRef(path)}${q2}`);
+      const q3 = ref ? `?ref=${encodeURIComponent(ref)}` : "";
+      const r2 = await this.request("GET", `${this.repoPath}/contents/${encodeRef(path)}${q3}`);
       if (!Array.isArray(r2)) return [];
       return r2.map((e2) => ({ name: e2.name, path: e2.path, type: e2.type, sha: e2.sha, size: e2.size ?? 0 }));
     } catch (err) {
@@ -1266,7 +1266,7 @@ class GitHubClient {
     ]);
     const checks = [
       ...runs.map((c10) => ({ name: c10.name, status: c10.status, conclusion: c10.conclusion })),
-      ...combined.statuses.map((s) => ({ name: s.context, status: s.state === "pending" ? "in_progress" : "completed", conclusion: s.state === "pending" ? null : s.state }))
+      ...combined.statuses.map((s2) => ({ name: s2.context, status: s2.state === "pending" ? "in_progress" : "completed", conclusion: s2.state === "pending" ? null : s2.state }))
     ];
     const failing = checks.some((c10) => c10.conclusion && !["success", "neutral", "skipped"].includes(c10.conclusion));
     const pending = checks.some((c10) => c10.status !== "completed");
@@ -1275,7 +1275,7 @@ class GitHubClient {
   /** Commit statuses of a commit, newest first (Vercel reports each project as "Vercel – <project>"). */
   async listCommitStatuses(sha) {
     const r2 = await this.request("GET", `${this.repoPath}/commits/${encodeRef(sha)}/statuses?per_page=100`);
-    return r2.map((s) => ({ context: s.context, state: s.state, target_url: s.target_url ?? null, description: s.description ?? null }));
+    return r2.map((s2) => ({ context: s2.context, state: s2.state, target_url: s2.target_url ?? null, description: s2.description ?? null }));
   }
   /**
    * GitHub deployments of a commit with their latest status (environment "Preview – <project>", environment_url the
@@ -1288,14 +1288,14 @@ class GitHubClient {
     return Promise.all(
       [...latest.values()].map(async (d2) => {
         const st = await this.request("GET", `${this.repoPath}/deployments/${d2.id}/statuses?per_page=1`).catch(() => []);
-        const s = st[0];
-        return { id: d2.id, environment: d2.environment, state: s?.state ?? null, environmentUrl: s?.environment_url || null };
+        const s2 = st[0];
+        return { id: d2.id, environment: d2.environment, state: s2?.state ?? null, environmentUrl: s2?.environment_url || null };
       })
     );
   }
   async getPullRequest(n2) {
     const r2 = await this.request("GET", `${this.repoPath}/pulls/${n2}`);
-    return { ...toSummary(r2), body: r2.body ?? "", mergeable: r2.mergeable ?? null };
+    return { ...toSummary(r2), body: r2.body ?? "", mergeable: r2.mergeable ?? null, requestedReviewers: (r2.requested_reviewers ?? []).map((x) => x.login) };
   }
   async listPullRequestFiles(n2) {
     const r2 = await this.request("GET", `${this.repoPath}/pulls/${n2}/files?per_page=100`);
@@ -1372,6 +1372,100 @@ class GitHubClient {
   async removeLabel(issueNumber, label) {
     await this.request("DELETE", `${this.repoPath}/issues/${issueNumber}/labels/${encodeURIComponent(label)}`);
   }
+  // --- branch actions shared by Studio, the MCP server and the CLI (branch-actions.ts) ---
+  /** The account the token belongs to (GET /user). Needs a token. */
+  async getViewer() {
+    this.assertToken("Reading who you are on GitHub");
+    const r2 = await this.request("GET", "/user");
+    return { login: r2.login };
+  }
+  /** The repository's merge settings and the viewer's permissions (unknown settings count as allowed). */
+  async getMergeSettings() {
+    return this.request("GET", this.repoPath);
+  }
+  /**
+   * Merges a pull request, only at `sha` (GitHub refuses when the branch moved meanwhile). The repository's branch
+   * rules still apply: GitHub refuses a merge they block, whatever Bridge says.
+   */
+  async mergePullRequest(n2, input) {
+    this.assertToken("Merging a branch");
+    const r2 = await this.request("PUT", `${this.repoPath}/pulls/${n2}/merge`, {
+      merge_method: input.method,
+      sha: input.sha,
+      ...input.commitMessage !== void 0 && input.method !== "rebase" ? { commit_message: input.commitMessage } : {}
+    });
+    return { sha: r2?.sha ?? "", merged: r2?.merged ?? true };
+  }
+  /** GitHub's "Update branch": merges the base into the pull request, only when its head is still `expectedHeadSha`. */
+  async updatePullRequestBranch(n2, expectedHeadSha) {
+    this.assertToken("Updating a branch from main");
+    await this.request("PUT", `${this.repoPath}/pulls/${n2}/update-branch`, { expected_head_sha: expectedHeadSha });
+  }
+  /** Posts a comment on an issue or pull request and returns its id and link. */
+  async createIssueComment(n2, body) {
+    this.assertToken("Commenting");
+    const r2 = await this.request("POST", `${this.repoPath}/issues/${n2}/comments`, { body });
+    return { id: r2.id, url: r2.html_url };
+  }
+  /** Replaces the text of a comment. */
+  async updateIssueComment(id, body) {
+    this.assertToken("Editing a comment");
+    await this.request("PATCH", `${this.repoPath}/issues/comments/${id}`, { body });
+  }
+  /** Submits a review on a given commit (the head the reviewer saw); the body may be empty for an approval. */
+  async submitReview(n2, input) {
+    this.assertToken("Reviewing a branch");
+    const r2 = await this.request("POST", `${this.repoPath}/pulls/${n2}/reviews`, {
+      event: input.event,
+      ...input.body ? { body: input.body } : {},
+      ...input.commitId ? { commit_id: input.commitId } : {}
+    });
+    return { id: r2.id, user: r2.user?.login, state: r2.state, body: r2.body ?? "" };
+  }
+  /** Line comments of a pull request (review threads), oldest first. */
+  async listReviewComments(n2) {
+    const r2 = await this.request(
+      "GET",
+      `${this.repoPath}/pulls/${n2}/comments?per_page=100`
+    );
+    return r2.map((c10) => ({ id: c10.id, body: c10.body ?? "", author: c10.user?.login ?? "unknown", path: c10.path, line: c10.line ?? null, inReplyTo: c10.in_reply_to_id ?? null, url: c10.html_url, createdAt: c10.created_at }));
+  }
+  /** Asks these people to review a pull request. */
+  async requestReviewers(n2, logins) {
+    this.assertToken("Asking for a review");
+    await this.request("POST", `${this.repoPath}/pulls/${n2}/requested_reviewers`, { reviewers: logins });
+  }
+  /** Takes these people off the requested reviewers. */
+  async removeRequestedReviewers(n2, logins) {
+    this.assertToken("Changing the requested reviewers");
+    await this.request("DELETE", `${this.repoPath}/pulls/${n2}/requested_reviewers`, { reviewers: logins });
+  }
+  /** Replies in the thread of a line comment. */
+  async replyToReviewComment(n2, commentId, body) {
+    this.assertToken("Replying to a comment");
+    const r2 = await this.request("POST", `${this.repoPath}/pulls/${n2}/comments/${commentId}/replies`, { body });
+    return { id: r2.id, url: r2.html_url };
+  }
+  /**
+   * What `head` adds on top of `base`, with what library sync needs: the shared start (merge base), the base
+   * commit and its tree, how far behind, and the files with their previous names.
+   */
+  async compareDetailed(base, head) {
+    const r2 = await this.request("GET", `${this.repoPath}/compare/${encodeRef(base)}...${encodeRef(head)}`);
+    return {
+      behindBy: r2.behind_by,
+      aheadBy: r2.ahead_by,
+      mergeBase: r2.merge_base_commit?.sha ?? null,
+      baseSha: r2.base_commit?.sha ?? null,
+      baseTree: r2.base_commit?.commit?.tree?.sha ?? null,
+      files: (r2.files ?? []).map((f) => ({ filename: f.filename, status: f.status, ...f.previous_filename ? { previous_filename: f.previous_filename } : {} }))
+    };
+  }
+  /** A tree on top of `baseTree` from entries with their own file mode (blob sha, inline content, or sha null to delete). */
+  async createTreeEntries(baseTree, entries) {
+    const r2 = await this.request("POST", `${this.repoPath}/git/trees`, { base_tree: baseTree, tree: entries.map((e2) => ({ ...e2, type: "blob" })) }, true);
+    return r2.sha;
+  }
 }
 function toCommitSummary(c10) {
   return {
@@ -1515,7 +1609,7 @@ function importsIn(text) {
   for (const m2 of text.matchAll(IMPORT_RE)) out.add(m2[1] ?? m2[2]);
   return [...out];
 }
-const norm = (p) => p.replace(/\\/g, "/").replace(/\/+$/, "");
+const norm$1 = (p) => p.replace(/\\/g, "/").replace(/\/+$/, "");
 const isStory = (p) => /\.stories\.[cm]?[jt]sx?$/.test(p);
 const isTest = (p) => /\.(test|spec)\.[cm]?[jt]sx?$/.test(p);
 const isCss = (p) => /\.(css|scss|less)$/.test(p);
@@ -1533,14 +1627,14 @@ function componentOf(from, spec, componentsDir) {
   return abs.slice(componentsDir.length + 1).split("/")[0] || null;
 }
 function componentForPath(path, componentsDir) {
-  const dir = norm(componentsDir);
-  const p = norm(path);
+  const dir = norm$1(componentsDir);
+  const p = norm$1(path);
   if (!p.startsWith(`${dir}/`)) return null;
   const rest = p.slice(dir.length + 1).split("/");
   return rest.length >= 2 ? rest[0] : null;
 }
 function buildUsageIndex(files, componentsDir) {
-  const dir = norm(componentsDir);
+  const dir = norm$1(componentsDir);
   const modules = {};
   const vars = /* @__PURE__ */ new Map();
   const imports = /* @__PURE__ */ new Map();
@@ -1548,7 +1642,7 @@ function buildUsageIndex(files, componentsDir) {
   const globalVars = {};
   const get = (m2, k3) => m2.get(k3) ?? m2.set(k3, /* @__PURE__ */ new Set()).get(k3);
   for (const f of files) {
-    const path = norm(f.path);
+    const path = norm$1(f.path);
     const id = componentForPath(path, dir);
     if (!id) {
       if (isCss(path)) {
@@ -1592,7 +1686,7 @@ function impactedModules(index, input) {
   for (const v2 of changedVars) for (const id of index.byVar[v2] ?? []) add(id, `uses ${v2}`, false);
   for (const f of input.files ?? []) {
     const id = componentForPath(f, index.componentsDir);
-    if (id && index.modules[id]) add(id, `file changed: ${norm(f)}`, false);
+    if (id && index.modules[id]) add(id, `file changed: ${norm$1(f)}`, false);
   }
   const renderedBy = /* @__PURE__ */ new Map();
   for (const m2 of Object.values(index.modules)) for (const d2 of m2.imports) (renderedBy.get(d2) ?? renderedBy.set(d2, []).get(d2)).push(m2.id);
@@ -1605,7 +1699,7 @@ function impactedModules(index, input) {
       if (!known) queue.push(parent);
     }
   }
-  const globalHits = Object.entries(index.globalVars).map(([file, vs]) => ({ file, vars: vs.filter((v2) => changedVars.has(v2)) })).filter((g3) => g3.vars.length > 0);
+  const globalHits = Object.entries(index.globalVars).map(([file, vs]) => ({ file, vars: vs.filter((v2) => changedVars.has(v2)) })).filter((g2) => g2.vars.length > 0);
   const modules = [...reasons.entries()].map(([id, r2]) => ({ id, reasons: r2.reasons, indirect: r2.indirect })).sort((a, b) => Number(a.indirect) - Number(b.indirect) || a.id.localeCompare(b.id));
   return { modules, globalHits };
 }
@@ -1708,8 +1802,8 @@ async function loadGitHubHistory(client, config, opts = {}) {
   const limit = opts.limit ?? 30;
   const backend = gitHubHistoryBackend(client, config);
   let listed = 0;
-  const counted = { ...backend, listCommits: async (o2) => {
-    const r2 = await backend.listCommits(o2);
+  const counted = { ...backend, listCommits: async (o3) => {
+    const r2 = await backend.listCommits(o3);
     listed = r2.length;
     return r2;
   } };
@@ -1721,10 +1815,10 @@ async function loadGitHubHistory(client, config, opts = {}) {
     const files = await backend.tree(head).catch(() => []);
     for (const dir of packageDirCandidates(config)) {
       const p = (f) => dir ? `${dir}/${f}` : f;
-      const cl = files.find((e2) => e2.path === p("CHANGELOG.md"));
+      const cl2 = files.find((e2) => e2.path === p("CHANGELOG.md"));
       const pkg = files.find((e2) => e2.path === p("package.json"));
-      if (!cl && !pkg) continue;
-      if (cl) changelog = parseChangelog(await client.getBlobText(cl.sha));
+      if (!cl2 && !pkg) continue;
+      if (cl2) changelog = parseChangelog(await client.getBlobText(cl2.sha));
       if (pkg) {
         try {
           const json = JSON.parse(await client.getBlobText(pkg.sha));
@@ -1816,19 +1910,19 @@ const LIGHTNESS = { 50: 0.975, 100: 0.952, 200: 0.912, 300: 0.85, 400: 0.735, 50
 const BELL = { 50: 0.12, 100: 0.22, 200: 0.4, 300: 0.62, 400: 0.85, 500: 1, 600: 1, 700: 0.92, 800: 0.8, 900: 0.62, 950: 0.5 };
 const NEUTRAL_ANCHORS = { 200: "#E3E8EE", 600: "#5B6672", 900: "#15202B" };
 const PIN_TOLERANCE = 0.04;
-const bellChroma = (peak) => (s) => peak * BELL[s];
-const neutralChroma = (scale = 1, low = 4e-3, base = 0.01, slope = 0.022) => (s) => (s <= 100 ? low : base + slope * (s / 950)) * scale;
-function oklchToLinear(L, C2, h3) {
+const bellChroma = (peak) => (s2) => peak * BELL[s2];
+const neutralChroma = (scale = 1, low = 4e-3, base = 0.01, slope = 0.022) => (s2) => (s2 <= 100 ? low : base + slope * (s2 / 950)) * scale;
+function oklchToLinear(L, C, h3) {
   const hr = h3 * Math.PI / 180;
-  const a = C2 * Math.cos(hr);
-  const b = C2 * Math.sin(hr);
+  const a = C * Math.cos(hr);
+  const b = C * Math.sin(hr);
   const l2 = (L + 0.3963377774 * a + 0.2158037573 * b) ** 3;
   const m2 = (L - 0.1055613458 * a - 0.0638541728 * b) ** 3;
-  const s = (L - 0.0894841775 * a - 1.291485548 * b) ** 3;
+  const s2 = (L - 0.0894841775 * a - 1.291485548 * b) ** 3;
   return [
-    4.0767416621 * l2 - 3.3077115913 * m2 + 0.2309699292 * s,
-    -1.2684380046 * l2 + 2.6097574011 * m2 - 0.3413193965 * s,
-    -0.0041960863 * l2 - 0.7034186147 * m2 + 1.707614701 * s
+    4.0767416621 * l2 - 3.3077115913 * m2 + 0.2309699292 * s2,
+    -1.2684380046 * l2 + 2.6097574011 * m2 - 0.3413193965 * s2,
+    -0.0041960863 * l2 - 0.7034186147 * m2 + 1.707614701 * s2
   ];
 }
 const encode = (x) => {
@@ -1836,8 +1930,8 @@ const encode = (x) => {
   return c10 <= 31308e-7 ? 12.92 * c10 : 1.055 * c10 ** (1 / 2.4) - 0.055;
 };
 const decode = (x) => x <= 0.04045 ? x / 12.92 : ((x + 0.055) / 1.055) ** 2.4;
-function oklch(L, C2, h3) {
-  let c10 = C2;
+function oklch(L, C, h3) {
+  let c10 = C;
   let lin = oklchToLinear(L, c10, h3);
   for (let i2 = 0; i2 < 60 && !lin.every((x) => x >= -5e-4 && x <= 1.0005); i2++) {
     c10 *= 0.95;
@@ -1846,18 +1940,18 @@ function oklch(L, C2, h3) {
   return lin.map(encode);
 }
 function toOklch(rgb) {
-  const [r2, g3, b] = rgb.map(decode);
-  const l2 = Math.cbrt(0.4122214708 * r2 + 0.5363325363 * g3 + 0.0514459929 * b);
-  const m2 = Math.cbrt(0.2119034982 * r2 + 0.6806995451 * g3 + 0.1073969566 * b);
-  const s = Math.cbrt(0.0883024619 * r2 + 0.2817188376 * g3 + 0.6299787005 * b);
-  const L = 0.2104542553 * l2 + 0.793617785 * m2 - 0.0040720468 * s;
-  const A = 1.9779984951 * l2 - 2.428592205 * m2 + 0.4505937099 * s;
-  const B = 0.0259040371 * l2 + 0.7827717662 * m2 - 0.808675766 * s;
-  const C2 = Math.sqrt(A * A + B * B);
-  const h3 = C2 < 1e-6 ? 0 : (Math.atan2(B, A) * 180 / Math.PI + 360) % 360;
-  return { L, C: C2, h: h3 };
-}
-const isHex = (s) => typeof s === "string" && /^#[0-9a-f]{6}$/i.test(s.trim());
+  const [r2, g2, b] = rgb.map(decode);
+  const l2 = Math.cbrt(0.4122214708 * r2 + 0.5363325363 * g2 + 0.0514459929 * b);
+  const m2 = Math.cbrt(0.2119034982 * r2 + 0.6806995451 * g2 + 0.1073969566 * b);
+  const s2 = Math.cbrt(0.0883024619 * r2 + 0.2817188376 * g2 + 0.6299787005 * b);
+  const L = 0.2104542553 * l2 + 0.793617785 * m2 - 0.0040720468 * s2;
+  const A = 1.9779984951 * l2 - 2.428592205 * m2 + 0.4505937099 * s2;
+  const B = 0.0259040371 * l2 + 0.7827717662 * m2 - 0.808675766 * s2;
+  const C = Math.sqrt(A * A + B * B);
+  const h3 = C < 1e-6 ? 0 : (Math.atan2(B, A) * 180 / Math.PI + 360) % 360;
+  return { L, C, h: h3 };
+}
+const isHex = (s2) => typeof s2 === "string" && /^#[0-9a-f]{6}$/i.test(s2.trim());
 const fromHex = (hex) => [1, 3, 5].map((i2) => parseInt(hex.slice(i2, i2 + 2), 16) / 255);
 const round3 = (x) => Math.round(x * 1e3) / 1e3;
 const toHex = (rgb) => "#" + rgb.map((x) => Math.round(x * 255).toString(16).padStart(2, "0")).join("");
@@ -1868,35 +1962,35 @@ function dtcgColor(rgb, alpha) {
 }
 function generateRamp({ hue, chroma, offset = () => 0, pins = {} }) {
   const out = {};
-  for (const s of STEPS) {
-    const pin = pins[s];
-    out[s] = pin ? fromHex(pin) : oklch(LIGHTNESS[s] + offset(s), chroma(s), hue);
+  for (const s2 of STEPS) {
+    const pin = pins[s2];
+    out[s2] = pin ? fromHex(pin) : oklch(LIGHTNESS[s2] + offset(s2), chroma(s2), hue);
   }
   return out;
 }
 function nearestStep(rgb) {
   const { L } = toOklch(rgb);
   let best = STEPS[0];
-  for (const s of STEPS) if (Math.abs(LIGHTNESS[s] - L) < Math.abs(LIGHTNESS[best] - L)) best = s;
+  for (const s2 of STEPS) if (Math.abs(LIGHTNESS[s2] - L) < Math.abs(LIGHTNESS[best] - L)) best = s2;
   return best;
 }
 function anchoredRamp(hex, pinStep) {
   const rgb = fromHex(hex);
-  const { L, C: C2, h: h3 } = toOklch(rgb);
+  const { L, C, h: h3 } = toOklch(rgb);
   const step = pinStep ?? nearestStep(rgb);
-  const peak = Math.min(0.24, Math.max(0.02, C2 / BELL[step]));
+  const peak = Math.min(0.24, Math.max(0.02, C / BELL[step]));
   return { hue: h3, peak, step, distance: Math.abs(L - LIGHTNESS[step]), ramp: generateRamp({ hue: h3, chroma: bellChroma(peak), pins: { [step]: hex.toUpperCase() } }) };
 }
 function neutralOffset() {
   const off = {};
-  for (const [s, hex] of Object.entries(NEUTRAL_ANCHORS)) off[s] = toOklch(fromHex(hex)).L - LIGHTNESS[s];
-  return (s) => off[s] ?? 0;
+  for (const [s2, hex] of Object.entries(NEUTRAL_ANCHORS)) off[s2] = toOklch(fromHex(hex)).L - LIGHTNESS[s2];
+  return (s2) => off[s2] ?? 0;
 }
 function tintedNeutral(hex) {
   const rgb = fromHex(hex);
-  const { C: C2, h: h3 } = toOklch(rgb);
+  const { C, h: h3 } = toOklch(rgb);
   const ref = neutralChroma()(nearestStep(rgb));
-  const scale = C2 < 4e-3 ? 0 : Math.min(2.5, C2 / ref);
+  const scale = C < 4e-3 ? 0 : Math.min(2.5, C / ref);
   return { hue: h3, scale, ramp: generateRamp({ hue: h3, chroma: neutralChroma(scale), offset: neutralOffset() }) };
 }
 const BRAND_FONTS = [
@@ -1982,9 +2076,9 @@ function rampFor(input, pinStep, kind) {
 function aliasRamp(doc, role, ramp, description) {
   const group = getAt(doc, `palette.${role}`);
   if (!group) return;
-  for (const s of STEPS) {
-    if (!(String(s) in group)) continue;
-    setAt(doc, `palette.${role}.${s}`, { $value: `{color.${ramp}.${s}}` });
+  for (const s2 of STEPS) {
+    if (!(String(s2) in group)) continue;
+    setAt(doc, `palette.${role}.${s2}`, { $value: `{color.${ramp}.${s2}}` });
   }
   group.$description = description;
 }
@@ -2031,15 +2125,15 @@ function listBrands(source) {
 }
 function checkBrandSlug(config, files, slug) {
   const out = [];
-  const s = slug.trim();
-  if (!s) return [{ level: "error", code: "slug-empty", message: "Give the brand a name." }];
-  if (s.length < 2 || s.length > 24 || !BRAND_SLUG_RE.test(s)) out.push({ level: "error", code: "slug-format", message: 'Use 2 to 24 lowercase letters, digits and single dashes, starting with a letter: "acme" or "north-star".' });
+  const s2 = slug.trim();
+  if (!s2) return [{ level: "error", code: "slug-empty", message: "Give the brand a name." }];
+  if (s2.length < 2 || s2.length > 24 || !BRAND_SLUG_RE.test(s2)) out.push({ level: "error", code: "slug-format", message: 'Use 2 to 24 lowercase letters, digits and single dashes, starting with a letter: "acme" or "north-star".' });
   const taken = Object.values(config.axes).flatMap((a) => a.values);
-  if (config.axes.brand?.values.includes(s)) out.push({ level: "error", code: "slug-taken", message: `A brand called "${s}" already exists. Pick another name or edit that brand.` });
-  else if (taken.includes(s) || RESERVED.has(s)) out.push({ level: "error", code: "slug-reserved", message: `"${s}" is a reserved mode name. Pick another name.` });
+  if (config.axes.brand?.values.includes(s2)) out.push({ level: "error", code: "slug-taken", message: `A brand called "${s2}" already exists. Pick another name or edit that brand.` });
+  else if (taken.includes(s2) || RESERVED.has(s2)) out.push({ level: "error", code: "slug-reserved", message: `"${s2}" is a reserved mode name. Pick another name.` });
   const layer = brandLayers(config).brand;
   const map = fileMap(files);
-  if (layer && !config.axes.brand?.values.includes(s) && map.has(fill(layer, { brand: s }))) out.push({ level: "error", code: "slug-file-exists", message: `${tokensPath(config, fill(layer, { brand: s }))} already exists. Pick another name or add it to bridge.config.json.` });
+  if (layer && !config.axes.brand?.values.includes(s2) && map.has(fill(layer, { brand: s2 }))) out.push({ level: "error", code: "slug-file-exists", message: `${tokensPath(config, fill(layer, { brand: s2 }))} already exists. Pick another name or add it to bridge.config.json.` });
   return out;
 }
 function planNewBrand(source, input) {
@@ -2183,8 +2277,8 @@ function planNewBrand(source, input) {
       const src = fill(layers.override, { brand: from, [layers.overrideAxis]: v2 });
       const text2 = files.get(src);
       if (!text2) continue;
-      const o2 = JSON.parse(text2);
-      const out = { ...o2, $description: `${name} overrides on top of semantic/${v2}, copied from ${brandDisplayName(from)}.` };
+      const o3 = JSON.parse(text2);
+      const out = { ...o3, $description: `${name} overrides on top of semantic/${v2}, copied from ${brandDisplayName(from)}.` };
       const dst = fill(layers.override, { brand: slug, [layers.overrideAxis]: v2 });
       nextFiles.set(dst, `${JSON.stringify(out, null, 2)}
 `);
@@ -2219,7 +2313,7 @@ function planNewBrand(source, input) {
   const ramps = {};
   if (inGate) {
     const combo = after.normalizeCombo({ brand: slug });
-    const read = (role) => STEPS.map((s) => ({ step: s, hex: after.resolve(`palette.${role}.${s}`, combo).css })).filter((x) => /^#[0-9a-f]{6}$/i.test(x.hex));
+    const read = (role) => STEPS.map((s2) => ({ step: s2, hex: after.resolve(`palette.${role}.${s2}`, combo).css })).filter((x) => /^#[0-9a-f]{6}$/i.test(x.hex));
     ramps.primary = read("primary");
     ramps.neutral = read("neutral");
     for (const role of ["accent", "link"]) {
@@ -2233,10 +2327,10 @@ function planNewBrand(source, input) {
     ...created.map((f) => ({ path: tokensPath(config, f), action: "create", content: nextFiles.get(f) })),
     { path: CONFIG_FILE, action: "modify", content: configText }
   ];
-  const cs = config.changesets ?? (config.changeset ? { dir: ".changeset", package: config.changeset.package } : void 0);
-  const changeset = cs ? {
-    path: `${cs.dir}/bridge-brand-${slug}.md`,
-    content: formatChangeset(cs.package, "minor", `Add the ${name} brand (\`${slug}\`), started from ${blank ? "a blank brand" : brandDisplayName(from)}.`, `- ${created.map((f) => `\`${tokensPath(config, f)}\``).join("\n- ")}
+  const cs2 = config.changesets ?? (config.changeset ? { dir: ".changeset", package: config.changeset.package } : void 0);
+  const changeset = cs2 ? {
+    path: `${cs2.dir}/bridge-brand-${slug}.md`,
+    content: formatChangeset(cs2.package, "minor", `Add the ${name} brand (\`${slug}\`), started from ${blank ? "a blank brand" : brandDisplayName(from)}.`, `- ${created.map((f) => `\`${tokensPath(config, f)}\``).join("\n- ")}
 - \`${CONFIG_FILE}\`: modes.brand gains "${slug}", so the token build and the contrast gate cover it.`)
   } : void 0;
   if (changeset) planned.push({ path: changeset.path, action: "create", content: changeset.content });
@@ -2281,13 +2375,13 @@ function brandPreviewVariables(source, plan, theme) {
   }
   return out;
 }
-const code = (s) => `\`${s}\``;
+const code = (s2) => `\`${s2}\``;
 function newBrandSection(plan) {
   const roles = Object.keys(plan.ramps);
   const rampTable = roles.length ? [
     `| Step | ${roles.map((r2) => r2[0].toUpperCase() + r2.slice(1)).join(" | ")} |`,
     `| --- | ${roles.map(() => "---").join(" | ")} |`,
-    ...STEPS.map((s) => `| ${s}${s === plan.actionStep ? " (actions)" : ""} | ${roles.map((r2) => code(plan.ramps[r2].find((x) => x.step === s)?.hex ?? "")).join(" | ")} |`)
+    ...STEPS.map((s2) => `| ${s2}${s2 === plan.actionStep ? " (actions)" : ""} | ${roles.map((r2) => code(plan.ramps[r2].find((x) => x.step === s2)?.hex ?? "")).join(" | ")} |`)
   ].join("\n") : "_No ramps resolved._";
   const c10 = plan.contrast;
   const contrastLine = c10.failing.length ? `**${c10.failing.length} of ${c10.checks} pairs fail** for ${plan.name} (${c10.themes.join(" and ")}).` : `All ${c10.checks} contrast checks pass for ${plan.name} in ${c10.themes.join(" and ")}.`;
@@ -2376,7 +2470,7 @@ function cssModuleClasses(css) {
   }
   return out;
 }
-const cell$1 = (s) => s.replace(/\|/g, "\\|").replace(/\n/g, " ");
+const cell$1 = (s2) => s2.replace(/\|/g, "\\|").replace(/\n/g, " ");
 function propsTable(name, props, inherits) {
   if (!props.length) return inherits ? `${name} has no props of its own. It accepts every native <${inherits}> attribute.` : "";
   const rows = props.map((p) => `| \`${p.name}\`${p.required ? " (required)" : ""} | \`${cell$1(p.type)}\` | ${p.defaultValue ? `\`${cell$1(p.defaultValue)}\`` : ""} | ${cell$1(p.description ?? "")} |`);
@@ -2547,16 +2641,16 @@ const DOCS_CHANGE_BUMP = "patch";
 function cleanDraftText(text) {
   return text.replace(/\s*\u2014\s*/g, ", ").replace(/,\s*,/g, ",").replace(/^,\s*/, "").replace(/[ \t]+/g, " ").trim();
 }
-const values = (s) => (s ?? "").split(", ").map((x) => x.trim()).filter(Boolean);
+const values = (s2) => (s2 ?? "").split(", ").map((x) => x.trim()).filter(Boolean);
 const article = (word) => /^[aeiou]/i.test(word) ? "an" : "a";
 const andList = (xs) => xs.length <= 1 ? xs[0] ?? "" : `${xs.slice(0, -1).join(", ")} and ${xs[xs.length - 1]}`;
-const plural = (n2, word, many = `${word}s`) => `${n2} ${n2 === 1 ? word : many}`;
-const capital = (s) => s.charAt(0).toUpperCase() + s.slice(1);
-const lower = (s) => s.charAt(0).toLowerCase() + s.slice(1);
-function propShape(s) {
-  if (!s) return void 0;
-  const m2 = /^(.*?), default (.*)$/.exec(s);
-  return m2 ? { type: m2[1], def: m2[2] } : { type: s, def: "" };
+const plural$1 = (n2, word, many = `${word}s`) => `${n2} ${n2 === 1 ? word : many}`;
+const capital = (s2) => s2.charAt(0).toUpperCase() + s2.slice(1);
+const lower = (s2) => s2.charAt(0).toLowerCase() + s2.slice(1);
+function propShape(s2) {
+  if (!s2) return void 0;
+  const m2 = /^(.*?), default (.*)$/.exec(s2);
+  return m2 ? { type: m2[1], def: m2[2] } : { type: s2, def: "" };
 }
 const VARIANT_FIRST = ["variant", "tone", "intent", "appearance", "kind", "type", "style"];
 function shortVariant(key) {
@@ -2597,7 +2691,7 @@ function firstChange(component, kind, c10, all) {
     case "new-component": {
       const axes = all.filter((x) => x.field.startsWith("Variant "));
       const props = all.filter((x) => x.field.startsWith("Prop "));
-      const parts = [axes.length ? plural(axes.length, "variant axis", "variant axes") : "", props.length ? plural(props.length, "prop") : ""].filter(Boolean);
+      const parts = [axes.length ? plural$1(axes.length, "variant axis", "variant axes") : "", props.length ? plural$1(props.length, "prop") : ""].filter(Boolean);
       return {
         title: `Add the ${component} component`,
         summary: `${component} is not in code yet.${parts.length ? ` The Figma component has ${andList(parts)}.` : ""}`
@@ -2614,7 +2708,7 @@ function firstChange(component, kind, c10, all) {
       if (!before.length) return { title: `Add a ${axis} variant axis`, summary: `${component} gets a new variant axis, ${axis}, with ${after.length === 1 ? "the value" : "the values"} ${andList(after)}.` };
       if (!after.length) return { title: `Remove the ${axis} variant axis`, summary: `${component} no longer has the ${axis} variant axis (${andList(before)}).` };
       if (added.length === 1 && !removed.length) return { title: `Add ${article(added[0])} ${added[0]} ${word}`, summary: `${component} gets a new ${axis} value, ${added[0]}.` };
-      if (added.length && !removed.length) return { title: `Add ${andList(added)} to ${axis}`, summary: `${component} gets ${plural(added.length, `new ${axis} value`)}: ${andList(added)}.` };
+      if (added.length && !removed.length) return { title: `Add ${andList(added)} to ${axis}`, summary: `${component} gets ${plural$1(added.length, `new ${axis} value`)}: ${andList(added)}.` };
       if (removed.length === 1 && !added.length) return { title: `Remove the ${removed[0]} ${word}`, summary: `${component} no longer has the ${axis} value ${removed[0]}.` };
       if (removed.length && !added.length) return { title: `Remove ${andList(removed)} from ${axis}`, summary: `${component} no longer has the ${axis} values ${andList(removed)}.` };
       return { title: `Change the ${axis} values`, summary: `${axis} on ${component} goes from ${andList(before)} to ${andList(after)}.` };
@@ -2666,7 +2760,7 @@ function draftRequestText(component, kind, changes) {
   if (!changes.length && kind !== "new-component") return { title: "", summary: "" };
   const d2 = firstChange(name, kind, changes[0], changes);
   const rest = kind === "new-component" ? 0 : changes.length - 1;
-  const summary = rest > 0 ? `${d2.summary} ${capital(plural(rest, "other change"))} ${rest === 1 ? "is" : "are"} listed below.` : d2.summary;
+  const summary = rest > 0 ? `${d2.summary} ${capital(plural$1(rest, "other change"))} ${rest === 1 ? "is" : "are"} listed below.` : d2.summary;
   return { title: cleanDraftText(d2.title), summary: cleanDraftText(summary) };
 }
 const DRAFT_LINE_MAX = 120;
@@ -2719,7 +2813,7 @@ function draftChangeLine(kind, changes) {
   if (kind === "new-component") {
     const axes = changes.filter((x) => x.field.startsWith("Variant ")).length;
     const props = changes.filter((x) => x.field.startsWith("Prop ")).length;
-    const parts = [axes ? plural(axes, "variant axis", "variant axes") : "", props ? plural(props, "prop") : ""].filter(Boolean);
+    const parts = [axes ? plural$1(axes, "variant axis", "variant axes") : "", props ? plural$1(props, "prop") : ""].filter(Boolean);
     return `New component${parts.length ? ` with ${andList(parts)}` : ""}, not in code yet`;
   }
   if (!changes.length) return "";
@@ -2744,7 +2838,7 @@ function pushChangeRows(entries) {
     return { field: renamed ? `${before.path} -> ${after.path}` : pathOf(e2), before: show(before), after: show(after) };
   });
 }
-function names(paths) {
+function names$1(paths) {
   if (paths.length <= 3) return andList(paths);
   return `${paths.length} tokens, including ${andList(paths.slice(0, 2))}`;
 }
@@ -2761,15 +2855,15 @@ function draftPushDescription(entries, components = []) {
     const modes = only ? valueModes(only) : [];
     if (only && fields.size === 1 && fields.has("description")) clauses.push(`updates the description of ${pathOf(only)}`);
     else if (only && modes.length) clauses.push(`changes ${pathOf(only)} in ${andList(modes)}`);
-    else clauses.push(`changes ${names(by2.changed.map(pathOf))}`);
+    else clauses.push(`changes ${names$1(by2.changed.map(pathOf))}`);
   }
-  if (by2.added.length) clauses.push(`adds ${names(by2.added.map(pathOf))}`);
+  if (by2.added.length) clauses.push(`adds ${names$1(by2.added.map(pathOf))}`);
   if (by2.renamed.length) {
     const r2 = by2.renamed[0];
     const from = (r2.head ?? r2.base)?.path;
-    clauses.push(by2.renamed.length === 1 && from && from !== pathOf(r2) ? `renames ${from} to ${pathOf(r2)}` : `renames ${names(by2.renamed.map(pathOf))}`);
+    clauses.push(by2.renamed.length === 1 && from && from !== pathOf(r2) ? `renames ${from} to ${pathOf(r2)}` : `renames ${names$1(by2.renamed.map(pathOf))}`);
   }
-  if (by2.removed.length) clauses.push(`removes ${names(by2.removed.map(pathOf))}`);
+  if (by2.removed.length) clauses.push(`removes ${names$1(by2.removed.map(pathOf))}`);
   const sentences2 = [];
   if (clauses.length) sentences2.push(`${capital(andList(clauses))}.`);
   const fresh = components.filter((c10) => c10.kind === "new-component").map((c10) => c10.component);
@@ -2842,7 +2936,7 @@ function parseDocsReply(text) {
   if (!json || typeof json !== "object" || Array.isArray(json)) throw new Error("The reply is not a docs.json object.");
   return json;
 }
-const cleanDocsText = (s) => cleanDraftText(s.replace(/[\r\n]+/g, " "));
+const cleanDocsText = (s2) => cleanDraftText(s2.replace(/[\r\n]+/g, " "));
 const isExample = (x) => {
   if (typeof x === "string") return true;
   if (!x || typeof x !== "object" || Array.isArray(x)) return false;
@@ -2854,15 +2948,15 @@ const isExample = (x) => {
 const textList = (x) => {
   if (typeof x === "string") x = [x];
   if (!Array.isArray(x)) return void 0;
-  const out = x.filter((s) => typeof s === "string").map(cleanDocsText).filter(Boolean);
+  const out = x.filter((s2) => typeof s2 === "string").map(cleanDocsText).filter(Boolean);
   return out.length ? out : void 0;
 };
 const guidanceList = (x, examples) => {
   if (!Array.isArray(x)) return void 0;
   const out = [];
-  for (const g3 of x) {
-    if (!g3 || typeof g3 !== "object") continue;
-    const r2 = g3;
+  for (const g2 of x) {
+    if (!g2 || typeof g2 !== "object") continue;
+    const r2 = g2;
     const title = typeof r2.title === "string" ? cleanDocsText(r2.title) : "";
     const text = typeof r2.text === "string" ? cleanDocsText(r2.text) : "";
     if (!title || !text) continue;
@@ -2877,11 +2971,11 @@ function sanitizeDocsSections(raw, keys = PROSE_KEYS, opts = {}) {
   for (const k3 of keys) {
     const v2 = r2[k3];
     if (k3 === "summary") {
-      const s = typeof v2 === "string" ? cleanDocsText(v2) : "";
-      if (s) out.summary = s;
+      const s2 = typeof v2 === "string" ? cleanDocsText(v2) : "";
+      if (s2) out.summary = s2;
     } else if (k3 === "dos" || k3 === "donts") {
-      const g3 = guidanceList(v2, opts.examples ?? false);
-      if (g3) out[k3] = g3;
+      const g2 = guidanceList(v2, opts.examples ?? false);
+      if (g2) out[k3] = g2;
     } else {
       const l2 = textList(v2);
       if (l2) out[k3] = l2;
@@ -2970,9 +3064,9 @@ const EXPLORATION_STATUS_LABEL = { active: "Running", promoted: "Promoted to rev
 const MARK$1 = "bridge-exploration";
 const SLUG_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 function explorationSlug(name) {
-  const s = name.trim().replace(/^explore\//i, "");
-  if (!/[a-z0-9]/i.test(s)) return "";
-  return slugify(s, 40);
+  const s2 = name.trim().replace(/^explore\//i, "");
+  if (!/[a-z0-9]/i.test(s2)) return "";
+  return slugify(s2, 40);
 }
 function explorationBranch(nameOrBranch) {
   return `${EXPLORATION_PREFIX}${explorationSlug(nameOrBranch)}`;
@@ -3079,6 +3173,8 @@ function explorationStatus(p) {
 const isActiveExploration = (labels) => labelNames(labels).includes(EXPLORATION_LABEL);
 function promotionPlan(input) {
   const exploration = parseExplorationBody(input.body);
+  const jira = /^([A-Z][A-Z0-9_]*-\d+)\s+/.exec(input.title)?.[1] ?? null;
+  const title = jira ? input.title.slice(jira.length).trim() : input.title;
   const removeFiles = input.files.filter((f) => f.path.startsWith(`${EXPLORATION_NOTES_DIR}/`) && f.status !== "removed").map((f) => f.path);
   const files = input.files.filter((f) => !f.path.startsWith(`${EXPLORATION_NOTES_DIR}/`));
   const risk = classifyRisk({ files, ...input.config ? { config: input.config } : {} });
@@ -3091,13 +3187,13 @@ function promotionPlan(input) {
   const body = [
     `**Promoted from an exploration on ${date}.** Review it like any change: the tier below comes from the files it touches.`,
     "",
-    kept || `## ${input.title.replace(/^Exploration:\s*/i, "")}`,
+    kept || `## ${title.replace(/^Exploration:\s*/i, "")}`,
     "",
     `**Risk tier:** ${risk.tier}.`,
     ...risk.reasons.slice(0, 8).map((r2) => `- ${r2}`),
     ...closes.length ? ["", ...closes.map((n2) => `Closes #${n2}`)] : []
   ].join("\n");
-  const t3 = input.title.replace(/^Exploration:\s*/i, "").trim() || exploration?.name || input.title;
+  const t3 = title.replace(/^Exploration:\s*/i, "").trim() || exploration?.name || title;
   return {
     tier: risk.tier,
     reasons: risk.reasons,
@@ -3105,7 +3201,7 @@ function promotionPlan(input) {
     addLabels,
     removeFiles,
     body,
-    title: t3.charAt(0).toUpperCase() + t3.slice(1),
+    title: `${jira ? `${jira} ` : ""}${t3.charAt(0).toUpperCase()}${t3.slice(1)}`,
     markReady: true
   };
 }
@@ -3206,8 +3302,8 @@ function declineReasonProblems(reason) {
   return [];
 }
 function declineComment(reason, by2) {
-  const quote = reason.trim().split("\n").map((l2) => `> ${l2}`.trimEnd()).join("\n");
-  return [`Declined${by2 ? ` by @${by2.replace(/^@/, "")}` : ""} in Bridge Studio.`, "", quote, "", "<sub>Closed as not planned. Reopen the issue if things change.</sub>"].join("\n");
+  const quote2 = reason.trim().split("\n").map((l2) => `> ${l2}`.trimEnd()).join("\n");
+  return [`Declined${by2 ? ` by @${by2.replace(/^@/, "")}` : ""} in Bridge Studio.`, "", quote2, "", "<sub>Closed as not planned. Reopen the issue if things change.</sub>"].join("\n");
 }
 function requestStatus(issue) {
   const prs = issue.linkedPrs ?? [];
@@ -3249,8 +3345,8 @@ function requestBrief(r2, ctx) {
     "- If the request is unclear or conflicts with the guidance, comment on the issue instead of guessing."
   ].join("\n");
 }
-const cell = (s) => s.replace(/\|/g, "\\|").replace(/\n/g, " ");
-const sourceLabel = (s) => s === "figma" ? "Figma" : s === "studio" ? "Bridge Studio" : s === "cli" ? "the CLI" : "Claude (MCP)";
+const cell = (s2) => s2.replace(/\|/g, "\\|").replace(/\n/g, " ");
+const sourceLabel = (s2) => s2 === "figma" ? "Figma" : s2 === "studio" ? "Bridge Studio" : s2 === "cli" ? "the CLI" : "Claude (MCP)";
 function validateIntegrations(i2) {
   const out = [];
   if (!i2?.jira) return out;
@@ -3308,7 +3404,7 @@ function newDraftSessionId(random = Math.random) {
   return out;
 }
 const SESSION_RE = /^[a-z0-9-]{6,64}$/;
-const isDraftSessionId = (s) => typeof s === "string" && SESSION_RE.test(s);
+const isDraftSessionId = (s2) => typeof s2 === "string" && SESSION_RE.test(s2);
 function draftSessionPath(sessionId) {
   if (!isDraftSessionId(sessionId)) throw new Error(`"${sessionId}" is not a draft session id.`);
   return `${DRAFTS_DIR}/${sessionId}.json`;
@@ -3405,7 +3501,7 @@ function clip(text, max) {
 function sentences(text) {
   const t3 = text.replace(/\s+/g, " ").trim();
   const parts = t3.match(/[^.!?]+(?:[.!?]+(?=\s|$)|$)/g) ?? [t3];
-  let out = parts.slice(0, DRAFT_SUMMARY_SENTENCES).map((s) => s.trim()).join(" ");
+  let out = parts.slice(0, DRAFT_SUMMARY_SENTENCES).map((s2) => s2.trim()).join(" ");
   if (out.length > SUMMARY_MAX) out = `${clip(out, SUMMARY_MAX)}.`;
   return out;
 }
@@ -3478,7 +3574,7 @@ function draftItemBrief(i2) {
     return [`Item ${i2.id}: component docs${i2.component ? ` of ${i2.component}` : ""} from Bridge Studio (${i2.docs.path ?? i2.docs.slug}): ${what}.`, "", i2.docs.prompt].join("\n");
   }
   const kind = i2.kind ? REQUEST_KINDS.find((k3) => k3.value === i2.kind)?.label : void 0;
-  const cell2 = (s) => (s ?? "").replace(/\|/g, "\\|").replace(/\n/g, " ");
+  const cell2 = (s2) => (s2 ?? "").replace(/\|/g, "\\|").replace(/\n/g, " ");
   const lines = [`Item ${i2.id}: ${i2.scope === "request" ? "a component change request (a GitHub issue developers implement)" : "the description of a pull request with design token (variable) edits from Figma"}.`];
   if (i2.component) lines.push(`Component: ${i2.component}`);
   if (kind) lines.push(`Kind: ${kind}`);
@@ -3578,8 +3674,8 @@ async function createDocsDraftSession(client, input) {
 const DRAFT_POLL_INTERVAL_MS = 5e3;
 const DRAFT_POLL_TIMEOUT_MS = 10 * 6e4;
 class DraftPoller {
-  constructor(o2) {
-    this.o = o2;
+  constructor(o3) {
+    this.o = o3;
   }
   o;
   handle;
@@ -3645,7 +3741,7 @@ class DraftPoller {
     }
   }
 }
-function explorationSummary(p, _owner, _repo, s) {
+function explorationSummary(p, _owner, _repo, s2) {
   const e2 = parseExplorationBody(p.body);
   const slug = p.headRef?.startsWith(EXPLORATION_PREFIX) ? p.headRef.slice(EXPLORATION_PREFIX.length) : e2?.slug ?? explorationSlug(p.title);
   return {
@@ -3653,7 +3749,7 @@ function explorationSummary(p, _owner, _repo, s) {
     url: p.url,
     branch: p.headRef,
     slug,
-    name: e2?.name ?? p.title.replace(/^Exploration:\s*/i, ""),
+    name: e2?.name ?? p.title.replace(/^[A-Z][A-Z0-9_]*-\d+\s+/, "").replace(/^Exploration:\s*/i, ""),
     purpose: e2?.purpose ?? "",
     ...e2?.useCase ? { useCase: e2.useCase } : {},
     status: explorationStatus({ state: p.state, labels: p.labels, headRef: p.headRef, body: p.body }),
@@ -3663,14 +3759,14 @@ function explorationSummary(p, _owner, _repo, s) {
     ...e2?.agent ? { agent: e2.agent } : {},
     updatedAt: p.updatedAt,
     headSha: p.headSha,
-    previews: previewLinks(s.apps, { branch: p.headRef, pr: p.number, sha: p.headSha })
+    previews: previewLinks(s2.apps, { branch: p.headRef, pr: p.number, sha: p.headSha })
   };
 }
-async function listExplorationsOnGitHub(gh, s, opts = {}) {
+async function listExplorationsOnGitHub(gh, s2, opts = {}) {
   const pulls = await gh.listPullRequests(opts.state ?? "open");
-  return pulls.filter((p) => isExplorationPull({ state: p.state, labels: p.labels, headRef: p.headRef, body: p.body })).map((p) => explorationSummary(p, gh.owner, gh.name, s));
+  return pulls.filter((p) => isExplorationPull({ state: p.state, labels: p.labels, headRef: p.headRef, body: p.body })).map((p) => explorationSummary(p, gh.owner, gh.name, s2));
 }
-async function startExplorationOnGitHub(gh, e2, s) {
+async function startExplorationOnGitHub(gh, e2, s2) {
   const problems = explorationProblems(e2);
   if (problems.length) throw new GitHubError(422, problems.join(" "));
   if (!gh.canWrite) throw new GitHubError(401, "Starting an exploration needs a GitHub token (contents and pull requests, read and write, on this repository only).");
@@ -3680,7 +3776,7 @@ async function startExplorationOnGitHub(gh, e2, s) {
   if (await x.getBranchSha(branch)) throw new GitHubError(422, `An exploration named "${slug}" already exists (${branch}). Pick another name, or continue that one.`);
   const full = { ...e2, slug, startedAt: e2.startedAt ?? (/* @__PURE__ */ new Date()).toISOString() };
   const commit = await x.commitToNewBranch({
-    base: s.base,
+    base: s2.base,
     branch,
     message: `chore(explore): start ${full.name.trim()}
 
@@ -3689,8 +3785,9 @@ ${full.purpose.trim()}
 Exploration: never merged as is. Promote it to review or close it.`,
     files: [{ path: explorationNotePath(slug), content: explorationNote(full) }]
   });
-  const ctx = { owner: gh.owner, repo: gh.name, packages: s.packages, apps: s.apps, ...s.requests?.length ? { requests: s.requests } : {} };
-  const pr = await x.createPullRequest({ title: explorationPrTitle(full), head: branch, base: s.base, body: explorationPrBody(full, ctx), draft: true });
+  const ctx = { owner: gh.owner, repo: gh.name, packages: s2.packages, apps: s2.apps, ...s2.requests?.length ? { requests: s2.requests } : {} };
+  const title = full.jira ? `${full.jira.trim().toUpperCase()} ${explorationPrTitle(full)}` : explorationPrTitle(full);
+  const pr = await x.createPullRequest({ title, head: branch, base: s2.base, body: explorationPrBody(full, ctx), draft: true });
   await x.addLabels(pr.number, [EXPLORATION_LABEL]);
   await x.updatePullRequest(pr.number, { body: explorationPrBody(full, { ...ctx, pr: pr.number }) }).catch(() => void 0);
   return {
@@ -3700,7 +3797,7 @@ Exploration: never merged as is. Promote it to review or close it.`,
     url: pr.url,
     commit: commit.sha,
     tryIt: { state: "building" },
-    previews: previewLinks(s.apps, { branch, pr: pr.number, sha: commit.sha })
+    previews: previewLinks(s2.apps, { branch, pr: pr.number, sha: commit.sha })
   };
 }
 async function explorationTryItOnGitHub(gh, e2) {
@@ -3787,32 +3884,1009 @@ async function declineRequestOnGitHub(gh, n2, reason, by2) {
   await gh.addComment(n2, declineComment(reason, by2));
   await gh.updateIssue(n2, { state: "closed", state_reason: "not_planned" });
 }
+const FIDELITY_DEFAULTS = { scale: 2, threshold: 0.1, maxPercent: 3, sizeTolerance: 1 };
+const MAX_DELTA = 35215;
+const STRICT_THRESHOLD = 0.02;
+function rgbAt(img, x, y) {
+  if (x < 0 || y < 0 || x >= img.width || y >= img.height) return [255, 255, 255];
+  const i2 = (y * img.width + x) * 4;
+  const a = img.data[i2 + 3] / 255;
+  return [255 + (img.data[i2] - 255) * a, 255 + (img.data[i2 + 1] - 255) * a, 255 + (img.data[i2 + 2] - 255) * a];
+}
+function colorDelta(a, b) {
+  const dr = a[0] - b[0];
+  const dg = a[1] - b[1];
+  const db = a[2] - b[2];
+  const y = dr * 0.29889531 + dg * 0.58662247 + db * 0.11448223;
+  const i2 = dr * 0.59597799 - dg * 0.2741761 - db * 0.32180189;
+  const q3 = dr * 0.21147017 - dg * 0.52261711 + db * 0.31114694;
+  return 0.5053 * y * y + 0.299 * i2 * i2 + 0.1957 * q3 * q3;
+}
+function foundNear(img, x, y, c10, radius, max) {
+  for (let dy = -radius; dy <= radius; dy++) for (let dx = -radius; dx <= radius; dx++) if (colorDelta(c10, rgbAt(img, x + dx, y + dy)) <= max) return true;
+  return false;
+}
+function compareImages(figma, code2, options = {}) {
+  const scale = options.scale ?? FIDELITY_DEFAULTS.scale;
+  const radius = Math.max(0, Math.round(options.radius ?? scale));
+  const max = MAX_DELTA * (options.threshold ?? FIDELITY_DEFAULTS.threshold) ** 2;
+  const strict = MAX_DELTA * STRICT_THRESHOLD ** 2;
+  const width = Math.max(figma.width, code2.width);
+  const height = Math.max(figma.height, code2.height);
+  const total = width * height;
+  const wantDiff = options.diffImage !== false;
+  const out = wantDiff ? new Uint8ClampedArray(total * 4) : void 0;
+  let different = 0;
+  for (let y = 0; y < height; y++) {
+    for (let x = 0; x < width; x++) {
+      const a = rgbAt(figma, x, y);
+      const b = rgbAt(code2, x, y);
+      const m2 = x < Math.min(figma.width, code2.width) && y < Math.min(figma.height, code2.height) ? max : strict;
+      const same = colorDelta(a, b) <= m2 || foundNear(code2, x, y, a, radius, m2) && foundNear(figma, x, y, b, radius, m2);
+      if (!same) different++;
+      if (out) {
+        const o3 = (y * width + x) * 4;
+        if (same) {
+          const gray = 255 + (b[0] * 0.299 + b[1] * 0.587 + b[2] * 0.114 - 255) * 0.1;
+          out[o3] = out[o3 + 1] = out[o3 + 2] = gray;
+        } else {
+          out[o3] = 220;
+          out[o3 + 1] = 38;
+          out[o3 + 2] = 38;
+        }
+        out[o3 + 3] = 255;
+      }
+    }
+  }
+  const css = (img) => ({ width: Math.round(img.width / scale), height: Math.round(img.height / scale) });
+  const size = { figma: css(figma), code: css(code2) };
+  const tol = options.sizeTolerance ?? FIDELITY_DEFAULTS.sizeTolerance;
+  const sizeMatches = Math.abs(size.figma.width - size.code.width) <= tol && Math.abs(size.figma.height - size.code.height) <= tol;
+  const percent = total ? Math.round(different / total * 1e4) / 100 : 0;
+  return {
+    matches: sizeMatches && percent <= (options.maxPercent ?? FIDELITY_DEFAULTS.maxPercent),
+    percent,
+    differentPixels: different,
+    totalPixels: total,
+    size,
+    sizeMatches,
+    ...out ? { diff: { width, height, data: out } } : {}
+  };
+}
+function summarizeComponent(component, variants, reason) {
+  const compared = variants.filter((v2) => v2.status !== "skipped");
+  const differing = compared.filter((v2) => v2.status === "differs");
+  const rank = (v2) => (v2.status === "differs" ? 1e3 : 0) + (v2.percent ?? 0) + (v2.size && !sameSize(v2.size) ? 500 : 0);
+  const worst = [...compared].sort((a, b) => rank(b) - rank(a))[0];
+  return {
+    component,
+    status: compared.length === 0 ? "not-checked" : differing.length ? "differs" : "matches",
+    checked: compared.length,
+    differing: differing.length,
+    skipped: variants.length - compared.length,
+    ...worst && worst.size ? { worst: { key: worst.key, percent: worst.percent ?? 0, size: worst.size } } : {},
+    ...compared.length === 0 ? { reason: reason ?? variants.find((v2) => v2.reason)?.reason } : {},
+    variants
+  };
+}
+const sameSize = (s2) => s2.figma.width === s2.code.width && s2.figma.height === s2.code.height;
+function buildFidelityReport(input) {
+  const o3 = input.options ?? {};
+  const scale = o3.scale ?? FIDELITY_DEFAULTS.scale;
+  const c10 = input.components;
+  return {
+    version: 1,
+    checkedAt: (input.now ?? /* @__PURE__ */ new Date()).toISOString(),
+    ...input.file ? { file: input.file } : {},
+    reference: input.reference,
+    options: {
+      scale,
+      threshold: o3.threshold ?? FIDELITY_DEFAULTS.threshold,
+      radius: Math.round(o3.radius ?? scale),
+      maxPercent: o3.maxPercent ?? FIDELITY_DEFAULTS.maxPercent,
+      sizeTolerance: o3.sizeTolerance ?? FIDELITY_DEFAULTS.sizeTolerance
+    },
+    components: c10,
+    summary: {
+      components: c10.length,
+      matches: c10.filter((x) => x.status === "matches").length,
+      differs: c10.filter((x) => x.status === "differs").length,
+      notChecked: c10.filter((x) => x.status === "not-checked").length,
+      variantsChecked: c10.reduce((n2, x) => n2 + x.checked, 0),
+      variantsSkipped: c10.reduce((n2, x) => n2 + x.skipped, 0)
+    }
+  };
+}
+const fmtPercent = (p) => p >= 10 ? `${Math.round(p)}%` : p >= 1 ? `${Math.round(p * 10) / 10}%` : p > 0 ? "under 1%" : "0%";
+const fmtSize = (s2) => `${s2.width}x${s2.height}`;
+function fidelityVerdict(v2) {
+  if (v2.status === "skipped") return `Not compared: ${v2.reason ?? "no image of the code"}`;
+  if (v2.status === "matches") return "Matches the code";
+  const parts = [`${fmtPercent(v2.percent ?? 0)} of pixels`];
+  if (v2.size && !sameSize(v2.size)) parts.push(`size ${fmtSize(v2.size.figma)} vs ${fmtSize(v2.size.code)}`);
+  return `Differs from the code: ${parts.join(", ")}`;
+}
+function fidelityComponentLine(c10) {
+  if (c10.status === "not-checked") return `Not compared: ${c10.reason ?? "no image of the code"}`;
+  if (c10.status === "matches") return c10.checked === 1 ? "Matches the code" : `Matches the code (${c10.checked} variants)`;
+  const w = c10.worst;
+  const head = fidelityVerdict({ status: "differs", percent: w.percent, size: w.size });
+  return c10.checked > 1 ? `${head} (${c10.differing} of ${c10.checked} variants)` : head;
+}
+const FIGMA_REFERENCES_BRANCH = "bridge-visual";
+const FIGMA_REFERENCES_DIR = "figma-references";
+const FIGMA_REFERENCES_MANIFEST = `${FIGMA_REFERENCES_DIR}/manifest.json`;
+const FIGMA_REFERENCE_STORY = "internal-figma-reference--variant";
+const FIGMA_FILL_WIDTH_TOKEN = "size.80";
+const STATE_PSEUDO = {
+  default: "rest",
+  rest: "rest",
+  enabled: "rest",
+  hover: "hover",
+  hovered: "hover",
+  pressed: "active",
+  active: "active",
+  focus: "focus-visible",
+  focused: "focus-visible",
+  "focus visible": "focus-visible",
+  disabled: "disabled"
+};
+const iconName = (component) => component.replace(/^Icon\//, "");
+const exportName = (name) => name.replace(/[^A-Za-z0-9]+/g, "");
+function planReference(spec, variant, file) {
+  if (spec.view === "popup") return { ok: false, reason: "drawn open in Figma; the code image shows it closed" };
+  const props = { ...spec.fixed ?? {} };
+  let pseudo;
+  for (const axis of spec.axes) {
+    const value = variant.props[axis.name];
+    if (value === void 0) return { ok: false, reason: `the variant has no ${axis.name} value` };
+    if (axis.prop) {
+      props[axis.prop] = value === "true" ? true : value === "false" ? false : value;
+      continue;
+    }
+    if (axis.name === "Checked") {
+      props.checked = value === "true";
+      if (value === "mixed") props.indeterminate = true;
+      continue;
+    }
+    if (axis.name.toLowerCase() !== "state") return { ok: false, reason: `${axis.name} has no matching option in code` };
+    const s2 = STATE_PSEUDO[value.toLowerCase()];
+    if (!s2) return { ok: false, reason: `the ${value} state has no code equivalent to render` };
+    if (s2 === "disabled") props.disabled = true;
+    else if (s2 !== "rest") pseudo = s2;
+  }
+  const root = spec.parts.find((p) => !p.parent);
+  if (!root) return { ok: false, reason: "the spec has no root layer" };
+  const children = (id) => spec.parts.filter((p) => p.parent === id);
+  const textOf = (part) => {
+    const swapTo = variant.slots?.[part.id] ?? part.swap?.default;
+    if (part.swap && swapTo) {
+      const slot = file?.slots?.find((s2) => s2.name === swapTo);
+      if (!slot) return { reason: `${swapTo} is not in the specs` };
+      if (slot.kind !== "text" || !slot.text) return { reason: `Figma shows a placeholder (${swapTo}) that code has no example of` };
+      return slot.text.default;
+    }
+    const prop = spec.properties.find((p) => p.name === part.text && p.type === "TEXT");
+    return typeof prop?.default === "string" ? prop.default : part.name;
+  };
+  let text;
+  const icons = {};
+  for (const prop of spec.properties) {
+    if (prop.type === "TEXT") {
+      const hidden = spec.properties.some((b) => b.type === "BOOLEAN" && b.prop === prop.prop && b.default === false);
+      if (hidden && prop.prop) continue;
+      if (prop.prop === "children") text = String(prop.default);
+      else if (prop.prop) props[prop.prop] = String(prop.default);
+      continue;
+    }
+    const iconPart = spec.parts.find((p) => p.kind === "icon" && p.visible === prop.name);
+    if (prop.default === true && !iconPart && prop.prop && props[prop.prop] === void 0 && spec.example?.p?.[prop.prop] === void 0) props[prop.prop] = true;
+  }
+  for (const part of spec.parts) {
+    if (part.kind !== "icon" || !part.swap) continue;
+    const shown = part.visible ? spec.properties.find((p) => p.name === part.visible)?.default === true : true;
+    if (!shown) continue;
+    if (!part.swap.prop) return { ok: false, reason: `the ${part.name} icon has no matching option in code` };
+    icons[part.swap.prop] = iconName(variant.slots?.[part.id] ?? part.swap.default);
+  }
+  let parts;
+  const loose = spec.properties.filter((p) => p.type === "TEXT" && !p.prop);
+  const frames = children(root.id).filter((p) => p.kind === "frame");
+  const compound = text === void 0 && frames.length > 0 && frames.every((f) => spec.parts.some((p) => p.parent === f.id && p.kind === "text" && (p.swap || p.text === f.name)));
+  if (compound) {
+    parts = [];
+    for (const f of frames) {
+      const t3 = spec.parts.find((p) => p.parent === f.id && p.kind === "text");
+      const value = textOf(t3);
+      if (typeof value !== "string") return { ok: false, reason: value.reason };
+      parts.push({ component: `${exportName(spec.name)}${exportName(f.name)}`, text: value });
+    }
+  }
+  for (const p of loose) {
+    if (p.name === "Value") continue;
+    const part = spec.parts.find((x) => x.text === p.name);
+    if (compound && part && part.parent !== root.id) continue;
+    if (part && /placeholder$/.test(part.id)) {
+      props.placeholder = String(p.default);
+      continue;
+    }
+    return { ok: false, reason: `the ${p.name} text has no matching option in code` };
+  }
+  const example = spec.example;
+  const exampleChildren = example?.children?.length ? example.children : void 0;
+  return {
+    ok: true,
+    render: {
+      component: exportName(spec.view || spec.fixed || example ? example?.c ?? spec.component ?? spec.name : spec.name),
+      props: { ...example?.p ?? {}, ...props },
+      ...exampleChildren ? { children: exampleChildren } : {},
+      ...text !== void 0 && !exampleChildren ? { text } : {},
+      ...parts && !exampleChildren ? { parts } : {},
+      ...Object.keys(icons).length ? { icons } : {},
+      ...pseudo ? { pseudo } : {},
+      ...root.fill ? { width: FIGMA_FILL_WIDTH_TOKEN } : {}
+    }
+  };
+}
+function referenceImagePath(component, key) {
+  const slug = (s2) => s2.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+  const file = key.split(",").map((kv) => slug(kv)).filter(Boolean).join("__");
+  return `${slug(component)}/${file || "default"}.png`;
+}
+function planReferences(file) {
+  return file.components.flatMap(
+    (spec) => spec.variants.map((v2) => ({ component: spec.name, specHash: spec.hash, key: variantKeyOf(v2.props), plan: planReference(spec, v2, file) }))
+  );
+}
+function parseTier(labels, body) {
+  const found = [];
+  for (const l2 of labels) {
+    const m2 = l2.name.match(/^(?:risk[\s:-]*)?tier[\s:_-]*([123])\b/i) ?? l2.name.match(/^risk[\s:_-]*([123])$/i);
+    if (m2) found.push(Number(m2[1]));
+  }
+  for (const m2 of (body ?? "").matchAll(/-\s*\[[xX]\]\s*\**\s*Tier\s*([123])\b/g)) found.push(Number(m2[1]));
+  for (const m2 of (body ?? "").matchAll(/risk tier\W{0,6}(?:tier\s*)?([123])\b/gi)) found.push(Number(m2[1]));
+  return found.length ? Math.max(...found) : null;
+}
+function pullState(p) {
+  if (p.merged_at || p.merged) return "merged";
+  if (p.state && p.state !== "open") return "closed";
+  if (p.draft) return "draft";
+  return "open";
+}
+const PULL_STATE_PILL = {
+  merged: { label: "Merged", cls: "" },
+  closed: { label: "Closed", cls: "" },
+  draft: { label: "Draft", cls: "" },
+  open: { label: "Open", cls: "" }
+};
+function openPulls(pulls) {
+  return pulls.filter((p) => {
+    const s2 = pullState(p);
+    return s2 === "open" || s2 === "draft";
+  });
+}
+const OK = /* @__PURE__ */ new Set(["success", "neutral", "skipped"]);
+function summarizeCi(runs, statuses = []) {
+  const failed = [];
+  const pending = [];
+  let passed = 0;
+  for (const r2 of runs) {
+    if (r2.status !== "completed") pending.push({ name: r2.name, url: r2.html_url });
+    else if (r2.conclusion && OK.has(r2.conclusion)) passed++;
+    else failed.push({ name: r2.name, url: r2.html_url });
+  }
+  const seen = /* @__PURE__ */ new Set();
+  for (const s2 of statuses) {
+    if (seen.has(s2.context)) continue;
+    seen.add(s2.context);
+    if (s2.state === "success") passed++;
+    else if (s2.state === "pending") pending.push({ name: s2.context, url: s2.target_url ?? void 0 });
+    else failed.push({ name: s2.context, url: s2.target_url ?? void 0 });
+  }
+  const total = passed + failed.length + pending.length;
+  const state = total === 0 ? "none" : failed.length ? "fail" : pending.length ? "pending" : "pass";
+  return { state, total, passed, failed, pending };
+}
+function summarizeApprovals(reviews, owners, author) {
+  const latest = /* @__PURE__ */ new Map();
+  const sorted = [...reviews].sort((a2, b) => String(a2.submitted_at ?? "").localeCompare(String(b.submitted_at ?? "")));
+  for (const r2 of sorted) {
+    const login = r2.user?.login;
+    if (!login || login === author) continue;
+    if (r2.state === "APPROVED" || r2.state === "CHANGES_REQUESTED" || r2.state === "DISMISSED") latest.set(login, r2.state);
+  }
+  const approvers = [...latest].filter(([, s2]) => s2 === "APPROVED").map(([l2]) => l2);
+  const changesRequested = [...latest].filter(([, s2]) => s2 === "CHANGES_REQUESTED").map(([l2]) => l2);
+  const lower2 = (xs) => xs.map((x) => x.toLowerCase().replace(/^@/, ""));
+  const d2 = lower2(owners.design);
+  const t3 = lower2(owners.tech);
+  const a = lower2(approvers);
+  let design;
+  let tech;
+  if (d2.length || t3.length) {
+    design = d2.length ? a.some((x) => d2.includes(x)) : a.length > 0;
+    const soloBoth = (x) => a.length === 1 && d2.includes(x);
+    tech = t3.length ? a.some((x) => t3.includes(x) && !soloBoth(x)) : a.length > 1;
+  } else {
+    design = a.length >= 1;
+    tech = a.length >= 2;
+  }
+  return { approvers, changesRequested, design, tech };
+}
+const normLogin = (x) => x.trim().toLowerCase().replace(/^@/, "");
+function canOverride(login, policy) {
+  if (!login || !policy?.allowed.length) return false;
+  return policy.allowed.map(normLogin).includes(normLogin(login));
+}
+function mergeGate(input) {
+  const blocking = [];
+  const missing = [];
+  const approvalReasons = [];
+  const lifecycle = pullState(input);
+  if (lifecycle === "merged") blocking.push("This branch is already merged.");
+  else if (lifecycle === "closed") blocking.push("This branch is closed.");
+  if (input.exploration && lifecycle !== "merged" && lifecycle !== "closed") blocking.push("It is an exploration: promote it to review first.");
+  if (input.draft) blocking.push("It is a draft. Mark it ready for review on GitHub first.");
+  if (input.ci.state === "fail") blocking.push(`Tests fail: ${input.ci.failed.map((f) => f.name).join(", ")}.`);
+  if (input.ci.state === "pending") blocking.push("Tests are still running.");
+  if (input.approvals.changesRequested.length) blocking.push(`Changes requested by @${input.approvals.changesRequested.join(", @")}.`);
+  const tier = input.tier ?? 3;
+  if (tier >= 2) {
+    if (!input.approvals.design) {
+      approvalReasons.push("It needs a design owner approval.");
+      missing.push("design approval");
+    }
+    if (!input.approvals.tech) {
+      approvalReasons.push("It needs a tech owner approval.");
+      missing.push("tech approval");
+    }
+  } else if (!input.approvals.approvers.length) {
+    approvalReasons.push("It needs one approval.");
+    missing.push("approval");
+  }
+  const conflict = input.mergeable === false ? [CONFLICT_REASON] : [];
+  const shipper = !input.viewer || canShip(input.viewer, input.ship);
+  const ship = !shipper && lifecycle !== "merged" && lifecycle !== "closed" ? [whoCanShipSentence(input.ship), ...unreadableShipTeams(input.ship).map((t3) => t3.status === "unreadable" ? t3.message : "")] : [];
+  const reasons = [...blocking, ...approvalReasons, ...ship, ...conflict];
+  const allowed = reasons.length === 0;
+  const overridable = !allowed && blocking.length + conflict.length + ship.length === 0 && missing.length > 0 && canOverride(input.viewer, input.override);
+  return { allowed, reasons, overridable, missing, canShip: shipper };
+}
+const CONFLICT_REASON = "It conflicts with main: resolve it with Update from main on the branch.";
+const OVERRIDE_HEADING = "**Bridge owner override**";
+function overrideReasonProblem(reason, policy) {
+  if (!policy.requireReason) return null;
+  const n2 = reason.trim().length;
+  if (n2 === 0) return `Write why this merges without the missing approvals, in at least ${policy.minReasonLength} characters.`;
+  if (n2 < policy.minReasonLength) return `Write at least ${policy.minReasonLength} characters (${n2} so far), so the history says why.`;
+  return null;
+}
+function overrideComment(login, reason, missing) {
+  const why = reason.trim().replace(/\s+/g, " ").replace(/[.\s]+$/, "");
+  return `${OVERRIDE_HEADING}
+
+Owner override by @${normLogin(login)}: ${why || "no reason given"}. Missing: ${missing.join(", ")}. Merged from Bridge.`;
+}
+function overrideRefusedComment(body, message) {
+  return body.replace(/ Merged from Bridge\.$/, ` Merge refused by GitHub: ${message.trim().replace(/[.\s]+$/, "")}. Not merged.`);
+}
+function parseOverrideComment(body) {
+  const text = (body ?? "").trim();
+  if (!text.startsWith(OVERRIDE_HEADING)) return null;
+  const m2 = text.match(/Owner override by @([\w-]+): ([\s\S]*?)\. Missing: ([^.]*)\. (Merged from Bridge\.|Merge refused by GitHub)/);
+  if (!m2) return null;
+  return { login: m2[1], reason: m2[2], missing: m2[3].split(/,\s*/).filter(Boolean), merged: m2[4].startsWith("Merged") };
+}
+function allowedMergeMethods(repo) {
+  const out = [];
+  if (repo?.allow_squash_merge !== false) out.push("squash");
+  if (repo?.allow_merge_commit !== false) out.push("merge");
+  if (repo?.allow_rebase_merge !== false) out.push("rebase");
+  return out;
+}
+function hasWriteAccess(perms) {
+  return Boolean(perms && (perms.admin || perms.maintain || perms.push));
+}
+const REVIEW_STATUS_ORDER = {
+  "ci-failing": 0,
+  conflict: 1,
+  "changes-requested": 2,
+  "needs-design": 3,
+  "needs-tech": 4,
+  "needs-approval": 5,
+  ready: 6,
+  "ci-running": 7,
+  checking: 8,
+  unknown: 9,
+  draft: 10,
+  merged: 11,
+  closed: 12
+};
+function reviewStatusKind(input) {
+  const out = (kind) => kind;
+  const lifecycle = pullState(input);
+  if (lifecycle === "merged") return out("merged");
+  if (lifecycle === "closed") return out("closed");
+  if (lifecycle === "draft") return out("draft");
+  if (input.ci?.state === "fail") return out("ci-failing");
+  if (input.approvals?.changesRequested.length) return out("changes-requested");
+  if (input.mergeable === false) return out("conflict");
+  if (input.ci?.state === "pending") return out("ci-running");
+  if (!input.ci || !input.approvals) return out("unknown");
+  if (input.mergeable === null) return out("checking");
+  const tier = input.tier ?? 3;
+  if (tier >= 2) {
+    if (!input.approvals.design) return out("needs-design");
+    if (!input.approvals.tech) return out("needs-tech");
+  } else if (!input.approvals.approvers.length) return out("needs-approval");
+  const gate = mergeGate({ tier: input.tier, ci: input.ci, approvals: input.approvals, draft: Boolean(input.draft), mergeable: input.mergeable, state: input.state ?? "open", merged_at: input.merged_at });
+  return gate.allowed ? out("ready") : out("unknown");
+}
+const BOTS = /* @__PURE__ */ new Set(["github-actions[bot]", "app/github-actions", "changeset-bot[bot]"]);
+const isReleasePull = (p) => p.head.ref.startsWith("changeset-release/");
+function isAutomationPull(p) {
+  return isReleasePull(p) || BOTS.has((p.user?.login ?? "").toLowerCase());
+}
+const runningExploration = (p) => p.state === "open" && isActiveExploration(p.labels ?? []);
+function reviewQueue(pulls) {
+  return openPulls(pulls).filter((p) => !isAutomationPull(p) && !runningExploration(p));
+}
+function releasePull(pulls) {
+  return openPulls(pulls).find((p) => isReleasePull(p)) ?? null;
+}
+function effectiveTier(labels, body, files) {
+  const labelled = parseTier(labels, body);
+  if (!files) return labelled;
+  const computed = classifyRisk({ files: files.map((f) => ({ path: f.filename, status: f.status })) }).tier;
+  return Math.max(labelled ?? 0, computed);
+}
+const norm = (x) => x.trim().toLowerCase().replace(/^@/, "");
+function reopenEligibility(x) {
+  if (x.state !== "closed" || !x.viewer) return { kind: "none" };
+  const isAuthor = norm(x.viewer) === norm(x.author);
+  const isOwner = x.owners.some((o3) => norm(o3) === norm(x.viewer));
+  if (!isAuthor && !isOwner) return { kind: "none" };
+  if (!x.canWrite && !isAuthor) return { kind: "none" };
+  if (x.branch === "exists") return { kind: "reopen" };
+  if (x.branch === "gone") return { kind: "gone" };
+  return { kind: "none" };
+}
+const NO_CI = { state: "pass", total: 0, passed: 0, failed: [], pending: [] };
+const ROLE_OF_MISSING = { "design approval": "design", "tech approval": "tech", approval: "approval" };
+function requiredApprovals(tier) {
+  return mergeGate({ tier, ci: NO_CI, approvals: { approvers: [], changesRequested: [], design: false, tech: false }, draft: false, state: "open" }).missing.map((m2) => ROLE_OF_MISSING[m2]);
+}
+function pendingApprovals(tier, approvals) {
+  if (tier == null || !approvals) return [];
+  return mergeGate({ tier, ci: NO_CI, approvals, draft: false, state: "open" }).missing.map((m2) => ROLE_OF_MISSING[m2]);
+}
+const uniqLogins = (xs) => xs.filter((x, i2) => xs.findIndex((y) => normLogin(y) === normLogin(x)) === i2);
+function eligibleReviewers(role, p) {
+  const raw = role === "design" ? p.owners.design : role === "tech" ? p.owners.tech : uniqLogins([...p.owners.design, ...p.owners.tech]);
+  const listed = raw.map((x) => x.replace(/^@/, ""));
+  const approvers = (p.approvers ?? []).map(normLogin);
+  const logins = listed.filter((l2) => normLogin(l2) !== normLogin(p.author) && !approvers.includes(normLogin(l2)));
+  return { open: listed.length === 0, logins, listed };
+}
+function reviewersToAsk(x) {
+  const roles = pendingApprovals(x.tier, x.approvals);
+  const all = roles.flatMap((r2) => eligibleReviewers(r2, { owners: x.owners, author: x.author, approvers: x.approvals.approvers }).logins);
+  return uniqLogins(all).filter((l2) => normLogin(l2) !== normLogin(x.viewer ?? "") && normLogin(l2) !== normLogin(x.author));
+}
+const plural = (n2, one, many = `${one}s`) => `${n2} ${n2 === 1 ? one : many}`;
+const names = (files) => files.flatMap((f) => f.previous_filename ? [f.filename, f.previous_filename] : [f.filename]);
+function overlap(changeFiles, libraryFiles, isTokenFile) {
+  const lib = new Set(names(libraryFiles));
+  const both = [...new Set(names(changeFiles).filter((f) => lib.has(f)))].sort();
+  return { tokenFiles: both.filter(isTokenFile), codeFiles: both.filter((f) => !isTokenFile(f)) };
+}
+const COMPARE_FILE_LIMIT = 300;
+function conflictRoute(o3, opts = {}) {
+  if (opts.truncated || !o3.tokenFiles.length && !o3.codeFiles.length) return { kind: "code", alsoTokens: false, files: [] };
+  if (o3.codeFiles.length) return { kind: "code", alsoTokens: o3.tokenFiles.length > 0, files: o3.codeFiles };
+  return { kind: "tokens", files: o3.tokenFiles };
+}
+function dismissStaleFrom(rules) {
+  const pr = (rules ?? []).filter((r2) => r2.type === "pull_request");
+  if (!pr.length) return null;
+  return pr.some((r2) => r2.parameters?.dismiss_stale_reviews_on_push === true);
+}
+function resolutionMessage(input) {
+  const lines = input.conflicts.map((c10) => `- ${c10.path} (${c10.file}): ${choiceFor(c10, input.choices) === "theirs" ? `used the ${input.library} value` : "kept this change"}`);
+  const title = input.conflicts.length ? `Bring in the latest ${input.library} and resolve ${plural(input.conflicts.length, "token conflict")}` : `Bring in the latest ${input.library}`;
+  const by2 = input.who ? `
+
+Resolved in Bridge by @${input.who.replace(/^@/, "")}.` : "\n\nResolved in Bridge.";
+  return `${title}${lines.length ? `
+
+${lines.join("\n")}` : ""}${by2}`;
+}
+function freshness(input) {
+  const behindBy = typeof input.compare?.behind_by === "number" ? input.compare.behind_by : null;
+  const mergeBase = input.compare?.merge_base_commit?.sha ?? null;
+  if (!input.open) return { state: "current", behindBy, mergeBase };
+  if (input.mergeable === false) return { state: "conflict", behindBy, mergeBase };
+  if (behindBy === null) return { state: "unknown", behindBy, mergeBase };
+  return { state: behindBy > 0 ? "behind" : "current", behindBy, mergeBase };
+}
+const withoutRoot = (root, p) => root && p.startsWith(`${root}/`) ? p.slice(root.length + 1) : p;
+async function treeAt(gh, sha) {
+  const t3 = await gh.getTree(await gh.getCommitTree(sha));
+  if (t3.truncated) throw new Error("This repository is too big for Bridge to read in one go. A developer resolves the conflict on GitHub.");
+  return new Map(t3.entries.filter((e2) => e2.type === "blob").map((e2) => [e2.path, e2]));
+}
+async function textAt(gh, sha, path) {
+  return await gh.readFile(path, sha) ?? "";
+}
+async function tokenFilesAt(gh, sha, root, tree) {
+  const prefix = root ? `${root}/` : "";
+  const paths = [...tree.keys()].filter((p) => p.startsWith(prefix) && p.endsWith(".tokens.json"));
+  return Object.fromEntries(await Promise.all(paths.map(async (p) => [withoutRoot(root, p), await textAt(gh, sha, p)])));
+}
+async function configAt(gh, sha, tree) {
+  if (!tree.has("bridge.config.json")) return null;
+  try {
+    return loadConfig(await textAt(gh, sha, "bridge.config.json"));
+  } catch {
+    return null;
+  }
+}
+async function readLibraryConflicts(gh, compare, headSha, opts = {}) {
+  const { mergeBase, baseSha: mainSha, baseTree: mainTree } = compare;
+  const changeFiles = compare.files;
+  if (!mergeBase || !mainSha || !mainTree) return { route: conflictRoute({ tokenFiles: [], codeFiles: [] }) };
+  const library = (await gh.compareDetailed(mergeBase, mainSha)).files;
+  const truncated = changeFiles.length >= COMPARE_FILE_LIMIT || library.length >= COMPARE_FILE_LIMIT;
+  const guess = opts.tokensRoot ?? DEFAULT_TOKEN_PATHS.root;
+  const route = conflictRoute(
+    overlap(changeFiles, library, (p) => p.endsWith(".tokens.json") && p.startsWith(`${guess}/`)),
+    { truncated }
+  );
+  if (route.kind !== "tokens") return { route };
+  const [baseTree, headTree, theirsTree] = await Promise.all([treeAt(gh, mergeBase), treeAt(gh, headSha), treeAt(gh, mainSha)]);
+  const config = await configAt(gh, mainSha, theirsTree) ?? await configAt(gh, mergeBase, baseTree);
+  const root = config?.tokens.root ?? guess;
+  const options = config ? layoutOptions(config) : {};
+  const checksPath = `${root}/${config?.tokens.contrastChecks ?? DEFAULT_TOKEN_PATHS.contrastChecks}`;
+  const [baseFiles, mineFiles, theirsFiles, checks] = await Promise.all([
+    tokenFilesAt(gh, mergeBase, root, baseTree),
+    tokenFilesAt(gh, headSha, root, headTree),
+    tokenFilesAt(gh, mainSha, root, theirsTree),
+    theirsTree.has(checksPath) ? textAt(gh, mainSha, checksPath) : Promise.resolve("")
+  ]);
+  const input = { base: baseFiles, mine: mineFiles, theirs: theirsFiles, files: route.files.map((f) => withoutRoot(root, f)) };
+  return {
+    route,
+    tokens: {
+      root,
+      plan: planTokenMerge(input),
+      input,
+      sets: { base: buildTokenSet(baseFiles, options), mine: buildTokenSet(mineFiles, options), theirs: buildTokenSet(theirsFiles, options) },
+      mineFiles,
+      theirsFiles,
+      pairs: parseContrastChecks(checks || opts.contrastFallback),
+      options
+    },
+    write: { mainSha, mainTree, headSha, headTree, changeFiles }
+  };
+}
+function resolvedTokenFiles(data, choices) {
+  const t3 = data.tokens;
+  const merged = applyTokenMerge(t3.input, choices).files;
+  const all = { ...t3.theirsFiles };
+  for (const f of data.write.changeFiles) {
+    for (const p of [f.previous_filename, f.filename]) {
+      if (!p || !p.endsWith(".tokens.json") || !p.startsWith(`${t3.root}/`)) continue;
+      const rel = withoutRoot(t3.root, p);
+      if (rel in merged) continue;
+      if (t3.mineFiles[rel] === void 0) delete all[rel];
+      else all[rel] = t3.mineFiles[rel];
+    }
+  }
+  for (const [rel, text] of Object.entries(merged)) {
+    if (text === null) delete all[rel];
+    else all[rel] = text;
+  }
+  return { all, merged };
+}
+async function commitLibraryResolution(gh, pull, data, choices, who) {
+  const t3 = data.tokens;
+  const w = data.write;
+  if (!t3 || !w) throw new Error("Only a token conflict can be resolved in Bridge. A developer resolves code conflicts on GitHub.");
+  if (w.headSha !== pull.head.sha) throw new Error("The branch moved while you were choosing. Read it again and resolve again.");
+  const { merged } = resolvedTokenFiles(data, choices);
+  const shared = new Set(data.route.files);
+  const tree = [];
+  for (const f of w.changeFiles) {
+    if (shared.has(f.filename)) continue;
+    if (f.previous_filename && !shared.has(f.previous_filename)) tree.push({ path: f.previous_filename, mode: "100644", sha: null });
+    if (f.status === "removed") {
+      tree.push({ path: f.filename, mode: "100644", sha: null });
+      continue;
+    }
+    const e2 = w.headTree.get(f.filename);
+    if (!e2) throw new Error(`Bridge could not read ${f.filename} in the branch. Read it again and try again.`);
+    tree.push({ path: e2.path, mode: e2.mode, sha: e2.sha });
+  }
+  for (const [rel, text] of Object.entries(merged)) {
+    const path = t3.root ? `${t3.root}/${rel}` : rel;
+    const mode = w.headTree.get(path)?.mode ?? "100644";
+    tree.push(text === null ? { path, mode, sha: null } : { path, mode, content: text });
+  }
+  const newTree = await gh.createTreeEntries(w.mainTree, tree);
+  const message = resolutionMessage({ library: pull.base.ref, conflicts: t3.plan.conflicts, choices, who });
+  const commit = await gh.createCommit(message, newTree, [w.headSha, w.mainSha]);
+  await gh.updateBranch(pull.head.ref, commit);
+  return commit;
+}
+async function mergeOnGitHub(gh, input) {
+  const r2 = await gh.mergePullRequest(input.number, { method: input.method ?? "squash", sha: input.headSha });
+  return { sha: r2.sha };
+}
+class OverrideMergeError extends Error {
+  constructor(stage, message, cause, commentUrl) {
+    super(message);
+    this.stage = stage;
+    this.cause = cause;
+    this.commentUrl = commentUrl;
+    this.name = "OverrideMergeError";
+  }
+  stage;
+  cause;
+  commentUrl;
+}
+async function overrideMergeOnGitHub(gh, input) {
+  const body = overrideComment(input.login, input.reason, input.missing);
+  let comment;
+  try {
+    comment = await gh.createIssueComment(input.number, body);
+  } catch (err) {
+    throw new OverrideMergeError("comment", `GitHub did not take the comment, so nothing merged: ${err.message}`, err);
+  }
+  try {
+    const r2 = await gh.mergePullRequest(input.number, { method: input.method, sha: input.headSha, commitMessage: body.replace(OVERRIDE_HEADING, "").trim() });
+    return { sha: r2.sha, commentUrl: comment.url, comment: body };
+  } catch (err) {
+    const msg = err.message.trim().replace(/[.\s]+$/, "");
+    await gh.updateIssueComment(comment.id, overrideRefusedComment(body, msg)).catch(() => void 0);
+    throw new OverrideMergeError(
+      "merge",
+      `GitHub refused to merge it: ${msg}. Your reason stays on the branch, marked not merged. The protection of main may need an approving review or an admin bypass.`,
+      err,
+      comment.url
+    );
+  }
+}
+async function reviewOnGitHub(gh, input) {
+  const text = input.body?.trim() ?? "";
+  if (input.event === "REQUEST_CHANGES" && !text) throw new Error("Add a comment that says what to change.");
+  if (input.event === "COMMENT" && !text) throw new Error("Write a comment first.");
+  return gh.submitReview(input.number, { event: input.event, body: text || void 0, commitId: input.headSha });
+}
+async function commentOnGitHub(gh, n2, body) {
+  const text = body.trim();
+  if (!text) throw new Error("Write the comment first.");
+  return gh.createIssueComment(n2, text);
+}
+async function askOthersToReviewOnGitHub(gh, input) {
+  if (!input.others.length) throw new Error("Nobody else can give the missing approval. Review it, or ask an owner in Settings to add a reviewer.");
+  await gh.requestReviewers(input.number, input.others);
+  if (input.viewer && input.viewerRequested) await gh.removeRequestedReviewers(input.number, [input.viewer]).catch(() => void 0);
+  return input.others;
+}
+async function closeOnGitHub(gh, n2) {
+  await gh.updatePullRequest(n2, { state: "closed" });
+}
+async function reopenOnGitHub(gh, n2) {
+  await gh.updatePullRequest(n2, { state: "open" });
+}
+const sameLogin = (a, b) => Boolean(a && b && a.toLowerCase().replace(/^@/, "") === b.toLowerCase().replace(/^@/, ""));
+function canAddTo(p, viewer, write) {
+  if (!viewer) return false;
+  return write || sameLogin(p.user?.login, viewer);
+}
+function addedComment(paths, viewer, from = "the Bridge token editor") {
+  const lines = paths.slice(0, 20).map((p) => `- \`${p}\``);
+  if (paths.length > 20) lines.push(`- and ${paths.length - 20} more`);
+  return `${viewer ? `@${viewer} added` : "Added"} token edits from ${from}:
+
+${lines.join("\n")}`;
+}
+const JIRA_KEY = /^[A-Z][A-Z0-9_]{0,9}-[1-9]\d{0,6}$/;
+function parseJiraKey(input) {
+  const t3 = (input ?? "").trim().toUpperCase();
+  if (!t3) return null;
+  if (!JIRA_KEY.test(t3)) throw new Error("Write the Jira ticket as its key, like DS-42, or leave it empty.");
+  return t3;
+}
+const isJiraKey = (input) => JIRA_KEY.test(input.trim().toUpperCase());
+const LEADING_KEY = /^\[?([A-Z][A-Z0-9_]{0,9}-[1-9]\d{0,6})\]?[:\s]\s*/;
+function jiraKeyOf(title) {
+  return LEADING_KEY.exec(title.trim())?.[1] ?? null;
+}
+const withoutJiraKey = (title) => title.trim().replace(LEADING_KEY, "");
+function titleWithJiraKey(title, key) {
+  if (!key) return title;
+  return `${key} ${withoutJiraKey(title)}`;
+}
+function branchWithJiraKey(branch, key) {
+  if (!key || branch.includes(key)) return branch;
+  const i2 = branch.lastIndexOf("/");
+  return i2 < 0 ? `${key}-${branch}` : `${branch.slice(0, i2 + 1)}${key}-${branch.slice(i2 + 1)}`;
+}
+const 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").',
+  label: "source: bridge-web"
+};
+const DOCS_MCP_ORIGIN = {
+  where: "with Claude through the Bridge MCP server",
+  footer: 'Proposed with the Bridge MCP server on behalf of a person. Docs Claude drafted say "draftedBy": "claude" until a reviewer accepts them.',
+  label: "source: mcp"
+};
+const EM_DASH = /\u2014/;
+function validateDocs(d2) {
+  const out = [];
+  if (!d2.summary.trim()) out.push({ field: "summary", message: "Add a summary: one or two sentences on what it is for." });
+  const lists = ["whenToUse", "whenNotToUse", "accessibility", "contentGuidelines"];
+  for (const k3 of lists) (d2[k3] ?? []).forEach((x, i2) => !x.trim() && out.push({ field: `${k3}.${i2}`, message: "Fill or remove the empty item." }));
+  for (const k3 of ["dos", "donts"]) d2[k3].forEach((g2, i2) => (!g2.title.trim() || !g2.text.trim()) && out.push({ field: `${k3}.${i2}`, message: "Give every item a title and a sentence." }));
+  const prose = JSON.stringify([d2.summary, d2.whenToUse, d2.whenNotToUse, d2.dos, d2.donts, d2.accessibility, d2.contentGuidelines ?? [], d2.anatomy ?? {}]);
+  if (EM_DASH.test(prose)) out.push({ field: "voice", message: "Replace the em dashes with a colon, a comma or two sentences." });
+  return out;
+}
+function cleanDocs(d2) {
+  const list = (xs) => (xs ?? []).map((x) => x.trim()).filter(Boolean);
+  const guide = (xs) => xs.map((g2) => ({ ...g2, title: g2.title.trim(), text: g2.text.trim() })).filter((g2) => g2.title || g2.text);
+  return {
+    ...d2,
+    summary: d2.summary.trim(),
+    whenToUse: list(d2.whenToUse),
+    whenNotToUse: list(d2.whenNotToUse),
+    dos: guide(d2.dos),
+    donts: guide(d2.donts),
+    accessibility: list(d2.accessibility),
+    contentGuidelines: list(d2.contentGuidelines),
+    anatomy: Object.fromEntries(Object.entries(d2.anatomy ?? {}).filter(([k3, v2]) => k3.trim() && v2.trim()))
+  };
+}
+const docsText = (d2) => formatDocsJson(cleanDocs(d2));
+const docsFileText = (d2, original) => patchDocsJson(original, cleanDocs(d2));
+const slugDate = (d2) => d2.toISOString().slice(0, 10).replace(/-/g, "");
+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((e2) => e2.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 slug = `${names2.length === 1 ? edits[0].slug : `${edits[0].slug}-and-${names2.length - 1}-more`}`.toLowerCase().replace(/[^a-z0-9-]+/g, "-").slice(0, 40);
+  const branch = `docs/${slug}-${slugDate(opts.date)}-${opts.date.getTime().toString(36).slice(-4)}`;
+  const csPath = `${opts.changesetDir ?? ".changeset"}/docs-${slug}-${opts.date.getTime().toString(36)}.md`;
+  const pkg = opts.packageName ?? "@bridge-ds/react";
+  const changeset = `---
+"${pkg}": patch
+---
+
+Usage guidance for ${list}.
+`;
+  const files = [...edits.map((e2) => ({ path: e2.path, content: e2.after })), { path: csPath, content: changeset }];
+  const risk = classifyRisk({ files: files.map((f) => ({ path: f.path, status: "modified" })) });
+  const rows = edits.map((e2) => {
+    let state = "edited";
+    try {
+      const d2 = JSON.parse(e2.after);
+      const gaps = missingProse(d2);
+      state = gaps.length ? `still missing: ${gaps.join(", ")}` : "every section filled";
+    } catch {
+      state = "not valid JSON";
+    }
+    return `- \`${e2.path}\` (${e2.before === null ? "new" : "changed"}, ${state})`;
+  });
+  const body = [
+    `## Docs change`,
+    "",
+    `Usage guidance for ${list}, written ${origin.where}.`,
+    "",
+    ...rows,
+    "",
+    `**Risk:** ${risk.label}. Docs only: the published components do not change. Changeset: patch.`,
+    "",
+    opts.notes?.trim() ? `## Notes
+
+${opts.notes.trim()}
+` : "",
+    "---",
+    origin.footer
+  ].filter((x, i2, a) => !(x === "" && a[i2 - 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 });
+  const prTitle = titleWithJiraKey(p.title, opts.jira ?? null);
+  const branch = branchWithJiraKey(p.branch, opts.jira ?? null);
+  const mainSha = await gh.getBranchSha(opts.base);
+  if (!mainSha) throw new Error(`Branch ${opts.base} not found.`);
+  const tree = await gh.createTree(await gh.getCommitTree(mainSha), p.files.map((f) => ({ path: f.path, content: f.content })));
+  const commit = await gh.createCommit(`${prTitle}
+
+${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 };
+}
+async function commitFileOnGitHub(gh, input) {
+  const cur = await gh.getFile(input.path, input.branch);
+  if (!cur) throw new Error(`${input.path} is not on ${input.branch}. Check the component name and the branch.`);
+  const content = input.next(cur.text);
+  if (content === cur.text) return "";
+  return gh.putFile({ path: input.path, content, branch: input.branch, message: input.message, sha: cur.sha });
+}
+const SHARE_EXPLAIN = "Product teams can install this branch in their app before it is merged, and remove it any time.";
+const packageDir = (name) => `packages/${name.replace(/^@[^/]+\//, "")}/`;
+function touchesPackages(files, packages) {
+  const dirs = packages.map(packageDir);
+  return files.some((f) => dirs.some((d2) => f.startsWith(d2)));
+}
+const canShare = (x) => !x.fromFork && x.packages.length > 0;
+function shareState(x) {
+  if (!touchesPackages(x.files, x.packages)) return { kind: "no-packages" };
+  const c10 = readPreviewComment(x.comment);
+  if (x.lifecycle === "merged" || x.lifecycle === "closed") {
+    const kind = x.lifecycle === "merged" ? "shipped" : "closed";
+    if (!c10 || !c10.command || c10.source === "none") return { kind, stillWorks: null, command: null };
+    return { kind, stillWorks: c10.source === "pkg.pr.new" ? true : c10.source === "release" ? false : null, command: c10.command };
+  }
+  if (!c10) return { kind: "building" };
+  if (c10.sha7 && !x.headSha.startsWith(c10.sha7)) return { kind: "building" };
+  if (!c10.command || c10.source === "none") return { kind: "failed" };
+  return { kind: "ready", command: c10.command, source: c10.source };
+}
+const showShare = (lifecycle, s2) => lifecycle === "open" || lifecycle === "draft" || (s2.kind === "shipped" || s2.kind === "closed") && !!s2.command;
+const shareDescription = (s2) => s2.kind === "shipped" || s2.kind === "closed" ? stateSentence(s2) ?? SHARE_EXPLAIN : SHARE_EXPLAIN;
+const stableCommand = (packages) => `npm i ${packages.map((p) => `${p}@latest`).join(" ")}`;
+function stateSentence(s2) {
+  switch (s2.kind) {
+    case "ready":
+      return null;
+    case "building":
+      return "The preview version is being prepared. It is usually ready a couple of minutes after each update to the branch.";
+    case "failed":
+      return "The preview version could not be prepared for the latest update. Update the branch to try again, or ask a developer to run it again on GitHub.";
+    case "no-packages":
+      return "This branch does not touch the library tokens or components, so there is no preview version to install.";
+    case "shipped":
+      return s2.stillWorks === true ? "This branch was merged. Its preview version still installs, and products get it with the next library release." : s2.stillWorks === false ? "This branch was merged, so its preview version was removed. Products get it with the next library release." : "This branch was merged. Products get it with the next library release.";
+    case "closed":
+      return s2.stillWorks === true ? "This branch was closed without merging. Its preview version still installs, but it will not reach the library." : s2.stillWorks === false ? "This branch was closed without merging, so its preview version was removed." : "This branch was closed without merging.";
+  }
+}
+const quote = (t3) => `"${t3.trim().replace(/"/g, "'")}"`;
+function shareMessage(x) {
+  const back = stableCommand(x.packages);
+  const s2 = x.state;
+  if (s2.kind === "ready") {
+    const lasts = s2.source === "pkg.pr.new" ? "This preview stays available. Each update to the change makes a new one: ask me for the latest command." : "This preview is replaced on each update to the change and removed when it ships or closes: ask me for the latest command if the install fails.";
+    return {
+      subject: `Try the design system change ${quote(x.title)} before it ships`,
+      body: [
+        "Hi,",
+        "",
+        `Could you try the design system change ${quote(x.title)} in our product before it ships?`,
+        ...x.tryUrl ? ["", `See it in the demo product first: ${x.tryUrl}`] : [],
+        "",
+        "Install the preview version in a staging branch (not production):",
+        s2.command,
+        "",
+        lasts,
+        "",
+        "To go back to the stable version:",
+        back,
+        "",
+        `Details for developers: ${x.url}`
+      ].join("\n")
+    };
+  }
+  if ((s2.kind === "shipped" || s2.kind === "closed") && s2.command) {
+    const what = s2.kind === "shipped" ? `The design system change ${quote(x.title)} has shipped. You get it with the next library release.` : `The design system change ${quote(x.title)} was closed without shipping.`;
+    const preview = s2.stillWorks === false ? "Its preview version was removed, so reinstalling it fails." : s2.stillWorks === true ? "Its preview version still installs, but it is not the released version." : "";
+    return {
+      subject: `Design system change ${quote(x.title)} ${s2.kind === "shipped" ? "has shipped" : "was closed"}`,
+      body: ["Hi,", "", [what, preview].filter(Boolean).join(" "), "", "If you installed its preview, go back to the stable version:", back, "", `Details for developers: ${x.url}`].join("\n")
+    };
+  }
+  return null;
+}
+const mailtoHref = (m2) => `mailto:?subject=${encodeURIComponent(m2.subject)}&body=${encodeURIComponent(m2.body.replace(/\r?\n/g, "\r\n"))}`;
+function productPreview(apps, ctx, sources) {
+  if (!apps.admin || ctx.fromFork) return null;
+  const admin = resolveBranchPreviews(apps, { branch: ctx.branch, pr: ctx.pr, sha: ctx.sha }, sources).find((p) => p.app === "admin");
+  if (!admin?.url || admin.source === "template" || admin.state === "failed") return null;
+  return admin.url;
+}
+function tryInProductUrl(preview, pr, screen) {
+  const url = new URL(preview);
+  url.pathname = "/";
+  url.search = "";
+  url.searchParams.set("bridge", String(pr));
+  if (screen) {
+    url.searchParams.set("tenant", screen.tenant);
+    url.searchParams.set("theme", screen.theme);
+  }
+  url.hash = screen ? screen.route : "";
+  return url.href;
+}
+const MIN_TOGETHER = 2;
+const MAX_TOGETHER = 4;
+function onlyTokens(files, tokensRoot) {
+  const root = `${tokensRoot.replace(/^\/+|\/+$/g, "")}/`;
+  return files.length > 0 && files.every((f) => f.startsWith(root) && f.endsWith(".tokens.json") || /contrast\.checks\.json$/.test(f) || f.startsWith(".changeset/"));
+}
+function tokenFilesOf(files, tokensRoot) {
+  const root = `${tokensRoot.replace(/^\/+|\/+$/g, "")}/`;
+  return files.filter((f) => f.startsWith(root) && f.endsWith(".tokens.json")).map((f) => f.slice(root.length));
+}
+const changeList = (numbers) => numbers.join(",");
+function tryTogetherUrl(admin, numbers, picks) {
+  const url = new URL(admin);
+  url.pathname = "/";
+  url.hash = "";
+  const use = encodePicks(picks);
+  url.search = `?bridge=${changeList(numbers)}${use ? `&bridge-use=${encodeURIComponent(use)}` : ""}`;
+  return url.href;
+}
+const COMBINE_COMPARE_LIMIT = 300;
+async function readCombineBranch(gh, pull, opts) {
+  const compare = await gh.compareDetailed(opts.base, pull.headSha);
+  const files = compare.files;
+  const names2 = files.flatMap((f) => f.previous_filename ? [f.filename, f.previous_filename] : [f.filename]);
+  const start = compare.mergeBase;
+  if (!start || files.length >= COMBINE_COMPARE_LIMIT || !onlyTokens(names2, opts.tokensRoot)) return { number: pull.number, title: pull.title, tokens: false, edits: null };
+  const root = opts.tokensRoot.replace(/^\/+|\/+$/g, "");
+  const tokenFiles = files.filter((f) => tokenFilesOf([f.filename], root).length);
+  const source = { number: pull.number, base: {}, head: {}, files: tokenFiles.map((f) => tokenFilesOf([f.filename], root)[0]) };
+  await Promise.all(
+    tokenFiles.map(async (f) => {
+      const rel = tokenFilesOf([f.filename], root)[0];
+      source.base[rel] = f.status === "added" ? void 0 : await gh.readFile(f.previous_filename ?? f.filename, start);
+      source.head[rel] = f.status === "removed" ? void 0 : await gh.readFile(f.filename, pull.headSha);
+    })
+  );
+  return { number: pull.number, title: pull.title, tokens: true, edits: changeEdits(source) };
+}
 export {
-  ai as AAA_MIN,
-  aj as AA_MIN,
+  ao as AAA_MIN,
+  ap as AA_MIN,
   ADMIN_ROLE_ID,
   ANTHROPIC_MESSAGES_URL,
   BELL,
   BRAND_FONTS,
   BRAND_SLUG_RE,
-  ak as BULK_LIMIT,
-  k as COLOR_FIELDS,
-  C as COMPONENT_SPECS_VERSION,
+  aq as BULK_LIMIT,
+  q as COLOR_FIELDS,
+  COMBINE_COMPARE_LIMIT,
+  COMPARE_FILE_LIMIT,
+  o as COMPONENT_SPECS_VERSION,
   CONFIG_FILE,
-  al as CONTRAST_CELL_MAX,
-  am as CONTRAST_CHECKS_FILE,
+  CONFLICT_REASON,
+  ar as CONTRAST_CELL_MAX,
+  as as CONTRAST_CHECKS_FILE,
   ConfigError,
-  an as DEFAULT_COMPONENT_SPECS_FILE,
-  ao as DEFAULT_GOVERNANCE,
-  ap as DEFAULT_OVERRIDE,
+  at as DEFAULT_COMPONENT_SPECS_FILE,
+  au as DEFAULT_GOVERNANCE,
+  av as DEFAULT_OVERRIDE,
+  aw as DEFAULT_PRODUCTS,
   DEFAULT_PROTECTED_BRANCHES,
-  aq as DEFAULT_RIGHTS,
+  ax as DEFAULT_RIGHTS,
   DEFAULT_TOKEN_PATHS,
-  ar as DEFAULT_VISUAL_IMPACT,
+  ay as DEFAULT_VISUAL_IMPACT,
   DEMO_RELEASES,
   DOCS_CHANGE_BUMP,
   DOCS_DRAFT_MODEL,
+  DOCS_EDITOR_ORIGIN,
   DOCS_KEYS,
+  DOCS_MCP_ORIGIN,
   DOCS_SELECTION_MODES,
   DRAFTS_DIR,
   DRAFT_EXCHANGE_VERSION,
@@ -3835,121 +4909,157 @@ export {
   EXPLORATION_USE_CASES,
   EXT_ID,
   EXT_SCOPES,
+  FIDELITY_DEFAULTS,
+  FIGMA_FILL_WIDTH_TOKEN,
+  FIGMA_REFERENCES_BRANCH,
+  FIGMA_REFERENCES_DIR,
+  FIGMA_REFERENCES_MANIFEST,
+  FIGMA_REFERENCE_STORY,
   GitHubClient,
   GitHubError,
-  as as JsonParseError,
+  az as JsonParseError,
   LIGHTNESS,
   LayeredTokenSet,
+  MAX_TOGETHER,
+  MIN_TOGETHER,
   NEUTRAL_ANCHORS,
-  at as OWNER_GROUPS,
+  OVERRIDE_HEADING,
+  aA as OWNER_GROUPS,
+  OverrideMergeError,
   PIN_TOLERANCE,
-  au as PREVIEW_APP_LABELS,
-  av as PREVIEW_COMMENT_MARKER,
-  aw as PREVIEW_PLACEHOLDERS,
-  ax as PRIMITIVE_MODE,
+  aB as PREVIEW_APP_LABELS,
+  aC as PREVIEW_COMMENT_MARKER,
+  aD as PREVIEW_PLACEHOLDERS,
+  aE as PRIMITIVE_MODE,
+  aF as PRODUCT_LABEL_PREFIX,
   PROSE_KEYS,
   PROTECTION_PARTS,
   PROTECTION_PART_PHRASE,
+  PULL_STATE_PILL,
   ProtectedBranchError,
   RADIUS_PRESETS,
+  aG as REDUCED_MOTION_NOTE,
   REQUESTS_BRANCH,
   REQUEST_KINDS,
   REQUEST_LABEL,
   REQUEST_STATUS_LABEL,
-  ay as RIGHTS,
-  az as RIGHT_LABEL,
+  REVIEW_STATUS_ORDER,
+  aH as RIGHTS,
+  aI as RIGHT_LABEL,
   RISK_LABELS,
-  aA as RISK_TIER,
+  aJ as RISK_TIER,
+  SHARE_EXPLAIN,
   SIMILARITY_THRESHOLD,
   SINGLE_MODE,
-  aB as SPEC_FIELDS,
+  aK as SPEC_FIELDS,
   STEPS,
   TIER_AXIS,
   TIER_NAMES,
-  aC as TIER_ORDER,
+  aL as TIER_ORDER,
   TOKEN_REJECTED_MESSAGE,
   TOKEN_SETTINGS_URL,
-  aD as TeamDirectory,
-  aE as UNRELEASED,
-  aF as VISUAL_CHECK_LABEL,
+  aM as TRIGGER_LABELS,
+  aN as TeamDirectory,
+  aO as UNRELEASED,
+  aP as VISUAL_CHECK_LABEL,
   acceptDocsDraft,
   acceptDocsText,
   addBrandToConfigText,
-  aG as affectedContrast,
+  addedComment,
+  aQ as affectedContrast,
   d as aliasOf,
   aliasTarget,
+  allowedMergeMethods,
   anatomyLabel,
   anchoredRamp,
   anthropicReplyText,
   anthropicRequest,
-  aH as appForProject,
-  aI as appUrl,
+  aR as appForProject,
+  aS as appUrl,
   applyConfirmedRenames,
   applyDocsSections,
   applyTokenEdits,
   applyTokenMerge,
-  aJ as approverEntries,
-  aK as approverLists,
+  aT as approverEntries,
+  aU as approverLists,
+  askOthersToReviewOnGitHub,
   assertSafeBranch,
   assignRequestOnGitHub,
-  aL as assignVersions,
+  aV as assignVersions,
   base64ToUtf8,
-  aM as baseBranchOf,
+  aW as baseBranchOf,
   bellChroma,
-  aN as branchName,
+  aX as branchName,
   branchPreviewUrls,
-  aO as branchSlug,
+  aY as branchSlug,
+  branchWithJiraKey,
   brandDisplayName,
   brandPreviewVariables,
+  buildFidelityReport,
   buildHistoryEntry,
   buildReport,
-  i as buildTokenSet,
+  buildTokenSet,
   buildUsageIndex,
-  aP as canShip,
+  canAddTo,
+  canOverride,
+  canShare,
+  canShip,
   changeEdits,
-  aQ as changeKind,
-  aR as changeTable,
-  aS as changedModes,
-  aT as changesetBump,
+  aZ as changeKind,
+  changeList,
+  a_ as changeTable,
+  a$ as changedModes,
+  b0 as changesetBump,
   checkBrandSlug,
   checkLayeredPair,
   choiceFor,
   classifyAuth,
-  aU as classifyLayered,
+  b1 as classifyLayered,
   classifyRisk,
+  cleanDocs,
   cleanDocsText,
   cleanDraftText,
-  aV as clearRawDeep,
+  b2 as clearRawDeep,
   closeExplorationOnGitHub,
+  closeOnGitHub,
   closingIssueNumbers,
   coerceValue,
   collectHistory,
   collectRefs,
+  colorDelta,
   k2 as colorToCss,
   l as colorsEqual,
   combineChanges,
   combineConflicts,
   c as comboKey,
-  aW as commitMessage,
+  commentOnGitHub,
+  commitFileOnGitHub,
+  commitLibraryResolution,
+  b3 as commitMessage,
   m as compactJson,
+  compareImages,
   componentForPath,
-  aX as composeChangeset,
+  b4 as componentMotion,
+  b5 as componentsUsingMotionToken,
+  b6 as composeChangeset,
   composeFiles,
   composeNewBrandBody,
   composePendingDrafts,
-  aY as composePrBody,
-  aZ as composeProposalBody,
+  b7 as composePrBody,
+  b8 as composeProposalBody,
   composeRequestIssue,
-  a_ as composite,
-  a$ as contextFor,
+  b9 as composite,
+  conflictRoute,
+  ba as contextFor,
   contextLabel,
-  b0 as contrastDelta,
-  b1 as contrastDeltaTable,
-  b2 as contrastLevel,
-  b3 as contrastPair,
-  b4 as contrastRatio,
+  bb as contrastDelta,
+  bc as contrastDeltaTable,
+  bd as contrastLevel,
+  be as contrastPair,
+  bf as contrastRatio,
   contrastScope,
-  b5 as countChanges,
+  bg as countChanges,
+  bh as coverageSummary,
   createDocsDraftSession,
   createPendingDrafts,
   cssModuleClasses,
@@ -3961,22 +5071,27 @@ export {
   declineRequestOnGitHub,
   decodePicks,
   defaultChoiceFor,
-  b6 as defaultContext,
+  k as defaultContext,
   defaultFile,
+  bi as defaultProduct,
   defaultScopes,
-  b7 as defaultTitle,
-  b8 as defineConfig,
+  bj as defaultTitle,
+  bk as defineConfig,
   deletePendingDrafts,
   demoHistory,
-  b9 as detectLayout,
-  ba as diffLayered,
+  bl as detectLayout,
+  bm as diffLayered,
+  dismissStaleFrom,
+  docsFileText,
   docsPrompt,
+  docsProposal,
   docsSectionShapes,
   docsSectionsAnswer,
   docsSectionsResult,
   docsSelectionPrompt,
   docsTaskKeys,
   docsTaskPrompt,
+  docsText,
   draftChangeLine,
   draftImagePath,
   draftItemBrief,
@@ -3985,14 +5100,16 @@ export {
   draftSessionPath,
   dtcgColor,
   effectiveScopes,
+  effectiveTier,
+  eligibleReviewers,
   emptyTokenFile,
   encodePicks,
   ensureRequestsBranch,
-  bb as entriesFor,
-  bc as entryLabel,
+  bn as entriesFor,
+  bo as entryLabel,
   evaluatePairs,
-  bd as expandEntries,
-  be as expandOwners,
+  bp as expandEntries,
+  bq as expandOwners,
   explorationBranch,
   explorationNote,
   explorationNotePath,
@@ -4008,63 +5125,73 @@ export {
   explorationTestBuildOnGitHub,
   explorationTryIt,
   explorationTryItOnGitHub,
-  bf as fieldChanges,
-  bg as fileModes,
-  bh as filterHistory,
+  fidelityComponentLine,
+  fidelityVerdict,
+  br as fieldChanges,
+  bs as figmaCell,
+  bt as fileModes,
+  bu as filterHistory,
   findExplorationOnGitHub,
   findPreviewComment,
+  bv as findProduct,
   findReferenceProblems,
-  bi as findToken,
-  bj as findVercelComment,
-  bk as firstParagraph,
+  bw as findToken,
+  bx as findVercelComment,
+  by as firstParagraph,
   n as flattenLayerFile,
   flattenTokens,
   formatChangeset,
   formatDocsJson,
-  bl as formatNumber,
-  bm as formatOwnerEntry,
+  bz as formatNumber,
+  bA as formatOwnerEntry,
   formatValue,
+  freshness,
   friendlyMessage,
   fromHex,
   fromPlain,
   generateRamp,
-  bn as getChild,
+  bB as getChild,
   getEntry,
   gitHubHistoryBackend,
-  g2 as globToRegExp,
-  bo as groupsPhrase,
+  g as globToRegExp,
+  bC as groupsPhrase,
+  hasWriteAccess,
   h as hashSpec,
   h2 as hexToRgba,
-  bp as holdersOf,
-  j as iconComponentName,
+  bD as holdersOf,
+  i as iconComponentName,
   idExtensionFor,
   impactedModules,
   importsIn,
-  bq as indexByPath,
-  br as inheritedTypeAt,
-  bs as installCommand,
-  bt as installCommandFromPreviewComment,
+  bE as indexByPath,
+  bF as inheritedTypeAt,
+  bG as installCommand,
+  bH as installCommandFromPreviewComment,
   isActiveExploration,
   isAlias,
+  isAutomationPull,
   isDocsSelectionMode,
   isDraftSessionId,
   isExplorationBranch,
   isExplorationPull,
-  bu as isGuardrail,
+  bI as isGuardrail,
   isHex,
+  isJiraKey,
   isMissingPermission,
   isMultiMode,
   isPlanRefusal,
   isProseKey,
-  bv as isTeamEntry,
-  bw as isTokenFile,
+  isReleasePull,
+  bJ as isTeamEntry,
+  bK as isTokenFile,
   isTokenRejected,
-  bx as isVercelComment,
+  bL as isVercelComment,
   jiraIssueFields,
-  by as kindForMin,
-  bz as layeredImpact,
-  o as layeredParityIssues,
-  g as layoutOptions,
+  jiraKeyOf,
+  bM as kindForMin,
+  bN as layeredImpact,
+  o2 as layeredParityIssues,
+  layoutOptions,
   levenshtein,
   linkRequestToExplorationOnGitHub,
   listBrands,
@@ -4075,17 +5202,20 @@ export {
   loadProtection,
   loadRepoFiles,
   loadRequiredChecks,
-  bA as luminance,
+  bO as luminance,
+  mailtoHref,
   markClaudeDraft,
   mergeDocsDraft,
   mergeDraftResults,
+  mergeGate,
+  mergeOnGitHub,
   mergeReleases,
   missingChoices,
   missingPermissionMessage,
   missingProse,
   modeDisplayName,
   modeFile,
-  bB as modeLabel,
+  bP as modeLabel,
   modesOf$1 as modesOf,
   moveToken,
   nearestStep,
@@ -4094,88 +5224,124 @@ export {
   neutralOffset,
   newBrandSection,
   newDraftSessionId,
-  bC as nodesEqual,
-  bD as normalizeRights,
+  bQ as nodesEqual,
+  bR as normalizeRights,
   oklch,
   oklchToLinear,
-  bE as overrideKey,
-  bF as ownerEntryProblems,
+  onlyTokens,
+  openPulls,
+  overlap,
+  overrideComment,
+  bS as overrideKey,
+  overrideMergeOnGitHub,
+  overrideReasonProblem,
+  overrideRefusedComment,
+  bT as ownerEntryProblems,
+  packageDir,
   packageDirCandidates,
-  bG as pairKey,
+  bU as pairKey,
   parseChangelog,
-  bH as parseChangesetText,
+  bV as parseChangesetText,
   parseColor,
-  bI as parseComponentSpecs,
+  bW as parseComponentSpecs,
   parseContrastChecks,
-  q as parseDimension,
+  q2 as parseDimension,
   parseDocsReply,
   parseDocsTaskAnswer,
   parseExplorationBody,
+  parseJiraKey,
   parseJson,
-  bJ as parseOwnerEntry,
+  parseOverrideComment,
+  bX as parseOwnerEntry,
   parsePendingDrafts,
   parseRepo,
   parseRequestIssue,
   parseStructureChange,
+  parseTier,
   parseTokenFile,
-  bK as parseVercelComment,
+  bY as parseVercelComment,
   patchDocsJson,
   pathId,
   pathSimilarity,
+  pendingApprovals,
   permissionLabel,
   pickedOption,
   plainEqual,
   planNewBrand,
-  bL as planRestore,
-  bM as planRevert,
-  bN as planToJson,
+  planReference,
+  planReferences,
+  bZ as planRestore,
+  b_ as planRevert,
+  b$ as planToJson,
   planTokenMerge,
   e as prNumberFromSubject,
   prefillDocs,
-  bO as previewComment,
+  c0 as previewComment,
   previewLinks,
-  bP as previewLinksOf,
+  c1 as previewLinksOf,
   previewOverrides,
-  bQ as previewUrl,
+  c2 as previewUrl,
   previewsSettled,
-  bR as projectOfLabel,
+  c3 as productForPlace,
+  c4 as productLabel,
+  c5 as productOfBranch,
+  productPreview,
+  c6 as productProblems,
+  c7 as productsOf,
+  c8 as projectOfLabel,
   promoteExplorationOnGitHub,
   promotionPlan,
+  proposeDocsOnGitHub,
   propsTable,
   protectLibrary,
   protectRefusal,
-  bS as protectedBranchesOf,
+  c9 as protectedBranchesOf,
   protectionRuleset,
   protectionRulesetName,
   protectionSentence,
   protectionState,
+  pullState,
   pushChangeRows,
   rateLimitMessage,
+  readCombineBranch,
+  readLibraryConflicts,
   readPendingDrafts,
   readPreviewComment,
   readTokenAt,
   reconcileIds,
+  referenceImagePath,
+  releasePull,
   releasesFromTags,
   removeToken,
   removedSide,
-  bT as renderedColor,
+  ca as renderedColor,
+  reopenEligibility,
+  reopenOnGitHub,
   requestBrief,
   requestImagePath,
   requestIssueTitle,
   requestStatus,
+  requiredApprovals,
   requiredCheckNames,
   requiredPermission,
+  resolutionMessage,
   resolve,
   resolveBranchPreviews,
+  resolvedTokenFiles,
+  reviewOnGitHub,
+  reviewQueue,
+  reviewStatusKind,
+  reviewersToAsk,
   r as rgbaToDtcg,
   rgbaToHex,
-  bU as rightsProblems,
+  cb as rightsProblems,
   round3,
   rulesSettingsUrl,
   rulesetTargetsDefault,
-  bV as runLayeredContrast,
+  cc as runLayeredContrast,
+  cd as sameProducts,
   sameScopes,
-  bW as sameToken,
+  ce as sameToken,
   sanitizeDocsReplacement,
   sanitizeDocsResult,
   sanitizeDocsSections,
@@ -4189,58 +5355,75 @@ export {
   serializePendingDrafts,
   serializeTokenFile,
   shadowedEdits,
-  bX as shipPolicy,
+  shareDescription,
+  shareMessage,
+  shareState,
+  cf as shipPolicy,
   shortVariant,
   shortVariants,
+  showShare,
   slugify,
-  bY as snapshotUrl,
-  bZ as specHash,
+  cg as snapshotUrl,
+  s as specHash,
+  stableCommand,
   startExplorationOnGitHub,
-  b_ as summarizeTokenChange,
+  stateSentence,
+  summarizeApprovals,
+  summarizeCi,
+  summarizeComponent,
+  ch as summarizeTokenChange,
   takeMine,
-  b$ as tarballAssetName,
-  c0 as tarballUrl,
-  c1 as teamKey,
-  c2 as teamKeyOf,
-  c3 as teamUnreadableMessage,
-  c4 as teamsIn,
+  ci as tarballAssetName,
+  cj as tarballUrl,
+  ck as teamKey,
+  cl as teamKeyOf,
+  cm as teamUnreadableMessage,
+  cn as teamsIn,
   threeWayDiff,
   tintedNeutral,
-  c5 as titleOf,
+  co as titleOf,
+  titleWithJiraKey,
   t2 as toAlias,
-  c6 as toChangeSummary,
+  cp as toChangeSummary,
   toConfigJson,
   toHex,
-  c7 as toMap,
+  cq as toMap,
   toOklch,
   toPlain,
-  c8 as tokenBump,
+  cr as tokenBump,
   t as tokenCssVar,
-  c9 as tokenHistory,
-  ca as tokenNode,
+  tokenFilesOf,
+  cs as tokenHistory,
+  ct as tokenNode,
   tokenUsage,
   tokensPath,
+  touchesPackages,
+  tryInProductUrl,
+  tryTogetherUrl,
   unpicked,
-  cb as unreadableShipTeams,
-  cc as unreadableTeams,
+  unreadableShipTeams,
+  cu as unreadableTeams,
   updatePendingDrafts,
   upsertToken,
   utf8ToBase64,
+  v as validateComponentSpec,
+  validateDocs,
   validateDocsTask,
   validateIntegrations,
   validateLayered,
   validatePendingDrafts,
   validateProposal,
   validateSet,
-  cd as valueIn,
+  cv as valueIn,
   u as valueToCss,
   valuesEqual,
-  v as variantKeyOf,
-  ce as variantName,
-  cf as versionTimeline,
-  cg as visualImpactProblems,
-  ch as whoCanShipSentence,
+  variantKeyOf,
+  cw as variantName,
+  cx as versionTimeline,
+  cy as visualImpactProblems,
+  whoCanShipSentence,
   withRequestExploration,
+  withoutJiraKey,
   writeDraftResults
 };
 //# sourceMappingURL=index.js.map