@bridge-ds/core 0.18.0 → 0.20.0

package/dist/{repo-source-CRfhLO87.js → repo-source-CshjjC7x.js}

@@ -1,4 +1,4 @@
-import { cn as tokenBump, aU as changeKind, L as LayeredTokenSet, aL as aliasOf, c1 as rgbaToDtcg, bq as hexToRgba, w as parseTokenFile, q as emptyTokenFile, s as serializeTokenFile, C as moveToken, r as removeToken, bt as inheritedTypeAt, u as upsertToken, H as readTokenAt, a_ as comboKey, c0 as renderedColor, b6 as contrastRatio, z as rgbaToHex, U as classifyRisk, W as RISK_LABELS, V as CONFIG_FILE, N as loadConfig, ah as ConfigError, _ as DEFAULT_TOKEN_PATHS, ag as globToRegExp, ae as slugify, Q as validateLayered, bM as parseJson, c5 as serializeJson, bR as plainEqual, cm as toPlain, bn as getEntry, bl as fromPlain, m as modeDisplayName, A as formatValue, X as previewLinks, a1 as readPreviewComment, aT as canShip, cv as whoCanShipSentence, cp as unreadableShipTeams, c8 as soloApprover, aP as approverLists, O as tokensPath, a6 as NEEDED_BY_LABEL, K as selectTokenFiles, R as parseContrastChecks } from "./prod-branch-DenQkr_e.js";
+import { cr as tokenBump, aW as changeKind, L as LayeredTokenSet, aO as aliasOf, c4 as rgbaToDtcg, bu as hexToRgba, w as parseTokenFile, q as emptyTokenFile, s as serializeTokenFile, C as moveToken, r as removeToken, bx as inheritedTypeAt, u as upsertToken, H as readTokenAt, b0 as comboKey, c3 as renderedColor, b8 as contrastRatio, z as rgbaToHex, U as classifyRisk, bh as figmaPushNextLine, W as RISK_LABELS, bi as figmaPushTierLabel, V as CONFIG_FILE, N as loadConfig, ai as ConfigError, $ as DEFAULT_TOKEN_PATHS, ah as globToRegExp, af as slugify, Q as validateLayered, bP as parseJson, c8 as serializeJson, bU as plainEqual, cq as toPlain, br as getEntry, bp as fromPlain, m as modeDisplayName, A as formatValue, X as previewLinks, a2 as readPreviewComment, aV as canShip, cz as whoCanShipSentence, ct as unreadableShipTeams, cb as soloApprover, aS as approverLists, O as tokensPath, a7 as NEEDED_BY_LABEL, K as selectTokenFiles, R as parseContrastChecks } from "./prod-branch-CJZwMfVD.js";
 function changesetBump(changes) {
   return tokenBump(changes) ?? "patch";
 }
@@ -177,9 +177,9 @@ function checkLayeredPair(set, pair, combo) {
   const ratio = Math.round(contrastRatio(fc, bc) * 100) / 100;
   return { ...base, ratio, pass: ratio >= pair.min, fgValue: rgbaToHex(fc), bgValue: rgbaToHex(bc), ...fc.a < 1 ? { note: "foreground alpha composited over background" } : {} };
 }
-function runLayeredContrast(set, pairs, modes) {
+function runLayeredContrast(set, pairs2, modes) {
   const combos = set.combos(modes ?? set.config.contrast?.modes);
-  return combos.flatMap((c) => pairs.map((p) => checkLayeredPair(set, p, c)));
+  return combos.flatMap((c) => pairs2.map((p) => checkLayeredPair(set, p, c)));
 }
 function contrastDelta(before, after) {
   const key = (r) => `${r.fg}|${r.bg}|${r.modes}`;
@@ -295,14 +295,15 @@ _${deltas.length - limit} more pair(s) not shown._` : "";
 }
 function composeProposalBody(args) {
   const t = args.tier.tier;
-  const box = (n) => `- ${n === t ? "[x]" : "[ ]"} ${RISK_LABELS[n]}`;
+  const figma = Boolean(args.fromFigma);
+  const box = (n) => `- ${n === t ? "[x]" : "[ ]"} ${figma && n === t ? figmaPushTierLabel(n, args.changes) : RISK_LABELS[n]}`;
   const impactList = args.impact.entries.slice(0, 15).map((e) => `- \`${e.path}\`: ${swatch(e.before)} -> ${swatch(e.after)} (${e.modes.length} mode${e.modes.length > 1 ? "s" : ""})`);
   return [
     "## What changed and why",
     "",
     args.summary.trim(),
     "",
-    `Proposed through ${args.tool ?? "Bridge MCP"}${args.author ? ` by ${args.author}` : ""}. Agent-authored: a human design owner and tech owner review and merge.`,
+    figma ? `Pushed from Figma through ${args.tool ?? "the Bridge Figma plugin"}${args.author ? ` by ${args.author}` : ""}. ${figmaPushNextLine(args.changes)}` : `Proposed through ${args.tool ?? "Bridge MCP"}${args.author ? ` by ${args.author}` : ""}. Agent-authored: a human design owner and tech owner review and merge.`,
     "",
     "## Risk tier",
     "",
@@ -332,8 +333,8 @@ function composeProposalBody(args) {
     "",
     "## Authored by",
     "",
-    "- [ ] Human",
-    "- [x] AI agent (Claude), reviewed by a human before merge",
+    `- [${figma ? "x" : " "}] Human`,
+    `- [${figma ? " " : "x"}] AI agent (Claude), reviewed by a human before merge`,
     "",
     "## Design review checklist",
     "",
@@ -368,6 +369,7 @@ class GitHubError extends Error {
     this.name = "GitHubError";
     this.auth = info.auth;
     this.permission = info.permission;
+    this.resetsAt = info.resetsAt;
   }
   status;
   detail;
@@ -375,6 +377,8 @@ class GitHubError extends Error {
   auth;
   /** With auth "missing-permission": the permission the call needed, when known. */
   permission;
+  /** For a rate limit (status 429): when the limit resets, when known. */
+  resetsAt;
 }
 const isTokenRejected = (err) => err instanceof GitHubError && err.auth === "rejected";
 const isMissingPermission = (err) => err instanceof GitHubError && err.auth === "missing-permission";
@@ -656,7 +660,7 @@ class GitHubClient {
           return copy(cached.body);
         }
         const resetsAt = reset ? new Date(Number(reset) * 1e3) : void 0;
-        const limited = new GitHubError(429, rateLimitMessage({ withToken: Boolean(this.token), resetsAt, tokenHint: this.options.tokenHint }), detail);
+        const limited = new GitHubError(429, rateLimitMessage({ withToken: Boolean(this.token), resetsAt, tokenHint: this.options.tokenHint }), detail, { resetsAt });
         hourlyLimitErrors.add(limited);
         throw limited;
       }
@@ -693,6 +697,31 @@ class GitHubClient {
     );
     return { fullName: r.full_name, defaultBranch: r.default_branch, private: r.private, permissions: r.permissions };
   }
+  /**
+   * What the token may write here, found without writing anything: each probe is invalid on purpose (a zero sha, a
+   * missing head branch, an empty title), so GitHub answers 422 when the token has the permission and 403 or 404 when
+   * it does not. repo.permissions.push says what the user may do, not what a fine-grained token may do.
+   */
+  async writeAccess(base) {
+    this.assertToken("Checking the token");
+    const probe = async (path, body) => {
+      try {
+        await this.request("POST", `${this.repoPath}${path}`, body);
+        return true;
+      } catch (err) {
+        if (!(err instanceof GitHubError)) throw err;
+        if (err.status === 422) return true;
+        if (err.auth === "missing-permission" || err.status === 404 || err.status === 410) return false;
+        throw err;
+      }
+    };
+    const [contents, pullRequests, issues] = await Promise.all([
+      probe("/git/refs", { ref: "refs/heads/bridge-permission-probe", sha: "0".repeat(40) }),
+      probe("/pulls", { title: "Bridge permission probe", head: "bridge-permission-probe-missing-branch", base }),
+      probe("/issues", { title: "" })
+    ]);
+    return { contents, pullRequests, issues };
+  }
   /** Commit sha a branch points to, or undefined when the branch does not exist. */
   async getBranchSha(branch) {
     try {
@@ -703,6 +732,14 @@ class GitHubClient {
       throw err;
     }
   }
+  /**
+   * Whether a branch exists, through the matching-refs list: it answers 200 with an empty list when the branch is
+   * missing, so asking never leaves a 404 in the browser console (an optional branch like bridge-data).
+   */
+  async hasBranch(branch) {
+    const refs = await this.request("GET", `${this.repoPath}/git/matching-refs/heads/${encodeRef(branch)}`);
+    return Array.isArray(refs) && refs.some((r) => r.ref === `refs/heads/${branch}`);
+  }
   async getCommitTree(commitSha) {
     const r = await this.request("GET", `${this.repoPath}/git/commits/${commitSha}`);
     return r.tree.sha;
@@ -989,6 +1026,7 @@ class GitHubClient {
       const q = ref ? `?ref=${encodeURIComponent(ref)}` : "";
       const r = await this.request("GET", `${this.repoPath}/contents/${encodeRef(path)}${q}`);
       if (r.type !== "file") return void 0;
+      if (r.encoding === "none" || !r.content && (r.size ?? 0) > 0) return await this.request("GET", `${this.repoPath}/contents/${encodeRef(path)}${q}`, void 0, true, { accept: ACCEPT_RAW, text: true });
       if (r.encoding === "base64" && r.content !== void 0) return base64ToUtf8(r.content);
       return r.content;
     } catch (err) {
@@ -1208,7 +1246,7 @@ class GitHubClient {
   }
   async getPullRequest(n) {
     const r = await this.request("GET", `${this.repoPath}/pulls/${n}`);
-    return { ...toSummary(r), body: r.body ?? "", mergeable: r.mergeable ?? null, requestedReviewers: (r.requested_reviewers ?? []).map((x) => x.login) };
+    return { ...toSummary(r), body: r.body ?? "", mergeable: r.mergeable ?? null, requestedReviewers: (r.requested_reviewers ?? []).map((x) => x.login), autoMerge: Boolean(r.auto_merge) };
   }
   async listPullRequestFiles(n) {
     const r = await this.request("GET", `${this.repoPath}/pulls/${n}/files?per_page=100`);
@@ -1219,7 +1257,7 @@ class GitHubClient {
   }
   async listReviews(n) {
     const r = await this.request("GET", `${this.repoPath}/pulls/${n}/reviews`);
-    return r.map((x) => ({ id: x.id, user: x.user?.login, state: x.state, body: x.body ?? "", ...x.submitted_at ? { submittedAt: x.submitted_at } : {} }));
+    return r.map((x) => ({ id: x.id, user: x.user?.login, state: x.state, body: x.body ?? "", ...x.submitted_at ? { submittedAt: x.submitted_at } : {}, ...x.commit_id ? { commitId: x.commit_id } : {} }));
   }
   /** Submit a review. `COMMENT` works for any collaborator; approving your own PR is refused by GitHub. */
   async createReview(n, input) {
@@ -1413,7 +1451,10 @@ function toSummary(r) {
     labels: (r.labels ?? []).map((l) => l.name),
     url: r.html_url,
     updatedAt: r.updated_at,
-    ...typeof r.body === "string" ? { body: r.body } : {}
+    ...typeof r.body === "string" ? { body: r.body } : {},
+    ...r.created_at ? { createdAt: r.created_at } : {},
+    ...r.merged_at ? { mergedAt: r.merged_at } : {},
+    ...r.assignees?.length ? { assignees: r.assignees.map((a) => a.login ?? "").filter(Boolean) } : {}
   };
 }
 function friendlyMessage(status, detail, info = {}) {
@@ -1490,9 +1531,37 @@ function toIssue(r) {
     labels: r.labels.map((l) => typeof l === "string" ? l : l.name ?? "").filter(Boolean),
     author: r.user?.login ?? "",
     createdAt: r.created_at,
-    updatedAt: r.updated_at
+    updatedAt: r.updated_at,
+    ...r.assignees?.length ? { assignees: r.assignees.map((a) => a.login ?? "").filter(Boolean) } : {},
+    ...r.closed_at ? { closedAt: r.closed_at } : {}
   };
 }
+const FORMER_MEMBER = "A former member";
+const requesterFirstName = (name) => name.trim() === FORMER_MEMBER ? FORMER_MEMBER : name.trim().split(/\s+/)[0] ?? name;
+const LOGIN = /^[A-Za-z0-9](?:[A-Za-z0-9-]{0,38})$/;
+const LINE = /(?:^|\n)[ \t>*_-]*(?:<sub>)?\s*Requested (?:from [^\n<]{1,40}? )?by ([^\n<]{1,120}?)(?:\s+with Bridge)?\.?\s*(?:<\/sub>)?[ \t]*(?=\n|$)/i;
+const SUGGESTED = new RegExp(LINE.source.replace("Requested (?:from", "Suggested (?:from"), "i");
+function requesterOf(body) {
+  const m = LINE.exec(body ?? "") ?? SUGGESTED.exec(body ?? "");
+  if (!m) return null;
+  const who = m[1].trim().replace(/\.$/, "").replace(/\s+through Bridge$/i, "").replace(/\s*\([^()\s@]+@[^()\s]+\)$/, "");
+  const both = /^(.+?)\s*\(@([^)\s]+)\)$/.exec(who);
+  if (both) return LOGIN.test(both[2]) ? { name: both[1].trim(), login: both[2] } : null;
+  if (who.startsWith("@")) return LOGIN.test(who.slice(1)) ? { name: null, login: who.slice(1) } : null;
+  return /^[\p{L}][\p{L}'’. -]{0,60}$/u.test(who) && who.split(/\s+/).length <= 5 ? { name: who, login: null } : null;
+}
+function requesterLine(r) {
+  const name = r.name?.trim();
+  const login = r.login?.replace(/^@/, "").trim();
+  if (name && login) return `Requested by ${name} (@${login}).`;
+  if (login) return `Requested by @${login}.`;
+  if (name) return `Requested by ${name}.`;
+  throw new Error("A requester needs a name or a login.");
+}
+function requesterName(body) {
+  const r = requesterOf(body);
+  return r ? r.name ?? r.login : null;
+}
 const BULK_LIMIT = 60;
 const UNRELEASED = "Unreleased";
 const SUBJECT_PR = [/^Merge pull request #(\d+)/, /\(#(\d+)\)\s*$/];
@@ -1557,7 +1626,9 @@ function buildHistoryEntry(input) {
     sha: commit.sha,
     ...commit.parents[0] ? { baseSha: commit.parents[0] } : {},
     date: commit.date,
-    author: commit.pr?.author ?? commit.author,
+    // Who asked, as Bridge recorded it in the pull request ("Requested by Priya Shah ... through Bridge."), before the
+    // account that opened it (the Bridge app for an email member, an agent): History names the person.
+    author: requesterName(commit.pr?.body) ?? commit.pr?.author ?? commit.author,
     title,
     why,
     ...pr ? { pr } : {},
@@ -1910,9 +1981,9 @@ function finishPlan(p) {
   if (!changes.length) return nothing("The edits leave every token as it is now.");
   const prev = new Set(validateLayered(current).map(issueKey));
   const newErrors = validateLayered(after).filter((i) => i.level === "error" && !prev.has(issueKey(i)));
-  const pairs = p.pairs ?? [];
+  const pairs2 = p.pairs ?? [];
   const modes = config.contrast?.modes;
-  const contrast = pairs.length ? contrastDelta(runLayeredContrast(current, pairs, modes), runLayeredContrast(after, pairs, modes)) : [];
+  const contrast = pairs2.length ? contrastDelta(runLayeredContrast(current, pairs2, modes), runLayeredContrast(after, pairs2, modes)) : [];
   const newFailures = contrast.filter((d) => d.passBefore && !d.passAfter);
   const tier = classifyLayered(changes, [], config);
   const impact = layeredImpact(current, after, changes);
@@ -2177,11 +2248,11 @@ function propShape(s) {
 }
 const VARIANT_FIRST = ["variant", "tone", "intent", "appearance", "kind", "type", "style"];
 function shortVariant(key) {
-  const pairs = key.split(", ").map((p) => {
+  const pairs2 = key.split(", ").map((p) => {
     const at = p.indexOf("=");
     return at < 0 ? { k: "", v: p.trim() } : { k: p.slice(0, at).trim(), v: p.slice(at + 1).trim() };
   });
-  const kept = pairs.filter((p) => p.v && !/^default$/i.test(p.v));
+  const kept = pairs2.filter((p) => p.v && !/^default$/i.test(p.v));
   if (!kept.length) return key;
   const rank = (k) => {
     const i = VARIANT_FIRST.indexOf(k.toLowerCase());
@@ -2222,6 +2293,14 @@ function firstChange(component, kind, c, all) {
     }
     case "new-variant": {
       if (!c) return { title: `Update the ${component} variants`, summary: `The variants of ${component} changed in Figma.` };
+      if (c.field === "Variants") {
+        const gone = (c.before ?? "").split("; ").filter(Boolean);
+        const born = (c.after ?? "").split("; ").filter(Boolean);
+        if (gone.length === 1 && !born.length) return { title: `Remove the ${shortVariant(gone[0])} variant`, summary: `${component} no longer has the ${shortVariant(gone[0])} variant (${gone[0]}).` };
+        if (born.length === 1 && !gone.length) return { title: `Add the ${shortVariant(born[0])} variant`, summary: `${component} gets a new variant, ${shortVariant(born[0])} (${born[0]}).` };
+        const parts = [born.length ? `gets ${plural(born.length, "new variant")}: ${andList(born.map(shortVariant))}` : "", gone.length ? `no longer has ${andList(gone.map(shortVariant))}` : ""].filter(Boolean);
+        return { title: `Update the ${component} variants`, summary: `${component} ${parts.join(", and ")}.` };
+      }
       const axis = c.field.replace(/^Variant /, "");
       const before = values(c.before);
       const after = values(c.after);
@@ -2250,7 +2329,7 @@ function firstChange(component, kind, c, all) {
       if (!c) return { title: "Use another token", summary: `A part of ${component} uses another token in Figma.` };
       const m = /^(.*?)(?: \((.*)\))?$/.exec(c.field);
       const part = lower(m[1]);
-      const where2 = m[2] ? ` in ${m[2]}` : "";
+      const where2 = m[2] ? ` in ${shortVariants(m[2])}` : "";
       const after = c.after && c.after !== "none" ? c.after : "";
       const before = c.before && c.before !== "none" ? c.before : "";
       if (!after) return { title: `Unbind the ${part}`, summary: `The ${part} of ${component}${where2} no longer uses ${before || "a token"}.` };
@@ -2300,6 +2379,11 @@ function sanitizeDraftLine(raw) {
 }
 function changePhrase(c) {
   let m;
+  if (c.field === "Variants") {
+    const gone = (c.before ?? "").split("; ").filter(Boolean).map(shortVariant);
+    const born = (c.after ?? "").split("; ").filter(Boolean).map(shortVariant);
+    return [born.length ? `New variant${born.length === 1 ? "" : "s"} ${andList(born)}` : "", gone.length ? `${andList(gone)} variant${gone.length === 1 ? "" : "s"} removed` : ""].filter(Boolean).join("; ");
+  }
   if (m = /^Variant (.+)$/.exec(c.field)) {
     const axis = m[1];
     const before2 = values(c.before);
@@ -2325,7 +2409,7 @@ function changePhrase(c) {
   const layer = parseStructureChange(c);
   if (layer) return structurePhrase(layer);
   m = /^(.*?)(?: \((.*)\))?$/.exec(c.field);
-  const where2 = m[2] ? ` in ${m[2]}` : "";
+  const where2 = m[2] ? ` in ${shortVariants(m[2])}` : "";
   const before = c.before && c.before !== "none" ? c.before : "";
   const after = c.after && c.after !== "none" ? c.after : "";
   if (!after) return `${m[1]} no longer uses ${before || "a token"}${where2}`;
@@ -2403,10 +2487,10 @@ const EXPLORATION_NOTES_DIR = ".bridge/explorations";
 const EXPLORATION_TIER_LABEL = "Exploration (not mergeable)";
 const EXPLORATION_CHECK = "Exploration not merged as is";
 const EXPLORATION_USE_CASES = [
-  { value: "user-test", label: "Prototype for a user test", hint: "A coded prototype on a product staging branch, with the real components and tokens." },
-  { value: "stakeholder-demo", label: "Stakeholder demo", hint: "Show an idea on real screens before anyone commits to it." },
-  { value: "ab-idea", label: "A/B idea", hint: "Ship a variant to a staging or experiment branch and compare it with what is live." },
-  { value: "terminal", label: "Exploring with Claude Code", hint: "A designer works from the terminal with Claude and the Bridge MCP server on this branch, never on main." },
+  { value: "user-test", label: "Prototype for a user test", hint: "A coded prototype in a test version of a product, with the real components and tokens." },
+  { value: "stakeholder-demo", label: "Stakeholder demo", hint: "Show an idea on real screens before anyone signs off on it." },
+  { value: "ab-idea", label: "A/B idea", hint: "Ship a variant to a test version of a product and compare it with what is live." },
+  { value: "terminal", label: "Exploring with Claude Code", hint: "A designer works from the terminal with Claude and the Bridge MCP server inside this exploration, never in the library." },
   { value: "other", label: "Other", hint: "Anything else worth trying before it becomes a change." }
 ];
 const EXPLORATION_STATUS_LABEL = { active: "Running", promoted: "Promoted to review", closed: "Closed" };
@@ -2433,8 +2517,8 @@ function explorationProblems(e) {
   const name = e.name.trim();
   const slug = e.slug?.trim() || explorationSlug(name);
   if (!name) out.push('Name the exploration, for example "Denser data tables".');
-  else if (name.length > 60) out.push("Keep the name under 60 characters: it becomes the branch name.");
-  else if (slug.length < 2 || !SLUG_RE.test(slug)) out.push("Use letters or digits in the name: it becomes the branch explore/<name>.");
+  else if (name.length > 60) out.push("Keep the name under 60 characters: it becomes the exploration's link name.");
+  else if (slug.length < 2 || !SLUG_RE.test(slug)) out.push("Use letters or digits in the name: it becomes the exploration's link name.");
   if (!e.purpose.trim()) out.push("Say what you want to learn, in one sentence.");
   return out;
 }
@@ -2565,7 +2649,8 @@ function explorationShareMessage(input) {
   const name = input.name.trim().replace(/"/g, "'");
   const head = input.command ? `Exploration "${name}" (${input.branch}): try it in a staging branch of your product with: ${input.command}.` : `Exploration "${name}" (${input.branch}): its test build is being prepared, the install command for a staging branch of your product will be on the pull request in a few minutes.`;
   const previews = (input.previews ?? []).map((p) => `${p.label} ${p.url}`);
-  return [head, previews.length ? `Previews: ${previews.join(", ")}.` : "", `Pull request: ${input.url}.`].filter(Boolean).join(" ");
+  const local = !previews.length && input.local ? `Try it locally: ${input.local}, then start Storybook or the app with its dev command.` : "";
+  return [head, previews.length ? `Previews: ${previews.join(", ")}.` : local, `Pull request: ${input.url}.`].filter(Boolean).join(" ");
 }
 function explorationRules(branch) {
   return [
@@ -2800,6 +2885,7 @@ const SPEC_FIELDS = [
   "minWidth",
   "minHeight",
   "opacity",
+  "shadow",
   "textFill",
   "fontFamily",
   "fontSize",
@@ -2996,139 +3082,841 @@ function figmaCell(entry) {
   if (entry.status === "layout") return { label: "Auto layout", title: "A layout helper: nothing to draw, use auto layout in Figma." };
   return { label: "Not yet", ...entry.reason ? { title: `Not supported yet: ${entry.reason}` } : {} };
 }
-function parseTier(labels, body) {
-  const found = [];
-  for (const l of labels) {
-    const m = l.name.match(/^(?:risk[\s:-]*)?tier[\s:_-]*([123])\b/i) ?? l.name.match(/^risk[\s:_-]*([123])$/i);
-    if (m) found.push(Number(m[1]));
-  }
-  for (const m of (body ?? "").matchAll(/-\s*\[[xX]\]\s*\**\s*Tier\s*([123])\b/g)) found.push(Number(m[1]));
-  for (const m of (body ?? "").matchAll(/risk tier\W{0,6}(?:tier\s*)?([123])\b/gi)) found.push(Number(m[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: "" }
+const px = (v) => {
+  if (!v) return void 0;
+  const m = /^(-?[\d.]+)px$/.exec(v.trim());
+  return m ? Math.round(Number(m[1]) * 100) / 100 : void 0;
 };
-function openPulls(pulls) {
-  return pulls.filter((p) => {
-    const s = pullState(p);
-    return s === "open" || s === "draft";
+function evalCalc(expr, resolve) {
+  const body = /^calc\((.*)\)$/s.exec(expr.trim())?.[1];
+  if (!body) return void 0;
+  let missing = false;
+  const text = body.replace(/[A-Za-z_][\w-]*(?:\.[\w-]+)*/g, (path) => {
+    const v2 = resolve(path);
+    const n = typeof v2 === "number" ? v2 : v2 === void 0 ? void 0 : Number.parseFloat(v2);
+    if (n === void 0 || Number.isNaN(n)) missing = true;
+    return String(n);
   });
+  if (missing || !/^[\d.\s+\-*/()]+$/.test(text)) return void 0;
+  const tokens = text.match(/\d*\.?\d+|[+\-*/()]/g) ?? [];
+  let i = 0;
+  const factor = () => {
+    const t = tokens[i++];
+    if (t === "(") {
+      const v2 = sum();
+      i++;
+      return v2;
+    }
+    if (t === "-") return -factor();
+    return Number(t);
+  };
+  const product = () => {
+    let v2 = factor();
+    while (tokens[i] === "*" || tokens[i] === "/") v2 = tokens[i++] === "*" ? v2 * factor() : v2 / factor();
+    return v2;
+  };
+  const sum = () => {
+    let v2 = product();
+    while (tokens[i] === "+" || tokens[i] === "-") v2 = tokens[i++] === "+" ? v2 + product() : v2 - product();
+    return v2;
+  };
+  const v = sum();
+  return Number.isFinite(v) ? Math.round(v * 100) / 100 : void 0;
+}
+const sameName = (cssVar, path) => cssVar.replace(/^--/, "").replace(/[^A-Za-z0-9]/g, "").toLowerCase() === path.replace(/[^A-Za-z0-9]/g, "").toLowerCase();
+function normColor(v) {
+  const t = v.trim().toLowerCase();
+  const hex2 = /^#([0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})$/.exec(t)?.[1];
+  if (hex2) {
+    const full = hex2.length <= 4 ? hex2.split("").map((c) => c + c).join("") : hex2;
+    const [r, g, b] = [0, 2, 4].map((i) => parseInt(full.slice(i, i + 2), 16));
+    const a = full.length === 8 ? Math.round(parseInt(full.slice(6, 8), 16) / 255 * 100) / 100 : 1;
+    return a === 1 ? `rgb(${r},${g},${b})` : `rgba(${r},${g},${b},${a})`;
+  }
+  const m = /^rgba?\(([^)]*)\)$/.exec(t);
+  if (m) {
+    const parts = m[1].split(/[\s,/]+/).filter(Boolean).map(Number);
+    const [r, g, b] = parts;
+    const a = parts[3] ?? 1;
+    return a === 1 ? `rgb(${r},${g},${b})` : `rgba(${r},${g},${b},${Math.round(a * 100) / 100})`;
+  }
+  return t.replace(/\s+/g, "");
+}
+const normText = (t) => (t ?? "").replace(/\s+/g, " ").trim().toLowerCase();
+const graphic = (k) => k === "icon" || k === "vector" ? "graphic" : k;
+function withoutAddedWrappers(parts, measured) {
+  const real = new Set(measured.parts.map((m) => m.id));
+  const added = /* @__PURE__ */ new Map();
+  for (const p of parts) {
+    if (p.kind !== "frame" || !p.parent || real.has(p.id)) continue;
+    const kids = parts.filter((c) => c.parent === p.id);
+    if (kids.length === 1 && `${kids[0].id}-wrapper` === p.id) added.set(p.id, p.parent);
+  }
+  if (!added.size) return parts;
+  const up = (id) => id && added.has(id) ? up(added.get(id)) : id;
+  return parts.filter((p) => !added.has(p.id)).map((p) => p.parent && added.has(p.parent) ? { ...p, parent: up(p.parent) } : p);
+}
+function pairParts(staticParts, measured, o = {}) {
+  const pairs2 = /* @__PURE__ */ new Map();
+  const taken = /* @__PURE__ */ new Set();
+  const mParts = new Map(measured.parts.map((p) => [p.id, p]));
+  const sParts = new Map(staticParts.map((p) => [p.id, p]));
+  const take = (s, m) => {
+    pairs2.set(s, m);
+    taken.add(m);
+  };
+  const ancestors = (id) => {
+    const out = [];
+    const seen = /* @__PURE__ */ new Set([id]);
+    for (let p = mParts.get(id)?.parent; p && !seen.has(p); p = mParts.get(p)?.parent) {
+      seen.add(p);
+      out.push(p);
+    }
+    return out;
+  };
+  const pairedAncestor = (p) => {
+    const seen = /* @__PURE__ */ new Set([p.id]);
+    for (let a = p.parent; a && !seen.has(a); a = sParts.get(a)?.parent) {
+      if (pairs2.has(a)) return pairs2.get(a);
+      seen.add(a);
+    }
+    return void 0;
+  };
+  const best = (p, cands) => {
+    if (!cands.length) return void 0;
+    const parent = p.parent ? pairs2.get(p.parent) : void 0;
+    if (parent) {
+      const direct = cands.find((c) => c.parent === parent);
+      if (direct) return direct;
+    }
+    const anc = pairedAncestor(p);
+    if (anc) {
+      const under2 = cands.find((c) => ancestors(c.id).includes(anc));
+      if (under2) return under2;
+    }
+    return cands[0];
+  };
+  const root = staticParts.find((p) => !p.parent);
+  if (root) take(root.id, "root");
+  const textOf = (p) => {
+    if (p.characters) return normText(p.characters);
+    const prop = p.text ? o.properties?.find((x) => x.name === p.text && x.type === "TEXT") : void 0;
+    return typeof prop?.default === "string" ? normText(prop.default) : "";
+  };
+  const classesOf = (p) => [...(p?.source ?? "").matchAll(/(?:^|[\s,])\.([\w-]+)/g)].map((x) => x[1]);
+  const mClasses = (m) => [...new Set((m.source ?? "").split(" ").filter(Boolean))];
+  const shared = (p, m) => {
+    const mine = new Set(classesOf(p));
+    return mClasses(m).filter((c) => mine.has(c)).length;
+  };
+  const staticClasses = new Set(staticParts.flatMap((p) => classesOf(p)));
+  const claimedByOther = (p, m) => !shared(p, m) && mClasses(m).length > 0 && (classesOf(p).length > 0 || mClasses(m).some((c) => staticClasses.has(c)));
+  for (const p of staticParts) {
+    if (p.kind !== "text" || pairs2.has(p.id)) continue;
+    const t = textOf(p);
+    if (!t) continue;
+    const hit = best(p, measured.parts.filter((m) => m.kind === "text" && !taken.has(m.id) && normText(m.characters) === t && !(classesOf(p).length && mClasses(m).length && !shared(p, m))));
+    if (hit) take(p.id, hit.id);
+  }
+  const classOf = (p) => /\.([\w-]+)\s*$/.exec(p?.source ?? "")?.[1];
+  for (const p of staticParts) {
+    if (p.kind !== "text" || !pairs2.has(p.id) || !p.parent || pairs2.has(p.parent)) continue;
+    const sp = sParts.get(p.parent);
+    if (!sp || sp.kind !== "frame" || !sp.parent) continue;
+    const cls = classOf(sp);
+    const mp = cls ? ancestors(pairs2.get(p.id)).find((a) => (mParts.get(a)?.source ?? "").split(" ").includes(cls)) : mParts.get(pairs2.get(p.id))?.parent;
+    if (mp && mp !== "root" && !taken.has(mp) && mParts.get(mp)?.kind === "frame") take(sp.id, mp);
+  }
+  for (const p of staticParts) {
+    if (pairs2.has(p.id) || !classesOf(p).length) continue;
+    if (p.parent && !pairs2.has(p.parent) && classesOf(sParts.get(p.parent)).length) continue;
+    const all = measured.parts.filter((m) => !taken.has(m.id) && shared(p, m) > 0);
+    const parent = p.parent ? pairs2.get(p.parent) : void 0;
+    const under2 = parent ? all.filter((m) => m.parent === parent) : [];
+    const cands = under2.length ? under2 : all;
+    const most = Math.max(0, ...cands.map((m) => shared(p, m)));
+    const hit = best(p, cands.filter((m) => shared(p, m) === most));
+    if (hit) take(p.id, hit.id);
+  }
+  for (const p of staticParts) {
+    if (pairs2.has(p.id)) continue;
+    if (p.parent && !pairs2.has(p.parent)) continue;
+    const parent = p.parent ? pairs2.get(p.parent) : void 0;
+    const known = p.kind === "text" && !!textOf(p);
+    const free = measured.parts.filter((m) => !taken.has(m.id) && graphic(m.kind) === graphic(p.kind) && !claimedByOther(p, m));
+    const hit = free.find((m) => !parent || m.parent === parent) ?? (p.kind === "text" && parent && !known ? free.find((m) => ancestors(m.id).includes(parent)) : void 0);
+    if (hit) take(p.id, hit.id);
+  }
+  for (const p of staticParts) {
+    if (pairs2.has(p.id) || p.kind !== "text" || !p.parent) continue;
+    const mp = pairs2.get(p.parent);
+    const t = textOf(p);
+    if (mp && mParts.get(mp)?.kind === "text" && staticParts.filter((x) => x.parent === p.parent).length === 1 && (!t || normText(mParts.get(mp).characters) === t)) pairs2.set(p.id, mp);
+  }
+  return pairs2;
+}
+function compareSpecToMeasured(staticParts, staticValues, measured, resolve, o = {}) {
+  const pairs2 = pairParts(staticParts, measured, o);
+  const out = { partsMatched: pairs2.size, staticParts: staticParts.length, measuredParts: measured.parts.length, compared: 0, same: 0, sameToken: 0, diffs: [], unmatchedParts: [], staticOnly: 0, measuredOnly: 0 };
+  const num2 = (v) => typeof v === "number" ? v : v === void 0 ? void 0 : /^-?[\d.]+$/.test(v.trim()) ? Number(v) : px(v);
+  const near = (a, b) => {
+    if (a === void 0 || b === void 0) return false;
+    const na0 = num2(a);
+    const nb0 = num2(b);
+    if (na0 !== void 0 && nb0 !== void 0) return Math.abs(na0 - nb0) <= 0.5;
+    if (typeof a === "number" && typeof b === "number") return Math.abs(a - b) <= 0.5;
+    const na = typeof a === "string" ? px(a) ?? normColor(a) : a;
+    const nb = typeof b === "string" ? px(b) ?? normColor(b) : b;
+    return typeof na === "number" && typeof nb === "number" ? Math.abs(na - nb) <= 0.5 : na === nb;
+  };
+  for (const sp of staticParts) {
+    const mid = pairs2.get(sp.id);
+    if (!mid) {
+      out.unmatchedParts.push(sp.id);
+      continue;
+    }
+    const sv = staticValues[sp.id] ?? {};
+    const mv = mid ? measured.values[mid] ?? {} : {};
+    const mr = mid ? measured.raw[mid] ?? {} : {};
+    const fields = /* @__PURE__ */ new Set([...Object.keys(sv), ...Object.keys(mv)]);
+    for (const f of fields) {
+      if ((f === "width" || f === "height") && sv[f] === void 0) continue;
+      const s = sv[f];
+      const m = mv[f] !== void 0 ? mv[f] : mr[f];
+      if (s === void 0) {
+        if (m !== void 0 && m !== 0) out.measuredOnly++;
+        continue;
+      }
+      if (m === void 0 && !(f in mr)) {
+        if (s === 0 || s === null) continue;
+        const r = typeof s === "string" && resolve ? resolve(s) : s;
+        if (r === 0 || r === "0px" || r === null) continue;
+        out.staticOnly++;
+        out.diffs.push({ part: sp.id, field: f, static: s, same: false });
+        continue;
+      }
+      out.compared++;
+      let same2 = s === m;
+      if (!same2 && typeof s === "string" && !/^calc\(/.test(s)) same2 = (measured.tokens[mid]?.[f]?.chain ?? []).some((v) => sameName(v, s));
+      if (same2 && typeof s === "string") out.sameToken++;
+      if (!same2 && resolve) {
+        let rs = typeof s === "string" ? /^calc\(/.test(s) ? evalCalc(s, resolve) : resolve(s) : typeof s === "number" ? s : void 0;
+        const size = typeof mr.fontSize === "number" ? mr.fontSize : void 0;
+        if (f === "lineHeight" && size && rs !== void 0 && /^[\d.]+$/.test(String(rs).trim()) && Number(rs) < 4) rs = Number(rs) * size;
+        same2 = near(rs, mr[f]);
+      }
+      if (same2) out.same++;
+      else out.diffs.push({ part: sp.id, field: f, static: s, measured: m ?? null, same: same2 });
+    }
+  }
+  const root = staticValues[staticParts.find((p) => !p.parent)?.id ?? "root"] ?? {};
+  const box = measured.boxes.root;
+  if (box) out.rootSize = { static: { width: typeof root.width === "number" ? root.width : void 0, height: typeof root.height === "number" ? root.height : void 0 }, measured: { width: box.width, height: box.height } };
+  return out;
 }
-const OK = /* @__PURE__ */ new Set(["success", "neutral", "skipped"]);
-function summarizeCi(runs, statuses = []) {
-  const failed = [];
-  const pending = [];
-  let passed = 0;
-  for (const r of runs) {
-    if (r.status !== "completed") pending.push({ name: r.name, url: r.html_url });
-    else if (r.conclusion && OK.has(r.conclusion)) passed++;
-    else failed.push({ name: r.name, url: r.html_url });
+function tokenVariablePath(name, prefix) {
+  let parts = name.replace(/^--/, "").split(/-+/).flatMap((x) => x.replace(/([a-z0-9])([A-Z])/g, "$1 $2").split(" ")).map((x) => x.toLowerCase()).filter(Boolean);
+  if (prefix && parts[0] === prefix.toLowerCase() && parts.length > 1) parts = parts.slice(1);
+  return parts.join("/");
+}
+function sharedTokenPrefix(names2) {
+  if (names2.length < 20) return void 0;
+  const counts = /* @__PURE__ */ new Map();
+  for (const n2 of names2) {
+    const first = n2.replace(/^--/, "").split("-")[0];
+    counts.set(first, (counts.get(first) ?? 0) + 1);
   }
+  const [top, n] = [...counts.entries()].sort((a, b) => b[1] - a[1])[0] ?? ["", 0];
+  return top && n / names2.length >= 0.6 ? top : void 0;
+}
+function markUsedTokens(tokens, stories) {
+  const byName = new Map(tokens.properties.map((p) => [p.name, p]));
   const seen = /* @__PURE__ */ new Set();
-  for (const s of statuses) {
-    if (seen.has(s.context)) continue;
-    seen.add(s.context);
-    if (s.state === "success") passed++;
-    else if (s.state === "pending") pending.push({ name: s.context, url: s.target_url ?? void 0 });
-    else failed.push({ name: s.context, url: s.target_url ?? void 0 });
+  const use = (name) => {
+    if (seen.has(name)) return;
+    seen.add(name);
+    const p = byName.get(name);
+    if (!p) return;
+    p.used = true;
+    for (const target of [p.aliasOf, ...Object.values(p.aliasOfByMode ?? {})]) if (target) use(target);
+    if (p.kind === "expression") for (const m of p.raw.matchAll(/var\(\s*(--[\w-]+)/g)) use(m[1]);
+  };
+  for (const s of stories)
+    for (const spec of [s.spec, ...s.instances ?? []])
+      for (const part of Object.values(spec?.tokens ?? {}))
+        for (const t of Object.values(part ?? {})) for (const name of t?.chain ?? []) use(name);
+  const used = tokens.properties.filter((p) => p.used).length;
+  tokens.counts.used = used;
+  return used;
+}
+class MeasuredSpecsError extends Error {
+}
+const isObj$1 = (v) => !!v && typeof v === "object" && !Array.isArray(v);
+function parseMeasuredSpecsFile(input) {
+  let data = input;
+  if (typeof input === "string") {
+    try {
+      data = JSON.parse(input);
+    } catch (e) {
+      throw new MeasuredSpecsError(`measured specs are not JSON: ${e.message}`);
+    }
   }
-  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, rules = {}) {
-  const latest = /* @__PURE__ */ new Map();
-  const sorted = [...reviews].sort((a2, b) => String(a2.submitted_at ?? "").localeCompare(String(b.submitted_at ?? "")));
-  for (const r of sorted) {
-    const login = r.user?.login;
-    if (!login || login === author) continue;
-    if (r.state === "APPROVED" || r.state === "CHANGES_REQUESTED" || r.state === "DISMISSED") latest.set(login, r.state);
+  if (!isObj$1(data)) throw new MeasuredSpecsError("measured specs: expected an object");
+  if (data.version !== 1) throw new MeasuredSpecsError(`measured specs: version ${String(data.version)} is not supported (expected 1)`);
+  if (typeof data.storybook !== "string") throw new MeasuredSpecsError("measured specs: storybook URL missing");
+  if (!Array.isArray(data.stories)) throw new MeasuredSpecsError("measured specs: stories missing");
+  data.stories.forEach((s, i) => {
+    if (!isObj$1(s) || typeof s.id !== "string") throw new MeasuredSpecsError(`measured specs: story ${i} has no id`);
+    const specs = [s.spec, ...Array.isArray(s.instances) ? s.instances : []].filter((x) => x !== void 0);
+    for (const sp of specs) {
+      if (!isObj$1(sp) || !Array.isArray(sp.parts) || !isObj$1(sp.values)) throw new MeasuredSpecsError(`measured specs: story ${s.id} has a spec without parts and values`);
+      for (const p of sp.parts) if (!isObj$1(p) || typeof p.id !== "string" || typeof p.kind !== "string") throw new MeasuredSpecsError(`measured specs: story ${s.id} has a part without id or kind`);
+    }
+    if (s.props !== void 0 && !isObj$1(s.props)) throw new MeasuredSpecsError(`measured specs: story ${s.id} props is not an object`);
+  });
+  if (data.components !== void 0 && !Array.isArray(data.components)) throw new MeasuredSpecsError("measured specs: components is not a list");
+  if (data.tokens !== void 0) {
+    const t = data.tokens;
+    if (!isObj$1(t) || !Array.isArray(t.properties) || !Array.isArray(t.modes)) throw new MeasuredSpecsError("measured specs: tokens needs properties and modes");
+    for (const p of t.properties) if (!isObj$1(p) || typeof p.name !== "string" || typeof p.path !== "string" || p.tier !== "primitive" && p.tier !== "semantic") throw new MeasuredSpecsError("measured specs: a token has no name, path or tier");
+  }
+  return data;
+}
+const mul = (m, v) => [0, 1, 2].map((i) => m[i][0] * v[0] + m[i][1] * v[1] + m[i][2] * v[2]);
+const XYZ_D65_TO_LINEAR_SRGB = [
+  [3.2409699419045226, -1.537383177570094, -0.4986107602930034],
+  [-0.9692436362808796, 1.8759675015077202, 0.04155505740717559],
+  [0.05563007969699366, -0.20397695888897652, 1.0569715142428786]
+];
+const D50_TO_D65 = [
+  [0.9554734527042182, -0.023098536874261423, 0.0632593086610217],
+  [-0.028369706963208136, 1.0099954580058226, 0.021041398966943008],
+  [0.012314001688319899, -0.020507696433477912, 1.3303659366080753]
+];
+const LINEAR_P3_TO_XYZ_D65 = [
+  [0.4865709486482162, 0.26566769316909306, 0.1982172852343625],
+  [0.2289745640697488, 0.6917385218365064, 0.079286914093745],
+  [0, 0.04511338185890264, 1.043944368900976]
+];
+const D50_WHITE = [0.3457 / 0.3585, 1, (1 - 0.3457 - 0.3585) / 0.3585];
+const toLinear = (c) => Math.abs(c) <= 0.04045 ? c / 12.92 : Math.sign(c) * ((Math.abs(c) + 0.055) / 1.055) ** 2.4;
+const toGamma = (c) => Math.abs(c) <= 31308e-7 ? 12.92 * c : Math.sign(c) * (1.055 * Math.abs(c) ** (1 / 2.4) - 0.055);
+function oklabToLinearSrgb(L, a, b) {
+  const l = (L + 0.3963377774 * a + 0.2158037573 * b) ** 3;
+  const m = (L - 0.1055613458 * a - 0.0638541728 * b) ** 3;
+  const s = (L - 0.0894841775 * a - 1.291485548 * b) ** 3;
+  return [4.0767416621 * l - 3.3077115913 * m + 0.2309699292 * s, -1.2684380046 * l + 2.6097574011 * m - 0.3413193965 * s, -0.0041960863 * l - 0.7034186147 * m + 1.707614701 * s];
+}
+function labToXyzD50(L, a, b) {
+  const e = 216 / 24389;
+  const k = 24389 / 27;
+  const fy = (L + 16) / 116;
+  const fx = a / 500 + fy;
+  const fz = fy - b / 200;
+  const x = fx ** 3 > e ? fx ** 3 : (116 * fx - 16) / k;
+  const y = L > k * e ? fy ** 3 : L / k;
+  const z = fz ** 3 > e ? fz ** 3 : (116 * fz - 16) / k;
+  return [x * D50_WHITE[0], y * D50_WHITE[1], z * D50_WHITE[2]];
+}
+function num(s, full = 1) {
+  if (s === void 0 || s === "none") return 0;
+  if (s.endsWith("%")) return parseFloat(s) / 100 * full;
+  if (/deg$/.test(s)) return parseFloat(s);
+  if (/turn$/.test(s)) return parseFloat(s) * 360;
+  if (/rad$/.test(s)) return parseFloat(s) * 180 / Math.PI;
+  return parseFloat(s);
+}
+function linearSrgb(fn, args) {
+  switch (fn) {
+    case "oklab":
+      return oklabToLinearSrgb(num(args[0]), num(args[1], 0.4), num(args[2], 0.4));
+    case "oklch": {
+      const c = num(args[1], 0.4);
+      const h = num(args[2]) * Math.PI / 180;
+      return oklabToLinearSrgb(num(args[0]), c * Math.cos(h), c * Math.sin(h));
+    }
+    case "lab":
+      return mul(XYZ_D65_TO_LINEAR_SRGB, mul(D50_TO_D65, labToXyzD50(num(args[0], 100), num(args[1], 125), num(args[2], 125))));
+    case "lch": {
+      const c = num(args[1], 150);
+      const h = num(args[2]) * Math.PI / 180;
+      return mul(XYZ_D65_TO_LINEAR_SRGB, mul(D50_TO_D65, labToXyzD50(num(args[0], 100), c * Math.cos(h), c * Math.sin(h))));
+    }
+    case "color": {
+      const [space, ...c] = args;
+      const v = [num(c[0]), num(c[1]), num(c[2])];
+      if (space === "srgb") return v.map(toLinear);
+      if (space === "srgb-linear") return v;
+      if (space === "display-p3") return mul(XYZ_D65_TO_LINEAR_SRGB, mul(LINEAR_P3_TO_XYZ_D65, v.map(toLinear)));
+      if (space === "xyz" || space === "xyz-d65") return mul(XYZ_D65_TO_LINEAR_SRGB, v);
+      if (space === "xyz-d50") return mul(XYZ_D65_TO_LINEAR_SRGB, mul(D50_TO_D65, v));
+      return void 0;
+    }
   }
-  const approvers = [...latest].filter(([, s]) => s === "APPROVED").map(([l]) => l);
-  const changesRequested = [...latest].filter(([, s]) => s === "CHANGES_REQUESTED").map(([l]) => l);
-  const lower2 = (xs) => xs.map((x) => x.toLowerCase().replace(/^@/, ""));
-  const d = lower2(owners.design);
-  const t = lower2(owners.tech);
-  const a = lower2(approvers);
-  let design;
-  let tech;
-  if (d.length || t.length) {
-    design = d.length ? a.some((x) => d.includes(x)) : a.length > 0;
-    const solo = rules.soloOwnerCanApproveBoth ? soloApprover(owners) : null;
-    const soloBoth = (x) => a.length === 1 && d.includes(x) && x !== solo;
-    tech = t.length ? a.some((x) => t.includes(x) && !soloBoth(x)) : a.length > 1;
-  } else {
-    design = a.length >= 1;
-    tech = a.length >= 2;
+  return void 0;
+}
+const COLOR_FN = /\b(oklch|oklab|lab|lch|color)\(([^()]*)\)/gi;
+function cssColorToRgb(fn, inner) {
+  const [main, alpha] = inner.split("/");
+  const args = main.trim().split(/[\s,]+/).filter(Boolean);
+  const lin = linearSrgb(fn.toLowerCase(), args);
+  if (!lin || lin.some((x) => !Number.isFinite(x))) return void 0;
+  const [r, g, b] = lin.map((x) => Math.round(Math.min(1, Math.max(0, toGamma(x))) * 255));
+  const a = alpha === void 0 ? 1 : Math.min(1, Math.max(0, num(alpha.trim())));
+  return a >= 1 ? `rgb(${r}, ${g}, ${b})` : `rgba(${r}, ${g}, ${b}, ${Math.round(a * 1e3) / 1e3})`;
+}
+function cssColorsToRgb(text) {
+  if (!/(oklch|oklab|lab|lch|color)\(/i.test(text)) return text;
+  return text.replace(COLOR_FN, (whole, fn, inner) => cssColorToRgb(fn, inner) ?? whole);
+}
+function withSrgbColors(value) {
+  if (typeof value === "string") return cssColorsToRgb(value);
+  if (Array.isArray(value)) return value.map((v) => withSrgbColors(v));
+  if (value && typeof value === "object") return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, withSrgbColors(v)]));
+  return value;
+}
+function parseBoxShadow(css) {
+  if (!css || css.trim() === "none") return [];
+  const out = [];
+  for (const one of cssColorsToRgb(css).split(/,(?![^(]*\))/)) {
+    const color = /rgba?\(([^)]*)\)/i.exec(one);
+    const c = color ? color[1].split(/[\s,/]+/).filter(Boolean).map(Number) : [0, 0, 0, 1];
+    const a = c[3] ?? 1;
+    const lengths = one.replace(/rgba?\([^)]*\)/i, "").replace(/inset/i, "").trim().split(/\s+/).filter(Boolean).map((x) => Number.parseFloat(x));
+    if (lengths.length < 2 || lengths.some((x) => !Number.isFinite(x)) || !(a > 0)) continue;
+    out.push({ inset: /\binset\b/i.test(one), x: lengths[0], y: lengths[1], blur: lengths[2] ?? 0, spread: lengths[3] ?? 0, color: { r: c[0] / 255, g: c[1] / 255, b: c[2] / 255, a } });
   }
-  return { approvers, changesRequested, design, tech };
+  return out;
 }
-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));
+const where = (r) => r.allVariants ? "every variant" : shortVariants(r.variants.join("; "));
+const cap = (s) => s ? s.charAt(0).toUpperCase() + s.slice(1) : s;
+const and = (xs) => xs.length < 2 ? xs[0] ?? "" : `${xs.slice(0, -1).join(", ")} and ${xs.at(-1)}`;
+function rawIssue(label, r, values2) {
+  const matches = [...new Set(values2.flatMap((v) => v.matches ?? []))];
+  const todo = !matches.length ? "No variable has that value: bind it to one so it follows the library, or create the variable and send it with the variables." : matches.length === 1 ? `${matches[0]} has that value: bind it so it follows the library.` : `${and(matches)} have that value: bind one so it follows the library.`;
+  return { what: `${label} is ${and(values2.map((v) => v.value))}, not a variable.`, todo, raw: { kind: r.kind, variants: r.variants, values: values2 } };
 }
-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");
+function planComponentPush(d, ctx) {
+  const issues = [...d.unknown];
+  const reasons = [];
+  const edits = /* @__PURE__ */ new Map();
+  const also = /* @__PURE__ */ new Set();
+  for (const r of d.rebinds) {
+    const label = `${cap(r.kind)} in ${where(r)}`;
+    if (r.raw?.length) {
+      issues.push(rawIssue(label, r, r.raw));
+      continue;
     }
-    if (!input.approvals.tech) {
-      approvalReasons.push("It needs a tech owner approval.");
-      missing.push("tech approval");
+    if (!r.after.length) {
+      issues.push({ what: `${label} is no longer bound to a variable: it uses a raw value.`, todo: "Bind it to a variable, or create the variable and send it with the variables, then scan again." });
+      continue;
     }
-  } else if (!input.approvals.approvers.length) {
-    approvalReasons.push("It needs one approval.");
-    missing.push("approval");
+    const missing = r.after.filter((p) => !ctx.tierOf(p));
+    if (missing.length) {
+      issues.push({ what: `${label} uses ${missing.join(", ")}, a variable the library does not have yet.`, todo: "Send the variable first (Variables, above), then scan again." });
+      continue;
+    }
+    if (!r.before.length) {
+      reasons.push(`${label} is bound to ${r.after.join(", ")} where code paints nothing: the CSS needs it added.`);
+      continue;
+    }
+    if (r.before.length !== 1 || r.after.length !== 1) {
+      reasons.push(`${label} moved from ${r.before.join(", ")} to ${r.after.join(", ")}: several variables on one property, so the CSS needs writing.`);
+      continue;
+    }
+    const [from, to] = [r.before[0], r.after[0]];
+    if (ctx.tierOf(from) !== "component") {
+      reasons.push(`Code paints ${r.kind} with ${from} directly, not through a ${d.component} token: the CSS needs to change to ${to}.`);
+      continue;
+    }
+    const elsewhere = ctx.usedElsewhere(from, r);
+    if (elsewhere.variants.length) {
+      const v = elsewhere.variants;
+      const list2 = v.length > 3 ? `${shortVariants(v.slice(0, 3).join("; ")).replace(/ and /, ", ")} and ${v.length - 3} more` : shortVariants(v.join("; "));
+      reasons.push(`${from} also paints ${list2}: pointing it to ${to} would change them too, so it needs a new token for ${where(r)}.`);
+      continue;
+    }
+    for (const c of elsewhere.components) also.add(c);
+    const prev = edits.get(from);
+    if (prev && prev.value !== `{${to}}`) {
+      reasons.push(`${from} moved to two different variables (${String(prev.value).slice(1, -1)} and ${to}): it needs splitting in two.`);
+      edits.delete(from);
+      continue;
+    }
+    edits.set(from, { op: "set", path: from, value: `{${to}}` });
   }
-  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((t) => t.status === "unreadable" ? t.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 n = reason.trim().length;
-  if (n === 0) return `Write why this merges without the missing approvals, in at least ${policy.minReasonLength} characters.`;
-  if (n < policy.minReasonLength) return `Write at least ${policy.minReasonLength} characters (${n} so far), so the history says why.`;
-  return null;
+  const list = [...edits.values()];
+  if (d.needsCode || reasons.length) {
+    return {
+      route: "claude-draft",
+      said: `A developer builds it with Claude from what you changed, then a person reviews it.${list.length ? ` ${list.length === 1 ? "Its token swap goes" : "Its token swaps go"} with it.` : ""}`,
+      edits: list,
+      reasons,
+      issues,
+      alsoChanges: [...also]
+    };
+  }
+  if (list.length) {
+    const n = list.length;
+    const others = [...also];
+    const names2 = others.length > 3 ? [...others.slice(0, 3), `${others.length - 3} more`] : others;
+    const alsoLine = names2.length ? ` It also repaints ${names2.length > 1 ? `${names2.slice(0, -1).join(", ")} and ${names2[names2.length - 1]}` : names2[0]}: they use the same token${n === 1 ? "" : "s"}.` : "";
+    return { route: "token-change", said: `Exact, no AI: ${n === 1 ? `${list[0].path} points` : `${n} ${d.component} tokens point`} to the new variable${n === 1 ? "" : "s"}, checked for contrast and reviewed like any token change.${alsoLine}`, edits: list, reasons, issues, alsoChanges: others };
+  }
+  return { route: "manual", said: issues.length ? "Fix it in Figma first: nothing is sent until Bridge can read it." : "Nothing to send.", edits: [], reasons, issues, alsoChanges: [] };
 }
-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 specsUsage(specs, component) {
+  const own = specs.components.find((x) => x.name === component) ?? specs.components.find((x) => x.component === component);
+  return (path, r) => {
+    const variants = [];
+    const components = [];
+    for (const c of specs.components) {
+      for (const v of c.variants) {
+        if (!Object.values(v.values).some((fields) => Object.values(fields ?? {}).includes(path))) continue;
+        const key = variantKeyOf(v.props);
+        if (c === own) {
+          if (!r.variants.includes(key)) variants.push(key);
+        } else if (!components.includes(c.name)) components.push(c.name);
+      }
+    }
+    return { variants, components };
+  };
 }
-function overrideRefusedComment(body, message) {
-  return body.replace(/ Merged from Bridge\.$/, ` Merge refused by GitHub: ${message.trim().replace(/[.\s]+$/, "")}. Not merged.`);
+function componentContrastPairs(edits, pairs2, tokens) {
+  const out = /* @__PURE__ */ new Map();
+  for (const e of edits) {
+    const target = tokens.aliasOf(e.path);
+    if (!target) continue;
+    const group = e.path.split(".")[0];
+    const sibling = (other) => tokens.paths.find((p) => p !== e.path && p.split(".")[0] === group && tokens.aliasOf(p) === other) ?? other;
+    for (const p of pairs2) {
+      if (p.foreground === target) out.set(`${e.path}|${sibling(p.background)}`, { ...p, foreground: e.path, background: sibling(p.background) });
+      if (p.background === target) out.set(`${sibling(p.foreground)}|${e.path}`, { ...p, foreground: sibling(p.foreground), background: e.path });
+    }
+  }
+  return [...out.values()];
+}
+const FROM_FIGMA_LABEL = "from-figma";
+const WAITING_FOR_CLAUDE_LABEL = "waiting-for-claude";
+const DRAFTED_BY_CLAUDE_LABEL = "drafted-by-claude";
+const FIGMA_SPEC_DIR = ".bridge/figma";
+const ORIGIN_MARK = "bridge-from-figma";
+const hidden = (data) => `<!-- ${ORIGIN_MARK} ${JSON.stringify(data).replace(/-->/g, "--\\u003e")} -->`;
+function parseFigmaOrigin(body) {
+  if (!body) return void 0;
+  const m = new RegExp(`<!-- ${ORIGIN_MARK} (\\{[\\s\\S]*?\\}) -->`).exec(body);
+  if (!m) return void 0;
+  try {
+    const o = JSON.parse(m[1]);
+    return typeof o.component === "string" && (o.route === "token-change" || o.route === "claude-draft") ? o : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function figmaOriginSection(o) {
+  const design = o.url ? `[${o.figmaName}](${o.url})` : `"${o.figmaName}"`;
+  const who = o.requestedBy ? ` by @${o.requestedBy}` : "";
+  const status = o.route === "token-change" ? "Exact token change, no AI: Bridge read the token swap from the Figma component." : o.status === "drafted" ? "**Drafted with Claude** from the Figma spec. A person reviews it before it ships." : `**Waiting for a developer:** this branch carries the spec only, as a request. A developer builds the code here with Claude (\`bridge_get_figma_change\`, or \`bridge figma show <number>\`), then it is labelled ${DRAFTED_BY_CLAUDE_LABEL}.`;
+  return [`**From Figma:** ${design}${who}. Once it ships, a pull in the Bridge Figma plugin rebuilds the component from this code.`, "", status, "", hidden(o)].join("\n");
+}
+function withFigmaOrigin(body, o) {
+  let b = (body ?? "").trim();
+  const at = b.indexOf("**From Figma:**");
+  const mark = b.indexOf(`<!-- ${ORIGIN_MARK} `);
+  if (at >= 0 && mark > at) {
+    const end = b.indexOf("-->", mark);
+    b = `${b.slice(0, at)}${b.slice(end + 3)}`.trim();
+  }
+  return `${figmaOriginSection(o)}${b ? `
+
+${b}` : ""}`;
+}
+const figmaSpecSlug = (d) => slugify(`${d.component} ${d.title}`, 48);
+const figmaSpecPath = (d) => `${FIGMA_SPEC_DIR}/${figmaSpecSlug(d)}.json`;
+const kindLabel = (k) => REQUEST_KINDS.find((x) => x.value === k)?.label ?? "Change";
+function formatFigmaSpec(d, plan) {
+  return `${JSON.stringify({ ...d, tokenEdits: plan.edits, reasons: plan.reasons, unknown: plan.issues }, null, 2)}
+`;
+}
+function parseFigmaSpec(text) {
+  if (!text) return void 0;
+  try {
+    const s = JSON.parse(text);
+    return s && s.v === 1 && typeof s.component === "string" && Array.isArray(s.changes) ? s : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function figmaDraftBrief(d, ctx) {
+  const dir = `${(ctx.componentsDir ?? "packages/react/src/components").replace(/\/+$/, "")}/${d.component}`;
+  const suggested = "suggestion" in ctx;
+  const variants = Object.entries(d.variantAxes).map(([axis, values2]) => `${axis}: ${values2.join(", ")}`);
+  const props = d.properties.filter((p) => p.type !== "VARIANT").map((p) => `${p.name} (${p.type.toLowerCase().replace("_", " ")}, default ${p.default || "empty"})`);
+  return [
+    suggested ? "Draft the code for a component change made in Figma, sent as a Bridge suggestion (this issue)." : `Draft the code for a component change made in Figma, on the library branch ${ctx.branch} (draft pull request #${ctx.pr}).`,
+    "",
+    d.coded ? `Component: ${d.component} (${dir})` : `New component: ${d.component} (create ${dir})`,
+    `Kind: ${kindLabel(d.kind)}`,
+    `Change: ${d.title}`,
+    ...d.line?.trim() ? [`What changes: ${d.line.trim()}`] : [],
+    "",
+    d.summary.trim(),
+    "",
+    ...d.changes.length ? ["Changes in Figma:", ...d.changes.map((c) => `- ${c.field}: ${c.before ?? "(none)"} -> ${c.after ?? "(removed)"}`), ""] : [],
+    ...variants.length ? ["Variant matrix in Figma:", ...variants.map((v) => `- ${v}`), ""] : [],
+    ...props.length ? ["Properties in Figma:", ...props.map((p) => `- ${p}`), ""] : [],
+    ...d.tokenEdits?.length ? ["Token swaps to make too (exact, with bridge_propose_token_change on this branch or by hand in the token files):", ...d.tokenEdits.map((e) => `- ${e.path} -> ${String(e.value)}`), ""] : [],
+    ...d.reasons?.length ? ["Why this needs code:", ...d.reasons.map((r) => `- ${r}`), ""] : [],
+    `Spec: ${ctx.specPath} ${suggested ? "in the suggestion" : "on the branch"} has the bound variables of every variant (token paths), the layers of every variant and what code gave Figma before.`,
+    ...d.figma?.url ? [`Design: ${d.figma.url}`] : [],
+    ...suggested && d.figma?.fileKey && d.figma.nodeId ? [`Read the design straight from Figma: Figma MCP get_design_context { fileKey: "${d.figma.fileKey}", nodeId: "${d.figma.nodeId}" }${d.figma.before?.nodeId ? ` (before: node ${d.figma.before.nodeId})` : ""}, or the REST API GET https://api.figma.com/v1/files/${d.figma.fileKey}/nodes?ids=${encodeURIComponent(d.figma.nodeId)}.`] : [],
+    ...d.images?.length ? ["Screenshot:", ...d.images.map((u) => `- ${u}`)] : [],
+    "",
+    "Steps:",
+    "suggestion" in ctx ? "1. Apply the suggestion on a new branch: bridge apply <this issue number> (it writes the spec file), or start a branch from the default branch." : `1. git fetch origin && git checkout ${ctx.branch}`,
+    `2. Write the change in ${dir}: the TSX on Base UI, the CSS module with tokens only (the bound variables of the spec, as token paths), the stories (examples), docs.json and a changeset. Follow ${ctx.agentsFile ?? "AGENTS.md"}.`,
+    "3. Run npm run specs so component-specs.json matches the code, then npm test.",
+    "suggestion" in ctx ? '4. Commit, push and open a pull request that says "Closes #<this issue number>", so the suggestion closes when it ships. A person reviews it.' : `4. Commit and push to ${ctx.branch}, then call bridge_mark_figma_change_drafted { pr: ${ctx.pr} } (CLI: bridge figma drafted ${ctx.pr}). The pull request is then ready for review, labelled ${DRAFTED_BY_CLAUDE_LABEL}, and a person reviews it.`,
+    "",
+    "Rules:",
+    "- Never invent a token or a value: use the variables the spec lists. A value the library lacks is a token change, said in the pull request.",
+    "- Keep every existing variant and prop unchanged unless the spec changes it.",
+    `- If the spec is unclear, comment on the ${suggested ? "suggestion" : "pull request"} instead of guessing.`
+  ].join("\n");
+}
+function figmaDraftBody(d, plan, o) {
+  const cell2 = (s) => s.replace(/\|/g, "\\|").replace(/\n/g, " ");
+  const rows = d.changes.length ? ["| What | Code now | In Figma |", "| --- | --- | --- |", ...d.changes.map((c) => `| ${cell2(c.field)} | ${cell2(c.before ?? "")} | ${cell2(c.after ?? "")} |`), ""] : [];
+  return withFigmaOrigin(
+    [
+      `## ${d.coded ? `${kindLabel(d.kind)} for ${d.component}` : `New component: ${d.component}`}`,
+      "",
+      d.summary.trim(),
+      "",
+      ...d.line?.trim() ? [`**What changes:** ${d.line.trim()}`, ""] : [],
+      ...rows,
+      ...d.images?.length ? [...d.images.map((u, i) => `![${d.component} in Figma ${i + 1}](${u})`), ""] : [],
+      ...plan.edits.length ? ["**Token swaps to make too:**", ...plan.edits.map((e) => `- \`${e.path}\` -> \`${String(e.value)}\``), ""] : [],
+      ...plan.reasons.length ? ["**Why this needs code:**", ...plan.reasons.map((r) => `- ${r}`), ""] : [],
+      ...plan.issues.length ? ["**Left in Figma (the designer fixes these first):**", ...plan.issues.map((i) => `- ${i.what} ${i.todo}`), ""] : [],
+      `**Spec:** \`${o.spec ?? figmaSpecPath(d)}\` (variant matrix, properties, bound variables and layers of every variant).`
+    ].join("\n"),
+    o
+  );
+}
+const figmaBranchTitle = (d) => requestIssueTitle(d);
+function figmaPushStatus(x) {
+  const labels = x.labels ?? [];
+  if (x.state === "merged") return { key: "shipped", label: "Shipped", sentence: "It shipped. Pull to rebuild the component from the reviewed code.", rebuild: true };
+  if (x.state !== "open") return { key: "closed", label: "Closed", sentence: "The library closed it without shipping. Pull to bring the component back to the code.", rebuild: true };
+  if (labels.includes(WAITING_FOR_CLAUDE_LABEL)) return { key: "waiting-for-claude", label: "Waiting for a developer", sentence: "A developer builds it with Claude from its spec, then a person reviews it.", rebuild: false };
+  if (labels.includes(DRAFTED_BY_CLAUDE_LABEL)) return { key: "drafted", label: "Drafted with Claude", sentence: "The code is drafted. A person reviews it before it ships.", rebuild: false };
+  return { key: "in-review", label: "In review", sentence: x.route === "token-change" ? "Owners review the token change." : "Owners review it.", rebuild: false };
+}
+function parseTier(labels, body) {
+  const found = [];
+  for (const l of labels) {
+    const m = l.name.match(/^(?:risk[\s:-]*)?tier[\s:_-]*([123])\b/i) ?? l.name.match(/^risk[\s:_-]*([123])$/i);
+    if (m) found.push(Number(m[1]));
+  }
+  for (const m of (body ?? "").matchAll(/-\s*\[[xX]\]\s*\**\s*Tier\s*([123])\b/g)) found.push(Number(m[1]));
+  for (const m of (body ?? "").matchAll(/risk tier\W{0,6}(?:tier\s*)?([123])\b/gi)) found.push(Number(m[1]));
+  return found.length ? Math.max(...found) : null;
+}
+function claudeStage(labels) {
+  const names2 = (labels ?? []).map((l) => (typeof l === "string" ? l : l.name ?? "").toLowerCase());
+  if (names2.includes(WAITING_FOR_CLAUDE_LABEL)) return "waiting";
+  if (names2.includes(DRAFTED_BY_CLAUDE_LABEL)) return "drafted";
+  return null;
+}
+const isDraft = (p) => Boolean(p.draft) && claudeStage(p.labels) !== "drafted";
+function pullState(p) {
+  if (p.merged_at || p.merged) return "merged";
+  if (p.state && p.state !== "open") return "closed";
+  if (isDraft(p)) 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 s = pullState(p);
+    return s === "open" || s === "draft";
+  });
+}
+function isPlatformRefusal(s) {
+  return s.state !== "success" && s.state !== "pending" && /rate.limited/i.test(s.description ?? "");
+}
+const OK = /* @__PURE__ */ new Set(["success", "neutral", "skipped"]);
+function summarizeCi(runs, statuses = []) {
+  const failed = [];
+  const pending = [];
+  let passed = 0;
+  for (const r of runs) {
+    if (r.status !== "completed") pending.push({ name: r.name, url: r.html_url });
+    else if (r.conclusion && OK.has(r.conclusion)) passed++;
+    else failed.push({ name: r.name, url: r.html_url });
+  }
+  const seen = /* @__PURE__ */ new Set();
+  for (const s of statuses) {
+    if (seen.has(s.context)) continue;
+    seen.add(s.context);
+    if (isPlatformRefusal(s)) continue;
+    if (s.state === "success") passed++;
+    else if (s.state === "pending") pending.push({ name: s.context, url: s.target_url ?? void 0 });
+    else failed.push({ name: s.context, url: s.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 };
+}
+const hasOwnerApproval = (a) => a.owner ?? a.approvers.length > 0;
+function summarizeApprovals(reviews, owners, author, rules = {}) {
+  const latest = /* @__PURE__ */ new Map();
+  const sorted = [...reviews].sort((a2, b) => String(a2.submitted_at ?? "").localeCompare(String(b.submitted_at ?? "")));
+  for (const r of sorted) {
+    const login = r.user?.login;
+    if (!login || login === author) continue;
+    if (r.state === "APPROVED" || r.state === "CHANGES_REQUESTED" || r.state === "DISMISSED") latest.set(login, r.state);
+  }
+  const approvers = [...latest].filter(([, s]) => s === "APPROVED").map(([l]) => l);
+  const changesRequested = [...latest].filter(([, s]) => s === "CHANGES_REQUESTED").map(([l]) => l);
+  const lower2 = (xs) => xs.map((x) => x.toLowerCase().replace(/^@/, ""));
+  const d = lower2(owners.design);
+  const t = lower2(owners.tech);
+  const a = lower2(approvers);
+  let design;
+  let tech;
+  const owner = d.length || t.length ? a.some((x) => d.includes(x) || t.includes(x)) : a.length > 0;
+  if (d.length || t.length) {
+    design = d.length ? a.some((x) => d.includes(x)) : a.length > 0;
+    const solo = rules.soloOwnerCanApproveBoth ? soloApprover(owners) : null;
+    const soloBoth = (x) => a.length === 1 && d.includes(x) && x !== solo;
+    tech = t.length ? a.some((x) => t.includes(x) && !soloBoth(x)) : a.length > 1;
+  } else {
+    design = a.length >= 1;
+    tech = a.length >= 2;
+  }
+  return { approvers, changesRequested, design, tech, owner };
+}
+function lookAgainReviewers(reviews, headSha, author) {
+  if (!headSha) return [];
+  const latest = /* @__PURE__ */ new Map();
+  const sorted = [...reviews].sort((a, b) => String(a.submitted_at ?? "").localeCompare(String(b.submitted_at ?? "")));
+  for (const r of sorted) {
+    const login = r.user?.login;
+    if (!login || login === author) continue;
+    if (r.state === "APPROVED" || r.state === "CHANGES_REQUESTED" || r.state === "DISMISSED") latest.set(login, r);
+  }
+  const asked = [...latest.values()].filter((r) => r.state === "CHANGES_REQUESTED");
+  if (!asked.length) return [];
+  return asked.every((r) => r.commit_id && r.commit_id !== headSha) ? asked.map((r) => r.user.login) : [];
+}
+function withSuggestionApprovals(pr, suggestion, prTier) {
+  if (!suggestion) return pr;
+  const s = suggestion.approvals;
+  if (s.changesRequested.length || (prTier ?? 3) > suggestion.tier) return pr;
+  const covered = suggestion.tier >= 2 ? s.design && s.tech : hasOwnerApproval(s);
+  if (!covered) return pr;
+  const approvers = [...pr.approvers, ...s.approvers.filter((l) => !pr.approvers.some((x) => normLogin(x) === normLogin(l)))];
+  return { ...pr, approvers, design: pr.design || s.design, tech: pr.tech || s.tech, owner: hasOwnerApproval(pr) || hasOwnerApproval(s) };
+}
+function withFigmaPushApprovals(pr, push) {
+  if (!push || push.scope === "outside") return pr;
+  const tech = pr.tech || push.scope === "token-values";
+  return { ...pr, design: true, tech, owner: true };
+}
+function withTokenValueApprovals(pr, valuesOnly) {
+  if (!valuesOnly) return pr;
+  return { ...pr, tech: pr.tech || pr.design, valuesOnly: true };
+}
+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 overrideHolders(policy, owners) {
+  const allowed = policy?.allowed ?? [];
+  const all = [...owners.design, ...owners.tech];
+  if (!all.length || all.some((o) => o.includes("/"))) return allowed;
+  const named = all.map(normLogin);
+  return allowed.filter((l) => named.includes(normLogin(l)));
+}
+const ownerOverridePolicy = (policy, owners) => policy ? { ...policy, allowed: overrideHolders(policy, owners) } : null;
+function mergeGate(input) {
+  const blocking = [];
+  const missing = [];
+  const approvalReasons = [];
+  const lifecycle = pullState(input);
+  if (lifecycle === "merged" || lifecycle === "closed") {
+    return { allowed: false, reasons: [lifecycle === "merged" ? "This branch is already merged." : "This branch is closed."], overridable: false, missing: [], canShip: !input.viewer || canShip(input.viewer, input.ship) };
+  }
+  if (input.exploration) 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 && !input.approvals.valuesOnly) {
+      approvalReasons.push("It needs a tech owner approval.");
+      missing.push("tech approval");
+    }
+  } else if (!hasOwnerApproval(input.approvals)) {
+    approvalReasons.push("It needs one owner approval.");
+    missing.push("approval");
+  }
+  const conflict = input.mergeable === false ? [CONFLICT_REASON] : [];
+  const shipper = !input.viewer || canShip(input.viewer, input.ship);
+  const ship = !shipper ? [whoCanShipSentence(input.ship), ...unreadableShipTeams(input.ship).map((t) => t.status === "unreadable" ? t.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 };
+}
+function branchVerdict(input) {
+  const own = input.approvals ? withFigmaPushApprovals(input.approvals, input.figmaPush) : null;
+  const carried = own ? withSuggestionApprovals(own, input.suggestion, input.tier) : null;
+  const approvals = carried ? withTokenValueApprovals(carried, input.tokenValues || input.figmaPush?.scope === "token-values") : null;
+  const override = ownerOverridePolicy(input.override, input.owners);
+  const state = input.state ?? "open";
+  const draft = isDraft(input);
+  const status = reviewStatusKind({ state, draft, merged_at: input.merged_at, ci: input.ci, approvals, tier: input.tier, mergeable: input.mergeable });
+  const gate = input.ci && approvals ? mergeGate({ tier: input.tier, ci: input.ci, approvals, draft, mergeable: input.mergeable, state, merged_at: input.merged_at, viewer: input.viewer, override, exploration: input.exploration, ship: input.ship }) : null;
+  const valuesArmed = Boolean(input.autoMerge && approvals?.valuesOnly && approvals.design);
+  const tier1Armed = Boolean(input.tier1Published && input.autoMerge && input.tier === 1 && input.ci?.state !== "fail");
+  const autoShip = (input.figmaPush?.scope === "token-values" || valuesArmed || tier1Armed) && state === "open" && !input.merged_at && !input.exploration;
+  const lookAgain = status === "changes-requested" ? [...input.lookAgain ?? []] : [];
+  return { approvals, override, gate, status, label: reviewStatusLabel(status, lookAgain), lookAgain, autoShip };
+}
+const CONFLICT_REASON = "It conflicts with main: resolve it with Update from main on the branch.";
+const OVERRIDE_HEADING = "**Bridge owner override**";
+function overrideReasonMin(policy) {
+  return policy.minReasonLength > 0 ? policy.minReasonLength : 20;
+}
+function overrideReasonProblem(reason, policy) {
+  const min = overrideReasonMin(policy);
+  const n = reason.trim().length;
+  if (n === 0) return `Write why this merges without the missing approvals, in at least ${min} characters.`;
+  if (n < min) return `Write at least ${min} characters (${n} 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();
@@ -3177,9 +3965,9 @@ function reviewStatusKind(input) {
   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");
+  } else if (!hasOwnerApproval(input.approvals)) return out("needs-approval");
   if (input.mergeable === null) return out("checking");
-  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 });
+  const gate = mergeGate({ tier: input.tier, ci: input.ci, approvals: input.approvals, draft: isDraft(input), mergeable: input.mergeable, state: input.state ?? "open", merged_at: input.merged_at });
   return gate.allowed ? out("ready") : out("unknown");
 }
 const REVIEW_STATUS_LABEL = {
@@ -3197,6 +3985,10 @@ const REVIEW_STATUS_LABEL = {
   ready: "Ready to merge",
   unknown: "Status unknown"
 };
+const LOOK_AGAIN_STATUS_LABEL = "Updated, look again";
+function reviewStatusLabel(kind, lookAgain) {
+  return kind === "changes-requested" && (lookAgain?.length ?? 0) > 0 ? LOOK_AGAIN_STATUS_LABEL : REVIEW_STATUS_LABEL[kind];
+}
 const CI_STATE_LABEL = {
   pass: "Tests pass",
   fail: "Tests fail",
@@ -3234,8 +4026,8 @@ function reopenEligibility(x) {
 }
 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((m) => ROLE_OF_MISSING[m]);
+function requiredApprovals(tier, valuesOnly) {
+  return mergeGate({ tier, ci: NO_CI, approvals: { approvers: [], changesRequested: [], design: false, tech: false, ...valuesOnly ? { valuesOnly: true } : {} }, draft: false, state: "open" }).missing.map((m) => ROLE_OF_MISSING[m]);
 }
 function pendingApprovals(tier, approvals) {
   if (tier == null || !approvals) return [];
@@ -3323,6 +4115,46 @@ function parseSuggestionAppliedComment(body) {
     return null;
   }
 }
+const SUGGESTION_OVERRIDE_MARK = "bridge-suggestion-override";
+function composeSuggestionOverrideComment(r) {
+  const audit = overrideComment(r.login, r.reason, r.missing).replace(/ Merged from Bridge\.$/, " Approved as owner from Bridge.");
+  const record = { payloadSha: r.payloadSha, login: r.login.replace(/^@/, "").toLowerCase(), missing: r.missing };
+  return [audit, "", `<sub>Applies to version \`${r.payloadSha.slice(0, 7)}\` of this suggestion.</sub>`, "", `<!-- ${SUGGESTION_OVERRIDE_MARK} ${JSON.stringify(record)} -->`].join("\n");
+}
+function parseSuggestionOverrideComment(body) {
+  const text = (body ?? "").trim();
+  if (!text.startsWith(OVERRIDE_HEADING)) return null;
+  const m = new RegExp(`<!-- ${SUGGESTION_OVERRIDE_MARK} (\\{[^\\n]*?\\}) -->`).exec(text);
+  if (!m) return null;
+  try {
+    const r = JSON.parse(m[1]);
+    if (typeof r.payloadSha !== "string" || typeof r.login !== "string") return null;
+    const why = /Owner override by @[\w-]+: ([\s\S]*?)\. Missing:/.exec(text);
+    return { login: r.login, reason: why?.[1] ?? "", missing: Array.isArray(r.missing) ? r.missing.map(String) : [], payloadSha: r.payloadSha };
+  } catch {
+    return null;
+  }
+}
+function suggestionOverrideProblem(x) {
+  const lists = approverLists(x.gov.owners, x.gov.rights ?? null, x.gov.teams);
+  const holders = overrideHolders(x.gov.override, lists).map(norm);
+  if (!x.viewer || !holders.includes(norm(x.viewer))) return "Only an owner the review rules allow to use the owner override can approve as owner.";
+  if (norm(x.viewer) !== norm(x.author)) return "The owner override is for your own suggestion: approve this one the usual way.";
+  const others = eligibleReviewers("approval", { owners: lists, author: x.author });
+  if (others.open || others.logins.length) return "Someone else can review it: ask them instead.";
+  return null;
+}
+function suggestionOverrideOf(comments, gov, opts) {
+  if (!gov.override || !opts.author) return null;
+  for (const c of [...comments].reverse()) {
+    const r = parseSuggestionOverrideComment(c.body);
+    if (!r || r.payloadSha !== opts.payloadSha || !c.author || norm(c.author) !== norm(r.login)) continue;
+    if (suggestionOverrideProblem({ viewer: c.author, author: opts.author, gov })) continue;
+    if (overrideReasonProblem(r.reason, gov.override)) continue;
+    return r;
+  }
+  return null;
+}
 const norm = (l) => l.trim().replace(/^@/, "").toLowerCase();
 const COLLABORATOR = ["OWNER", "MEMBER", "COLLABORATOR"];
 function summarizeSuggestionApprovals(comments, gov, opts) {
@@ -3352,229 +4184,16 @@ function summarizeSuggestionApprovals(comments, gov, opts) {
     latestOld.delete(c.author);
     reviews.push({ user: { login: c.author }, state: r.event === "approve" ? "APPROVED" : "CHANGES_REQUESTED", submitted_at: at });
   });
-  const summary = summarizeApprovals(reviews, lists, opts.author ?? void 0, { soloOwnerCanApproveBoth: gov.soloOwnerCanApproveBoth });
+  const summary = withTokenValueApprovals(summarizeApprovals(reviews, lists, opts.author ?? void 0, { soloOwnerCanApproveBoth: gov.soloOwnerCanApproveBoth }), opts.valuesOnly);
   const stale = [...latestOld.keys()].filter((l) => !summary.approvers.includes(l) && !summary.changesRequested.includes(l));
-  return { ...summary, stale, ignored: [...ignored].filter((l) => !summary.approvers.includes(l)) };
+  const out = { ...summary, stale, ignored: [...ignored].filter((l) => !summary.approvers.includes(l)) };
+  const override = summary.changesRequested.length ? null : suggestionOverrideOf(comments, gov, { payloadSha: opts.payloadSha, author: opts.author });
+  return override ? { ...out, design: true, tech: true, owner: true, override } : out;
 }
 function suggestionReviewState(tier, approvals) {
   if (approvals.changesRequested.length) return "changes-requested";
   return pendingApprovals(tier, approvals).length ? "needs-review" : "approved";
 }
-const where = (r) => r.allVariants ? "every variant" : shortVariants(r.variants.join("; "));
-const cap = (s) => s ? s.charAt(0).toUpperCase() + s.slice(1) : s;
-function planComponentPush(d, ctx) {
-  const issues = [...d.unknown];
-  const reasons = [];
-  const edits = /* @__PURE__ */ new Map();
-  const also = /* @__PURE__ */ new Set();
-  for (const r of d.rebinds) {
-    const label = `${cap(r.kind)} in ${where(r)}`;
-    if (!r.after.length) {
-      issues.push({ what: `${label} is no longer bound to a variable: it uses a raw value.`, todo: "Bind it to a variable, or create the variable and push it with the variables, then push again." });
-      continue;
-    }
-    const missing = r.after.filter((p) => !ctx.tierOf(p));
-    if (missing.length) {
-      issues.push({ what: `${label} uses ${missing.join(", ")}, a variable the library does not have yet.`, todo: "Push the variable first (Variables, above), then push this component again." });
-      continue;
-    }
-    if (!r.before.length) {
-      reasons.push(`${label} is bound to ${r.after.join(", ")} where code paints nothing: Claude AI adds it to the CSS.`);
-      continue;
-    }
-    if (r.before.length !== 1 || r.after.length !== 1) {
-      reasons.push(`${label} moved from ${r.before.join(", ")} to ${r.after.join(", ")}: several variables on one property, so Claude AI writes the CSS.`);
-      continue;
-    }
-    const [from, to] = [r.before[0], r.after[0]];
-    if (ctx.tierOf(from) !== "component") {
-      reasons.push(`Code paints ${r.kind} with ${from} directly, not through a ${d.component} token: Claude AI changes the CSS to ${to}.`);
-      continue;
-    }
-    const elsewhere = ctx.usedElsewhere(from, r);
-    if (elsewhere.variants.length) {
-      const v = elsewhere.variants;
-      const list2 = v.length > 3 ? `${shortVariants(v.slice(0, 3).join("; ")).replace(/ and /, ", ")} and ${v.length - 3} more` : shortVariants(v.join("; "));
-      reasons.push(`${from} also paints ${list2}: pointing it to ${to} would change them too, so Claude AI adds a token for ${where(r)}.`);
-      continue;
-    }
-    for (const c of elsewhere.components) also.add(c);
-    const prev = edits.get(from);
-    if (prev && prev.value !== `{${to}}`) {
-      reasons.push(`${from} moved to two different variables (${String(prev.value).slice(1, -1)} and ${to}): Claude AI splits it.`);
-      edits.delete(from);
-      continue;
-    }
-    edits.set(from, { op: "set", path: from, value: `{${to}}` });
-  }
-  const list = [...edits.values()];
-  if (d.needsCode || reasons.length) {
-    return {
-      route: "claude-draft",
-      said: `Claude AI drafts the code from what you changed, then a person reviews it.${list.length ? ` ${list.length === 1 ? "Its token swap goes" : "Its token swaps go"} with it.` : ""}`,
-      edits: list,
-      reasons,
-      issues,
-      alsoChanges: [...also]
-    };
-  }
-  if (list.length) {
-    const n = list.length;
-    const others = [...also];
-    const names2 = others.length > 3 ? [...others.slice(0, 3), `${others.length - 3} more`] : others;
-    const alsoLine = names2.length ? ` It also repaints ${names2.length > 1 ? `${names2.slice(0, -1).join(", ")} and ${names2[names2.length - 1]}` : names2[0]}: they use the same token${n === 1 ? "" : "s"}.` : "";
-    return { route: "token-change", said: `Exact, no AI: ${n === 1 ? `${list[0].path} points` : `${n} ${d.component} tokens point`} to the new variable${n === 1 ? "" : "s"}, checked for contrast and reviewed like any token change.${alsoLine}`, edits: list, reasons, issues, alsoChanges: others };
-  }
-  return { route: "manual", said: issues.length ? "Fix it in Figma first: nothing is sent until Bridge can read it." : "Nothing to send.", edits: [], reasons, issues, alsoChanges: [] };
-}
-function specsUsage(specs, component) {
-  const own = specs.components.find((x) => x.name === component) ?? specs.components.find((x) => x.component === component);
-  return (path, r) => {
-    const variants = [];
-    const components = [];
-    for (const c of specs.components) {
-      for (const v of c.variants) {
-        if (!Object.values(v.values).some((fields) => Object.values(fields ?? {}).includes(path))) continue;
-        const key = variantKeyOf(v.props);
-        if (c === own) {
-          if (!r.variants.includes(key)) variants.push(key);
-        } else if (!components.includes(c.name)) components.push(c.name);
-      }
-    }
-    return { variants, components };
-  };
-}
-function componentContrastPairs(edits, pairs, tokens) {
-  const out = /* @__PURE__ */ new Map();
-  for (const e of edits) {
-    const target = tokens.aliasOf(e.path);
-    if (!target) continue;
-    const group = e.path.split(".")[0];
-    const sibling = (other) => tokens.paths.find((p) => p !== e.path && p.split(".")[0] === group && tokens.aliasOf(p) === other) ?? other;
-    for (const p of pairs) {
-      if (p.foreground === target) out.set(`${e.path}|${sibling(p.background)}`, { ...p, foreground: e.path, background: sibling(p.background) });
-      if (p.background === target) out.set(`${sibling(p.foreground)}|${e.path}`, { ...p, foreground: sibling(p.foreground), background: e.path });
-    }
-  }
-  return [...out.values()];
-}
-const FROM_FIGMA_LABEL = "from-figma";
-const WAITING_FOR_CLAUDE_LABEL = "waiting-for-claude";
-const DRAFTED_BY_CLAUDE_LABEL = "drafted-by-claude";
-const FIGMA_SPEC_DIR = ".bridge/figma";
-const ORIGIN_MARK = "bridge-from-figma";
-const hidden = (data) => `<!-- ${ORIGIN_MARK} ${JSON.stringify(data).replace(/-->/g, "--\\u003e")} -->`;
-function parseFigmaOrigin(body) {
-  if (!body) return void 0;
-  const m = new RegExp(`<!-- ${ORIGIN_MARK} (\\{[\\s\\S]*?\\}) -->`).exec(body);
-  if (!m) return void 0;
-  try {
-    const o = JSON.parse(m[1]);
-    return typeof o.component === "string" && (o.route === "token-change" || o.route === "claude-draft") ? o : void 0;
-  } catch {
-    return void 0;
-  }
-}
-function figmaOriginSection(o) {
-  const design = o.url ? `[${o.figmaName}](${o.url})` : `"${o.figmaName}"`;
-  const who = o.requestedBy ? ` by @${o.requestedBy}` : "";
-  const status = o.route === "token-change" ? "Exact token change, no AI: Bridge read the token swap from the Figma component." : o.status === "drafted" ? "**Drafted by Claude AI** from the Figma spec. A person reviews it before it ships." : `**Waiting for Claude AI:** this branch carries the spec only, as a request. Claude writes the code here (\`bridge_get_figma_change\`, or \`bridge figma show <number>\`), then it is labelled ${DRAFTED_BY_CLAUDE_LABEL}.`;
-  return [`**From Figma:** ${design}${who}. Once it ships, a pull in the DS Bridge plugin rebuilds the component from this code.`, "", status, "", hidden(o)].join("\n");
-}
-function withFigmaOrigin(body, o) {
-  let b = (body ?? "").trim();
-  const at = b.indexOf("**From Figma:**");
-  const mark = b.indexOf(`<!-- ${ORIGIN_MARK} `);
-  if (at >= 0 && mark > at) {
-    const end = b.indexOf("-->", mark);
-    b = `${b.slice(0, at)}${b.slice(end + 3)}`.trim();
-  }
-  return `${figmaOriginSection(o)}${b ? `
-
-${b}` : ""}`;
-}
-const figmaSpecSlug = (d) => slugify(`${d.component} ${d.title}`, 48);
-const figmaSpecPath = (d) => `${FIGMA_SPEC_DIR}/${figmaSpecSlug(d)}.json`;
-const kindLabel = (k) => REQUEST_KINDS.find((x) => x.value === k)?.label ?? "Change";
-function formatFigmaSpec(d, plan) {
-  return `${JSON.stringify({ ...d, tokenEdits: plan.edits, reasons: plan.reasons, unknown: plan.issues }, null, 2)}
-`;
-}
-function parseFigmaSpec(text) {
-  if (!text) return void 0;
-  try {
-    const s = JSON.parse(text);
-    return s && s.v === 1 && typeof s.component === "string" && Array.isArray(s.changes) ? s : void 0;
-  } catch {
-    return void 0;
-  }
-}
-function figmaDraftBrief(d, ctx) {
-  const dir = `${(ctx.componentsDir ?? "packages/react/src/components").replace(/\/+$/, "")}/${d.component}`;
-  const suggested = "suggestion" in ctx;
-  const variants = Object.entries(d.variantAxes).map(([axis, values2]) => `${axis}: ${values2.join(", ")}`);
-  const props = d.properties.filter((p) => p.type !== "VARIANT").map((p) => `${p.name} (${p.type.toLowerCase().replace("_", " ")}, default ${p.default || "empty"})`);
-  return [
-    suggested ? "Draft the code for a component change made in Figma, sent as a Bridge suggestion (this issue)." : `Draft the code for a component change made in Figma, on the library branch ${ctx.branch} (draft pull request #${ctx.pr}).`,
-    "",
-    d.coded ? `Component: ${d.component} (${dir})` : `New component: ${d.component} (create ${dir})`,
-    `Kind: ${kindLabel(d.kind)}`,
-    `Change: ${d.title}`,
-    ...d.line?.trim() ? [`What changes: ${d.line.trim()}`] : [],
-    "",
-    d.summary.trim(),
-    "",
-    ...d.changes.length ? ["Changes in Figma:", ...d.changes.map((c) => `- ${c.field}: ${c.before ?? "(none)"} -> ${c.after ?? "(removed)"}`), ""] : [],
-    ...variants.length ? ["Variant matrix in Figma:", ...variants.map((v) => `- ${v}`), ""] : [],
-    ...props.length ? ["Properties in Figma:", ...props.map((p) => `- ${p}`), ""] : [],
-    ...d.tokenEdits?.length ? ["Token swaps to make too (exact, with bridge_propose_token_change on this branch or by hand in the token files):", ...d.tokenEdits.map((e) => `- ${e.path} -> ${String(e.value)}`), ""] : [],
-    ...d.reasons?.length ? ["Why this needs code:", ...d.reasons.map((r) => `- ${r}`), ""] : [],
-    `Spec: ${ctx.specPath} ${suggested ? "in the suggestion" : "on the branch"} has the bound variables of every variant (token paths), the layers of every variant and what code gave Figma before.`,
-    ...d.figma?.url ? [`Design: ${d.figma.url}`] : [],
-    ...suggested && d.figma?.fileKey && d.figma.nodeId ? [`Read the design straight from Figma: Figma MCP get_design_context { fileKey: "${d.figma.fileKey}", nodeId: "${d.figma.nodeId}" }${d.figma.before?.nodeId ? ` (before: node ${d.figma.before.nodeId})` : ""}, or the REST API GET https://api.figma.com/v1/files/${d.figma.fileKey}/nodes?ids=${encodeURIComponent(d.figma.nodeId)}.`] : [],
-    ...d.images?.length ? ["Screenshot:", ...d.images.map((u) => `- ${u}`)] : [],
-    "",
-    "Steps:",
-    "suggestion" in ctx ? "1. Apply the suggestion on a new branch: bridge apply <this issue number> (it writes the spec file), or start a branch from the default branch." : `1. git fetch origin && git checkout ${ctx.branch}`,
-    `2. Write the change in ${dir}: the TSX on Base UI, the CSS module with tokens only (the bound variables of the spec, as token paths), the stories (examples), docs.json and a changeset. Follow ${ctx.agentsFile ?? "AGENTS.md"}.`,
-    "3. Run npm run specs so component-specs.json matches the code, then npm test.",
-    "suggestion" in ctx ? '4. Commit, push and open a pull request that says "Closes #<this issue number>", so the suggestion closes when it ships. A person reviews it.' : `4. Commit and push to ${ctx.branch}, then call bridge_mark_figma_change_drafted { pr: ${ctx.pr} } (CLI: bridge figma drafted ${ctx.pr}). The branch is then labelled ${DRAFTED_BY_CLAUDE_LABEL} and a person reviews it.`,
-    "",
-    "Rules:",
-    "- Never invent a token or a value: use the variables the spec lists. A value the library lacks is a token change, said in the pull request.",
-    "- Keep every existing variant and prop unchanged unless the spec changes it.",
-    `- If the spec is unclear, comment on the ${suggested ? "suggestion" : "pull request"} instead of guessing.`
-  ].join("\n");
-}
-function figmaDraftBody(d, plan, o) {
-  const cell2 = (s) => s.replace(/\|/g, "\\|").replace(/\n/g, " ");
-  const rows = d.changes.length ? ["| What | Code now | In Figma |", "| --- | --- | --- |", ...d.changes.map((c) => `| ${cell2(c.field)} | ${cell2(c.before ?? "")} | ${cell2(c.after ?? "")} |`), ""] : [];
-  return withFigmaOrigin(
-    [
-      `## ${d.coded ? `${kindLabel(d.kind)} for ${d.component}` : `New component: ${d.component}`}`,
-      "",
-      d.summary.trim(),
-      "",
-      ...d.line?.trim() ? [`**What changes:** ${d.line.trim()}`, ""] : [],
-      ...rows,
-      ...d.images?.length ? [...d.images.map((u, i) => `![${d.component} in Figma ${i + 1}](${u})`), ""] : [],
-      ...plan.edits.length ? ["**Token swaps to make too:**", ...plan.edits.map((e) => `- \`${e.path}\` -> \`${String(e.value)}\``), ""] : [],
-      ...plan.reasons.length ? ["**Why this needs code:**", ...plan.reasons.map((r) => `- ${r}`), ""] : [],
-      ...plan.issues.length ? ["**Left in Figma (the designer fixes these first):**", ...plan.issues.map((i) => `- ${i.what} ${i.todo}`), ""] : [],
-      `**Spec:** \`${o.spec ?? figmaSpecPath(d)}\` (variant matrix, properties, bound variables and layers of every variant).`
-    ].join("\n"),
-    o
-  );
-}
-const figmaBranchTitle = (d) => requestIssueTitle(d);
-function figmaPushStatus(x) {
-  const labels = x.labels ?? [];
-  if (x.state === "merged") return { key: "shipped", label: "Shipped", sentence: "It shipped. Pull to rebuild the component from the reviewed code.", rebuild: true };
-  if (x.state !== "open") return { key: "closed", label: "Closed", sentence: "The library closed it without shipping. Pull to bring the component back to the code.", rebuild: true };
-  if (labels.includes(WAITING_FOR_CLAUDE_LABEL)) return { key: "waiting-for-claude", label: "Waiting for Claude AI", sentence: "The spec is on the library branch. Claude AI writes the code there, then a person reviews it.", rebuild: false };
-  if (labels.includes(DRAFTED_BY_CLAUDE_LABEL)) return { key: "drafted", label: "Drafted by Claude AI", sentence: "Claude AI drafted the code. A person reviews it before it ships.", rebuild: false };
-  return { key: "in-review", label: "In review", sentence: x.route === "token-change" ? "Owners review the token change." : "Owners review it.", rebuild: false };
-}
 const SUGGESTION_SCHEMA = "bridge.suggestion/1";
 const SUGGESTION_LABEL = "bridge-suggestion";
 const SUGGESTION_KINDS = ["token-change", "docs", "component-spec", "brand", "revert", "config"];
@@ -3836,6 +4455,11 @@ function suggestionKindFromLabels(labels) {
 function suggestionStateFromLabels(labels) {
   return Object.entries(SUGGESTION_STATE_LABELS).find(([, l]) => labels.includes(l))?.[0];
 }
+function suggestionIsTokenValues(p) {
+  if (p.kind !== "token-change" || !p.tokens?.edits.length || p.docs?.length || p.componentSpec) return false;
+  if (!p.tokens.edits.every((e) => e.op === "set" || e.op === "add")) return false;
+  return (p.files ?? []).every((f) => f.path.endsWith(".md"));
+}
 function suggestionStatus(i) {
   const prs = i.linkedPrs ?? [];
   if (i.state === "closed") return prs.some((p) => p.merged) || i.stateReason === "completed" ? "applied" : "declined";
@@ -3906,7 +4530,7 @@ function checksSection(p, max) {
     "",
     `- Token validation: ${c.newErrors ? `**${c.newErrors} new error(s)**` : "no new errors"}`,
     `- Contrast: ${c.contrast.length ? failing.length ? `**${failing.length} failing pair(s)**` : `${c.contrast.length} pair(s) checked, all pass` : "no pair affected"}`,
-    `- Risk tier: ${p.tier.tier} (\`${p.tier.bump}\`), ${p.tier.tier === 1 ? "one approval" : "design and tech approval"}`,
+    `- Risk tier: ${p.tier.tier} (\`${p.tier.bump}\`), ${p.tier.tier === 1 ? "one owner approval" : "design and tech approval"}`,
     `- Impact: ${c.impact ? `${c.impact} token(s) resolve to a new value` : "no other token changes value"}`,
     "",
     ...rows.length ? [...table(["Pair", "Mode", "Before", "After", "Min", "Result"], rows, max), ""] : []
@@ -4380,8 +5004,8 @@ async function planSuggestionApply(input) {
     for (const p of new Set(targets)) if (await ws.isSymlink(p)) links.push(`"${p}" is a symbolic link (or inside one): Bridge never writes through links.`);
     if (links.length) return out("refused", "Not applied: the suggestion writes through a symbolic link.", { problems: links });
   }
-  const governance = input.governance ?? { owners: config.governance.owners, rights: config.governance.rights ?? null, soloOwnerCanApproveBoth: config.governance.soloOwnerCanApproveBoth };
-  const approvals = summarizeSuggestionApprovals(input.comments, governance, { payloadSha: parsed.sha, author: input.author });
+  const governance = input.governance ?? { owners: config.governance.owners, rights: config.governance.rights ?? null, soloOwnerCanApproveBoth: config.governance.soloOwnerCanApproveBoth, override: config.governance.override ?? null };
+  const approvals = summarizeSuggestionApprovals(input.comments, governance, { payloadSha: parsed.sha, author: input.author, valuesOnly: suggestionIsTokenValues(payload) });
   const review = suggestionReviewState(payload.tier.tier, approvals);
   const missing = pendingApprovals(payload.tier.tier, approvals);
   const approved = review === "approved";
@@ -4458,16 +5082,16 @@ async function planSuggestionApply(input) {
   const issueKey2 = (i) => `${i.code}|${i.path ?? ""}|${i.file ?? ""}|${i.message}`;
   const prevErrors = new Set(validateLayered(before).map(issueKey2));
   const newErrors = tokenChanges.length ? validateLayered(after).filter((i) => i.level === "error" && !prevErrors.has(issueKey2(i))) : [];
-  let pairs = [];
+  let pairs2 = [];
   if (config.contrast && tokenChanges.length) {
     try {
-      pairs = parseContrastChecks((await ws.read(config.contrast.path))?.text);
+      pairs2 = parseContrastChecks((await ws.read(config.contrast.path))?.text);
     } catch {
       notes.push(`${config.contrast.path} does not parse: contrast was not checked.`);
     }
   }
   const modes = config.contrast?.modes;
-  const contrast = pairs.length ? contrastDelta(runLayeredContrast(before, pairs, modes), runLayeredContrast(after, pairs, modes)) : [];
+  const contrast = pairs2.length ? contrastDelta(runLayeredContrast(before, pairs2, modes), runLayeredContrast(after, pairs2, modes)) : [];
   const newFailures = contrast.filter((d) => d.passBefore && !d.passAfter);
   const otherFiles = [...writes.keys()].filter((p) => !tokenFileOf(config, p));
   const tier = classifyRisk({ tokenChanges: tokenChanges.map((c) => ({ kind: c.kind, path: c.path, ...c.kind === "changed" ? { descriptionOnly: c.fields.length > 0 && c.fields.every((x) => x === "description") } : {} })), files: otherFiles.map((path) => ({ path })), config });
@@ -4539,6 +5163,7 @@ function listItem(i, pulls) {
     title: i.title,
     url: i.url,
     author: i.author,
+    requester: requesterOf(i.body),
     createdAt: i.createdAt,
     state: i.state,
     stateReason: i.stateReason,
@@ -4554,7 +5179,7 @@ async function getSuggestionOnGitHub(gh, n, gov, opts = {}) {
   const parsed = parseSuggestionIssue(issue.body, { comments, author: issue.author || void 0 });
   const linkedPrs = linkedPullsOf(n, pulls);
   const applied = comments.flatMap((c) => parseSuggestionAppliedComment(c.body) ?? []);
-  const approvals = parsed.ok ? summarizeSuggestionApprovals(comments, gov, { payloadSha: parsed.sha, author: issue.author }) : void 0;
+  const approvals = parsed.ok ? summarizeSuggestionApprovals(comments, gov, { payloadSha: parsed.sha, author: issue.author, valuesOnly: suggestionIsTokenValues(parsed.payload) }) : void 0;
   const status = suggestionStatus({
     state: issue.state,
     stateReason: issue.stateReason,
@@ -4565,6 +5190,19 @@ async function getSuggestionOnGitHub(gh, n, gov, opts = {}) {
   });
   return { issue, parsed, comments, approvals, linkedPrs, applied, status };
 }
+async function approvedSuggestionOnGitHub(gh, body, gov) {
+  for (const n of closingIssueNumbers(body).slice(0, 3)) {
+    const found = await approvedSuggestionNumber(gh, n, gov).catch(() => null);
+    if (found) return found;
+  }
+  return null;
+}
+async function approvedSuggestionNumber(gh, n, gov) {
+  const d = await getSuggestionOnGitHub(gh, n, gov, { pulls: [] });
+  if (!d.parsed.ok || !d.approvals) return null;
+  const tier = d.parsed.payload.tier.tier;
+  return suggestionReviewState(tier, d.approvals) === "approved" ? { number: n, approvals: d.approvals, tier } : null;
+}
 async function syncSuggestionStateLabel(gh, n, labels, status) {
   const { add, remove } = suggestionLabelChanges(labels, status);
   let ok = true;
@@ -4662,6 +5300,27 @@ async function reviewSuggestionOnGitHub(gh, n, input, gov) {
   if (labelWarning) warnings.push(labelWarning);
   return { commentUrl: posted.url, payloadSha: sha, status, counts, warnings };
 }
+async function overrideSuggestionOnGitHub(gh, n, input, gov) {
+  if (!gov.override) throw new GitHubError(422, "The review rules allow no owner override.");
+  const before = await getSuggestionOnGitHub(gh, n, gov);
+  if (!before.parsed.ok) throw new GitHubError(422, `#${n} cannot be approved: ${before.parsed.message}`);
+  if (before.issue.state === "closed") throw new GitHubError(422, `#${n} is closed.`);
+  const sha = before.parsed.sha;
+  if (input.payloadSha && input.payloadSha !== sha) throw new GitHubError(409, `#${n} changed since you opened it. Reload it and approve the new version.`);
+  const by = input.by ?? (await gh.getViewer().catch(() => ({ login: "" }))).login;
+  const problem = suggestionOverrideProblem({ viewer: by, author: before.issue.author, gov }) ?? overrideReasonProblem(input.reason, gov.override);
+  if (problem) throw new GitHubError(422, problem);
+  if (before.approvals?.changesRequested.length) throw new GitHubError(422, `Changes were asked for on #${n}: the owner override covers missing approvals only.`);
+  const missing = pendingApprovals(before.parsed.payload.tier.tier, before.approvals ?? { approvers: [], changesRequested: [], design: false, tech: false }).map((r) => r === "design" ? "design approval" : r === "tech" ? "tech approval" : "approval");
+  const posted = await gh.createIssueComment(n, composeSuggestionOverrideComment({ login: by, reason: input.reason, missing, payloadSha: sha }));
+  const after = await getSuggestionOnGitHub(gh, n, gov);
+  const counts = Boolean(after.approvals?.override);
+  const warnings = [];
+  if (!counts) warnings.push("The owner override is posted but does not count: check the owners and the override in bridge.config.json.");
+  const labelWarning = await syncSuggestionStateLabel(gh, n, before.issue.labels, after.status);
+  if (labelWarning) warnings.push(labelWarning);
+  return { commentUrl: posted.url, payloadSha: sha, status: after.status, counts, warnings };
+}
 async function linkSuggestionPrOnGitHub(gh, n, link) {
   if (!link.pr && !link.branch && !link.commit) throw new GitHubError(422, "Say where it is applied: a pull request number, a branch or a commit.");
   const issue = await gh.getIssue(n);
@@ -4689,6 +5348,11 @@ const DOCS_MCP_ORIGIN = {
   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 DOCS_CLI_ORIGIN = {
+  where: "with the bridge CLI",
+  footer: 'Proposed with the bridge CLI on behalf of a person. Docs Claude drafted say "draftedBy": "claude" until a reviewer accepts them.',
+  label: "source: cli"
+};
 const EM_DASH = /\u2014/;
 function validateDocs(d) {
   const out = [];
@@ -4821,7 +5485,7 @@ ${opts.notes.trim()}
   ].filter((x, i, a) => !(x === "" && a[i - 1] === "")).join("\n");
   return { branch, title, body, files, risk, bump: "patch", labels: ["docs", origin.label, `tier-${risk.tier}`] };
 }
-const docsSource = (origin) => origin.label === DOCS_MCP_ORIGIN.label ? "mcp" : "studio";
+const docsSource = (origin) => origin.label === DOCS_MCP_ORIGIN.label ? "mcp" : origin.label === DOCS_CLI_ORIGIN.label ? "cli" : "studio";
 function docsSuggestionPayload(edits, opts) {
   const origin = opts.origin ?? DOCS_EDITOR_ORIGIN;
   const date = opts.date ?? /* @__PURE__ */ new Date();
@@ -4898,6 +5562,149 @@ async function commitFileOnGitHub(gh, input) {
   if (content === cur.text) return "";
   return gh.putFile({ path: input.path, content, branch: input.branch, message: input.message, sha: cur.sha });
 }
+class StorybookIndexError extends Error {
+  constructor(code, message, status) {
+    super(message);
+    this.code = code;
+    this.status = status;
+    this.name = "StorybookIndexError";
+  }
+  code;
+  status;
+}
+const isObj = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+const str = (v) => typeof v === "string" && v.trim() ? v : void 0;
+function entryFrom(key, raw, v3) {
+  if (!isObj(raw)) return null;
+  const id = str(raw.id) ?? key;
+  const title = str(raw.title) ?? str(raw.kind);
+  const name = str(raw.name) ?? str(raw.story);
+  if (!id || !title || !name) return null;
+  const params = isObj(raw.parameters) ? raw.parameters : {};
+  const type = raw.type === "docs" || raw.type === "story" ? raw.type : v3 && params.docsOnly === true ? "docs" : "story";
+  const e = {
+    id,
+    title,
+    name,
+    type,
+    importPath: str(raw.importPath) ?? str(params.fileName) ?? "",
+    tags: Array.isArray(raw.tags) ? raw.tags.filter((t) => typeof t === "string") : []
+  };
+  const subtype = str(raw.subtype);
+  if (subtype) e.subtype = subtype;
+  const exportName = str(raw.exportName);
+  if (exportName) e.exportName = exportName;
+  const componentPath = str(raw.componentPath);
+  if (componentPath) e.componentPath = componentPath;
+  return e;
+}
+function groupStorybookComponents(entries) {
+  const byTitle = /* @__PURE__ */ new Map();
+  for (const e of entries) {
+    let c = byTitle.get(e.title);
+    if (!c) {
+      const parts = e.title.split("/").map((p) => p.trim()).filter(Boolean);
+      c = { title: e.title, name: parts[parts.length - 1] ?? e.title, group: parts.slice(0, -1), stories: [], docs: [], tags: [] };
+      byTitle.set(e.title, c);
+    }
+    if (e.type === "docs") c.docs.push(e);
+    else if (e.subtype !== "test") c.stories.push(e);
+    for (const t of e.tags) if (!c.tags.includes(t)) c.tags.push(t);
+  }
+  const out = [...byTitle.values()].filter((c) => c.stories.length || c.docs.length);
+  for (const c of out) c.tags.sort();
+  return out.sort((a, b) => a.title.localeCompare(b.title));
+}
+function parseStorybookIndex(json, source) {
+  if (!isObj(json)) throw new StorybookIndexError("not-json", "The Storybook index is not a JSON object.");
+  if (typeof json.loginUrl === "string" && !("entries" in json) && !("stories" in json)) {
+    throw new StorybookIndexError("private", "This Storybook is private: it asks for a sign-in before showing its index.");
+  }
+  const map = isObj(json.entries) ? json.entries : isObj(json.stories) ? json.stories : null;
+  if (!map) throw new StorybookIndexError("empty", "This file has no Storybook entries.");
+  const v3 = !isObj(json.entries);
+  const entries = Object.entries(map).map(([k, raw]) => entryFrom(k, raw, v3)).filter((e) => e !== null);
+  if (!entries.length) throw new StorybookIndexError("empty", "This Storybook index lists no stories or docs.");
+  const version = typeof json.v === "number" ? json.v : v3 ? 3 : 4;
+  return { version, source: source ?? (v3 ? "stories.json" : "index.json"), entries, components: groupStorybookComponents(entries) };
+}
+function normalizeStorybookUrl(input) {
+  let u;
+  try {
+    u = new URL(input.trim());
+  } catch {
+    throw new StorybookIndexError("invalid-url", "Enter the full Storybook address, for example https://storybook.example.com");
+  }
+  const local = u.hostname === "localhost" || u.hostname === "127.0.0.1" || u.hostname === "[::1]";
+  if (u.protocol !== "https:" && !(u.protocol === "http:" && local)) {
+    throw new StorybookIndexError("invalid-url", "The Storybook address must start with https://");
+  }
+  if (u.username || u.password) throw new StorybookIndexError("invalid-url", "Remove the user name and password from the address.");
+  const path = u.pathname.replace(/\/(index\.html|iframe\.html|index\.json|stories\.json)$/i, "/").replace(/\/+$/, "");
+  return `${u.protocol}//${u.host}${path}`;
+}
+const storybookIndexUrls = (base) => {
+  const b = base.replace(/\/+$/, "");
+  return [
+    { url: `${b}/index.json`, source: "index.json" },
+    { url: `${b}/stories.json`, source: "stories.json" }
+  ];
+};
+const pairs = (o) => Object.entries(o).map(([k, v]) => `${encodeURIComponent(k)}:${encodeURIComponent(v)}`).join(";");
+function storybookIframeUrl(base, id, o = {}) {
+  let url = `${base.replace(/\/+$/, "")}/iframe.html?id=${encodeURIComponent(id)}&viewMode=${o.viewMode ?? "story"}`;
+  if (o.globals && Object.keys(o.globals).length) url += `&globals=${pairs(o.globals)}`;
+  if (o.args && Object.keys(o.args).length) url += `&args=${pairs(o.args)}`;
+  return url;
+}
+function storybookManagerUrl(base, id, viewMode = "story") {
+  return `${base.replace(/\/+$/, "")}/?path=/${viewMode}/${encodeURIComponent(id)}`;
+}
+async function fetchStorybookIndex(base, o = {}) {
+  const doFetch = o.fetch ?? ((url, init) => fetch(url, init));
+  const rank = { private: 6, http: 5, network: 4, empty: 3, "not-json": 2, "not-found": 1, "invalid-url": 0 };
+  let worst = null;
+  const keep = (e) => {
+    if (!worst || rank[e.code] > rank[worst.code]) worst = e;
+  };
+  for (const { url, source } of storybookIndexUrls(base)) {
+    let res;
+    try {
+      res = await doFetch(url, { headers: { accept: "application/json" }, ...o.signal ? { signal: o.signal } : {} });
+    } catch (err) {
+      if (o.signal?.aborted) throw err;
+      keep(new StorybookIndexError("network", `Could not reach ${url}. The host may be down or may not allow reading from another site.`));
+      continue;
+    }
+    if (res.status === 404 || res.status === 410) {
+      keep(new StorybookIndexError("not-found", `No Storybook index at ${base}: neither index.json nor stories.json was found.`, res.status));
+      continue;
+    }
+    if (res.status === 401 || res.status === 403) {
+      keep(new StorybookIndexError("private", "This Storybook is private: it asks for a sign-in before showing its index.", res.status));
+      continue;
+    }
+    if (!res.ok) {
+      keep(new StorybookIndexError("http", `The Storybook host answered ${res.status} for ${url}.`, res.status));
+      continue;
+    }
+    const text = await res.text();
+    let json;
+    try {
+      json = JSON.parse(text);
+    } catch {
+      keep(new StorybookIndexError("not-json", `${url} is not a Storybook index (the host answered with a web page).`));
+      continue;
+    }
+    try {
+      return parseStorybookIndex(json, source);
+    } catch (err) {
+      if (err instanceof StorybookIndexError) keep(err);
+      else throw err;
+    }
+  }
+  throw worst ?? new StorybookIndexError("not-found", `No Storybook index at ${base}.`);
+}
 function normalizeRepoPath(path) {
   return path.replace(/\\/g, "/").split("/").filter((s) => s && s !== ".").join("/");
 }
@@ -4944,274 +5751,323 @@ async function readRepoTexts(source, paths, concurrency = 4, onError = (_path, e
   return out;
 }
 export {
-  figmaSpecPath as $,
+  classifyLayered as $,
   explorationPrTitle as A,
   explorationPrBody as B,
-  variantKeyOf as C,
+  compareSpecToMeasured as C,
   DRAFT_LINE_MAX as D,
   EXPLORATION_PREFIX as E,
-  overrideComment as F,
+  variantKeyOf as F,
   GitHubError as G,
-  overrideRefusedComment as H,
-  suggestionStateFromLabels as I,
-  suggestionStatus as J,
-  composeRequestIssue as K,
-  EXPLORATION_NOTES_DIR as L,
-  isExplorationBranch as M,
-  diffLayered as N,
+  withoutAddedWrappers as H,
+  pairParts as I,
+  COLOR_FIELDS as J,
+  hashSpec as K,
+  DRAFTED_BY_CLAUDE_LABEL as L,
+  overrideComment as M,
+  overrideRefusedComment as N,
   OVERRIDE_HEADING as O,
   PROSE_KEYS as P,
-  contrastDelta as Q,
+  suggestionStateFromLabels as Q,
   REQUESTS_BRANCH as R,
-  runLayeredContrast as S,
-  layeredImpact as T,
-  classifyLayered as U,
-  composeProposalBody as V,
-  createSuggestionOnGitHub as W,
-  gitBlobSha as X,
-  SUGGESTION_SCHEMA as Y,
-  branchWithJiraKey as Z,
-  titleWithJiraKey as _,
+  SPEC_FIELDS as S,
+  suggestionStatus as T,
+  composeRequestIssue as U,
+  EXPLORATION_NOTES_DIR as V,
+  isExplorationBranch as W,
+  diffLayered as X,
+  contrastDelta as Y,
+  runLayeredContrast as Z,
+  layeredImpact as _,
   parseChangelog as a,
-  TOKEN_SETTINGS_URL as a$,
-  formatFigmaSpec as a0,
-  figmaDraftBrief as a1,
-  parseFigmaOrigin as a2,
-  figmaPushStatus as a3,
-  parseFigmaSpec as a4,
-  FIGMA_SPEC_DIR as a5,
-  FROM_FIGMA_LABEL as a6,
-  withFigmaOrigin as a7,
-  WAITING_FOR_CLAUDE_LABEL as a8,
-  DRAFTED_BY_CLAUDE_LABEL as a9,
-  DOCS_EDITOR_ORIGIN as aA,
-  DOCS_KEYS as aB,
-  DOCS_MCP_ORIGIN as aC,
-  EXPLORATION_CHECK as aD,
-  EXPLORATION_STATUS_LABEL as aE,
-  EXPLORATION_TIER_LABEL as aF,
-  EXPLORATION_USE_CASES as aG,
-  PULL_STATE_PILL as aH,
-  ProtectedBranchError as aI,
-  REDUCED_MOTION_NOTE as aJ,
-  REQUEST_STATUS_LABEL as aK,
-  REVIEW_STATUS_LABEL as aL,
-  REVIEW_STATUS_ORDER as aM,
-  SPEC_FIELDS as aN,
-  SUGGESTION_APPLIED_MARK as aO,
-  SUGGESTION_APPLY_EXIT as aP,
-  SUGGESTION_FINAL_LABELS as aQ,
-  SUGGESTION_KINDS as aR,
-  SUGGESTION_LABEL as aS,
-  SUGGESTION_LIMITS as aT,
-  SUGGESTION_REVIEW_MARK as aU,
-  SUGGESTION_STATE_LABELS as aV,
-  SUGGESTION_STATUS_LABEL as aW,
-  SUGGESTION_STATUS_LABELS as aX,
-  SUGGESTION_TOO_LARGE as aY,
-  SuggestionError as aZ,
-  TOKEN_REJECTED_MESSAGE as a_,
-  planComponentPush as aa,
-  figmaOriginSection as ab,
-  figmaBranchTitle as ac,
-  figmaSpecSlug as ad,
-  figmaDraftBody as ae,
-  REQUEST_LABEL as af,
-  figmaNodeUrl as ag,
-  parentDir as ah,
-  parseComponentSpecs as ai,
-  readRepoTexts as aj,
-  normalizeRepoPath as ak,
-  isUnder as al,
-  GitHubClient as am,
-  effectiveTier as an,
-  parseRequestIssue as ao,
-  requestStatus as ap,
-  listSuggestionsOnGitHub as aq,
-  getSuggestionOnGitHub as ar,
-  BULK_LIMIT as as,
-  CI_STATE_LABEL as at,
-  COLOR_FIELDS as au,
-  COMPONENT_SPECS_VERSION as av,
-  CONFLICT_REASON as aw,
-  DEFAULT_COMPONENT_SPECS_FILE as ax,
-  DEFAULT_PROTECTED_BRANCHES as ay,
-  DOCS_CHANGE_BUMP as az,
+  REVIEW_STATUS_ORDER as a$,
+  composeProposalBody as a0,
+  createSuggestionOnGitHub as a1,
+  gitBlobSha as a2,
+  SUGGESTION_SCHEMA as a3,
+  branchWithJiraKey as a4,
+  titleWithJiraKey as a5,
+  figmaSpecPath as a6,
+  formatFigmaSpec as a7,
+  figmaDraftBrief as a8,
+  parseFigmaOrigin as a9,
+  requestIssueTitle as aA,
+  pullState as aB,
+  summarizeCi as aC,
+  summarizeApprovals as aD,
+  BULK_LIMIT as aE,
+  CI_STATE_LABEL as aF,
+  COMPONENT_SPECS_VERSION as aG,
+  CONFLICT_REASON as aH,
+  DEFAULT_COMPONENT_SPECS_FILE as aI,
+  DEFAULT_PROTECTED_BRANCHES as aJ,
+  DOCS_CHANGE_BUMP as aK,
+  DOCS_CLI_ORIGIN as aL,
+  DOCS_EDITOR_ORIGIN as aM,
+  DOCS_KEYS as aN,
+  DOCS_MCP_ORIGIN as aO,
+  EXPLORATION_CHECK as aP,
+  EXPLORATION_STATUS_LABEL as aQ,
+  EXPLORATION_TIER_LABEL as aR,
+  EXPLORATION_USE_CASES as aS,
+  FORMER_MEMBER as aT,
+  LOOK_AGAIN_STATUS_LABEL as aU,
+  MeasuredSpecsError as aV,
+  PULL_STATE_PILL as aW,
+  ProtectedBranchError as aX,
+  REDUCED_MOTION_NOTE as aY,
+  REQUEST_STATUS_LABEL as aZ,
+  REVIEW_STATUS_LABEL as a_,
+  figmaPushStatus as aa,
+  parseFigmaSpec as ab,
+  FIGMA_SPEC_DIR as ac,
+  FROM_FIGMA_LABEL as ad,
+  withFigmaOrigin as ae,
+  WAITING_FOR_CLAUDE_LABEL as af,
+  planComponentPush as ag,
+  figmaOriginSection as ah,
+  figmaBranchTitle as ai,
+  figmaSpecSlug as aj,
+  figmaDraftBody as ak,
+  REQUEST_LABEL as al,
+  figmaNodeUrl as am,
+  parentDir as an,
+  parseComponentSpecs as ao,
+  readRepoTexts as ap,
+  normalizeRepoPath as aq,
+  isUnder as ar,
+  componentMotion as as,
+  GitHubClient as at,
+  effectiveTier as au,
+  parseRequestIssue as av,
+  requestStatus as aw,
+  listSuggestionsOnGitHub as ax,
+  getSuggestionOnGitHub as ay,
+  closingIssueNumbers as az,
   buildReport as b,
-  hasWriteAccess as b$,
-  TRIGGER_LABELS as b0,
-  UNRELEASED as b1,
-  acceptDocsDraft as b2,
-  acceptDocsText as b3,
-  allowedMergeMethods as b4,
-  anatomyLabel as b5,
-  appliedStatus as b6,
-  assertSafeBranch as b7,
-  assignRequestOnGitHub as b8,
-  assignVersions as b9,
-  declineSuggestionOnGitHub as bA,
-  defaultDocsFooter as bB,
-  docsAuthorLine as bC,
-  docsFileText as bD,
-  docsProposal as bE,
-  docsSectionShapes as bF,
-  docsSlug as bG,
-  docsSuggestionPayload as bH,
-  docsText as bI,
-  draftChangeLine as bJ,
-  draftPushDescription as bK,
-  draftRequestText as bL,
-  eligibleReviewers as bM,
-  explorationBranch as bN,
-  explorationRules as bO,
-  explorationShareMessage as bP,
-  explorationSlugFromBranch as bQ,
-  figmaCell as bR,
-  fileModes as bS,
-  filterHistory as bT,
-  findOpenDocsProposal as bU,
-  findOpenDocsProposalOnGitHub as bV,
-  firstParagraph as bW,
-  formatDocsJson as bX,
-  friendlyMessage as bY,
-  githubSuggestionWorkspace as bZ,
-  hasSuggestionBlock as b_,
-  base64ToUtf8 as ba,
-  bridgeMcpInstallCommand as bb,
-  canOverride as bc,
-  canonicalJson as bd,
-  changeTable as be,
-  changesetBump as bf,
-  classifyAuth as bg,
-  cleanDocs as bh,
-  clearSharedEtags as bi,
-  closingIssueNumbers as bj,
-  commitFileOnGitHub as bk,
-  componentContrastPairs as bl,
-  componentMotion as bm,
-  componentsUsingMotionToken as bn,
-  composeChangeset as bo,
-  composeSuggestionAppliedComment as bp,
-  composeSuggestionIssue as bq,
-  composeSuggestionReviewComment as br,
-  continueDocsProposalOnGitHub as bs,
-  contrastDeltaTable as bt,
-  countChanges as bu,
-  coverageSummary as bv,
-  cssModuleClasses as bw,
-  declineComment as bx,
-  declineReasonProblems as by,
-  declineRequestOnGitHub as bz,
+  docsSlug as b$,
+  SUGGESTION_APPLIED_MARK as b0,
+  SUGGESTION_APPLY_EXIT as b1,
+  SUGGESTION_FINAL_LABELS as b2,
+  SUGGESTION_KINDS as b3,
+  SUGGESTION_LABEL as b4,
+  SUGGESTION_LIMITS as b5,
+  SUGGESTION_OVERRIDE_MARK as b6,
+  SUGGESTION_REVIEW_MARK as b7,
+  SUGGESTION_STATE_LABELS as b8,
+  SUGGESTION_STATUS_LABEL as b9,
+  claudeStage as bA,
+  cleanDocs as bB,
+  clearSharedEtags as bC,
+  commitFileOnGitHub as bD,
+  componentContrastPairs as bE,
+  componentsUsingMotionToken as bF,
+  composeChangeset as bG,
+  composeSuggestionAppliedComment as bH,
+  composeSuggestionIssue as bI,
+  composeSuggestionOverrideComment as bJ,
+  composeSuggestionReviewComment as bK,
+  continueDocsProposalOnGitHub as bL,
+  contrastDeltaTable as bM,
+  countChanges as bN,
+  coverageSummary as bO,
+  cssColorToRgb as bP,
+  cssColorsToRgb as bQ,
+  cssModuleClasses as bR,
+  declineComment as bS,
+  declineReasonProblems as bT,
+  declineRequestOnGitHub as bU,
+  declineSuggestionOnGitHub as bV,
+  defaultDocsFooter as bW,
+  docsAuthorLine as bX,
+  docsFileText as bY,
+  docsProposal as bZ,
+  docsSectionShapes as b_,
+  SUGGESTION_STATUS_LABELS as ba,
+  SUGGESTION_TOO_LARGE as bb,
+  StorybookIndexError as bc,
+  SuggestionError as bd,
+  TOKEN_REJECTED_MESSAGE as be,
+  TOKEN_SETTINGS_URL as bf,
+  TRIGGER_LABELS as bg,
+  UNRELEASED as bh,
+  acceptDocsDraft as bi,
+  acceptDocsText as bj,
+  allowedMergeMethods as bk,
+  anatomyLabel as bl,
+  appliedStatus as bm,
+  approvedSuggestionNumber as bn,
+  approvedSuggestionOnGitHub as bo,
+  assertSafeBranch as bp,
+  assignRequestOnGitHub as bq,
+  assignVersions as br,
+  base64ToUtf8 as bs,
+  branchVerdict as bt,
+  bridgeMcpInstallCommand as bu,
+  canOverride as bv,
+  canonicalJson as bw,
+  changeTable as bx,
+  changesetBump as by,
+  classifyAuth as bz,
   collectHistory as c,
-  sectionsNeedingReview as c$,
-  hashSpec as c0,
-  iconComponentName as c1,
-  installationFor as c2,
-  isActiveExploration as c3,
-  isAutomationPull as c4,
-  isDocsProposalBranch as c5,
-  isGuardrailPath as c6,
-  isJiraKey as c7,
-  isMissingPermission as c8,
-  isReleasePull as c9,
-  parseSuggestionReviewComment as cA,
-  parseTier as cB,
-  patchDocsJson as cC,
-  pendingApprovals as cD,
-  permissionLabel as cE,
-  planRestore as cF,
-  planRevert as cG,
-  planSuggestionApply as cH,
-  planToJson as cI,
-  prNumberFromSubject as cJ,
-  prefillDocs as cK,
-  proposeDocsOnGitHub as cL,
-  propsTable as cM,
-  pullState as cN,
-  pushChangeRows as cO,
-  rateLimitMessage as cP,
-  releasePull as cQ,
-  reopenEligibility as cR,
-  requestBrief as cS,
-  requestImagePath as cT,
-  requestIssueTitle as cU,
-  requiredApprovals as cV,
-  requiredPermission as cW,
-  reviewQueue as cX,
-  reviewStatusKind as cY,
-  reviewSuggestionOnGitHub as cZ,
-  reviewersToAsk as c_,
-  isTokenRejected as ca,
-  jiraIssueFields as cb,
-  jiraKeyOf as cc,
-  joinRepoPath as cd,
-  linkRequestToExplorationOnGitHub as ce,
-  linkSuggestionPrOnGitHub as cf,
-  linkedPullsOf as cg,
-  loadRepoFiles as ch,
-  lowerFirstWord as ci,
-  markSuggestionsAppliedOnGitHub as cj,
-  memoryEtagStore as ck,
-  memorySource as cl,
-  mergeGate as cm,
-  missingPermissionMessage as cn,
-  missingProse as co,
-  modeLabel as cp,
-  needsDocsReview as cq,
-  openPulls as cr,
-  overrideReasonProblem as cs,
-  parseChangesetText as ct,
-  parseJiraKey as cu,
-  parseOverrideComment as cv,
-  parseRepo as cw,
-  parseStructureChange as cx,
-  parseSuggestionAppliedComment as cy,
-  parseSuggestionIssue as cz,
+  parseChangesetText as c$,
+  docsSuggestionPayload as c0,
+  docsText as c1,
+  draftChangeLine as c2,
+  draftPushDescription as c3,
+  draftRequestText as c4,
+  eligibleReviewers as c5,
+  evalCalc as c6,
+  explorationBranch as c7,
+  explorationRules as c8,
+  explorationShareMessage as c9,
+  isTokenRejected as cA,
+  jiraIssueFields as cB,
+  jiraKeyOf as cC,
+  joinRepoPath as cD,
+  linkRequestToExplorationOnGitHub as cE,
+  linkSuggestionPrOnGitHub as cF,
+  linkedPullsOf as cG,
+  loadRepoFiles as cH,
+  lookAgainReviewers as cI,
+  lowerFirstWord as cJ,
+  markSuggestionsAppliedOnGitHub as cK,
+  markUsedTokens as cL,
+  memoryEtagStore as cM,
+  memorySource as cN,
+  mergeGate as cO,
+  missingPermissionMessage as cP,
+  missingProse as cQ,
+  modeLabel as cR,
+  needsDocsReview as cS,
+  normalizeStorybookUrl as cT,
+  openPulls as cU,
+  overrideHolders as cV,
+  overrideReasonMin as cW,
+  overrideReasonProblem as cX,
+  overrideSuggestionOnGitHub as cY,
+  ownerOverridePolicy as cZ,
+  parseBoxShadow as c_,
+  explorationSlugFromBranch as ca,
+  fetchStorybookIndex as cb,
+  figmaCell as cc,
+  fileModes as cd,
+  filterHistory as ce,
+  findOpenDocsProposal as cf,
+  findOpenDocsProposalOnGitHub as cg,
+  firstParagraph as ch,
+  formatDocsJson as ci,
+  friendlyMessage as cj,
+  githubSuggestionWorkspace as ck,
+  groupStorybookComponents as cl,
+  hasOwnerApproval as cm,
+  hasSuggestionBlock as cn,
+  hasWriteAccess as co,
+  iconComponentName as cp,
+  installationFor as cq,
+  isActiveExploration as cr,
+  isAutomationPull as cs,
+  isDocsProposalBranch as ct,
+  isDraft as cu,
+  isGuardrailPath as cv,
+  isJiraKey as cw,
+  isMissingPermission as cx,
+  isPlatformRefusal as cy,
+  isReleasePull as cz,
   applyTokenEdits as d,
-  sha256Hex as d0,
-  shortVariant as d1,
-  shortVariants as d2,
-  specHash as d3,
-  specsUsage as d4,
-  stalenessStatus as d5,
-  subjectTitle as d6,
-  suggestionAllowedRoots as d7,
-  suggestionAppliedComment as d8,
-  suggestionApplyTable as d9,
-  validateIntegrations as dA,
-  variantName as dB,
-  versionTimeline as dC,
-  webStorageEtagStore as dD,
-  withAuthorLine as dE,
-  withOutdated as dF,
-  withRequestExploration as dG,
-  withoutJiraKey as dH,
-  suggestionIssueTitle as da,
-  suggestionKindFromLabels as db,
-  suggestionLabelChanges as dc,
-  suggestionLabels as dd,
-  suggestionPathProblems as de,
-  suggestionPayloadSha as df,
-  suggestionReviewState as dg,
-  suggestionShapeProblems as dh,
-  suggestionStalenessOnGitHub as di,
-  suggestionStateLabel as dj,
-  suggestionSubject as dk,
-  suggestionTouches as dl,
-  summarizeApprovals as dm,
-  summarizeCi as dn,
-  summarizeSuggestionApprovals as dp,
-  syncSuggestionStateLabel as dq,
-  titleOf as dr,
-  toChangeSummary as ds,
-  tokenCssVar as dt,
-  tokenFingerprint as du,
-  tokenHistory as dv,
-  unsafePathProblem as dw,
-  utf8ToBase64 as dx,
-  validateComponentSpec as dy,
-  validateDocs as dz,
+  suggestionReviewState as d$,
+  parseJiraKey as d0,
+  parseMeasuredSpecsFile as d1,
+  parseOverrideComment as d2,
+  parseRepo as d3,
+  parseStorybookIndex as d4,
+  parseStructureChange as d5,
+  parseSuggestionAppliedComment as d6,
+  parseSuggestionIssue as d7,
+  parseSuggestionOverrideComment as d8,
+  parseSuggestionReviewComment as d9,
+  reviewStatusLabel as dA,
+  reviewSuggestionOnGitHub as dB,
+  reviewersToAsk as dC,
+  sectionsNeedingReview as dD,
+  sha256Hex as dE,
+  sharedTokenPrefix as dF,
+  shortVariant as dG,
+  shortVariants as dH,
+  specHash as dI,
+  specsUsage as dJ,
+  stalenessStatus as dK,
+  storybookIframeUrl as dL,
+  storybookIndexUrls as dM,
+  storybookManagerUrl as dN,
+  subjectTitle as dO,
+  suggestionAllowedRoots as dP,
+  suggestionAppliedComment as dQ,
+  suggestionApplyTable as dR,
+  suggestionIsTokenValues as dS,
+  suggestionIssueTitle as dT,
+  suggestionKindFromLabels as dU,
+  suggestionLabelChanges as dV,
+  suggestionLabels as dW,
+  suggestionOverrideOf as dX,
+  suggestionOverrideProblem as dY,
+  suggestionPathProblems as dZ,
+  suggestionPayloadSha as d_,
+  parseTier as da,
+  patchDocsJson as db,
+  pendingApprovals as dc,
+  permissionLabel as dd,
+  planRestore as de,
+  planRevert as df,
+  planSuggestionApply as dg,
+  planToJson as dh,
+  prNumberFromSubject as di,
+  prefillDocs as dj,
+  proposeDocsOnGitHub as dk,
+  propsTable as dl,
+  pushChangeRows as dm,
+  rateLimitMessage as dn,
+  releasePull as dp,
+  reopenEligibility as dq,
+  requestBrief as dr,
+  requestImagePath as ds,
+  requesterFirstName as dt,
+  requesterLine as du,
+  requesterOf as dv,
+  requiredApprovals as dw,
+  requiredPermission as dx,
+  reviewQueue as dy,
+  reviewStatusKind as dz,
   buildHistoryEntry as e,
+  suggestionShapeProblems as e0,
+  suggestionStalenessOnGitHub as e1,
+  suggestionStateLabel as e2,
+  suggestionSubject as e3,
+  suggestionTouches as e4,
+  summarizeSuggestionApprovals as e5,
+  syncSuggestionStateLabel as e6,
+  titleOf as e7,
+  toChangeSummary as e8,
+  tokenCssVar as e9,
+  tokenFingerprint as ea,
+  tokenHistory as eb,
+  tokenVariablePath as ec,
+  unsafePathProblem as ed,
+  utf8ToBase64 as ee,
+  validateComponentSpec as ef,
+  validateDocs as eg,
+  validateIntegrations as eh,
+  variantName as ei,
+  versionTimeline as ej,
+  webStorageEtagStore as ek,
+  withAuthorLine as el,
+  withFigmaPushApprovals as em,
+  withOutdated as en,
+  withRequestExploration as eo,
+  withSrgbColors as ep,
+  withSuggestionApprovals as eq,
+  withTokenValueApprovals as er,
+  withoutJiraKey as es,
   coerceValue as f,
   checkLayeredPair as g,
   formatChangeset as h,
@@ -5234,4 +6090,4 @@ export {
   explorationNote as y,
   explorationNotePath as z
 };
-//# sourceMappingURL=repo-source-CRfhLO87.js.map
+//# sourceMappingURL=repo-source-CshjjC7x.js.map