@bridge-ds/core 0.2.0 → 0.3.0

package/dist/index.js

@@ -1,5 +1,5 @@
-import { n as modeDisplayName, o as modesOf$1, q as isMultiMode, T as TIER_NAMES, s as TIER_AXIS, u as findReferenceProblems, w as evaluatePairs, x as contrastScope, y as contextLabel, S as SINGLE_MODE, z as pathId, A as removeToken, B as moveToken, D as effectiveScopes, E as sameScopes, F as defaultScopes, G as readTokenAt, H as upsertToken, I as serializeTokenFile, J as emptyTokenFile, K as parseTokenFile, L as modeFile, M as defaultFile, N as EXT_SCOPES, O as EXT_ID, P as DEFAULT_PROTECTED_BRANCHES, a as assertSafeBranch, Q as ProtectedBranchError, f as CONFIG_FILE, l as loadConfig, R as ConfigError, U as DEFAULT_TOKEN_PATHS, c as collectHistory, p as packageDirCandidates, b as parseChangelog, r as releasesFromTags, m as mergeReleases, d as buildReport, V as applyTokenEdits, W as buildHistoryEntry, X as tokensPath, Y as coerceValue, Z as toConfigJson, _ as parseContrastChecks, $ as checkLayeredPair, a0 as classifyRisk, a1 as formatChangeset, a2 as RISK_LABELS, a3 as parseJson, a4 as serializeJson, a5 as plainEqual, a6 as toPlain, a7 as getEntry, a8 as fromPlain, a9 as snapshotUrl, aa as tarballUrl, ab as previewLinks, ac as slugify, ad as installCommand } from "./component-spec-B0V_D3gM.js";
-import { ae, af, ag, k, C, ah, ai, aj, ak, al, am, an, ao, ap, aq, ar, as, at, au, av, aw, ax, ay, az, aA, i, aB, aC, aD, aE, aF, aG, aH, aI, aJ, aK, aL, aM, aN, aO, aP, aQ, aR, aS, aT, aU, aV, aW, aX, aY, aZ, a_, a$, b0, b1, b2, b3, h, j, b4, b5, b6, b7, b8, b9, g, ba, bb, bc, bd, be, bf, bg, bh, bi, bj, e, bk, bl, bm, bn, bo, bp, bq, br, bs, bt, bu, bv, bw, bx, by, t, bz, bA, bB, v, bC, bD } from "./component-spec-B0V_D3gM.js";
+import { n as modeDisplayName, o as modesOf$1, q as isMultiMode, T as TIER_NAMES, s as TIER_AXIS, u as findReferenceProblems, w as evaluatePairs, x as contrastScope, y as contextLabel, S as SINGLE_MODE, z as pathId, A as removeToken, B as moveToken, D as effectiveScopes, E as sameScopes, F as defaultScopes, G as readTokenAt, H as upsertToken, I as serializeTokenFile, J as emptyTokenFile, K as parseTokenFile, L as modeFile, M as defaultFile, N as EXT_SCOPES, O as EXT_ID, P as DEFAULT_PROTECTED_BRANCHES, a as assertSafeBranch, Q as ProtectedBranchError, f as CONFIG_FILE, l as loadConfig, R as ConfigError, U as DEFAULT_TOKEN_PATHS, c as collectHistory, p as packageDirCandidates, b as parseChangelog, r as releasesFromTags, m as mergeReleases, d as buildReport, V as applyTokenEdits, W as buildHistoryEntry, X as resolveBranchPreviews, Y as tokensPath, Z as coerceValue, _ as toConfigJson, $ as parseContrastChecks, a0 as checkLayeredPair, a1 as classifyRisk, a2 as formatChangeset, a3 as RISK_LABELS, a4 as parseJson, a5 as serializeJson, a6 as plainEqual, a7 as toPlain, a8 as getEntry, a9 as fromPlain, aa as previewLinks, ab as slugify, ac as readPreviewComment, ad as findPreviewComment, ae as previewsSettled } from "./component-spec-IRFGJ7XK.js";
+import { af, ag, ah, k, C, ai, aj, ak, al, am, an, ao, ap, aq, ar, as, at, au, av, aw, ax, ay, az, aA, aB, aC, aD, aE, aF, aG, aH, aI, aJ, aK, aL, i, aM, aN, aO, aP, aQ, aR, aS, aT, aU, aV, aW, aX, aY, aZ, a_, a$, b0, b1, b2, b3, b4, b5, b6, b7, b8, b9, ba, bb, bc, bd, be, bf, bg, bh, bi, bj, bk, bl, bm, h, bn, j, bo, bp, bq, br, bs, bt, bu, bv, bw, bx, g, by, bz, bA, bB, bC, bD, bE, bF, bG, bH, bI, bJ, bK, bL, e, bM, bN, bO, bP, bQ, bR, bS, bT, bU, bV, bW, bX, bY, bZ, b_, b$, c0, c1, c2, c3, c4, c5, c6, c7, c8, t, c9, ca, cb, cc, cd, v, ce, cf, cg, ch } from "./component-spec-IRFGJ7XK.js";
 import { a as collectRefs, i as isAlias, b as aliasTarget, v as valuesEqual, s as selectTokenFiles, L as LayeredTokenSet, d as validateLayered, f as formatValue } from "./layered-DGate4nv.js";
 import { D, e as e2, j as j2, k as k2, c, l, m, g as g2, h as h2, n, p, o, r, q, t as t2, u } from "./layered-DGate4nv.js";
 const issueKey = (i2) => `${i2.code}|${i2.path ?? ""}|${i2.mode ?? ""}|${i2.code === "file-problem" ? i2.message : ""}`;
@@ -165,12 +165,12 @@ function validateProposal(proposed, head, pairs, typeChanges = []) {
     else if (existing.has(issueKey(i2))) warnings.push({ ...i2, severity: "warning", message: `Already on main: ${i2.message}` });
     else blocking.push(i2);
   }
-  for (const c2 of typeChanges) {
+  for (const c10 of typeChanges) {
     blocking.push({
       code: "type-change",
       severity: "error",
-      path: c2.path,
-      message: `${c2.path} changed type from ${c2.from} to ${c2.to}. Type changes are not allowed; create a new token instead.`
+      path: c10.path,
+      message: `${c10.path} changed type from ${c10.from} to ${c10.to}. Type changes are not allowed; create a new token instead.`
     });
   }
   return { blocking, warnings, contrastBefore: before.contrast, contrastAfter: after.contrast };
@@ -304,137 +304,191 @@ function composeFiles(head, originals, changes) {
   }
   return { files, allFiles };
 }
-const VAR_RE = /var\(\s*(--[A-Za-z0-9_-]+)/g;
-const IMPORT_RE = /(?:import|export)\s[^'"]*?from\s*['"]([^'"]+)['"]|import\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
-function cssVarsIn(text) {
-  const out = /* @__PURE__ */ new Set();
-  for (const m2 of text.matchAll(VAR_RE)) out.add(m2[1]);
-  return [...out];
-}
-function importsIn(text) {
-  const out = /* @__PURE__ */ new Set();
-  for (const m2 of text.matchAll(IMPORT_RE)) out.add(m2[1] ?? m2[2]);
-  return [...out];
-}
-const norm = (p2) => p2.replace(/\\/g, "/").replace(/\/+$/, "");
-const isStory = (p2) => /\.stories\.[cm]?[jt]sx?$/.test(p2);
-const isTest = (p2) => /\.(test|spec)\.[cm]?[jt]sx?$/.test(p2);
-const isCss = (p2) => /\.(css|scss|less)$/.test(p2);
-const isScript = (p2) => /\.[cm]?[jt]sx?$/.test(p2);
-function componentOf(from, spec, componentsDir) {
-  if (!spec.startsWith(".")) return null;
-  const parts = from.split("/").slice(0, -1);
-  for (const seg of spec.split("/")) {
-    if (seg === "." || seg === "") continue;
-    if (seg === "..") parts.pop();
-    else parts.push(seg);
-  }
-  const abs = parts.join("/");
-  if (!abs.startsWith(`${componentsDir}/`)) return null;
-  return abs.slice(componentsDir.length + 1).split("/")[0] || null;
-}
-function componentForPath(path, componentsDir) {
-  const dir = norm(componentsDir);
-  const p2 = norm(path);
-  if (!p2.startsWith(`${dir}/`)) return null;
-  const rest = p2.slice(dir.length + 1).split("/");
-  return rest.length >= 2 ? rest[0] : null;
-}
-function buildUsageIndex(files, componentsDir) {
-  const dir = norm(componentsDir);
-  const modules = {};
-  const vars = /* @__PURE__ */ new Map();
-  const imports = /* @__PURE__ */ new Map();
-  const storyImports = /* @__PURE__ */ new Map();
-  const globalVars = {};
-  const get = (m2, k3) => m2.get(k3) ?? m2.set(k3, /* @__PURE__ */ new Set()).get(k3);
-  for (const f of files) {
-    const path = norm(f.path);
-    const id = componentForPath(path, dir);
-    if (!id) {
-      if (isCss(path)) {
-        const v2 = cssVarsIn(f.text);
-        if (v2.length) globalVars[path] = v2.sort();
+const PROTECTION_PARTS = ["review", "checks", "history", "deletion"];
+const protectionRulesetName = (defaultBranch) => `Protect the library (${defaultBranch})`;
+const ADMIN_ROLE_ID = 5;
+function protectionRuleset(config, opts) {
+  const branch = config?.repo?.defaultBranch ?? "main";
+  const approvals = Math.max(1, Math.floor(Number.isFinite(opts.approvals) ? opts.approvals : 1));
+  const checks = [...new Set(opts.checks.map((c10) => c10.trim()).filter(Boolean))];
+  const rules = [
+    { type: "deletion" },
+    { type: "non_fast_forward" },
+    {
+      type: "pull_request",
+      parameters: {
+        required_approving_review_count: approvals,
+        dismiss_stale_reviews_on_push: true,
+        require_code_owner_review: false,
+        require_last_push_approval: false,
+        required_review_thread_resolution: false
       }
-      continue;
-    }
-    const mod = modules[id] ??= { id, dir: `${dir}/${id}`, files: [], vars: [], imports: [], storyImports: [] };
-    mod.files.push(path);
-    if (isTest(path)) continue;
-    for (const v2 of cssVarsIn(f.text)) get(vars, id).add(v2);
-    if (!isScript(path)) continue;
-    for (const spec of importsIn(f.text)) {
-      const dep = componentOf(path, spec, dir);
-      if (!dep || dep === id) continue;
-      get(isStory(path) ? storyImports : imports, id).add(dep);
     }
+  ];
+  if (checks.length) {
+    rules.push({
+      type: "required_status_checks",
+      parameters: {
+        strict_required_status_checks_policy: false,
+        required_status_checks: checks.map((context) => ({ context }))
+      }
+    });
   }
-  const byVar = {};
-  for (const mod of Object.values(modules)) {
-    mod.files.sort();
-    mod.vars = [...vars.get(mod.id) ?? []].sort();
-    mod.imports = [...imports.get(mod.id) ?? []].sort();
-    mod.storyImports = [...storyImports.get(mod.id) ?? []].filter((d) => !mod.imports.includes(d)).sort();
-    for (const v2 of mod.vars) (byVar[v2] ??= []).push(mod.id);
-  }
-  for (const k3 of Object.keys(byVar)) byVar[k3].sort();
-  return { componentsDir: dir, modules, byVar, globalVars };
-}
-function impactedModules(index, input) {
-  const reasons = /* @__PURE__ */ new Map();
-  const add = (id, reason, indirect) => {
-    const r2 = reasons.get(id);
-    if (r2) {
-      if (!r2.reasons.includes(reason)) r2.reasons.push(reason);
-      r2.indirect &&= indirect;
-    } else reasons.set(id, { reasons: [reason], indirect });
+  return {
+    name: protectionRulesetName(branch),
+    target: "branch",
+    enforcement: "active",
+    conditions: { ref_name: { include: ["~DEFAULT_BRANCH"], exclude: [] } },
+    rules,
+    bypass_actors: opts.adminBypass ? [{ actor_id: ADMIN_ROLE_ID, actor_type: "RepositoryRole", bypass_mode: "pull_request" }] : []
   };
-  const changedVars = new Set(input.vars ?? []);
-  for (const v2 of changedVars) for (const id of index.byVar[v2] ?? []) add(id, `uses ${v2}`, false);
-  for (const f of input.files ?? []) {
-    const id = componentForPath(f, index.componentsDir);
-    if (id && index.modules[id]) add(id, `file changed: ${norm(f)}`, false);
-  }
-  const renderedBy = /* @__PURE__ */ new Map();
-  for (const m2 of Object.values(index.modules)) for (const d of m2.imports) (renderedBy.get(d) ?? renderedBy.set(d, []).get(d)).push(m2.id);
-  const queue = [...reasons.keys()];
-  while (queue.length) {
-    const id = queue.shift();
-    for (const parent of renderedBy.get(id) ?? []) {
-      const known = reasons.has(parent);
-      add(parent, `renders ${id}`, true);
-      if (!known) queue.push(parent);
-    }
-  }
-  const globalHits = Object.entries(index.globalVars).map(([file, vs]) => ({ file, vars: vs.filter((v2) => changedVars.has(v2)) })).filter((g3) => g3.vars.length > 0);
-  const modules = [...reasons.entries()].map(([id, r2]) => ({ id, reasons: r2.reasons, indirect: r2.indirect })).sort((a, b) => Number(a.indirect) - Number(b.indirect) || a.id.localeCompare(b.id));
-  return { modules, globalHits };
 }
-function tokenUsage(tokens, reads) {
-  const readVars = /* @__PURE__ */ new Set();
-  for (const [v2, mods] of Object.entries(reads.byVar ?? {})) if (mods.length) readVars.add(v2);
-  for (const vars of Object.values(reads.globalVars ?? {})) for (const v2 of vars) readVars.add(v2);
-  const byPath = new Map(tokens.map((t3) => [t3.path, t3]));
-  const direct = new Set(tokens.filter((t3) => readVars.has(t3.cssVar)).map((t3) => t3.path));
-  const used = /* @__PURE__ */ new Set();
-  const queue = [...direct];
-  while (queue.length) {
-    const p2 = queue.pop();
-    if (used.has(p2)) continue;
-    used.add(p2);
-    for (const r2 of byPath.get(p2)?.refs ?? []) if (!used.has(r2) && byPath.has(r2)) queue.push(r2);
+const isVercel = (r2) => /vercel/i.test(r2.app ?? "") || /^vercel\b/i.test(r2.name);
+const ran = (r2) => r2.conclusion !== "skipped" && r2.conclusion !== "cancelled" && r2.conclusion !== "stale";
+function requiredCheckNames(defaultBranchRuns, pullRequestRuns) {
+  const names2 = [...new Set(defaultBranchRuns.filter((r2) => !isVercel(r2) && ran(r2)).map((r2) => r2.name))];
+  if (!pullRequestRuns?.length) return names2;
+  const onPulls = new Set(pullRequestRuns.filter((r2) => !isVercel(r2)).map((r2) => r2.name));
+  return names2.filter((n2) => onPulls.has(n2));
+}
+function refPattern(pattern) {
+  const src = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*\*/g, "\0").replace(/\*/g, "[^/]*").replace(/\?/g, "[^/]").replace(/\u0000/g, ".*");
+  return new RegExp(`^${src}$`);
+}
+function rulesetTargetsDefault(ruleset, defaultBranch) {
+  if (ruleset.target && ruleset.target !== "branch") return false;
+  const ref = `refs/heads/${defaultBranch}`;
+  const hit = (p2) => p2 === "~ALL" || p2 === "~DEFAULT_BRANCH" || p2 === ref || p2 === defaultBranch || refPattern(p2.startsWith("refs/") ? p2 : `refs/heads/${p2}`).test(ref);
+  const cond = ruleset.conditions?.ref_name;
+  if (!cond) return false;
+  if ((cond.exclude ?? []).some(hit)) return false;
+  return (cond.include ?? []).some(hit);
+}
+const count = (v2) => typeof v2 === "number" ? v2 : 0;
+function rulesetParts(ruleset) {
+  const parts = /* @__PURE__ */ new Set();
+  if (ruleset.enforcement !== "active") return parts;
+  for (const rule of ruleset.rules ?? []) {
+    if (rule.type === "deletion") parts.add("deletion");
+    if (rule.type === "non_fast_forward") parts.add("history");
+    if (rule.type === "pull_request" && count(rule.parameters?.required_approving_review_count) >= 1) parts.add("review");
+    if (rule.type === "required_status_checks" && Array.isArray(rule.parameters?.required_status_checks) && rule.parameters.required_status_checks.length > 0) parts.add("checks");
+  }
+  return parts;
+}
+function classicParts(p2) {
+  const parts = /* @__PURE__ */ new Set();
+  if (count(p2.required_pull_request_reviews?.required_approving_review_count) >= 1) parts.add("review");
+  if (((p2.required_status_checks?.contexts?.length ?? 0) || (p2.required_status_checks?.checks?.length ?? 0)) > 0) parts.add("checks");
+  if (!p2.allow_force_pushes?.enabled) parts.add("history");
+  if (!p2.allow_deletions?.enabled) parts.add("deletion");
+  return parts;
+}
+const rulesetUrl = (r2) => r2.html_url ?? r2._links?.html?.href;
+function protectionState(rulesets, branchProtection, defaultBranch) {
+  const bridge = rulesets?.find((r2) => r2.name === protectionRulesetName(defaultBranch));
+  const extra = bridge?.id !== void 0 ? { bridgeRulesetId: bridge.id } : {};
+  const covered = /* @__PURE__ */ new Set();
+  let url;
+  for (const r2 of rulesets ?? []) {
+    if (!rulesetTargetsDefault(r2, defaultBranch)) continue;
+    const parts = rulesetParts(r2);
+    if (parts.size && !url) url = rulesetUrl(r2);
+    parts.forEach((p2) => covered.add(p2));
+  }
+  if (branchProtection) classicParts(branchProtection).forEach((p2) => covered.add(p2));
+  const missing = PROTECTION_PARTS.filter((p2) => !covered.has(p2));
+  const withUrl = url ? { url } : {};
+  if (!missing.length) return { kind: "protected", missing, ...extra, ...withUrl };
+  const unreadable = rulesets == null || branchProtection === void 0;
+  if (covered.size === 0) return { kind: unreadable ? "unknown" : "unprotected", missing, ...extra };
+  return { kind: "partial", missing, ...extra, ...withUrl };
+}
+const PROTECTION_PART_PHRASE = {
+  review: "changes can skip review",
+  checks: "checks do not have to pass",
+  history: "past changes can be rewritten",
+  deletion: "the library can be deleted"
+};
+const joinAnd = (xs) => xs.length <= 1 ? xs[0] ?? "" : `${xs.slice(0, -1).join(", ")} and ${xs[xs.length - 1]}`;
+function protectionSentence(state) {
+  switch (state.kind) {
+    case "protected":
+      return "Protected: every change goes through review.";
+    case "unprotected":
+      return "Your library can be changed without review.";
+    case "partial": {
+      const s = joinAnd(state.missing.map((p2) => PROTECTION_PART_PHRASE[p2]));
+      return `Partly protected: ${s}.`;
+    }
+    default:
+      return "Protection status unknown: GitHub did not let this token read it.";
   }
-  return { used, direct };
 }
 class GitHubError extends Error {
-  constructor(status, message, detail) {
+  constructor(status, message, detail, info = {}) {
     super(message);
     this.status = status;
     this.detail = detail;
     this.name = "GitHubError";
+    this.auth = info.auth;
+    this.permission = info.permission;
   }
   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;
+}
+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(/^./, (c10) => c10.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((p22) => p22.trim().split("=")[0].trim()).filter((p22) => p22 && p22 !== "metadata");
+    if (first.length) return first[0];
+  }
+  const p2 = path.replace(/[?#].*$/, "");
+  if (/\/repos\/[^/]+\/[^/]+\/(issues|labels|milestones)(\/|$)/.test(p2)) return "issues";
+  if (/\/repos\/[^/]+\/[^/]+\/pulls(\/|$)/.test(p2)) return "pull_requests";
+  if (/\/repos\/[^/]+\/[^/]+\/(rulesets(\/|$)|branches\/.+\/protection$)/.test(p2)) return "administration";
+  if (/\/repos\/[^/]+\/[^/]+\/(contents|git|commits|branches|merges)(\/|$)/.test(p2)) return "contents";
+  if (/\/repos\/[^/]+\/[^/]+\/(check-runs|check-suites)(\/|$)/.test(p2)) return "checks";
+  if (/\/repos\/[^/]+\/[^/]+\/statuses(\/|$)/.test(p2)) return "statuses";
+  if (/\/repos\/[^/]+\/[^/]+\/deployments(\/|$)/.test(p2)) return "deployments";
+  if (/\/repos\/[^/]+\/[^/]+\/actions(\/|$)/.test(p2)) 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 DEFAULT_RETRY = { attempts: 3, baseDelayMs: 600, sleep: (ms) => new Promise((r2) => setTimeout(r2, ms)) };
 const isTransient = (status, detail) => status === 0 || status >= 500 || status === 429 || status === 403 && /secondary rate limit/i.test(detail);
@@ -497,7 +551,7 @@ class GitHubClient {
     }
   }
   assertToken(what) {
-    if (!this.token) throw new GitHubError(401, `${what} needs a GitHub token (contents and pull requests, read and write, on this repository only). Without one Bridge is read-only.`);
+    if (!this.token) throw new GitHubError(401, `${what} needs a GitHub token (contents and pull requests, read and write, on this repository only). Without one Bridge is read-only.`, "no-token");
   }
   get repoPath() {
     return `/repos/${this.owner}/${this.name}`;
@@ -546,7 +600,12 @@ class GitHubClient {
           detail
         );
       }
-      throw new GitHubError(res.status, friendlyMessage(res.status, detail), detail);
+      const info = classifyAuth(res.status, detail, {
+        path,
+        acceptedPermissions: res.headers?.get("x-accepted-github-permissions"),
+        withToken: Boolean(this.token)
+      });
+      throw new GitHubError(res.status, friendlyMessage(res.status, detail, info), detail, info);
     }
     return await res.json();
   }
@@ -725,6 +784,11 @@ class GitHubClient {
   async addComment(issueNumber, body) {
     await this.request("POST", `${this.repoPath}/issues/${issueNumber}/comments`, { body });
   }
+  /** Comments on an issue or pull request, oldest first (first 100: the sticky preview comment is posted early). */
+  async listIssueComments(issueNumber) {
+    const r2 = await this.request("GET", `${this.repoPath}/issues/${issueNumber}/comments?per_page=100`);
+    return r2.map((c10) => ({ id: c10.id, body: c10.body ?? "", author: c10.user?.login ?? "unknown", updatedAt: c10.updated_at }));
+  }
   // --- Issues (component change requests) ---------------------------------------------------
   async createIssue(input) {
     const r2 = await this.request("POST", `${this.repoPath}/issues`, {
@@ -745,6 +809,67 @@ class GitHubClient {
   async getIssue(n2) {
     return toIssue(await this.request("GET", `${this.repoPath}/issues/${n2}`));
   }
+  /** Edits an issue: its body, or closes it with a reason ("not_planned" for a declined request). */
+  async updateIssue(n2, patch) {
+    this.assertToken("Editing an issue");
+    return toIssue(await this.request("PATCH", `${this.repoPath}/issues/${n2}`, patch));
+  }
+  /** Adds people to an issue's assignees (GitHub ignores logins that cannot be assigned: the result says who is). */
+  async addAssignees(n2, logins) {
+    this.assertToken("Assigning an issue");
+    const r2 = await this.request("POST", `${this.repoPath}/issues/${n2}/assignees`, { assignees: logins });
+    return (r2.assignees ?? []).map((a) => a.login);
+  }
+  /** People with at least `permission` on the repository (reading the list needs push access). First 100. */
+  async listCollaborators(permission = "push") {
+    const r2 = await this.request("GET", `${this.repoPath}/collaborators?permission=${permission}&per_page=100`);
+    return r2.map((c10) => ({ login: c10.login, avatarUrl: c10.avatar_url ?? "" }));
+  }
+  /** Whether a token is sent with each request (TeamReader). */
+  get hasToken() {
+    return Boolean(this.token);
+  }
+  /** Every page of a list endpoint (per_page 100), up to `maxPages`. */
+  async paginate(path, maxPages = 20) {
+    const out = [];
+    const sep = path.includes("?") ? "&" : "?";
+    for (let page = 1; page <= maxPages; page++) {
+      const r2 = await this.request("GET", `${path}${sep}per_page=100&page=${page}`);
+      out.push(...r2);
+      if (r2.length < 100) break;
+    }
+    return out;
+  }
+  /** Every member login of an organization team (needs read:org, or Members: Read on a fine-grained token). */
+  async listTeamMembers(org, slug) {
+    const r2 = await this.paginate(`/orgs/${encodeURIComponent(org)}/teams/${encodeURIComponent(slug)}/members`);
+    return r2.map((m2) => m2.login);
+  }
+  /** A user's membership of a team: "active", "pending", or null when GitHub says they are not a member (404). */
+  async getTeamMembership(org, slug, login) {
+    try {
+      const r2 = await this.request("GET", `/orgs/${encodeURIComponent(org)}/teams/${encodeURIComponent(slug)}/memberships/${encodeURIComponent(login)}`);
+      return r2.state === "active" ? "active" : "pending";
+    } catch (err) {
+      if (err instanceof GitHubError && err.status === 404) return null;
+      throw err;
+    }
+  }
+  /** "User" or "Organization" for a login, null when GitHub does not know it. */
+  async getAccountType(login) {
+    try {
+      const r2 = await this.request("GET", `/users/${encodeURIComponent(login)}`);
+      return r2.type === "Organization" ? "Organization" : r2.type === "User" ? "User" : null;
+    } catch (err) {
+      if (err instanceof GitHubError && err.status === 404) return null;
+      throw err;
+    }
+  }
+  /** The organization's teams this token can see. */
+  async listOrgTeams(org) {
+    const r2 = await this.paginate(`/orgs/${encodeURIComponent(org)}/teams`);
+    return r2.map((t3) => ({ slug: t3.slug, name: t3.name }));
+  }
   /** Create or update a binary file (base64 content) on a branch, e.g. a Figma export attached to a request. */
   async putBase64File(input) {
     this.assertWritableBranch(input.branch);
@@ -873,13 +998,34 @@ class GitHubClient {
       this.listCheckRuns(sha).catch(() => [])
     ]);
     const checks = [
-      ...runs.map((c2) => ({ name: c2.name, status: c2.status, conclusion: c2.conclusion })),
+      ...runs.map((c10) => ({ name: c10.name, status: c10.status, conclusion: c10.conclusion })),
       ...combined.statuses.map((s) => ({ name: s.context, status: s.state === "pending" ? "in_progress" : "completed", conclusion: s.state === "pending" ? null : s.state }))
     ];
-    const failing = checks.some((c2) => c2.conclusion && !["success", "neutral", "skipped"].includes(c2.conclusion));
-    const pending = checks.some((c2) => c2.status !== "completed");
+    const failing = checks.some((c10) => c10.conclusion && !["success", "neutral", "skipped"].includes(c10.conclusion));
+    const pending = checks.some((c10) => c10.status !== "completed");
     return { state: !checks.length ? "none" : failing ? "failure" : pending ? "pending" : "success", checks };
   }
+  /** Commit statuses of a commit, newest first (Vercel reports each project as "Vercel – <project>"). */
+  async listCommitStatuses(sha) {
+    const r2 = await this.request("GET", `${this.repoPath}/commits/${encodeRef(sha)}/statuses?per_page=100`);
+    return r2.map((s) => ({ context: s.context, state: s.state, target_url: s.target_url ?? null, description: s.description ?? null }));
+  }
+  /**
+   * GitHub deployments of a commit with their latest status (environment "Preview – <project>", environment_url the
+   * preview). Latest per environment only, so it costs one read plus one per environment.
+   */
+  async listDeployments(sha) {
+    const list = await this.request("GET", `${this.repoPath}/deployments?sha=${encodeURIComponent(sha)}&per_page=30`);
+    const latest = /* @__PURE__ */ new Map();
+    for (const d of list) if (!latest.has(d.environment)) latest.set(d.environment, d);
+    return Promise.all(
+      [...latest.values()].map(async (d) => {
+        const st = await this.request("GET", `${this.repoPath}/deployments/${d.id}/statuses?per_page=1`).catch(() => []);
+        const s = st[0];
+        return { id: d.id, environment: d.environment, state: s?.state ?? null, environmentUrl: s?.environment_url || null };
+      })
+    );
+  }
   async getPullRequest(n2) {
     const r2 = await this.request("GET", `${this.repoPath}/pulls/${n2}`);
     return { ...toSummary(r2), body: r2.body ?? "", mergeable: r2.mergeable ?? null };
@@ -906,7 +1052,44 @@ class GitHubClient {
       "GET",
       `${this.repoPath}/commits/${encodeRef(ref)}/check-runs`
     );
-    return r2.check_runs.map((c2) => ({ id: c2.id, name: c2.name, status: c2.status, conclusion: c2.conclusion, url: c2.html_url }));
+    return r2.check_runs.map((c10) => ({ id: c10.id, name: c10.name, status: c10.status, conclusion: c10.conclusion, url: c10.html_url, ...c10.app?.slug ? { app: c10.app.slug } : {} }));
+  }
+  /** Rulesets that apply to the repository, without their rules (GET /rulesets; read access is enough). */
+  async listRulesets() {
+    const r2 = await this.request("GET", `${this.repoPath}/rulesets?includes_parents=true&per_page=100`);
+    return r2.map(withRulesetUrl);
+  }
+  /** One ruleset with its rules. */
+  async getRuleset(id) {
+    return withRulesetUrl(await this.request("GET", `${this.repoPath}/rulesets/${id}`));
+  }
+  /** Creates a repository ruleset. Needs admin on the repo (fine-grained token: Administration read and write). */
+  async createRuleset(payload) {
+    this.assertToken("Protecting the library");
+    return withRulesetUrl(await this.request("POST", `${this.repoPath}/rulesets`, payload));
+  }
+  /** Replaces a repository ruleset (same permissions as createRuleset). */
+  async updateRuleset(id, payload) {
+    this.assertToken("Protecting the library");
+    return withRulesetUrl(await this.request("PUT", `${this.repoPath}/rulesets/${id}`, payload));
+  }
+  /**
+   * Classic branch protection of `branch`: the settings, null when the branch has none (404), undefined when this
+   * token cannot read them (403: the endpoint needs admin). On a 403 the public branch summary still tells
+   * whether the branch is protected at all: `protected: false` means there is nothing to read, so null.
+   */
+  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) {
@@ -923,13 +1106,13 @@ class GitHubClient {
     await this.request("DELETE", `${this.repoPath}/issues/${issueNumber}/labels/${encodeURIComponent(label)}`);
   }
 }
-function toCommitSummary(c2) {
+function toCommitSummary(c10) {
   return {
-    sha: c2.sha,
-    parents: (c2.parents ?? []).map((p2) => p2.sha),
-    date: c2.commit?.committer?.date ?? c2.commit?.author?.date ?? "",
-    author: c2.author?.login ?? c2.commit?.author?.name ?? "unknown",
-    message: c2.commit?.message ?? ""
+    sha: c10.sha,
+    parents: (c10.parents ?? []).map((p2) => p2.sha),
+    date: c10.commit?.committer?.date ?? c10.commit?.author?.date ?? "",
+    author: c10.author?.login ?? c10.commit?.author?.name ?? "unknown",
+    message: c10.commit?.message ?? ""
   };
 }
 function toSummary(r2) {
@@ -948,7 +1131,9 @@ function toSummary(r2) {
     ...typeof r2.body === "string" ? { body: r2.body } : {}
   };
 }
-function friendlyMessage(status, detail) {
+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.";
@@ -1005,6 +1190,10 @@ async function loadRepoFiles(client, commitSha, fallbackTokensPath) {
   await Promise.all([worker(), worker(), worker(), worker()]);
   return { commitSha, treeSha, files, contrastChecks, config, ...config ? { configText } : {}, tokensPath: tokensPath2, warnings };
 }
+function withRulesetUrl(r2) {
+  const href = r2._links?.html?.href;
+  return href && !r2.html_url ? { ...r2, html_url: href } : r2;
+}
 function toIssue(r2) {
   return {
     number: r2.number,
@@ -1019,15 +1208,165 @@ function toIssue(r2) {
     updatedAt: r2.updated_at
   };
 }
-function gitHubHistoryBackend(client, config, opts = {}) {
-  const trees = /* @__PURE__ */ new Map();
-  const tree = (sha) => {
-    let t3 = trees.get(sha);
-    if (!t3) {
-      t3 = client.getCommitTree(sha).then((ts) => client.getTree(ts, true)).then((r2) => r2.entries);
-      trees.set(sha, t3);
+async function loadProtection(client, defaultBranch) {
+  const rulesets = await client.listRulesets().then((list) => Promise.all(list.map((r2) => r2.enforcement === "disabled" || r2.id === void 0 ? r2 : client.getRuleset(r2.id)))).catch(() => null);
+  const classic = await client.getBranchProtection(defaultBranch).catch(() => void 0);
+  return protectionState(rulesets, classic, defaultBranch);
+}
+async function loadRequiredChecks(client, defaultBranch) {
+  const onDefault = await client.listCheckRuns(defaultBranch).catch(() => []);
+  const merged = await client.listPullRequests("closed").then((prs) => prs.find((p2) => p2.state === "merged" && p2.baseRef === defaultBranch)).catch(() => void 0);
+  const onPull = merged?.headSha ? await client.listCheckRuns(merged.headSha).catch(() => []) : [];
+  return requiredCheckNames(onDefault, onPull);
+}
+async function protectLibrary(client, defaultBranch, opts = {}) {
+  const checks = opts.checks ?? await loadRequiredChecks(client, defaultBranch);
+  const payload = protectionRuleset({ repo: { defaultBranch } }, { checks, approvals: opts.approvals ?? 1, adminBypass: opts.adminBypass ?? true });
+  const id = opts.state?.bridgeRulesetId;
+  return id !== void 0 ? client.updateRuleset(id, payload) : client.createRuleset(payload);
+}
+const PLAN_REFUSED = /upgrade to github (pro|team)|make this repository public|not available for private repositories/i;
+const isPlanRefusal = (err) => err instanceof GitHubError && (err.status === 403 || err.status === 422) && PLAN_REFUSED.test(`${err.detail ?? ""} ${err.message}`);
+const rulesSettingsUrl = (owner, repo) => `https://github.com/${owner}/${repo}/settings/rules`;
+function protectRefusal(err) {
+  if (!(err instanceof GitHubError)) return null;
+  if (isPlanRefusal(err)) return "GitHub's plan for this private repository does not include protection rules. Upgrade the plan or make the repository public, then try again.";
+  if (/admin rights/i.test(`${err.detail ?? ""}`)) return "Only a repository admin can protect the library. Ask an admin, or set it up in GitHub settings.";
+  if (err.auth === "missing-permission") return "This token cannot change the protection. Add Administration: Read and write to the token on GitHub, then try again.";
+  if (err.status === 403 || err.status === 404) return "Only a repository admin can protect the library. Ask an admin, or set it up in GitHub settings.";
+  return null;
+}
+const VAR_RE = /var\(\s*(--[A-Za-z0-9_-]+)/g;
+const IMPORT_RE = /(?:import|export)\s[^'"]*?from\s*['"]([^'"]+)['"]|import\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
+function cssVarsIn(text) {
+  const out = /* @__PURE__ */ new Set();
+  for (const m2 of text.matchAll(VAR_RE)) out.add(m2[1]);
+  return [...out];
+}
+function importsIn(text) {
+  const out = /* @__PURE__ */ new Set();
+  for (const m2 of text.matchAll(IMPORT_RE)) out.add(m2[1] ?? m2[2]);
+  return [...out];
+}
+const norm = (p2) => p2.replace(/\\/g, "/").replace(/\/+$/, "");
+const isStory = (p2) => /\.stories\.[cm]?[jt]sx?$/.test(p2);
+const isTest = (p2) => /\.(test|spec)\.[cm]?[jt]sx?$/.test(p2);
+const isCss = (p2) => /\.(css|scss|less)$/.test(p2);
+const isScript = (p2) => /\.[cm]?[jt]sx?$/.test(p2);
+function componentOf(from, spec, componentsDir) {
+  if (!spec.startsWith(".")) return null;
+  const parts = from.split("/").slice(0, -1);
+  for (const seg of spec.split("/")) {
+    if (seg === "." || seg === "") continue;
+    if (seg === "..") parts.pop();
+    else parts.push(seg);
+  }
+  const abs = parts.join("/");
+  if (!abs.startsWith(`${componentsDir}/`)) return null;
+  return abs.slice(componentsDir.length + 1).split("/")[0] || null;
+}
+function componentForPath(path, componentsDir) {
+  const dir = norm(componentsDir);
+  const p2 = norm(path);
+  if (!p2.startsWith(`${dir}/`)) return null;
+  const rest = p2.slice(dir.length + 1).split("/");
+  return rest.length >= 2 ? rest[0] : null;
+}
+function buildUsageIndex(files, componentsDir) {
+  const dir = norm(componentsDir);
+  const modules = {};
+  const vars = /* @__PURE__ */ new Map();
+  const imports = /* @__PURE__ */ new Map();
+  const storyImports = /* @__PURE__ */ new Map();
+  const globalVars = {};
+  const get = (m2, k3) => m2.get(k3) ?? m2.set(k3, /* @__PURE__ */ new Set()).get(k3);
+  for (const f of files) {
+    const path = norm(f.path);
+    const id = componentForPath(path, dir);
+    if (!id) {
+      if (isCss(path)) {
+        const v2 = cssVarsIn(f.text);
+        if (v2.length) globalVars[path] = v2.sort();
+      }
+      continue;
     }
-    return t3;
+    const mod = modules[id] ??= { id, dir: `${dir}/${id}`, files: [], vars: [], imports: [], storyImports: [] };
+    mod.files.push(path);
+    if (isTest(path)) continue;
+    for (const v2 of cssVarsIn(f.text)) get(vars, id).add(v2);
+    if (!isScript(path)) continue;
+    for (const spec of importsIn(f.text)) {
+      const dep = componentOf(path, spec, dir);
+      if (!dep || dep === id) continue;
+      get(isStory(path) ? storyImports : imports, id).add(dep);
+    }
+  }
+  const byVar = {};
+  for (const mod of Object.values(modules)) {
+    mod.files.sort();
+    mod.vars = [...vars.get(mod.id) ?? []].sort();
+    mod.imports = [...imports.get(mod.id) ?? []].sort();
+    mod.storyImports = [...storyImports.get(mod.id) ?? []].filter((d) => !mod.imports.includes(d)).sort();
+    for (const v2 of mod.vars) (byVar[v2] ??= []).push(mod.id);
+  }
+  for (const k3 of Object.keys(byVar)) byVar[k3].sort();
+  return { componentsDir: dir, modules, byVar, globalVars };
+}
+function impactedModules(index, input) {
+  const reasons = /* @__PURE__ */ new Map();
+  const add = (id, reason, indirect) => {
+    const r2 = reasons.get(id);
+    if (r2) {
+      if (!r2.reasons.includes(reason)) r2.reasons.push(reason);
+      r2.indirect &&= indirect;
+    } else reasons.set(id, { reasons: [reason], indirect });
+  };
+  const changedVars = new Set(input.vars ?? []);
+  for (const v2 of changedVars) for (const id of index.byVar[v2] ?? []) add(id, `uses ${v2}`, false);
+  for (const f of input.files ?? []) {
+    const id = componentForPath(f, index.componentsDir);
+    if (id && index.modules[id]) add(id, `file changed: ${norm(f)}`, false);
+  }
+  const renderedBy = /* @__PURE__ */ new Map();
+  for (const m2 of Object.values(index.modules)) for (const d of m2.imports) (renderedBy.get(d) ?? renderedBy.set(d, []).get(d)).push(m2.id);
+  const queue = [...reasons.keys()];
+  while (queue.length) {
+    const id = queue.shift();
+    for (const parent of renderedBy.get(id) ?? []) {
+      const known = reasons.has(parent);
+      add(parent, `renders ${id}`, true);
+      if (!known) queue.push(parent);
+    }
+  }
+  const globalHits = Object.entries(index.globalVars).map(([file, vs]) => ({ file, vars: vs.filter((v2) => changedVars.has(v2)) })).filter((g3) => g3.vars.length > 0);
+  const modules = [...reasons.entries()].map(([id, r2]) => ({ id, reasons: r2.reasons, indirect: r2.indirect })).sort((a, b) => Number(a.indirect) - Number(b.indirect) || a.id.localeCompare(b.id));
+  return { modules, globalHits };
+}
+function tokenUsage(tokens, reads) {
+  const readVars = /* @__PURE__ */ new Set();
+  for (const [v2, mods] of Object.entries(reads.byVar ?? {})) if (mods.length) readVars.add(v2);
+  for (const vars of Object.values(reads.globalVars ?? {})) for (const v2 of vars) readVars.add(v2);
+  const byPath = new Map(tokens.map((t3) => [t3.path, t3]));
+  const direct = new Set(tokens.filter((t3) => readVars.has(t3.cssVar)).map((t3) => t3.path));
+  const used = /* @__PURE__ */ new Set();
+  const queue = [...direct];
+  while (queue.length) {
+    const p2 = queue.pop();
+    if (used.has(p2)) continue;
+    used.add(p2);
+    for (const r2 of byPath.get(p2)?.refs ?? []) if (!used.has(r2) && byPath.has(r2)) queue.push(r2);
+  }
+  return { used, direct };
+}
+function gitHubHistoryBackend(client, config, opts = {}) {
+  const trees = /* @__PURE__ */ new Map();
+  const tree = (sha) => {
+    let t3 = trees.get(sha);
+    if (!t3) {
+      t3 = client.getCommitTree(sha).then((ts) => client.getTree(ts, true)).then((r2) => r2.entries);
+      trees.set(sha, t3);
+    }
+    return t3;
   };
   const root = config.tokens.root.replace(/\/$/, "");
   const prefix = root === "." || !root ? "" : `${root}/`;
@@ -1046,20 +1385,20 @@ function gitHubHistoryBackend(client, config, opts = {}) {
       const commits = [];
       for (let page = 1; commits.length < max && page <= 10; page++) {
         const batch = await client.listCommits({ sha: ref, path: paths[0], perPage: Math.min(100, max), page });
-        for (const c2 of batch) {
-          const [subject, ...rest] = c2.message.split("\n");
-          commits.push({ sha: c2.sha, parents: c2.parents, date: c2.date, author: c2.author, subject: subject ?? "", body: rest.join("\n").trim() });
+        for (const c10 of batch) {
+          const [subject, ...rest] = c10.message.split("\n");
+          commits.push({ sha: c10.sha, parents: c10.parents, date: c10.date, author: c10.author, subject: subject ?? "", body: rest.join("\n").trim() });
         }
         if (batch.length < Math.min(100, max)) break;
       }
       const list = commits.slice(0, max);
       const merges = /* @__PURE__ */ new Map();
-      const enriched = await pool(list, async (c2) => {
-        const prs = await client.listPullRequestsForCommit(c2.sha).catch(() => []);
+      const enriched = await pool(list, async (c10) => {
+        const prs = await client.listPullRequestsForCommit(c10.sha).catch(() => []);
         const pr = prs.find((p2) => p2.mergedAt && p2.baseRef === ref) ?? prs.find((p2) => p2.mergedAt);
-        if (!pr) return c2;
+        if (!pr) return c10;
         const prInfo = { number: pr.number, title: pr.title, url: pr.url, author: pr.author, ...pr.mergedAt ? { mergedAt: pr.mergedAt } : {}, body: pr.body };
-        if (pr.mergeCommitSha && pr.mergeCommitSha !== c2.sha) {
+        if (pr.mergeCommitSha && pr.mergeCommitSha !== c10.sha) {
           let m2 = merges.get(pr.mergeCommitSha);
           if (!m2) {
             m2 = client.getCommitInfo(pr.mergeCommitSha).then(
@@ -1074,7 +1413,7 @@ function gitHubHistoryBackend(client, config, opts = {}) {
           const merge = await m2;
           if (merge) return { ...merge, pr: prInfo };
         }
-        return { ...c2, ...pr.mergedAt ? { date: pr.mergedAt } : {}, pr: prInfo };
+        return { ...c10, ...pr.mergedAt ? { date: pr.mergedAt } : {}, pr: prInfo };
       });
       return enriched;
     },
@@ -1175,6 +1514,36 @@ function demoHistory(config, current) {
   });
   return { ...buildReport({ source: "demo", label: "Demo history (fixture data)", ref: "demo", entries, releases: DEMO_RELEASES, truncated: false }), demo: true };
 }
+async function branchPreviewUrls(gh, ref, config, opts = {}) {
+  const apps = config?.previews?.apps ?? {};
+  if (!Object.values(apps).some(Boolean)) return [];
+  let pr;
+  let branch = opts.branch;
+  let sha = opts.sha;
+  if (typeof ref === "number") {
+    pr = ref;
+    if (!branch || !sha) {
+      const p2 = await gh.getPullRequest(ref);
+      branch ??= p2.headRef;
+      sha ??= p2.headSha;
+    }
+  } else {
+    sha = ref;
+    if (!branch || !opts.comments) {
+      const open = (await gh.listPullRequestsForCommit(ref).catch(() => [])).find((p2) => p2.state === "open");
+      if (open) {
+        pr = open.number;
+        branch ??= open.headRef;
+      }
+    }
+  }
+  const [comments, statuses, deployments] = await Promise.all([
+    opts.comments ? Promise.resolve(opts.comments) : pr !== void 0 ? gh.listIssueComments(pr).catch(() => []) : Promise.resolve([]),
+    sha ? gh.listCommitStatuses(sha).catch(() => []) : Promise.resolve([]),
+    sha ? gh.listDeployments(sha).catch(() => []) : Promise.resolve([])
+  ]);
+  return resolveBranchPreviews(apps, { branch: branch ?? "", ...pr !== void 0 ? { pr } : {}, ...sha ? { sha } : {} }, { comments, statuses, deployments });
+}
 const STEPS = [50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 950];
 const LIGHTNESS = { 50: 0.975, 100: 0.952, 200: 0.912, 300: 0.85, 400: 0.735, 500: 0.63, 600: 0.53, 700: 0.445, 800: 0.36, 900: 0.27, 950: 0.205 };
 const BELL = { 50: 0.12, 100: 0.22, 200: 0.4, 300: 0.62, 400: 0.85, 500: 1, 600: 1, 700: 0.92, 800: 0.8, 900: 0.62, 950: 0.5 };
@@ -1196,16 +1565,16 @@ function oklchToLinear(L, C2, h3) {
   ];
 }
 const encode = (x) => {
-  const c2 = Math.min(1, Math.max(0, x));
-  return c2 <= 31308e-7 ? 12.92 * c2 : 1.055 * c2 ** (1 / 2.4) - 0.055;
+  const c10 = Math.min(1, Math.max(0, x));
+  return c10 <= 31308e-7 ? 12.92 * c10 : 1.055 * c10 ** (1 / 2.4) - 0.055;
 };
 const decode = (x) => x <= 0.04045 ? x / 12.92 : ((x + 0.055) / 1.055) ** 2.4;
 function oklch(L, C2, h3) {
-  let c2 = C2;
-  let lin = oklchToLinear(L, c2, h3);
+  let c10 = C2;
+  let lin = oklchToLinear(L, c10, h3);
   for (let i2 = 0; i2 < 60 && !lin.every((x) => x >= -5e-4 && x <= 1.0005); i2++) {
-    c2 *= 0.95;
-    lin = oklchToLinear(L, c2, h3);
+    c10 *= 0.95;
+    lin = oklchToLinear(L, c10, h3);
   }
   return lin.map(encode);
 }
@@ -1426,7 +1795,7 @@ function planNewBrand(source, input) {
   const doc = JSON.parse(templateText);
   const before = new LayeredTokenSet(config, files);
   const chain = before.resolve("color.action.primary.bg", before.normalizeCombo({ brand: template })).chain;
-  const actionStep = Number(/^palette\.primary\.(\d+)$/.exec(chain.find((c2) => /^palette\.primary\.\d+$/.test(c2)) ?? "")?.[1] ?? 600);
+  const actionStep = Number(/^palette\.primary\.(\d+)$/.exec(chain.find((c10) => /^palette\.primary\.\d+$/.test(c10)) ?? "")?.[1] ?? 600);
   const anchors = {};
   const safeRamp = (role, hue, kind, pin) => {
     try {
@@ -1576,10 +1945,10 @@ function planNewBrand(source, input) {
   }
   const pairs = parseContrastChecks(source.contrastText);
   const inGate = nextConfig.axes.brand?.values.includes(slug);
-  const combos = inGate ? after.combos(nextConfig.contrast?.modes).filter((c2) => c2.brand === slug) : [];
-  const results = combos.flatMap((c2) => pairs.map((p2) => checkLayeredPair(after, p2, c2)));
+  const combos = inGate ? after.combos(nextConfig.contrast?.modes).filter((c10) => c10.brand === slug) : [];
+  const results = combos.flatMap((c10) => pairs.map((p2) => checkLayeredPair(after, p2, c10)));
   const failing = results.filter((r2) => !r2.pass);
-  const themes = [...new Set(combos.map((c2) => c2.theme).filter((t3) => !!t3))];
+  const themes = [...new Set(combos.map((c10) => c10.theme).filter((t3) => !!t3))];
   const ramps = {};
   if (inGate) {
     const combo = after.normalizeCombo({ brand: slug });
@@ -1653,10 +2022,10 @@ function newBrandSection(plan) {
     `| --- | ${roles.map(() => "---").join(" | ")} |`,
     ...STEPS.map((s) => `| ${s}${s === plan.actionStep ? " (actions)" : ""} | ${roles.map((r2) => code(plan.ramps[r2].find((x) => x.step === s)?.hex ?? "")).join(" | ")} |`)
   ].join("\n") : "_No ramps resolved._";
-  const c2 = plan.contrast;
-  const contrastLine = c2.failing.length ? `**${c2.failing.length} of ${c2.checks} pairs fail** for ${plan.name} (${c2.themes.join(" and ")}).` : `All ${c2.checks} contrast checks pass for ${plan.name} in ${c2.themes.join(" and ")}.`;
-  const failRows = c2.failing.slice(0, 20).map((r2) => `| ${code(r2.fg)} on ${code(r2.bg)} | ${r2.modes.split(",").find((m2) => m2.startsWith("theme="))?.slice(6) ?? r2.modes} | ${r2.ratio ?? "n/a"} | ${r2.min} |`);
-  const tightest = [...c2.results].filter((r2) => r2.pass && r2.ratio !== null).sort((a, b) => a.ratio - a.min - (b.ratio - b.min)).slice(0, 3);
+  const c10 = plan.contrast;
+  const contrastLine = c10.failing.length ? `**${c10.failing.length} of ${c10.checks} pairs fail** for ${plan.name} (${c10.themes.join(" and ")}).` : `All ${c10.checks} contrast checks pass for ${plan.name} in ${c10.themes.join(" and ")}.`;
+  const failRows = c10.failing.slice(0, 20).map((r2) => `| ${code(r2.fg)} on ${code(r2.bg)} | ${r2.modes.split(",").find((m2) => m2.startsWith("theme="))?.slice(6) ?? r2.modes} | ${r2.ratio ?? "n/a"} | ${r2.min} |`);
+  const tightest = [...c10.results].filter((r2) => r2.pass && r2.ratio !== null).sort((a, b) => a.ratio - a.min - (b.ratio - b.min)).slice(0, 3);
   return [
     "## New brand",
     "",
@@ -1756,7 +2125,7 @@ function missingProse(d) {
 function prefillDocs(input) {
   const existing = input.existing ?? null;
   const anatomy = {};
-  for (const c2 of input.cssClasses) anatomy[c2] = existing?.anatomy?.[c2] ?? anatomyLabel(c2);
+  for (const c10 of input.cssClasses) anatomy[c10] = existing?.anatomy?.[c10] ?? anatomyLabel(c10);
   const contrastNotes = (input.contrast ?? []).slice().sort((a, b) => a.ratio - b.ratio).map((p2) => `${p2.foreground} on ${p2.background}: ${p2.ratio.toFixed(2)}:1 at worst over every brand and theme, needs ${p2.min}:1 (${p2.ratio >= p2.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.`;
@@ -1773,6 +2142,7 @@ function prefillDocs(input) {
     contentGuidelines: existing?.contentGuidelines ?? [],
     anatomy,
     ...existing?.draftedBy ? { draftedBy: existing.draftedBy } : {},
+    ...existing?.draftedSections?.length ? { draftedSections: existing.draftedSections } : {},
     ...existing?.needsReview !== void 0 ? { needsReview: existing.needsReview } : {}
   };
   return {
@@ -1787,7 +2157,17 @@ function prefillDocs(input) {
     draft
   };
 }
-function docsPrompt(prefill, conventions = {}) {
+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((k3) => SECTION_SHAPE[k3]).join(", ")} }`;
+function docsPrompt(prefill, conventions = {}, options = {}) {
   const facts = [
     `Component: ${prefill.component}`,
     prefill.propsTable ? `Props (parsed from TypeScript):
@@ -1802,15 +2182,33 @@ ${prefill.propsTable}` : "Props: none of its own.",
   const block = (title, text) => text?.trim() ? `<${title}>
 ${text.trim()}
 </${title}>` : "";
+  const keys = options.keys;
+  const check = keys ? (options.check ?? []).filter((k3) => keys.includes(k3)) : [];
+  const write = keys ? keys.filter((k3) => !check.includes(k3)) : [];
+  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 [
-    `Write the missing prose of ${prefill.component}.docs.json for the Bridge design system.`,
+    ...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.',
-    `- 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.",
+    ...shape,
     "",
     "Facts computed from the code:",
     facts.join("\n\n"),
@@ -1819,20 +2217,32 @@ ${text.trim()}
 ${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, i2, all) => x !== "" || all[i2 - 1] !== "").join("\n");
 }
-function markClaudeDraft(d) {
-  return { ...d, draftedBy: "claude", needsReview: true };
+function markClaudeDraft(d, sections) {
+  if (!sections) {
+    const { draftedSections: _all, ...rest } = d;
+    return { ...rest, draftedBy: "claude", needsReview: true };
+  }
+  const waiting = d.needsReview === true ? d.draftedSections ?? (d.draftedBy ? [...PROSE_KEYS] : []) : [];
+  const union = PROSE_KEYS.filter((k3) => waiting.includes(k3) || sections.includes(k3));
+  return { ...d, draftedBy: "claude", needsReview: true, draftedSections: union };
+}
+function sectionsNeedingReview(d) {
+  if (!d || d.needsReview !== true) return [];
+  return d.draftedSections ? PROSE_KEYS.filter((k3) => d.draftedSections.includes(k3)) : [...PROSE_KEYS];
 }
 const needsDocsReview = (d) => Boolean(d && d.needsReview === true);
 function acceptDocsDraft(d) {
-  return { ...d, needsReview: false };
+  const { draftedSections: _done, ...rest } = d;
+  return { ...rest, needsReview: false };
 }
 function formatDocsJson(d) {
-  const order = ["summary", "category", "status", ...DOCS_KEYS.filter((k3) => k3 !== "summary"), "draftedBy", "needsReview"];
+  const order = ["summary", "category", "status", ...DOCS_KEYS.filter((k3) => k3 !== "summary"), "draftedBy", "draftedSections", "needsReview"];
   const out = {};
   for (const k3 of order) if (d[k3] !== void 0) out[k3] = d[k3];
   for (const [k3, v2] of Object.entries(d)) if (!(k3 in out) && v2 !== void 0) out[k3] = v2;
@@ -1867,6 +2277,416 @@ 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 = (n2, word, many = `${word}s`) => `${n2} ${n2 === 1 ? word : many}`;
+const capital = (s) => s.charAt(0).toUpperCase() + s.slice(1);
+const lower = (s) => s.charAt(0).toLowerCase() + s.slice(1);
+function propShape(s) {
+  if (!s) return void 0;
+  const m2 = /^(.*?), default (.*)$/.exec(s);
+  return m2 ? { type: m2[1], def: m2[2] } : { type: s, def: "" };
+}
+const VARIANT_FIRST = ["variant", "tone", "intent", "appearance", "kind", "type", "style"];
+function shortVariant(key) {
+  const pairs = key.split(", ").map((p2) => {
+    const at2 = p2.indexOf("=");
+    return at2 < 0 ? { k: "", v: p2.trim() } : { k: p2.slice(0, at2).trim(), v: p2.slice(at2 + 1).trim() };
+  });
+  const kept = pairs.filter((p2) => p2.v && !/^default$/i.test(p2.v));
+  if (!kept.length) return key;
+  const rank = (k3) => {
+    const i2 = VARIANT_FIRST.indexOf(k3.toLowerCase());
+    return i2 < 0 ? VARIANT_FIRST.length : i2;
+  };
+  return kept.map((p2, i2) => ({ ...p2, i: i2 })).sort((a, b) => rank(a.k) - rank(b.k) || a.i - b.i).map((p2) => p2.v).join(" ");
+}
+const shortVariants = (list) => list ? andList(list.split("; ").map(shortVariant)) : "every variant";
+function parseStructureChange(c10) {
+  const m2 = /^(New|Removed|Moved) layer "(.*)"(?: \((.*)\))?$/.exec(c10.field);
+  if (!m2) return void 0;
+  const op = m2[1] === "New" ? "added" : m2[1] === "Removed" ? "removed" : "moved";
+  const where = `in ${shortVariants(m2[3])}`;
+  if (op === "moved") return { op, name: m2[2], where, at: c10.after, from: c10.before };
+  const shape = (op === "added" ? c10.after : c10.before) ?? "";
+  const sm = /^(\S+)(?: (.*?))?, ((?:after|before) ".*"|alone)$/.exec(shape);
+  return { op, name: m2[2], where, ...sm ? { type: sm[1], ...sm[2] ? { main: sm[2] } : {}, at: sm[3] } : {} };
+}
+function structurePhrase(r2) {
+  const type = r2.type ? `${r2.type} ` : "";
+  const main = r2.main ? ` (${r2.main})` : "";
+  const at2 = r2.at && r2.at !== "alone" ? ` ${r2.at}` : "";
+  if (r2.op === "added") return `New ${type}layer "${r2.name}"${main}${at2} ${r2.where}`;
+  if (r2.op === "removed") return `Removed ${type}layer "${r2.name}"${main}${at2} ${r2.where}`;
+  return `Moved layer "${r2.name}" ${r2.at ?? ""}${r2.from ? ` (was ${r2.from})` : ""} ${r2.where}`.replace(/\s+/g, " ");
+}
+const bare = (at2) => (at2 ?? "").replace(/"/g, "");
+function firstChange(component, kind, c10, 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 (!c10) return { title: `Update the ${component} variants`, summary: `The variants of ${component} changed in Figma.` };
+      const axis = c10.field.replace(/^Variant /, "");
+      const before = values(c10.before);
+      const after = values(c10.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 (!c10) return { title: `Change a ${component} prop`, summary: `A prop of ${component} changed in Figma.` };
+      const name = c10.field.replace(/^Prop /, "");
+      const b = propShape(c10.before);
+      const a = propShape(c10.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 ${c10.before ?? "none"} to ${c10.after ?? "none"}.` };
+    }
+    case "token-binding": {
+      if (!c10) return { title: "Use another token", summary: `A part of ${component} uses another token in Figma.` };
+      const m2 = /^(.*?)(?: \((.*)\))?$/.exec(c10.field);
+      const part = lower(m2[1]);
+      const where = m2[2] ? ` in ${m2[2]}` : "";
+      const after = c10.after && c10.after !== "none" ? c10.after : "";
+      const before = c10.before && c10.before !== "none" ? c10.before : "";
+      if (!after) return { title: `Unbind the ${part}`, summary: `The ${part} of ${component}${where} no longer uses ${before || "a token"}.` };
+      return {
+        title: `Use ${after} for the ${part}`,
+        summary: `The ${part} of ${component}${where} ${before ? `moves from ${before} to ${after}` : `now uses ${after}`}.`
+      };
+    }
+    case "structure": {
+      const r2 = c10 ? parseStructureChange(c10) : void 0;
+      if (!r2) return { title: "Change the layers to match Figma", summary: `The layers of ${component} changed in Figma.` };
+      if (r2.op === "added") {
+        const at2 = r2.at && r2.at !== "alone" ? ` ${bare(r2.at)}` : "";
+        return { title: `Add a layer${at2}`, summary: `${component} gets ${article(r2.type ?? "layer")} ${r2.type ?? "layer"}${r2.type ? " layer" : ""}, ${r2.name}${r2.main ? ` (${r2.main})` : ""}${at2} ${r2.where}.` };
+      }
+      if (r2.op === "removed") return { title: `Remove the ${r2.name} layer`, summary: `${component} no longer has the ${r2.name} layer ${r2.where}.` };
+      return { title: `Move the ${r2.name} layer`, summary: `The ${r2.name} layer of ${component} moves ${bare(r2.at) || "elsewhere"}${r2.from ? ` (it was ${bare(r2.from)})` : ""} ${r2.where}.` };
+    }
+    case "visual":
+      return {
+        title: "Update the look to match Figma",
+        summary: `${component} looks different in Figma${c10?.field.startsWith("Look of ") && c10.field !== "Look of every variant" ? ` in ${c10.field.slice(8)}` : ""}, and no variable edit explains it.`
+      };
+    default:
+      return { title: "", summary: "" };
+  }
+}
+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 t3 = text.replace(/\s+/g, " ").trim().replace(/\.$/, "");
+  if (t3.length <= max) return t3;
+  const cut = t3.slice(0, max + 1);
+  const at2 = cut.lastIndexOf(" ");
+  return (at2 > max * 0.5 ? cut.slice(0, at2) : t3.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 changePhrase(c10) {
+  let m2;
+  if (m2 = /^Variant (.+)$/.exec(c10.field)) {
+    const axis = m2[1];
+    const before2 = values(c10.before);
+    const after2 = values(c10.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 (m2 = /^Prop (.+)$/.exec(c10.field)) {
+    const name = m2[1];
+    const b = propShape(c10.before);
+    const a = propShape(c10.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 ${c10.before ?? "none"} to ${c10.after ?? "none"}`;
+  }
+  if (m2 = /^Swapped instance(?: \((.*)\))?$/.exec(c10.field)) return `Shows ${c10.after ?? "another instance"} instead of ${c10.before ?? "the coded one"} ${m2[1] ? `in ${m2[1]}` : "in every variant"}`;
+  if (m2 = /^Look of (.+)$/.exec(c10.field)) return `Looks different in ${m2[1]}; no variable explains it`;
+  const layer = parseStructureChange(c10);
+  if (layer) return structurePhrase(layer);
+  m2 = /^(.*?)(?: \((.*)\))?$/.exec(c10.field);
+  const where = m2[2] ? ` in ${m2[2]}` : "";
+  const before = c10.before && c10.before !== "none" ? c10.before : "";
+  const after = c10.after && c10.after !== "none" ? c10.after : "";
+  if (!after) return `${m2[1]} no longer uses ${before || "a token"}${where}`;
+  if (!before) return `${m2[1]} now uses ${after}${where}`;
+  return `${m2[1]} uses ${after} instead of ${before}${where}`;
+}
+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;
+}
+const tokenOf = (e3) => e3.figma ?? e3.head ?? e3.base;
+const pathOf = (e3) => tokenOf(e3)?.path ?? e3.path;
+function pushChangeRows(entries) {
+  return entries.map((e3) => {
+    const before = e3.head ?? e3.base;
+    const after = e3.figma;
+    const show = (t3) => {
+      if (!t3) return void 0;
+      const modes = Object.keys(t3.values);
+      if (modes.length <= 1) return formatValue(t3.type, t3.values[modes[0] ?? ""]);
+      return modes.map((m2) => `${modeDisplayName(m2)} ${formatValue(t3.type, t3.values[m2])}`).join("; ");
+    };
+    const renamed = e3.local?.kind === "renamed" && before && after && before.path !== after.path;
+    return { field: renamed ? `${before.path} -> ${after.path}` : pathOf(e3), before: show(before), after: show(after) };
+  });
+}
+function names(paths) {
+  if (paths.length <= 3) return andList(paths);
+  return `${paths.length} tokens, including ${andList(paths.slice(0, 2))}`;
+}
+function valueModes(e3) {
+  return (e3.local?.fields ?? []).filter((f) => f.field === "value" && f.mode && f.mode !== "value").map((f) => modeDisplayName(f.mode));
+}
+function draftPushDescription(entries, components = []) {
+  const by2 = { changed: [], added: [], renamed: [], removed: [] };
+  for (const e3 of entries) by2[e3.local?.kind ?? "changed"].push(e3);
+  const clauses = [];
+  if (by2.changed.length) {
+    const only = by2.changed.length === 1 ? by2.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(by2.changed.map(pathOf))}`);
+  }
+  if (by2.added.length) clauses.push(`adds ${names(by2.added.map(pathOf))}`);
+  if (by2.renamed.length) {
+    const r2 = by2.renamed[0];
+    const from = (r2.head ?? r2.base)?.path;
+    clauses.push(by2.renamed.length === 1 && from && from !== pathOf(r2) ? `renames ${from} to ${pathOf(r2)}` : `renames ${names(by2.renamed.map(pathOf))}`);
+  }
+  if (by2.removed.length) clauses.push(`removes ${names(by2.removed.map(pathOf))}`);
+  const sentences2 = [];
+  if (clauses.length) sentences2.push(`${capital(andList(clauses))}.`);
+  const fresh = components.filter((c10) => c10.kind === "new-component").map((c10) => c10.component);
+  const changed = [...new Set(components.filter((c10) => c10.kind !== "new-component").map((c10) => c10.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) sentences2.push(`Requests ${andList(comp)}.`);
+  return cleanDraftText(sentences2.join(" "));
+}
+const DOCS_DRAFT_MODEL = "claude-sonnet-5-5";
+const ANTHROPIC_MESSAGES_URL = "https://api.anthropic.com/v1/messages";
+const DOCS_SELECTION_MODES = {
+  clearer: "Make it clearer: plain words, one idea per sentence, the most useful fact first.",
+  shorter: "Make it shorter: keep every fact, drop filler, aim for half the words or fewer.",
+  voice: "Put it in the Bridge voice: sentence case, verbs first, calm and precise, no marketing words, no em dash."
+};
+const isDocsSelectionMode = (m2) => typeof m2 === "string" && m2 in DOCS_SELECTION_MODES;
+const isProseKey = (k3) => typeof k3 === "string" && PROSE_KEYS.includes(k3);
+function validateDocsTask(x) {
+  if (!x || typeof x !== "object") return ["The docs task is missing."];
+  const t3 = x;
+  if (t3.kind === "sections") {
+    const keys = t3.keys;
+    if (!Array.isArray(keys) || !keys.length || !keys.every(isProseKey)) return [`The docs task lists no sections: use ${PROSE_KEYS.join(", ")}.`];
+    if (t3.check !== void 0 && (!Array.isArray(t3.check) || !t3.check.every(isProseKey))) return ["check must list prose sections."];
+    return [];
+  }
+  if (t3.kind === "selection") {
+    const out = [];
+    if (!isProseKey(t3.key)) out.push(`The selection needs a section: ${PROSE_KEYS.join(", ")}.`);
+    if (typeof t3.text !== "string" || !t3.text.trim()) out.push("The selection has no text.");
+    if (!isDocsSelectionMode(t3.mode)) out.push("The selection mode must be clearer, shorter or voice.");
+    return out;
+  }
+  return ['The docs task kind must be "sections" or "selection".'];
+}
+const docsTaskKeys = (t3) => t3.kind === "sections" ? t3.keys : [t3.key];
+function docsSelectionPrompt(prefill, conventions, sel) {
+  const base = docsPrompt(prefill, conventions, { keys: [sel.key] });
+  const facts = base.slice(base.indexOf("Facts computed from the code:"));
+  return [
+    `Rewrite one passage of the "${sel.key}" section of ${prefill.component}.docs.json for the Bridge design system.`,
+    DOCS_SELECTION_MODES[sel.mode],
+    "",
+    "Rules:",
+    "- Keep its meaning and every fact that the code supports. Never add props, variants, keyboard behavior or tokens that are not in the facts or the source below.",
+    "- Bridge voice: sentence case, plain words, verbs first, no em dashes, no marketing words, no Markdown.",
+    "- Rewrite only the passage: it is pasted back in place of the selection, inside the rest of the section.",
+    '- Answer with one JSON object, nothing else: { "replacement": "the rewritten passage" }.',
+    "",
+    `<passage>
+${sel.text.trim()}
+</passage>`,
+    "",
+    facts
+  ].join("\n");
+}
+function docsTaskPrompt(prefill, conventions, task) {
+  if (task.kind === "selection") return docsSelectionPrompt(prefill, conventions, task);
+  return docsPrompt(prefill, conventions, { keys: task.keys, ...task.rewrite ? { rewrite: true } : {}, ...task.check?.length ? { check: task.check } : {} });
+}
+function parseDocsReply(text) {
+  const fenced = /```(?:json)?\s*([\s\S]*?)```/i.exec(text);
+  const body = fenced ? fenced[1] : text;
+  const start = body.indexOf("{");
+  const end = body.lastIndexOf("}");
+  if (start < 0 || end <= start) throw new Error("The reply holds no JSON object.");
+  const json = JSON.parse(body.slice(start, end + 1));
+  if (!json || typeof json !== "object" || Array.isArray(json)) throw new Error("The reply is not a docs.json object.");
+  return json;
+}
+const cleanDocsText = (s) => cleanDraftText(s.replace(/[\r\n]+/g, " "));
+const isExample = (x) => {
+  if (typeof x === "string") return true;
+  if (!x || typeof x !== "object" || Array.isArray(x)) return false;
+  const n2 = x;
+  if (typeof n2.c !== "string" || !n2.c) return false;
+  if (n2.p !== void 0 && (!n2.p || typeof n2.p !== "object" || Array.isArray(n2.p))) return false;
+  return n2.children === void 0 || Array.isArray(n2.children) && n2.children.every(isExample);
+};
+const textList = (x) => {
+  if (typeof x === "string") x = [x];
+  if (!Array.isArray(x)) return void 0;
+  const out = x.filter((s) => typeof s === "string").map(cleanDocsText).filter(Boolean);
+  return out.length ? out : void 0;
+};
+const guidanceList = (x, examples) => {
+  if (!Array.isArray(x)) return void 0;
+  const out = [];
+  for (const g3 of x) {
+    if (!g3 || typeof g3 !== "object") continue;
+    const r2 = g3;
+    const title = typeof r2.title === "string" ? cleanDocsText(r2.title) : "";
+    const text = typeof r2.text === "string" ? cleanDocsText(r2.text) : "";
+    if (!title || !text) continue;
+    out.push({ title, text, ...examples && r2.example !== void 0 && isExample(r2.example) ? { example: r2.example } : {} });
+  }
+  return out.length ? out : void 0;
+};
+function sanitizeDocsSections(raw, keys = PROSE_KEYS, opts = {}) {
+  const out = {};
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) return out;
+  const r2 = raw;
+  for (const k3 of keys) {
+    const v2 = r2[k3];
+    if (k3 === "summary") {
+      const s = typeof v2 === "string" ? cleanDocsText(v2) : "";
+      if (s) out.summary = s;
+    } else if (k3 === "dos" || k3 === "donts") {
+      const g3 = guidanceList(v2, opts.examples ?? false);
+      if (g3) out[k3] = g3;
+    } else {
+      const l2 = textList(v2);
+      if (l2) out[k3] = l2;
+    }
+  }
+  return out;
+}
+function sanitizeDocsReplacement(raw) {
+  if (typeof raw !== "string") return "";
+  return cleanDocsText(raw.trim().replace(/^["'“]+|["'”]+$/g, ""));
+}
+function parseDocsTaskAnswer(task, text) {
+  if (task.kind === "selection") {
+    let raw = text;
+    try {
+      const json = parseDocsReply(text);
+      raw = json.replacement ?? json.text ?? json[task.key];
+    } catch {
+      raw = text.replace(/```[a-z]*\s*|```/gi, "");
+    }
+    const replacement = sanitizeDocsReplacement(raw);
+    if (!replacement) throw new Error("Claude sent no rewritten passage. Try again.");
+    return { sections: {}, replacement };
+  }
+  return docsSectionsAnswer(task, parseDocsReply(text));
+}
+function docsSectionsAnswer(task, raw) {
+  const check = (task.check ?? []).filter((k3) => task.keys.includes(k3));
+  const sections = check.length ? sanitizeDocsSections(raw, task.keys) : docsSectionsResult(task, raw);
+  return { sections, checked: check.filter((k3) => sections[k3] === void 0) };
+}
+function docsSectionsResult(task, raw) {
+  const sections = sanitizeDocsSections(raw, task.keys);
+  if (!Object.keys(sections).length) throw new Error(`Claude's answer holds none of the sections asked for (${task.keys.join(", ")}). Try again.`);
+  return sections;
+}
+function applyDocsSections(docs, sections) {
+  const keys = PROSE_KEYS.filter((k3) => sections[k3] !== void 0);
+  if (!keys.length) return docs;
+  return markClaudeDraft({ ...docs, ...sections }, keys);
+}
+function mergeDocsDraft(prefillDraft, reply) {
+  const empty = PROSE_KEYS.filter((k3) => {
+    const v2 = prefillDraft[k3];
+    return v2 === void 0 || (typeof v2 === "string" ? !v2.trim() : Array.isArray(v2) && !v2.length);
+  });
+  const sections = sanitizeDocsSections(reply, empty, { examples: true });
+  const merged = { ...prefillDraft, ...sections };
+  if (reply.preview && !prefillDraft.preview && isExample(reply.preview)) merged.preview = reply.preview;
+  merged.anatomy = prefillDraft.anatomy;
+  const drafted = PROSE_KEYS.filter((k3) => sections[k3] !== void 0);
+  return markClaudeDraft(merged, drafted.length && drafted.length < PROSE_KEYS.length ? drafted : void 0);
+}
+function anthropicRequest(input) {
+  const headers = { "x-api-key": input.apiKey, "anthropic-version": "2023-06-01", "content-type": "application/json" };
+  if (input.fallback) headers["anthropic-beta"] = "server-side-fallback-2026-07-01";
+  if (input.browser) headers["anthropic-dangerous-direct-browser-access"] = "true";
+  const body = {
+    model: input.model || DOCS_DRAFT_MODEL,
+    max_tokens: input.maxTokens ?? 16e3,
+    ...input.fallback ? { fallbacks: "default" } : {},
+    ...input.system ? { system: input.system } : {},
+    messages: [{ role: "user", content: input.prompt }]
+  };
+  return { url: ANTHROPIC_MESSAGES_URL, init: { method: "POST", headers, body: JSON.stringify(body) } };
+}
+function anthropicReplyText(msg) {
+  const m2 = msg ?? {};
+  if (m2.stop_reason === "refusal") throw new Error("Claude declined to draft this one.");
+  if (m2.stop_reason === "max_tokens") throw new Error("The reply was cut off (max_tokens).");
+  return (m2.content ?? []).filter((b) => b?.type === "text" && typeof b.text === "string").map((b) => b.text).join("");
+}
 const EXPLORATION_LABEL = "exploration";
 const EXPLORATION_PREFIX = "explore/";
 const EXPLORATION_NOTES_DIR = ".bridge/explorations";
@@ -1925,16 +2745,6 @@ function explorationNote(e3) {
     ""
   ].join("\n");
 }
-function explorationInstall(input) {
-  const packages = input.packages.map((name) => ({ name, url: snapshotUrl(input.owner, input.repo, name, input.pr) }));
-  const named = (list) => installCommand(list.map((p2) => `${p2.name}@${p2.url}`));
-  const out = { command: named(packages), packages };
-  if (input.sha) {
-    const tarballs = input.packages.map((name) => ({ name, url: tarballUrl(input.owner, input.repo, input.pr, name, input.sha) }));
-    out.fallback = { command: named(tarballs), packages: tarballs, release: `https://github.com/${input.owner}/${input.repo}/releases/tag/preview-pr-${input.pr}` };
-  }
-  return out;
-}
 function explorationPrTitle(e3) {
   const n2 = e3.name.trim().replace(/\.$/, "");
   return `Exploration: ${n2.charAt(0).toLowerCase()}${n2.slice(1)}`;
@@ -1960,20 +2770,9 @@ function explorationPrBody(e3, ctx) {
     "### Try it in a product staging branch",
     ""
   ];
-  if (ctx.pr) {
-    const install = explorationInstall({ owner: ctx.owner, repo: ctx.repo, pr: ctx.pr, packages: ctx.packages });
-    lines.push(
-      "In the product repo, on a branch that deploys to staging (production keeps the released version):",
-      "",
-      "```sh",
-      install.command,
-      "```",
-      "",
-      `The snapshots follow the latest commit of this pull request. The "Try this DS branch in your product" comment lists the exact commit, and the tarball URLs from the [\`preview-pr-${ctx.pr}\` prerelease](https://github.com/${ctx.owner}/${ctx.repo}/releases/tag/preview-pr-${ctx.pr}) when pkg.pr.new is not set up.`
-    );
-  } else {
-    lines.push('The install command appears here and in the "Try this DS branch in your product" comment once the first snapshot is published.');
-  }
+  lines.push(
+    '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 = previewLinks(ctx.apps, { branch, ...ctx.pr ? { pr: ctx.pr } : {} });
   if (links.length) lines.push("| App | Preview |", "| --- | --- |", ...links.map((l2) => `| ${l2.label} | ${l2.url} |`));
@@ -2043,6 +2842,19 @@ function promotionPlan(input) {
     markReady: true
   };
 }
+function explorationTryIt(input) {
+  const c10 = readPreviewComment(input.comment);
+  if (!c10) return { state: "building" };
+  if (input.headSha && c10.sha7 && !input.headSha.startsWith(c10.sha7)) return { state: "building" };
+  if (!c10.command || c10.source === "none") return { state: "failed" };
+  return { state: "ready", command: c10.command, source: c10.source, sha7: c10.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((p2) => `${p2.label} ${p2.url}`);
+  return [head, previews.length ? `Previews: ${previews.join(", ")}.` : "", `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.`,
@@ -2053,7 +2865,8 @@ function explorationRules(branch) {
 const REQUEST_KINDS = [
   { value: "new-component", label: "New component", hint: "A component the design system does not have yet." },
   { value: "new-variant", label: "New variant", hint: "A size, tone or state the component does not have yet." },
-  { value: "prop-change", label: "Prop change", hint: "Add, rename or change a prop or its default." },
+  { value: "prop-change", label: "Option change (prop)", hint: "Add, rename or change an option (a prop in code) or its default." },
+  { value: "structure", label: "Structure change", hint: "A part was added, removed or moved." },
   { value: "visual", label: "Visual change", hint: "Spacing, radius, layout or icon placement." },
   { value: "token-binding", label: "Token change", hint: "The component should paint with another token." },
   { value: "bug", label: "Bug", hint: "It looks or behaves differently from the guidance." },
@@ -2068,13 +2881,14 @@ function requestIssueTitle(r2) {
   return `${r2.component}: ${t3.charAt(0).toLowerCase()}${t3.slice(1)}`;
 }
 function composeRequestIssue(r2, opts = {}) {
-  const rows = r2.changes.length ? ["| What | Now | Requested |", "| --- | --- | --- |", ...r2.changes.map((c2) => `| ${cell(c2.field)} | ${cell(c2.before ?? "")} | ${cell(c2.after ?? "")} |`)] : [];
+  const rows = r2.changes.length ? ["| What | Now | Requested |", "| --- | --- | --- |", ...r2.changes.map((c10) => `| ${cell(c10.field)} | ${cell(c10.before ?? "")} | ${cell(c10.after ?? "")} |`)] : [];
   const figma = r2.figma?.url ? `[${r2.figma.nodeName ?? "Open in Figma"}](${r2.figma.url})` : r2.figma?.nodeName ? r2.figma.nodeName : "";
   const body = [
     r2.kind === "new-component" ? `## New component request: ${r2.component}` : `## ${kindLabel(r2.kind)} request for ${r2.component}`,
     "",
     r2.summary.trim(),
     "",
+    ...r2.line?.trim() ? [`**What changes:** ${r2.line.trim()}`, ""] : [],
     ...rows.length ? [...rows, ""] : [],
     ...r2.images?.length ? [...r2.images.map((u2, i2) => `![${r2.component} design ${i2 + 1}](${u2})`), ""] : [],
     ...figma ? [`**Design:** ${figma}`, ""] : [],
@@ -2102,6 +2916,32 @@ function parseRequestIssue(body) {
     return void 0;
   }
 }
+function withRequestExploration(body, branch) {
+  const r2 = parseRequestIssue(body);
+  if (!r2 || !body) return void 0;
+  const block = new RegExp(`<!-- ${MARK} \\{[\\s\\S]*?\\} -->`);
+  let out = body.replace(block, () => `<!-- ${MARK} ${JSON.stringify({ ...r2, exploration: branch })} -->`);
+  const line = `**Exploration:** \`${branch}\`. Implement it on that branch, not in a pull request to main: it ships to product staging as a snapshot and is promoted to review only when the idea is validated.`;
+  if (/^\*\*Exploration:\*\* .*$/m.test(out)) out = out.replace(/^\*\*Exploration:\*\* .*$/m, () => line);
+  else if (out.includes("\n## How to implement")) out = out.replace("\n## How to implement", () => `
+${line}
+
+## How to implement`);
+  else out = out.replace(block, (m2) => `${line}
+
+${m2}`);
+  return out;
+}
+function declineReasonProblems(reason) {
+  const r2 = reason.trim();
+  if (!r2) return ["Say why, in one or two sentences: the requester reads it."];
+  if (r2.length < 10) return ["Say a bit more, so the requester knows why: at least 10 characters."];
+  return [];
+}
+function declineComment(reason, by2) {
+  const quote = reason.trim().split("\n").map((l2) => `> ${l2}`.trimEnd()).join("\n");
+  return [`Declined${by2 ? ` by @${by2.replace(/^@/, "")}` : ""} in Bridge Studio.`, "", quote, "", "<sub>Closed as not planned. Reopen the issue if things change.</sub>"].join("\n");
+}
 function requestStatus(issue) {
   const prs = issue.linkedPrs ?? [];
   if (issue.state === "open") return prs.some((p2) => p2.state === "open") ? "in-progress" : "requested";
@@ -2127,10 +2967,11 @@ function requestBrief(r2, ctx) {
     `Component: ${r2.component}`,
     `Kind: ${kindLabel(r2.kind)}`,
     `Request: ${r2.title}`,
+    ...r2.line?.trim() ? [`What changes: ${r2.line.trim()}`] : [],
     "",
     r2.summary.trim(),
     "",
-    ...r2.changes.length ? ["Changes asked:", ...r2.changes.map((c2) => `- ${c2.field}: ${c2.before ?? "(none)"} -> ${c2.after ?? "(removed)"}`), ""] : [],
+    ...r2.changes.length ? ["Changes asked:", ...r2.changes.map((c10) => `- ${c10.field}: ${c10.before ?? "(none)"} -> ${c10.after ?? "(removed)"}`), ""] : [],
     ...r2.figma?.url ? [`Design: ${r2.figma.url}`, ""] : [],
     ...r2.images?.length ? ["Images:", ...r2.images.map((u2) => `- ${u2}`), ""] : [],
     ...ctx.files?.length ? ["Files of this component:", ...ctx.files.map((f) => `- ${f}`), ""] : [],
@@ -2152,7 +2993,7 @@ function validateIntegrations(i2) {
 }
 function jiraIssueFields(r2, jira, issueUrl) {
   const text = (t3) => ({ type: "text", text: t3 });
-  const para = (...c2) => ({ type: "paragraph", content: c2 });
+  const para = (...c10) => ({ type: "paragraph", content: c10 });
   return {
     project: { key: jira.project },
     issuetype: { name: jira.issueType ?? "Task" },
@@ -2163,145 +3004,13 @@ function jiraIssueFields(r2, jira, issueUrl) {
       version: 1,
       content: [
         para(text(r2.summary.trim() || r2.title)),
-        ...r2.changes.map((c2) => para(text(`${c2.field}: ${c2.before ?? "(none)"} -> ${c2.after ?? "(removed)"}`))),
+        ...r2.line?.trim() ? [para(text(r2.line.trim()))] : [],
+        ...r2.changes.map((c10) => para(text(`${c10.field}: ${c10.before ?? "(none)"} -> ${c10.after ?? "(removed)"}`))),
         para({ type: "text", text: "GitHub request", marks: [{ type: "link", attrs: { href: issueUrl } }] })
       ]
     }
   };
 }
-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 = (n2, word, many = `${word}s`) => `${n2} ${n2 === 1 ? word : many}`;
-const capital = (s) => s.charAt(0).toUpperCase() + s.slice(1);
-const lower = (s) => s.charAt(0).toLowerCase() + s.slice(1);
-function propShape(s) {
-  if (!s) return void 0;
-  const m2 = /^(.*?), default (.*)$/.exec(s);
-  return m2 ? { type: m2[1], def: m2[2] } : { type: s, def: "" };
-}
-function firstChange(component, kind, c2, 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 (!c2) return { title: `Update the ${component} variants`, summary: `The variants of ${component} changed in Figma.` };
-      const axis = c2.field.replace(/^Variant /, "");
-      const before = values(c2.before);
-      const after = values(c2.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 (!c2) return { title: `Change a ${component} prop`, summary: `A prop of ${component} changed in Figma.` };
-      const name = c2.field.replace(/^Prop /, "");
-      const b = propShape(c2.before);
-      const a = propShape(c2.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 ${c2.before ?? "none"} to ${c2.after ?? "none"}.` };
-    }
-    case "token-binding": {
-      if (!c2) return { title: "Use another token", summary: `A part of ${component} uses another token in Figma.` };
-      const m2 = /^(.*?)(?: \((.*)\))?$/.exec(c2.field);
-      const part = lower(m2[1]);
-      const where = m2[2] ? ` in ${m2[2]}` : "";
-      const after = c2.after && c2.after !== "none" ? c2.after : "";
-      const before = c2.before && c2.before !== "none" ? c2.before : "";
-      if (!after) return { title: `Unbind the ${part}`, summary: `The ${part} of ${component}${where} no longer uses ${before || "a token"}.` };
-      return {
-        title: `Use ${after} for the ${part}`,
-        summary: `The ${part} of ${component}${where} ${before ? `moves from ${before} to ${after}` : `now uses ${after}`}.`
-      };
-    }
-    case "visual":
-      return {
-        title: "Update the look to match Figma",
-        summary: `${component} looks different in Figma${c2?.field && c2.field !== "Look of every variant" ? ` (${lower(c2.field)})` : ""}, and no variable edit explains it.`
-      };
-    default:
-      return { title: "", summary: "" };
-  }
-}
-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 tokenOf = (e3) => e3.figma ?? e3.head ?? e3.base;
-const pathOf = (e3) => tokenOf(e3)?.path ?? e3.path;
-function pushChangeRows(entries) {
-  return entries.map((e3) => {
-    const before = e3.head ?? e3.base;
-    const after = e3.figma;
-    const show = (t3) => {
-      if (!t3) return void 0;
-      const modes = Object.keys(t3.values);
-      if (modes.length <= 1) return formatValue(t3.type, t3.values[modes[0] ?? ""]);
-      return modes.map((m2) => `${modeDisplayName(m2)} ${formatValue(t3.type, t3.values[m2])}`).join("; ");
-    };
-    const renamed = e3.local?.kind === "renamed" && before && after && before.path !== after.path;
-    return { field: renamed ? `${before.path} -> ${after.path}` : pathOf(e3), before: show(before), after: show(after) };
-  });
-}
-function names(paths) {
-  if (paths.length <= 3) return andList(paths);
-  return `${paths.length} tokens, including ${andList(paths.slice(0, 2))}`;
-}
-function valueModes(e3) {
-  return (e3.local?.fields ?? []).filter((f) => f.field === "value" && f.mode && f.mode !== "value").map((f) => modeDisplayName(f.mode));
-}
-function draftPushDescription(entries, components = []) {
-  const by2 = { changed: [], added: [], renamed: [], removed: [] };
-  for (const e3 of entries) by2[e3.local?.kind ?? "changed"].push(e3);
-  const clauses = [];
-  if (by2.changed.length) {
-    const only = by2.changed.length === 1 ? by2.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(by2.changed.map(pathOf))}`);
-  }
-  if (by2.added.length) clauses.push(`adds ${names(by2.added.map(pathOf))}`);
-  if (by2.renamed.length) {
-    const r2 = by2.renamed[0];
-    const from = (r2.head ?? r2.base)?.path;
-    clauses.push(by2.renamed.length === 1 && from && from !== pathOf(r2) ? `renames ${from} to ${pathOf(r2)}` : `renames ${names(by2.renamed.map(pathOf))}`);
-  }
-  if (by2.removed.length) clauses.push(`removes ${names(by2.removed.map(pathOf))}`);
-  const sentences2 = [];
-  if (clauses.length) sentences2.push(`${capital(andList(clauses))}.`);
-  const fresh = components.filter((c2) => c2.kind === "new-component").map((c2) => c2.component);
-  const changed = [...new Set(components.filter((c2) => c2.kind !== "new-component").map((c2) => c2.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) sentences2.push(`Requests ${andList(comp)}.`);
-  return cleanDraftText(sentences2.join(" "));
-}
 const DRAFT_EXCHANGE_VERSION = 1;
 const DRAFTS_DIR = ".bridge/drafts";
 const DRAFT_PHRASE = "Draft my Bridge changes";
@@ -2314,12 +3023,16 @@ const DRAFT_VOICE_RULES = [
   "Use only facts from the changes, the images and the designer's notes. Never invent numbers, names, usage or reasons. If the reason is unknown, say what changes and leave the reason out.",
   "Keep the designer's intent from their notes.",
   "Never use an em dash: use a colon, a comma or parentheses. No exclamation marks, no emoji, no Markdown.",
-  "A request title never repeats the component name: the issue title already starts with it."
+  "A request title never repeats the component name: the issue title already starts with it.",
+  `For each change line, write one short sentence (at most ${DRAFT_LINE_MAX} characters, no trailing period) of what changed for developers, read from the before and after images: the part, the variant and the values when you can see them, for example "Icon added after the label in primary sm: Pencil, 16px". Never guess a value you cannot read.`,
+  `For each change line, also write the title of the request it becomes: short, sentence case, starts with a verb, at most ${DRAFT_TITLE_MAX} characters, no trailing period, never the component name, for example "Add an icon after the label".`
 ];
 const DRAFT_OUTPUT_CONTRACT = [
-  `Call bridge_write_drafts once per session with {"sessionId": "...", "results": [{"id": "<item id>", "title": "...", "summary": "..."}]}, one result per item.`,
+  `Call bridge_write_drafts once per session with {"sessionId": "...", "results": [{"id": "<item id>", "title": "...", "summary": "...", "lines": [{"id": "<line id>", "line": "...", "title": "..."}]}]}, one result per item.`,
   `title: one line, at most ${DRAFT_TITLE_MAX} characters, no trailing period.`,
   `summary: at most ${DRAFT_SUMMARY_SENTENCES} sentences, plain text.`,
+  `lines: one per change line the item lists (its "lines"), by line id: line is one sentence, at most ${DRAFT_LINE_MAX} characters, no trailing period; title is the request title for that component change, at most ${DRAFT_TITLE_MAX} characters, no trailing period. Leave lines out when the item lists none.`,
+  `Docs items (scope "docs", from Bridge Studio): follow the item's prompt and send {"id": "<item id>", "docs": {<only the sections it asks for>}} for a sections task (a section to check goes in only when something in it is no longer true for the code: leave accurate ones out, {"docs": {}} when all are), or {"id": "<item id>", "replacement": "..."} for a selection task. No title or summary. The designer reviews them on the Library page.`,
   "The designer reviews the text in Figma before anything is sent."
 ];
 function newDraftSessionId(random = Math.random) {
@@ -2344,7 +3057,7 @@ function composePendingDrafts(input) {
     sessionId: input.sessionId ?? newDraftSessionId(input.random),
     createdAt: (input.now ?? /* @__PURE__ */ new Date()).toISOString(),
     status: "pending",
-    source: "figma",
+    source: input.source ?? "figma",
     items: input.items.map((i2) => ({ ...i2, changes: i2.changes ?? [] }))
   };
   const problems = validatePendingDrafts(p2);
@@ -2362,7 +3075,7 @@ function validatePendingDrafts(x) {
   if (!isDraftSessionId(p2.sessionId)) out.push("The session id is missing or invalid.");
   if (!str(p2.createdAt) || Number.isNaN(Date.parse(p2.createdAt))) out.push("createdAt must be an ISO date.");
   if (p2.status !== "pending" && p2.status !== "drafted") out.push('status must be "pending" or "drafted".');
-  if (p2.source !== "figma") out.push('source must be "figma".');
+  if (p2.source !== "figma" && p2.source !== "studio") out.push('source must be "figma" or "studio".');
   if (!Array.isArray(p2.items) || !p2.items.length) out.push("A draft session needs at least one item.");
   const ids = /* @__PURE__ */ new Set();
   for (const [n2, i2] of (Array.isArray(p2.items) ? p2.items : []).entries()) {
@@ -2374,18 +3087,30 @@ function validatePendingDrafts(x) {
     if (!str(i2.id) || !i2.id) out.push(`${at2} has no id.`);
     else if (ids.has(i2.id)) out.push(`${at2} repeats the id "${i2.id}".`);
     else ids.add(i2.id);
-    if (i2.scope !== "request" && i2.scope !== "push") out.push(`${at2}: scope must be "request" or "push".`);
+    if (i2.scope !== "request" && i2.scope !== "push" && i2.scope !== "docs") out.push(`${at2}: scope must be "request", "push" or "docs".`);
+    if (i2.scope === "docs") {
+      const d = i2.docs;
+      if (!d || typeof d !== "object" || !str(d.slug) || !d.slug || !str(d.prompt) || !d.prompt || !optStr(d.path)) out.push(`${at2}: a docs item needs docs {slug, task, prompt}.`);
+      else out.push(...validateDocsTask(d.task).map((m2) => `${at2}: ${m2}`));
+    } else if (i2.docs !== void 0) out.push(`${at2}: only a docs item has docs.`);
     if (!optStr(i2.component)) out.push(`${at2}: component must be text.`);
     if (i2.kind !== void 0 && !KINDS.has(i2.kind)) out.push(`${at2}: unknown kind "${String(i2.kind)}".`);
-    if (!Array.isArray(i2.changes) || i2.changes.some((c2) => !c2 || !str(c2.field) || !optStr(c2.before) || !optStr(c2.after))) out.push(`${at2}: changes must be a list of {field, before, after}.`);
+    if (!Array.isArray(i2.changes) || i2.changes.some((c10) => !c10 || !str(c10.field) || !optStr(c10.before) || !optStr(c10.after))) out.push(`${at2}: changes must be a list of {field, before, after}.`);
     if (i2.variables !== void 0 && (!Array.isArray(i2.variables) || i2.variables.some((v2) => !v2 || !str(v2.path)))) out.push(`${at2}: variables must be a list of {path, before, after}.`);
     if (i2.variables !== void 0 && i2.scope !== "push") out.push(`${at2}: only a push item has variables.`);
     if (i2.images !== void 0 && (!Array.isArray(i2.images) || i2.images.some((m2) => !m2 || m2.label !== "before" && m2.label !== "after" || !str(m2.url)))) out.push(`${at2}: images must be a list of {label: before or after, url}.`);
     if (!i2.draft || !str(i2.draft.title) || !str(i2.draft.summary)) out.push(`${at2}: draft must hold a title and a summary.`);
+    if (i2.lines !== void 0 && (!Array.isArray(i2.lines) || i2.lines.some((l2) => !l2 || !str(l2.id) || !l2.id || !str(l2.line) || !optStr(l2.title) || !Array.isArray(l2.changes)))) out.push(`${at2}: lines must be a list of {id, changes, line, title}.`);
   }
   if (p2.results !== void 0) {
     if (!Array.isArray(p2.results)) out.push("results must be a list.");
-    else for (const r2 of p2.results) if (!r2 || !str(r2.id) || !str(r2.title) || !str(r2.summary)) out.push("Each result needs an id, a title and a summary.");
+    else
+      for (const r2 of p2.results) {
+        if (!r2 || !str(r2.id) || !str(r2.title) || !str(r2.summary)) out.push("Each result needs an id, a title and a summary.");
+        else if (r2.docs !== void 0 && (!r2.docs || typeof r2.docs !== "object" || Array.isArray(r2.docs))) out.push("Result docs must be an object of sections.");
+        else if (!optStr(r2.replacement)) out.push("A result replacement must be text.");
+        else if (r2.lines !== void 0 && (!Array.isArray(r2.lines) || r2.lines.some((l2) => !l2 || !str(l2.id) || !str(l2.line) || !optStr(l2.title)))) out.push("Result lines must be a list of {id, line, title}.");
+      }
   }
   return out;
 }
@@ -2422,31 +3147,88 @@ function sanitizeDraftText(raw) {
   const summary = typeof raw.summary === "string" ? sentences(cleanDraftText(raw.summary)) : "";
   return { title, summary };
 }
+function sanitizeDocsResult(item, r2) {
+  const task = item.docs.task;
+  if (task.kind === "selection") {
+    const raw = r2.replacement ?? (r2.docs && typeof r2.docs === "object" ? r2.docs[task.key] : void 0);
+    const replacement = sanitizeDocsReplacement(raw);
+    if (!replacement) throw new Error(`Item "${item.id}" asks to rewrite a passage of ${task.key}: send {"id": "${item.id}", "replacement": "..."}.`);
+    return { replacement };
+  }
+  try {
+    const { sections, checked } = docsSectionsAnswer(task, r2.docs ?? {});
+    return { docs: sections, checked };
+  } catch {
+    throw new Error(`Item "${item.id}" asks for the sections ${docsTaskKeys(task).join(", ")}: send {"id": "${item.id}", "docs": {${task.keys.map((k3) => `"${k3}": ...`).join(", ")}}} in the shapes of its prompt.`);
+  }
+}
+function sanitizeResultLines(item, raw) {
+  if (raw === void 0 || raw === null) return [];
+  if (!Array.isArray(raw)) throw new Error(`lines for "${item.id}" must be a list of {"id", "line", "title"}.`);
+  const known = new Set((item.lines ?? []).map((l2) => l2.id));
+  const out = /* @__PURE__ */ new Map();
+  for (const l2 of raw) {
+    const id = typeof l2?.id === "string" ? l2.id : "";
+    if (!known.has(id)) throw new Error(`Item "${item.id}" has no change line "${id}".${known.size ? ` Use the line ids from bridge_pending_drafts: ${[...known].join(", ")}.` : " It lists no lines: leave lines out."}`);
+    const line = sanitizeDraftLine(l2.line);
+    const title = sanitizeDraftTitle(l2.title);
+    if (line || title) out.set(id, { id, line, ...title ? { title } : {} });
+  }
+  return [...out.values()];
+}
+function sanitizeDraftTitle(raw) {
+  if (typeof raw !== "string") return "";
+  const t3 = clip(cleanDraftText(raw.replace(/[\r\n]+/g, " ")), DRAFT_TITLE_MAX);
+  return t3.charAt(0).toUpperCase() + t3.slice(1);
+}
 function mergeDraftResults(p2, results, at2 = /* @__PURE__ */ new Date()) {
   const ids = new Set(p2.items.map((i2) => i2.id));
   const next = new Map((p2.results ?? []).map((r2) => [r2.id, r2]));
   for (const r2 of results) {
     if (!ids.has(r2.id)) throw new Error(`Session ${p2.sessionId} has no item "${r2.id}". Use the ids from bridge_pending_drafts: ${[...ids].join(", ")}.`);
+    const item = p2.items.find((i2) => i2.id === r2.id);
+    if (item.scope === "docs") {
+      next.set(r2.id, { id: r2.id, title: "", summary: "", ...sanitizeDocsResult(item, r2), by: "claude", at: at2.toISOString() });
+      continue;
+    }
     const clean = sanitizeDraftText(r2);
-    if (!clean.title && !clean.summary) throw new Error(`The result for "${r2.id}" has no title and no summary.`);
-    next.set(r2.id, { id: r2.id, title: clean.title, summary: clean.summary, by: "claude", at: at2.toISOString() });
+    const lines = sanitizeResultLines(item, r2.lines);
+    if (!clean.title && !clean.summary && !lines.length) throw new Error(`The result for "${r2.id}" has no title and no summary, and no line.`);
+    next.set(r2.id, { id: r2.id, title: clean.title, summary: clean.summary, ...lines.length ? { lines } : {}, by: "claude", at: at2.toISOString() });
   }
   const merged = p2.items.map((i2) => next.get(i2.id)).filter((r2) => !!r2);
   return { ...p2, results: merged, status: merged.length === p2.items.length ? "drafted" : "pending" };
 }
 function draftItemBrief(i2) {
+  if (i2.scope === "docs" && i2.docs) {
+    const t3 = i2.docs.task;
+    const check = t3.kind === "sections" ? (t3.check ?? []).filter((k3) => t3.keys.includes(k3)) : [];
+    const write = t3.kind === "sections" ? t3.keys.filter((k3) => !check.includes(k3)) : [];
+    const what = t3.kind === "selection" ? `rewrite one passage of the ${t3.key} section (${t3.mode}), answer with "replacement"` : [
+      write.length ? `${t3.rewrite ? "rewrite" : "write"} the sections ${write.join(", ")}` : "",
+      check.length ? `check the sections ${check.join(", ")} against the code and return one only when something in it is no longer true (leave accurate ones out)` : ""
+    ].filter(Boolean).join("; ") + ', answer with "docs"';
+    return [`Item ${i2.id}: component docs${i2.component ? ` of ${i2.component}` : ""} from Bridge Studio (${i2.docs.path ?? i2.docs.slug}): ${what}.`, "", i2.docs.prompt].join("\n");
+  }
   const kind = i2.kind ? REQUEST_KINDS.find((k3) => k3.value === i2.kind)?.label : void 0;
   const cell2 = (s) => (s ?? "").replace(/\|/g, "\\|").replace(/\n/g, " ");
   const lines = [`Item ${i2.id}: ${i2.scope === "request" ? "a component change request (a GitHub issue developers implement)" : "the description of a pull request with design token (variable) edits from Figma"}.`];
   if (i2.component) lines.push(`Component: ${i2.component}`);
   if (kind) lines.push(`Kind: ${kind}`);
   if (i2.components?.length) lines.push(`Components with a change request: ${i2.components.join(", ")}`);
-  if (i2.changes.length) lines.push("", "| What | Now | In Figma |", "| --- | --- | --- |", ...i2.changes.map((c2) => `| ${cell2(c2.field)} | ${cell2(c2.before) || "none"} | ${cell2(c2.after) || "removed"} |`));
+  if (i2.changes.length) lines.push("", "| What | Now | In Figma |", "| --- | --- | --- |", ...i2.changes.map((c10) => `| ${cell2(c10.field)} | ${cell2(c10.before) || "none"} | ${cell2(c10.after) || "removed"} |`));
   if (i2.variables?.length) lines.push("", "| Token | Now | In Figma |", "| --- | --- | --- |", ...i2.variables.map((v2) => `| ${cell2(v2.path)} | ${cell2(v2.before) || "none"} | ${cell2(v2.after) || "removed"} |`));
-  if (!i2.changes.length && !i2.variables?.length) lines.push("", "No change detected: rely on the notes and the images.");
+  if (!i2.changes.length && !i2.variables?.length && !i2.lines?.length) lines.push("", "No change detected: rely on the notes and the images.");
   if (i2.draft.title || i2.draft.summary) lines.push("", "Starting draft, written from the changes only:", `Title: ${i2.draft.title}`, `Summary: ${i2.draft.summary}`);
   if (i2.notes?.trim()) lines.push("", "The designer's notes (keep their intent):", i2.notes.trim());
-  if (i2.images?.length) lines.push("", `Images: ${i2.images.map((m2) => `${m2.label} ${m2.url}`).join(", ")}`);
+  if (i2.lines?.length) {
+    lines.push("", `Change lines to write (one sentence each, at most ${DRAFT_LINE_MAX} characters, from the before and after images), each with the title of its request (at most ${DRAFT_TITLE_MAX} characters):`);
+    for (const l2 of i2.lines) {
+      lines.push(`- Line ${l2.id}${l2.component ? `, ${l2.component}` : ""}${l2.kind ? ` (${REQUEST_KINDS.find((k3) => k3.value === l2.kind)?.label ?? l2.kind})` : ""}. Starting line: ${l2.line || "(none)"}${l2.title ? `. Starting title: ${l2.title}` : ""}`);
+      for (const c10 of l2.changes) lines.push(`  - ${c10.field}: ${c10.before || "none"} -> ${c10.after || "removed"}`);
+    }
+  }
+  if (i2.images?.length) lines.push("", `Images: ${i2.images.map((m2) => `${m2.label}${m2.line ? ` (line ${m2.line})` : ""} ${m2.url}`).join(", ")}`);
   return lines.join("\n");
 }
 const isConflict = (err) => err instanceof GitHubError ? err.status === 409 || err.status === 422 && /sha/i.test(`${err.detail ?? ""} ${err.message}`) : err?.status === 409;
@@ -2507,7 +3289,96 @@ async function deletePendingDrafts(client, sessionId, opts = {}) {
   }
   return true;
 }
-function explorationSummary(p2, owner, repo, s) {
+async function ensureRequestsBranch(client, baseBranch) {
+  if (await client.getBranchSha(REQUESTS_BRANCH)) return;
+  const head = await client.getBranchSha(baseBranch);
+  if (!head) throw new Error(`Branch "${baseBranch}" was not found, so the ${REQUESTS_BRANCH} branch cannot start from it.`);
+  await client.createBranch(REQUESTS_BRANCH, head);
+}
+async function createDocsDraftSession(client, input) {
+  await ensureRequestsBranch(client, input.baseBranch);
+  const what = input.task.kind === "selection" ? `Rewrite a passage of ${input.task.key}` : `${input.task.rewrite ? "Rewrite" : "Write"} ${input.task.keys.join(", ")}`;
+  const item = {
+    id: "docs-1",
+    scope: "docs",
+    component: input.component,
+    changes: [],
+    draft: { title: `${input.component} docs`, summary: what },
+    docs: { slug: input.slug, ...input.path ? { path: input.path } : {}, task: input.task, prompt: input.prompt }
+  };
+  return createPendingDrafts(client, composePendingDrafts({ items: [item], source: "studio", now: input.now, random: input.random }));
+}
+const DRAFT_POLL_INTERVAL_MS = 5e3;
+const DRAFT_POLL_TIMEOUT_MS = 10 * 6e4;
+class DraftPoller {
+  constructor(o2) {
+    this.o = o2;
+  }
+  o;
+  handle;
+  startedAt = 0;
+  running = false;
+  busy = false;
+  get active() {
+    return this.running;
+  }
+  now() {
+    return (this.o.now ?? Date.now)();
+  }
+  schedule() {
+    const set = this.o.setTimer ?? ((fn, ms) => setTimeout(fn, ms));
+    this.handle = set(() => void this.tick(), this.o.intervalMs ?? DRAFT_POLL_INTERVAL_MS);
+  }
+  /** Starts (or restarts, after a timeout) polling; the timeout counts from now. */
+  start() {
+    this.stop();
+    this.running = true;
+    this.startedAt = this.now();
+    this.schedule();
+  }
+  stop() {
+    if (this.handle !== void 0) (this.o.clearTimer ?? ((h3) => clearTimeout(h3)))(this.handle);
+    this.handle = void 0;
+    this.running = false;
+  }
+  async tick() {
+    if (!this.running) return;
+    this.handle = void 0;
+    const done = await this.check();
+    if (done || !this.running) return;
+    if (this.now() - this.startedAt >= (this.o.timeoutMs ?? DRAFT_POLL_TIMEOUT_MS)) {
+      this.stop();
+      this.o.onTimeout();
+      return;
+    }
+    this.schedule();
+  }
+  /** Reads the file once. True when polling is over (answered or gone). */
+  async check() {
+    if (this.busy) return false;
+    this.busy = true;
+    try {
+      const cur = await readPendingDrafts(this.o.client, this.o.sessionId);
+      if (!cur) {
+        this.stop();
+        this.o.onGone?.();
+        return true;
+      }
+      if (cur.drafts.status === "drafted" && cur.drafts.results?.length) {
+        this.stop();
+        this.o.onResults(cur.drafts.results, cur.drafts);
+        return true;
+      }
+      return false;
+    } catch (err) {
+      this.o.onError?.(err instanceof Error ? err.message : String(err));
+      return false;
+    } finally {
+      this.busy = false;
+    }
+  }
+}
+function explorationSummary(p2, _owner, _repo, s) {
   const e3 = parseExplorationBody(p2.body);
   const slug = p2.headRef?.startsWith(EXPLORATION_PREFIX) ? p2.headRef.slice(EXPLORATION_PREFIX.length) : e3?.slug ?? explorationSlug(p2.title);
   return {
@@ -2522,8 +3393,8 @@ function explorationSummary(p2, owner, repo, s) {
     draft: p2.draft,
     author: e3?.author ?? p2.author,
     updatedAt: p2.updatedAt,
-    previews: previewLinks(s.apps, { branch: p2.headRef, pr: p2.number, sha: p2.headSha }),
-    install: explorationInstall({ owner, repo, pr: p2.number, packages: s.packages, sha: p2.headSha })
+    headSha: p2.headSha,
+    previews: previewLinks(s.apps, { branch: p2.headRef, pr: p2.number, sha: p2.headSha })
   };
 }
 async function listExplorationsOnGitHub(gh, s, opts = {}) {
@@ -2549,7 +3420,7 @@ ${full.purpose.trim()}
 Exploration: never merged as is. Promote it to review or close it.`,
     files: [{ path: explorationNotePath(slug), content: explorationNote(full) }]
   });
-  const ctx = { owner: gh.owner, repo: gh.name, packages: s.packages, apps: s.apps };
+  const ctx = { owner: gh.owner, repo: gh.name, packages: s.packages, apps: s.apps, ...s.requests?.length ? { requests: s.requests } : {} };
   const pr = await x.createPullRequest({ title: explorationPrTitle(full), head: branch, base: s.base, body: explorationPrBody(full, ctx), draft: true });
   await x.addLabels(pr.number, [EXPLORATION_LABEL]);
   await x.updatePullRequest(pr.number, { body: explorationPrBody(full, { ...ctx, pr: pr.number }) }).catch(() => void 0);
@@ -2559,10 +3430,20 @@ Exploration: never merged as is. Promote it to review or close it.`,
     pr: pr.number,
     url: pr.url,
     commit: commit.sha,
-    install: explorationInstall({ owner: gh.owner, repo: gh.name, pr: pr.number, packages: s.packages, sha: commit.sha }),
+    tryIt: { state: "building" },
     previews: previewLinks(s.apps, { branch, pr: pr.number, sha: commit.sha })
   };
 }
+async function explorationTryItOnGitHub(gh, e3) {
+  const [comments, head] = await Promise.all([gh.listIssueComments(e3.number), gh.getBranchSha(e3.branch).catch(() => void 0)]);
+  return explorationTryIt({ comment: findPreviewComment(comments)?.body, headSha: head });
+}
+async function explorationTestBuildOnGitHub(gh, e3, config) {
+  const [comments, head] = await Promise.all([gh.listIssueComments(e3.number), gh.getBranchSha(e3.branch).catch(() => void 0)]);
+  const tryIt = explorationTryIt({ comment: findPreviewComment(comments)?.body, headSha: head });
+  const previews = await branchPreviewUrls(gh, e3.number, config, { branch: e3.branch, sha: head, comments }).catch(() => []);
+  return { tryIt, previews, settled: tryIt.state !== "building" && previewsSettled(previews) };
+}
 async function findExplorationOnGitHub(gh, ref) {
   if (typeof ref === "number" || /^#?\d+$/.test(String(ref))) {
     const p2 = await gh.getPullRequest(Number(String(ref).replace(/^#/, "")));
@@ -2586,6 +3467,7 @@ async function promoteExplorationOnGitHub(gh, ref, opts = {}) {
   const x = gh.withBranchPrefix(EXPLORATION_PREFIX);
   if (plan.removeFiles.length) {
     await x.commitToBranch({ branch: p2.headRef, message: "chore(explore): promote to review, remove the exploration note", files: plan.removeFiles.map((path) => ({ path, content: null })) }).catch((e3) => {
+      if (e3 instanceof GitHubError && e3.auth === "rejected") throw e3;
       out.warnings.push(`The exploration note stays on the branch (${e3.message}). Delete ${plan.removeFiles.join(", ")} before merging.`);
     });
   }
@@ -2605,35 +3487,76 @@ async function closeExplorationOnGitHub(gh, ref) {
   await gh.updatePullRequest(p2.number, { state: "closed" });
   return { number: p2.number, url: p2.url, branch: p2.headRef };
 }
+async function linkRequestToExplorationOnGitHub(gh, n2, branch, opts = {}) {
+  if (!isExplorationBranch(branch)) throw new GitHubError(422, `"${branch}" is not an exploration branch. Exploration branches are named explore/<name>.`);
+  const issue = await gh.getIssue(n2);
+  const body = withRequestExploration(issue.body, branch);
+  if (!body) throw new GitHubError(422, `#${n2} has no Bridge request block, so it cannot be linked. Add "exploration: ${branch}" to it on GitHub.`);
+  await gh.updateIssue(n2, { body });
+  const warnings = [];
+  if (!await gh.addLabels(n2, [EXPLORATION_LABEL])) warnings.push(`The ${EXPLORATION_LABEL} label could not be added to #${n2}.`);
+  let assignees = [];
+  if (opts.assignee) {
+    try {
+      assignees = await gh.addAssignees(n2, [opts.assignee.replace(/^@/, "")]);
+    } catch {
+      warnings.push(`@${opts.assignee.replace(/^@/, "")} could not be assigned to #${n2}.`);
+    }
+  }
+  return { number: n2, branch, assignees, warnings };
+}
+async function assignRequestOnGitHub(gh, n2, login) {
+  const who = login.trim().replace(/^@/, "");
+  if (!who) throw new GitHubError(422, "Pick who should work on it.");
+  const assignees = await gh.addAssignees(n2, [who]);
+  if (!assignees.some((a) => a.toLowerCase() === who.toLowerCase())) throw new GitHubError(422, `GitHub did not assign @${who}: they need access to this repository.`);
+  return assignees;
+}
+async function declineRequestOnGitHub(gh, n2, reason, by2) {
+  const problems = declineReasonProblems(reason);
+  if (problems.length) throw new GitHubError(422, problems.join(" "));
+  await gh.addComment(n2, declineComment(reason, by2));
+  await gh.updateIssue(n2, { state: "closed", state_reason: "not_planned" });
+}
 export {
-  ae as AAA_MIN,
-  af as AA_MIN,
+  af as AAA_MIN,
+  ag as AA_MIN,
+  ADMIN_ROLE_ID,
+  ANTHROPIC_MESSAGES_URL,
   BELL,
   BRAND_FONTS,
   BRAND_SLUG_RE,
-  ag as BULK_LIMIT,
+  ah as BULK_LIMIT,
   k as COLOR_FIELDS,
   C as COMPONENT_SPECS_VERSION,
   CONFIG_FILE,
-  ah as CONTRAST_CELL_MAX,
-  ai as CONTRAST_CHECKS_FILE,
+  ai as CONTRAST_CELL_MAX,
+  aj as CONTRAST_CHECKS_FILE,
   ConfigError,
-  aj as DEFAULT_COMPONENT_SPECS_FILE,
-  ak as DEFAULT_GOVERNANCE,
-  al as DEFAULT_OVERRIDE,
+  ak as DEFAULT_COMPONENT_SPECS_FILE,
+  al as DEFAULT_GOVERNANCE,
+  am as DEFAULT_OVERRIDE,
   DEFAULT_PROTECTED_BRANCHES,
+  an as DEFAULT_RIGHTS,
   DEFAULT_TOKEN_PATHS,
+  ao as DEFAULT_VISUAL_IMPACT,
   DEMO_RELEASES,
   DOCS_CHANGE_BUMP,
+  DOCS_DRAFT_MODEL,
   DOCS_KEYS,
+  DOCS_SELECTION_MODES,
   DRAFTS_DIR,
   DRAFT_EXCHANGE_VERSION,
+  DRAFT_LINE_MAX,
   DRAFT_OUTPUT_CONTRACT,
   DRAFT_PHRASE,
+  DRAFT_POLL_INTERVAL_MS,
+  DRAFT_POLL_TIMEOUT_MS,
   DRAFT_SUMMARY_SENTENCES,
   DRAFT_TITLE_MAX,
   DRAFT_VOICE_RULES,
   D as DTCG_TYPES,
+  DraftPoller,
   EXPLORATION_CHECK,
   EXPLORATION_LABEL,
   EXPLORATION_NOTES_DIR,
@@ -2645,66 +3568,86 @@ export {
   EXT_SCOPES,
   GitHubClient,
   GitHubError,
-  am as JsonParseError,
+  ap as JsonParseError,
   LIGHTNESS,
   LayeredTokenSet,
   NEUTRAL_ANCHORS,
+  aq as OWNER_GROUPS,
   PIN_TOLERANCE,
-  an as PREVIEW_APP_LABELS,
-  ao as PREVIEW_COMMENT_MARKER,
-  ap as PREVIEW_PLACEHOLDERS,
-  aq as PRIMITIVE_MODE,
+  ar as PREVIEW_APP_LABELS,
+  as as PREVIEW_COMMENT_MARKER,
+  at as PREVIEW_PLACEHOLDERS,
+  au as PRIMITIVE_MODE,
   PROSE_KEYS,
+  PROTECTION_PARTS,
+  PROTECTION_PART_PHRASE,
   ProtectedBranchError,
   RADIUS_PRESETS,
   REQUESTS_BRANCH,
   REQUEST_KINDS,
   REQUEST_LABEL,
   REQUEST_STATUS_LABEL,
+  av as RIGHTS,
+  aw as RIGHT_LABEL,
   RISK_LABELS,
-  ar as RISK_TIER,
+  ax as RISK_TIER,
   SIMILARITY_THRESHOLD,
   SINGLE_MODE,
-  as as SPEC_FIELDS,
+  ay as SPEC_FIELDS,
   STEPS,
   TIER_AXIS,
   TIER_NAMES,
-  at as TIER_ORDER,
-  au as UNRELEASED,
+  az as TIER_ORDER,
+  TOKEN_REJECTED_MESSAGE,
+  TOKEN_SETTINGS_URL,
+  aA as TeamDirectory,
+  aB as UNRELEASED,
+  aC as VISUAL_CHECK_LABEL,
   acceptDocsDraft,
   acceptDocsText,
   addBrandToConfigText,
-  av as affectedContrast,
+  aD as affectedContrast,
   e2 as aliasOf,
   aliasTarget,
   anatomyLabel,
   anchoredRamp,
-  aw as appUrl,
+  anthropicReplyText,
+  anthropicRequest,
+  aE as appForProject,
+  aF as appUrl,
   applyConfirmedRenames,
+  applyDocsSections,
   applyTokenEdits,
+  aG as approverEntries,
+  aH as approverLists,
   assertSafeBranch,
-  ax as assignVersions,
+  assignRequestOnGitHub,
+  aI as assignVersions,
   base64ToUtf8,
-  ay as baseBranchOf,
+  aJ as baseBranchOf,
   bellChroma,
-  az as branchName,
-  aA as branchSlug,
+  aK as branchName,
+  branchPreviewUrls,
+  aL as branchSlug,
   brandDisplayName,
   brandPreviewVariables,
   buildHistoryEntry,
   buildReport,
   i as buildTokenSet,
   buildUsageIndex,
-  aB as changeKind,
-  aC as changeTable,
-  aD as changedModes,
-  aE as changesetBump,
+  aM as canShip,
+  aN as changeKind,
+  aO as changeTable,
+  aP as changedModes,
+  aQ as changesetBump,
   checkBrandSlug,
   checkLayeredPair,
-  aF as classifyLayered,
+  classifyAuth,
+  aR as classifyLayered,
   classifyRisk,
+  cleanDocsText,
   cleanDraftText,
-  aG as clearRawDeep,
+  aS as clearRawDeep,
   closeExplorationOnGitHub,
   closingIssueNumbers,
   coerceValue,
@@ -2713,39 +3656,50 @@ export {
   j2 as colorToCss,
   k2 as colorsEqual,
   c as comboKey,
-  aH as commitMessage,
+  aT as commitMessage,
   l as compactJson,
   componentForPath,
-  aI as composeChangeset,
+  aU as composeChangeset,
   composeFiles,
   composeNewBrandBody,
   composePendingDrafts,
-  aJ as composePrBody,
-  aK as composeProposalBody,
+  aV as composePrBody,
+  aW as composeProposalBody,
   composeRequestIssue,
-  aL as composite,
-  aM as contextFor,
+  aX as composite,
+  aY as contextFor,
   contextLabel,
-  aN as contrastDelta,
-  aO as contrastDeltaTable,
-  aP as contrastLevel,
-  aQ as contrastPair,
-  aR as contrastRatio,
+  aZ as contrastDelta,
+  a_ as contrastDeltaTable,
+  a$ as contrastLevel,
+  b0 as contrastPair,
+  b1 as contrastRatio,
   contrastScope,
-  aS as countChanges,
+  b2 as countChanges,
+  createDocsDraftSession,
   createPendingDrafts,
   cssModuleClasses,
   cssVarsIn,
-  aT as defaultContext,
+  declineComment,
+  declineReasonProblems,
+  declineRequestOnGitHub,
+  b3 as defaultContext,
   defaultFile,
   defaultScopes,
-  aU as defaultTitle,
-  aV as defineConfig,
+  b4 as defaultTitle,
+  b5 as defineConfig,
   deletePendingDrafts,
   demoHistory,
-  aW as detectLayout,
-  aX as diffLayered,
+  b6 as detectLayout,
+  b7 as diffLayered,
   docsPrompt,
+  docsSectionShapes,
+  docsSectionsAnswer,
+  docsSectionsResult,
+  docsSelectionPrompt,
+  docsTaskKeys,
+  docsTaskPrompt,
+  draftChangeLine,
   draftImagePath,
   draftItemBrief,
   draftPushDescription,
@@ -2754,78 +3708,104 @@ export {
   dtcgColor,
   effectiveScopes,
   emptyTokenFile,
+  ensureRequestsBranch,
+  b8 as entriesFor,
+  b9 as entryLabel,
   evaluatePairs,
+  ba as expandEntries,
+  bb as expandOwners,
   explorationBranch,
-  explorationInstall,
   explorationNote,
   explorationNotePath,
   explorationPrBody,
   explorationPrTitle,
   explorationProblems,
   explorationRules,
+  explorationShareMessage,
   explorationSlug,
   explorationSlugFromBranch,
   explorationStatus,
   explorationSummary,
-  aY as fieldChanges,
-  aZ as fileModes,
-  a_ as filterHistory,
+  explorationTestBuildOnGitHub,
+  explorationTryIt,
+  explorationTryItOnGitHub,
+  bc as fieldChanges,
+  bd as fileModes,
+  be as filterHistory,
   findExplorationOnGitHub,
+  findPreviewComment,
   findReferenceProblems,
-  a$ as findToken,
-  b0 as firstParagraph,
+  bf as findToken,
+  bg as findVercelComment,
+  bh as firstParagraph,
   m as flattenLayerFile,
-  b1 as flattenTokens,
+  bi as flattenTokens,
   formatChangeset,
   formatDocsJson,
-  b2 as formatNumber,
+  bj as formatNumber,
+  bk as formatOwnerEntry,
   formatValue,
   friendlyMessage,
   fromHex,
   fromPlain,
   generateRamp,
-  b3 as getChild,
+  bl as getChild,
   getEntry,
   gitHubHistoryBackend,
   g2 as globToRegExp,
+  bm as groupsPhrase,
   h as hashSpec,
   h2 as hexToRgba,
+  bn as holdersOf,
   j as iconComponentName,
   idExtensionFor,
   impactedModules,
   importsIn,
-  b4 as indexByPath,
-  b5 as inheritedTypeAt,
-  installCommand,
+  bo as indexByPath,
+  bp as inheritedTypeAt,
+  bq as installCommand,
+  br as installCommandFromPreviewComment,
   isActiveExploration,
   isAlias,
+  isDocsSelectionMode,
   isDraftSessionId,
   isExplorationBranch,
   isExplorationPull,
-  b6 as isGuardrail,
+  bs as isGuardrail,
   isHex,
+  isMissingPermission,
   isMultiMode,
-  b7 as isTokenFile,
+  isPlanRefusal,
+  isProseKey,
+  bt as isTeamEntry,
+  bu as isTokenFile,
+  isTokenRejected,
+  bv as isVercelComment,
   jiraIssueFields,
-  b8 as kindForMin,
-  b9 as layeredImpact,
+  bw as kindForMin,
+  bx as layeredImpact,
   n as layeredParityIssues,
   g as layoutOptions,
   levenshtein,
+  linkRequestToExplorationOnGitHub,
   listBrands,
   listExplorationsOnGitHub,
   listPendingDrafts,
   loadConfig,
   loadGitHubHistory,
+  loadProtection,
   loadRepoFiles,
-  ba as luminance,
+  loadRequiredChecks,
+  by as luminance,
   markClaudeDraft,
+  mergeDocsDraft,
   mergeDraftResults,
   mergeReleases,
+  missingPermissionMessage,
   missingProse,
   modeDisplayName,
   modeFile,
-  bb as modeLabel,
+  bz as modeLabel,
   modesOf$1 as modesOf,
   moveToken,
   nearestStep,
@@ -2834,102 +3814,146 @@ export {
   neutralOffset,
   newBrandSection,
   newDraftSessionId,
-  bc as nodesEqual,
+  bA as nodesEqual,
+  bB as normalizeRights,
   oklch,
   oklchToLinear,
-  bd as overrideKey,
+  bC as overrideKey,
+  bD as ownerEntryProblems,
   packageDirCandidates,
-  be as pairKey,
+  bE as pairKey,
   parseChangelog,
-  bf as parseChangesetText,
+  bF as parseChangesetText,
   p as parseColor,
-  bg as parseComponentSpecs,
+  bG as parseComponentSpecs,
   parseContrastChecks,
   o as parseDimension,
+  parseDocsReply,
+  parseDocsTaskAnswer,
   parseExplorationBody,
   parseJson,
+  bH as parseOwnerEntry,
   parsePendingDrafts,
   parseRepo,
   parseRequestIssue,
+  parseStructureChange,
   parseTokenFile,
+  bI as parseVercelComment,
   patchDocsJson,
   pathId,
   pathSimilarity,
+  permissionLabel,
   plainEqual,
   planNewBrand,
-  bh as planRestore,
-  bi as planRevert,
-  bj as planToJson,
+  bJ as planRestore,
+  bK as planRevert,
+  bL as planToJson,
   e as prNumberFromSubject,
   prefillDocs,
-  bk as previewComment,
+  bM as previewComment,
   previewLinks,
-  bl as previewUrl,
+  bN as previewLinksOf,
+  bO as previewUrl,
+  previewsSettled,
+  bP as projectOfLabel,
   promoteExplorationOnGitHub,
   promotionPlan,
   propsTable,
-  bm as protectedBranchesOf,
+  protectLibrary,
+  protectRefusal,
+  bQ as protectedBranchesOf,
+  protectionRuleset,
+  protectionRulesetName,
+  protectionSentence,
+  protectionState,
   pushChangeRows,
   readPendingDrafts,
+  readPreviewComment,
   readTokenAt,
   reconcileIds,
   releasesFromTags,
   removeToken,
-  bn as renderedColor,
+  bR as renderedColor,
   requestBrief,
   requestImagePath,
   requestIssueTitle,
   requestStatus,
-  bo as resolve,
+  requiredCheckNames,
+  requiredPermission,
+  bS as resolve,
+  resolveBranchPreviews,
   r as rgbaToDtcg,
   q as rgbaToHex,
+  bT as rightsProblems,
   round3,
-  bp as runLayeredContrast,
+  rulesSettingsUrl,
+  rulesetTargetsDefault,
+  bU as runLayeredContrast,
   sameScopes,
-  bq as sameToken,
+  bV as sameToken,
+  sanitizeDocsReplacement,
+  sanitizeDocsResult,
+  sanitizeDocsSections,
+  sanitizeDraftLine,
   sanitizeDraftText,
+  sanitizeDraftTitle,
+  sanitizeResultLines,
+  sectionsNeedingReview,
   selectTokenFiles,
   serializeJson,
   serializePendingDrafts,
   serializeTokenFile,
   shadowedEdits,
+  bW as shipPolicy,
+  shortVariant,
+  shortVariants,
   slugify,
-  snapshotUrl,
-  br as specHash,
+  bX as snapshotUrl,
+  bY as specHash,
   startExplorationOnGitHub,
-  bs as summarizeTokenChange,
-  bt as tarballAssetName,
-  tarballUrl,
-  bu as threeWayDiff,
+  bZ as summarizeTokenChange,
+  b_ as tarballAssetName,
+  b$ as tarballUrl,
+  c0 as teamKey,
+  c1 as teamKeyOf,
+  c2 as teamUnreadableMessage,
+  c3 as teamsIn,
+  c4 as threeWayDiff,
   tintedNeutral,
-  bv as titleOf,
+  c5 as titleOf,
   t2 as toAlias,
-  bw as toChangeSummary,
+  c6 as toChangeSummary,
   toConfigJson,
   toHex,
-  bx as toMap,
+  c7 as toMap,
   toOklch,
   toPlain,
-  by as tokenBump,
+  c8 as tokenBump,
   t as tokenCssVar,
-  bz as tokenHistory,
-  bA as tokenNode,
+  c9 as tokenHistory,
+  ca as tokenNode,
   tokenUsage,
   tokensPath,
+  cb as unreadableShipTeams,
+  cc as unreadableTeams,
   updatePendingDrafts,
   upsertToken,
   utf8ToBase64,
+  validateDocsTask,
   validateIntegrations,
   validateLayered,
   validatePendingDrafts,
   validateProposal,
   validateSet,
-  bB as valueIn,
+  cd as valueIn,
   u as valueToCss,
   valuesEqual,
   v as variantKeyOf,
-  bC as variantName,
-  bD as versionTimeline,
+  ce as variantName,
+  cf as versionTimeline,
+  cg as visualImpactProblems,
+  ch as whoCanShipSentence,
+  withRequestExploration,
   writeDraftResults
 };
 //# sourceMappingURL=index.js.map