@bridge-ds/core 0.3.0 → 0.5.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 resolveBranchPreviews, Y as tokensPath, Z as coerceValue, _ as toConfigJson, $ as parseContrastChecks, a0 as checkLayeredPair, a1 as classifyRisk, a2 as formatChangeset, a3 as RISK_LABELS, a4 as parseJson, a5 as serializeJson, a6 as plainEqual, a7 as toPlain, a8 as getEntry, a9 as fromPlain, aa as previewLinks, ab as slugify, ac as readPreviewComment, ad as findPreviewComment, ae as previewsSettled } from "./component-spec-IRFGJ7XK.js";
-import { af, ag, ah, k, C, ai, aj, ak, al, am, an, ao, ap, aq, ar, as, at, au, av, aw, ax, ay, az, aA, aB, aC, aD, aE, aF, aG, aH, aI, aJ, aK, aL, i, aM, aN, aO, aP, aQ, aR, aS, aT, aU, aV, aW, aX, aY, aZ, a_, a$, b0, b1, b2, b3, b4, b5, b6, b7, b8, b9, ba, bb, bc, bd, be, bf, bg, bh, bi, bj, bk, bl, bm, h, bn, j, bo, bp, bq, br, bs, bt, bu, bv, bw, bx, g, by, bz, bA, bB, bC, bD, bE, bF, bG, bH, bI, bJ, bK, bL, e, bM, bN, bO, bP, bQ, bR, bS, bT, bU, bV, bW, bX, bY, bZ, b_, b$, c0, c1, c2, c3, c4, c5, c6, c7, c8, t, c9, ca, cb, cc, cd, v, ce, cf, cg, ch } from "./component-spec-IRFGJ7XK.js";
-import { a as collectRefs, i as isAlias, b as aliasTarget, v as valuesEqual, s as selectTokenFiles, L as LayeredTokenSet, d as validateLayered, f as formatValue } from "./layered-DGate4nv.js";
-import { D, e as e2, j as j2, k as k2, c, l, m, g as g2, h as h2, n, p, o, r, q, t as t2, u } from "./layered-DGate4nv.js";
+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.`
       });
     }
   }
@@ -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,8 +543,8 @@ 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;
   }
@@ -358,7 +604,7 @@ function refPattern(pattern) {
 function rulesetTargetsDefault(ruleset, defaultBranch) {
   if (ruleset.target && ruleset.target !== "branch") return false;
   const ref = `refs/heads/${defaultBranch}`;
-  const hit = (p2) => p2 === "~ALL" || p2 === "~DEFAULT_BRANCH" || p2 === ref || p2 === defaultBranch || refPattern(p2.startsWith("refs/") ? p2 : `refs/heads/${p2}`).test(ref);
+  const 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;
@@ -376,12 +622,12 @@ function rulesetParts(ruleset) {
   }
   return parts;
 }
-function classicParts(p2) {
+function classicParts(p) {
   const parts = /* @__PURE__ */ new Set();
-  if (count(p2.required_pull_request_reviews?.required_approving_review_count) >= 1) parts.add("review");
-  if (((p2.required_status_checks?.contexts?.length ?? 0) || (p2.required_status_checks?.checks?.length ?? 0)) > 0) parts.add("checks");
-  if (!p2.allow_force_pushes?.enabled) parts.add("history");
-  if (!p2.allow_deletions?.enabled) parts.add("deletion");
+  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;
@@ -394,10 +640,10 @@ function protectionState(rulesets, branchProtection, defaultBranch) {
     if (!rulesetTargetsDefault(r2, defaultBranch)) continue;
     const parts = rulesetParts(r2);
     if (parts.size && !url) url = rulesetUrl(r2);
-    parts.forEach((p2) => covered.add(p2));
+    parts.forEach((p) => covered.add(p));
   }
-  if (branchProtection) classicParts(branchProtection).forEach((p2) => covered.add(p2));
-  const missing = PROTECTION_PARTS.filter((p2) => !covered.has(p2));
+  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;
@@ -418,7 +664,7 @@ function protectionSentence(state) {
     case "unprotected":
       return "Your library can be changed without review.";
     case "partial": {
-      const s = joinAnd(state.missing.map((p2) => PROTECTION_PART_PHRASE[p2]));
+      const s = joinAnd(state.missing.map((p) => PROTECTION_PART_PHRASE[p]));
       return `Partly protected: ${s}.`;
     }
     default:
@@ -467,18 +713,18 @@ function missingPermissionMessage(permission, action) {
 }
 function requiredPermission(path, acceptedHeader) {
   if (acceptedHeader) {
-    const first = acceptedHeader.split(";")[0].split(",").map((p22) => p22.trim().split("=")[0].trim()).filter((p22) => p22 && p22 !== "metadata");
+    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 p2 = path.replace(/[?#].*$/, "");
-  if (/\/repos\/[^/]+\/[^/]+\/(issues|labels|milestones)(\/|$)/.test(p2)) return "issues";
-  if (/\/repos\/[^/]+\/[^/]+\/pulls(\/|$)/.test(p2)) return "pull_requests";
-  if (/\/repos\/[^/]+\/[^/]+\/(rulesets(\/|$)|branches\/.+\/protection$)/.test(p2)) return "administration";
-  if (/\/repos\/[^/]+\/[^/]+\/(contents|git|commits|branches|merges)(\/|$)/.test(p2)) return "contents";
-  if (/\/repos\/[^/]+\/[^/]+\/(check-runs|check-suites)(\/|$)/.test(p2)) return "checks";
-  if (/\/repos\/[^/]+\/[^/]+\/statuses(\/|$)/.test(p2)) return "statuses";
-  if (/\/repos\/[^/]+\/[^/]+\/deployments(\/|$)/.test(p2)) return "deployments";
-  if (/\/repos\/[^/]+\/[^/]+\/actions(\/|$)/.test(p2)) return "actions";
+  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;
@@ -490,6 +736,12 @@ function classifyAuth(status, detail, opts = {}) {
   }
   return {};
 }
+function rateLimitMessage(x) {
+  const when = x.resetsAt ? ` It resets at ${x.resetsAt.toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" })}.` : "";
+  if (x.withToken) return `GitHub's hourly request limit for this token is used up.${when} Try again after that.`;
+  const hint = x.tokenHint ?? "add a GitHub token";
+  return `GitHub's hourly limit for requests without a token (60 an hour) is used up.${when} To keep going now, ${hint}: a token gets 5,000 requests an hour.`;
+}
 const DEFAULT_RETRY = { attempts: 3, baseDelayMs: 600, sleep: (ms) => new Promise((r2) => setTimeout(r2, ms)) };
 const isTransient = (status, detail) => status === 0 || status >= 500 || status === 429 || status === 403 && /secondary rate limit/i.test(detail);
 const API = "https://api.github.com";
@@ -562,8 +814,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));
       }
     }
@@ -586,19 +838,15 @@ 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 = "";
       }
       const remaining = res.headers?.get("x-ratelimit-remaining");
       const reset = res.headers?.get("x-ratelimit-reset");
       if ((res.status === 403 || res.status === 429) && remaining === "0") {
-        const when = reset ? new Date(Number(reset) * 1e3) : void 0;
-        throw new GitHubError(
-          429,
-          `GitHub's hourly request limit for this token is used up.${when ? ` It resets at ${when.toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" })}.` : ""} Try again after that.`,
-          detail
-        );
+        const resetsAt = reset ? new Date(Number(reset) * 1e3) : void 0;
+        throw new GitHubError(429, rateLimitMessage({ withToken: Boolean(this.token), resetsAt, tokenHint: this.options.tokenHint }), detail);
       }
       const info = classifyAuth(res.status, detail, {
         path,
@@ -670,7 +918,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) {
@@ -751,10 +999,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(
@@ -931,7 +1198,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;
@@ -984,7 +1251,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") {
@@ -1017,12 +1284,12 @@ class GitHubClient {
   async listDeployments(sha) {
     const list = await this.request("GET", `${this.repoPath}/deployments?sha=${encodeURIComponent(sha)}&per_page=30`);
     const latest = /* @__PURE__ */ new Map();
-    for (const d of list) if (!latest.has(d.environment)) latest.set(d.environment, d);
+    for (const d2 of list) if (!latest.has(d2.environment)) latest.set(d2.environment, d2);
     return Promise.all(
-      [...latest.values()].map(async (d) => {
-        const st = await this.request("GET", `${this.repoPath}/deployments/${d.id}/statuses?per_page=1`).catch(() => []);
+      [...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: d.id, environment: d.environment, state: s?.state ?? null, environmentUrl: s?.environment_url || null };
+        return { id: d2.id, environment: d2.environment, state: s?.state ?? null, environmentUrl: s?.environment_url || null };
       })
     );
   }
@@ -1109,7 +1376,7 @@ class GitHubClient {
 function toCommitSummary(c10) {
   return {
     sha: c10.sha,
-    parents: (c10.parents ?? []).map((p2) => p2.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 ?? ""
@@ -1160,7 +1427,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);
@@ -1173,16 +1440,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;
     }
@@ -1215,7 +1482,7 @@ async function loadProtection(client, defaultBranch) {
 }
 async function loadRequiredChecks(client, defaultBranch) {
   const onDefault = await client.listCheckRuns(defaultBranch).catch(() => []);
-  const merged = await client.listPullRequests("closed").then((prs) => prs.find((p2) => p2.state === "merged" && p2.baseRef === defaultBranch)).catch(() => void 0);
+  const 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);
 }
@@ -1248,11 +1515,11 @@ function importsIn(text) {
   for (const m2 of text.matchAll(IMPORT_RE)) out.add(m2[1] ?? m2[2]);
   return [...out];
 }
-const norm = (p2) => p2.replace(/\\/g, "/").replace(/\/+$/, "");
-const isStory = (p2) => /\.stories\.[cm]?[jt]sx?$/.test(p2);
-const isTest = (p2) => /\.(test|spec)\.[cm]?[jt]sx?$/.test(p2);
-const isCss = (p2) => /\.(css|scss|less)$/.test(p2);
-const isScript = (p2) => /\.[cm]?[jt]sx?$/.test(p2);
+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);
@@ -1267,9 +1534,9 @@ function componentOf(from, spec, componentsDir) {
 }
 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("/");
+  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) {
@@ -1306,7 +1573,7 @@ function buildUsageIndex(files, componentsDir) {
     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();
+    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();
@@ -1328,7 +1595,7 @@ function impactedModules(index, input) {
     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);
+  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();
@@ -1351,10 +1618,10 @@ function tokenUsage(tokens, reads) {
   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 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 };
 }
@@ -1395,7 +1662,7 @@ function gitHubHistoryBackend(client, config, opts = {}) {
       const merges = /* @__PURE__ */ new Map();
       const enriched = await pool(list, async (c10) => {
         const prs = await client.listPullRequestsForCommit(c10.sha).catch(() => []);
-        const pr = prs.find((p2) => p2.mergedAt && p2.baseRef === ref) ?? prs.find((p2) => p2.mergedAt);
+        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 !== c10.sha) {
@@ -1419,20 +1686,20 @@ function gitHubHistoryBackend(client, config, opts = {}) {
     },
     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;
     }
   };
 }
@@ -1453,9 +1720,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) {
@@ -1503,14 +1770,14 @@ 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 };
 }
@@ -1523,14 +1790,14 @@ async function branchPreviewUrls(gh, ref, config, opts = {}) {
   if (typeof ref === "number") {
     pr = ref;
     if (!branch || !sha) {
-      const p2 = await gh.getPullRequest(ref);
-      branch ??= p2.headRef;
-      sha ??= p2.headSha;
+      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((p2) => p2.state === "open");
+      const open = (await gh.listPullRequestsForCommit(ref).catch(() => [])).find((p) => p.state === "open");
       if (open) {
         pr = open.number;
         branch ??= open.headRef;
@@ -1655,12 +1922,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;
@@ -1803,8 +2070,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;
     }
   };
@@ -1889,7 +2156,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;
@@ -1931,8 +2198,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}`;
@@ -1946,7 +2213,7 @@ 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((c10) => c10.brand === slug) : [];
-  const results = combos.flatMap((c10) => pairs.map((p2) => checkLayeredPair(after, p2, c10)));
+  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((c10) => c10.theme).filter((t3) => !!t3))];
   const ramps = {};
@@ -1960,7 +2227,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) })),
@@ -2112,21 +2379,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 c10 of input.cssClasses) anatomy[c10] = existing?.anatomy?.[c10] ?? anatomyLabel(c10);
-  const contrastNotes = (input.contrast ?? []).slice().sort((a, b) => a.ratio - b.ratio).map((p2) => `${p2.foreground} on ${p2.background}: ${p2.ratio.toFixed(2)}:1 at worst over every brand and theme, needs ${p2.min}:1 (${p2.ratio >= p2.min ? "passes" : "fails"}).`);
+  const 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 = {
@@ -2194,7 +2461,7 @@ ${text.trim()}
     ] : [],
     ...options.rewrite ? ["Rewrite each one from the facts and the source: keep what is true in the current text, drop what the code does not support."] : []
   ] : [`Write the missing prose of ${prefill.component}.docs.json for the Bridge design system.`];
-  const shape = keys ? [
+  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)}.`
   ] : [
@@ -2208,7 +2475,7 @@ ${text.trim()}
     "- Ground every sentence in the facts and the source below. Never invent props, variants, keyboard behavior or tokens that are not there.",
     "- Bridge voice: sentence case, plain words, verbs first, no em dashes, no marketing words.",
     '- Keep the keys and shapes of the example docs.json. dos and donts are { "title", "text" } objects; add an "example" only with components and props that exist.',
-    ...shape,
+    ...shape2,
     "",
     "Facts computed from the code:",
     facts.join("\n\n"),
@@ -2223,29 +2490,29 @@ ${JSON.stringify(prefill.draft, null, 2)}`,
     block("example-docs-json", conventions.example)
   ].filter((x, i2, all) => x !== "" || all[i2 - 1] !== "").join("\n");
 }
-function markClaudeDraft(d, sections) {
+function markClaudeDraft(d2, sections) {
   if (!sections) {
-    const { draftedSections: _all, ...rest } = d;
+    const { draftedSections: _all, ...rest } = d2;
     return { ...rest, draftedBy: "claude", needsReview: true };
   }
-  const waiting = d.needsReview === true ? d.draftedSections ?? (d.draftedBy ? [...PROSE_KEYS] : []) : [];
+  const waiting = d2.needsReview === true ? d2.draftedSections ?? (d2.draftedBy ? [...PROSE_KEYS] : []) : [];
   const union = PROSE_KEYS.filter((k3) => waiting.includes(k3) || sections.includes(k3));
-  return { ...d, draftedBy: "claude", needsReview: true, draftedSections: union };
+  return { ...d2, draftedBy: "claude", needsReview: true, draftedSections: union };
 }
-function sectionsNeedingReview(d) {
-  if (!d || d.needsReview !== true) return [];
-  return d.draftedSections ? PROSE_KEYS.filter((k3) => d.draftedSections.includes(k3)) : [...PROSE_KEYS];
+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) {
-  const { draftedSections: _done, ...rest } = d;
+const needsDocsReview = (d2) => Boolean(d2 && d2.needsReview === true);
+function acceptDocsDraft(d2) {
+  const { draftedSections: _done, ...rest } = d2;
   return { ...rest, needsReview: false };
 }
-function formatDocsJson(d) {
+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)}
 `;
 }
@@ -2253,7 +2520,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] };
   }
@@ -2293,17 +2560,17 @@ function propShape(s) {
 }
 const VARIANT_FIRST = ["variant", "tone", "intent", "appearance", "kind", "type", "style"];
 function shortVariant(key) {
-  const pairs = key.split(", ").map((p2) => {
-    const at2 = p2.indexOf("=");
-    return at2 < 0 ? { k: "", v: p2.trim() } : { k: p2.slice(0, at2).trim(), v: p2.slice(at2 + 1).trim() };
+  const 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((p2) => p2.v && !/^default$/i.test(p2.v));
+  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((p2, i2) => ({ ...p2, i: i2 })).sort((a, b) => rank(a.k) - rank(b.k) || a.i - b.i).map((p2) => p2.v).join(" ");
+  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) {
@@ -2312,8 +2579,8 @@ function parseStructureChange(c10) {
   const op = m2[1] === "New" ? "added" : m2[1] === "Removed" ? "removed" : "moved";
   const where = `in ${shortVariants(m2[3])}`;
   if (op === "moved") return { op, name: m2[2], where, at: c10.after, from: c10.before };
-  const shape = (op === "added" ? c10.after : c10.before) ?? "";
-  const sm = /^(\S+)(?: (.*?))?, ((?:after|before) ".*"|alone)$/.exec(shape);
+  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) {
@@ -2397,10 +2664,10 @@ function firstChange(component, kind, c10, all) {
 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 d2 = 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 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) {
@@ -2461,32 +2728,32 @@ function draftChangeLine(kind, changes) {
   const tail = rest ? ` (and ${rest} more)` : "";
   return capital(clipText(cleanDraftText(first), DRAFT_LINE_MAX - tail.length)) + tail;
 }
-const tokenOf = (e3) => e3.figma ?? e3.head ?? e3.base;
-const pathOf = (e3) => tokenOf(e3)?.path ?? e3.path;
+const tokenOf = (e2) => e2.figma ?? e2.head ?? e2.base;
+const pathOf = (e2) => tokenOf(e2)?.path ?? e2.path;
 function pushChangeRows(entries) {
-  return entries.map((e3) => {
-    const before = e3.head ?? e3.base;
-    const after = e3.figma;
+  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 = 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) };
+    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(e3) {
-  return (e3.local?.fields ?? []).filter((f) => f.field === "value" && f.mode && f.mode !== "value").map((f) => modeDisplayName(f.mode));
+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 e3 of entries) by2[e3.local?.kind ?? "changed"].push(e3);
+  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;
@@ -2718,48 +2985,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 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",
@@ -2784,7 +3051,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");
 }
@@ -2793,20 +3060,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);
@@ -2852,7 +3119,7 @@ function explorationTryIt(input) {
 function explorationShareMessage(input) {
   const name = input.name.trim().replace(/"/g, "'");
   const head = input.command ? `Exploration "${name}" (${input.branch}): try it in a staging branch of your product with: ${input.command}.` : `Exploration "${name}" (${input.branch}): its test build is being prepared, the install command for a staging branch of your product will be on the pull request in a few minutes.`;
-  const previews = (input.previews ?? []).map((p2) => `${p2.label} ${p2.url}`);
+  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) {
@@ -2944,8 +3211,8 @@ function declineComment(reason, by2) {
 }
 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" };
@@ -3052,7 +3319,7 @@ 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(),
@@ -3060,9 +3327,9 @@ function composePendingDrafts(input) {
     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";
@@ -3070,15 +3337,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" && p2.source !== "studio") out.push('source must be "figma" or "studio".');
-  if (!Array.isArray(p2.items) || !p2.items.length) out.push("A draft session needs at least one item.");
+  const 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.`);
@@ -3089,9 +3356,9 @@ function validatePendingDrafts(x) {
     else ids.add(i2.id);
     if (i2.scope !== "request" && i2.scope !== "push" && i2.scope !== "docs") out.push(`${at2}: scope must be "request", "push" or "docs".`);
     if (i2.scope === "docs") {
-      const d = i2.docs;
-      if (!d || typeof d !== "object" || !str(d.slug) || !d.slug || !str(d.prompt) || !d.prompt || !optStr(d.path)) out.push(`${at2}: a docs item needs docs {slug, task, prompt}.`);
-      else out.push(...validateDocsTask(d.task).map((m2) => `${at2}: ${m2}`));
+      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)}".`);
@@ -3102,10 +3369,10 @@ function validatePendingDrafts(x) {
     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.");
+  if (p.results !== void 0) {
+    if (!Array.isArray(p.results)) out.push("results must be a list.");
     else
-      for (const r2 of p2.results) {
+      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.");
@@ -3124,8 +3391,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) {
@@ -3181,12 +3448,12 @@ function sanitizeDraftTitle(raw) {
   const t3 = clip(cleanDraftText(raw.replace(/[\r\n]+/g, " ")), DRAFT_TITLE_MAX);
   return t3.charAt(0).toUpperCase() + t3.slice(1);
 }
-function mergeDraftResults(p2, results, at2 = /* @__PURE__ */ new Date()) {
-  const ids = new Set(p2.items.map((i2) => i2.id));
-  const next = new Map((p2.results ?? []).map((r2) => [r2.id, r2]));
+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(", ")}.`);
-    const item = p2.items.find((i2) => i2.id === r2.id);
+    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;
@@ -3196,8 +3463,8 @@ function mergeDraftResults(p2, results, at2 = /* @__PURE__ */ new Date()) {
     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) {
@@ -3232,11 +3499,11 @@ function draftItemBrief(i2) {
   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);
@@ -3245,16 +3512,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;
@@ -3272,7 +3539,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`
   });
@@ -3284,7 +3551,7 @@ 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;
@@ -3378,38 +3645,40 @@ class DraftPoller {
     }
   }
 }
-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);
+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,
-    headSha: p2.headSha,
-    previews: previewLinks(s.apps, { branch: p2.headRef, pr: p2.number, 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,
@@ -3434,21 +3703,21 @@ Exploration: never merged as is. Promote it to review or close it.`,
     previews: previewLinks(s.apps, { branch, pr: pr.number, sha: commit.sha })
   };
 }
-async function explorationTryItOnGitHub(gh, e3) {
-  const [comments, head] = await Promise.all([gh.listIssueComments(e3.number), gh.getBranchSha(e3.branch).catch(() => void 0)]);
+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, e3, config) {
-  const [comments, head] = await Promise.all([gh.listIssueComments(e3.number), gh.getBranchSha(e3.branch).catch(() => void 0)]);
+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, e3.number, config, { branch: e3.branch, sha: head, comments }).catch(() => []);
+  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);
@@ -3456,36 +3725,36 @@ 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) => {
-      if (e3 instanceof GitHubError && e3.auth === "rejected") throw e3;
-      out.warnings.push(`The exploration note stays on the branch (${e3.message}). Delete ${plan.removeFiles.join(", ")} before merging.`);
+    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>.`);
@@ -3519,27 +3788,27 @@ async function declineRequestOnGitHub(gh, n2, reason, by2) {
   await gh.updateIssue(n2, { state: "closed", state_reason: "not_planned" });
 }
 export {
-  af as AAA_MIN,
-  ag as AA_MIN,
+  ai as AAA_MIN,
+  aj as AA_MIN,
   ADMIN_ROLE_ID,
   ANTHROPIC_MESSAGES_URL,
   BELL,
   BRAND_FONTS,
   BRAND_SLUG_RE,
-  ah as BULK_LIMIT,
+  ak as BULK_LIMIT,
   k as COLOR_FIELDS,
   C as COMPONENT_SPECS_VERSION,
   CONFIG_FILE,
-  ai as CONTRAST_CELL_MAX,
-  aj as CONTRAST_CHECKS_FILE,
+  al as CONTRAST_CELL_MAX,
+  am as CONTRAST_CHECKS_FILE,
   ConfigError,
-  ak as DEFAULT_COMPONENT_SPECS_FILE,
-  al as DEFAULT_GOVERNANCE,
-  am as DEFAULT_OVERRIDE,
+  an as DEFAULT_COMPONENT_SPECS_FILE,
+  ao as DEFAULT_GOVERNANCE,
+  ap as DEFAULT_OVERRIDE,
   DEFAULT_PROTECTED_BRANCHES,
-  an as DEFAULT_RIGHTS,
+  aq as DEFAULT_RIGHTS,
   DEFAULT_TOKEN_PATHS,
-  ao as DEFAULT_VISUAL_IMPACT,
+  ar as DEFAULT_VISUAL_IMPACT,
   DEMO_RELEASES,
   DOCS_CHANGE_BUMP,
   DOCS_DRAFT_MODEL,
@@ -3568,16 +3837,16 @@ export {
   EXT_SCOPES,
   GitHubClient,
   GitHubError,
-  ap as JsonParseError,
+  as as JsonParseError,
   LIGHTNESS,
   LayeredTokenSet,
   NEUTRAL_ANCHORS,
-  aq as OWNER_GROUPS,
+  at as OWNER_GROUPS,
   PIN_TOLERANCE,
-  ar as PREVIEW_APP_LABELS,
-  as as PREVIEW_COMMENT_MARKER,
-  at as PREVIEW_PLACEHOLDERS,
-  au 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,
@@ -3587,111 +3856,120 @@ export {
   REQUEST_KINDS,
   REQUEST_LABEL,
   REQUEST_STATUS_LABEL,
-  av as RIGHTS,
-  aw as RIGHT_LABEL,
+  ay as RIGHTS,
+  az as RIGHT_LABEL,
   RISK_LABELS,
-  ax as RISK_TIER,
+  aA as RISK_TIER,
   SIMILARITY_THRESHOLD,
   SINGLE_MODE,
-  ay as SPEC_FIELDS,
+  aB as SPEC_FIELDS,
   STEPS,
   TIER_AXIS,
   TIER_NAMES,
-  az as TIER_ORDER,
+  aC as TIER_ORDER,
   TOKEN_REJECTED_MESSAGE,
   TOKEN_SETTINGS_URL,
-  aA as TeamDirectory,
-  aB as UNRELEASED,
-  aC as VISUAL_CHECK_LABEL,
+  aD as TeamDirectory,
+  aE as UNRELEASED,
+  aF as VISUAL_CHECK_LABEL,
   acceptDocsDraft,
   acceptDocsText,
   addBrandToConfigText,
-  aD as affectedContrast,
-  e2 as aliasOf,
+  aG as affectedContrast,
+  d as aliasOf,
   aliasTarget,
   anatomyLabel,
   anchoredRamp,
   anthropicReplyText,
   anthropicRequest,
-  aE as appForProject,
-  aF as appUrl,
+  aH as appForProject,
+  aI as appUrl,
   applyConfirmedRenames,
   applyDocsSections,
   applyTokenEdits,
-  aG as approverEntries,
-  aH as approverLists,
+  applyTokenMerge,
+  aJ as approverEntries,
+  aK as approverLists,
   assertSafeBranch,
   assignRequestOnGitHub,
-  aI as assignVersions,
+  aL as assignVersions,
   base64ToUtf8,
-  aJ as baseBranchOf,
+  aM as baseBranchOf,
   bellChroma,
-  aK as branchName,
+  aN as branchName,
   branchPreviewUrls,
-  aL as branchSlug,
+  aO as branchSlug,
   brandDisplayName,
   brandPreviewVariables,
   buildHistoryEntry,
   buildReport,
   i as buildTokenSet,
   buildUsageIndex,
-  aM as canShip,
-  aN as changeKind,
-  aO as changeTable,
-  aP as changedModes,
-  aQ as changesetBump,
+  aP as canShip,
+  changeEdits,
+  aQ as changeKind,
+  aR as changeTable,
+  aS as changedModes,
+  aT as changesetBump,
   checkBrandSlug,
   checkLayeredPair,
+  choiceFor,
   classifyAuth,
-  aR as classifyLayered,
+  aU as classifyLayered,
   classifyRisk,
   cleanDocsText,
   cleanDraftText,
-  aS 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,
-  aT as commitMessage,
-  l as compactJson,
+  aW as commitMessage,
+  m as compactJson,
   componentForPath,
-  aU as composeChangeset,
+  aX as composeChangeset,
   composeFiles,
   composeNewBrandBody,
   composePendingDrafts,
-  aV as composePrBody,
-  aW as composeProposalBody,
+  aY as composePrBody,
+  aZ as composeProposalBody,
   composeRequestIssue,
-  aX as composite,
-  aY as contextFor,
+  a_ as composite,
+  a$ as contextFor,
   contextLabel,
-  aZ as contrastDelta,
-  a_ as contrastDeltaTable,
-  a$ as contrastLevel,
-  b0 as contrastPair,
-  b1 as contrastRatio,
+  b0 as contrastDelta,
+  b1 as contrastDeltaTable,
+  b2 as contrastLevel,
+  b3 as contrastPair,
+  b4 as contrastRatio,
   contrastScope,
-  b2 as countChanges,
+  b5 as countChanges,
   createDocsDraftSession,
   createPendingDrafts,
   cssModuleClasses,
+  cssOf,
+  cssVarOf,
   cssVarsIn,
   declineComment,
   declineReasonProblems,
   declineRequestOnGitHub,
-  b3 as defaultContext,
+  decodePicks,
+  defaultChoiceFor,
+  b6 as defaultContext,
   defaultFile,
   defaultScopes,
-  b4 as defaultTitle,
-  b5 as defineConfig,
+  b7 as defaultTitle,
+  b8 as defineConfig,
   deletePendingDrafts,
   demoHistory,
-  b6 as detectLayout,
-  b7 as diffLayered,
+  b9 as detectLayout,
+  ba as diffLayered,
   docsPrompt,
   docsSectionShapes,
   docsSectionsAnswer,
@@ -3708,12 +3986,13 @@ export {
   dtcgColor,
   effectiveScopes,
   emptyTokenFile,
+  encodePicks,
   ensureRequestsBranch,
-  b8 as entriesFor,
-  b9 as entryLabel,
+  bb as entriesFor,
+  bc as entryLabel,
   evaluatePairs,
-  ba as expandEntries,
-  bb as expandOwners,
+  bd as expandEntries,
+  be as expandOwners,
   explorationBranch,
   explorationNote,
   explorationNotePath,
@@ -3729,62 +4008,62 @@ export {
   explorationTestBuildOnGitHub,
   explorationTryIt,
   explorationTryItOnGitHub,
-  bc as fieldChanges,
-  bd as fileModes,
-  be as filterHistory,
+  bf as fieldChanges,
+  bg as fileModes,
+  bh as filterHistory,
   findExplorationOnGitHub,
   findPreviewComment,
   findReferenceProblems,
-  bf as findToken,
-  bg as findVercelComment,
-  bh as firstParagraph,
-  m as flattenLayerFile,
-  bi as flattenTokens,
+  bi as findToken,
+  bj as findVercelComment,
+  bk as firstParagraph,
+  n as flattenLayerFile,
+  flattenTokens,
   formatChangeset,
   formatDocsJson,
-  bj as formatNumber,
-  bk as formatOwnerEntry,
+  bl as formatNumber,
+  bm as formatOwnerEntry,
   formatValue,
   friendlyMessage,
   fromHex,
   fromPlain,
   generateRamp,
-  bl as getChild,
+  bn as getChild,
   getEntry,
   gitHubHistoryBackend,
   g2 as globToRegExp,
-  bm as groupsPhrase,
+  bo as groupsPhrase,
   h as hashSpec,
   h2 as hexToRgba,
-  bn as holdersOf,
+  bp as holdersOf,
   j as iconComponentName,
   idExtensionFor,
   impactedModules,
   importsIn,
-  bo as indexByPath,
-  bp as inheritedTypeAt,
-  bq as installCommand,
-  br as installCommandFromPreviewComment,
+  bq as indexByPath,
+  br as inheritedTypeAt,
+  bs as installCommand,
+  bt as installCommandFromPreviewComment,
   isActiveExploration,
   isAlias,
   isDocsSelectionMode,
   isDraftSessionId,
   isExplorationBranch,
   isExplorationPull,
-  bs as isGuardrail,
+  bu as isGuardrail,
   isHex,
   isMissingPermission,
   isMultiMode,
   isPlanRefusal,
   isProseKey,
-  bt as isTeamEntry,
-  bu as isTokenFile,
+  bv as isTeamEntry,
+  bw as isTokenFile,
   isTokenRejected,
-  bv as isVercelComment,
+  bx as isVercelComment,
   jiraIssueFields,
-  bw as kindForMin,
-  bx as layeredImpact,
-  n as layeredParityIssues,
+  by as kindForMin,
+  bz as layeredImpact,
+  o as layeredParityIssues,
   g as layoutOptions,
   levenshtein,
   linkRequestToExplorationOnGitHub,
@@ -3796,16 +4075,17 @@ export {
   loadProtection,
   loadRepoFiles,
   loadRequiredChecks,
-  by as luminance,
+  bA as luminance,
   markClaudeDraft,
   mergeDocsDraft,
   mergeDraftResults,
   mergeReleases,
+  missingChoices,
   missingPermissionMessage,
   missingProse,
   modeDisplayName,
   modeFile,
-  bz as modeLabel,
+  bB as modeLabel,
   modesOf$1 as modesOf,
   moveToken,
   nearestStep,
@@ -3814,83 +4094,88 @@ export {
   neutralOffset,
   newBrandSection,
   newDraftSessionId,
-  bA as nodesEqual,
-  bB as normalizeRights,
+  bC as nodesEqual,
+  bD as normalizeRights,
   oklch,
   oklchToLinear,
-  bC as overrideKey,
-  bD as ownerEntryProblems,
+  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,
-  bH as parseOwnerEntry,
+  bJ as parseOwnerEntry,
   parsePendingDrafts,
   parseRepo,
   parseRequestIssue,
   parseStructureChange,
   parseTokenFile,
-  bI as parseVercelComment,
+  bK as parseVercelComment,
   patchDocsJson,
   pathId,
   pathSimilarity,
   permissionLabel,
+  pickedOption,
   plainEqual,
   planNewBrand,
-  bJ as planRestore,
-  bK as planRevert,
-  bL as planToJson,
+  bL as planRestore,
+  bM as planRevert,
+  bN as planToJson,
+  planTokenMerge,
   e as prNumberFromSubject,
   prefillDocs,
-  bM as previewComment,
+  bO as previewComment,
   previewLinks,
-  bN as previewLinksOf,
-  bO as previewUrl,
+  bP as previewLinksOf,
+  previewOverrides,
+  bQ as previewUrl,
   previewsSettled,
-  bP as projectOfLabel,
+  bR as projectOfLabel,
   promoteExplorationOnGitHub,
   promotionPlan,
   propsTable,
   protectLibrary,
   protectRefusal,
-  bQ as protectedBranchesOf,
+  bS as protectedBranchesOf,
   protectionRuleset,
   protectionRulesetName,
   protectionSentence,
   protectionState,
   pushChangeRows,
+  rateLimitMessage,
   readPendingDrafts,
   readPreviewComment,
   readTokenAt,
   reconcileIds,
   releasesFromTags,
   removeToken,
-  bR as renderedColor,
+  removedSide,
+  bT as renderedColor,
   requestBrief,
   requestImagePath,
   requestIssueTitle,
   requestStatus,
   requiredCheckNames,
   requiredPermission,
-  bS as resolve,
+  resolve,
   resolveBranchPreviews,
   r as rgbaToDtcg,
-  q as rgbaToHex,
-  bT as rightsProblems,
+  rgbaToHex,
+  bU as rightsProblems,
   round3,
   rulesSettingsUrl,
   rulesetTargetsDefault,
-  bU as runLayeredContrast,
+  bV as runLayeredContrast,
   sameScopes,
-  bV as sameToken,
+  bW as sameToken,
   sanitizeDocsReplacement,
   sanitizeDocsResult,
   sanitizeDocsSections,
@@ -3904,21 +4189,22 @@ export {
   serializePendingDrafts,
   serializeTokenFile,
   shadowedEdits,
-  bW as shipPolicy,
+  bX as shipPolicy,
   shortVariant,
   shortVariants,
   slugify,
-  bX as snapshotUrl,
-  bY as specHash,
+  bY as snapshotUrl,
+  bZ as specHash,
   startExplorationOnGitHub,
-  bZ as summarizeTokenChange,
-  b_ as tarballAssetName,
-  b$ as tarballUrl,
-  c0 as teamKey,
-  c1 as teamKeyOf,
-  c2 as teamUnreadableMessage,
-  c3 as teamsIn,
-  c4 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,
   c5 as titleOf,
   t2 as toAlias,
@@ -3934,6 +4220,7 @@ export {
   ca as tokenNode,
   tokenUsage,
   tokensPath,
+  unpicked,
   cb as unreadableShipTeams,
   cc as unreadableTeams,
   updatePendingDrafts,