@bridge-ds/core 0.2.0 → 0.4.0

package/dist/index.js

@@ -1,7 +1,7 @@
-import { n as modeDisplayName, o as modesOf$1, q as isMultiMode, T as TIER_NAMES, s as TIER_AXIS, u as findReferenceProblems, w as evaluatePairs, x as contrastScope, y as contextLabel, S as SINGLE_MODE, z as pathId, A as 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 { 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";
+import { n as modeDisplayName, o as modesOf$1, q as isMultiMode, T as TIER_NAMES, s as TIER_AXIS, u as findReferenceProblems, w as evaluatePairs, x as contrastScope, y as contextLabel, S as SINGLE_MODE, z as pathId, A as flattenTokens, B as serializeTokenFile, D as removeToken, E as upsertToken, F as threeWayDiff, G as emptyTokenFile, H as parseTokenFile, I as EXT_ID, J as EXT_SCOPES, K as resolve, L as moveToken, M as effectiveScopes, N as sameScopes, O as defaultScopes, P as readTokenAt, Q as modeFile, R as defaultFile, U as DEFAULT_PROTECTED_BRANCHES, a as assertSafeBranch, V as ProtectedBranchError, f as CONFIG_FILE, l as loadConfig, W as ConfigError, X as DEFAULT_TOKEN_PATHS, c as collectHistory, p as packageDirCandidates, b as parseChangelog, r as releasesFromTags, m as mergeReleases, d as buildReport, Y as applyTokenEdits, Z as buildHistoryEntry, _ as resolveBranchPreviews, $ as tokensPath, a0 as coerceValue, a1 as toConfigJson, a2 as parseContrastChecks, a3 as checkLayeredPair, a4 as classifyRisk, a5 as formatChangeset, a6 as RISK_LABELS, a7 as parseJson, a8 as serializeJson, a9 as plainEqual, aa as toPlain, ab as getEntry, ac as fromPlain, ad as previewLinks, ae as slugify, af as readPreviewComment, ag as findPreviewComment, ah as previewsSettled } from "./component-spec-cvrSvIZj.js";
+import { ai, aj, ak, k, C, al, am, an, ao, ap, aq, ar, as, at, au, av, aw, ax, ay, az, aA, aB, aC, aD, aE, aF, aG, aH, aI, aJ, aK, aL, aM, aN, aO, i, aP, aQ, aR, aS, aT, aU, aV, aW, aX, aY, aZ, a_, a$, b0, b1, b2, b3, b4, b5, b6, b7, b8, b9, ba, bb, bc, bd, be, bf, bg, bh, bi, bj, bk, bl, bm, bn, bo, h, bp, j, bq, br, bs, bt, bu, bv, bw, bx, by, bz, g, bA, bB, bC, bD, bE, bF, bG, bH, bI, bJ, bK, bL, bM, bN, e, bO, bP, bQ, bR, bS, bT, bU, bV, bW, bX, bY, bZ, b_, b$, c0, c1, c2, c3, c4, c5, c6, c7, c8, t, c9, ca, cb, cc, cd, v, ce, cf, cg, ch } from "./component-spec-cvrSvIZj.js";
+import { a as collectRefs, i as isAlias, b as aliasTarget, v as valuesEqual, p as parseColor, e as rgbaToHex, f as formatValue, s as selectTokenFiles, L as LayeredTokenSet, j as validateLayered } from "./layered-BnbmToGs.js";
+import { D, d, k as k2, l, c, m, n, g as g2, h as h2, o, q, r, t as t2, u } from "./layered-BnbmToGs.js";
 const issueKey = (i2) => `${i2.code}|${i2.path ?? ""}|${i2.mode ?? ""}|${i2.code === "file-problem" ? i2.message : ""}`;
 const modeName = (mode) => mode === SINGLE_MODE ? "all modes" : modeDisplayName(mode);
 const isPalette = (t3) => t3.tier === "brand" && t3.path.startsWith("palette.");
@@ -54,7 +54,7 @@ function checkValue(set, owner, value, mode, where, issues) {
 }
 function validateSet(set, pairs) {
   const issues = [];
-  for (const p2 of set.problems) issues.push({ code: "file-problem", severity: "error", message: p2 });
+  for (const p of set.problems) issues.push({ code: "file-problem", severity: "error", message: p });
   for (const t3 of set.tokens.values()) {
     if (t3.scopes?.includes("ALL_SCOPES")) {
       issues.push({
@@ -102,20 +102,20 @@ function validateSet(set, pairs) {
     }
   }
   const axes = { brand: modesOf$1(set.layout, "brand"), theme: modesOf$1(set.layout, "semantic"), density: modesOf$1(set.layout, "density") };
-  for (const p2 of findReferenceProblems(set.byPath, axes)) {
+  for (const p of findReferenceProblems(set.byPath, axes)) {
     issues.push(
-      p2.kind === "broken" ? {
+      p.kind === "broken" ? {
         code: "broken-reference",
         severity: "error",
-        path: p2.path,
-        mode: p2.mode,
-        message: `${p2.path} points to ${p2.target}, which does not exist (${modeName(p2.mode)}).`
+        path: p.path,
+        mode: p.mode,
+        message: `${p.path} points to ${p.target}, which does not exist (${modeName(p.mode)}).`
       } : {
         code: "alias-cycle",
         severity: "error",
-        path: p2.path,
-        mode: p2.mode,
-        message: `${p2.path} is part of a loop of references: ${p2.chain.join(" -> ")} (${modeName(p2.mode)}).`
+        path: p.path,
+        mode: p.mode,
+        message: `${p.path} is part of a loop of references: ${p.chain.join(" -> ")} (${modeName(p.mode)}).`
       }
     );
   }
@@ -139,16 +139,16 @@ function validateSet(set, pairs) {
 }
 function shadowedEdits(set, edits) {
   const out = [];
-  for (const e3 of edits) {
-    if (e3.tier !== "semantic") continue;
+  for (const e2 of edits) {
+    if (e2.tier !== "semantic") continue;
     for (const o2 of set.overrides) {
-      if (o2.path !== e3.path || !e3.modes.includes(o2.theme)) continue;
+      if (o2.path !== e2.path || !e2.modes.includes(o2.theme)) continue;
       out.push({
         code: "override-shadowed",
         severity: "warning",
-        path: e3.path,
+        path: e2.path,
         mode: `${o2.brand}.${o2.theme}`,
-        message: `${e3.path} is overridden for ${modeDisplayName(o2.brand)} in ${o2.theme} (${o2.file}), so this edit does not change ${modeDisplayName(o2.brand)} ${o2.theme}. Brand overrides stay code-only.`
+        message: `${e2.path} is overridden for ${modeDisplayName(o2.brand)} in ${o2.theme} (${o2.file}), so this edit does not change ${modeDisplayName(o2.brand)} ${o2.theme}. Brand overrides stay code-only.`
       });
     }
   }
@@ -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 };
@@ -180,9 +180,9 @@ function levenshtein(a, b) {
   for (let i2 = 1; i2 <= a.length; i2++) {
     let diag = prev[0];
     prev[0] = i2;
-    for (let j3 = 1; j3 <= b.length; j3++) {
-      const tmp = prev[j3];
-      prev[j3] = Math.min(prev[j3] + 1, prev[j3 - 1] + 1, diag + (a[i2 - 1] === b[j3 - 1] ? 0 : 1));
+    for (let j2 = 1; j2 <= b.length; j2++) {
+      const tmp = prev[j2];
+      prev[j2] = Math.min(prev[j2] + 1, prev[j2 - 1] + 1, diag + (a[i2 - 1] === b[j2 - 1] ? 0 : 1));
       diag = tmp;
     }
   }
@@ -249,17 +249,263 @@ function applyConfirmedRenames(tokens, confirmed) {
 function idExtensionFor(t3) {
   return t3.id === pathId(t3.path) ? void 0 : t3.id;
 }
+const idOf$1 = (f) => {
+  const id = f.extensions?.[EXT_ID];
+  return typeof id === "string" && id ? id : pathId(f.path);
+};
+function logical(f) {
+  const scopes = f.extensions?.[EXT_SCOPES];
+  return {
+    id: idOf$1(f),
+    path: f.path,
+    type: f.type ?? "unknown",
+    // One file holds one tier: the tier only feeds default scopes, the same on every side.
+    tier: "primitive",
+    values: { [SINGLE_MODE]: f.value },
+    description: f.description,
+    scopes: Array.isArray(scopes) ? scopes.map(String) : void 0,
+    files: { [SINGLE_MODE]: f.file }
+  };
+}
+function readSide(file, text, problems, label) {
+  const side = { doc: void 0, flat: /* @__PURE__ */ new Map(), logical: /* @__PURE__ */ new Map() };
+  if (text === void 0) return side;
+  try {
+    side.doc = parseTokenFile(file, text);
+  } catch (err) {
+    problems.push(`${file} (${label}) is not valid JSON: ${err.message}`);
+    return side;
+  }
+  for (const f of flattenTokens(side.doc)) {
+    const id = idOf$1(f);
+    side.flat.set(id, f);
+    side.logical.set(id, logical(f));
+  }
+  return side;
+}
+function diffFile(input, file, problems) {
+  const base = readSide(file, input.base[file], problems, "shared start");
+  const mine = readSide(file, input.mine[file], problems, "this change");
+  const theirs = readSide(file, input.theirs[file], problems, "latest library");
+  const r2 = threeWayDiff(base.logical, mine.logical, theirs.logical);
+  return { file, base, mine, theirs, local: r2.local, remote: r2.remote, conflicts: r2.conflicts };
+}
+function removedSide(c10) {
+  if (!c10.base) return null;
+  if (!c10.mine && c10.theirs) return "mine";
+  if (!c10.theirs && c10.mine) return "theirs";
+  return null;
+}
+const defaultChoiceFor = (c10) => removedSide(c10) ? null : "mine";
+function planTokenMerge(input) {
+  const problems = [];
+  const files = [...new Set(input.files)].sort();
+  const conflicts = [];
+  let mineOnly = 0;
+  let theirsOnly = 0;
+  for (const file of files) {
+    const d2 = diffFile(input, file, problems);
+    mineOnly += d2.local.length;
+    theirsOnly += d2.remote.length;
+    for (const e2 of d2.conflicts) {
+      const c10 = { base: d2.base.flat.get(e2.id), mine: d2.mine.flat.get(e2.id), theirs: d2.theirs.flat.get(e2.id) };
+      conflicts.push({ key: `${file}#${e2.id}`, file, path: (c10.mine ?? c10.theirs ?? c10.base).path, ...c10, removedOn: removedSide(c10), defaultChoice: defaultChoiceFor(c10) });
+    }
+  }
+  return { files, conflicts, mineOnly, theirsOnly, problems };
+}
+const choiceFor = (c10, choices) => choices[c10.key] ?? c10.defaultChoice;
+function missingChoices(plan, choices) {
+  return plan.conflicts.filter((c10) => choiceFor(c10, choices) === null);
+}
+function takeMine(doc, mine, existing) {
+  if (!mine) return existing ? removeToken(doc, existing.path) : false;
+  let changed = false;
+  if (existing && existing.path !== mine.path) changed = removeToken(doc, existing.path) || changed;
+  const extensions = {};
+  for (const k3 of Object.keys(existing?.path === mine.path ? existing.extensions ?? {} : {})) extensions[k3] = void 0;
+  Object.assign(extensions, mine.extensions ?? {});
+  return upsertToken(doc, mine.path, { type: mine.type, value: mine.value, description: mine.description, extensions }) || changed;
+}
+function applyTokenMerge(input, choices) {
+  const plan = planTokenMerge(input);
+  if (plan.problems.length) throw new Error(plan.problems[0]);
+  const missing = missingChoices(plan, choices);
+  if (missing.length) throw new Error(`Pick a value for ${missing.map((c10) => c10.path).join(", ")} first.`);
+  const byKey = new Map(plan.conflicts.map((c10) => [c10.key, c10]));
+  const kept = { mine: 0, theirs: 0 };
+  const files = {};
+  for (const file of plan.files) {
+    const d2 = diffFile(input, file, []);
+    const doc = d2.theirs.doc ?? emptyTokenFile(file);
+    for (const e2 of d2.local) takeMine(doc, d2.mine.flat.get(e2.id), d2.theirs.flat.get(e2.id) ?? d2.base.flat.get(e2.id));
+    for (const e2 of d2.conflicts) {
+      const side = choiceFor(byKey.get(`${file}#${e2.id}`), choices);
+      kept[side]++;
+      if (side === "mine") takeMine(doc, d2.mine.flat.get(e2.id), d2.theirs.flat.get(e2.id));
+    }
+    const empty = flattenTokens(doc).length === 0;
+    files[file] = empty && (input.theirs[file] === void 0 || input.mine[file] === void 0) ? null : serializeTokenFile(doc);
+  }
+  return { files, kept };
+}
+const idOf = (f) => {
+  const id = f.extensions?.[EXT_ID];
+  return typeof id === "string" && id ? id : pathId(f.path);
+};
+function tokensOf(file, text, problems, label) {
+  const out = /* @__PURE__ */ new Map();
+  if (text === void 0) return out;
+  try {
+    for (const t3 of flattenTokens(parseTokenFile(file, text))) out.set(idOf(t3), t3);
+  } catch (err) {
+    problems.push(`${file} (${label}) is not valid JSON: ${err.message}`);
+  }
+  return out;
+}
+const shape = (t3) => t3 ? JSON.stringify([t3.path, t3.type ?? null, t3.value, t3.description ?? null]) : "removed";
+const look = (t3) => t3 ? JSON.stringify([t3.path, t3.type ?? null, t3.value]) : "removed";
+function changeEdits(src) {
+  const problems = [];
+  const edits = [];
+  for (const file of [...new Set(src.files)].sort()) {
+    const before = tokensOf(file, src.base[file], problems, "start");
+    const after = tokensOf(file, src.head[file], problems, `change ${src.number}`);
+    for (const id of /* @__PURE__ */ new Set([...before.keys(), ...after.keys()])) {
+      const a = before.get(id);
+      const b = after.get(id);
+      if (shape(a) === shape(b)) continue;
+      edits.push({ key: `${file}#${id}`, file, path: (b ?? a).path, change: src.number, token: b });
+    }
+  }
+  return { number: src.number, edits, problems };
+}
+function byToken(changes) {
+  const out = /* @__PURE__ */ new Map();
+  for (const c10 of changes) for (const e2 of c10.edits) out.set(e2.key, [...out.get(e2.key) ?? [], e2]);
+  return out;
+}
+function optionsOf(edits) {
+  const out = [];
+  for (const e2 of edits) {
+    const l2 = look(e2.token);
+    const hit = out.find((o2) => o2.look === l2);
+    if (hit) hit.option.changes.push(e2.change);
+    else out.push({ look: l2, option: { changes: [e2.change], token: e2.token } });
+  }
+  return out.map((o2) => o2.option);
+}
+function combineConflicts(changes) {
+  const out = [];
+  for (const [key, edits] of byToken(changes)) {
+    const options = optionsOf(edits);
+    if (options.length > 1) out.push({ key, file: edits[0].file, path: edits[0].path, options });
+  }
+  return out;
+}
+function pickedOption(c10, picks) {
+  const n2 = picks[c10.key];
+  return n2 === void 0 ? null : c10.options.find((o2) => o2.changes.includes(n2)) ?? null;
+}
+const unpicked = (conflicts, picks) => conflicts.filter((c10) => !pickedOption(c10, picks));
+function combineChanges(latest, changes, picks = {}, opts = {}) {
+  const on = opts.include ? changes.filter((c10) => opts.include.includes(c10.number)) : changes;
+  const problems = on.flatMap((c10) => c10.problems);
+  const groups = byToken(on);
+  const conflicts = [];
+  const missing = [];
+  const from = {};
+  const docs = /* @__PURE__ */ new Map();
+  const docOf = (file) => {
+    if (docs.has(file)) return docs.get(file);
+    const text = latest[file];
+    let doc;
+    try {
+      doc = text === void 0 ? emptyTokenFile(file) : parseTokenFile(file, text);
+    } catch (err) {
+      problems.push(`${file} (latest library) is not valid JSON: ${err.message}`);
+      return null;
+    }
+    docs.set(file, doc);
+    return doc;
+  };
+  for (const [key, edits] of groups) {
+    const options = optionsOf(edits);
+    let use = options[0];
+    if (options.length > 1) {
+      const conflict = { key, file: edits[0].file, path: edits[0].path, options };
+      conflicts.push(conflict);
+      use = pickedOption(conflict, picks);
+      if (!use) {
+        missing.push(conflict);
+        use = opts.unpicked === "first" ? options[0] : null;
+      }
+    }
+    if (!use) continue;
+    const doc = docOf(edits[0].file);
+    if (!doc) continue;
+    const existing = flattenTokens(doc).find((t3) => idOf(t3) === key.slice(key.indexOf("#") + 1));
+    takeMine(doc, use.token, existing);
+    const path = use.token?.path ?? edits[0].path;
+    from[path] = [.../* @__PURE__ */ new Set([...from[path] ?? [], ...use.changes])];
+  }
+  const files = { ...latest };
+  for (const [file, doc] of docs) {
+    if (latest[file] === void 0 && flattenTokens(doc).length === 0) continue;
+    files[file] = serializeTokenFile(doc);
+  }
+  const tokens = new Set([...groups.values()].map((e2) => e2[0].path)).size;
+  return { files, included: on.map((c10) => c10.number), edits: groups.size, tokens, conflicts, missing, from, problems };
+}
+function encodePicks(picks) {
+  return Object.entries(picks).filter(([, n2]) => Number.isSafeInteger(n2) && n2 > 0).sort(([a], [b]) => a.localeCompare(b)).map(([key, n2]) => `${n2}:${key}`).join("~");
+}
+function decodePicks(raw) {
+  const out = {};
+  for (const part of (raw ?? "").split("~")) {
+    const i2 = part.indexOf(":");
+    if (i2 < 1) continue;
+    const n2 = Number(part.slice(0, i2));
+    const key = part.slice(i2 + 1);
+    if (/^\d{1,7}$/.test(part.slice(0, i2)) && n2 > 0 && key.includes("#")) out[key] = n2;
+  }
+  return out;
+}
+function cssOf(type, value) {
+  if (value === void 0) return void 0;
+  if (type === "color") {
+    const hex = value && typeof value === "object" ? value.hex : void 0;
+    const c10 = parseColor(value);
+    if (!c10) return void 0;
+    if (c10.a < 1) return `rgb(${Math.round(c10.r * 255)} ${Math.round(c10.g * 255)} ${Math.round(c10.b * 255)} / ${c10.a})`;
+    return typeof hex === "string" ? hex.toLowerCase() : rgbaToHex(c10);
+  }
+  return formatValue(type, value);
+}
+const cssVarOf = (path) => `--${path.replace(/\./g, "-")}`;
+function previewOverrides(head, proposed, ctx) {
+  const out = {};
+  const hctx = { ...ctx, overrides: head.overrideIndex };
+  const pctx = { ...ctx, overrides: proposed.overrideIndex };
+  for (const t3 of proposed.byPath.values()) {
+    const a = resolve(head.byPath, t3.path, hctx);
+    const b = resolve(proposed.byPath, t3.path, pctx);
+    const css = cssOf(t3.type, b.value);
+    if (css !== void 0 && JSON.stringify(a.value) !== JSON.stringify(b.value)) out[cssVarOf(t3.path)] = css;
+  }
+  return out;
+}
 const modesOf = (t3) => Object.keys(t3.values);
 function composeFiles(head, originals, changes) {
   const docs = /* @__PURE__ */ new Map();
   const doc = (file) => {
-    let d = docs.get(file);
-    if (!d) {
+    let d2 = docs.get(file);
+    if (!d2) {
       const text = originals[file];
-      d = text === void 0 ? emptyTokenFile(file) : parseTokenFile(file, text);
-      docs.set(file, d);
+      d2 = text === void 0 ? emptyTokenFile(file) : parseTokenFile(file, text);
+      docs.set(file, d2);
     }
-    return d;
+    return d2;
   };
   const fileFor = (t3, mode, current) => current?.files[mode] ?? t3.files[mode] ?? (isMultiMode(t3.tier) ? modeFile(head.layout, t3.tier, mode) : void 0) ?? defaultFile(t3.tier, t3.path, head.options.dirs);
   for (const { target, current } of changes) {
@@ -270,9 +516,9 @@ function composeFiles(head, originals, changes) {
     const renamed = !!current && current.path !== target.path;
     if (current) {
       for (const mode of modesOf(current)) {
-        const d = doc(fileFor(current, mode));
-        if (target.values[mode] === void 0) removeToken(d, current.path);
-        else if (renamed) moveToken(d, current.path, target.path);
+        const d2 = doc(fileFor(current, mode));
+        if (target.values[mode] === void 0) removeToken(d2, current.path);
+        else if (renamed) moveToken(d2, current.path, target.path);
       }
     }
     const targetScopes = effectiveScopes(target);
@@ -280,14 +526,14 @@ function composeFiles(head, originals, changes) {
     const scopesChanged = !current || !sameScopes(targetScopes, effectiveScopes(current));
     const descChanged = (target.description ?? "").trim() !== (current?.description ?? "").trim();
     for (const mode of modesOf(target)) {
-      const d = doc(fileFor(target, mode, current));
-      const existing = readTokenAt(d, target.path);
+      const d2 = doc(fileFor(target, mode, current));
+      const existing = readTokenAt(d2, target.path);
       const currentValue = current?.values[mode];
       const value = currentValue !== void 0 && valuesEqual(target.type, target.values[mode], currentValue) ? currentValue : target.values[mode];
       const extensions = {};
       if (scopesChanged) extensions[EXT_SCOPES] = scopesExt;
       if (renamed || !existing) extensions[EXT_ID] = idExtensionFor(target);
-      upsertToken(d, target.path, {
+      upsertToken(d2, target.path, {
         type: target.type,
         value,
         description: descChanged || !existing ? target.description : existing.description,
@@ -297,144 +543,198 @@ function composeFiles(head, originals, changes) {
   }
   const files = {};
   const allFiles = { ...originals };
-  for (const [file, d] of docs) {
-    const text = serializeTokenFile(d);
+  for (const [file, d2] of docs) {
+    const text = serializeTokenFile(d2);
     allFiles[file] = text;
     if (text !== originals[file]) files[file] = text;
   }
   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];
+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
+      }
+    }
+  ];
+  if (checks.length) {
+    rules.push({
+      type: "required_status_checks",
+      parameters: {
+        strict_required_status_checks_policy: false,
+        required_status_checks: checks.map((context) => ({ context }))
+      }
+    });
+  }
+  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" }] : []
+  };
 }
-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 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));
 }
-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 refPattern(pattern) {
+  const src = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*\*/g, "\0").replace(/\*/g, "[^/]*").replace(/\?/g, "[^/]").replace(/\u0000/g, ".*");
+  return new RegExp(`^${src}$`);
 }
-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 rulesetTargetsDefault(ruleset, defaultBranch) {
+  if (ruleset.target && ruleset.target !== "branch") return false;
+  const ref = `refs/heads/${defaultBranch}`;
+  const hit = (p) => p === "~ALL" || p === "~DEFAULT_BRANCH" || p === ref || p === defaultBranch || refPattern(p.startsWith("refs/") ? p : `refs/heads/${p}`).test(ref);
+  const cond = ruleset.conditions?.ref_name;
+  if (!cond) return false;
+  if ((cond.exclude ?? []).some(hit)) return false;
+  return (cond.include ?? []).some(hit);
 }
-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;
-    }
-    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);
+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");
   }
-  for (const k3 of Object.keys(byVar)) byVar[k3].sort();
-  return { componentsDir: dir, modules, byVar, globalVars };
+  return parts;
 }
-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);
-    }
+function classicParts(p) {
+  const parts = /* @__PURE__ */ new Set();
+  if (count(p.required_pull_request_reviews?.required_approving_review_count) >= 1) parts.add("review");
+  if (((p.required_status_checks?.contexts?.length ?? 0) || (p.required_status_checks?.checks?.length ?? 0)) > 0) parts.add("checks");
+  if (!p.allow_force_pushes?.enabled) parts.add("history");
+  if (!p.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((p) => covered.add(p));
   }
-  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 };
+  if (branchProtection) classicParts(branchProtection).forEach((p) => covered.add(p));
+  const missing = PROTECTION_PARTS.filter((p) => !covered.has(p));
+  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 };
 }
-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 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((p) => PROTECTION_PART_PHRASE[p]));
+      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((p2) => p2.trim().split("=")[0].trim()).filter((p2) => p2 && p2 !== "metadata");
+    if (first.length) return first[0];
+  }
+  const p = path.replace(/[?#].*$/, "");
+  if (/\/repos\/[^/]+\/[^/]+\/(issues|labels|milestones)(\/|$)/.test(p)) return "issues";
+  if (/\/repos\/[^/]+\/[^/]+\/pulls(\/|$)/.test(p)) return "pull_requests";
+  if (/\/repos\/[^/]+\/[^/]+\/(rulesets(\/|$)|branches\/.+\/protection$)/.test(p)) return "administration";
+  if (/\/repos\/[^/]+\/[^/]+\/(contents|git|commits|branches|merges)(\/|$)/.test(p)) return "contents";
+  if (/\/repos\/[^/]+\/[^/]+\/(check-runs|check-suites)(\/|$)/.test(p)) return "checks";
+  if (/\/repos\/[^/]+\/[^/]+\/statuses(\/|$)/.test(p)) return "statuses";
+  if (/\/repos\/[^/]+\/[^/]+\/deployments(\/|$)/.test(p)) return "deployments";
+  if (/\/repos\/[^/]+\/[^/]+\/actions(\/|$)/.test(p)) return "actions";
+  return void 0;
+}
+const PERMISSION_DENIED = /not accessible by (personal access token|integration)|must have (admin|push|write) (rights|access)|write access to repository not granted|permission to .* denied/i;
+function classifyAuth(status, detail, opts = {}) {
+  if (status === 401 && opts.withToken !== false) return { auth: "rejected" };
+  if (status !== 403 || /rate limit|archived/i.test(detail)) return {};
+  if (opts.acceptedPermissions || PERMISSION_DENIED.test(detail)) {
+    return { auth: "missing-permission", permission: requiredPermission(opts.path ?? "", opts.acceptedPermissions) };
+  }
+  return {};
 }
 const 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 +797,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}`;
@@ -508,8 +808,8 @@ class GitHubClient {
       try {
         return await this.once(method, path, body);
       } catch (err) {
-        const e3 = err;
-        if (attempt >= attempts || !(e3 instanceof GitHubError) || !isTransient(e3.status, e3.detail ?? "")) throw err;
+        const e2 = err;
+        if (attempt >= attempts || !(e2 instanceof GitHubError) || !isTransient(e2.status, e2.detail ?? "")) throw err;
         await this.retry.sleep(this.retry.baseDelayMs * 2 ** (attempt - 1));
       }
     }
@@ -532,7 +832,7 @@ class GitHubClient {
       let detail = "";
       try {
         const data = await res.json();
-        detail = [data.message, ...(data.errors ?? []).map((e3) => typeof e3 === "string" ? e3 : e3.message)].filter(Boolean).join(" ");
+        detail = [data.message, ...(data.errors ?? []).map((e2) => typeof e2 === "string" ? e2 : e2.message)].filter(Boolean).join(" ");
       } catch {
         detail = "";
       }
@@ -546,7 +846,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();
   }
@@ -611,7 +916,7 @@ class GitHubClient {
   /** Pull requests a commit belongs to (merged ones first): how a commit on main finds its PR. */
   async listPullRequestsForCommit(sha) {
     const r2 = await this.request("GET", `${this.repoPath}/commits/${encodeRef(sha)}/pulls`);
-    return r2.map((p2) => ({ ...toSummary(p2), body: p2.body ?? "", ...p2.merged_at ? { mergedAt: p2.merged_at } : {}, ...p2.merge_commit_sha ? { mergeCommitSha: p2.merge_commit_sha } : {} })).sort((a, b) => Number(Boolean(b.mergedAt)) - Number(Boolean(a.mergedAt)));
+    return r2.map((p) => ({ ...toSummary(p), body: p.body ?? "", ...p.merged_at ? { mergedAt: p.merged_at } : {}, ...p.merge_commit_sha ? { mergeCommitSha: p.merge_commit_sha } : {} })).sort((a, b) => Number(Boolean(b.mergedAt)) - Number(Boolean(a.mergedAt)));
   }
   /** Tags with the commit they point to, newest first as GitHub lists them. */
   async listTags(perPage = 30) {
@@ -692,10 +997,29 @@ class GitHubClient {
       variables: { id: pr.node_id }
     });
     if (r2?.errors?.length) {
-      const detail = r2.errors.map((e3) => e3.message).filter(Boolean).join(" ");
+      const detail = r2.errors.map((e2) => e2.message).filter(Boolean).join(" ");
       throw new GitHubError(422, `GitHub refused to mark #${n2} ready for review${detail ? `: ${detail}` : "."} Use "Ready for review" on GitHub instead.`, detail);
     }
   }
+  /**
+   * Turns an open pull request back into a draft: the GraphQL mutation convertPullRequestToDraft (REST cannot set
+   * `draft` either), same token. No-op when it is already a draft.
+   */
+  async convertToDraft(n2) {
+    this.assertToken("Turning a pull request back into a draft");
+    const pr = await this.request("GET", `${this.repoPath}/pulls/${n2}`);
+    if (pr.draft === true) return;
+    if (pr.state && pr.state !== "open") throw new GitHubError(422, `Pull request #${n2} is ${pr.state}: only an open one can go back to draft.`);
+    if (!pr.node_id) throw new GitHubError(422, `Pull request #${n2} has no node id: convert it to draft on GitHub.`);
+    const r2 = await this.request("POST", "/graphql", {
+      query: "mutation($id: ID!) { convertPullRequestToDraft(input: { pullRequestId: $id }) { pullRequest { number isDraft } } }",
+      variables: { id: pr.node_id }
+    });
+    if (r2?.errors?.length) {
+      const detail = r2.errors.map((e2) => e2.message).filter(Boolean).join(" ");
+      throw new GitHubError(422, `GitHub refused to turn #${n2} back into a draft${detail ? `: ${detail}` : "."} Use "Convert to draft" on GitHub instead.`, detail);
+    }
+  }
   async createPullRequest(input) {
     this.assertWritableBranch(input.head, input.base);
     const r2 = await this.request(
@@ -725,6 +1049,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 +1074,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);
@@ -806,7 +1196,7 @@ class GitHubClient {
       const q2 = ref ? `?ref=${encodeURIComponent(ref)}` : "";
       const r2 = await this.request("GET", `${this.repoPath}/contents/${encodeRef(path)}${q2}`);
       if (!Array.isArray(r2)) return [];
-      return r2.map((e3) => ({ name: e3.name, path: e3.path, type: e3.type, sha: e3.sha, size: e3.size ?? 0 }));
+      return r2.map((e2) => ({ name: e2.name, path: e2.path, type: e2.type, sha: e2.sha, size: e2.size ?? 0 }));
     } catch (err) {
       if (err instanceof GitHubError && err.status === 404) return [];
       throw err;
@@ -859,7 +1249,7 @@ class GitHubClient {
   async listFiles(ref) {
     const r2 = await this.request("GET", `${this.repoPath}/git/trees/${encodeRef(ref)}?recursive=1`);
     if (r2.truncated) throw new GitHubError(413, "The repository tree is too large to read in one request.");
-    return r2.tree.filter((e3) => e3.type === "blob").map((e3) => e3.path);
+    return r2.tree.filter((e2) => e2.type === "blob").map((e2) => e2.path);
   }
   // --- Pull requests, reviews, checks ---------------------------------------------------------
   async listPullRequests(state = "open") {
@@ -873,13 +1263,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 d2 of list) if (!latest.has(d2.environment)) latest.set(d2.environment, d2);
+    return Promise.all(
+      [...latest.values()].map(async (d2) => {
+        const st = await this.request("GET", `${this.repoPath}/deployments/${d2.id}/statuses?per_page=1`).catch(() => []);
+        const s = st[0];
+        return { id: d2.id, environment: d2.environment, state: s?.state ?? null, environmentUrl: s?.environment_url || null };
+      })
+    );
+  }
   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 +1317,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 +1371,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((p) => p.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 +1396,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.";
@@ -975,7 +1425,7 @@ async function loadRepoFiles(client, commitSha, fallbackTokensPath) {
   const warnings = [];
   let config;
   let configText;
-  const configEntry = entries.find((e3) => e3.type === "blob" && e3.path === CONFIG_FILE);
+  const configEntry = entries.find((e2) => e2.type === "blob" && e2.path === CONFIG_FILE);
   if (configEntry) {
     try {
       configText = await client.getBlobText(configEntry.sha);
@@ -988,16 +1438,16 @@ async function loadRepoFiles(client, commitSha, fallbackTokensPath) {
   const checksFile = config?.tokens.contrastChecks ?? DEFAULT_TOKEN_PATHS.contrastChecks;
   const prefix = tokensPath2 + "/";
   const wanted = entries.filter(
-    (e3) => e3.type === "blob" && e3.path.startsWith(prefix) && (e3.path.endsWith(".tokens.json") || e3.path === prefix + checksFile)
+    (e2) => e2.type === "blob" && e2.path.startsWith(prefix) && (e2.path.endsWith(".tokens.json") || e2.path === prefix + checksFile)
   );
-  if (!wanted.some((e3) => e3.path.endsWith(".tokens.json"))) throw new Error(`No *.tokens.json files found under ${tokensPath2} at ${commitSha.slice(0, 7)}.`);
+  if (!wanted.some((e2) => e2.path.endsWith(".tokens.json"))) throw new Error(`No *.tokens.json files found under ${tokensPath2} at ${commitSha.slice(0, 7)}.`);
   const files = {};
   let contrastChecks;
   const queue = [...wanted];
   const worker = async () => {
-    for (let e3 = queue.shift(); e3; e3 = queue.shift()) {
-      const text = await client.getBlobText(e3.sha);
-      const rel = e3.path.slice(prefix.length);
+    for (let e2 = queue.shift(); e2; e2 = queue.shift()) {
+      const text = await client.getBlobText(e2.sha);
+      const rel = e2.path.slice(prefix.length);
       if (rel === checksFile) contrastChecks = text;
       else files[rel] = text;
     }
@@ -1005,6 +1455,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,47 +1473,197 @@ 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);
-    }
-    return t3;
-  };
-  const root = config.tokens.root.replace(/\/$/, "");
-  const prefix = root === "." || !root ? "" : `${root}/`;
-  const limit = Math.max(1, opts.concurrency ?? 4);
-  const pool = async (items, fn) => {
-    const out = new Array(items.length);
-    let i2 = 0;
-    await Promise.all(Array.from({ length: Math.min(limit, items.length) }, async () => {
-      for (let k3 = i2++; k3 < items.length; k3 = i2++) out[k3] = await fn(items[k3]);
-    }));
-    return out;
-  };
-  return {
-    tree,
-    async listCommits({ ref, paths, limit: max }) {
-      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() });
-        }
-        if (batch.length < Math.min(100, max)) break;
-      }
-      const list = commits.slice(0, max);
+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((p) => p.state === "merged" && p.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 = (p) => p.replace(/\\/g, "/").replace(/\/+$/, "");
+const isStory = (p) => /\.stories\.[cm]?[jt]sx?$/.test(p);
+const isTest = (p) => /\.(test|spec)\.[cm]?[jt]sx?$/.test(p);
+const isCss = (p) => /\.(css|scss|less)$/.test(p);
+const isScript = (p) => /\.[cm]?[jt]sx?$/.test(p);
+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 p = norm(path);
+  if (!p.startsWith(`${dir}/`)) return null;
+  const rest = p.slice(dir.length + 1).split("/");
+  return rest.length >= 2 ? rest[0] : null;
+}
+function buildUsageIndex(files, componentsDir) {
+  const dir = norm(componentsDir);
+  const 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;
+    }
+    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((d2) => !mod.imports.includes(d2)).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 d2 of m2.imports) (renderedBy.get(d2) ?? renderedBy.set(d2, []).get(d2)).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 p = queue.pop();
+    if (used.has(p)) continue;
+    used.add(p);
+    for (const r2 of byPath.get(p)?.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}/`;
+  const limit = Math.max(1, opts.concurrency ?? 4);
+  const pool = async (items, fn) => {
+    const out = new Array(items.length);
+    let i2 = 0;
+    await Promise.all(Array.from({ length: Math.min(limit, items.length) }, async () => {
+      for (let k3 = i2++; k3 < items.length; k3 = i2++) out[k3] = await fn(items[k3]);
+    }));
+    return out;
+  };
+  return {
+    tree,
+    async listCommits({ ref, paths, limit: max }) {
+      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 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 pr = prs.find((p2) => p2.mergedAt && p2.baseRef === ref) ?? prs.find((p2) => p2.mergedAt);
-        if (!pr) return c2;
+      const enriched = await pool(list, async (c10) => {
+        const prs = await client.listPullRequestsForCommit(c10.sha).catch(() => []);
+        const pr = prs.find((p) => p.mergedAt && p.baseRef === ref) ?? prs.find((p) => p.mergedAt);
+        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,26 +1678,26 @@ 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;
     },
     async tokenFiles(sha) {
       const entries = await tree(sha);
-      const blobs = entries.filter((e3) => e3.type === "blob" && e3.path.startsWith(prefix));
-      const picked = new Set(selectTokenFiles(config, blobs.map((e3) => e3.path)));
-      const wanted = blobs.filter((e3) => picked.has(prefix ? e3.path.slice(prefix.length) : e3.path));
-      const texts = await pool(wanted, async (e3) => [prefix ? e3.path.slice(prefix.length) : e3.path, await client.getBlobText(e3.sha)]);
+      const blobs = entries.filter((e2) => e2.type === "blob" && e2.path.startsWith(prefix));
+      const picked = new Set(selectTokenFiles(config, blobs.map((e2) => e2.path)));
+      const wanted = blobs.filter((e2) => picked.has(prefix ? e2.path.slice(prefix.length) : e2.path));
+      const texts = await pool(wanted, async (e2) => [prefix ? e2.path.slice(prefix.length) : e2.path, await client.getBlobText(e2.sha)]);
       return new Map(texts);
     },
     async changesetPaths(sha) {
       const dir = config.changesets?.dir.replace(/\/$/, "");
       if (!dir) return [];
-      return (await tree(sha)).filter((e3) => e3.type === "blob" && e3.path.startsWith(`${dir}/`)).map((e3) => e3.path);
+      return (await tree(sha)).filter((e2) => e2.type === "blob" && e2.path.startsWith(`${dir}/`)).map((e2) => e2.path);
     },
     async readFile(sha, path) {
-      const e3 = (await tree(sha)).find((x) => x.type === "blob" && x.path === path);
-      return e3 ? client.getBlobText(e3.sha) : null;
+      const e2 = (await tree(sha)).find((x) => x.type === "blob" && x.path === path);
+      return e2 ? client.getBlobText(e2.sha) : null;
     }
   };
 }
@@ -1114,9 +1718,9 @@ async function loadGitHubHistory(client, config, opts = {}) {
   if (head) {
     const files = await backend.tree(head).catch(() => []);
     for (const dir of packageDirCandidates(config)) {
-      const p2 = (f) => dir ? `${dir}/${f}` : f;
-      const cl = files.find((e3) => e3.path === p2("CHANGELOG.md"));
-      const pkg = files.find((e3) => e3.path === p2("package.json"));
+      const p = (f) => dir ? `${dir}/${f}` : f;
+      const cl = files.find((e2) => e2.path === p("CHANGELOG.md"));
+      const pkg = files.find((e2) => e2.path === p("package.json"));
       if (!cl && !pkg) continue;
       if (cl) changelog = parseChangelog(await client.getBlobText(cl.sha));
       if (pkg) {
@@ -1164,17 +1768,47 @@ function demoHistory(config, current) {
   }
   const entries = [];
   kept.forEach((step, i2) => {
-    const e3 = buildHistoryEntry({
+    const e2 = buildHistoryEntry({
       config,
       commit: { sha: `demo${String(step.pr).padStart(36, "0")}`, parents: [`demo${String(step.pr - 1).padStart(36, "0")}`], date: step.date, author: step.author, subject: step.title, body: step.why, pr: { number: step.pr, title: step.title, author: step.author, mergedAt: step.date, body: step.why } },
       before: states[i2],
       after: states[i2 + 1],
       demo: true
     });
-    if (e3) entries.push(e3);
+    if (e2) entries.push(e2);
   });
   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 p = await gh.getPullRequest(ref);
+      branch ??= p.headRef;
+      sha ??= p.headSha;
+    }
+  } else {
+    sha = ref;
+    if (!branch || !opts.comments) {
+      const open = (await gh.listPullRequestsForCommit(ref).catch(() => [])).find((p) => p.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 +1830,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);
 }
@@ -1286,12 +1920,12 @@ const brandDisplayName = (slug) => slug.split("-").filter(Boolean).map((w) => w[
 function brandLayers(config) {
   const out = {};
   for (const l2 of config.tokens.layers) {
-    const ph = (l2.files.match(/\{([^}]+)\}/g) ?? []).map((p2) => p2.slice(1, -1));
+    const ph = (l2.files.match(/\{([^}]+)\}/g) ?? []).map((p) => p.slice(1, -1));
     if (!ph.includes("brand")) continue;
     if (ph.length === 1 && !out.brand) out.brand = l2.files;
     else if (ph.length === 2 && !out.override) {
       out.override = l2.files;
-      out.overrideAxis = ph.find((p2) => p2 !== "brand");
+      out.overrideAxis = ph.find((p) => p !== "brand");
     }
   }
   return out;
@@ -1426,7 +2060,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 {
@@ -1434,8 +2068,8 @@ function planNewBrand(source, input) {
       if (r2.issue) issues.push({ ...r2.issue, path: `palette.${role}` });
       anchors[role] = r2.anchor;
       return r2.ramp;
-    } catch (e3) {
-      issues.push({ level: "error", code: "invalid-color", message: e3.message, path: `palette.${role}` });
+    } catch (e2) {
+      issues.push({ level: "error", code: "invalid-color", message: e2.message, path: `palette.${role}` });
       return void 0;
     }
   };
@@ -1520,7 +2154,7 @@ function planNewBrand(source, input) {
   const primDir = config.tokens.tiers.primitive?.[0]?.replace(/\/$/, "") ?? config.tokens.primitives;
   const primFile = `${primDir}/${slug}.tokens.json`;
   if (prims.size && files.has(primFile)) issues.push({ level: "error", code: "slug-file-exists", message: `${tokensPath(config, primFile)} already exists. Pick another name.` });
-  for (const r2 of prims.keys()) if (before.allPaths().some((p2) => p2.startsWith(`color.${r2}.`))) issues.push({ level: "error", code: "ramp-exists", message: `A primitive ramp color.${r2} already exists. Pick another name.` });
+  for (const r2 of prims.keys()) if (before.allPaths().some((p) => p.startsWith(`color.${r2}.`))) issues.push({ level: "error", code: "ramp-exists", message: `A primitive ramp color.${r2} already exists. Pick another name.` });
   doc.$description = `${name}: created with Bridge, started from ${blank ? "a blank brand" : brandDisplayName(from)}.`;
   doc.$extensions = { ...isObj(doc.$extensions) ? doc.$extensions : {}, "dev.bridge.brand": { name, from, ...Object.keys(anchors).length ? { anchors } : {} } };
   const { $description, $extensions, ...rest } = doc;
@@ -1562,8 +2196,8 @@ function planNewBrand(source, input) {
   try {
     configText = addBrandToConfigText(baseConfigText, slug);
     nextConfig = issues.some((i2) => i2.code.startsWith("slug-")) ? config : loadConfig(configText);
-  } catch (e3) {
-    issues.push({ level: "error", code: "config", message: e3.message });
+  } catch (e2) {
+    issues.push({ level: "error", code: "config", message: e2.message });
   }
   const after = new LayeredTokenSet(nextConfig, nextFiles);
   const key = (i2) => `${i2.code}|${i2.path ?? ""}|${i2.message}`;
@@ -1576,10 +2210,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((p) => checkLayeredPair(after, p, 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 });
@@ -1591,7 +2225,7 @@ function planNewBrand(source, input) {
       if (JSON.stringify(r2) !== JSON.stringify(ramps.primary)) ramps[role] = r2;
     }
   }
-  const addedTokens = after.defs.filter((d) => created.includes(d.file)).map((d) => ({ kind: "added", path: d.path }));
+  const addedTokens = after.defs.filter((d2) => created.includes(d2.file)).map((d2) => ({ kind: "added", path: d2.path }));
   const risk = classifyRisk({ tokenChanges: addedTokens, files: [{ path: CONFIG_FILE, status: "modified" }], config });
   const planned = [
     ...created.map((f) => ({ path: tokensPath(config, f), action: "create", content: nextFiles.get(f) })),
@@ -1653,10 +2287,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",
     "",
@@ -1743,21 +2377,21 @@ function cssModuleClasses(css) {
 const cell$1 = (s) => s.replace(/\|/g, "\\|").replace(/\n/g, " ");
 function propsTable(name, props, inherits) {
   if (!props.length) return inherits ? `${name} has no props of its own. It accepts every native <${inherits}> attribute.` : "";
-  const rows = props.map((p2) => `| \`${p2.name}\`${p2.required ? " (required)" : ""} | \`${cell$1(p2.type)}\` | ${p2.defaultValue ? `\`${cell$1(p2.defaultValue)}\`` : ""} | ${cell$1(p2.description ?? "")} |`);
+  const rows = props.map((p) => `| \`${p.name}\`${p.required ? " (required)" : ""} | \`${cell$1(p.type)}\` | ${p.defaultValue ? `\`${cell$1(p.defaultValue)}\`` : ""} | ${cell$1(p.description ?? "")} |`);
   const tail = inherits ? `
 
 Also accepts every native <${inherits}> attribute.` : "";
   return ["| Prop | Type | Default | Description |", "| --- | --- | --- | --- |", ...rows].join("\n") + tail;
 }
 const isEmpty = (v2) => v2 === void 0 || v2 === null || typeof v2 === "string" && !v2.trim() || Array.isArray(v2) && v2.length === 0;
-function missingProse(d) {
-  return PROSE_KEYS.filter((k3) => isEmpty(d?.[k3]));
+function missingProse(d2) {
+  return PROSE_KEYS.filter((k3) => isEmpty(d2?.[k3]));
 }
 function prefillDocs(input) {
   const existing = input.existing ?? null;
   const anatomy = {};
-  for (const c2 of input.cssClasses) anatomy[c2] = existing?.anatomy?.[c2] ?? anatomyLabel(c2);
-  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"}).`);
+  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((p) => `${p.foreground} on ${p.background}: ${p.ratio.toFixed(2)}:1 at worst over every brand and theme, needs ${p.min}:1 (${p.ratio >= p.min ? "passes" : "fails"}).`);
   const missing = missingProse(existing);
   const changelogLine = input.change ? `${input.name}: ${input.change.replace(/\.$/, "")}.` : missing.length === PROSE_KEYS.length ? `${input.name}: usage guidance added.` : `${input.name}: usage guidance updated.`;
   const draft = {
@@ -1773,6 +2407,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 +2422,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 +2447,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 shape2 = 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.",
+    ...shape2,
     "",
     "Facts computed from the code:",
     facts.join("\n\n"),
@@ -1819,23 +2482,35 @@ ${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(d2, sections) {
+  if (!sections) {
+    const { draftedSections: _all, ...rest } = d2;
+    return { ...rest, draftedBy: "claude", needsReview: true };
+  }
+  const waiting = d2.needsReview === true ? d2.draftedSections ?? (d2.draftedBy ? [...PROSE_KEYS] : []) : [];
+  const union = PROSE_KEYS.filter((k3) => waiting.includes(k3) || sections.includes(k3));
+  return { ...d2, draftedBy: "claude", needsReview: true, draftedSections: union };
+}
+function sectionsNeedingReview(d2) {
+  if (!d2 || d2.needsReview !== true) return [];
+  return d2.draftedSections ? PROSE_KEYS.filter((k3) => d2.draftedSections.includes(k3)) : [...PROSE_KEYS];
 }
-const needsDocsReview = (d) => Boolean(d && d.needsReview === true);
-function acceptDocsDraft(d) {
-  return { ...d, needsReview: false };
+const needsDocsReview = (d2) => Boolean(d2 && d2.needsReview === true);
+function acceptDocsDraft(d2) {
+  const { draftedSections: _done, ...rest } = d2;
+  return { ...rest, needsReview: false };
 }
-function formatDocsJson(d) {
-  const order = ["summary", "category", "status", ...DOCS_KEYS.filter((k3) => k3 !== "summary"), "draftedBy", "needsReview"];
+function formatDocsJson(d2) {
+  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;
+  for (const k3 of order) if (d2[k3] !== void 0) out[k3] = d2[k3];
+  for (const [k3, v2] of Object.entries(d2)) if (!(k3 in out) && v2 !== void 0) out[k3] = v2;
   return `${JSON.stringify(out, null, 2)}
 `;
 }
@@ -1843,7 +2518,7 @@ function patchNode(old, next) {
   if (plainEqual(toPlain(old), next)) return old;
   if (old.kind === "object" && next && typeof next === "object" && !Array.isArray(next)) {
     const n2 = next;
-    const kept = old.entries.filter((e3) => n2[e3.key] !== void 0).map((e3) => ({ key: e3.key, value: patchNode(e3.value, n2[e3.key]) }));
+    const kept = old.entries.filter((e2) => n2[e2.key] !== void 0).map((e2) => ({ key: e2.key, value: patchNode(e2.value, n2[e2.key]) }));
     const added = Object.keys(n2).filter((k3) => n2[k3] !== void 0 && !getEntry(old, k3)).map((k3) => ({ key: k3, value: fromPlain(n2[k3], void 0, old.inline) }));
     return { kind: "object", inline: old.inline, entries: [...kept, ...added] };
   }
@@ -1867,6 +2542,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((p) => {
+    const at2 = p.indexOf("=");
+    return at2 < 0 ? { k: "", v: p.trim() } : { k: p.slice(0, at2).trim(), v: p.slice(at2 + 1).trim() };
+  });
+  const kept = pairs.filter((p) => p.v && !/^default$/i.test(p.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((p, i2) => ({ ...p, i: i2 })).sort((a, b) => rank(a.k) - rank(b.k) || a.i - b.i).map((p) => p.v).join(" ");
+}
+const shortVariants = (list) => list ? andList(list.split("; ").map(shortVariant)) : "every variant";
+function parseStructureChange(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 shape2 = (op === "added" ? c10.after : c10.before) ?? "";
+  const sm = /^(\S+)(?: (.*?))?, ((?:after|before) ".*"|alone)$/.exec(shape2);
+  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 d2 = firstChange(name, kind, changes[0], changes);
+  const rest = kind === "new-component" ? 0 : changes.length - 1;
+  const summary = rest > 0 ? `${d2.summary} ${capital(plural(rest, "other change"))} ${rest === 1 ? "is" : "are"} listed below.` : d2.summary;
+  return { title: cleanDraftText(d2.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 = (e2) => e2.figma ?? e2.head ?? e2.base;
+const pathOf = (e2) => tokenOf(e2)?.path ?? e2.path;
+function pushChangeRows(entries) {
+  return entries.map((e2) => {
+    const before = e2.head ?? e2.base;
+    const after = e2.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 = e2.local?.kind === "renamed" && before && after && before.path !== after.path;
+    return { field: renamed ? `${before.path} -> ${after.path}` : pathOf(e2), 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(e2) {
+  return (e2.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 e2 of entries) by2[e2.local?.kind ?? "changed"].push(e2);
+  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";
@@ -1898,58 +2983,48 @@ function explorationSlugFromBranch(ref) {
   return isExplorationBranch(ref) ? ref.replace(/^refs\/heads\//, "").slice(EXPLORATION_PREFIX.length) : null;
 }
 const explorationNotePath = (slug) => `${EXPLORATION_NOTES_DIR}/${slug}.md`;
-function explorationProblems(e3) {
+function explorationProblems(e2) {
   const out = [];
-  const name = e3.name.trim();
-  const slug = e3.slug?.trim() || explorationSlug(name);
+  const name = e2.name.trim();
+  const slug = e2.slug?.trim() || explorationSlug(name);
   if (!name) out.push('Name the exploration, for example "Denser data tables".');
   else if (name.length > 60) out.push("Keep the name under 60 characters: it becomes the branch name.");
   else if (slug.length < 2 || !SLUG_RE.test(slug)) out.push("Use letters or digits in the name: it becomes the branch explore/<name>.");
-  if (!e3.purpose.trim()) out.push("Say what you want to learn, in one sentence.");
+  if (!e2.purpose.trim()) out.push("Say what you want to learn, in one sentence.");
   return out;
 }
 const useCaseLabel = (u2) => EXPLORATION_USE_CASES.find((x) => x.value === u2)?.label;
-function explorationNote(e3) {
-  const slug = e3.slug || explorationSlug(e3.name);
-  const uc = useCaseLabel(e3.useCase);
+function explorationNote(e2) {
+  const slug = e2.slug || explorationSlug(e2.name);
+  const uc = useCaseLabel(e2.useCase);
   return [
-    `# Exploration: ${e3.name.trim()}`,
+    `# Exploration: ${e2.name.trim()}`,
     "",
-    e3.purpose.trim(),
+    e2.purpose.trim(),
     "",
     `- Branch: \`${EXPLORATION_PREFIX}${slug}\``,
     ...uc ? [`- Use case: ${uc}`] : [],
-    ...e3.startedAt ? [`- Started: ${e3.startedAt.slice(0, 10)}${e3.author ? ` by @${e3.author}` : ""}`] : [],
+    ...e2.startedAt ? [`- Started: ${e2.startedAt.slice(0, 10)}${e2.author ? ` by @${e2.author}` : ""}`] : [],
     "",
     "This file marks the branch as an exploration. It is never merged as is: promoting the pull request to review removes it.",
     ""
   ].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(/\.$/, "");
+function explorationPrTitle(e2) {
+  const n2 = e2.name.trim().replace(/\.$/, "");
   return `Exploration: ${n2.charAt(0).toLowerCase()}${n2.slice(1)}`;
 }
-function explorationPrBody(e3, ctx) {
-  const slug = e3.slug || explorationSlug(e3.name);
+function explorationPrBody(e2, ctx) {
+  const slug = e2.slug || explorationSlug(e2.name);
   const branch = `${EXPLORATION_PREFIX}${slug}`;
-  const uc = useCaseLabel(e3.useCase);
-  const experimental = (e3.experimental ?? []).map((x) => x.trim()).filter(Boolean);
+  const uc = useCaseLabel(e2.useCase);
+  const experimental = (e2.experimental ?? []).map((x) => x.trim()).filter(Boolean);
   const lines = [
-    `## Exploration: ${e3.name.trim()}`,
+    `## Exploration: ${e2.name.trim()}`,
     "",
     `> Not mergeable as is. This draft pull request is a sandbox on \`${branch}\`: promote it to a normal review when the idea is validated, or close it.`,
     "",
-    `**Purpose.** ${e3.purpose.trim()}`,
+    `**Purpose.** ${e2.purpose.trim()}`,
     ...uc ? ["", `**Use case.** ${uc}`] : [],
     "",
     "### What is experimental",
@@ -1960,20 +3035,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} |`));
@@ -1985,7 +3049,7 @@ function explorationPrBody(e3, ctx) {
     `- **Promote:** in Bridge Studio (Changes, Explorations, Promote to review) or \`bridge explore promote ${slug}\`. Bridge marks the pull request ready for review, removes the \`${EXPLORATION_LABEL}\` label and the exploration note, and adds the tier labels. Then it goes through the usual review.`,
     "- **Close:** close this pull request. The branch stays for reference; the preview prerelease is removed.",
     "",
-    `<!-- ${MARK$1} ${JSON.stringify({ name: e3.name.trim(), purpose: e3.purpose.trim(), slug, ...e3.useCase ? { useCase: e3.useCase } : {}, ...experimental.length ? { experimental } : {}, ...e3.author ? { author: e3.author } : {}, ...e3.startedAt ? { startedAt: e3.startedAt } : {} }).replace(/-->/g, "--\\u003e")} -->`
+    `<!-- ${MARK$1} ${JSON.stringify({ name: e2.name.trim(), purpose: e2.purpose.trim(), slug, ...e2.useCase ? { useCase: e2.useCase } : {}, ...experimental.length ? { experimental } : {}, ...e2.author ? { author: e2.author } : {}, ...e2.startedAt ? { startedAt: e2.startedAt } : {}, ...e2.source ? { source: e2.source } : {}, ...e2.agent ? { agent: e2.agent } : {} }).replace(/-->/g, "--\\u003e")} -->`
   );
   return lines.join("\n");
 }
@@ -1994,20 +3058,20 @@ function parseExplorationBody(body) {
   const m2 = new RegExp(`<!-- ${MARK$1} (\\{[\\s\\S]*?\\}) -->`).exec(body);
   if (!m2) return void 0;
   try {
-    const e3 = JSON.parse(m2[1]);
-    return e3 && typeof e3.name === "string" && typeof e3.purpose === "string" ? e3 : void 0;
+    const e2 = JSON.parse(m2[1]);
+    return e2 && typeof e2.name === "string" && typeof e2.purpose === "string" ? e2 : void 0;
   } catch {
     return void 0;
   }
 }
 const labelNames = (labels) => labels.map((l2) => typeof l2 === "string" ? l2 : l2.name ?? "");
-function isExplorationPull(p2) {
-  return isExplorationBranch(p2.headRef) || labelNames(p2.labels).includes(EXPLORATION_LABEL) || Boolean(parseExplorationBody(p2.body));
+function isExplorationPull(p) {
+  return isExplorationBranch(p.headRef) || labelNames(p.labels).includes(EXPLORATION_LABEL) || Boolean(parseExplorationBody(p.body));
 }
-function explorationStatus(p2) {
-  const merged = Boolean(p2.merged || p2.merged_at || p2.state === "merged");
-  if (p2.state !== "open" && !merged) return "closed";
-  if (p2.state === "open" && labelNames(p2.labels).includes(EXPLORATION_LABEL)) return "active";
+function explorationStatus(p) {
+  const merged = Boolean(p.merged || p.merged_at || p.state === "merged");
+  if (p.state !== "open" && !merged) return "closed";
+  if (p.state === "open" && labelNames(p.labels).includes(EXPLORATION_LABEL)) return "active";
   return "promoted";
 }
 const isActiveExploration = (labels) => labelNames(labels).includes(EXPLORATION_LABEL);
@@ -2043,6 +3107,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((p) => `${p.label} ${p.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 +3130,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 +3146,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,10 +3181,36 @@ 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";
-  if (prs.some((p2) => p2.merged) || issue.stateReason === "completed") return "done";
+  if (issue.state === "open") return prs.some((p) => p.state === "open") ? "in-progress" : "requested";
+  if (prs.some((p) => p.merged) || issue.stateReason === "completed") return "done";
   return "declined";
 }
 const REQUEST_STATUS_LABEL = { requested: "Requested", "in-progress": "In progress", done: "Done", declined: "Declined" };
@@ -2127,10 +3232,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 +3258,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 +3269,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 +3288,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) {
@@ -2339,17 +3317,17 @@ function draftImagePath(sessionId, itemId, label) {
   return `${DRAFTS_DIR}/${sessionId}/${item}-${label}.png`;
 }
 function composePendingDrafts(input) {
-  const p2 = {
+  const p = {
     version: DRAFT_EXCHANGE_VERSION,
     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);
+  const problems = validatePendingDrafts(p);
   if (problems.length) throw new Error(problems.join(" "));
-  return p2;
+  return p;
 }
 const KINDS = new Set(REQUEST_KINDS.map((k3) => k3.value));
 const str = (x) => typeof x === "string";
@@ -2357,15 +3335,15 @@ const optStr = (x) => x === void 0 || typeof x === "string";
 function validatePendingDrafts(x) {
   const out = [];
   if (!x || typeof x !== "object" || Array.isArray(x)) return ["A draft session is a JSON object."];
-  const p2 = x;
-  if (p2.version !== DRAFT_EXCHANGE_VERSION) out.push(`Unsupported draft session version ${String(p2.version)}: update Bridge.`);
-  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 (!Array.isArray(p2.items) || !p2.items.length) out.push("A draft session needs at least one item.");
+  const p = x;
+  if (p.version !== DRAFT_EXCHANGE_VERSION) out.push(`Unsupported draft session version ${String(p.version)}: update Bridge.`);
+  if (!isDraftSessionId(p.sessionId)) out.push("The session id is missing or invalid.");
+  if (!str(p.createdAt) || Number.isNaN(Date.parse(p.createdAt))) out.push("createdAt must be an ISO date.");
+  if (p.status !== "pending" && p.status !== "drafted") out.push('status must be "pending" or "drafted".');
+  if (p.source !== "figma" && p.source !== "studio") out.push('source must be "figma" or "studio".');
+  if (!Array.isArray(p.items) || !p.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()) {
+  for (const [n2, i2] of (Array.isArray(p.items) ? p.items : []).entries()) {
     const at2 = `Item ${n2 + 1}`;
     if (!i2 || typeof i2 !== "object") {
       out.push(`${at2} is not an object.`);
@@ -2374,18 +3352,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 d2 = i2.docs;
+      if (!d2 || typeof d2 !== "object" || !str(d2.slug) || !d2.slug || !str(d2.prompt) || !d2.prompt || !optStr(d2.path)) out.push(`${at2}: a docs item needs docs {slug, task, prompt}.`);
+      else out.push(...validateDocsTask(d2.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.");
+  if (p.results !== void 0) {
+    if (!Array.isArray(p.results)) out.push("results must be a list.");
+    else
+      for (const r2 of p.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;
 }
@@ -2399,8 +3389,8 @@ function parsePendingDrafts(text) {
   }
   return validatePendingDrafts(json).length ? void 0 : json;
 }
-function serializePendingDrafts(p2) {
-  return `${JSON.stringify(p2, null, 2)}
+function serializePendingDrafts(p) {
+  return `${JSON.stringify(p, null, 2)}
 `;
 }
 function clip(text, max) {
@@ -2422,39 +3412,96 @@ function sanitizeDraftText(raw) {
   const summary = typeof raw.summary === "string" ? sentences(cleanDraftText(raw.summary)) : "";
   return { title, summary };
 }
-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]));
+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(p, results, at2 = /* @__PURE__ */ new Date()) {
+  const ids = new Set(p.items.map((i2) => i2.id));
+  const next = new Map((p.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(", ")}.`);
+    if (!ids.has(r2.id)) throw new Error(`Session ${p.sessionId} has no item "${r2.id}". Use the ids from bridge_pending_drafts: ${[...ids].join(", ")}.`);
+    const item = p.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" };
+  const merged = p.items.map((i2) => next.get(i2.id)).filter((r2) => !!r2);
+  return { ...p, results: merged, status: merged.length === p.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;
-async function createPendingDrafts(client, p2, branch = REQUESTS_BRANCH) {
-  const problems = validatePendingDrafts(p2);
+async function createPendingDrafts(client, p, branch = REQUESTS_BRANCH) {
+  const problems = validatePendingDrafts(p);
   if (problems.length) throw new Error(problems.join(" "));
-  await client.putFile({ path: draftSessionPath(p2.sessionId), content: serializePendingDrafts(p2), branch, message: `Bridge drafts: ${p2.items.length === 1 ? "1 item" : `${p2.items.length} items`} waiting for Claude` });
-  return p2;
+  await client.putFile({ path: draftSessionPath(p.sessionId), content: serializePendingDrafts(p), branch, message: `Bridge drafts: ${p.items.length === 1 ? "1 item" : `${p.items.length} items`} waiting for Claude` });
+  return p;
 }
 async function readPendingDrafts(client, sessionId, branch = REQUESTS_BRANCH) {
   const f = await client.getFile(draftSessionPath(sessionId), branch);
@@ -2463,16 +3510,16 @@ async function readPendingDrafts(client, sessionId, branch = REQUESTS_BRANCH) {
 }
 async function listPendingDrafts(client, opts = {}) {
   const branch = opts.branch ?? REQUESTS_BRANCH;
-  const entries = (await client.listDirectory(DRAFTS_DIR, branch)).filter((e3) => e3.type === "file" && /\.json$/.test(e3.name));
+  const entries = (await client.listDirectory(DRAFTS_DIR, branch)).filter((e2) => e2.type === "file" && /\.json$/.test(e2.name));
   const out = [];
-  for (const e3 of entries) {
-    const id = e3.name.replace(/\.json$/, "");
+  for (const e2 of entries) {
+    const id = e2.name.replace(/\.json$/, "");
     if (!isDraftSessionId(id)) continue;
     const r2 = await readPendingDrafts(client, id, branch).catch(() => void 0);
     if (r2 && r2.drafts.sessionId === id) out.push(r2.drafts);
   }
   const status = opts.status ?? "all";
-  return out.filter((p2) => status === "all" || p2.status === status).sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+  return out.filter((p) => status === "all" || p.status === status).sort((a, b) => b.createdAt.localeCompare(a.createdAt));
 }
 async function updatePendingDrafts(client, sessionId, change, opts = {}) {
   const branch = opts.branch ?? REQUESTS_BRANCH;
@@ -2490,7 +3537,7 @@ async function updatePendingDrafts(client, sessionId, change, opts = {}) {
   }
 }
 function writeDraftResults(client, sessionId, results, opts = {}) {
-  return updatePendingDrafts(client, sessionId, (p2) => mergeDraftResults(p2, results, opts.now), {
+  return updatePendingDrafts(client, sessionId, (p) => mergeDraftResults(p, results, opts.now), {
     ...opts,
     message: `Bridge drafts: ${results.length === 1 ? "1 text" : `${results.length} texts`} drafted by Claude`
   });
@@ -2502,43 +3549,134 @@ async function deletePendingDrafts(client, sessionId, opts = {}) {
   if (!f) return false;
   await client.deleteFile({ path, branch, message: "Bridge drafts: done", sha: f.sha });
   const images = await client.listDirectory(`${DRAFTS_DIR}/${sessionId}`, branch).catch(() => []);
-  for (const img of images.filter((e3) => e3.type === "file")) {
+  for (const img of images.filter((e2) => e2.type === "file")) {
     await client.deleteFile({ path: img.path, branch, message: "Bridge drafts: done", sha: img.sha }).catch(() => void 0);
   }
   return true;
 }
-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);
+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(p, _owner, _repo, s) {
+  const e2 = parseExplorationBody(p.body);
+  const slug = p.headRef?.startsWith(EXPLORATION_PREFIX) ? p.headRef.slice(EXPLORATION_PREFIX.length) : e2?.slug ?? explorationSlug(p.title);
   return {
-    number: p2.number,
-    url: p2.url,
-    branch: p2.headRef,
+    number: p.number,
+    url: p.url,
+    branch: p.headRef,
     slug,
-    name: e3?.name ?? p2.title.replace(/^Exploration:\s*/i, ""),
-    purpose: e3?.purpose ?? "",
-    ...e3?.useCase ? { useCase: e3.useCase } : {},
-    status: explorationStatus({ state: p2.state, labels: p2.labels, headRef: p2.headRef, body: p2.body }),
-    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 })
+    name: e2?.name ?? p.title.replace(/^Exploration:\s*/i, ""),
+    purpose: e2?.purpose ?? "",
+    ...e2?.useCase ? { useCase: e2.useCase } : {},
+    status: explorationStatus({ state: p.state, labels: p.labels, headRef: p.headRef, body: p.body }),
+    draft: p.draft,
+    author: e2?.author ?? p.author,
+    ...e2?.source ? { source: e2.source } : {},
+    ...e2?.agent ? { agent: e2.agent } : {},
+    updatedAt: p.updatedAt,
+    headSha: p.headSha,
+    previews: previewLinks(s.apps, { branch: p.headRef, pr: p.number, sha: p.headSha })
   };
 }
 async function listExplorationsOnGitHub(gh, s, opts = {}) {
   const pulls = await gh.listPullRequests(opts.state ?? "open");
-  return pulls.filter((p2) => isExplorationPull({ state: p2.state, labels: p2.labels, headRef: p2.headRef, body: p2.body })).map((p2) => explorationSummary(p2, gh.owner, gh.name, s));
+  return pulls.filter((p) => isExplorationPull({ state: p.state, labels: p.labels, headRef: p.headRef, body: p.body })).map((p) => explorationSummary(p, gh.owner, gh.name, s));
 }
-async function startExplorationOnGitHub(gh, e3, s) {
-  const problems = explorationProblems(e3);
+async function startExplorationOnGitHub(gh, e2, s) {
+  const problems = explorationProblems(e2);
   if (problems.length) throw new GitHubError(422, problems.join(" "));
   if (!gh.canWrite) throw new GitHubError(401, "Starting an exploration needs a GitHub token (contents and pull requests, read and write, on this repository only).");
-  const slug = e3.slug || explorationSlug(e3.name);
+  const slug = e2.slug || explorationSlug(e2.name);
   const branch = `${EXPLORATION_PREFIX}${slug}`;
   const x = gh.withBranchPrefix(EXPLORATION_PREFIX);
   if (await x.getBranchSha(branch)) throw new GitHubError(422, `An exploration named "${slug}" already exists (${branch}). Pick another name, or continue that one.`);
-  const full = { ...e3, slug, startedAt: e3.startedAt ?? (/* @__PURE__ */ new Date()).toISOString() };
+  const full = { ...e2, slug, startedAt: e2.startedAt ?? (/* @__PURE__ */ new Date()).toISOString() };
   const commit = await x.commitToNewBranch({
     base: s.base,
     branch,
@@ -2549,7 +3687,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,15 +3697,25 @@ 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, e2) {
+  const [comments, head] = await Promise.all([gh.listIssueComments(e2.number), gh.getBranchSha(e2.branch).catch(() => void 0)]);
+  return explorationTryIt({ comment: findPreviewComment(comments)?.body, headSha: head });
+}
+async function explorationTestBuildOnGitHub(gh, e2, config) {
+  const [comments, head] = await Promise.all([gh.listIssueComments(e2.number), gh.getBranchSha(e2.branch).catch(() => void 0)]);
+  const tryIt = explorationTryIt({ comment: findPreviewComment(comments)?.body, headSha: head });
+  const previews = await branchPreviewUrls(gh, e2.number, config, { branch: e2.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(/^#/, "")));
-    if (!isExplorationPull({ state: p2.state, labels: p2.labels, headRef: p2.headRef, body: p2.body })) throw new GitHubError(422, `Pull request #${p2.number} is not an exploration.`);
-    return p2;
+    const p = await gh.getPullRequest(Number(String(ref).replace(/^#/, "")));
+    if (!isExplorationPull({ state: p.state, labels: p.labels, headRef: p.headRef, body: p.body })) throw new GitHubError(422, `Pull request #${p.number} is not an exploration.`);
+    return p;
   }
   const branch = `${EXPLORATION_PREFIX}${explorationSlug(String(ref))}`;
   const open = await gh.findOpenPullRequest(branch);
@@ -2575,65 +3723,107 @@ async function findExplorationOnGitHub(gh, ref) {
   return gh.getPullRequest(open.number);
 }
 async function promoteExplorationOnGitHub(gh, ref, opts = {}) {
-  const p2 = await findExplorationOnGitHub(gh, ref);
-  const status = explorationStatus({ state: p2.state, labels: p2.labels, headRef: p2.headRef, body: p2.body });
-  if (status !== "active") throw new GitHubError(422, status === "closed" ? `Exploration #${p2.number} is closed. Reopen it on GitHub first.` : `#${p2.number} is already promoted to review.`);
-  const files = await gh.listPullRequestFiles(p2.number);
-  const plan = promotionPlan({ title: p2.title, body: p2.body, labels: p2.labels, files: files.map((f) => ({ path: f.filename, status: f.status })), config: opts.config, requests: opts.requests, date: opts.date });
-  const out = { ...plan, number: p2.number, url: p2.url, branch: p2.headRef, warnings: [] };
+  const p = await findExplorationOnGitHub(gh, ref);
+  const status = explorationStatus({ state: p.state, labels: p.labels, headRef: p.headRef, body: p.body });
+  if (status !== "active") throw new GitHubError(422, status === "closed" ? `Exploration #${p.number} is closed. Reopen it on GitHub first.` : `#${p.number} is already promoted to review.`);
+  const files = await gh.listPullRequestFiles(p.number);
+  const plan = promotionPlan({ title: p.title, body: p.body, labels: p.labels, files: files.map((f) => ({ path: f.filename, status: f.status })), config: opts.config, requests: opts.requests, date: opts.date });
+  const out = { ...plan, number: p.number, url: p.url, branch: p.headRef, warnings: [] };
   if (opts.dryRun) return out;
   if (!gh.canWrite) throw new GitHubError(401, "Promoting an exploration needs a GitHub token (contents and pull requests, read and write).");
   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) => {
-      out.warnings.push(`The exploration note stays on the branch (${e3.message}). Delete ${plan.removeFiles.join(", ")} before merging.`);
+    await x.commitToBranch({ branch: p.headRef, message: "chore(explore): promote to review, remove the exploration note", files: plan.removeFiles.map((path) => ({ path, content: null })) }).catch((e2) => {
+      if (e2 instanceof GitHubError && e2.auth === "rejected") throw e2;
+      out.warnings.push(`The exploration note stays on the branch (${e2.message}). Delete ${plan.removeFiles.join(", ")} before merging.`);
     });
   }
-  await x.addLabels(p2.number, plan.addLabels);
-  await x.removeLabel(p2.number, EXPLORATION_LABEL).catch((e3) => {
-    if (!(e3 instanceof GitHubError && e3.status === 404)) out.warnings.push(`The exploration label is still on (${e3.message}). Remove it on GitHub.`);
+  await x.addLabels(p.number, plan.addLabels);
+  await x.removeLabel(p.number, EXPLORATION_LABEL).catch((e2) => {
+    if (!(e2 instanceof GitHubError && e2.status === 404)) out.warnings.push(`The exploration label is still on (${e2.message}). Remove it on GitHub.`);
   });
-  await x.updatePullRequest(p2.number, { title: plan.title, body: plan.body });
-  await x.markReadyForReview(p2.number).catch((e3) => {
-    out.warnings.push(`Still a draft: ${e3.message}`);
+  await x.updatePullRequest(p.number, { title: plan.title, body: plan.body });
+  await x.markReadyForReview(p.number).catch((e2) => {
+    out.warnings.push(`Still a draft: ${e2.message}`);
   });
   return out;
 }
 async function closeExplorationOnGitHub(gh, ref) {
   if (!gh.canWrite) throw new GitHubError(401, "Closing an exploration needs a GitHub token (pull requests: write).");
-  const p2 = await findExplorationOnGitHub(gh, ref);
-  await gh.updatePullRequest(p2.number, { state: "closed" });
-  return { number: p2.number, url: p2.url, branch: p2.headRef };
+  const p = await findExplorationOnGitHub(gh, ref);
+  await gh.updatePullRequest(p.number, { state: "closed" });
+  return { number: p.number, url: p.url, branch: p.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,
+  ai as AAA_MIN,
+  aj as AA_MIN,
+  ADMIN_ROLE_ID,
+  ANTHROPIC_MESSAGES_URL,
   BELL,
   BRAND_FONTS,
   BRAND_SLUG_RE,
-  ag as BULK_LIMIT,
+  ak as BULK_LIMIT,
   k as COLOR_FIELDS,
   C as COMPONENT_SPECS_VERSION,
   CONFIG_FILE,
-  ah as CONTRAST_CELL_MAX,
-  ai as CONTRAST_CHECKS_FILE,
+  al as CONTRAST_CELL_MAX,
+  am as CONTRAST_CHECKS_FILE,
   ConfigError,
-  aj as DEFAULT_COMPONENT_SPECS_FILE,
-  ak as DEFAULT_GOVERNANCE,
-  al as DEFAULT_OVERRIDE,
+  an as DEFAULT_COMPONENT_SPECS_FILE,
+  ao as DEFAULT_GOVERNANCE,
+  ap as DEFAULT_OVERRIDE,
   DEFAULT_PROTECTED_BRANCHES,
+  aq as DEFAULT_RIGHTS,
   DEFAULT_TOKEN_PATHS,
+  ar 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,107 +3835,147 @@ export {
   EXT_SCOPES,
   GitHubClient,
   GitHubError,
-  am as JsonParseError,
+  as as JsonParseError,
   LIGHTNESS,
   LayeredTokenSet,
   NEUTRAL_ANCHORS,
+  at as OWNER_GROUPS,
   PIN_TOLERANCE,
-  an as PREVIEW_APP_LABELS,
-  ao as PREVIEW_COMMENT_MARKER,
-  ap as PREVIEW_PLACEHOLDERS,
-  aq as PRIMITIVE_MODE,
+  au as PREVIEW_APP_LABELS,
+  av as PREVIEW_COMMENT_MARKER,
+  aw as PREVIEW_PLACEHOLDERS,
+  ax as PRIMITIVE_MODE,
   PROSE_KEYS,
+  PROTECTION_PARTS,
+  PROTECTION_PART_PHRASE,
   ProtectedBranchError,
   RADIUS_PRESETS,
   REQUESTS_BRANCH,
   REQUEST_KINDS,
   REQUEST_LABEL,
   REQUEST_STATUS_LABEL,
+  ay as RIGHTS,
+  az as RIGHT_LABEL,
   RISK_LABELS,
-  ar as RISK_TIER,
+  aA as RISK_TIER,
   SIMILARITY_THRESHOLD,
   SINGLE_MODE,
-  as as SPEC_FIELDS,
+  aB as SPEC_FIELDS,
   STEPS,
   TIER_AXIS,
   TIER_NAMES,
-  at as TIER_ORDER,
-  au as UNRELEASED,
+  aC as TIER_ORDER,
+  TOKEN_REJECTED_MESSAGE,
+  TOKEN_SETTINGS_URL,
+  aD as TeamDirectory,
+  aE as UNRELEASED,
+  aF as VISUAL_CHECK_LABEL,
   acceptDocsDraft,
   acceptDocsText,
   addBrandToConfigText,
-  av as affectedContrast,
-  e2 as aliasOf,
+  aG as affectedContrast,
+  d as aliasOf,
   aliasTarget,
   anatomyLabel,
   anchoredRamp,
-  aw as appUrl,
+  anthropicReplyText,
+  anthropicRequest,
+  aH as appForProject,
+  aI as appUrl,
   applyConfirmedRenames,
+  applyDocsSections,
   applyTokenEdits,
+  applyTokenMerge,
+  aJ as approverEntries,
+  aK as approverLists,
   assertSafeBranch,
-  ax as assignVersions,
+  assignRequestOnGitHub,
+  aL as assignVersions,
   base64ToUtf8,
-  ay as baseBranchOf,
+  aM as baseBranchOf,
   bellChroma,
-  az as branchName,
-  aA as branchSlug,
+  aN as branchName,
+  branchPreviewUrls,
+  aO as branchSlug,
   brandDisplayName,
   brandPreviewVariables,
   buildHistoryEntry,
   buildReport,
   i as buildTokenSet,
   buildUsageIndex,
-  aB as changeKind,
-  aC as changeTable,
-  aD as changedModes,
-  aE as changesetBump,
+  aP as canShip,
+  changeEdits,
+  aQ as changeKind,
+  aR as changeTable,
+  aS as changedModes,
+  aT as changesetBump,
   checkBrandSlug,
   checkLayeredPair,
-  aF as classifyLayered,
+  choiceFor,
+  classifyAuth,
+  aU as classifyLayered,
   classifyRisk,
+  cleanDocsText,
   cleanDraftText,
-  aG as clearRawDeep,
+  aV as clearRawDeep,
   closeExplorationOnGitHub,
   closingIssueNumbers,
   coerceValue,
   collectHistory,
   collectRefs,
-  j2 as colorToCss,
-  k2 as colorsEqual,
+  k2 as colorToCss,
+  l as colorsEqual,
+  combineChanges,
+  combineConflicts,
   c as comboKey,
-  aH as commitMessage,
-  l as compactJson,
+  aW as commitMessage,
+  m as compactJson,
   componentForPath,
-  aI as composeChangeset,
+  aX as composeChangeset,
   composeFiles,
   composeNewBrandBody,
   composePendingDrafts,
-  aJ as composePrBody,
-  aK as composeProposalBody,
+  aY as composePrBody,
+  aZ as composeProposalBody,
   composeRequestIssue,
-  aL as composite,
-  aM as contextFor,
+  a_ as composite,
+  a$ as contextFor,
   contextLabel,
-  aN as contrastDelta,
-  aO as contrastDeltaTable,
-  aP as contrastLevel,
-  aQ as contrastPair,
-  aR as contrastRatio,
+  b0 as contrastDelta,
+  b1 as contrastDeltaTable,
+  b2 as contrastLevel,
+  b3 as contrastPair,
+  b4 as contrastRatio,
   contrastScope,
-  aS as countChanges,
+  b5 as countChanges,
+  createDocsDraftSession,
   createPendingDrafts,
   cssModuleClasses,
+  cssOf,
+  cssVarOf,
   cssVarsIn,
-  aT as defaultContext,
+  declineComment,
+  declineReasonProblems,
+  declineRequestOnGitHub,
+  decodePicks,
+  defaultChoiceFor,
+  b6 as defaultContext,
   defaultFile,
   defaultScopes,
-  aU as defaultTitle,
-  aV as defineConfig,
+  b7 as defaultTitle,
+  b8 as defineConfig,
   deletePendingDrafts,
   demoHistory,
-  aW as detectLayout,
-  aX as diffLayered,
+  b9 as detectLayout,
+  ba as diffLayered,
   docsPrompt,
+  docsSectionShapes,
+  docsSectionsAnswer,
+  docsSectionsResult,
+  docsSelectionPrompt,
+  docsTaskKeys,
+  docsTaskPrompt,
+  draftChangeLine,
   draftImagePath,
   draftItemBrief,
   draftPushDescription,
@@ -2754,78 +3984,106 @@ export {
   dtcgColor,
   effectiveScopes,
   emptyTokenFile,
+  encodePicks,
+  ensureRequestsBranch,
+  bb as entriesFor,
+  bc as entryLabel,
   evaluatePairs,
+  bd as expandEntries,
+  be 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,
+  bf as fieldChanges,
+  bg as fileModes,
+  bh as filterHistory,
   findExplorationOnGitHub,
+  findPreviewComment,
   findReferenceProblems,
-  a$ as findToken,
-  b0 as firstParagraph,
-  m as flattenLayerFile,
-  b1 as flattenTokens,
+  bi as findToken,
+  bj as findVercelComment,
+  bk as firstParagraph,
+  n as flattenLayerFile,
+  flattenTokens,
   formatChangeset,
   formatDocsJson,
-  b2 as formatNumber,
+  bl as formatNumber,
+  bm as formatOwnerEntry,
   formatValue,
   friendlyMessage,
   fromHex,
   fromPlain,
   generateRamp,
-  b3 as getChild,
+  bn as getChild,
   getEntry,
   gitHubHistoryBackend,
   g2 as globToRegExp,
+  bo as groupsPhrase,
   h as hashSpec,
   h2 as hexToRgba,
+  bp as holdersOf,
   j as iconComponentName,
   idExtensionFor,
   impactedModules,
   importsIn,
-  b4 as indexByPath,
-  b5 as inheritedTypeAt,
-  installCommand,
+  bq as indexByPath,
+  br as inheritedTypeAt,
+  bs as installCommand,
+  bt as installCommandFromPreviewComment,
   isActiveExploration,
   isAlias,
+  isDocsSelectionMode,
   isDraftSessionId,
   isExplorationBranch,
   isExplorationPull,
-  b6 as isGuardrail,
+  bu as isGuardrail,
   isHex,
+  isMissingPermission,
   isMultiMode,
-  b7 as isTokenFile,
+  isPlanRefusal,
+  isProseKey,
+  bv as isTeamEntry,
+  bw as isTokenFile,
+  isTokenRejected,
+  bx as isVercelComment,
   jiraIssueFields,
-  b8 as kindForMin,
-  b9 as layeredImpact,
-  n as layeredParityIssues,
+  by as kindForMin,
+  bz as layeredImpact,
+  o as layeredParityIssues,
   g as layoutOptions,
   levenshtein,
+  linkRequestToExplorationOnGitHub,
   listBrands,
   listExplorationsOnGitHub,
   listPendingDrafts,
   loadConfig,
   loadGitHubHistory,
+  loadProtection,
   loadRepoFiles,
-  ba as luminance,
+  loadRequiredChecks,
+  bA as luminance,
   markClaudeDraft,
+  mergeDocsDraft,
   mergeDraftResults,
   mergeReleases,
+  missingChoices,
+  missingPermissionMessage,
   missingProse,
   modeDisplayName,
   modeFile,
-  bb as modeLabel,
+  bB as modeLabel,
   modesOf$1 as modesOf,
   moveToken,
   nearestStep,
@@ -2834,102 +4092,152 @@ export {
   neutralOffset,
   newBrandSection,
   newDraftSessionId,
-  bc as nodesEqual,
+  bC as nodesEqual,
+  bD as normalizeRights,
   oklch,
   oklchToLinear,
-  bd as overrideKey,
+  bE as overrideKey,
+  bF as ownerEntryProblems,
   packageDirCandidates,
-  be as pairKey,
+  bG as pairKey,
   parseChangelog,
-  bf as parseChangesetText,
-  p as parseColor,
-  bg as parseComponentSpecs,
+  bH as parseChangesetText,
+  parseColor,
+  bI as parseComponentSpecs,
   parseContrastChecks,
-  o as parseDimension,
+  q as parseDimension,
+  parseDocsReply,
+  parseDocsTaskAnswer,
   parseExplorationBody,
   parseJson,
+  bJ as parseOwnerEntry,
   parsePendingDrafts,
   parseRepo,
   parseRequestIssue,
+  parseStructureChange,
   parseTokenFile,
+  bK as parseVercelComment,
   patchDocsJson,
   pathId,
   pathSimilarity,
+  permissionLabel,
+  pickedOption,
   plainEqual,
   planNewBrand,
-  bh as planRestore,
-  bi as planRevert,
-  bj as planToJson,
+  bL as planRestore,
+  bM as planRevert,
+  bN as planToJson,
+  planTokenMerge,
   e as prNumberFromSubject,
   prefillDocs,
-  bk as previewComment,
+  bO as previewComment,
   previewLinks,
-  bl as previewUrl,
+  bP as previewLinksOf,
+  previewOverrides,
+  bQ as previewUrl,
+  previewsSettled,
+  bR as projectOfLabel,
   promoteExplorationOnGitHub,
   promotionPlan,
   propsTable,
-  bm as protectedBranchesOf,
+  protectLibrary,
+  protectRefusal,
+  bS as protectedBranchesOf,
+  protectionRuleset,
+  protectionRulesetName,
+  protectionSentence,
+  protectionState,
   pushChangeRows,
   readPendingDrafts,
+  readPreviewComment,
   readTokenAt,
   reconcileIds,
   releasesFromTags,
   removeToken,
-  bn as renderedColor,
+  removedSide,
+  bT as renderedColor,
   requestBrief,
   requestImagePath,
   requestIssueTitle,
   requestStatus,
-  bo as resolve,
+  requiredCheckNames,
+  requiredPermission,
+  resolve,
+  resolveBranchPreviews,
   r as rgbaToDtcg,
-  q as rgbaToHex,
+  rgbaToHex,
+  bU as rightsProblems,
   round3,
-  bp as runLayeredContrast,
+  rulesSettingsUrl,
+  rulesetTargetsDefault,
+  bV as runLayeredContrast,
   sameScopes,
-  bq as sameToken,
+  bW as sameToken,
+  sanitizeDocsReplacement,
+  sanitizeDocsResult,
+  sanitizeDocsSections,
+  sanitizeDraftLine,
   sanitizeDraftText,
+  sanitizeDraftTitle,
+  sanitizeResultLines,
+  sectionsNeedingReview,
   selectTokenFiles,
   serializeJson,
   serializePendingDrafts,
   serializeTokenFile,
   shadowedEdits,
+  bX as shipPolicy,
+  shortVariant,
+  shortVariants,
   slugify,
-  snapshotUrl,
-  br as specHash,
+  bY as snapshotUrl,
+  bZ as specHash,
   startExplorationOnGitHub,
-  bs as summarizeTokenChange,
-  bt as tarballAssetName,
-  tarballUrl,
-  bu as threeWayDiff,
+  b_ as summarizeTokenChange,
+  takeMine,
+  b$ as tarballAssetName,
+  c0 as tarballUrl,
+  c1 as teamKey,
+  c2 as teamKeyOf,
+  c3 as teamUnreadableMessage,
+  c4 as teamsIn,
+  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,
+  unpicked,
+  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