@bridge-ds/core 0.22.0 → 0.24.0

package/dist/{repo-source-CcWmqNBZ.js → repo-source-vRf_Jfbz.js}

@@ -1,4 +1,4 @@
-import { cw as tokenBump, a_ as changeKind, L as LayeredTokenSet, aS as aliasOf, c9 as rgbaToDtcg, by as hexToRgba, w as parseTokenFile, q as emptyTokenFile, s as serializeTokenFile, C as moveToken, r as removeToken, bB as inheritedTypeAt, u as upsertToken, H as readTokenAt, b4 as comboKey, c8 as renderedColor, bc as contrastRatio, z as rgbaToHex, U as classifyRisk, bl as figmaPushNextLine, W as RISK_LABELS, bm as figmaPushTierLabel, V as CONFIG_FILE, N as loadConfig, am as ConfigError, af as DEFAULT_TOKEN_PATHS, al as globToRegExp, aj as slugify, Q as validateLayered, bT as parseJson, cd as serializeJson, bZ as plainEqual, cv as toPlain, bv as getEntry, bt as fromPlain, m as modeDisplayName, A as formatValue, _ as previewUrl, M as resolveBranchPreviews, ai as readPreviewComment, O as tokensPath, a4 as NEEDED_BY_LABEL, aZ as canShip, cE as whoCanShipSentence, cy as unreadableShipTeams, cg as soloApprover, aW as approverLists, K as selectTokenFiles, R as parseContrastChecks } from "./prod-branch-JL5tmL6u.js";
+import { cw as tokenBump, a_ as changeKind, L as LayeredTokenSet, aS as aliasOf, c9 as rgbaToDtcg, by as hexToRgba, w as parseTokenFile, q as emptyTokenFile, s as serializeTokenFile, C as moveToken, r as removeToken, bB as inheritedTypeAt, u as upsertToken, H as readTokenAt, b4 as comboKey, c8 as renderedColor, bc as contrastRatio, z as rgbaToHex, U as classifyRisk, bl as figmaPushNextLine, W as RISK_LABELS, bm as figmaPushTierLabel, _ as previewUrl, M as resolveBranchPreviews, aj as slugify, ai as readPreviewComment, V as CONFIG_FILE, N as loadConfig, am as ConfigError, af as DEFAULT_TOKEN_PATHS, al as globToRegExp, Q as validateLayered, bT as parseJson, cd as serializeJson, bZ as plainEqual, cv as toPlain, bv as getEntry, bt as fromPlain, m as modeDisplayName, A as formatValue, O as tokensPath, a4 as NEEDED_BY_LABEL, aZ as canShip, cE as whoCanShipSentence, cy as unreadableShipTeams, cg as soloApprover, aW as approverLists, K as selectTokenFiles, R as parseContrastChecks } from "./prod-branch-JL5tmL6u.js";
 function changesetBump(changes) {
   return tokenBump(changes) ?? "patch";
 }
@@ -361,193 +361,518 @@ function assertSafeBranch(branch, rules = {}) {
     throw new ProtectedBranchError(`Branch "${name}" must start with "${rules.branchPrefix}".`);
   }
 }
-class GitHubError extends Error {
-  constructor(status, message, detail, info = {}) {
-    super(message);
-    this.status = status;
-    this.detail = detail;
-    this.name = "GitHubError";
-    this.auth = info.auth;
-    this.permission = info.permission;
-    this.resetsAt = info.resetsAt;
-  }
-  status;
-  detail;
-  /** Set when the failure is about the token: rejected (401) or missing a permission (403). */
-  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";
-const PERMISSION_LABELS = {
-  issues: "Issues",
-  pull_requests: "Pull requests",
-  contents: "Contents",
-  checks: "Checks",
-  statuses: "Commit statuses",
-  metadata: "Metadata",
-  actions: "Actions",
-  deployments: "Deployments",
-  workflows: "Workflows",
-  administration: "Administration"
+const EXPLORATION_LABEL = "exploration";
+const EXPLORATION_PREFIX = "explore/";
+const EXPLORATION_NOTES_DIR = ".bridge/explorations";
+const EXPLORATION_TIER_LABEL = "Exploration (not mergeable)";
+const EXPLORATION_CHECK = "Exploration not merged as is";
+const EXPLORATION_READY_LABEL = "ready-for-devs";
+const EXPLORATION_ARCHIVED_LABEL = "archived";
+const EXPLORATION_USE_CASES = [
+  { 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",
+  ready: "Waiting for code",
+  building: "Being built",
+  shipped: "Shipped",
+  promoted: "Promoted to review",
+  closed: "Closed"
 };
-function permissionLabel(permission) {
-  return PERMISSION_LABELS[permission] ?? permission.replace(/_/g, " ").replace(/^./, (c) => c.toUpperCase());
-}
-const TOKEN_SETTINGS_URL = "https://github.com/settings/personal-access-tokens";
-const TOKEN_REJECTED_MESSAGE = "Your GitHub token stopped working. It was revoked, regenerated or has expired: replace it with a new one.";
-function missingPermissionMessage(permission, action) {
-  const what = action ? `This token cannot ${action}.` : "This token is missing a permission for this.";
-  if (!permission) return `${what} Check its repository permissions on GitHub (Contents and Pull requests need Read and write).`;
-  return `${what} Add ${permissionLabel(permission)}: Read and write on GitHub.`;
-}
-function requiredPermission(path, acceptedHeader) {
-  if (acceptedHeader) {
-    const first = acceptedHeader.split(";")[0].split(",").map((p2) => p2.trim().split("=")[0].trim()).filter((p2) => p2 && p2 !== "metadata");
-    if (first.length) return first[0];
-  }
-  const p = path.replace(/[?#].*$/, "");
-  if (/\/repos\/[^/]+\/[^/]+\/(issues|labels|milestones)(\/|$)/.test(p)) return "issues";
-  if (/\/repos\/[^/]+\/[^/]+\/pulls(\/|$)/.test(p)) return "pull_requests";
-  if (/\/repos\/[^/]+\/[^/]+\/(rulesets(\/|$)|branches\/.+\/protection$)/.test(p)) return "administration";
-  if (/\/repos\/[^/]+\/[^/]+\/(contents|git|commits|branches|merges)(\/|$)/.test(p)) return "contents";
-  if (/\/repos\/[^/]+\/[^/]+\/(check-runs|check-suites)(\/|$)/.test(p)) return "checks";
-  if (/\/repos\/[^/]+\/[^/]+\/statuses(\/|$)/.test(p)) return "statuses";
-  if (/\/repos\/[^/]+\/[^/]+\/deployments(\/|$)/.test(p)) return "deployments";
-  if (/\/repos\/[^/]+\/[^/]+\/actions(\/|$)/.test(p)) return "actions";
-  return void 0;
-}
-const PERMISSION_DENIED = /not accessible by (personal access token|integration)|must have (admin|push|write) (rights|access)|write access to repository not granted|permission to .* denied/i;
-function classifyAuth(status, detail, opts = {}) {
-  if (status === 401 && opts.withToken !== false) return { auth: "rejected" };
-  if (status !== 403 || /rate limit|archived/i.test(detail)) return {};
-  if (opts.acceptedPermissions || PERMISSION_DENIED.test(detail)) {
-    return { auth: "missing-permission", permission: requiredPermission(opts.path ?? "", opts.acceptedPermissions) };
-  }
-  return {};
+const MARK$2 = "bridge-exploration";
+const SLUG_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const EXPLORATION_SLUG_MAX = 60;
+function explorationSlug(name) {
+  const s = name.trim().replace(/^explore\//i, "");
+  if (!/[a-z0-9]/i.test(s)) return "";
+  return slugify(s, EXPLORATION_SLUG_MAX);
 }
-function memoryEtagStore(max = 500) {
-  const map = /* @__PURE__ */ new Map();
-  return {
-    get(key) {
-      const e = map.get(key);
-      if (e) {
-        map.delete(key);
-        map.set(key, e);
-      }
-      return e;
-    },
-    set(key, entry) {
-      map.delete(key);
-      map.set(key, entry);
-      while (map.size > max) map.delete(map.keys().next().value);
-    },
-    clear: () => map.clear()
-  };
+function explorationBranch(nameOrBranch) {
+  return `${EXPLORATION_PREFIX}${explorationSlug(nameOrBranch)}`;
 }
-function webStorageEtagStore(storage, opts = {}) {
-  const prefix = opts.prefix ?? "bridge.gh.etag:";
-  const maxBytes = opts.maxEntryBytes ?? 512e3;
-  return {
-    get(key) {
-      try {
-        const raw = storage.getItem(prefix + key);
-        if (!raw) return void 0;
-        const e = JSON.parse(raw);
-        return typeof e?.etag === "string" ? e : void 0;
-      } catch {
-        return void 0;
-      }
-    },
-    set(key, entry) {
-      try {
-        const raw = JSON.stringify(entry);
-        if (raw.length > maxBytes) return;
-        storage.setItem(prefix + key, raw);
-      } catch {
-      }
-    },
-    clear() {
-      try {
-        const keys = [];
-        for (let i = 0; i < storage.length; i++) {
-          const k = storage.key(i);
-          if (k?.startsWith(prefix)) keys.push(k);
-        }
-        for (const k of keys) storage.removeItem(k);
-      } catch {
-      }
-    }
-  };
+function isExplorationBranch(ref) {
+  const r = (ref ?? "").replace(/^refs\/heads\//, "");
+  return r.startsWith(EXPLORATION_PREFIX) && SLUG_RE.test(r.slice(EXPLORATION_PREFIX.length));
 }
-const sharedEtags = memoryEtagStore();
-function clearSharedEtags() {
-  sharedEtags.clear();
+function explorationSlugFromBranch(ref) {
+  return isExplorationBranch(ref) ? ref.replace(/^refs\/heads\//, "").slice(EXPLORATION_PREFIX.length) : null;
 }
-function tokenFingerprint(token) {
-  if (!token) return "anon";
-  let a = 2166136261;
-  let b = 16777619 ^ token.length;
-  for (let i = 0; i < token.length; i++) {
-    const c = token.charCodeAt(i);
-    a = Math.imul(a ^ c, 16777619) >>> 0;
-    b = Math.imul(b ^ c ^ i & 255, 1540483477) >>> 0;
+const REPO_NAME = /^[\w.-]+\/[\w.-]+$/;
+const KEY_NAME = /^[a-z0-9][a-z0-9-]*$/i;
+function parseExplorationRef(input) {
+  if (typeof input === "number") return { ref: input };
+  const s = input.trim();
+  const link = /^https?:\/\/github\.com\/([\w.-]+)\/([\w.-]+)\/pull\/(\d+)/i.exec(s);
+  if (link) return { repo: `${link[1]}/${link[2]}`, ref: Number(link[3]) };
+  if (/^#?\d+$/.test(s)) return { ref: Number(s.replace(/^#/, "")) };
+  const hash = /^(.+)#(\d+)$/.exec(s);
+  if (hash) {
+    const where2 = hash[1].trim();
+    if (REPO_NAME.test(where2)) return { repo: where2, ref: Number(hash[2]) };
+    if (KEY_NAME.test(where2)) return { product: where2.toLowerCase(), ref: Number(hash[2]) };
   }
-  return a.toString(16).padStart(8, "0") + b.toString(16).padStart(8, "0");
-}
-function installationFor(list, owner) {
-  const inst = list.find((i) => i.account?.login?.toLowerCase() === owner.toLowerCase());
-  if (!inst) return { reach: "no" };
-  const selection = inst.repositorySelection ?? inst.repository_selection;
-  return selection === "all" ? { reach: "yes", id: inst.id } : { reach: "check", id: inst.id };
-}
-const MAX_PAGES = 10;
-function rateLimitMessage(x) {
-  const when = x.resetsAt ? ` It resets at ${x.resetsAt.toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" })}.` : "";
-  if (x.withToken) return `GitHub's hourly request limit for this token is used up.${when} Try again after that.`;
-  const hint = x.tokenHint ?? "add a GitHub token";
-  return `GitHub's hourly limit for requests without a token (60 an hour) is used up.${when} To keep going now, ${hint}: a token gets 5,000 requests an hour.`;
+  const named = /^([a-z0-9][a-z0-9-]*):(.+)$/i.exec(s);
+  if (named) return { product: named[1].toLowerCase(), ref: /^#?\d+$/.test(named[2].trim()) ? Number(named[2].trim().replace(/^#/, "")) : named[2].trim() };
+  return { ref: s };
 }
-const DEFAULT_RETRY = { attempts: 3, baseDelayMs: 600, sleep: (ms) => new Promise((r) => setTimeout(r, ms)) };
-const hourlyLimitErrors = /* @__PURE__ */ new WeakSet();
-const isTransient = (status, detail) => status === 0 || status >= 500 || status === 429 || status === 403 && /secondary rate limit/i.test(detail);
-const API = "https://api.github.com";
-const ACCEPT_JSON = "application/vnd.github+json";
-const ACCEPT_RAW = "application/vnd.github.raw";
-const RAW = "https://raw.githubusercontent.com";
-function parseRepo(repo) {
-  const m = /^\s*(?:https?:\/\/github\.com\/|git@github\.com:)?([A-Za-z0-9-]+)\/([A-Za-z0-9._-]+?)(?:\.git)?\/?\s*$/.exec(repo);
-  if (!m) throw new Error(`"${repo}" is not a repository. Use the form owner/name.`);
-  return { owner: m[1], name: m[2] };
+const explorationRefLabel = (x) => x.repo && x.product ? `${x.product}#${x.number}` : `#${x.number}`;
+const explorationNotePath = (slug) => `${EXPLORATION_NOTES_DIR}/${slug}.md`;
+function explorationProblems(e) {
+  const out = [];
+  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 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.");
+  return out;
 }
-function utf8ToBase64(text) {
-  const bytes = new TextEncoder().encode(text);
-  let bin = "";
-  for (const b of bytes) bin += String.fromCharCode(b);
-  return btoa(bin);
+const useCaseLabel = (u) => EXPLORATION_USE_CASES.find((x) => x.value === u)?.label;
+function explorationNote(e) {
+  const slug = e.slug || explorationSlug(e.name);
+  const uc = useCaseLabel(e.useCase);
+  return [
+    `# Exploration: ${e.name.trim()}`,
+    "",
+    ...e.purpose?.trim() ? [e.purpose.trim(), ""] : [],
+    `- Branch: \`${EXPLORATION_PREFIX}${slug}\``,
+    ...uc ? [`- Use case: ${uc}`] : [],
+    ...e.startedAt ? [`- Started: ${e.startedAt.slice(0, 10)}${e.author ? ` by @${e.author}` : ""}`] : [],
+    "",
+    'This file marks the branch as an exploration. It is never merged as is: "Done exploring" removes it before developers take the branch.',
+    ""
+  ].join("\n");
 }
-function base64ToUtf8(b64) {
-  const bin = atob(b64.replace(/\s/g, ""));
-  const bytes = new Uint8Array(bin.length);
-  for (let i = 0; i < bin.length; i++) bytes[i] = bin.charCodeAt(i);
-  return new TextDecoder("utf-8").decode(bytes);
+function explorationPrTitle(e) {
+  const n = e.name.trim().replace(/\.$/, "").replace(/^exploration\s*:\s*/i, "").replace(/\s*:\s+/g, ", ").trim();
+  return `Exploration: ${n}`;
 }
-const copy = (value) => value === null || typeof value !== "object" ? value : typeof structuredClone === "function" ? structuredClone(value) : JSON.parse(JSON.stringify(value));
-const encodeRef = (ref) => ref.split("/").map(encodeURIComponent).join("/");
-class GitHubClient {
-  constructor(repo, token, fetchImpl = (url, init) => fetch(url, init), retry = DEFAULT_RETRY, options = {}) {
-    this.token = token;
-    this.fetchImpl = fetchImpl;
-    this.retry = retry;
-    this.options = options;
-    const r = parseRepo(repo);
-    this.owner = r.owner;
-    this.name = r.name;
-    this.api = (options.apiUrl ?? API).replace(/\/$/, "");
-    this.protectedBranches = options.protectedBranches ?? DEFAULT_PROTECTED_BRANCHES;
+function explorationPrBody(e, ctx) {
+  const slug = e.slug || explorationSlug(e.name);
+  const branch = `${EXPLORATION_PREFIX}${slug}`;
+  const uc = useCaseLabel(e.useCase);
+  const experimental = (e.experimental ?? []).map((x) => x.trim()).filter(Boolean);
+  const lines = [
+    `## Exploration: ${e.name.trim()}`,
+    "",
+    `> Not mergeable as is. This draft pull request is a living prototype on \`${branch}\`: say "Done exploring" when the idea is ready for developers. Keep it open, so its preview link keeps working.`,
+    "",
+    ...e.purpose?.trim() ? [`**Purpose.** ${e.purpose.trim()}`, ""] : [],
+    ...uc ? [`**Use case.** ${uc}`, ""] : [],
+    "### What is experimental",
+    "",
+    ...experimental.length ? experimental.map((x) => `- ${x}`) : [ctx.inProduct ? `- The ${ctx.inProduct.name} screens and flows built on this branch with the library. Nothing here reaches main or production.` : "- Token edits and component work committed to this branch. Nothing here reaches main or production."],
+    ...ctx.requests?.length ? ["", "Requests implemented here:", ...ctx.requests.map((r) => `- #${r.number} ${r.title}`)] : [],
+    ""
+  ];
+  if (ctx.inProduct) {
+    const p = ctx.inProduct;
+    lines.push(
+      "### Work on it",
+      "",
+      `This exploration lives in the ${p.name} repository, so it runs in your usual environment: \`git fetch origin && git switch ${branch}\`, then start ${p.name} as you always do.`,
+      "",
+      `The library comes from npm, as on main. To try library changes that are not released yet, install the snapshot of their branch in ${p.library} (\`npm i @bridge-ds/react@<snapshot>\`): the command is in its "Try this exploration in your product" comment. Library changes are made in ${p.library}, never on this branch.`,
+      "",
+      "### Previews",
+      ""
+    );
+    const url = p.preview ? previewUrl(p.preview, { branch, ...ctx.pr ? { pr: ctx.pr } : {} }) : null;
+    if (p.preview) lines.push("| App | Preview |", "| --- | --- |", `| ${p.name} | ${url ?? "Link in the Vercel comment on this pull request"} |`);
+    else lines.push(`The preview deploys of ${p.name}, if it has them, build this branch like any other.`);
+  } else {
+    lines.push(
+      "### Try it in a product staging branch",
+      "",
+      'In the product repo, on a branch that deploys to staging (production keeps the released version), install the snapshot with the command in the "Try this exploration in your product" comment below. It appears a few minutes after each push and always matches the latest commit.'
+    );
+    lines.push("", "### Previews", "");
+    const links = resolveBranchPreviews(ctx.apps, { branch, ...ctx.pr ? { pr: ctx.pr } : {} });
+    if (links.length) lines.push("| App | Preview |", "| --- | --- |", ...links.map((l) => `| ${l.label} | ${l.url ?? "Link in the Vercel comment on this pull request"} |`));
+    else lines.push("Preview deploys are not set up: add `previews.apps` to `bridge.config.json` (docs/PREVIEWS.md).");
+  }
+  lines.push(
+    "",
+    "### When it is done",
+    "",
+    `- **Done exploring:** on the exploration's page in Bridge Studio, or \`bridge explore done ${slug}\`. Bridge removes the \`${EXPLORATION_LABEL}\` label and the exploration note, adds \`${EXPLORATION_READY_LABEL}\`, and sends the pieces the designer picks to the DS lead as requests. Nothing is closed or merged: developers continue on \`${branch}\`.`,
+    `- **Archive:** \`bridge explore archive ${slug}\` adds the \`${EXPLORATION_ARCHIVED_LABEL}\` label. Keep this pull request open: ${ctx.inProduct ? "Bridge follows open explorations, and its preview link is how people come back to the prototype." : "closing it removes the preview prerelease."}`,
+    "",
+    explorationBlock({ ...e, slug })
+  );
+  return lines.join("\n");
+}
+function explorationBlock(e) {
+  const experimental = (e.experimental ?? []).map((x) => x.trim()).filter(Boolean);
+  const data = {
+    name: e.name.trim(),
+    purpose: (e.purpose ?? "").trim(),
+    slug: e.slug || explorationSlug(e.name),
+    ...e.useCase ? { useCase: e.useCase } : {},
+    ...experimental.length ? { experimental } : {},
+    ...e.author ? { author: e.author } : {},
+    ...e.startedAt ? { startedAt: e.startedAt } : {},
+    ...e.source ? { source: e.source } : {},
+    ...e.agent ? { agent: e.agent } : {},
+    ...e.doneAt ? { doneAt: e.doneAt } : {},
+    ...e.doneSha ? { doneSha: e.doneSha } : {}
+  };
+  return `<!-- ${MARK$2} ${JSON.stringify(data).replace(/-->/g, "--\\u003e")} -->`;
+}
+function parseExplorationBody(body) {
+  if (!body) return void 0;
+  const m = new RegExp(`<!-- ${MARK$2} (\\{[\\s\\S]*?\\}) -->`).exec(body);
+  if (!m) return void 0;
+  try {
+    const e = JSON.parse(m[1]);
+    if (!e || typeof e.name !== "string") return void 0;
+    return typeof e.purpose === "string" ? e : e.purpose === void 0 ? { ...e, purpose: "" } : void 0;
+  } catch {
+    return void 0;
+  }
+}
+const labelNames = (labels) => labels.map((l) => typeof l === "string" ? l : l.name ?? "");
+function isExplorationPull(p) {
+  return isExplorationBranch(p.headRef) || labelNames(p.labels).includes(EXPLORATION_LABEL) || Boolean(parseExplorationBody(p.body));
+}
+function isUnlabeledExploration(p) {
+  if (p.state !== "open" || p.draft !== true) return false;
+  const names2 = labelNames(p.labels ?? []);
+  if (names2.includes(EXPLORATION_LABEL) || names2.includes(EXPLORATION_ARCHIVED_LABEL) || names2.includes(EXPLORATION_READY_LABEL)) return false;
+  const block = parseExplorationBody(p.body);
+  if (block?.doneAt) return false;
+  return isExplorationBranch(p.headRef) || Boolean(block);
+}
+function isHandedOff(p) {
+  return labelNames(p.labels).includes(EXPLORATION_READY_LABEL) || Boolean(parseExplorationBody(p.body)?.doneAt);
+}
+function explorationStatus(p) {
+  const merged = Boolean(p.merged || p.merged_at || p.state === "merged");
+  if (p.state !== "open" && !merged) return "closed";
+  if (p.state === "open" && (labelNames(p.labels).includes(EXPLORATION_LABEL) || isUnlabeledExploration(p))) return "active";
+  if (!isHandedOff(p)) return "promoted";
+  if (merged) return "shipped";
+  if (p.draft === false) return "building";
+  const doneSha = parseExplorationBody(p.body)?.doneSha;
+  if (doneSha && p.headSha && p.headSha !== doneSha) return "building";
+  return "ready";
+}
+function isGuardedExploration(p) {
+  if (p.state !== void 0 && p.state !== "open") return false;
+  if (labelNames(p.labels ?? []).includes(EXPLORATION_LABEL)) return true;
+  return isUnlabeledExploration({ state: "open", draft: p.draft, labels: p.labels, headRef: p.headRef ?? p.head?.ref, body: p.body });
+}
+const isExplorationCheck = (name) => (name ?? "").trim() === EXPLORATION_CHECK;
+const isActiveExploration = (labels) => labelNames(labels).includes(EXPLORATION_LABEL);
+const isArchivedExploration = (labels) => labelNames(labels ?? []).includes(EXPLORATION_ARCHIVED_LABEL);
+function isHeldExploration(p) {
+  if (p.state !== void 0 && p.state !== "open") return false;
+  const names2 = labelNames(p.labels ?? []);
+  if (names2.includes(EXPLORATION_LABEL) || names2.includes(EXPLORATION_ARCHIVED_LABEL)) return true;
+  if (isUnlabeledExploration({ state: "open", draft: p.draft, labels: p.labels, headRef: p.headRef ?? p.head?.ref, body: p.body })) return true;
+  return names2.includes(EXPLORATION_READY_LABEL) && p.draft !== false;
+}
+const explorationTakeCommands = (branch) => ["git fetch origin", `git checkout ${branch}`];
+const CONTINUE = "Continue on this branch: its pull request already exists, so Bridge follows your pushes, and the merge reads as shipped.";
+const EXPLORATION_STARTING_POINT = `A starting point, not ready to ship: nobody has reviewed Claude's prototype code yet. ${CONTINUE}`;
+function explorationStartingPoint(checks) {
+  switch (checks) {
+    case "success":
+      return `A starting point: its checks pass, but nobody has reviewed Claude's prototype code yet. ${CONTINUE}`;
+    case "failure":
+      return `A starting point, not ready to ship: some checks fail on this branch and nobody has reviewed Claude's prototype code yet. ${CONTINUE}`;
+    case "pending":
+      return `A starting point, not ready to ship: its checks are still running and nobody has reviewed Claude's prototype code yet. ${CONTINUE}`;
+    case "none":
+      return `A starting point, not ready to ship: no checks ran on this branch and nobody has reviewed Claude's prototype code yet. ${CONTINUE}`;
+    default:
+      return EXPLORATION_STARTING_POINT;
+  }
+}
+function doneExploringPlan(input) {
+  const removeFiles = input.files.filter((f) => f.path.startsWith(`${EXPLORATION_NOTES_DIR}/`) && f.status !== "removed").map((f) => f.path);
+  return {
+    removeLabels: [EXPLORATION_LABEL],
+    addLabels: [EXPLORATION_READY_LABEL],
+    removeFiles,
+    body: withDoneExploring(input.body, { branch: input.branch, doneAt: (input.date ?? /* @__PURE__ */ new Date()).toISOString() }),
+    take: explorationTakeCommands(input.branch),
+    markReady: false
+  };
+}
+const DEV_SECTION = "### For developers";
+function withDoneExploring(body, done) {
+  const e = parseExplorationBody(body);
+  const [fetch2, checkout] = explorationTakeCommands(done.branch);
+  const section = [
+    DEV_SECTION,
+    "",
+    `**Done exploring on ${done.doneAt.slice(0, 10)}.** ${explorationStartingPoint(done.checks)}`,
+    "",
+    "```sh",
+    fetch2,
+    checkout,
+    "```",
+    "",
+    "Mark this pull request ready for review when the code is yours. Keep it open: its preview link is how designers, the DS lead and stakeholders come back to the prototype."
+  ].join("\n");
+  const block = new RegExp(`<!-- ${MARK$2} \\{[\\s\\S]*?\\} -->`);
+  const kept = (body ?? "").replace(/^> Not mergeable as is\..*$\n?\n?/m, "").replace(/### When it is done[\s\S]*?(?=<!-- |$)/, "").replace(/### For developers[\s\S]*?(?=### |<!-- |$)/, "");
+  if (!e || !block.test(kept)) return `${kept.trim()}${kept.trim() ? "\n\n" : ""}${section}`;
+  const at = kept.search(block);
+  const nextBlock = explorationBlock({ ...e, doneAt: done.doneAt, ...done.doneSha ? { doneSha: done.doneSha } : {} });
+  const after = kept.slice(at).replace(block, () => nextBlock).trim();
+  return `${kept.slice(0, at).trim()}
+
+${section}
+
+${after}`.trim();
+}
+function promotionPlan(input) {
+  const exploration = parseExplorationBody(input.body);
+  const jira = /^([A-Z][A-Z0-9_]*-\d+)\s+/.exec(input.title)?.[1] ?? null;
+  const title = jira ? input.title.slice(jira.length).trim() : input.title;
+  const removeFiles = input.files.filter((f) => f.path.startsWith(`${EXPLORATION_NOTES_DIR}/`) && f.status !== "removed").map((f) => f.path);
+  const files = input.files.filter((f) => !f.path.startsWith(`${EXPLORATION_NOTES_DIR}/`));
+  const risk = classifyRisk({ files, ...input.config ? { config: input.config } : {} });
+  const tokens = files.some((f) => f.path.endsWith(".tokens.json"));
+  const addLabels = [`tier: ${risk.tier}`, ...risk.tier === 3 && tokens ? ["tokens"] : []];
+  const date = (input.date ?? /* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const existing = new Set(input.body ? [...input.body.matchAll(/\b(?:close[sd]?|fix(?:e[sd])?|resolve[sd]?)\s+#(\d+)/gi)].map((m) => Number(m[1])) : []);
+  const closes = [...new Set(input.requests ?? [])].filter((n) => !existing.has(n));
+  const kept = (input.body ?? "").replace(/^> Not mergeable as is\..*$\n?\n?/m, "").replace(/### When it is done[\s\S]*?(?=<!-- |$)/, "").replace(/^## Exploration: /m, "## ").trim();
+  const body = [
+    `**Promoted from an exploration on ${date}.** Review it like any change: the tier below comes from the files it touches.`,
+    "",
+    kept || `## ${title.replace(/^Exploration:\s*/i, "")}`,
+    "",
+    `**Risk tier:** ${risk.tier}.`,
+    ...risk.reasons.slice(0, 8).map((r) => `- ${r}`),
+    ...closes.length ? ["", ...closes.map((n) => `Closes #${n}`)] : []
+  ].join("\n");
+  const t = title.replace(/^Exploration:\s*/i, "").trim() || exploration?.name || title;
+  return {
+    tier: risk.tier,
+    reasons: risk.reasons,
+    removeLabels: [EXPLORATION_LABEL],
+    addLabels,
+    removeFiles,
+    body,
+    title: `${jira ? `${jira} ` : ""}${t.charAt(0).toUpperCase()}${t.slice(1)}`,
+    markReady: true
+  };
+}
+function explorationTryIt(input) {
+  const c = readPreviewComment(input.comment);
+  if (!c) return { state: "building" };
+  if (input.headSha && c.sha7 && !input.headSha.startsWith(c.sha7)) return { state: "building" };
+  if (!c.command || c.source === "none") return { state: "failed" };
+  return { state: "ready", command: c.command, source: c.source, sha7: c.sha7 };
+}
+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}`);
+  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 [
+    `- Work on the existing branch ${branch} (git fetch origin && git switch ${branch}). Commit there.`,
+    `- Do not open a pull request to main and do not create another branch: the draft pull request of ${branch} is the place. It stays open as a living prototype.`,
+    `- Do not mark the pull request ready for review, do not remove the exploration label and never close it: "Done exploring" is a person's decision, and closing removes its preview.`
+  ];
+}
+class GitHubError extends Error {
+  constructor(status, message, detail, info = {}) {
+    super(message);
+    this.status = status;
+    this.detail = detail;
+    this.name = "GitHubError";
+    this.auth = info.auth;
+    this.permission = info.permission;
+    this.resetsAt = info.resetsAt;
+  }
+  status;
+  detail;
+  /** Set when the failure is about the token: rejected (401) or missing a permission (403). */
+  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";
+const PERMISSION_LABELS = {
+  issues: "Issues",
+  pull_requests: "Pull requests",
+  contents: "Contents",
+  checks: "Checks",
+  statuses: "Commit statuses",
+  metadata: "Metadata",
+  actions: "Actions",
+  deployments: "Deployments",
+  workflows: "Workflows",
+  administration: "Administration"
+};
+function permissionLabel(permission) {
+  return PERMISSION_LABELS[permission] ?? permission.replace(/_/g, " ").replace(/^./, (c) => c.toUpperCase());
+}
+const TOKEN_SETTINGS_URL = "https://github.com/settings/personal-access-tokens";
+const TOKEN_REJECTED_MESSAGE = "Your GitHub token stopped working. It was revoked, regenerated or has expired: replace it with a new one.";
+function missingPermissionMessage(permission, action) {
+  const what = action ? `This token cannot ${action}.` : "This token is missing a permission for this.";
+  if (!permission) return `${what} Check its repository permissions on GitHub (Contents and Pull requests need Read and write).`;
+  return `${what} Add ${permissionLabel(permission)}: Read and write on GitHub.`;
+}
+function requiredPermission(path, acceptedHeader) {
+  if (acceptedHeader) {
+    const first = acceptedHeader.split(";")[0].split(",").map((p2) => p2.trim().split("=")[0].trim()).filter((p2) => p2 && p2 !== "metadata");
+    if (first.length) return first[0];
+  }
+  const p = path.replace(/[?#].*$/, "");
+  if (/\/repos\/[^/]+\/[^/]+\/(issues|labels|milestones)(\/|$)/.test(p)) return "issues";
+  if (/\/repos\/[^/]+\/[^/]+\/pulls(\/|$)/.test(p)) return "pull_requests";
+  if (/\/repos\/[^/]+\/[^/]+\/(rulesets(\/|$)|branches\/.+\/protection$)/.test(p)) return "administration";
+  if (/\/repos\/[^/]+\/[^/]+\/(contents|git|commits|branches|merges)(\/|$)/.test(p)) return "contents";
+  if (/\/repos\/[^/]+\/[^/]+\/(check-runs|check-suites)(\/|$)/.test(p)) return "checks";
+  if (/\/repos\/[^/]+\/[^/]+\/statuses(\/|$)/.test(p)) return "statuses";
+  if (/\/repos\/[^/]+\/[^/]+\/deployments(\/|$)/.test(p)) return "deployments";
+  if (/\/repos\/[^/]+\/[^/]+\/actions(\/|$)/.test(p)) return "actions";
+  return void 0;
+}
+const PERMISSION_DENIED = /not accessible by (personal access token|integration)|must have (admin|push|write) (rights|access)|write access to repository not granted|permission to .* denied/i;
+function classifyAuth(status, detail, opts = {}) {
+  if (status === 401 && opts.withToken !== false) return { auth: "rejected" };
+  if (status !== 403 || /rate limit|archived/i.test(detail)) return {};
+  if (opts.acceptedPermissions || PERMISSION_DENIED.test(detail)) {
+    return { auth: "missing-permission", permission: requiredPermission(opts.path ?? "", opts.acceptedPermissions) };
+  }
+  return {};
+}
+function memoryEtagStore(max = 500) {
+  const map = /* @__PURE__ */ new Map();
+  return {
+    get(key) {
+      const e = map.get(key);
+      if (e) {
+        map.delete(key);
+        map.set(key, e);
+      }
+      return e;
+    },
+    set(key, entry) {
+      map.delete(key);
+      map.set(key, entry);
+      while (map.size > max) map.delete(map.keys().next().value);
+    },
+    clear: () => map.clear()
+  };
+}
+function webStorageEtagStore(storage, opts = {}) {
+  const prefix = opts.prefix ?? "bridge.gh.etag:";
+  const maxBytes = opts.maxEntryBytes ?? 512e3;
+  return {
+    get(key) {
+      try {
+        const raw = storage.getItem(prefix + key);
+        if (!raw) return void 0;
+        const e = JSON.parse(raw);
+        return typeof e?.etag === "string" ? e : void 0;
+      } catch {
+        return void 0;
+      }
+    },
+    set(key, entry) {
+      try {
+        const raw = JSON.stringify(entry);
+        if (raw.length > maxBytes) return;
+        storage.setItem(prefix + key, raw);
+      } catch {
+      }
+    },
+    clear() {
+      try {
+        const keys = [];
+        for (let i = 0; i < storage.length; i++) {
+          const k = storage.key(i);
+          if (k?.startsWith(prefix)) keys.push(k);
+        }
+        for (const k of keys) storage.removeItem(k);
+      } catch {
+      }
+    }
+  };
+}
+const sharedEtags = memoryEtagStore();
+function clearSharedEtags() {
+  sharedEtags.clear();
+}
+function tokenFingerprint(token) {
+  if (!token) return "anon";
+  let a = 2166136261;
+  let b = 16777619 ^ token.length;
+  for (let i = 0; i < token.length; i++) {
+    const c = token.charCodeAt(i);
+    a = Math.imul(a ^ c, 16777619) >>> 0;
+    b = Math.imul(b ^ c ^ i & 255, 1540483477) >>> 0;
+  }
+  return a.toString(16).padStart(8, "0") + b.toString(16).padStart(8, "0");
+}
+function installationFor(list, owner) {
+  const inst = list.find((i) => i.account?.login?.toLowerCase() === owner.toLowerCase());
+  if (!inst) return { reach: "no" };
+  const selection = inst.repositorySelection ?? inst.repository_selection;
+  return selection === "all" ? { reach: "yes", id: inst.id } : { reach: "check", id: inst.id };
+}
+const MAX_PAGES = 10;
+function rateLimitMessage(x) {
+  const when = x.resetsAt ? ` It resets at ${x.resetsAt.toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" })}.` : "";
+  if (x.withToken) return `GitHub's hourly request limit for this token is used up.${when} Try again after that.`;
+  const hint = x.tokenHint ?? "add a GitHub token";
+  return `GitHub's hourly limit for requests without a token (60 an hour) is used up.${when} To keep going now, ${hint}: a token gets 5,000 requests an hour.`;
+}
+const DEFAULT_RETRY = { attempts: 3, baseDelayMs: 600, sleep: (ms) => new Promise((r) => setTimeout(r, ms)) };
+const hourlyLimitErrors = /* @__PURE__ */ new WeakSet();
+const isTransient = (status, detail) => status === 0 || status >= 500 || status === 429 || status === 403 && /secondary rate limit/i.test(detail);
+const API = "https://api.github.com";
+const ACCEPT_JSON = "application/vnd.github+json";
+const ACCEPT_RAW = "application/vnd.github.raw";
+const RAW = "https://raw.githubusercontent.com";
+function parseRepo(repo) {
+  const m = /^\s*(?:https?:\/\/github\.com\/|git@github\.com:)?([A-Za-z0-9-]+)\/([A-Za-z0-9._-]+?)(?:\.git)?\/?\s*$/.exec(repo);
+  if (!m) throw new Error(`"${repo}" is not a repository. Use the form owner/name.`);
+  return { owner: m[1], name: m[2] };
+}
+function utf8ToBase64(text) {
+  const bytes = new TextEncoder().encode(text);
+  let bin = "";
+  for (const b of bytes) bin += String.fromCharCode(b);
+  return btoa(bin);
+}
+function base64ToUtf8(b64) {
+  const bin = atob(b64.replace(/\s/g, ""));
+  const bytes = new Uint8Array(bin.length);
+  for (let i = 0; i < bin.length; i++) bytes[i] = bin.charCodeAt(i);
+  return new TextDecoder("utf-8").decode(bytes);
+}
+const copy = (value) => value === null || typeof value !== "object" ? value : typeof structuredClone === "function" ? structuredClone(value) : JSON.parse(JSON.stringify(value));
+const encodeRef = (ref) => ref.split("/").map(encodeURIComponent).join("/");
+class GitHubClient {
+  constructor(repo, token, fetchImpl = (url, init) => fetch(url, init), retry = DEFAULT_RETRY, options = {}) {
+    this.token = token;
+    this.fetchImpl = fetchImpl;
+    this.retry = retry;
+    this.options = options;
+    const r = parseRepo(repo);
+    this.owner = r.owner;
+    this.name = r.name;
+    this.api = (options.apiUrl ?? API).replace(/\/$/, "");
+    this.protectedBranches = options.protectedBranches ?? DEFAULT_PROTECTED_BRANCHES;
     this.etags = options.etags === false ? void 0 : options.etags ?? sharedEtags;
     this.etagScope = options.etagScope ?? tokenFingerprint(token);
   }
@@ -1209,8 +1534,11 @@ class GitHubClient {
     const r = await this.request("GET", `${this.repoPath}/pulls?state=${state}&per_page=50&sort=updated&direction=desc`);
     return r.map(toSummary);
   }
-  /** Commit statuses and check runs of a commit, folded into one state. */
-  async getChecks(sha) {
+  /**
+   * Commit statuses and check runs of a commit, folded into one state. `exploration`: the commit heads an exploration
+   * (explorations isGuardedExploration), so its guard check, failing by design, is left out (as review-gate summarizeCi).
+   */
+  async getChecks(sha, opts = {}) {
     const [combined, runs] = await Promise.all([
       this.request("GET", `${this.repoPath}/commits/${encodeRef(sha)}/status`).catch(() => ({ statuses: [] })),
       this.listCheckRuns(sha).catch(() => [])
@@ -1218,7 +1546,7 @@ class GitHubClient {
     const checks = [
       ...runs.map((c) => ({ name: c.name, status: c.status, conclusion: c.conclusion })),
       ...combined.statuses.map((s) => ({ name: s.context, status: s.state === "pending" ? "in_progress" : "completed", conclusion: s.state === "pending" ? null : s.state }))
-    ];
+    ].filter((c) => !(opts.exploration && isExplorationCheck(c.name)));
     const failing = checks.some((c) => c.conclusion && !["success", "neutral", "skipped"].includes(c.conclusion));
     const pending = checks.some((c) => c.status !== "completed");
     return { state: !checks.length ? "none" : failing ? "failure" : pending ? "pending" : "success", checks };
@@ -1302,1498 +1630,1188 @@ class GitHubClient {
    */
   async getBranchProtection(branch) {
     try {
-      return await this.request("GET", `${this.repoPath}/branches/${encodeRef(branch)}/protection`);
-    } catch (err) {
-      if (!(err instanceof GitHubError)) throw err;
-      if (err.status === 404) return null;
-      if (err.status === 403 || err.status === 401) {
-        const b = await this.request("GET", `${this.repoPath}/branches/${encodeRef(branch)}`).catch(() => void 0);
-        return b?.protected === false ? null : void 0;
-      }
-      throw err;
-    }
-  }
-  /** Create a check run (needs a GitHub App token; personal tokens are refused by GitHub). */
-  async createCheckRun(input) {
-    const r = await this.request("POST", `${this.repoPath}/check-runs`, {
-      name: input.name,
-      head_sha: input.headSha,
-      ...input.status ? { status: input.status } : {},
-      ...input.conclusion ? { conclusion: input.conclusion } : {},
-      ...input.output ? { output: input.output } : {}
-    });
-    return { id: r.id, name: r.name, status: r.status, conclusion: r.conclusion, url: r.html_url };
-  }
-  async removeLabel(issueNumber, label) {
-    await this.request("DELETE", `${this.repoPath}/issues/${issueNumber}/labels/${encodeURIComponent(label)}`);
-  }
-  // --- branch actions shared by Studio, the MCP server and the CLI (branch-actions.ts) ---
-  /** The account the token belongs to (GET /user). Needs a token. */
-  async getViewer() {
-    this.assertToken("Reading who you are on GitHub");
-    const r = await this.request("GET", "/user");
-    return { login: r.login };
-  }
-  /** The repository's merge settings and the viewer's permissions (unknown settings count as allowed). */
-  async getMergeSettings() {
-    return this.request("GET", this.repoPath);
-  }
-  /**
-   * Merges a pull request, only at `sha` (GitHub refuses when the branch moved meanwhile). The repository's branch
-   * rules still apply: GitHub refuses a merge they block, whatever Bridge says.
-   */
-  async mergePullRequest(n, input) {
-    this.assertToken("Merging a branch");
-    const r = await this.request("PUT", `${this.repoPath}/pulls/${n}/merge`, {
-      merge_method: input.method,
-      sha: input.sha,
-      ...input.commitMessage !== void 0 && input.method !== "rebase" ? { commit_message: input.commitMessage } : {}
-    });
-    return { sha: r?.sha ?? "", merged: r?.merged ?? true };
-  }
-  /** GitHub's "Update branch": merges the base into the pull request, only when its head is still `expectedHeadSha`. */
-  async updatePullRequestBranch(n, expectedHeadSha) {
-    this.assertToken("Updating a branch from main");
-    await this.request("PUT", `${this.repoPath}/pulls/${n}/update-branch`, { expected_head_sha: expectedHeadSha });
-  }
-  /**
-   * Merges the branch `head` into the branch `base` (GitHub's merges API): a merge commit on `base`, or nothing when
-   * `base` already has every commit of `head`. A conflict throws a GitHubError with status 409. Refuses protected
-   * branches and, with a branch prefix, a `base` without it.
-   */
-  async mergeIntoBranch(base, head, message) {
-    this.assertToken("Merging a branch into another");
-    this.assertWritableBranch(base);
-    const r = await this.request("POST", `${this.repoPath}/merges`, { base, head, commit_message: message });
-    return r?.sha ? { status: "merged", sha: r.sha } : { status: "up-to-date", sha: null };
-  }
-  /** Posts a comment on an issue or pull request and returns its id and link. */
-  async createIssueComment(n, body) {
-    this.assertToken("Commenting");
-    const r = await this.request("POST", `${this.repoPath}/issues/${n}/comments`, { body });
-    return { id: r.id, url: r.html_url };
-  }
-  /** Replaces the text of a comment. */
-  async updateIssueComment(id, body) {
-    this.assertToken("Editing a comment");
-    await this.request("PATCH", `${this.repoPath}/issues/comments/${id}`, { body });
-  }
-  /** Submits a review on a given commit (the head the reviewer saw); the body may be empty for an approval. */
-  async submitReview(n, input) {
-    this.assertToken("Reviewing a branch");
-    const r = await this.request("POST", `${this.repoPath}/pulls/${n}/reviews`, {
-      event: input.event,
-      ...input.body ? { body: input.body } : {},
-      ...input.commitId ? { commit_id: input.commitId } : {}
-    });
-    return { id: r.id, user: r.user?.login, state: r.state, body: r.body ?? "" };
-  }
-  /** Line comments of a pull request (review threads), oldest first. */
-  async listReviewComments(n) {
-    const r = await this.request(
-      "GET",
-      `${this.repoPath}/pulls/${n}/comments?per_page=100`
-    );
-    return r.map((c) => ({ id: c.id, body: c.body ?? "", author: c.user?.login ?? "unknown", path: c.path, line: c.line ?? null, inReplyTo: c.in_reply_to_id ?? null, url: c.html_url, createdAt: c.created_at }));
-  }
-  /** Asks these people to review a pull request. */
-  async requestReviewers(n, logins) {
-    this.assertToken("Asking for a review");
-    await this.request("POST", `${this.repoPath}/pulls/${n}/requested_reviewers`, { reviewers: logins });
-  }
-  /** Takes these people off the requested reviewers. */
-  async removeRequestedReviewers(n, logins) {
-    this.assertToken("Changing the requested reviewers");
-    await this.request("DELETE", `${this.repoPath}/pulls/${n}/requested_reviewers`, { reviewers: logins });
-  }
-  /** Replies in the thread of a line comment. */
-  async replyToReviewComment(n, commentId, body) {
-    this.assertToken("Replying to a comment");
-    const r = await this.request("POST", `${this.repoPath}/pulls/${n}/comments/${commentId}/replies`, { body });
-    return { id: r.id, url: r.html_url };
-  }
-  /**
-   * What `head` adds on top of `base`, with what library sync needs: the shared start (merge base), the base
-   * commit and its tree, how far behind, and the files with their previous names.
-   */
-  async compareDetailed(base, head) {
-    const r = await this.request("GET", `${this.repoPath}/compare/${encodeRef(base)}...${encodeRef(head)}`);
-    return {
-      behindBy: r.behind_by,
-      aheadBy: r.ahead_by,
-      mergeBase: r.merge_base_commit?.sha ?? null,
-      baseSha: r.base_commit?.sha ?? null,
-      baseTree: r.base_commit?.commit?.tree?.sha ?? null,
-      files: (r.files ?? []).map((f) => ({ filename: f.filename, status: f.status, ...f.previous_filename ? { previous_filename: f.previous_filename } : {} }))
-    };
-  }
-  /** A tree on top of `baseTree` from entries with their own file mode (blob sha, inline content, or sha null to delete). */
-  async createTreeEntries(baseTree, entries) {
-    const r = await this.request("POST", `${this.repoPath}/git/trees`, { base_tree: baseTree, tree: entries.map((e) => ({ ...e, type: "blob" })) }, true);
-    return r.sha;
-  }
-}
-function toCommitSummary(c) {
-  return {
-    sha: c.sha,
-    parents: (c.parents ?? []).map((p) => p.sha),
-    date: c.commit?.committer?.date ?? c.commit?.author?.date ?? "",
-    author: c.author?.login ?? c.commit?.author?.name ?? "unknown",
-    message: c.commit?.message ?? ""
-  };
-}
-function toSummary(r) {
-  return {
-    number: r.number,
-    title: r.title,
-    state: r.merged_at || r.merged ? "merged" : r.state,
-    draft: Boolean(r.draft),
-    author: r.user?.login ?? "unknown",
-    headRef: r.head?.ref,
-    headSha: r.head?.sha,
-    baseRef: r.base?.ref,
-    labels: (r.labels ?? []).map((l) => l.name),
-    url: r.html_url,
-    updatedAt: r.updated_at,
-    ...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 = {}) {
-  if (info.auth === "rejected") return TOKEN_REJECTED_MESSAGE;
-  if (info.auth === "missing-permission") return missingPermissionMessage(info.permission);
-  switch (status) {
-    case 401:
-      return "GitHub rejected the token. It may be expired or mistyped: create a new one and save it in Settings.";
-    case 403:
-      if (/rate limit/i.test(detail)) return "GitHub is limiting requests right now. Wait a minute, then try again.";
-      if (/archived/i.test(detail)) return "This repository is archived and read-only.";
-      return 'The token does not have permission for this. It needs "Contents: read and write" and "Pull requests: read and write" on this repository.';
-    case 404:
-      return "Repository, branch or file not found, or the token cannot see this repository.";
-    case 409:
-      return "GitHub reported a conflict (the branch moved while saving). Scan again, then retry.";
-    case 429:
-      return "GitHub is limiting requests right now. Wait a minute, then try again.";
-    case 422:
-      return `GitHub refused the request${detail ? `: ${detail}` : "."}`;
-    default:
-      return `GitHub error ${status}${detail ? `: ${detail}` : ""}`;
-  }
-}
-async function loadRepoFiles(client, commitSha, fallbackTokensPath) {
-  const treeSha = await client.getCommitTree(commitSha);
-  const { entries, truncated } = await client.getTree(treeSha, true);
-  if (truncated) throw new Error("The repository tree is too large to read in one request.");
-  const warnings = [];
-  let config;
-  let configText;
-  const configEntry = entries.find((e) => e.type === "blob" && e.path === CONFIG_FILE);
-  if (configEntry) {
-    try {
-      configText = await client.getBlobText(configEntry.sha);
-      config = loadConfig(configText);
+      return await this.request("GET", `${this.repoPath}/branches/${encodeRef(branch)}/protection`);
     } catch (err) {
-      warnings.push(err instanceof ConfigError ? `${err.message}. Using ${fallbackTokensPath} instead.` : `${CONFIG_FILE} could not be read.`);
+      if (!(err instanceof GitHubError)) throw err;
+      if (err.status === 404) return null;
+      if (err.status === 403 || err.status === 401) {
+        const b = await this.request("GET", `${this.repoPath}/branches/${encodeRef(branch)}`).catch(() => void 0);
+        return b?.protected === false ? null : void 0;
+      }
+      throw err;
     }
   }
-  const tokensPath2 = (config?.tokens.root ?? fallbackTokensPath).replace(/^\/+|\/+$/g, "");
-  const checksFile = config?.tokens.contrastChecks ?? DEFAULT_TOKEN_PATHS.contrastChecks;
-  const prefix = tokensPath2 + "/";
-  const wanted = entries.filter(
-    (e) => e.type === "blob" && e.path.startsWith(prefix) && (e.path.endsWith(".tokens.json") || e.path === prefix + checksFile)
-  );
-  if (!wanted.some((e) => e.path.endsWith(".tokens.json"))) throw new Error(`No *.tokens.json files found under ${tokensPath2} at ${commitSha.slice(0, 7)}.`);
-  const files = {};
-  let contrastChecks;
-  const queue = [...wanted];
-  const worker = async () => {
-    for (let e = queue.shift(); e; e = queue.shift()) {
-      const text = await client.getBlobText(e.sha);
-      const rel = e.path.slice(prefix.length);
-      if (rel === checksFile) contrastChecks = text;
-      else files[rel] = text;
-    }
-  };
-  await Promise.all([worker(), worker(), worker(), worker()]);
-  return { commitSha, treeSha, files, contrastChecks, config, ...config ? { configText } : {}, tokensPath: tokensPath2, warnings };
-}
-function withRulesetUrl(r) {
-  const href = r._links?.html?.href;
-  return href && !r.html_url ? { ...r, html_url: href } : r;
-}
-function toIssue(r) {
-  return {
-    number: r.number,
-    title: r.title,
-    body: r.body ?? "",
-    url: r.html_url,
-    state: r.state,
-    stateReason: r.state_reason ?? null,
-    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,
-    ...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*$/];
-function prNumberFromSubject(subject) {
-  for (const re of SUBJECT_PR) {
-    const m = re.exec(subject);
-    if (m) return Number(m[1]);
+  /** Create a check run (needs a GitHub App token; personal tokens are refused by GitHub). */
+  async createCheckRun(input) {
+    const r = await this.request("POST", `${this.repoPath}/check-runs`, {
+      name: input.name,
+      head_sha: input.headSha,
+      ...input.status ? { status: input.status } : {},
+      ...input.conclusion ? { conclusion: input.conclusion } : {},
+      ...input.output ? { output: input.output } : {}
+    });
+    return { id: r.id, name: r.name, status: r.status, conclusion: r.conclusion, url: r.html_url };
   }
-  return void 0;
-}
-function parseChangesetText(path, text) {
-  const m = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/.exec(text);
-  if (!m) return null;
-  const bumps = [...m[1].matchAll(/["']?([^"'\s:]+)["']?\s*:\s*(major|minor|patch)/g)].map((x) => ({ pkg: x[1], bump: x[2] }));
-  const order = ["major", "minor", "patch"];
-  const bump = order.find((b) => bumps.some((x) => x.bump === b));
-  const summary = m[2].trim().split(/\r?\n\r?\n/)[0].replace(/\s+/g, " ").trim();
-  return { path, ...bump ? { bump } : {}, packages: bumps.map((b) => b.pkg), summary };
-}
-function firstParagraph(text) {
-  if (!text) return "";
-  const cleaned = text.replace(/<!--[\s\S]*?-->/g, "");
-  for (const para of cleaned.split(/\r?\n\s*\r?\n/)) {
-    const lines = para.split(/\r?\n/).filter((l) => l.trim() && !/^\s*#{1,6}\s/.test(l) && !/^\s*[-*]\s*\[[ xX]\]/.test(l) && !/^\s*(Co-Authored-By|Claude-Session|Signed-off-by):/i.test(l));
-    const s = lines.join(" ").replace(/\s+/g, " ").trim();
-    if (s && !/^\|/.test(s)) return s.length > 400 ? `${s.slice(0, 397)}...` : s;
+  async removeLabel(issueNumber, label) {
+    await this.request("DELETE", `${this.repoPath}/issues/${issueNumber}/labels/${encodeURIComponent(label)}`);
   }
-  return "";
-}
-function countChanges(changes) {
-  const c = { added: 0, changed: 0, removed: 0, renamed: 0, total: changes.length };
-  for (const x of changes) c[x.kind]++;
-  return c;
-}
-const shortSha = (sha) => sha.slice(0, 7);
-function titleOf(commit) {
-  if (commit.pr?.title) return commit.pr.title;
-  if (/^Merge pull request #\d+/.test(commit.subject)) {
-    const first = (commit.body ?? "").split(/\r?\n/).find((l) => l.trim());
-    if (first) return first.trim();
+  // --- branch actions shared by Studio, the MCP server and the CLI (branch-actions.ts) ---
+  /** The account the token belongs to (GET /user). Needs a token. */
+  async getViewer() {
+    this.assertToken("Reading who you are on GitHub");
+    const r = await this.request("GET", "/user");
+    return { login: r.login };
   }
-  return commit.subject;
-}
-function buildHistoryEntry(input) {
-  const { config, commit } = input;
-  const beforeSet = new LayeredTokenSet(config, input.before);
-  const afterSet = new LayeredTokenSet(config, input.after);
-  const changes = diffLayered(beforeSet, afterSet);
-  if (!changes.length) return null;
-  const tier = classifyLayered(changes, [], config);
-  const changesets = (input.changesets ?? []).map((c) => parseChangesetText(c.path, c.text)).filter((c) => c !== null);
-  const pkg = config.changesets?.package;
-  const relevant = changesets.filter((c) => !pkg || !c.packages.length || c.packages.includes(pkg));
-  const title = titleOf(commit);
-  const why = relevant.map((c) => c.summary).find(Boolean) || firstParagraph(commit.pr?.body) || firstParagraph(commit.body) || title;
-  const prNumber = commit.pr?.number ?? prNumberFromSubject(commit.subject);
-  const pr = commit.pr ?? (prNumber ? { number: prNumber, title, ...config.repo ? { url: `https://github.com/${config.repo.owner}/${config.repo.name}/pull/${prNumber}` } : {} } : void 0);
-  const changesetBump2 = relevant.map((c) => c.bump).find((b) => b === "major");
-  const bump = changesetBump2 ?? tier.bump;
-  return {
-    id: pr ? `pr-${pr.number}` : shortSha(commit.sha),
-    sha: commit.sha,
-    ...commit.parents[0] ? { baseSha: commit.parents[0] } : {},
-    date: commit.date,
-    // 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 } : {},
-    changes,
-    counts: countChanges(changes),
-    tier: tier.tier,
-    bump,
-    breaking: bump === "major",
-    reasons: tier.reasons,
-    changesets: relevant,
-    ...changes.length > BULK_LIMIT ? { bulk: true } : {},
-    ...input.demo ? { demo: true } : {}
-  };
-}
-async function collectHistory(config, backend, opts) {
-  const root = config.tokens.root.replace(/\/$/, "");
-  const commits = await backend.listCommits({ ref: opts.ref, paths: [root === "." ? "" : root].filter(Boolean), limit: opts.limit ?? 40 });
-  const seen = /* @__PURE__ */ new Set();
-  const picked = [];
-  for (const c of commits) {
-    const n = c.pr?.number;
-    if (n !== void 0) {
-      if (seen.has(n)) continue;
-      seen.add(n);
-    }
-    picked.push(c);
+  /** The repository's merge settings and the viewer's permissions (unknown settings count as allowed). */
+  async getMergeSettings() {
+    return this.request("GET", this.repoPath);
   }
-  const entries = [];
-  let done = 0;
-  for (const c of picked) {
-    const parent = c.parents[0];
-    const [before, after] = await Promise.all([parent ? backend.tokenFiles(parent) : Promise.resolve(/* @__PURE__ */ new Map()), backend.tokenFiles(c.sha)]);
-    let changesets = [];
-    if (backend.changesetPaths && backend.readFile && config.changesets) {
-      const [was, now] = await Promise.all([parent ? backend.changesetPaths(parent) : Promise.resolve([]), backend.changesetPaths(c.sha)]);
-      const added = now.filter((p) => !was.includes(p) && p.endsWith(".md") && !/README\.md$/i.test(p));
-      changesets = (await Promise.all(added.map(async (p) => ({ path: p, text: await backend.readFile(c.sha, p) ?? "" })))).filter((x) => x.text);
-    }
-    const e = buildHistoryEntry({ config, commit: c, before, after, changesets });
-    if (e) entries.push(e);
-    opts.onProgress?.(++done, picked.length);
+  /**
+   * Merges a pull request, only at `sha` (GitHub refuses when the branch moved meanwhile). The repository's branch
+   * rules still apply: GitHub refuses a merge they block, whatever Bridge says.
+   */
+  async mergePullRequest(n, input) {
+    this.assertToken("Merging a branch");
+    const r = await this.request("PUT", `${this.repoPath}/pulls/${n}/merge`, {
+      merge_method: input.method,
+      sha: input.sha,
+      ...input.commitMessage !== void 0 && input.method !== "rebase" ? { commit_message: input.commitMessage } : {}
+    });
+    return { sha: r?.sha ?? "", merged: r?.merged ?? true };
   }
-  return entries;
-}
-function parseChangelog(text) {
-  const out = [];
-  const parts = text.split(/^##\s+/m).slice(1);
-  for (const p of parts) {
-    const [head, ...rest] = p.split(/\r?\n/);
-    const version = /v?(\d+\.\d+\.\d+(?:-[\w.]+)?)/.exec(head ?? "")?.[1];
-    if (!version) continue;
-    const body = rest.join("\n");
-    const shas = [...new Set([...body.matchAll(/(?:^|[\s[`(])([0-9a-f]{7,40})(?=[\s`\]):]|$)/gm)].map((m) => m[1]))];
-    const prs = [...new Set([...body.matchAll(/(?:#|\/pull\/)(\d+)/g)].map((m) => Number(m[1])))];
-    const date = /(\d{4}-\d{2}-\d{2})/.exec(head ?? "")?.[1];
-    out.push({ version, ...date ? { date } : {}, shas, prs });
+  /** GitHub's "Update branch": merges the base into the pull request, only when its head is still `expectedHeadSha`. */
+  async updatePullRequestBranch(n, expectedHeadSha) {
+    this.assertToken("Updating a branch from main");
+    await this.request("PUT", `${this.repoPath}/pulls/${n}/update-branch`, { expected_head_sha: expectedHeadSha });
   }
-  return out;
-}
-function releasesFromTags(tags, pkg) {
-  const out = [];
-  for (const t of tags) {
-    const m = /^(?:(@?[^@\s]+)@)?v?(\d+\.\d+\.\d+(?:-[\w.]+)?)$/.exec(t.name);
-    if (!m) continue;
-    if (pkg && m[1] && m[1] !== pkg) continue;
-    out.push({ version: m[2], ...t.sha ? { sha: t.sha } : {}, ...t.date ? { date: t.date } : {} });
+  /**
+   * Merges the branch `head` into the branch `base` (GitHub's merges API): a merge commit on `base`, or nothing when
+   * `base` already has every commit of `head`. A conflict throws a GitHubError with status 409. Refuses protected
+   * branches and, with a branch prefix, a `base` without it.
+   */
+  async mergeIntoBranch(base, head, message) {
+    this.assertToken("Merging a branch into another");
+    this.assertWritableBranch(base);
+    const r = await this.request("POST", `${this.repoPath}/merges`, { base, head, commit_message: message });
+    return r?.sha ? { status: "merged", sha: r.sha } : { status: "up-to-date", sha: null };
+  }
+  /** Posts a comment on an issue or pull request and returns its id and link. */
+  async createIssueComment(n, body) {
+    this.assertToken("Commenting");
+    const r = await this.request("POST", `${this.repoPath}/issues/${n}/comments`, { body });
+    return { id: r.id, url: r.html_url };
   }
-  return out;
-}
-function assignVersions(entries, releases) {
-  const dated = releases.filter((r) => r.date).sort((a, b) => Date.parse(a.date) - Date.parse(b.date));
-  return entries.map((e) => {
-    const cited = releases.find((r) => r.shas?.some((s) => e.sha.startsWith(s)) || e.pr && r.prs?.includes(e.pr.number));
-    const byTag = cited ? void 0 : dated.find((r) => r.sha === e.sha || Date.parse(r.date) >= Date.parse(e.date));
-    return { ...e, version: (cited ?? byTag)?.version ?? UNRELEASED };
-  });
-}
-const BUMP_RANK = { patch: 0, minor: 1, major: 2 };
-function versionTimeline(entries, releases = []) {
-  const groups = /* @__PURE__ */ new Map();
-  for (const e of entries) {
-    const v = e.version ?? UNRELEASED;
-    let g = groups.get(v);
-    if (!g) {
-      const rel = releases.find((r) => r.version === v);
-      g = { version: v, pending: v === UNRELEASED, date: rel?.date ?? e.date, entries: [], prs: [], tokenChanges: 0, breaking: false, bump: "patch", authors: [] };
-      groups.set(v, g);
-    }
-    g.entries.push(e.id);
-    if (e.pr && !g.prs.includes(e.pr.number)) g.prs.push(e.pr.number);
-    g.tokenChanges += e.counts.total;
-    g.breaking ||= e.breaking;
-    if (BUMP_RANK[e.bump] > BUMP_RANK[g.bump]) g.bump = e.bump;
-    if (!g.authors.includes(e.author)) g.authors.push(e.author);
-    if (!releases.some((r) => r.version === v && r.date) && Date.parse(e.date) > Date.parse(g.date)) g.date = e.date;
+  /** Replaces the text of a comment. */
+  async updateIssueComment(id, body) {
+    this.assertToken("Editing a comment");
+    await this.request("PATCH", `${this.repoPath}/issues/comments/${id}`, { body });
   }
-  return [...groups.values()].sort((a, b) => a.pending ? -1 : b.pending ? 1 : Date.parse(b.date) - Date.parse(a.date));
-}
-const matchesToken = (path, q) => path === q || path.startsWith(`${q.replace(/\.$/, "")}.`);
-function filterHistory(entries, f = {}) {
-  const q = f.query?.trim().toLowerCase();
-  return entries.filter(
-    (e) => (!f.token || e.changes.some((c) => matchesToken(c.path, f.token) || c.from && matchesToken(c.from, f.token))) && (!f.author || e.author.toLowerCase() === f.author.toLowerCase()) && (!f.tier || e.tier === f.tier) && (!f.version || (e.version ?? UNRELEASED) === f.version) && (f.breaking === void 0 || e.breaking === f.breaking) && (!f.since || Date.parse(e.date) >= Date.parse(f.since)) && (!f.until || Date.parse(e.date) <= Date.parse(f.until) + 86399999) && (!q || `${e.title} ${e.why} ${e.pr ? `#${e.pr.number}` : ""} ${e.sha}`.toLowerCase().includes(q))
-  );
-}
-function fileModes(config, file) {
-  for (const layer of config.tokens.layers) {
-    const keys = [];
-    const marked = layer.files.replace(/\{([^}]+)\}/g, (_, k) => {
-      keys.push(k);
-      return "
";
+  /** Submits a review on a given commit (the head the reviewer saw); the body may be empty for an approval. */
+  async submitReview(n, input) {
+    this.assertToken("Reviewing a branch");
+    const r = await this.request("POST", `${this.repoPath}/pulls/${n}/reviews`, {
+      event: input.event,
+      ...input.body ? { body: input.body } : {},
+      ...input.commitId ? { commit_id: input.commitId } : {}
     });
-    const source = globToRegExp(marked).source.replace(/\u0001/g, "([^/.]+)");
-    const m = new RegExp(source).exec(file);
-    if (m) return Object.fromEntries(keys.map((k, i) => [k, m[i + 1]]));
+    return { id: r.id, user: r.user?.login, state: r.state, body: r.body ?? "" };
   }
-  return {};
-}
-function modeLabel(modes) {
-  const v = Object.values(modes).filter(Boolean);
-  if (!v.length) return "All modes";
-  const s = v.join(" ");
-  return s.charAt(0).toUpperCase() + s.slice(1);
-}
-function tokenHistory(entries, path, config) {
-  const names2 = /* @__PURE__ */ new Set([path]);
-  const out = [];
-  const sorted = [...entries].sort((a, b) => Date.parse(b.date) - Date.parse(a.date));
-  for (const e of sorted) {
-    const hits = e.changes.filter((c) => names2.has(c.path));
-    for (const c of hits) {
-      const modes = config ? fileModes(config, c.file) : {};
-      out.push({
-        entryId: e.id,
-        sha: e.sha,
-        date: e.date,
-        author: e.author,
-        title: e.title,
-        why: e.why,
-        ...e.pr ? { pr: e.pr } : {},
-        ...e.version ? { version: e.version } : {},
-        ...e.demo ? { demo: true } : {},
-        kind: c.kind,
-        path: c.path,
-        ...c.from ? { from: c.from } : {},
-        file: c.file,
-        modes,
-        modeLabel: modeLabel(modes),
-        fields: c.fields,
-        ...c.before !== void 0 ? { before: c.before } : {},
-        ...c.after !== void 0 ? { after: c.after } : {},
-        ...c.beforeCss !== void 0 ? { beforeCss: c.beforeCss } : {},
-        ...c.afterCss !== void 0 ? { afterCss: c.afterCss } : {},
-        ...c.descriptionBefore !== void 0 ? { descriptionBefore: c.descriptionBefore } : {},
-        ...c.descriptionAfter !== void 0 ? { descriptionAfter: c.descriptionAfter } : {}
-      });
-    }
-    for (const c of hits) if (c.kind === "renamed" && c.from) names2.add(c.from);
+  /** Line comments of a pull request (review threads), oldest first. */
+  async listReviewComments(n) {
+    const r = await this.request(
+      "GET",
+      `${this.repoPath}/pulls/${n}/comments?per_page=100`
+    );
+    return r.map((c) => ({ id: c.id, body: c.body ?? "", author: c.user?.login ?? "unknown", path: c.path, line: c.line ?? null, inReplyTo: c.in_reply_to_id ?? null, url: c.html_url, createdAt: c.created_at }));
   }
-  return out;
-}
-const same$1 = (a, b) => JSON.stringify(a) === JSON.stringify(b);
-const keyOf = (path, file) => `${path}@${file}`;
-const show$2 = (v) => typeof v === "string" ? v : JSON.stringify(v);
-function defIn(set, path, file) {
-  return set.defs.find((d) => d.path === path && d.file === file);
-}
-function sharesCombo(set, a, b) {
-  return a === b || set.combos().some((c) => {
-    const files = set.layerFiles(c).files;
-    return files.includes(a) && files.includes(b);
-  });
-}
-function laterTouching(later, path, file, from) {
-  return later.filter((e) => e.changes.some((c) => c.file === file && (c.path === path || c.from === path || from !== void 0 && (c.path === from || c.from === from)))).sort((a, b) => Date.parse(a.date) - Date.parse(b.date)).map((e) => ({ id: e.id, title: e.title, date: e.date, author: e.author, ...e.pr ? { pr: e.pr.number } : {} }));
-}
-function planRevert(input) {
-  const { current, entry } = input;
-  const later = (input.later ?? []).filter((e) => e.id !== entry.id && Date.parse(e.date) >= Date.parse(entry.date));
-  const res = input.resolutions ?? {};
-  const planned = [];
-  const conflicts = [];
-  const skipped = [];
-  const config = current.config;
-  const css = (path, file) => current.resolve(path, current.comboForFile(file)).css;
-  for (const c of entry.changes) {
-    const key = keyOf(c.path, c.file);
-    const label = modeLabel(fileModes(config, c.file));
-    const original = { ...c.before !== void 0 ? { before: c.before } : {}, ...c.after !== void 0 ? { after: c.after } : {}, ...c.beforeCss ? { beforeCss: c.beforeCss } : {}, ...c.afterCss ? { afterCss: c.afterCss } : {} };
-    const conflict = (reason, message, cur, editIfForced, summary) => {
-      const resolution = res[key] ?? "keep-current";
-      conflicts.push({ key, path: c.path, file: c.file, kind: c.kind, reason, message, original, ...cur ? { current: cur } : {}, later: laterTouching(later, c.path, c.file, c.from), resolution });
-      if (resolution === "use-before" && editIfForced) planned.push({ key, path: c.path, file: c.file, summary: summary ?? `${editIfForced.op} ${c.path}`, edit: editIfForced });
-    };
-    const now = defIn(current, c.path, c.file);
-    switch (c.kind) {
-      case "changed": {
-        if (!now) {
-          conflict("removed-later", `${c.path} was removed from ${c.file} after this change. Restoring it is a new token decision, not a revert.`, void 0, { op: "add", path: c.path, file: c.file, value: c.before, ...c.type ? { type: c.type } : {}, ...c.descriptionBefore ? { description: c.descriptionBefore } : {} }, `Add ${c.path} back with ${show$2(c.before)} (${label})`);
-          break;
-        }
-        const valueField = c.fields.includes("value");
-        const descField = c.fields.includes("description");
-        const cur = { value: now.value, css: css(c.path, c.file) };
-        const valueAt = (v) => same$1(now.value, v);
-        const descNow = now.description ?? "";
-        if (!valueField && !descField) {
-          skipped.push({ key, path: c.path, file: c.file, reason: "Only the type or extensions changed: edit those by hand." });
-          break;
-        }
-        if ((!valueField || valueAt(c.before)) && (!descField || descNow === (c.descriptionBefore ?? ""))) {
-          skipped.push({ key, path: c.path, file: c.file, reason: "Already back to the value from before this change." });
-          break;
-        }
-        const valueMoved = valueField && !valueAt(c.after) && !valueAt(c.before);
-        const descMoved = descField && descNow !== (c.descriptionAfter ?? "") && descNow !== (c.descriptionBefore ?? "");
-        const edit = {
-          op: "set",
-          path: c.path,
-          file: c.file,
-          ...valueField ? { value: c.before } : {},
-          ...descField ? { description: c.descriptionBefore ?? "" } : {}
-        };
-        const summary = valueField ? `Set ${c.path} back to ${show$2(c.before)} (${label})` : `Put the old description of ${c.path} back (${label})`;
-        if (valueMoved || descMoved) {
-          conflict("changed-later", `${c.path} changed again after this change: it is now ${cur.css || show$2(cur.value)}, not ${c.afterCss || show$2(c.after)}.`, cur, edit, summary);
-          break;
-        }
-        planned.push({ key, path: c.path, file: c.file, summary, edit });
-        break;
-      }
-      case "added": {
-        if (!now) {
-          skipped.push({ key, path: c.path, file: c.file, reason: "Already removed." });
-          break;
-        }
-        const users = current.referencedBy(c.path).filter((u) => u.path !== c.path && sharesCombo(current, u.file, c.file));
-        const edit = { op: "remove", path: c.path, file: c.file };
-        const summary = `Remove ${c.path} (${label})`;
-        if (!same$1(now.value, c.after)) {
-          conflict("changed-later", `${c.path} changed after it was added: it is now ${css(c.path, c.file) || show$2(now.value)}.`, { value: now.value, css: css(c.path, c.file) }, edit, summary);
-          break;
-        }
-        if (users.length) {
-          conflict("still-referenced", `${users.length} token(s) alias ${c.path} now (${users.slice(0, 4).map((u) => u.path).join(", ")}${users.length > 4 ? ", ..." : ""}). Removing it would break them.`, { value: now.value, css: css(c.path, c.file) }, edit, summary);
-          break;
-        }
-        planned.push({ key, path: c.path, file: c.file, summary, edit });
-        break;
-      }
-      case "removed": {
-        const edit = { op: "add", path: c.path, file: c.file, value: c.before, ...c.type ? { type: c.type } : {}, ...c.descriptionBefore ? { description: c.descriptionBefore } : {} };
-        const summary = `Add ${c.path} back with ${show$2(c.before)} (${label})`;
-        if (now) {
-          if (same$1(now.value, c.before)) skipped.push({ key, path: c.path, file: c.file, reason: "Already back." });
-          else conflict("recreated-later", `${c.path} was added again later with another value (${css(c.path, c.file) || show$2(now.value)}).`, { value: now.value, css: css(c.path, c.file) });
-          break;
-        }
-        planned.push({ key, path: c.path, file: c.file, summary, edit });
-        break;
-      }
-      case "renamed": {
-        const from = c.from;
-        const back = defIn(current, from, c.file);
-        if (back && !now) {
-          skipped.push({ key, path: c.path, file: c.file, reason: `Already named ${from}.` });
-          break;
-        }
-        if (!now) {
-          conflict("renamed-later", `${c.path} no longer exists in ${c.file}: it was renamed or removed again later.`);
-          break;
-        }
-        if (back) {
-          conflict("recreated-later", `${from} exists again in ${c.file}, so ${c.path} cannot take its old name back.`, { value: back.value, css: css(from, c.file) });
-          break;
-        }
-        if (planned.some((p) => p.edit.op === "rename" && p.path === c.path)) {
-          skipped.push({ key, path: c.path, file: c.file, reason: "Covered by the rename above." });
-          break;
-        }
-        planned.push({ key, path: c.path, file: c.file, summary: `Rename ${c.path} back to ${from} and repoint its aliases`, edit: { op: "rename", path: c.path, newPath: from } });
-        break;
-      }
-    }
+  /** Asks these people to review a pull request. */
+  async requestReviewers(n, logins) {
+    this.assertToken("Asking for a review");
+    await this.request("POST", `${this.repoPath}/pulls/${n}/requested_reviewers`, { reviewers: logins });
+  }
+  /** Takes these people off the requested reviewers. */
+  async removeRequestedReviewers(n, logins) {
+    this.assertToken("Changing the requested reviewers");
+    await this.request("DELETE", `${this.repoPath}/pulls/${n}/requested_reviewers`, { reviewers: logins });
+  }
+  /** Replies in the thread of a line comment. */
+  async replyToReviewComment(n, commentId, body) {
+    this.assertToken("Replying to a comment");
+    const r = await this.request("POST", `${this.repoPath}/pulls/${n}/comments/${commentId}/replies`, { body });
+    return { id: r.id, url: r.html_url };
+  }
+  /**
+   * What `head` adds on top of `base`, with what library sync needs: the shared start (merge base), the base
+   * commit and its tree, how far behind, and the files with their previous names.
+   */
+  async compareDetailed(base, head) {
+    const r = await this.request("GET", `${this.repoPath}/compare/${encodeRef(base)}...${encodeRef(head)}`);
+    return {
+      behindBy: r.behind_by,
+      aheadBy: r.ahead_by,
+      mergeBase: r.merge_base_commit?.sha ?? null,
+      baseSha: r.base_commit?.sha ?? null,
+      baseTree: r.base_commit?.commit?.tree?.sha ?? null,
+      files: (r.files ?? []).map((f) => ({ filename: f.filename, status: f.status, ...f.previous_filename ? { previous_filename: f.previous_filename } : {} }))
+    };
   }
-  const prLink = entry.pr ? entry.pr.url ? `[#${entry.pr.number}](${entry.pr.url})` : `#${entry.pr.number}` : `commit ${entry.sha.slice(0, 7)}`;
-  const title = `Revert: ${entry.title}`;
-  const lines = [
-    `Reverts ${prLink} ("${entry.title}"), merged ${entry.date.slice(0, 10)} by ${entry.author}.`,
-    "",
-    `Original reason: ${entry.why}`,
-    "",
-    "Bridge computed the inverse token edits against the current base branch, not a blind git revert: tokens that changed again since are listed as conflicts and kept unless a reviewer chose to restore them."
-  ];
-  if (conflicts.length) {
-    lines.push("", "### Conflicts", "", "| Token | File | Why | Decision |", "| --- | --- | --- | --- |");
-    for (const k of conflicts) lines.push(`| \`${k.path}\` | ${k.file} | ${k.message.replace(/\|/g, "\\|")}${k.later.length ? ` Later: ${k.later.map((l) => l.pr ? `#${l.pr}` : l.id).join(", ")}.` : ""} | ${k.resolution === "use-before" ? "restore the old value" : "keep current"} |`);
+  /** A tree on top of `baseTree` from entries with their own file mode (blob sha, inline content, or sha null to delete). */
+  async createTreeEntries(baseTree, entries) {
+    const r = await this.request("POST", `${this.repoPath}/git/trees`, { base_tree: baseTree, tree: entries.map((e) => ({ ...e, type: "blob" })) }, true);
+    return r.sha;
   }
-  if (skipped.length) lines.push("", `${skipped.length} change(s) were already undone on the base branch and are left alone.`);
-  return finishPlan({ ...input, kind: "revert", title, prTitle: title, summary: lines.join("\n"), planned, conflicts, skipped, source: entry });
 }
-function planRestore(input) {
-  const { current, path } = input;
-  const files = [...new Set(current.defs.filter((d) => d.path === path).map((d) => d.file))];
-  if (!files.length) throw new Error(`Token "${path}" does not exist on the base branch. Restoring a removed token is a revert of the change that removed it.`);
-  const file = input.file ?? (files.length === 1 ? files[0] : void 0);
-  if (!file) throw new Error(`"${path}" is defined in ${files.join(", ")}. Pass the file (the mode) to restore.`);
-  if (!files.includes(file)) throw new Error(`"${path}" is not defined in ${file}. It is defined in: ${files.join(", ")}.`);
-  const label = modeLabel(fileModes(current.config, file));
-  const from = input.label ? ` from ${input.label}` : "";
-  const planned = [{ key: keyOf(path, file), path, file, summary: `Set ${path} to ${show$2(input.value)} (${label})`, edit: { op: "set", path, file, value: input.value } }];
-  const title = `Restore ${path} (${label})${from}`;
-  const item = input.item;
-  const summary = [
-    `Restores \`${path}\` in ${label} to ${show$2(input.value)}${from}.`,
-    ...item ? ["", `That value came from ${item.pr ? item.pr.url ? `[#${item.pr.number}](${item.pr.url})` : `#${item.pr.number}` : `commit ${item.sha.slice(0, 7)}`} ("${item.title}"), ${item.date.slice(0, 10)}, by ${item.author}.`] : []
-  ].join("\n");
-  return finishPlan({ ...input, kind: "restore", title, prTitle: title, summary, planned, conflicts: [], skipped: [] });
+function toCommitSummary(c) {
+  return {
+    sha: c.sha,
+    parents: (c.parents ?? []).map((p) => p.sha),
+    date: c.commit?.committer?.date ?? c.commit?.author?.date ?? "",
+    author: c.author?.login ?? c.commit?.author?.name ?? "unknown",
+    message: c.commit?.message ?? ""
+  };
 }
-const issueKey = (i) => `${i.code}|${i.path ?? ""}|${i.file ?? ""}|${i.message}`;
-function finishPlan(p) {
-  const { current } = p;
-  const config = current.config;
-  const edits = p.planned.map((x) => x.edit);
-  const notes = [];
-  const empty = classifyLayered([], [], config);
-  const base = {
-    kind: p.kind,
-    title: p.title,
-    prTitle: p.prTitle,
-    summary: p.summary,
-    ...p.source ? { source: { id: p.source.id, sha: p.source.sha, title: p.source.title, ...p.source.pr ? { pr: p.source.pr } : {}, date: p.source.date, author: p.source.author } } : {},
-    planned: p.planned,
-    edits,
-    conflicts: p.conflicts,
-    skipped: p.skipped,
-    branch: `${config.governance.branchPrefix}${slugify(p.title, 48)}`
+function toSummary(r) {
+  return {
+    number: r.number,
+    title: r.title,
+    state: r.merged_at || r.merged ? "merged" : r.state,
+    draft: Boolean(r.draft),
+    author: r.user?.login ?? "unknown",
+    headRef: r.head?.ref,
+    headSha: r.head?.sha,
+    baseRef: r.base?.ref,
+    labels: (r.labels ?? []).map((l) => l.name),
+    url: r.html_url,
+    updatedAt: r.updated_at,
+    ...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) } : {}
   };
-  const nothing = (why) => ({ ...base, status: "nothing-to-do", why, changes: [], contrast: [], newFailures: [], newErrors: [], tier: empty, files: [], commitMessage: "", prBody: "", notes });
-  if (!edits.length) return nothing(p.conflicts.length ? 'Every change conflicts with a later one. Choose "restore the old value" on a conflict to include it.' : "Nothing left to undo: the base branch already has the old values.");
-  let result;
-  try {
-    result = applyTokenEdits(current, edits);
-  } catch (e) {
-    return { ...nothing(e.message), status: "blocked" };
+}
+function friendlyMessage(status, detail, info = {}) {
+  if (info.auth === "rejected") return TOKEN_REJECTED_MESSAGE;
+  if (info.auth === "missing-permission") return missingPermissionMessage(info.permission);
+  switch (status) {
+    case 401:
+      return "GitHub rejected the token. It may be expired or mistyped: create a new one and save it in Settings.";
+    case 403:
+      if (/rate limit/i.test(detail)) return "GitHub is limiting requests right now. Wait a minute, then try again.";
+      if (/archived/i.test(detail)) return "This repository is archived and read-only.";
+      return 'The token does not have permission for this. It needs "Contents: read and write" and "Pull requests: read and write" on this repository.';
+    case 404:
+      return "Repository, branch or file not found, or the token cannot see this repository.";
+    case 409:
+      return "GitHub reported a conflict (the branch moved while saving). Scan again, then retry.";
+    case 429:
+      return "GitHub is limiting requests right now. Wait a minute, then try again.";
+    case 422:
+      return `GitHub refused the request${detail ? `: ${detail}` : "."}`;
+    default:
+      return `GitHub error ${status}${detail ? `: ${detail}` : ""}`;
   }
-  notes.push(...result.notes);
-  const after = new LayeredTokenSet(config, result.files);
-  const changes = diffLayered(current, after);
-  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 pairs2 = p.pairs ?? [];
-  const modes = config.contrast?.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);
-  const prBody = composeProposalBody({ summary: p.summary, changes, contrast, impact, tier, validationErrors: newErrors.length, tool: p.tool ?? "Bridge", ...p.author ? { author: p.author } : {} });
-  const changeset = config.changesets ? { path: `${config.changesets.dir.replace(/\/$/, "")}/bridge-${slugify(p.title, 48)}.md`, content: formatChangeset(config.changesets.package, tier.bump, p.title.replace(/\.?$/, ".")) } : void 0;
-  const files = [...result.touched.map((f) => ({ path: current.repoPath(f), content: result.files.get(f) })), ...changeset ? [changeset] : []];
-  const commitMessage = `${p.kind === "revert" ? "revert(tokens)" : "fix(tokens)"}: ${p.title.replace(/^Revert: /, "")}
-
-${p.source?.pr ? `Reverts #${p.source.pr.number}. ` : ""}Tier ${tier.tier}. Planned with ${p.tool ?? "Bridge"}.`;
-  const blocked = newErrors.length || newFailures.length;
-  return {
-    ...base,
-    status: blocked ? "blocked" : "ready",
-    ...blocked ? { why: [newErrors.length ? `${newErrors.length} new validation error(s)` : "", newFailures.length ? `${newFailures.length} contrast pair(s) would fail` : ""].filter(Boolean).join(" and ") } : {},
-    changes,
-    contrast,
-    newFailures,
-    newErrors,
-    tier,
-    files,
-    ...changeset ? { changeset } : {},
-    commitMessage,
-    prBody,
-    notes
+}
+async function loadRepoFiles(client, commitSha, fallbackTokensPath) {
+  const treeSha = await client.getCommitTree(commitSha);
+  const { entries, truncated } = await client.getTree(treeSha, true);
+  if (truncated) throw new Error("The repository tree is too large to read in one request.");
+  const warnings = [];
+  let config;
+  let configText;
+  const configEntry = entries.find((e) => e.type === "blob" && e.path === CONFIG_FILE);
+  if (configEntry) {
+    try {
+      configText = await client.getBlobText(configEntry.sha);
+      config = loadConfig(configText);
+    } catch (err) {
+      warnings.push(err instanceof ConfigError ? `${err.message}. Using ${fallbackTokensPath} instead.` : `${CONFIG_FILE} could not be read.`);
+    }
+  }
+  const tokensPath2 = (config?.tokens.root ?? fallbackTokensPath).replace(/^\/+|\/+$/g, "");
+  const checksFile = config?.tokens.contrastChecks ?? DEFAULT_TOKEN_PATHS.contrastChecks;
+  const prefix = tokensPath2 + "/";
+  const wanted = entries.filter(
+    (e) => e.type === "blob" && e.path.startsWith(prefix) && (e.path.endsWith(".tokens.json") || e.path === prefix + checksFile)
+  );
+  if (!wanted.some((e) => e.path.endsWith(".tokens.json"))) throw new Error(`No *.tokens.json files found under ${tokensPath2} at ${commitSha.slice(0, 7)}.`);
+  const files = {};
+  let contrastChecks;
+  const queue = [...wanted];
+  const worker = async () => {
+    for (let e = queue.shift(); e; e = queue.shift()) {
+      const text = await client.getBlobText(e.sha);
+      const rel = e.path.slice(prefix.length);
+      if (rel === checksFile) contrastChecks = text;
+      else files[rel] = text;
+    }
   };
+  await Promise.all([worker(), worker(), worker(), worker()]);
+  return { commitSha, treeSha, files, contrastChecks, config, ...config ? { configText } : {}, tokensPath: tokensPath2, warnings };
 }
-function planToJson(plan) {
+function withRulesetUrl(r) {
+  const href = r._links?.html?.href;
+  return href && !r.html_url ? { ...r, html_url: href } : r;
+}
+function toIssue(r) {
   return {
-    bridge: "change-plan",
-    kind: plan.kind,
-    status: plan.status,
-    title: plan.prTitle,
-    branch: plan.branch,
-    tier: plan.tier.tier,
-    bump: plan.tier.bump,
-    edits: plan.edits,
-    conflicts: plan.conflicts.map((c) => ({ key: c.key, reason: c.reason, message: c.message, resolution: c.resolution })),
-    files: plan.files,
-    commitMessage: plan.commitMessage,
-    prBody: plan.prBody
+    number: r.number,
+    title: r.title,
+    body: r.body ?? "",
+    url: r.html_url,
+    state: r.state,
+    stateReason: r.state_reason ?? null,
+    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,
+    ...r.assignees?.length ? { assignees: r.assignees.map((a) => a.login ?? "").filter(Boolean) } : {},
+    ...r.closed_at ? { closedAt: r.closed_at } : {}
   };
 }
-function packageDirCandidates(config) {
-  const parts = config.tokens.root.replace(/\/$/, "").split("/").filter((p) => p && p !== ".");
-  const out = [];
-  for (let i = parts.length; i >= 0; i--) out.push(parts.slice(0, i).join("/"));
-  return out;
+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 mergeReleases(changelog, tags) {
-  const byVersion = /* @__PURE__ */ new Map();
-  for (const r of [...changelog, ...tags]) {
-    const prev = byVersion.get(r.version);
-    byVersion.set(r.version, prev ? { ...r, ...prev, ...prev.date ? {} : r.date ? { date: r.date } : {}, ...prev.sha ? {} : r.sha ? { sha: r.sha } : {} } : r);
-  }
-  return [...byVersion.values()];
+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 buildReport(args) {
-  const entries = assignVersions(args.entries, args.releases).sort((a, b) => Date.parse(b.date) - Date.parse(a.date));
-  return { ...args, entries, timeline: versionTimeline(entries, args.releases) };
+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*$/];
+function prNumberFromSubject(subject) {
+  for (const re of SUBJECT_PR) {
+    const m = re.exec(subject);
+    if (m) return Number(m[1]);
+  }
+  return void 0;
 }
-const DOCS_KEYS = ["summary", "preview", "whenToUse", "whenNotToUse", "dos", "donts", "accessibility", "contentGuidelines", "anatomy"];
-const PROSE_KEYS = ["summary", "whenToUse", "whenNotToUse", "dos", "donts", "accessibility", "contentGuidelines"];
-const ACRONYMS = /* @__PURE__ */ new Set(["sm", "md", "lg", "xl", "xs"]);
-function anatomyLabel(className) {
-  if (ACRONYMS.has(className)) return `Size ${className}`;
-  const words = className.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/[-_]+/g, " ").trim().toLowerCase();
-  if (!words) return className;
-  if (words === "root") return "Container";
-  return words.charAt(0).toUpperCase() + words.slice(1);
+function parseChangesetText(path, text) {
+  const m = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/.exec(text);
+  if (!m) return null;
+  const bumps = [...m[1].matchAll(/["']?([^"'\s:]+)["']?\s*:\s*(major|minor|patch)/g)].map((x) => ({ pkg: x[1], bump: x[2] }));
+  const order = ["major", "minor", "patch"];
+  const bump = order.find((b) => bumps.some((x) => x.bump === b));
+  const summary = m[2].trim().split(/\r?\n\r?\n/)[0].replace(/\s+/g, " ").trim();
+  return { path, ...bump ? { bump } : {}, packages: bumps.map((b) => b.pkg), summary };
 }
-function cssModuleClasses(css) {
-  const clean = css.replace(/\/\*[\s\S]*?\*\//g, "").replace(/@keyframes\s+[\w-]+\s*\{(?:[^{}]*\{[^{}]*\})*[^{}]*\}/g, "");
-  const out = [];
-  for (const m of clean.matchAll(/\.(-?[_a-zA-Z][\w-]*)/g)) {
-    const before = clean[m.index - 1] ?? " ";
-    if (/[\w)]/.test(before)) continue;
-    if (!out.includes(m[1])) out.push(m[1]);
+function firstParagraph(text) {
+  if (!text) return "";
+  const cleaned = text.replace(/<!--[\s\S]*?-->/g, "");
+  for (const para of cleaned.split(/\r?\n\s*\r?\n/)) {
+    const lines = para.split(/\r?\n/).filter((l) => l.trim() && !/^\s*#{1,6}\s/.test(l) && !/^\s*[-*]\s*\[[ xX]\]/.test(l) && !/^\s*(Co-Authored-By|Claude-Session|Signed-off-by):/i.test(l));
+    const s = lines.join(" ").replace(/\s+/g, " ").trim();
+    if (s && !/^\|/.test(s)) return s.length > 400 ? `${s.slice(0, 397)}...` : s;
   }
-  return out;
+  return "";
 }
-const cell$2 = (s) => s.replace(/\|/g, "\\|").replace(/\n/g, " ");
-function propsTable(name, props, inherits) {
-  if (!props.length) return inherits ? `${name} has no props of its own. It accepts every native <${inherits}> attribute.` : "";
-  const rows = props.map((p) => `| \`${p.name}\`${p.required ? " (required)" : ""} | \`${cell$2(p.type)}\` | ${p.defaultValue ? `\`${cell$2(p.defaultValue)}\`` : ""} | ${cell$2(p.description ?? "")} |`);
-  const tail = inherits ? `
-
-Also accepts every native <${inherits}> attribute.` : "";
-  return ["| Prop | Type | Default | Description |", "| --- | --- | --- | --- |", ...rows].join("\n") + tail;
+function countChanges(changes) {
+  const c = { added: 0, changed: 0, removed: 0, renamed: 0, total: changes.length };
+  for (const x of changes) c[x.kind]++;
+  return c;
 }
-const isEmpty = (v) => v === void 0 || v === null || typeof v === "string" && !v.trim() || Array.isArray(v) && v.length === 0;
-function missingProse(d) {
-  return PROSE_KEYS.filter((k) => isEmpty(d?.[k]));
+const shortSha = (sha) => sha.slice(0, 7);
+function titleOf(commit) {
+  if (commit.pr?.title) return commit.pr.title;
+  if (/^Merge pull request #\d+/.test(commit.subject)) {
+    const first = (commit.body ?? "").split(/\r?\n/).find((l) => l.trim());
+    if (first) return first.trim();
+  }
+  return commit.subject;
 }
-function prefillDocs(input) {
-  const existing = input.existing ?? null;
-  const anatomy = {};
-  for (const c of input.cssClasses) anatomy[c] = existing?.anatomy?.[c] ?? anatomyLabel(c);
-  const contrastNotes = (input.contrast ?? []).slice().sort((a, b) => a.ratio - b.ratio).map((p) => `${p.foreground} on ${p.background}: ${p.ratio.toFixed(2)}:1 at worst over every brand and theme, needs ${p.min}:1 (${p.ratio >= p.min ? "passes" : "fails"}).`);
-  const missing = missingProse(existing);
-  const changelogLine = input.change ? `${input.name}: ${input.change.replace(/\.$/, "")}.` : missing.length === PROSE_KEYS.length ? `${input.name}: usage guidance added.` : `${input.name}: usage guidance updated.`;
-  const draft = {
-    summary: existing?.summary ?? input.description ?? "",
-    ...existing?.category ? { category: existing.category } : {},
-    ...existing?.status ? { status: existing.status } : {},
-    ...existing?.preview ? { preview: existing.preview } : {},
-    whenToUse: existing?.whenToUse ?? [],
-    whenNotToUse: existing?.whenNotToUse ?? [],
-    dos: existing?.dos ?? [],
-    donts: existing?.donts ?? [],
-    accessibility: existing?.accessibility ?? [],
-    contentGuidelines: existing?.contentGuidelines ?? [],
-    anatomy,
-    ...existing?.draftedBy ? { draftedBy: existing.draftedBy } : {},
-    ...existing?.draftedSections?.length ? { draftedSections: existing.draftedSections } : {},
-    ...existing?.needsReview !== void 0 ? { needsReview: existing.needsReview } : {}
-  };
+function buildHistoryEntry(input) {
+  const { config, commit } = input;
+  const beforeSet = new LayeredTokenSet(config, input.before);
+  const afterSet = new LayeredTokenSet(config, input.after);
+  const changes = diffLayered(beforeSet, afterSet);
+  if (!changes.length) return null;
+  const tier = classifyLayered(changes, [], config);
+  const changesets = (input.changesets ?? []).map((c) => parseChangesetText(c.path, c.text)).filter((c) => c !== null);
+  const pkg = config.changesets?.package;
+  const relevant = changesets.filter((c) => !pkg || !c.packages.length || c.packages.includes(pkg));
+  const title = titleOf(commit);
+  const why = relevant.map((c) => c.summary).find(Boolean) || firstParagraph(commit.pr?.body) || firstParagraph(commit.body) || title;
+  const prNumber = commit.pr?.number ?? prNumberFromSubject(commit.subject);
+  const pr = commit.pr ?? (prNumber ? { number: prNumber, title, ...config.repo ? { url: `https://github.com/${config.repo.owner}/${config.repo.name}/pull/${prNumber}` } : {} } : void 0);
+  const changesetBump2 = relevant.map((c) => c.bump).find((b) => b === "major");
+  const bump = changesetBump2 ?? tier.bump;
   return {
-    component: input.name,
-    propsTable: propsTable(input.name, input.props, input.inherits),
-    tokens: [...new Set(input.tokens)].sort(),
-    inheritedTokens: input.inheritedTokens ?? {},
-    anatomy,
-    contrastNotes,
-    changelogLine,
-    missing,
-    draft
+    id: pr ? `pr-${pr.number}` : shortSha(commit.sha),
+    sha: commit.sha,
+    ...commit.parents[0] ? { baseSha: commit.parents[0] } : {},
+    date: commit.date,
+    // 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 } : {},
+    changes,
+    counts: countChanges(changes),
+    tier: tier.tier,
+    bump,
+    breaking: bump === "major",
+    reasons: tier.reasons,
+    changesets: relevant,
+    ...changes.length > BULK_LIMIT ? { bulk: true } : {},
+    ...input.demo ? { demo: true } : {}
   };
 }
-const SECTION_SHAPE = {
-  summary: '"summary": "one or two sentences"',
-  whenToUse: '"whenToUse": ["..."]',
-  whenNotToUse: '"whenNotToUse": ["..."]',
-  dos: '"dos": [{ "title": "...", "text": "..." }]',
-  donts: '"donts": [{ "title": "...", "text": "..." }]',
-  accessibility: '"accessibility": ["..."]',
-  contentGuidelines: '"contentGuidelines": ["..."]'
-};
-const docsSectionShapes = (keys) => `{ ${keys.map((k) => SECTION_SHAPE[k]).join(", ")} }`;
-function docsPrompt(prefill, conventions = {}, options = {}) {
-  const facts = [
-    `Component: ${prefill.component}`,
-    prefill.propsTable ? `Props (parsed from TypeScript):
-${prefill.propsTable}` : "Props: none of its own.",
-    `Tokens its stylesheet reads: ${prefill.tokens.join(", ") || "none"}`,
-    ...Object.entries(prefill.inheritedTokens).map(([from, list]) => `Tokens it reads through ${from}'s stylesheet: ${list.length}`),
-    `Anatomy (CSS module classes): ${Object.entries(prefill.anatomy).map(([k, v]) => `${k} = ${v}`).join("; ") || "none"}`,
-    prefill.contrastNotes.length ? `Contrast checks:
-- ${prefill.contrastNotes.join("\n- ")}` : "",
-    `Changelog line: ${prefill.changelogLine}`
-  ].filter(Boolean);
-  const block = (title, text) => text?.trim() ? `<${title}>
-${text.trim()}
-</${title}>` : "";
-  const keys = options.keys;
-  const check = keys ? (options.check ?? []).filter((k) => keys.includes(k)) : [];
-  const write = keys ? keys.filter((k) => !check.includes(k)) : [];
-  const task = keys ? [
-    ...write.length ? [`${options.rewrite ? "Rewrite" : "Write"} these sections of ${prefill.component}.docs.json for the Bridge design system: ${write.join(", ")}.`] : [],
-    ...check.length ? [
-      `Check these written sections of ${prefill.component}.docs.json against the current code: ${check.join(", ")}. The code changed after they were written.`,
-      "Return a checked section ONLY when something in it is no longer true for the code (a wrong or removed prop, a removed state or variant, changed behavior). Then return the whole section with only the untrue parts fixed, keeping the writer's wording everywhere else.",
-      "Leave a checked section out of the answer when it is still accurate: a missing key means unchanged. Never return a checked section just to improve its style."
-    ] : [],
-    ...options.rewrite ? ["Rewrite each one from the facts and the source: keep what is true in the current text, drop what the code does not support."] : []
-  ] : [`Write the missing prose of ${prefill.component}.docs.json for the Bridge design system.`];
-  const shape = keys ? [
-    `- ${check.length ? "Return" : "Write"} only these keys: ${keys.join(", ")}${check.length ? ` (the checked ones, ${check.join(", ")}, only when they need a fix)` : ""}. Never return anatomy, preview or any other key: code decides them.`,
-    `- Answer with one JSON object holding only those keys, nothing else: ${docsSectionShapes(keys)}.`
-  ] : [
-    `- Fill only these keys: ${prefill.missing.join(", ") || "none (everything is written: improve nothing, return the draft as is)"}. Keep every other key exactly as given.`,
-    "- Answer with the full docs.json as one JSON object, nothing else."
-  ];
-  return [
-    ...task,
-    "",
-    "Rules:",
-    "- Ground every sentence in the facts and the source below. Never invent props, variants, keyboard behavior or tokens that are not there.",
-    "- Bridge voice: sentence case, plain words, verbs first, no em dashes, no marketing words.",
-    '- Keep the keys and shapes of the example docs.json. dos and donts are { "title", "text" } objects; add an "example" only with components and props that exist.',
-    ...shape,
-    "",
-    "Facts computed from the code:",
-    facts.join("\n\n"),
-    "",
-    `Current draft:
-${JSON.stringify(prefill.draft, null, 2)}`,
-    "",
-    block("source", conventions.source),
-    block("styles", conventions.styles),
-    block("agents-md", conventions.agents),
-    block("voice", conventions.voice),
-    block("example-docs-json", conventions.example)
-  ].filter((x, i, all) => x !== "" || all[i - 1] !== "").join("\n");
-}
-function markClaudeDraft(d, sections) {
-  if (!sections) {
-    const { draftedSections: _all, ...rest } = d;
-    return { ...rest, draftedBy: "claude", needsReview: true };
+async function collectHistory(config, backend, opts) {
+  const root = config.tokens.root.replace(/\/$/, "");
+  const commits = await backend.listCommits({ ref: opts.ref, paths: [root === "." ? "" : root].filter(Boolean), limit: opts.limit ?? 40 });
+  const seen = /* @__PURE__ */ new Set();
+  const picked = [];
+  for (const c of commits) {
+    const n = c.pr?.number;
+    if (n !== void 0) {
+      if (seen.has(n)) continue;
+      seen.add(n);
+    }
+    picked.push(c);
   }
-  const waiting = d.needsReview === true ? d.draftedSections ?? (d.draftedBy ? [...PROSE_KEYS] : []) : [];
-  const union = PROSE_KEYS.filter((k) => waiting.includes(k) || sections.includes(k));
-  return { ...d, draftedBy: "claude", needsReview: true, draftedSections: union };
-}
-function sectionsNeedingReview(d) {
-  if (!d || d.needsReview !== true) return [];
-  return d.draftedSections ? PROSE_KEYS.filter((k) => d.draftedSections.includes(k)) : [...PROSE_KEYS];
-}
-const needsDocsReview = (d) => Boolean(d && d.needsReview === true);
-function acceptDocsDraft(d) {
-  const { draftedSections: _done, ...rest } = d;
-  return { ...rest, needsReview: false };
+  const entries = [];
+  let done = 0;
+  for (const c of picked) {
+    const parent = c.parents[0];
+    const [before, after] = await Promise.all([parent ? backend.tokenFiles(parent) : Promise.resolve(/* @__PURE__ */ new Map()), backend.tokenFiles(c.sha)]);
+    let changesets = [];
+    if (backend.changesetPaths && backend.readFile && config.changesets) {
+      const [was, now] = await Promise.all([parent ? backend.changesetPaths(parent) : Promise.resolve([]), backend.changesetPaths(c.sha)]);
+      const added = now.filter((p) => !was.includes(p) && p.endsWith(".md") && !/README\.md$/i.test(p));
+      changesets = (await Promise.all(added.map(async (p) => ({ path: p, text: await backend.readFile(c.sha, p) ?? "" })))).filter((x) => x.text);
+    }
+    const e = buildHistoryEntry({ config, commit: c, before, after, changesets });
+    if (e) entries.push(e);
+    opts.onProgress?.(++done, picked.length);
+  }
+  return entries;
 }
-function formatDocsJson(d) {
-  const order = ["summary", "category", "status", ...DOCS_KEYS.filter((k) => k !== "summary"), "draftedBy", "draftedSections", "needsReview"];
-  const out = {};
-  for (const k of order) if (d[k] !== void 0) out[k] = d[k];
-  for (const [k, v] of Object.entries(d)) if (!(k in out) && v !== void 0) out[k] = v;
-  return `${JSON.stringify(out, null, 2)}
-`;
+function parseChangelog(text) {
+  const out = [];
+  const parts = text.split(/^##\s+/m).slice(1);
+  for (const p of parts) {
+    const [head, ...rest] = p.split(/\r?\n/);
+    const version = /v?(\d+\.\d+\.\d+(?:-[\w.]+)?)/.exec(head ?? "")?.[1];
+    if (!version) continue;
+    const body = rest.join("\n");
+    const shas = [...new Set([...body.matchAll(/(?:^|[\s[`(])([0-9a-f]{7,40})(?=[\s`\]):]|$)/gm)].map((m) => m[1]))];
+    const prs = [...new Set([...body.matchAll(/(?:#|\/pull\/)(\d+)/g)].map((m) => Number(m[1])))];
+    const date = /(\d{4}-\d{2}-\d{2})/.exec(head ?? "")?.[1];
+    out.push({ version, ...date ? { date } : {}, shas, prs });
+  }
+  return out;
 }
-function patchNode(old, next) {
-  if (plainEqual(toPlain(old), next)) return old;
-  if (old.kind === "object" && next && typeof next === "object" && !Array.isArray(next)) {
-    const n = next;
-    const kept = old.entries.filter((e) => n[e.key] !== void 0).map((e) => ({ key: e.key, value: patchNode(e.value, n[e.key]) }));
-    const added = Object.keys(n).filter((k) => n[k] !== void 0 && !getEntry(old, k)).map((k) => ({ key: k, value: fromPlain(n[k], void 0, old.inline) }));
-    return { kind: "object", inline: old.inline, entries: [...kept, ...added] };
+function releasesFromTags(tags, pkg) {
+  const out = [];
+  for (const t of tags) {
+    const m = /^(?:(@?[^@\s]+)@)?v?(\d+\.\d+\.\d+(?:-[\w.]+)?)$/.exec(t.name);
+    if (!m) continue;
+    if (pkg && m[1] && m[1] !== pkg) continue;
+    out.push({ version: m[2], ...t.sha ? { sha: t.sha } : {}, ...t.date ? { date: t.date } : {} });
   }
-  if (old.kind === "array" && Array.isArray(next)) {
-    return { kind: "array", inline: old.inline, items: next.map((v, i) => old.items[i] ? patchNode(old.items[i], v) : fromPlain(v, old.items[0], old.inline)) };
+  return out;
+}
+function assignVersions(entries, releases) {
+  const dated = releases.filter((r) => r.date).sort((a, b) => Date.parse(a.date) - Date.parse(b.date));
+  return entries.map((e) => {
+    const cited = releases.find((r) => r.shas?.some((s) => e.sha.startsWith(s)) || e.pr && r.prs?.includes(e.pr.number));
+    const byTag = cited ? void 0 : dated.find((r) => r.sha === e.sha || Date.parse(r.date) >= Date.parse(e.date));
+    return { ...e, version: (cited ?? byTag)?.version ?? UNRELEASED };
+  });
+}
+const BUMP_RANK = { patch: 0, minor: 1, major: 2 };
+function versionTimeline(entries, releases = []) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const e of entries) {
+    const v = e.version ?? UNRELEASED;
+    let g = groups.get(v);
+    if (!g) {
+      const rel = releases.find((r) => r.version === v);
+      g = { version: v, pending: v === UNRELEASED, date: rel?.date ?? e.date, entries: [], prs: [], tokenChanges: 0, breaking: false, bump: "patch", authors: [] };
+      groups.set(v, g);
+    }
+    g.entries.push(e.id);
+    if (e.pr && !g.prs.includes(e.pr.number)) g.prs.push(e.pr.number);
+    g.tokenChanges += e.counts.total;
+    g.breaking ||= e.breaking;
+    if (BUMP_RANK[e.bump] > BUMP_RANK[g.bump]) g.bump = e.bump;
+    if (!g.authors.includes(e.author)) g.authors.push(e.author);
+    if (!releases.some((r) => r.version === v && r.date) && Date.parse(e.date) > Date.parse(g.date)) g.date = e.date;
   }
-  return fromPlain(next, old);
+  return [...groups.values()].sort((a, b) => a.pending ? -1 : b.pending ? 1 : Date.parse(b.date) - Date.parse(a.date));
 }
-function patchDocsJson(original, next) {
-  const plain = JSON.parse(formatDocsJson(next));
-  if (!original) return formatDocsJson(next);
-  try {
-    const doc = parseJson(original);
-    if (doc.root.kind !== "object") return formatDocsJson(next);
-    return serializeJson({ ...doc, root: patchNode(doc.root, plain) });
-  } catch {
-    return formatDocsJson(next);
+const matchesToken = (path, q) => path === q || path.startsWith(`${q.replace(/\.$/, "")}.`);
+function filterHistory(entries, f = {}) {
+  const q = f.query?.trim().toLowerCase();
+  return entries.filter(
+    (e) => (!f.token || e.changes.some((c) => matchesToken(c.path, f.token) || c.from && matchesToken(c.from, f.token))) && (!f.author || e.author.toLowerCase() === f.author.toLowerCase()) && (!f.tier || e.tier === f.tier) && (!f.version || (e.version ?? UNRELEASED) === f.version) && (f.breaking === void 0 || e.breaking === f.breaking) && (!f.since || Date.parse(e.date) >= Date.parse(f.since)) && (!f.until || Date.parse(e.date) <= Date.parse(f.until) + 86399999) && (!q || `${e.title} ${e.why} ${e.pr ? `#${e.pr.number}` : ""} ${e.sha}`.toLowerCase().includes(q))
+  );
+}
+function fileModes(config, file) {
+  for (const layer of config.tokens.layers) {
+    const keys = [];
+    const marked = layer.files.replace(/\{([^}]+)\}/g, (_, k) => {
+      keys.push(k);
+      return "
";
+    });
+    const source = globToRegExp(marked).source.replace(/\u0001/g, "([^/.]+)");
+    const m = new RegExp(source).exec(file);
+    if (m) return Object.fromEntries(keys.map((k, i) => [k, m[i + 1]]));
   }
+  return {};
 }
-function acceptDocsText(text) {
-  return patchDocsJson(text, acceptDocsDraft(JSON.parse(text)));
+function modeLabel(modes) {
+  const v = Object.values(modes).filter(Boolean);
+  if (!v.length) return "All modes";
+  const s = v.join(" ");
+  return s.charAt(0).toUpperCase() + s.slice(1);
 }
-const DOCS_CHANGE_BUMP = "patch";
-function cleanDraftText(text) {
-  return text.replace(/\s*\u2014\s*/g, ", ").replace(/,\s*,/g, ",").replace(/^,\s*/, "").replace(/[ \t]+/g, " ").trim();
+function tokenHistory(entries, path, config) {
+  const names2 = /* @__PURE__ */ new Set([path]);
+  const out = [];
+  const sorted = [...entries].sort((a, b) => Date.parse(b.date) - Date.parse(a.date));
+  for (const e of sorted) {
+    const hits = e.changes.filter((c) => names2.has(c.path));
+    for (const c of hits) {
+      const modes = config ? fileModes(config, c.file) : {};
+      out.push({
+        entryId: e.id,
+        sha: e.sha,
+        date: e.date,
+        author: e.author,
+        title: e.title,
+        why: e.why,
+        ...e.pr ? { pr: e.pr } : {},
+        ...e.version ? { version: e.version } : {},
+        ...e.demo ? { demo: true } : {},
+        kind: c.kind,
+        path: c.path,
+        ...c.from ? { from: c.from } : {},
+        file: c.file,
+        modes,
+        modeLabel: modeLabel(modes),
+        fields: c.fields,
+        ...c.before !== void 0 ? { before: c.before } : {},
+        ...c.after !== void 0 ? { after: c.after } : {},
+        ...c.beforeCss !== void 0 ? { beforeCss: c.beforeCss } : {},
+        ...c.afterCss !== void 0 ? { afterCss: c.afterCss } : {},
+        ...c.descriptionBefore !== void 0 ? { descriptionBefore: c.descriptionBefore } : {},
+        ...c.descriptionAfter !== void 0 ? { descriptionAfter: c.descriptionAfter } : {}
+      });
+    }
+    for (const c of hits) if (c.kind === "renamed" && c.from) names2.add(c.from);
+  }
+  return out;
 }
-const values = (s) => (s ?? "").split(", ").map((x) => x.trim()).filter(Boolean);
-const article = (word) => /^[aeiou]/i.test(word) ? "an" : "a";
-const andList = (xs) => xs.length <= 1 ? xs[0] ?? "" : `${xs.slice(0, -1).join(", ")} and ${xs[xs.length - 1]}`;
-const plural = (n, word, many = `${word}s`) => `${n} ${n === 1 ? word : many}`;
-const capital = (s) => s.charAt(0).toUpperCase() + s.slice(1);
-const lower = (s) => s.charAt(0).toLowerCase() + s.slice(1);
-function propShape(s) {
-  if (!s) return void 0;
-  const m = /^(.*?), default (.*)$/.exec(s);
-  return m ? { type: m[1], def: m[2] } : { type: s, def: "" };
+const same$1 = (a, b) => JSON.stringify(a) === JSON.stringify(b);
+const keyOf = (path, file) => `${path}@${file}`;
+const show$2 = (v) => typeof v === "string" ? v : JSON.stringify(v);
+function defIn(set, path, file) {
+  return set.defs.find((d) => d.path === path && d.file === file);
 }
-const VARIANT_FIRST = ["variant", "tone", "intent", "appearance", "kind", "type", "style"];
-function shortVariant(key) {
-  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() };
+function sharesCombo(set, a, b) {
+  return a === b || set.combos().some((c) => {
+    const files = set.layerFiles(c).files;
+    return files.includes(a) && files.includes(b);
   });
-  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());
-    return i < 0 ? VARIANT_FIRST.length : i;
-  };
-  return kept.map((p, i) => ({ ...p, i })).sort((a, b) => rank(a.k) - rank(b.k) || a.i - b.i).map((p) => p.v).join(" ");
-}
-const shortVariants = (list) => list ? andList(list.split("; ").map(shortVariant)) : "every variant";
-function parseStructureChange(c) {
-  const m = /^(New|Removed|Moved) layer "(.*)"(?: \((.*)\))?$/.exec(c.field);
-  if (!m) return void 0;
-  const op = m[1] === "New" ? "added" : m[1] === "Removed" ? "removed" : "moved";
-  const where2 = `in ${shortVariants(m[3])}`;
-  if (op === "moved") return { op, name: m[2], where: where2, at: c.after, from: c.before };
-  const shape = (op === "added" ? c.after : c.before) ?? "";
-  const sm = /^(\S+)(?: (.*?))?, ((?:after|before) ".*"|alone)$/.exec(shape);
-  return { op, name: m[2], where: where2, ...sm ? { type: sm[1], ...sm[2] ? { main: sm[2] } : {}, at: sm[3] } : {} };
 }
-function structurePhrase(r) {
-  const type = r.type ? `${r.type} ` : "";
-  const main = r.main ? ` (${r.main})` : "";
-  const at = r.at && r.at !== "alone" ? ` ${r.at}` : "";
-  if (r.op === "added") return `New ${type}layer "${r.name}"${main}${at} ${r.where}`;
-  if (r.op === "removed") return `Removed ${type}layer "${r.name}"${main}${at} ${r.where}`;
-  return `Moved layer "${r.name}" ${r.at ?? ""}${r.from ? ` (was ${r.from})` : ""} ${r.where}`.replace(/\s+/g, " ");
+function laterTouching(later, path, file, from) {
+  return later.filter((e) => e.changes.some((c) => c.file === file && (c.path === path || c.from === path || from !== void 0 && (c.path === from || c.from === from)))).sort((a, b) => Date.parse(a.date) - Date.parse(b.date)).map((e) => ({ id: e.id, title: e.title, date: e.date, author: e.author, ...e.pr ? { pr: e.pr.number } : {} }));
 }
-const bare = (at) => (at ?? "").replace(/"/g, "");
-function firstChange(component, kind, c, all) {
-  switch (kind) {
-    case "new-component": {
-      const axes = all.filter((x) => x.field.startsWith("Variant "));
-      const props = all.filter((x) => x.field.startsWith("Prop "));
-      const parts = [axes.length ? plural(axes.length, "variant axis", "variant axes") : "", props.length ? plural(props.length, "prop") : ""].filter(Boolean);
-      return {
-        title: `Add the ${component} component`,
-        summary: `${component} is not in code yet.${parts.length ? ` The Figma component has ${andList(parts)}.` : ""}`
-      };
-    }
-    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 ")}.` };
+function planRevert(input) {
+  const { current, entry } = input;
+  const later = (input.later ?? []).filter((e) => e.id !== entry.id && Date.parse(e.date) >= Date.parse(entry.date));
+  const res = input.resolutions ?? {};
+  const planned = [];
+  const conflicts = [];
+  const skipped = [];
+  const config = current.config;
+  const css = (path, file) => current.resolve(path, current.comboForFile(file)).css;
+  for (const c of entry.changes) {
+    const key = keyOf(c.path, c.file);
+    const label = modeLabel(fileModes(config, c.file));
+    const original = { ...c.before !== void 0 ? { before: c.before } : {}, ...c.after !== void 0 ? { after: c.after } : {}, ...c.beforeCss ? { beforeCss: c.beforeCss } : {}, ...c.afterCss ? { afterCss: c.afterCss } : {} };
+    const conflict = (reason, message, cur, editIfForced, summary) => {
+      const resolution = res[key] ?? "keep-current";
+      conflicts.push({ key, path: c.path, file: c.file, kind: c.kind, reason, message, original, ...cur ? { current: cur } : {}, later: laterTouching(later, c.path, c.file, c.from), resolution });
+      if (resolution === "use-before" && editIfForced) planned.push({ key, path: c.path, file: c.file, summary: summary ?? `${editIfForced.op} ${c.path}`, edit: editIfForced });
+    };
+    const now = defIn(current, c.path, c.file);
+    switch (c.kind) {
+      case "changed": {
+        if (!now) {
+          conflict("removed-later", `${c.path} was removed from ${c.file} after this change. Restoring it is a new token decision, not a revert.`, void 0, { op: "add", path: c.path, file: c.file, value: c.before, ...c.type ? { type: c.type } : {}, ...c.descriptionBefore ? { description: c.descriptionBefore } : {} }, `Add ${c.path} back with ${show$2(c.before)} (${label})`);
+          break;
+        }
+        const valueField = c.fields.includes("value");
+        const descField = c.fields.includes("description");
+        const cur = { value: now.value, css: css(c.path, c.file) };
+        const valueAt = (v) => same$1(now.value, v);
+        const descNow = now.description ?? "";
+        if (!valueField && !descField) {
+          skipped.push({ key, path: c.path, file: c.file, reason: "Only the type or extensions changed: edit those by hand." });
+          break;
+        }
+        if ((!valueField || valueAt(c.before)) && (!descField || descNow === (c.descriptionBefore ?? ""))) {
+          skipped.push({ key, path: c.path, file: c.file, reason: "Already back to the value from before this change." });
+          break;
+        }
+        const valueMoved = valueField && !valueAt(c.after) && !valueAt(c.before);
+        const descMoved = descField && descNow !== (c.descriptionAfter ?? "") && descNow !== (c.descriptionBefore ?? "");
+        const edit = {
+          op: "set",
+          path: c.path,
+          file: c.file,
+          ...valueField ? { value: c.before } : {},
+          ...descField ? { description: c.descriptionBefore ?? "" } : {}
+        };
+        const summary = valueField ? `Set ${c.path} back to ${show$2(c.before)} (${label})` : `Put the old description of ${c.path} back (${label})`;
+        if (valueMoved || descMoved) {
+          conflict("changed-later", `${c.path} changed again after this change: it is now ${cur.css || show$2(cur.value)}, not ${c.afterCss || show$2(c.after)}.`, cur, edit, summary);
+          break;
+        }
+        planned.push({ key, path: c.path, file: c.file, summary, edit });
+        break;
+      }
+      case "added": {
+        if (!now) {
+          skipped.push({ key, path: c.path, file: c.file, reason: "Already removed." });
+          break;
+        }
+        const users = current.referencedBy(c.path).filter((u) => u.path !== c.path && sharesCombo(current, u.file, c.file));
+        const edit = { op: "remove", path: c.path, file: c.file };
+        const summary = `Remove ${c.path} (${label})`;
+        if (!same$1(now.value, c.after)) {
+          conflict("changed-later", `${c.path} changed after it was added: it is now ${css(c.path, c.file) || show$2(now.value)}.`, { value: now.value, css: css(c.path, c.file) }, edit, summary);
+          break;
+        }
+        if (users.length) {
+          conflict("still-referenced", `${users.length} token(s) alias ${c.path} now (${users.slice(0, 4).map((u) => u.path).join(", ")}${users.length > 4 ? ", ..." : ""}). Removing it would break them.`, { value: now.value, css: css(c.path, c.file) }, edit, summary);
+          break;
+        }
+        planned.push({ key, path: c.path, file: c.file, summary, edit });
+        break;
       }
-      const axis = c.field.replace(/^Variant /, "");
-      const before = values(c.before);
-      const after = values(c.after);
-      const added = after.filter((x) => !before.includes(x));
-      const removed = before.filter((x) => !after.includes(x));
-      const word = axis.toLowerCase();
-      if (!before.length) return { title: `Add a ${axis} variant axis`, summary: `${component} gets a new variant axis, ${axis}, with ${after.length === 1 ? "the value" : "the values"} ${andList(after)}.` };
-      if (!after.length) return { title: `Remove the ${axis} variant axis`, summary: `${component} no longer has the ${axis} variant axis (${andList(before)}).` };
-      if (added.length === 1 && !removed.length) return { title: `Add ${article(added[0])} ${added[0]} ${word}`, summary: `${component} gets a new ${axis} value, ${added[0]}.` };
-      if (added.length && !removed.length) return { title: `Add ${andList(added)} to ${axis}`, summary: `${component} gets ${plural(added.length, `new ${axis} value`)}: ${andList(added)}.` };
-      if (removed.length === 1 && !added.length) return { title: `Remove the ${removed[0]} ${word}`, summary: `${component} no longer has the ${axis} value ${removed[0]}.` };
-      if (removed.length && !added.length) return { title: `Remove ${andList(removed)} from ${axis}`, summary: `${component} no longer has the ${axis} values ${andList(removed)}.` };
-      return { title: `Change the ${axis} values`, summary: `${axis} on ${component} goes from ${andList(before)} to ${andList(after)}.` };
-    }
-    case "prop-change": {
-      if (!c) return { title: `Change a ${component} prop`, summary: `A prop of ${component} changed in Figma.` };
-      const name = c.field.replace(/^Prop /, "");
-      const b = propShape(c.before);
-      const a = propShape(c.after);
-      if (!b && a) return { title: `Add the ${name} prop`, summary: `${component} gets a new ${a.type} prop, ${name}${a.def ? `, default ${a.def}` : ""}.` };
-      if (b && !a) return { title: `Remove the ${name} prop`, summary: `${component} no longer has the ${name} prop.` };
-      if (b && a && b.type === a.type && b.def !== a.def) return { title: `Change the ${name} default to ${a.def || "empty"}`, summary: `The default of ${name} on ${component} goes from ${b.def || "empty"} to ${a.def || "empty"}.` };
-      return { title: `Change the ${name} prop`, summary: `${name} on ${component} goes from ${c.before ?? "none"} to ${c.after ?? "none"}.` };
-    }
-    case "token-binding": {
-      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 ${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"}.` };
-      return {
-        title: `Use ${after} for the ${part}`,
-        summary: `The ${part} of ${component}${where2} ${before ? `moves from ${before} to ${after}` : `now uses ${after}`}.`
-      };
-    }
-    case "structure": {
-      const r = c ? parseStructureChange(c) : void 0;
-      if (!r) return { title: "Change the layers to match Figma", summary: `The layers of ${component} changed in Figma.` };
-      if (r.op === "added") {
-        const at = r.at && r.at !== "alone" ? ` ${bare(r.at)}` : "";
-        return { title: `Add a layer${at}`, summary: `${component} gets ${article(r.type ?? "layer")} ${r.type ?? "layer"}${r.type ? " layer" : ""}, ${r.name}${r.main ? ` (${r.main})` : ""}${at} ${r.where}.` };
+      case "removed": {
+        const edit = { op: "add", path: c.path, file: c.file, value: c.before, ...c.type ? { type: c.type } : {}, ...c.descriptionBefore ? { description: c.descriptionBefore } : {} };
+        const summary = `Add ${c.path} back with ${show$2(c.before)} (${label})`;
+        if (now) {
+          if (same$1(now.value, c.before)) skipped.push({ key, path: c.path, file: c.file, reason: "Already back." });
+          else conflict("recreated-later", `${c.path} was added again later with another value (${css(c.path, c.file) || show$2(now.value)}).`, { value: now.value, css: css(c.path, c.file) });
+          break;
+        }
+        planned.push({ key, path: c.path, file: c.file, summary, edit });
+        break;
+      }
+      case "renamed": {
+        const from = c.from;
+        const back = defIn(current, from, c.file);
+        if (back && !now) {
+          skipped.push({ key, path: c.path, file: c.file, reason: `Already named ${from}.` });
+          break;
+        }
+        if (!now) {
+          conflict("renamed-later", `${c.path} no longer exists in ${c.file}: it was renamed or removed again later.`);
+          break;
+        }
+        if (back) {
+          conflict("recreated-later", `${from} exists again in ${c.file}, so ${c.path} cannot take its old name back.`, { value: back.value, css: css(from, c.file) });
+          break;
+        }
+        if (planned.some((p) => p.edit.op === "rename" && p.path === c.path)) {
+          skipped.push({ key, path: c.path, file: c.file, reason: "Covered by the rename above." });
+          break;
+        }
+        planned.push({ key, path: c.path, file: c.file, summary: `Rename ${c.path} back to ${from} and repoint its aliases`, edit: { op: "rename", path: c.path, newPath: from } });
+        break;
       }
-      if (r.op === "removed") return { title: `Remove the ${r.name} layer`, summary: `${component} no longer has the ${r.name} layer ${r.where}.` };
-      return { title: `Move the ${r.name} layer`, summary: `The ${r.name} layer of ${component} moves ${bare(r.at) || "elsewhere"}${r.from ? ` (it was ${bare(r.from)})` : ""} ${r.where}.` };
     }
-    case "visual":
-      return {
-        title: "Update the look to match Figma",
-        summary: `${component} looks different in Figma${c?.field.startsWith("Look of ") && c.field !== "Look of every variant" ? ` in ${c.field.slice(8)}` : ""}, and no variable edit explains it.`
-      };
-    default:
-      return { title: "", summary: "" };
   }
+  const prLink = entry.pr ? entry.pr.url ? `[#${entry.pr.number}](${entry.pr.url})` : `#${entry.pr.number}` : `commit ${entry.sha.slice(0, 7)}`;
+  const title = `Revert: ${entry.title}`;
+  const lines = [
+    `Reverts ${prLink} ("${entry.title}"), merged ${entry.date.slice(0, 10)} by ${entry.author}.`,
+    "",
+    `Original reason: ${entry.why}`,
+    "",
+    "Bridge computed the inverse token edits against the current base branch, not a blind git revert: tokens that changed again since are listed as conflicts and kept unless a reviewer chose to restore them."
+  ];
+  if (conflicts.length) {
+    lines.push("", "### Conflicts", "", "| Token | File | Why | Decision |", "| --- | --- | --- | --- |");
+    for (const k of conflicts) lines.push(`| \`${k.path}\` | ${k.file} | ${k.message.replace(/\|/g, "\\|")}${k.later.length ? ` Later: ${k.later.map((l) => l.pr ? `#${l.pr}` : l.id).join(", ")}.` : ""} | ${k.resolution === "use-before" ? "restore the old value" : "keep current"} |`);
+  }
+  if (skipped.length) lines.push("", `${skipped.length} change(s) were already undone on the base branch and are left alone.`);
+  return finishPlan({ ...input, kind: "revert", title, prTitle: title, summary: lines.join("\n"), planned, conflicts, skipped, source: entry });
 }
-function draftRequestText(component, kind, changes) {
-  const name = component.trim() || "the component";
-  if (!changes.length && kind !== "new-component") return { title: "", summary: "" };
-  const d = firstChange(name, kind, changes[0], changes);
-  const rest = kind === "new-component" ? 0 : changes.length - 1;
-  const summary = rest > 0 ? `${d.summary} ${capital(plural(rest, "other change"))} ${rest === 1 ? "is" : "are"} listed below.` : d.summary;
-  return { title: cleanDraftText(d.title), summary: cleanDraftText(summary) };
-}
-const DRAFT_LINE_MAX = 120;
-function clipText(text, max) {
-  const t = text.replace(/\s+/g, " ").trim().replace(/\.$/, "");
-  if (t.length <= max) return t;
-  const cut = t.slice(0, max + 1);
-  const at = cut.lastIndexOf(" ");
-  return (at > max * 0.5 ? cut.slice(0, at) : t.slice(0, max)).replace(/[\s,;:(]+$/, "");
-}
-function sanitizeDraftLine(raw) {
-  if (typeof raw !== "string") return "";
-  return capital(clipText(cleanDraftText(raw.replace(/[\r\n]+/g, " ")), DRAFT_LINE_MAX));
+function planRestore(input) {
+  const { current, path } = input;
+  const files = [...new Set(current.defs.filter((d) => d.path === path).map((d) => d.file))];
+  if (!files.length) throw new Error(`Token "${path}" does not exist on the base branch. Restoring a removed token is a revert of the change that removed it.`);
+  const file = input.file ?? (files.length === 1 ? files[0] : void 0);
+  if (!file) throw new Error(`"${path}" is defined in ${files.join(", ")}. Pass the file (the mode) to restore.`);
+  if (!files.includes(file)) throw new Error(`"${path}" is not defined in ${file}. It is defined in: ${files.join(", ")}.`);
+  const label = modeLabel(fileModes(current.config, file));
+  const from = input.label ? ` from ${input.label}` : "";
+  const planned = [{ key: keyOf(path, file), path, file, summary: `Set ${path} to ${show$2(input.value)} (${label})`, edit: { op: "set", path, file, value: input.value } }];
+  const title = `Restore ${path} (${label})${from}`;
+  const item = input.item;
+  const summary = [
+    `Restores \`${path}\` in ${label} to ${show$2(input.value)}${from}.`,
+    ...item ? ["", `That value came from ${item.pr ? item.pr.url ? `[#${item.pr.number}](${item.pr.url})` : `#${item.pr.number}` : `commit ${item.sha.slice(0, 7)}`} ("${item.title}"), ${item.date.slice(0, 10)}, by ${item.author}.`] : []
+  ].join("\n");
+  return finishPlan({ ...input, kind: "restore", title, prTitle: title, summary, planned, conflicts: [], skipped: [] });
 }
-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);
-    const after2 = values(c.after);
-    if (!before2.length) return `New ${axis} variant axis: ${after2.join(", ")}`;
-    if (!after2.length) return `${axis} variant axis removed (${before2.join(", ")})`;
-    const added = after2.filter((x) => !before2.includes(x));
-    const removed = before2.filter((x) => !after2.includes(x));
-    const parts = [added.length ? `${andList(added)} added to ${axis}` : "", removed.length ? `${andList(removed)} removed from ${axis}` : ""].filter(Boolean);
-    return parts.join("; ") || `${axis} values reordered: ${after2.join(", ")}`;
-  }
-  if (m = /^Prop (.+)$/.exec(c.field)) {
-    const name = m[1];
-    const b = propShape(c.before);
-    const a = propShape(c.after);
-    if (!b && a) return `New ${a.type} prop ${name}${a.def ? `, default ${a.def}` : ""}`;
-    if (b && !a) return `${name} prop removed`;
-    if (b && a && b.type === a.type) return `${name} default goes from ${b.def || "empty"} to ${a.def || "empty"}`;
-    return `${name} prop goes from ${c.before ?? "none"} to ${c.after ?? "none"}`;
+const issueKey = (i) => `${i.code}|${i.path ?? ""}|${i.file ?? ""}|${i.message}`;
+function finishPlan(p) {
+  const { current } = p;
+  const config = current.config;
+  const edits = p.planned.map((x) => x.edit);
+  const notes = [];
+  const empty = classifyLayered([], [], config);
+  const base = {
+    kind: p.kind,
+    title: p.title,
+    prTitle: p.prTitle,
+    summary: p.summary,
+    ...p.source ? { source: { id: p.source.id, sha: p.source.sha, title: p.source.title, ...p.source.pr ? { pr: p.source.pr } : {}, date: p.source.date, author: p.source.author } } : {},
+    planned: p.planned,
+    edits,
+    conflicts: p.conflicts,
+    skipped: p.skipped,
+    branch: `${config.governance.branchPrefix}${slugify(p.title, 48)}`
+  };
+  const nothing = (why) => ({ ...base, status: "nothing-to-do", why, changes: [], contrast: [], newFailures: [], newErrors: [], tier: empty, files: [], commitMessage: "", prBody: "", notes });
+  if (!edits.length) return nothing(p.conflicts.length ? 'Every change conflicts with a later one. Choose "restore the old value" on a conflict to include it.' : "Nothing left to undo: the base branch already has the old values.");
+  let result;
+  try {
+    result = applyTokenEdits(current, edits);
+  } catch (e) {
+    return { ...nothing(e.message), status: "blocked" };
   }
-  if (m = /^Swapped instance(?: \((.*)\))?$/.exec(c.field)) return `Shows ${c.after ?? "another instance"} instead of ${c.before ?? "the coded one"} ${m[1] ? `in ${m[1]}` : "in every variant"}`;
-  if (m = /^Look of (.+)$/.exec(c.field)) return `Looks different in ${m[1]}; no variable explains it`;
-  const layer = parseStructureChange(c);
-  if (layer) return structurePhrase(layer);
-  m = /^(.*?)(?: \((.*)\))?$/.exec(c.field);
-  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}`;
-  if (!before) return `${m[1]} now uses ${after}${where2}`;
-  return `${m[1]} uses ${after} instead of ${before}${where2}`;
+  notes.push(...result.notes);
+  const after = new LayeredTokenSet(config, result.files);
+  const changes = diffLayered(current, after);
+  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 pairs2 = p.pairs ?? [];
+  const modes = config.contrast?.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);
+  const prBody = composeProposalBody({ summary: p.summary, changes, contrast, impact, tier, validationErrors: newErrors.length, tool: p.tool ?? "Bridge", ...p.author ? { author: p.author } : {} });
+  const changeset = config.changesets ? { path: `${config.changesets.dir.replace(/\/$/, "")}/bridge-${slugify(p.title, 48)}.md`, content: formatChangeset(config.changesets.package, tier.bump, p.title.replace(/\.?$/, ".")) } : void 0;
+  const files = [...result.touched.map((f) => ({ path: current.repoPath(f), content: result.files.get(f) })), ...changeset ? [changeset] : []];
+  const commitMessage = `${p.kind === "revert" ? "revert(tokens)" : "fix(tokens)"}: ${p.title.replace(/^Revert: /, "")}
+
+${p.source?.pr ? `Reverts #${p.source.pr.number}. ` : ""}Tier ${tier.tier}. Planned with ${p.tool ?? "Bridge"}.`;
+  const blocked = newErrors.length || newFailures.length;
+  return {
+    ...base,
+    status: blocked ? "blocked" : "ready",
+    ...blocked ? { why: [newErrors.length ? `${newErrors.length} new validation error(s)` : "", newFailures.length ? `${newFailures.length} contrast pair(s) would fail` : ""].filter(Boolean).join(" and ") } : {},
+    changes,
+    contrast,
+    newFailures,
+    newErrors,
+    tier,
+    files,
+    ...changeset ? { changeset } : {},
+    commitMessage,
+    prBody,
+    notes
+  };
+}
+function planToJson(plan) {
+  return {
+    bridge: "change-plan",
+    kind: plan.kind,
+    status: plan.status,
+    title: plan.prTitle,
+    branch: plan.branch,
+    tier: plan.tier.tier,
+    bump: plan.tier.bump,
+    edits: plan.edits,
+    conflicts: plan.conflicts.map((c) => ({ key: c.key, reason: c.reason, message: c.message, resolution: c.resolution })),
+    files: plan.files,
+    commitMessage: plan.commitMessage,
+    prBody: plan.prBody
+  };
 }
-function draftChangeLine(kind, changes) {
-  if (kind === "new-component") {
-    const axes = changes.filter((x) => x.field.startsWith("Variant ")).length;
-    const props = changes.filter((x) => x.field.startsWith("Prop ")).length;
-    const parts = [axes ? plural(axes, "variant axis", "variant axes") : "", props ? plural(props, "prop") : ""].filter(Boolean);
-    return `New component${parts.length ? ` with ${andList(parts)}` : ""}, not in code yet`;
-  }
-  if (!changes.length) return "";
-  const first = changePhrase(changes[0]);
-  const rest = changes.length - 1;
-  const tail = rest ? ` (and ${rest} more)` : "";
-  return capital(clipText(cleanDraftText(first), DRAFT_LINE_MAX - tail.length)) + tail;
+function packageDirCandidates(config) {
+  const parts = config.tokens.root.replace(/\/$/, "").split("/").filter((p) => p && p !== ".");
+  const out = [];
+  for (let i = parts.length; i >= 0; i--) out.push(parts.slice(0, i).join("/"));
+  return out;
 }
-const tokenOf = (e) => e.figma ?? e.head ?? e.base;
-const pathOf = (e) => tokenOf(e)?.path ?? e.path;
-function pushChangeRows(entries) {
-  return entries.map((e) => {
-    const before = e.head ?? e.base;
-    const after = e.figma;
-    const show2 = (t) => {
-      if (!t) return void 0;
-      const modes = Object.keys(t.values);
-      if (modes.length <= 1) return formatValue(t.type, t.values[modes[0] ?? ""]);
-      return modes.map((m) => `${modeDisplayName(m)} ${formatValue(t.type, t.values[m])}`).join("; ");
-    };
-    const renamed = e.local?.kind === "renamed" && before && after && before.path !== after.path;
-    return { field: renamed ? `${before.path} -> ${after.path}` : pathOf(e), before: show2(before), after: show2(after) };
-  });
+function mergeReleases(changelog, tags) {
+  const byVersion = /* @__PURE__ */ new Map();
+  for (const r of [...changelog, ...tags]) {
+    const prev = byVersion.get(r.version);
+    byVersion.set(r.version, prev ? { ...r, ...prev, ...prev.date ? {} : r.date ? { date: r.date } : {}, ...prev.sha ? {} : r.sha ? { sha: r.sha } : {} } : r);
+  }
+  return [...byVersion.values()];
 }
-function names(paths) {
-  if (paths.length <= 3) return andList(paths);
-  return `${paths.length} tokens, including ${andList(paths.slice(0, 2))}`;
+function buildReport(args) {
+  const entries = assignVersions(args.entries, args.releases).sort((a, b) => Date.parse(b.date) - Date.parse(a.date));
+  return { ...args, entries, timeline: versionTimeline(entries, args.releases) };
 }
-function valueModes(e) {
-  return (e.local?.fields ?? []).filter((f) => f.field === "value" && f.mode && f.mode !== "value").map((f) => modeDisplayName(f.mode));
+const DOCS_KEYS = ["summary", "preview", "whenToUse", "whenNotToUse", "dos", "donts", "accessibility", "contentGuidelines", "anatomy"];
+const PROSE_KEYS = ["summary", "whenToUse", "whenNotToUse", "dos", "donts", "accessibility", "contentGuidelines"];
+const ACRONYMS = /* @__PURE__ */ new Set(["sm", "md", "lg", "xl", "xs"]);
+function anatomyLabel(className) {
+  if (ACRONYMS.has(className)) return `Size ${className}`;
+  const words = className.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/[-_]+/g, " ").trim().toLowerCase();
+  if (!words) return className;
+  if (words === "root") return "Container";
+  return words.charAt(0).toUpperCase() + words.slice(1);
 }
-function draftPushDescription(entries, components = []) {
-  const by = { changed: [], added: [], renamed: [], removed: [] };
-  for (const e of entries) by[e.local?.kind ?? "changed"].push(e);
-  const clauses = [];
-  if (by.changed.length) {
-    const only = by.changed.length === 1 ? by.changed[0] : void 0;
-    const fields = new Set((only?.local?.fields ?? []).map((f) => f.field));
-    const modes = only ? valueModes(only) : [];
-    if (only && fields.size === 1 && fields.has("description")) clauses.push(`updates the description of ${pathOf(only)}`);
-    else if (only && modes.length) clauses.push(`changes ${pathOf(only)} in ${andList(modes)}`);
-    else clauses.push(`changes ${names(by.changed.map(pathOf))}`);
-  }
-  if (by.added.length) clauses.push(`adds ${names(by.added.map(pathOf))}`);
-  if (by.renamed.length) {
-    const r = by.renamed[0];
-    const from = (r.head ?? r.base)?.path;
-    clauses.push(by.renamed.length === 1 && from && from !== pathOf(r) ? `renames ${from} to ${pathOf(r)}` : `renames ${names(by.renamed.map(pathOf))}`);
+function cssModuleClasses(css) {
+  const clean = css.replace(/\/\*[\s\S]*?\*\//g, "").replace(/@keyframes\s+[\w-]+\s*\{(?:[^{}]*\{[^{}]*\})*[^{}]*\}/g, "");
+  const out = [];
+  for (const m of clean.matchAll(/\.(-?[_a-zA-Z][\w-]*)/g)) {
+    const before = clean[m.index - 1] ?? " ";
+    if (/[\w)]/.test(before)) continue;
+    if (!out.includes(m[1])) out.push(m[1]);
   }
-  if (by.removed.length) clauses.push(`removes ${names(by.removed.map(pathOf))}`);
-  const sentences = [];
-  if (clauses.length) sentences.push(`${capital(andList(clauses))}.`);
-  const fresh = components.filter((c) => c.kind === "new-component").map((c) => c.component);
-  const changed = [...new Set(components.filter((c) => c.kind !== "new-component").map((c) => c.component))];
-  const comp = [];
-  if (changed.length) comp.push(`${changed.length === 1 ? "a change" : "changes"} to ${andList(changed)}`);
-  if (fresh.length) comp.push(`the new ${andList(fresh)} component${fresh.length === 1 ? "" : "s"}`);
-  if (comp.length) sentences.push(`Requests ${andList(comp)}.`);
-  return cleanDraftText(sentences.join(" "));
+  return out;
 }
-const EXPLORATION_LABEL = "exploration";
-const EXPLORATION_PREFIX = "explore/";
-const EXPLORATION_NOTES_DIR = ".bridge/explorations";
-const EXPLORATION_TIER_LABEL = "Exploration (not mergeable)";
-const EXPLORATION_CHECK = "Exploration not merged as is";
-const EXPLORATION_READY_LABEL = "ready-for-devs";
-const EXPLORATION_ARCHIVED_LABEL = "archived";
-const EXPLORATION_USE_CASES = [
-  { 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",
-  ready: "Waiting for code",
-  building: "Being built",
-  shipped: "Shipped",
-  promoted: "Promoted to review",
-  closed: "Closed"
-};
-const MARK$2 = "bridge-exploration";
-const SLUG_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
-const EXPLORATION_SLUG_MAX = 60;
-function explorationSlug(name) {
-  const s = name.trim().replace(/^explore\//i, "");
-  if (!/[a-z0-9]/i.test(s)) return "";
-  return slugify(s, EXPLORATION_SLUG_MAX);
+const cell$2 = (s) => s.replace(/\|/g, "\\|").replace(/\n/g, " ");
+function propsTable(name, props, inherits) {
+  if (!props.length) return inherits ? `${name} has no props of its own. It accepts every native <${inherits}> attribute.` : "";
+  const rows = props.map((p) => `| \`${p.name}\`${p.required ? " (required)" : ""} | \`${cell$2(p.type)}\` | ${p.defaultValue ? `\`${cell$2(p.defaultValue)}\`` : ""} | ${cell$2(p.description ?? "")} |`);
+  const tail = inherits ? `
+
+Also accepts every native <${inherits}> attribute.` : "";
+  return ["| Prop | Type | Default | Description |", "| --- | --- | --- | --- |", ...rows].join("\n") + tail;
 }
-function explorationBranch(nameOrBranch) {
-  return `${EXPLORATION_PREFIX}${explorationSlug(nameOrBranch)}`;
+const isEmpty = (v) => v === void 0 || v === null || typeof v === "string" && !v.trim() || Array.isArray(v) && v.length === 0;
+function missingProse(d) {
+  return PROSE_KEYS.filter((k) => isEmpty(d?.[k]));
 }
-function isExplorationBranch(ref) {
-  const r = (ref ?? "").replace(/^refs\/heads\//, "");
-  return r.startsWith(EXPLORATION_PREFIX) && SLUG_RE.test(r.slice(EXPLORATION_PREFIX.length));
+function prefillDocs(input) {
+  const existing = input.existing ?? null;
+  const anatomy = {};
+  for (const c of input.cssClasses) anatomy[c] = existing?.anatomy?.[c] ?? anatomyLabel(c);
+  const contrastNotes = (input.contrast ?? []).slice().sort((a, b) => a.ratio - b.ratio).map((p) => `${p.foreground} on ${p.background}: ${p.ratio.toFixed(2)}:1 at worst over every brand and theme, needs ${p.min}:1 (${p.ratio >= p.min ? "passes" : "fails"}).`);
+  const missing = missingProse(existing);
+  const changelogLine = input.change ? `${input.name}: ${input.change.replace(/\.$/, "")}.` : missing.length === PROSE_KEYS.length ? `${input.name}: usage guidance added.` : `${input.name}: usage guidance updated.`;
+  const draft = {
+    summary: existing?.summary ?? input.description ?? "",
+    ...existing?.category ? { category: existing.category } : {},
+    ...existing?.status ? { status: existing.status } : {},
+    ...existing?.preview ? { preview: existing.preview } : {},
+    whenToUse: existing?.whenToUse ?? [],
+    whenNotToUse: existing?.whenNotToUse ?? [],
+    dos: existing?.dos ?? [],
+    donts: existing?.donts ?? [],
+    accessibility: existing?.accessibility ?? [],
+    contentGuidelines: existing?.contentGuidelines ?? [],
+    anatomy,
+    ...existing?.draftedBy ? { draftedBy: existing.draftedBy } : {},
+    ...existing?.draftedSections?.length ? { draftedSections: existing.draftedSections } : {},
+    ...existing?.needsReview !== void 0 ? { needsReview: existing.needsReview } : {}
+  };
+  return {
+    component: input.name,
+    propsTable: propsTable(input.name, input.props, input.inherits),
+    tokens: [...new Set(input.tokens)].sort(),
+    inheritedTokens: input.inheritedTokens ?? {},
+    anatomy,
+    contrastNotes,
+    changelogLine,
+    missing,
+    draft
+  };
 }
-function explorationSlugFromBranch(ref) {
-  return isExplorationBranch(ref) ? ref.replace(/^refs\/heads\//, "").slice(EXPLORATION_PREFIX.length) : null;
+const SECTION_SHAPE = {
+  summary: '"summary": "one or two sentences"',
+  whenToUse: '"whenToUse": ["..."]',
+  whenNotToUse: '"whenNotToUse": ["..."]',
+  dos: '"dos": [{ "title": "...", "text": "..." }]',
+  donts: '"donts": [{ "title": "...", "text": "..." }]',
+  accessibility: '"accessibility": ["..."]',
+  contentGuidelines: '"contentGuidelines": ["..."]'
+};
+const docsSectionShapes = (keys) => `{ ${keys.map((k) => SECTION_SHAPE[k]).join(", ")} }`;
+function docsPrompt(prefill, conventions = {}, options = {}) {
+  const facts = [
+    `Component: ${prefill.component}`,
+    prefill.propsTable ? `Props (parsed from TypeScript):
+${prefill.propsTable}` : "Props: none of its own.",
+    `Tokens its stylesheet reads: ${prefill.tokens.join(", ") || "none"}`,
+    ...Object.entries(prefill.inheritedTokens).map(([from, list]) => `Tokens it reads through ${from}'s stylesheet: ${list.length}`),
+    `Anatomy (CSS module classes): ${Object.entries(prefill.anatomy).map(([k, v]) => `${k} = ${v}`).join("; ") || "none"}`,
+    prefill.contrastNotes.length ? `Contrast checks:
+- ${prefill.contrastNotes.join("\n- ")}` : "",
+    `Changelog line: ${prefill.changelogLine}`
+  ].filter(Boolean);
+  const block = (title, text) => text?.trim() ? `<${title}>
+${text.trim()}
+</${title}>` : "";
+  const keys = options.keys;
+  const check = keys ? (options.check ?? []).filter((k) => keys.includes(k)) : [];
+  const write = keys ? keys.filter((k) => !check.includes(k)) : [];
+  const task = keys ? [
+    ...write.length ? [`${options.rewrite ? "Rewrite" : "Write"} these sections of ${prefill.component}.docs.json for the Bridge design system: ${write.join(", ")}.`] : [],
+    ...check.length ? [
+      `Check these written sections of ${prefill.component}.docs.json against the current code: ${check.join(", ")}. The code changed after they were written.`,
+      "Return a checked section ONLY when something in it is no longer true for the code (a wrong or removed prop, a removed state or variant, changed behavior). Then return the whole section with only the untrue parts fixed, keeping the writer's wording everywhere else.",
+      "Leave a checked section out of the answer when it is still accurate: a missing key means unchanged. Never return a checked section just to improve its style."
+    ] : [],
+    ...options.rewrite ? ["Rewrite each one from the facts and the source: keep what is true in the current text, drop what the code does not support."] : []
+  ] : [`Write the missing prose of ${prefill.component}.docs.json for the Bridge design system.`];
+  const shape = keys ? [
+    `- ${check.length ? "Return" : "Write"} only these keys: ${keys.join(", ")}${check.length ? ` (the checked ones, ${check.join(", ")}, only when they need a fix)` : ""}. Never return anatomy, preview or any other key: code decides them.`,
+    `- Answer with one JSON object holding only those keys, nothing else: ${docsSectionShapes(keys)}.`
+  ] : [
+    `- Fill only these keys: ${prefill.missing.join(", ") || "none (everything is written: improve nothing, return the draft as is)"}. Keep every other key exactly as given.`,
+    "- Answer with the full docs.json as one JSON object, nothing else."
+  ];
+  return [
+    ...task,
+    "",
+    "Rules:",
+    "- Ground every sentence in the facts and the source below. Never invent props, variants, keyboard behavior or tokens that are not there.",
+    "- Bridge voice: sentence case, plain words, verbs first, no em dashes, no marketing words.",
+    '- Keep the keys and shapes of the example docs.json. dos and donts are { "title", "text" } objects; add an "example" only with components and props that exist.',
+    ...shape,
+    "",
+    "Facts computed from the code:",
+    facts.join("\n\n"),
+    "",
+    `Current draft:
+${JSON.stringify(prefill.draft, null, 2)}`,
+    "",
+    block("source", conventions.source),
+    block("styles", conventions.styles),
+    block("agents-md", conventions.agents),
+    block("voice", conventions.voice),
+    block("example-docs-json", conventions.example)
+  ].filter((x, i, all) => x !== "" || all[i - 1] !== "").join("\n");
 }
-const REPO_NAME = /^[\w.-]+\/[\w.-]+$/;
-const KEY_NAME = /^[a-z0-9][a-z0-9-]*$/i;
-function parseExplorationRef(input) {
-  if (typeof input === "number") return { ref: input };
-  const s = input.trim();
-  const link = /^https?:\/\/github\.com\/([\w.-]+)\/([\w.-]+)\/pull\/(\d+)/i.exec(s);
-  if (link) return { repo: `${link[1]}/${link[2]}`, ref: Number(link[3]) };
-  if (/^#?\d+$/.test(s)) return { ref: Number(s.replace(/^#/, "")) };
-  const hash = /^(.+)#(\d+)$/.exec(s);
-  if (hash) {
-    const where2 = hash[1].trim();
-    if (REPO_NAME.test(where2)) return { repo: where2, ref: Number(hash[2]) };
-    if (KEY_NAME.test(where2)) return { product: where2.toLowerCase(), ref: Number(hash[2]) };
+function markClaudeDraft(d, sections) {
+  if (!sections) {
+    const { draftedSections: _all, ...rest } = d;
+    return { ...rest, draftedBy: "claude", needsReview: true };
   }
-  const named = /^([a-z0-9][a-z0-9-]*):(.+)$/i.exec(s);
-  if (named) return { product: named[1].toLowerCase(), ref: /^#?\d+$/.test(named[2].trim()) ? Number(named[2].trim().replace(/^#/, "")) : named[2].trim() };
-  return { ref: s };
+  const waiting = d.needsReview === true ? d.draftedSections ?? (d.draftedBy ? [...PROSE_KEYS] : []) : [];
+  const union = PROSE_KEYS.filter((k) => waiting.includes(k) || sections.includes(k));
+  return { ...d, draftedBy: "claude", needsReview: true, draftedSections: union };
 }
-const explorationRefLabel = (x) => x.repo && x.product ? `${x.product}#${x.number}` : `#${x.number}`;
-const explorationNotePath = (slug) => `${EXPLORATION_NOTES_DIR}/${slug}.md`;
-function explorationProblems(e) {
-  const out = [];
-  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 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.");
-  return out;
+function sectionsNeedingReview(d) {
+  if (!d || d.needsReview !== true) return [];
+  return d.draftedSections ? PROSE_KEYS.filter((k) => d.draftedSections.includes(k)) : [...PROSE_KEYS];
 }
-const useCaseLabel = (u) => EXPLORATION_USE_CASES.find((x) => x.value === u)?.label;
-function explorationNote(e) {
-  const slug = e.slug || explorationSlug(e.name);
-  const uc = useCaseLabel(e.useCase);
-  return [
-    `# Exploration: ${e.name.trim()}`,
-    "",
-    ...e.purpose?.trim() ? [e.purpose.trim(), ""] : [],
-    `- Branch: \`${EXPLORATION_PREFIX}${slug}\``,
-    ...uc ? [`- Use case: ${uc}`] : [],
-    ...e.startedAt ? [`- Started: ${e.startedAt.slice(0, 10)}${e.author ? ` by @${e.author}` : ""}`] : [],
-    "",
-    'This file marks the branch as an exploration. It is never merged as is: "Done exploring" removes it before developers take the branch.',
-    ""
-  ].join("\n");
+const needsDocsReview = (d) => Boolean(d && d.needsReview === true);
+function acceptDocsDraft(d) {
+  const { draftedSections: _done, ...rest } = d;
+  return { ...rest, needsReview: false };
 }
-function explorationPrTitle(e) {
-  const n = e.name.trim().replace(/\.$/, "").replace(/^exploration\s*:\s*/i, "").replace(/\s*:\s+/g, ", ").trim();
-  return `Exploration: ${n}`;
+function formatDocsJson(d) {
+  const order = ["summary", "category", "status", ...DOCS_KEYS.filter((k) => k !== "summary"), "draftedBy", "draftedSections", "needsReview"];
+  const out = {};
+  for (const k of order) if (d[k] !== void 0) out[k] = d[k];
+  for (const [k, v] of Object.entries(d)) if (!(k in out) && v !== void 0) out[k] = v;
+  return `${JSON.stringify(out, null, 2)}
+`;
 }
-function explorationPrBody(e, ctx) {
-  const slug = e.slug || explorationSlug(e.name);
-  const branch = `${EXPLORATION_PREFIX}${slug}`;
-  const uc = useCaseLabel(e.useCase);
-  const experimental = (e.experimental ?? []).map((x) => x.trim()).filter(Boolean);
-  const lines = [
-    `## Exploration: ${e.name.trim()}`,
-    "",
-    `> Not mergeable as is. This draft pull request is a living prototype on \`${branch}\`: say "Done exploring" when the idea is ready for developers. Keep it open, so its preview link keeps working.`,
-    "",
-    ...e.purpose?.trim() ? [`**Purpose.** ${e.purpose.trim()}`, ""] : [],
-    ...uc ? [`**Use case.** ${uc}`, ""] : [],
-    "### What is experimental",
-    "",
-    ...experimental.length ? experimental.map((x) => `- ${x}`) : [ctx.inProduct ? `- The ${ctx.inProduct.name} screens and flows built on this branch with the library. Nothing here reaches main or production.` : "- Token edits and component work committed to this branch. Nothing here reaches main or production."],
-    ...ctx.requests?.length ? ["", "Requests implemented here:", ...ctx.requests.map((r) => `- #${r.number} ${r.title}`)] : [],
-    ""
-  ];
-  if (ctx.inProduct) {
-    const p = ctx.inProduct;
-    lines.push(
-      "### Work on it",
-      "",
-      `This exploration lives in the ${p.name} repository, so it runs in your usual environment: \`git fetch origin && git switch ${branch}\`, then start ${p.name} as you always do.`,
-      "",
-      `The library comes from npm, as on main. To try library changes that are not released yet, install the snapshot of their branch in ${p.library} (\`npm i @bridge-ds/react@<snapshot>\`): the command is in its "Try this exploration in your product" comment. Library changes are made in ${p.library}, never on this branch.`,
-      "",
-      "### Previews",
-      ""
-    );
-    const url = p.preview ? previewUrl(p.preview, { branch, ...ctx.pr ? { pr: ctx.pr } : {} }) : null;
-    if (p.preview) lines.push("| App | Preview |", "| --- | --- |", `| ${p.name} | ${url ?? "Link in the Vercel comment on this pull request"} |`);
-    else lines.push(`The preview deploys of ${p.name}, if it has them, build this branch like any other.`);
-  } else {
-    lines.push(
-      "### Try it in a product staging branch",
-      "",
-      'In the product repo, on a branch that deploys to staging (production keeps the released version), install the snapshot with the command in the "Try this exploration in your product" comment below. It appears a few minutes after each push and always matches the latest commit.'
-    );
-    lines.push("", "### Previews", "");
-    const links = resolveBranchPreviews(ctx.apps, { branch, ...ctx.pr ? { pr: ctx.pr } : {} });
-    if (links.length) lines.push("| App | Preview |", "| --- | --- |", ...links.map((l) => `| ${l.label} | ${l.url ?? "Link in the Vercel comment on this pull request"} |`));
-    else lines.push("Preview deploys are not set up: add `previews.apps` to `bridge.config.json` (docs/PREVIEWS.md).");
+function patchNode(old, next) {
+  if (plainEqual(toPlain(old), next)) return old;
+  if (old.kind === "object" && next && typeof next === "object" && !Array.isArray(next)) {
+    const n = next;
+    const kept = old.entries.filter((e) => n[e.key] !== void 0).map((e) => ({ key: e.key, value: patchNode(e.value, n[e.key]) }));
+    const added = Object.keys(n).filter((k) => n[k] !== void 0 && !getEntry(old, k)).map((k) => ({ key: k, value: fromPlain(n[k], void 0, old.inline) }));
+    return { kind: "object", inline: old.inline, entries: [...kept, ...added] };
   }
-  lines.push(
-    "",
-    "### When it is done",
-    "",
-    `- **Done exploring:** on the exploration's page in Bridge Studio, or \`bridge explore done ${slug}\`. Bridge removes the \`${EXPLORATION_LABEL}\` label and the exploration note, adds \`${EXPLORATION_READY_LABEL}\`, and sends the pieces the designer picks to the DS lead as requests. Nothing is closed or merged: developers continue on \`${branch}\`.`,
-    `- **Archive:** \`bridge explore archive ${slug}\` adds the \`${EXPLORATION_ARCHIVED_LABEL}\` label. Keep this pull request open: ${ctx.inProduct ? "Bridge follows open explorations, and its preview link is how people come back to the prototype." : "closing it removes the preview prerelease."}`,
-    "",
-    explorationBlock({ ...e, slug })
-  );
-  return lines.join("\n");
+  if (old.kind === "array" && Array.isArray(next)) {
+    return { kind: "array", inline: old.inline, items: next.map((v, i) => old.items[i] ? patchNode(old.items[i], v) : fromPlain(v, old.items[0], old.inline)) };
+  }
+  return fromPlain(next, old);
 }
-function explorationBlock(e) {
-  const experimental = (e.experimental ?? []).map((x) => x.trim()).filter(Boolean);
-  const data = {
-    name: e.name.trim(),
-    purpose: (e.purpose ?? "").trim(),
-    slug: e.slug || explorationSlug(e.name),
-    ...e.useCase ? { useCase: e.useCase } : {},
-    ...experimental.length ? { experimental } : {},
-    ...e.author ? { author: e.author } : {},
-    ...e.startedAt ? { startedAt: e.startedAt } : {},
-    ...e.source ? { source: e.source } : {},
-    ...e.agent ? { agent: e.agent } : {},
-    ...e.doneAt ? { doneAt: e.doneAt } : {},
-    ...e.doneSha ? { doneSha: e.doneSha } : {}
+function patchDocsJson(original, next) {
+  const plain = JSON.parse(formatDocsJson(next));
+  if (!original) return formatDocsJson(next);
+  try {
+    const doc = parseJson(original);
+    if (doc.root.kind !== "object") return formatDocsJson(next);
+    return serializeJson({ ...doc, root: patchNode(doc.root, plain) });
+  } catch {
+    return formatDocsJson(next);
+  }
+}
+function acceptDocsText(text) {
+  return patchDocsJson(text, acceptDocsDraft(JSON.parse(text)));
+}
+const DOCS_CHANGE_BUMP = "patch";
+function cleanDraftText(text) {
+  return text.replace(/\s*\u2014\s*/g, ", ").replace(/,\s*,/g, ",").replace(/^,\s*/, "").replace(/[ \t]+/g, " ").trim();
+}
+const values = (s) => (s ?? "").split(", ").map((x) => x.trim()).filter(Boolean);
+const article = (word) => /^[aeiou]/i.test(word) ? "an" : "a";
+const andList = (xs) => xs.length <= 1 ? xs[0] ?? "" : `${xs.slice(0, -1).join(", ")} and ${xs[xs.length - 1]}`;
+const plural = (n, word, many = `${word}s`) => `${n} ${n === 1 ? word : many}`;
+const capital = (s) => s.charAt(0).toUpperCase() + s.slice(1);
+const lower = (s) => s.charAt(0).toLowerCase() + s.slice(1);
+function propShape(s) {
+  if (!s) return void 0;
+  const m = /^(.*?), default (.*)$/.exec(s);
+  return m ? { type: m[1], def: m[2] } : { type: s, def: "" };
+}
+const VARIANT_FIRST = ["variant", "tone", "intent", "appearance", "kind", "type", "style"];
+function shortVariant(key) {
+  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 = 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());
+    return i < 0 ? VARIANT_FIRST.length : i;
   };
-  return `<!-- ${MARK$2} ${JSON.stringify(data).replace(/-->/g, "--\\u003e")} -->`;
+  return kept.map((p, i) => ({ ...p, i })).sort((a, b) => rank(a.k) - rank(b.k) || a.i - b.i).map((p) => p.v).join(" ");
 }
-function parseExplorationBody(body) {
-  if (!body) return void 0;
-  const m = new RegExp(`<!-- ${MARK$2} (\\{[\\s\\S]*?\\}) -->`).exec(body);
+const shortVariants = (list) => list ? andList(list.split("; ").map(shortVariant)) : "every variant";
+function parseStructureChange(c) {
+  const m = /^(New|Removed|Moved) layer "(.*)"(?: \((.*)\))?$/.exec(c.field);
   if (!m) return void 0;
-  try {
-    const e = JSON.parse(m[1]);
-    if (!e || typeof e.name !== "string") return void 0;
-    return typeof e.purpose === "string" ? e : e.purpose === void 0 ? { ...e, purpose: "" } : void 0;
-  } catch {
-    return void 0;
+  const op = m[1] === "New" ? "added" : m[1] === "Removed" ? "removed" : "moved";
+  const where2 = `in ${shortVariants(m[3])}`;
+  if (op === "moved") return { op, name: m[2], where: where2, at: c.after, from: c.before };
+  const shape = (op === "added" ? c.after : c.before) ?? "";
+  const sm = /^(\S+)(?: (.*?))?, ((?:after|before) ".*"|alone)$/.exec(shape);
+  return { op, name: m[2], where: where2, ...sm ? { type: sm[1], ...sm[2] ? { main: sm[2] } : {}, at: sm[3] } : {} };
+}
+function structurePhrase(r) {
+  const type = r.type ? `${r.type} ` : "";
+  const main = r.main ? ` (${r.main})` : "";
+  const at = r.at && r.at !== "alone" ? ` ${r.at}` : "";
+  if (r.op === "added") return `New ${type}layer "${r.name}"${main}${at} ${r.where}`;
+  if (r.op === "removed") return `Removed ${type}layer "${r.name}"${main}${at} ${r.where}`;
+  return `Moved layer "${r.name}" ${r.at ?? ""}${r.from ? ` (was ${r.from})` : ""} ${r.where}`.replace(/\s+/g, " ");
+}
+const bare = (at) => (at ?? "").replace(/"/g, "");
+function firstChange(component, kind, c, all) {
+  switch (kind) {
+    case "new-component": {
+      const axes = all.filter((x) => x.field.startsWith("Variant "));
+      const props = all.filter((x) => x.field.startsWith("Prop "));
+      const parts = [axes.length ? plural(axes.length, "variant axis", "variant axes") : "", props.length ? plural(props.length, "prop") : ""].filter(Boolean);
+      return {
+        title: `Add the ${component} component`,
+        summary: `${component} is not in code yet.${parts.length ? ` The Figma component has ${andList(parts)}.` : ""}`
+      };
+    }
+    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);
+      const added = after.filter((x) => !before.includes(x));
+      const removed = before.filter((x) => !after.includes(x));
+      const word = axis.toLowerCase();
+      if (!before.length) return { title: `Add a ${axis} variant axis`, summary: `${component} gets a new variant axis, ${axis}, with ${after.length === 1 ? "the value" : "the values"} ${andList(after)}.` };
+      if (!after.length) return { title: `Remove the ${axis} variant axis`, summary: `${component} no longer has the ${axis} variant axis (${andList(before)}).` };
+      if (added.length === 1 && !removed.length) return { title: `Add ${article(added[0])} ${added[0]} ${word}`, summary: `${component} gets a new ${axis} value, ${added[0]}.` };
+      if (added.length && !removed.length) return { title: `Add ${andList(added)} to ${axis}`, summary: `${component} gets ${plural(added.length, `new ${axis} value`)}: ${andList(added)}.` };
+      if (removed.length === 1 && !added.length) return { title: `Remove the ${removed[0]} ${word}`, summary: `${component} no longer has the ${axis} value ${removed[0]}.` };
+      if (removed.length && !added.length) return { title: `Remove ${andList(removed)} from ${axis}`, summary: `${component} no longer has the ${axis} values ${andList(removed)}.` };
+      return { title: `Change the ${axis} values`, summary: `${axis} on ${component} goes from ${andList(before)} to ${andList(after)}.` };
+    }
+    case "prop-change": {
+      if (!c) return { title: `Change a ${component} prop`, summary: `A prop of ${component} changed in Figma.` };
+      const name = c.field.replace(/^Prop /, "");
+      const b = propShape(c.before);
+      const a = propShape(c.after);
+      if (!b && a) return { title: `Add the ${name} prop`, summary: `${component} gets a new ${a.type} prop, ${name}${a.def ? `, default ${a.def}` : ""}.` };
+      if (b && !a) return { title: `Remove the ${name} prop`, summary: `${component} no longer has the ${name} prop.` };
+      if (b && a && b.type === a.type && b.def !== a.def) return { title: `Change the ${name} default to ${a.def || "empty"}`, summary: `The default of ${name} on ${component} goes from ${b.def || "empty"} to ${a.def || "empty"}.` };
+      return { title: `Change the ${name} prop`, summary: `${name} on ${component} goes from ${c.before ?? "none"} to ${c.after ?? "none"}.` };
+    }
+    case "token-binding": {
+      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 ${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"}.` };
+      return {
+        title: `Use ${after} for the ${part}`,
+        summary: `The ${part} of ${component}${where2} ${before ? `moves from ${before} to ${after}` : `now uses ${after}`}.`
+      };
+    }
+    case "structure": {
+      const r = c ? parseStructureChange(c) : void 0;
+      if (!r) return { title: "Change the layers to match Figma", summary: `The layers of ${component} changed in Figma.` };
+      if (r.op === "added") {
+        const at = r.at && r.at !== "alone" ? ` ${bare(r.at)}` : "";
+        return { title: `Add a layer${at}`, summary: `${component} gets ${article(r.type ?? "layer")} ${r.type ?? "layer"}${r.type ? " layer" : ""}, ${r.name}${r.main ? ` (${r.main})` : ""}${at} ${r.where}.` };
+      }
+      if (r.op === "removed") return { title: `Remove the ${r.name} layer`, summary: `${component} no longer has the ${r.name} layer ${r.where}.` };
+      return { title: `Move the ${r.name} layer`, summary: `The ${r.name} layer of ${component} moves ${bare(r.at) || "elsewhere"}${r.from ? ` (it was ${bare(r.from)})` : ""} ${r.where}.` };
+    }
+    case "visual":
+      return {
+        title: "Update the look to match Figma",
+        summary: `${component} looks different in Figma${c?.field.startsWith("Look of ") && c.field !== "Look of every variant" ? ` in ${c.field.slice(8)}` : ""}, and no variable edit explains it.`
+      };
+    default:
+      return { title: "", summary: "" };
   }
 }
-const labelNames = (labels) => labels.map((l) => typeof l === "string" ? l : l.name ?? "");
-function isExplorationPull(p) {
-  return isExplorationBranch(p.headRef) || labelNames(p.labels).includes(EXPLORATION_LABEL) || Boolean(parseExplorationBody(p.body));
-}
-function isHandedOff(p) {
-  return labelNames(p.labels).includes(EXPLORATION_READY_LABEL) || Boolean(parseExplorationBody(p.body)?.doneAt);
+function draftRequestText(component, kind, changes) {
+  const name = component.trim() || "the component";
+  if (!changes.length && kind !== "new-component") return { title: "", summary: "" };
+  const d = firstChange(name, kind, changes[0], changes);
+  const rest = kind === "new-component" ? 0 : changes.length - 1;
+  const summary = rest > 0 ? `${d.summary} ${capital(plural(rest, "other change"))} ${rest === 1 ? "is" : "are"} listed below.` : d.summary;
+  return { title: cleanDraftText(d.title), summary: cleanDraftText(summary) };
 }
-function explorationStatus(p) {
-  const merged = Boolean(p.merged || p.merged_at || p.state === "merged");
-  if (p.state !== "open" && !merged) return "closed";
-  if (p.state === "open" && labelNames(p.labels).includes(EXPLORATION_LABEL)) return "active";
-  if (!isHandedOff(p)) return "promoted";
-  if (merged) return "shipped";
-  if (p.draft === false) return "building";
-  const doneSha = parseExplorationBody(p.body)?.doneSha;
-  if (doneSha && p.headSha && p.headSha !== doneSha) return "building";
-  return "ready";
+const DRAFT_LINE_MAX = 120;
+function clipText(text, max) {
+  const t = text.replace(/\s+/g, " ").trim().replace(/\.$/, "");
+  if (t.length <= max) return t;
+  const cut = t.slice(0, max + 1);
+  const at = cut.lastIndexOf(" ");
+  return (at > max * 0.5 ? cut.slice(0, at) : t.slice(0, max)).replace(/[\s,;:(]+$/, "");
 }
-const isActiveExploration = (labels) => labelNames(labels).includes(EXPLORATION_LABEL);
-const isArchivedExploration = (labels) => labelNames(labels ?? []).includes(EXPLORATION_ARCHIVED_LABEL);
-function isHeldExploration(p) {
-  if (p.state !== void 0 && p.state !== "open") return false;
-  const names2 = labelNames(p.labels ?? []);
-  if (names2.includes(EXPLORATION_LABEL) || names2.includes(EXPLORATION_ARCHIVED_LABEL)) return true;
-  return names2.includes(EXPLORATION_READY_LABEL) && p.draft !== false;
+function sanitizeDraftLine(raw) {
+  if (typeof raw !== "string") return "";
+  return capital(clipText(cleanDraftText(raw.replace(/[\r\n]+/g, " ")), DRAFT_LINE_MAX));
 }
-const explorationTakeCommands = (branch) => ["git fetch origin", `git checkout ${branch}`];
-const CONTINUE = "Continue on this branch: its pull request already exists, so Bridge follows your pushes, and the merge reads as shipped.";
-const EXPLORATION_STARTING_POINT = `A starting point, not ready to ship: nobody has reviewed Claude's prototype code yet. ${CONTINUE}`;
-function explorationStartingPoint(checks) {
-  switch (checks) {
-    case "success":
-      return `A starting point: its checks pass, but nobody has reviewed Claude's prototype code yet. ${CONTINUE}`;
-    case "failure":
-      return `A starting point, not ready to ship: some checks fail on this branch and nobody has reviewed Claude's prototype code yet. ${CONTINUE}`;
-    case "pending":
-      return `A starting point, not ready to ship: its checks are still running and nobody has reviewed Claude's prototype code yet. ${CONTINUE}`;
-    case "none":
-      return `A starting point, not ready to ship: no checks ran on this branch and nobody has reviewed Claude's prototype code yet. ${CONTINUE}`;
-    default:
-      return EXPLORATION_STARTING_POINT;
+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);
+    const after2 = values(c.after);
+    if (!before2.length) return `New ${axis} variant axis: ${after2.join(", ")}`;
+    if (!after2.length) return `${axis} variant axis removed (${before2.join(", ")})`;
+    const added = after2.filter((x) => !before2.includes(x));
+    const removed = before2.filter((x) => !after2.includes(x));
+    const parts = [added.length ? `${andList(added)} added to ${axis}` : "", removed.length ? `${andList(removed)} removed from ${axis}` : ""].filter(Boolean);
+    return parts.join("; ") || `${axis} values reordered: ${after2.join(", ")}`;
+  }
+  if (m = /^Prop (.+)$/.exec(c.field)) {
+    const name = m[1];
+    const b = propShape(c.before);
+    const a = propShape(c.after);
+    if (!b && a) return `New ${a.type} prop ${name}${a.def ? `, default ${a.def}` : ""}`;
+    if (b && !a) return `${name} prop removed`;
+    if (b && a && b.type === a.type) return `${name} default goes from ${b.def || "empty"} to ${a.def || "empty"}`;
+    return `${name} prop goes from ${c.before ?? "none"} to ${c.after ?? "none"}`;
+  }
+  if (m = /^Swapped instance(?: \((.*)\))?$/.exec(c.field)) return `Shows ${c.after ?? "another instance"} instead of ${c.before ?? "the coded one"} ${m[1] ? `in ${m[1]}` : "in every variant"}`;
+  if (m = /^Look of (.+)$/.exec(c.field)) return `Looks different in ${m[1]}; no variable explains it`;
+  const layer = parseStructureChange(c);
+  if (layer) return structurePhrase(layer);
+  m = /^(.*?)(?: \((.*)\))?$/.exec(c.field);
+  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}`;
+  if (!before) return `${m[1]} now uses ${after}${where2}`;
+  return `${m[1]} uses ${after} instead of ${before}${where2}`;
 }
-function doneExploringPlan(input) {
-  const removeFiles = input.files.filter((f) => f.path.startsWith(`${EXPLORATION_NOTES_DIR}/`) && f.status !== "removed").map((f) => f.path);
-  return {
-    removeLabels: [EXPLORATION_LABEL],
-    addLabels: [EXPLORATION_READY_LABEL],
-    removeFiles,
-    body: withDoneExploring(input.body, { branch: input.branch, doneAt: (input.date ?? /* @__PURE__ */ new Date()).toISOString() }),
-    take: explorationTakeCommands(input.branch),
-    markReady: false
-  };
-}
-const DEV_SECTION = "### For developers";
-function withDoneExploring(body, done) {
-  const e = parseExplorationBody(body);
-  const [fetch2, checkout] = explorationTakeCommands(done.branch);
-  const section = [
-    DEV_SECTION,
-    "",
-    `**Done exploring on ${done.doneAt.slice(0, 10)}.** ${explorationStartingPoint(done.checks)}`,
-    "",
-    "```sh",
-    fetch2,
-    checkout,
-    "```",
-    "",
-    "Mark this pull request ready for review when the code is yours. Keep it open: its preview link is how designers, the DS lead and stakeholders come back to the prototype."
-  ].join("\n");
-  const block = new RegExp(`<!-- ${MARK$2} \\{[\\s\\S]*?\\} -->`);
-  const kept = (body ?? "").replace(/^> Not mergeable as is\..*$\n?\n?/m, "").replace(/### When it is done[\s\S]*?(?=<!-- |$)/, "").replace(/### For developers[\s\S]*?(?=### |<!-- |$)/, "");
-  if (!e || !block.test(kept)) return `${kept.trim()}${kept.trim() ? "\n\n" : ""}${section}`;
-  const at = kept.search(block);
-  const nextBlock = explorationBlock({ ...e, doneAt: done.doneAt, ...done.doneSha ? { doneSha: done.doneSha } : {} });
-  const after = kept.slice(at).replace(block, () => nextBlock).trim();
-  return `${kept.slice(0, at).trim()}
-
-${section}
-
-${after}`.trim();
+function draftChangeLine(kind, changes) {
+  if (kind === "new-component") {
+    const axes = changes.filter((x) => x.field.startsWith("Variant ")).length;
+    const props = changes.filter((x) => x.field.startsWith("Prop ")).length;
+    const parts = [axes ? plural(axes, "variant axis", "variant axes") : "", props ? plural(props, "prop") : ""].filter(Boolean);
+    return `New component${parts.length ? ` with ${andList(parts)}` : ""}, not in code yet`;
+  }
+  if (!changes.length) return "";
+  const first = changePhrase(changes[0]);
+  const rest = changes.length - 1;
+  const tail = rest ? ` (and ${rest} more)` : "";
+  return capital(clipText(cleanDraftText(first), DRAFT_LINE_MAX - tail.length)) + tail;
 }
-function promotionPlan(input) {
-  const exploration = parseExplorationBody(input.body);
-  const jira = /^([A-Z][A-Z0-9_]*-\d+)\s+/.exec(input.title)?.[1] ?? null;
-  const title = jira ? input.title.slice(jira.length).trim() : input.title;
-  const removeFiles = input.files.filter((f) => f.path.startsWith(`${EXPLORATION_NOTES_DIR}/`) && f.status !== "removed").map((f) => f.path);
-  const files = input.files.filter((f) => !f.path.startsWith(`${EXPLORATION_NOTES_DIR}/`));
-  const risk = classifyRisk({ files, ...input.config ? { config: input.config } : {} });
-  const tokens = files.some((f) => f.path.endsWith(".tokens.json"));
-  const addLabels = [`tier: ${risk.tier}`, ...risk.tier === 3 && tokens ? ["tokens"] : []];
-  const date = (input.date ?? /* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-  const existing = new Set(input.body ? [...input.body.matchAll(/\b(?:close[sd]?|fix(?:e[sd])?|resolve[sd]?)\s+#(\d+)/gi)].map((m) => Number(m[1])) : []);
-  const closes = [...new Set(input.requests ?? [])].filter((n) => !existing.has(n));
-  const kept = (input.body ?? "").replace(/^> Not mergeable as is\..*$\n?\n?/m, "").replace(/### When it is done[\s\S]*?(?=<!-- |$)/, "").replace(/^## Exploration: /m, "## ").trim();
-  const body = [
-    `**Promoted from an exploration on ${date}.** Review it like any change: the tier below comes from the files it touches.`,
-    "",
-    kept || `## ${title.replace(/^Exploration:\s*/i, "")}`,
-    "",
-    `**Risk tier:** ${risk.tier}.`,
-    ...risk.reasons.slice(0, 8).map((r) => `- ${r}`),
-    ...closes.length ? ["", ...closes.map((n) => `Closes #${n}`)] : []
-  ].join("\n");
-  const t = title.replace(/^Exploration:\s*/i, "").trim() || exploration?.name || title;
-  return {
-    tier: risk.tier,
-    reasons: risk.reasons,
-    removeLabels: [EXPLORATION_LABEL],
-    addLabels,
-    removeFiles,
-    body,
-    title: `${jira ? `${jira} ` : ""}${t.charAt(0).toUpperCase()}${t.slice(1)}`,
-    markReady: true
-  };
+const tokenOf = (e) => e.figma ?? e.head ?? e.base;
+const pathOf = (e) => tokenOf(e)?.path ?? e.path;
+function pushChangeRows(entries) {
+  return entries.map((e) => {
+    const before = e.head ?? e.base;
+    const after = e.figma;
+    const show2 = (t) => {
+      if (!t) return void 0;
+      const modes = Object.keys(t.values);
+      if (modes.length <= 1) return formatValue(t.type, t.values[modes[0] ?? ""]);
+      return modes.map((m) => `${modeDisplayName(m)} ${formatValue(t.type, t.values[m])}`).join("; ");
+    };
+    const renamed = e.local?.kind === "renamed" && before && after && before.path !== after.path;
+    return { field: renamed ? `${before.path} -> ${after.path}` : pathOf(e), before: show2(before), after: show2(after) };
+  });
 }
-function explorationTryIt(input) {
-  const c = readPreviewComment(input.comment);
-  if (!c) return { state: "building" };
-  if (input.headSha && c.sha7 && !input.headSha.startsWith(c.sha7)) return { state: "building" };
-  if (!c.command || c.source === "none") return { state: "failed" };
-  return { state: "ready", command: c.command, source: c.source, sha7: c.sha7 };
+function names(paths) {
+  if (paths.length <= 3) return andList(paths);
+  return `${paths.length} tokens, including ${andList(paths.slice(0, 2))}`;
 }
-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}`);
-  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 valueModes(e) {
+  return (e.local?.fields ?? []).filter((f) => f.field === "value" && f.mode && f.mode !== "value").map((f) => modeDisplayName(f.mode));
 }
-function explorationRules(branch) {
-  return [
-    `- Work on the existing branch ${branch} (git fetch origin && git switch ${branch}). Commit there.`,
-    `- Do not open a pull request to main and do not create another branch: the draft pull request of ${branch} is the place. It stays open as a living prototype.`,
-    `- Do not mark the pull request ready for review, do not remove the exploration label and never close it: "Done exploring" is a person's decision, and closing removes its preview.`
-  ];
+function draftPushDescription(entries, components = []) {
+  const by = { changed: [], added: [], renamed: [], removed: [] };
+  for (const e of entries) by[e.local?.kind ?? "changed"].push(e);
+  const clauses = [];
+  if (by.changed.length) {
+    const only = by.changed.length === 1 ? by.changed[0] : void 0;
+    const fields = new Set((only?.local?.fields ?? []).map((f) => f.field));
+    const modes = only ? valueModes(only) : [];
+    if (only && fields.size === 1 && fields.has("description")) clauses.push(`updates the description of ${pathOf(only)}`);
+    else if (only && modes.length) clauses.push(`changes ${pathOf(only)} in ${andList(modes)}`);
+    else clauses.push(`changes ${names(by.changed.map(pathOf))}`);
+  }
+  if (by.added.length) clauses.push(`adds ${names(by.added.map(pathOf))}`);
+  if (by.renamed.length) {
+    const r = by.renamed[0];
+    const from = (r.head ?? r.base)?.path;
+    clauses.push(by.renamed.length === 1 && from && from !== pathOf(r) ? `renames ${from} to ${pathOf(r)}` : `renames ${names(by.renamed.map(pathOf))}`);
+  }
+  if (by.removed.length) clauses.push(`removes ${names(by.removed.map(pathOf))}`);
+  const sentences = [];
+  if (clauses.length) sentences.push(`${capital(andList(clauses))}.`);
+  const fresh = components.filter((c) => c.kind === "new-component").map((c) => c.component);
+  const changed = [...new Set(components.filter((c) => c.kind !== "new-component").map((c) => c.component))];
+  const comp = [];
+  if (changed.length) comp.push(`${changed.length === 1 ? "a change" : "changes"} to ${andList(changed)}`);
+  if (fresh.length) comp.push(`the new ${andList(fresh)} component${fresh.length === 1 ? "" : "s"}`);
+  if (comp.length) sentences.push(`Requests ${andList(comp)}.`);
+  return cleanDraftText(sentences.join(" "));
 }
 const escape = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 function properWord(word, names2) {
@@ -4583,11 +4601,13 @@ 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 = []) {
+function summarizeCi(runs, statuses = [], opts = {}) {
   const failed = [];
   const pending = [];
   let passed = 0;
+  const skip = (name) => Boolean(opts.exploration) && isExplorationCheck(name);
   for (const r of runs) {
+    if (skip(r.name)) continue;
     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 });
@@ -4596,7 +4616,7 @@ function summarizeCi(runs, statuses = []) {
   for (const s of statuses) {
     if (seen.has(s.context)) continue;
     seen.add(s.context);
-    if (isPlatformRefusal(s)) continue;
+    if (isPlatformRefusal(s) || skip(s.context)) 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 });
@@ -5904,7 +5924,7 @@ async function readRepoTexts(source, paths, concurrency = 4, onError = (_path, e
   return out;
 }
 export {
-  overrideComment as $,
+  COLOR_FIELDS as $,
   explorationNote as A,
   explorationNotePath as B,
   explorationPrTitle as C,
@@ -5918,323 +5938,326 @@ export {
   EXPLORATION_NOTES_DIR as K,
   isExplorationBranch as L,
   doneExploringPlan as M,
-  withDoneExploring as N,
-  explorationStartingPoint as O,
+  isGuardedExploration as N,
+  withDoneExploring as O,
   PROSE_KEYS as P,
-  explorationRefLabel as Q,
+  explorationStartingPoint as Q,
   REQUESTS_BRANCH as R,
-  compareSpecToMeasured as S,
-  variantKeyOf as T,
-  matchVariant as U,
-  withoutAddedWrappers as V,
-  pairParts as W,
-  hashSpec as X,
-  SPEC_FIELDS as Y,
-  COLOR_FIELDS as Z,
-  DRAFTED_BY_CLAUDE_LABEL as _,
+  explorationRefLabel as S,
+  EXPLORATION_STATUS_LABEL as T,
+  compareSpecToMeasured as U,
+  variantKeyOf as V,
+  matchVariant as W,
+  withoutAddedWrappers as X,
+  pairParts as Y,
+  hashSpec as Z,
+  SPEC_FIELDS as _,
   parseChangelog as a,
-  EXPLORATION_TIER_LABEL as a$,
-  OVERRIDE_HEADING as a0,
-  overrideRefusedComment as a1,
-  diffLayered as a2,
-  contrastDelta as a3,
-  runLayeredContrast as a4,
-  layeredImpact as a5,
-  classifyLayered as a6,
-  composeProposalBody as a7,
-  createSuggestionOnGitHub as a8,
-  gitBlobSha as a9,
-  GitHubClient as aA,
-  effectiveTier as aB,
-  parseRequestIssue as aC,
-  requestStatus as aD,
-  listSuggestionsOnGitHub as aE,
-  getSuggestionOnGitHub as aF,
-  closingIssueNumbers as aG,
-  requestIssueTitle as aH,
-  pullState as aI,
-  summarizeCi as aJ,
-  summarizeApprovals as aK,
-  BULK_LIMIT as aL,
-  CI_STATE_LABEL as aM,
-  COMPONENT_SPECS_VERSION as aN,
-  CONFLICT_REASON as aO,
-  DEFAULT_COMPONENT_SPECS_FILE as aP,
-  DEFAULT_PROTECTED_BRANCHES as aQ,
-  DOCS_CHANGE_BUMP as aR,
-  DOCS_CLI_ORIGIN as aS,
-  DOCS_EDITOR_ORIGIN as aT,
-  DOCS_KEYS as aU,
-  DOCS_MCP_ORIGIN as aV,
-  EXPLORATION_CHECK as aW,
-  EXPLORATION_READY_LABEL as aX,
-  EXPLORATION_SLUG_MAX as aY,
-  EXPLORATION_STARTING_POINT as aZ,
-  EXPLORATION_STATUS_LABEL as a_,
-  SUGGESTION_SCHEMA as aa,
-  branchWithJiraKey as ab,
-  titleWithJiraKey as ac,
-  figmaSpecPath as ad,
-  formatFigmaSpec as ae,
-  figmaDraftBrief as af,
-  parseFigmaOrigin as ag,
-  figmaPushStatus as ah,
-  parseFigmaSpec as ai,
-  FIGMA_SPEC_DIR as aj,
-  FROM_FIGMA_LABEL as ak,
-  withFigmaOrigin as al,
-  WAITING_FOR_CLAUDE_LABEL as am,
-  planComponentPush as an,
-  figmaOriginSection as ao,
-  figmaBranchTitle as ap,
-  figmaSpecSlug as aq,
-  figmaDraftBody as ar,
-  REQUEST_LABEL as as,
-  figmaNodeUrl as at,
-  parentDir as au,
-  parseComponentSpecs as av,
-  readRepoTexts as aw,
-  normalizeRepoPath as ax,
-  isUnder as ay,
-  componentMotion as az,
+  EXPLORATION_STARTING_POINT as a$,
+  DRAFTED_BY_CLAUDE_LABEL as a0,
+  overrideComment as a1,
+  OVERRIDE_HEADING as a2,
+  overrideRefusedComment as a3,
+  diffLayered as a4,
+  contrastDelta as a5,
+  runLayeredContrast as a6,
+  layeredImpact as a7,
+  classifyLayered as a8,
+  composeProposalBody as a9,
+  isUnder as aA,
+  componentMotion as aB,
+  GitHubClient as aC,
+  effectiveTier as aD,
+  parseRequestIssue as aE,
+  requestStatus as aF,
+  listSuggestionsOnGitHub as aG,
+  getSuggestionOnGitHub as aH,
+  closingIssueNumbers as aI,
+  requestIssueTitle as aJ,
+  pullState as aK,
+  summarizeCi as aL,
+  summarizeApprovals as aM,
+  BULK_LIMIT as aN,
+  CI_STATE_LABEL as aO,
+  COMPONENT_SPECS_VERSION as aP,
+  CONFLICT_REASON as aQ,
+  DEFAULT_COMPONENT_SPECS_FILE as aR,
+  DEFAULT_PROTECTED_BRANCHES as aS,
+  DOCS_CHANGE_BUMP as aT,
+  DOCS_CLI_ORIGIN as aU,
+  DOCS_EDITOR_ORIGIN as aV,
+  DOCS_KEYS as aW,
+  DOCS_MCP_ORIGIN as aX,
+  EXPLORATION_CHECK as aY,
+  EXPLORATION_READY_LABEL as aZ,
+  EXPLORATION_SLUG_MAX as a_,
+  createSuggestionOnGitHub as aa,
+  gitBlobSha as ab,
+  SUGGESTION_SCHEMA as ac,
+  branchWithJiraKey as ad,
+  titleWithJiraKey as ae,
+  figmaSpecPath as af,
+  formatFigmaSpec as ag,
+  figmaDraftBrief as ah,
+  parseFigmaOrigin as ai,
+  figmaPushStatus as aj,
+  parseFigmaSpec as ak,
+  FIGMA_SPEC_DIR as al,
+  FROM_FIGMA_LABEL as am,
+  withFigmaOrigin as an,
+  WAITING_FOR_CLAUDE_LABEL as ao,
+  planComponentPush as ap,
+  figmaOriginSection as aq,
+  figmaBranchTitle as ar,
+  figmaSpecSlug as as,
+  figmaDraftBody as at,
+  REQUEST_LABEL as au,
+  figmaNodeUrl as av,
+  parentDir as aw,
+  parseComponentSpecs as ax,
+  readRepoTexts as ay,
+  normalizeRepoPath as az,
   buildReport as b,
-  cssModuleClasses as b$,
-  EXPLORATION_USE_CASES as b0,
-  FORMER_MEMBER as b1,
-  LOOK_AGAIN_STATUS_LABEL as b2,
-  MeasuredSpecsError as b3,
-  PULL_STATE_PILL as b4,
-  ProtectedBranchError as b5,
-  REDUCED_MOTION_NOTE as b6,
-  REQUEST_STATUS_LABEL as b7,
-  REVIEW_STATUS_LABEL as b8,
-  REVIEW_STATUS_ORDER as b9,
-  assignRequestOnGitHub as bA,
-  assignVersions as bB,
-  base64ToUtf8 as bC,
-  branchVerdict as bD,
-  bridgeMcpInstallCommand as bE,
-  canOverride as bF,
-  canonicalJson as bG,
-  changeTable as bH,
-  changesetBump as bI,
-  classifyAuth as bJ,
-  claudeStage as bK,
-  cleanDocs as bL,
-  clearSharedEtags as bM,
-  commitFileOnGitHub as bN,
-  componentContrastPairs as bO,
-  componentsUsingMotionToken as bP,
-  composeChangeset as bQ,
-  composeSuggestionAppliedComment as bR,
-  composeSuggestionIssue as bS,
-  composeSuggestionOverrideComment as bT,
-  composeSuggestionReviewComment as bU,
-  continueDocsProposalOnGitHub as bV,
-  contrastDeltaTable as bW,
-  countChanges as bX,
-  coverageSummary as bY,
-  cssColorToRgb as bZ,
-  cssColorsToRgb as b_,
-  SUGGESTION_APPLIED_MARK as ba,
-  SUGGESTION_APPLY_EXIT as bb,
-  SUGGESTION_FINAL_LABELS as bc,
-  SUGGESTION_KINDS as bd,
-  SUGGESTION_LABEL as be,
-  SUGGESTION_LIMITS as bf,
-  SUGGESTION_OVERRIDE_MARK as bg,
-  SUGGESTION_REVIEW_MARK as bh,
-  SUGGESTION_STATE_LABELS as bi,
-  SUGGESTION_STATUS_LABEL as bj,
-  SUGGESTION_STATUS_LABELS as bk,
-  SUGGESTION_TOO_LARGE as bl,
-  StorybookIndexError as bm,
-  SuggestionError as bn,
-  TOKEN_REJECTED_MESSAGE as bo,
-  TOKEN_SETTINGS_URL as bp,
-  TRIGGER_LABELS as bq,
-  UNRELEASED as br,
-  acceptDocsDraft as bs,
-  acceptDocsText as bt,
-  allowedMergeMethods as bu,
-  anatomyLabel as bv,
-  appliedStatus as bw,
-  approvedSuggestionNumber as bx,
-  approvedSuggestionOnGitHub as by,
-  assertSafeBranch as bz,
+  cssColorsToRgb as b$,
+  EXPLORATION_TIER_LABEL as b0,
+  EXPLORATION_USE_CASES as b1,
+  FORMER_MEMBER as b2,
+  LOOK_AGAIN_STATUS_LABEL as b3,
+  MeasuredSpecsError as b4,
+  PULL_STATE_PILL as b5,
+  ProtectedBranchError as b6,
+  REDUCED_MOTION_NOTE as b7,
+  REQUEST_STATUS_LABEL as b8,
+  REVIEW_STATUS_LABEL as b9,
+  assertSafeBranch as bA,
+  assignRequestOnGitHub as bB,
+  assignVersions as bC,
+  base64ToUtf8 as bD,
+  branchVerdict as bE,
+  bridgeMcpInstallCommand as bF,
+  canOverride as bG,
+  canonicalJson as bH,
+  changeTable as bI,
+  changesetBump as bJ,
+  classifyAuth as bK,
+  claudeStage as bL,
+  cleanDocs as bM,
+  clearSharedEtags as bN,
+  commitFileOnGitHub as bO,
+  componentContrastPairs as bP,
+  componentsUsingMotionToken as bQ,
+  composeChangeset as bR,
+  composeSuggestionAppliedComment as bS,
+  composeSuggestionIssue as bT,
+  composeSuggestionOverrideComment as bU,
+  composeSuggestionReviewComment as bV,
+  continueDocsProposalOnGitHub as bW,
+  contrastDeltaTable as bX,
+  countChanges as bY,
+  coverageSummary as bZ,
+  cssColorToRgb as b_,
+  REVIEW_STATUS_ORDER as ba,
+  SUGGESTION_APPLIED_MARK as bb,
+  SUGGESTION_APPLY_EXIT as bc,
+  SUGGESTION_FINAL_LABELS as bd,
+  SUGGESTION_KINDS as be,
+  SUGGESTION_LABEL as bf,
+  SUGGESTION_LIMITS as bg,
+  SUGGESTION_OVERRIDE_MARK as bh,
+  SUGGESTION_REVIEW_MARK as bi,
+  SUGGESTION_STATE_LABELS as bj,
+  SUGGESTION_STATUS_LABEL as bk,
+  SUGGESTION_STATUS_LABELS as bl,
+  SUGGESTION_TOO_LARGE as bm,
+  StorybookIndexError as bn,
+  SuggestionError as bo,
+  TOKEN_REJECTED_MESSAGE as bp,
+  TOKEN_SETTINGS_URL as bq,
+  TRIGGER_LABELS as br,
+  UNRELEASED as bs,
+  acceptDocsDraft as bt,
+  acceptDocsText as bu,
+  allowedMergeMethods as bv,
+  anatomyLabel as bw,
+  appliedStatus as bx,
+  approvedSuggestionNumber as by,
+  approvedSuggestionOnGitHub as bz,
   collectHistory as c,
-  mergeGate as c$,
-  declineComment as c0,
-  declineReasonProblems as c1,
-  declineRequestOnGitHub as c2,
-  declineSuggestionOnGitHub as c3,
-  defaultDocsFooter as c4,
-  docsAuthorLine as c5,
-  docsFileText as c6,
-  docsProposal as c7,
-  docsSectionShapes as c8,
-  docsSlug as c9,
-  iconComponentName as cA,
-  installationFor as cB,
-  isActiveExploration as cC,
-  isAutomationPull as cD,
-  isDocsProposalBranch as cE,
-  isDraft as cF,
-  isGuardrailPath as cG,
-  isHandedOff as cH,
-  isHeldExploration as cI,
-  isJiraKey as cJ,
-  isMissingPermission as cK,
-  isPlatformRefusal as cL,
-  isReleasePull as cM,
-  isTokenRejected as cN,
-  jiraIssueFields as cO,
-  jiraKeyOf as cP,
-  joinRepoPath as cQ,
-  linkRequestToExplorationOnGitHub as cR,
-  linkSuggestionPrOnGitHub as cS,
-  linkedPullsOf as cT,
-  loadRepoFiles as cU,
-  lookAgainReviewers as cV,
-  lowerFirstWord as cW,
-  markSuggestionsAppliedOnGitHub as cX,
-  markUsedTokens as cY,
-  memoryEtagStore as cZ,
-  memorySource as c_,
-  docsSuggestionPayload as ca,
-  docsText as cb,
-  draftChangeLine as cc,
-  draftPushDescription as cd,
-  draftRequestText as ce,
-  eligibleReviewers as cf,
-  evalCalc as cg,
-  explorationBranch as ch,
-  explorationRules as ci,
-  explorationShareMessage as cj,
-  explorationSlugFromBranch as ck,
-  explorationTakeCommands as cl,
-  fetchStorybookIndex as cm,
-  figmaCell as cn,
-  fileModes as co,
-  filterHistory as cp,
-  findOpenDocsProposal as cq,
-  findOpenDocsProposalOnGitHub as cr,
-  firstParagraph as cs,
-  formatDocsJson as ct,
-  friendlyMessage as cu,
-  githubSuggestionWorkspace as cv,
-  groupStorybookComponents as cw,
-  hasOwnerApproval as cx,
-  hasSuggestionBlock as cy,
-  hasWriteAccess as cz,
+  markUsedTokens as c$,
+  cssModuleClasses as c0,
+  declineComment as c1,
+  declineReasonProblems as c2,
+  declineRequestOnGitHub as c3,
+  declineSuggestionOnGitHub as c4,
+  defaultDocsFooter as c5,
+  docsAuthorLine as c6,
+  docsFileText as c7,
+  docsProposal as c8,
+  docsSectionShapes as c9,
+  hasWriteAccess as cA,
+  iconComponentName as cB,
+  installationFor as cC,
+  isActiveExploration as cD,
+  isAutomationPull as cE,
+  isDocsProposalBranch as cF,
+  isDraft as cG,
+  isExplorationCheck as cH,
+  isGuardrailPath as cI,
+  isHandedOff as cJ,
+  isHeldExploration as cK,
+  isJiraKey as cL,
+  isMissingPermission as cM,
+  isPlatformRefusal as cN,
+  isReleasePull as cO,
+  isTokenRejected as cP,
+  isUnlabeledExploration as cQ,
+  jiraIssueFields as cR,
+  jiraKeyOf as cS,
+  joinRepoPath as cT,
+  linkRequestToExplorationOnGitHub as cU,
+  linkSuggestionPrOnGitHub as cV,
+  linkedPullsOf as cW,
+  loadRepoFiles as cX,
+  lookAgainReviewers as cY,
+  lowerFirstWord as cZ,
+  markSuggestionsAppliedOnGitHub as c_,
+  docsSlug as ca,
+  docsSuggestionPayload as cb,
+  docsText as cc,
+  draftChangeLine as cd,
+  draftPushDescription as ce,
+  draftRequestText as cf,
+  eligibleReviewers as cg,
+  evalCalc as ch,
+  explorationBranch as ci,
+  explorationRules as cj,
+  explorationShareMessage as ck,
+  explorationSlugFromBranch as cl,
+  explorationTakeCommands as cm,
+  fetchStorybookIndex as cn,
+  figmaCell as co,
+  fileModes as cp,
+  filterHistory as cq,
+  findOpenDocsProposal as cr,
+  findOpenDocsProposalOnGitHub as cs,
+  firstParagraph as ct,
+  formatDocsJson as cu,
+  friendlyMessage as cv,
+  githubSuggestionWorkspace as cw,
+  groupStorybookComponents as cx,
+  hasOwnerApproval as cy,
+  hasSuggestionBlock as cz,
   applyTokenEdits as d,
-  storybookManagerUrl as d$,
-  missingPermissionMessage as d0,
-  missingProse as d1,
-  modeLabel as d2,
-  needsDocsReview as d3,
-  normalizeStorybookUrl as d4,
-  openPulls as d5,
-  overrideHolders as d6,
-  overrideReasonMin as d7,
-  overrideReasonProblem as d8,
-  overrideSuggestionOnGitHub as d9,
-  propsTable as dA,
-  pushChangeRows as dB,
-  rateLimitMessage as dC,
-  releasePull as dD,
-  reopenEligibility as dE,
-  requestBrief as dF,
-  requestImagePath as dG,
-  requesterFirstName as dH,
-  requesterLine as dI,
-  requesterOf as dJ,
-  requiredApprovals as dK,
-  requiredPermission as dL,
-  reviewQueue as dM,
-  reviewStatusKind as dN,
-  reviewStatusLabel as dO,
-  reviewSuggestionOnGitHub as dP,
-  reviewersToAsk as dQ,
-  sectionsNeedingReview as dR,
-  sha256Hex as dS,
-  sharedTokenPrefix as dT,
-  shortVariant as dU,
-  shortVariants as dV,
-  specHash as dW,
-  specsUsage as dX,
-  stalenessStatus as dY,
-  storybookIframeUrl as dZ,
-  storybookIndexUrls as d_,
-  ownerOverridePolicy as da,
-  parseBoxShadow as db,
-  parseChangesetText as dc,
-  parseExplorationRef as dd,
-  parseJiraKey as de,
-  parseMeasuredSpecsFile as df,
-  parseOverrideComment as dg,
-  parseRepo as dh,
-  parseStorybookIndex as di,
-  parseStructureChange as dj,
-  parseSuggestionAppliedComment as dk,
-  parseSuggestionIssue as dl,
-  parseSuggestionOverrideComment as dm,
-  parseSuggestionReviewComment as dn,
-  parseTier as dp,
-  patchDocsJson as dq,
-  pendingApprovals as dr,
-  permissionLabel as ds,
-  planRestore as dt,
-  planRevert as du,
-  planSuggestionApply as dv,
-  planToJson as dw,
-  prNumberFromSubject as dx,
-  prefillDocs as dy,
-  proposeDocsOnGitHub as dz,
+  stalenessStatus as d$,
+  memoryEtagStore as d0,
+  memorySource as d1,
+  mergeGate as d2,
+  missingPermissionMessage as d3,
+  missingProse as d4,
+  modeLabel as d5,
+  needsDocsReview as d6,
+  normalizeStorybookUrl as d7,
+  openPulls as d8,
+  overrideHolders as d9,
+  prNumberFromSubject as dA,
+  prefillDocs as dB,
+  proposeDocsOnGitHub as dC,
+  propsTable as dD,
+  pushChangeRows as dE,
+  rateLimitMessage as dF,
+  releasePull as dG,
+  reopenEligibility as dH,
+  requestBrief as dI,
+  requestImagePath as dJ,
+  requesterFirstName as dK,
+  requesterLine as dL,
+  requesterOf as dM,
+  requiredApprovals as dN,
+  requiredPermission as dO,
+  reviewQueue as dP,
+  reviewStatusKind as dQ,
+  reviewStatusLabel as dR,
+  reviewSuggestionOnGitHub as dS,
+  reviewersToAsk as dT,
+  sectionsNeedingReview as dU,
+  sha256Hex as dV,
+  sharedTokenPrefix as dW,
+  shortVariant as dX,
+  shortVariants as dY,
+  specHash as dZ,
+  specsUsage as d_,
+  overrideReasonMin as da,
+  overrideReasonProblem as db,
+  overrideSuggestionOnGitHub as dc,
+  ownerOverridePolicy as dd,
+  parseBoxShadow as de,
+  parseChangesetText as df,
+  parseExplorationRef as dg,
+  parseJiraKey as dh,
+  parseMeasuredSpecsFile as di,
+  parseOverrideComment as dj,
+  parseRepo as dk,
+  parseStorybookIndex as dl,
+  parseStructureChange as dm,
+  parseSuggestionAppliedComment as dn,
+  parseSuggestionIssue as dp,
+  parseSuggestionOverrideComment as dq,
+  parseSuggestionReviewComment as dr,
+  parseTier as ds,
+  patchDocsJson as dt,
+  pendingApprovals as du,
+  permissionLabel as dv,
+  planRestore as dw,
+  planRevert as dx,
+  planSuggestionApply as dy,
+  planToJson as dz,
   buildHistoryEntry as e,
-  subjectTitle as e0,
-  suggestionAllowedRoots as e1,
-  suggestionAppliedComment as e2,
-  suggestionApplyTable as e3,
-  suggestionIsTokenValues as e4,
-  suggestionIssueTitle as e5,
-  suggestionKindFromLabels as e6,
-  suggestionLabelChanges as e7,
-  suggestionLabels as e8,
-  suggestionOverrideOf as e9,
-  withFigmaPushApprovals as eA,
-  withOutdated as eB,
-  withRequestExploration as eC,
-  withSrgbColors as eD,
-  withSuggestionApprovals as eE,
-  withTokenValueApprovals as eF,
-  withoutJiraKey as eG,
-  suggestionOverrideProblem as ea,
-  suggestionPathProblems as eb,
-  suggestionPayloadSha as ec,
-  suggestionReviewState as ed,
-  suggestionShapeProblems as ee,
-  suggestionStalenessOnGitHub as ef,
-  suggestionStateLabel as eg,
-  suggestionSubject as eh,
-  suggestionTouches as ei,
-  summarizeSuggestionApprovals as ej,
-  syncSuggestionStateLabel as ek,
-  titleOf as el,
-  toChangeSummary as em,
-  tokenCssVar as en,
-  tokenFingerprint as eo,
-  tokenHistory as ep,
-  tokenVariablePath as eq,
-  unsafePathProblem as er,
-  utf8ToBase64 as es,
-  validateComponentSpec as et,
-  validateDocs as eu,
-  validateIntegrations as ev,
-  variantName as ew,
-  versionTimeline as ex,
-  webStorageEtagStore as ey,
-  withAuthorLine as ez,
+  storybookIframeUrl as e0,
+  storybookIndexUrls as e1,
+  storybookManagerUrl as e2,
+  subjectTitle as e3,
+  suggestionAllowedRoots as e4,
+  suggestionAppliedComment as e5,
+  suggestionApplyTable as e6,
+  suggestionIsTokenValues as e7,
+  suggestionIssueTitle as e8,
+  suggestionKindFromLabels as e9,
+  versionTimeline as eA,
+  webStorageEtagStore as eB,
+  withAuthorLine as eC,
+  withFigmaPushApprovals as eD,
+  withOutdated as eE,
+  withRequestExploration as eF,
+  withSrgbColors as eG,
+  withSuggestionApprovals as eH,
+  withTokenValueApprovals as eI,
+  withoutJiraKey as eJ,
+  suggestionLabelChanges as ea,
+  suggestionLabels as eb,
+  suggestionOverrideOf as ec,
+  suggestionOverrideProblem as ed,
+  suggestionPathProblems as ee,
+  suggestionPayloadSha as ef,
+  suggestionReviewState as eg,
+  suggestionShapeProblems as eh,
+  suggestionStalenessOnGitHub as ei,
+  suggestionStateLabel as ej,
+  suggestionSubject as ek,
+  suggestionTouches as el,
+  summarizeSuggestionApprovals as em,
+  syncSuggestionStateLabel as en,
+  titleOf as eo,
+  toChangeSummary as ep,
+  tokenCssVar as eq,
+  tokenFingerprint as er,
+  tokenHistory as es,
+  tokenVariablePath as et,
+  unsafePathProblem as eu,
+  utf8ToBase64 as ev,
+  validateComponentSpec as ew,
+  validateDocs as ex,
+  validateIntegrations as ey,
+  variantName as ez,
   coerceValue as f,
   checkLayeredPair as g,
   formatChangeset as h,
@@ -6253,8 +6276,8 @@ export {
   explorationStatus as u,
   explorationTryIt as v,
   isExplorationPull as w,
-  promotionPlan as x,
-  EXPLORATION_LABEL as y,
+  EXPLORATION_LABEL as x,
+  promotionPlan as y,
   explorationProblems as z
 };
-//# sourceMappingURL=repo-source-CcWmqNBZ.js.map
+//# sourceMappingURL=repo-source-vRf_Jfbz.js.map