@bridge-ds/core 0.16.0 → 0.17.0

package/dist/{repo-source-73kARDJv.js → repo-source-B4jNZhyC.js}

@@ -1,4 +1,4 @@
-import { ck as tokenBump, aS as changeKind, L as LayeredTokenSet, aJ as aliasOf, b_ as rgbaToDtcg, bn as hexToRgba, w as parseTokenFile, q as emptyTokenFile, s as serializeTokenFile, C as moveToken, r as removeToken, bq as inheritedTypeAt, u as upsertToken, H as readTokenAt, aY as comboKey, bZ as renderedColor, b4 as contrastRatio, z as rgbaToHex, U as classifyRisk, W as RISK_LABELS, V as CONFIG_FILE, N as loadConfig, ah as ConfigError, _ as DEFAULT_TOKEN_PATHS, ag as globToRegExp, ae as slugify, Q as validateLayered, bJ as parseJson, c2 as serializeJson, bO as plainEqual, cj as toPlain, bl as getEntry, bj as fromPlain, m as modeDisplayName, A as formatValue, X as previewLinks, a1 as readPreviewComment, aR as canShip, cr as whoCanShipSentence, cm as unreadableShipTeams, c5 as soloApprover, aN as approverLists, O as tokensPath, a6 as NEEDED_BY_LABEL, K as selectTokenFiles, R as parseContrastChecks } from "./prod-branch-CSM0c2OF.js";
+import { cn as tokenBump, aU as changeKind, L as LayeredTokenSet, aL as aliasOf, c1 as rgbaToDtcg, bq as hexToRgba, w as parseTokenFile, q as emptyTokenFile, s as serializeTokenFile, C as moveToken, r as removeToken, bt as inheritedTypeAt, u as upsertToken, H as readTokenAt, a_ as comboKey, c0 as renderedColor, b6 as contrastRatio, z as rgbaToHex, U as classifyRisk, W as RISK_LABELS, V as CONFIG_FILE, N as loadConfig, ah as ConfigError, _ as DEFAULT_TOKEN_PATHS, ag as globToRegExp, ae as slugify, Q as validateLayered, bM as parseJson, c5 as serializeJson, bR as plainEqual, cm as toPlain, bn as getEntry, bl as fromPlain, m as modeDisplayName, A as formatValue, X as previewLinks, a1 as readPreviewComment, aT as canShip, cv as whoCanShipSentence, cp as unreadableShipTeams, c8 as soloApprover, aP as approverLists, O as tokensPath, a6 as NEEDED_BY_LABEL, K as selectTokenFiles, R as parseContrastChecks } from "./prod-branch-DenQkr_e.js";
 function changesetBump(changes) {
   return tokenBump(changes) ?? "patch";
 }
@@ -2574,6 +2574,31 @@ function explorationRules(branch) {
     "- Do not mark the pull request ready for review and do not remove the exploration label: promoting is a person's decision."
   ];
 }
+const escape = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+function properWord(word, names2) {
+  const bare2 = word.replace(/[^\p{L}\p{N}]+$/u, "");
+  if (!bare2) return false;
+  if (names2.some((n) => n === bare2)) return true;
+  return /\p{Lu}/u.test(bare2.slice(1));
+}
+function lowerFirstWord(text, names2 = []) {
+  const first = text.split(/\s+/)[0] ?? "";
+  if (!first || properWord(first, names2)) return text;
+  return `${text.charAt(0).toLowerCase()}${text.slice(1)}`;
+}
+function subjectTitle(subject, title, names2 = []) {
+  const t = title.trim().replace(/\.$/, "");
+  const keep = [subject, ...names2];
+  const s = subject.trim();
+  if (!s) return t;
+  const m = new RegExp(`^${escape(s)}(?=$|[^\\p{L}\\p{N}])\\s*(:)?\\s*`, "iu").exec(t);
+  if (m) {
+    const rest = t.slice(m[0].length);
+    if (!rest) return s;
+    return m[1] ? `${s}: ${lowerFirstWord(rest, keep)}` : `${s} ${rest}`;
+  }
+  return `${s}: ${lowerFirstWord(t, keep)}`;
+}
 const REQUEST_KINDS = [
   { value: "new-component", label: "New component", hint: "A component the design system does not have yet." },
   { value: "new-variant", label: "New variant", hint: "A size, tone or state the component does not have yet." },
@@ -2589,8 +2614,7 @@ const MARK$1 = "bridge-request";
 const kindLabel$1 = (k) => REQUEST_KINDS.find((x) => x.value === k)?.label ?? "Other";
 const kindSlug = (k) => `request: ${k}`;
 function requestIssueTitle(r) {
-  const t = r.title.trim().replace(/\.$/, "");
-  return `${r.component}: ${t.charAt(0).toLowerCase()}${t.slice(1)}`;
+  return subjectTitle(r.component, r.title);
 }
 function composeRequestIssue(r, opts = {}) {
   const rows = r.changes.length ? ["| What | Now | Requested |", "| --- | --- | --- |", ...r.changes.map((c) => `| ${cell$1(c.field)} | ${cell$1(c.before ?? "")} | ${cell$1(c.after ?? "")} |`)] : [];
@@ -3149,15 +3173,36 @@ function reviewStatusKind(input) {
   if (input.mergeable === false) return out("conflict");
   if (input.ci?.state === "pending") return out("ci-running");
   if (!input.ci || !input.approvals) return out("unknown");
-  if (input.mergeable === null) return out("checking");
   const tier = input.tier ?? 3;
   if (tier >= 2) {
     if (!input.approvals.design) return out("needs-design");
     if (!input.approvals.tech) return out("needs-tech");
   } else if (!input.approvals.approvers.length) return out("needs-approval");
+  if (input.mergeable === null) return out("checking");
   const gate = mergeGate({ tier: input.tier, ci: input.ci, approvals: input.approvals, draft: Boolean(input.draft), mergeable: input.mergeable, state: input.state ?? "open", merged_at: input.merged_at });
   return gate.allowed ? out("ready") : out("unknown");
 }
+const REVIEW_STATUS_LABEL = {
+  merged: "Merged",
+  closed: "Closed",
+  draft: "Draft",
+  "ci-failing": "Blocked by tests",
+  "changes-requested": "Changes requested",
+  "ci-running": "Tests running",
+  "needs-design": "Needs design approval",
+  "needs-tech": "Needs tech approval",
+  "needs-approval": "Needs approval",
+  conflict: "Conflict with main",
+  checking: "Checking for conflicts",
+  ready: "Ready to merge",
+  unknown: "Status unknown"
+};
+const CI_STATE_LABEL = {
+  pass: "Tests pass",
+  fail: "Tests fail",
+  pending: "Tests running",
+  none: "No automated checks"
+};
 const BOTS = /* @__PURE__ */ new Set(["github-actions[bot]", "app/github-actions", "changeset-bot[bot]"]);
 const isReleasePull = (p) => p.head.ref.startsWith("changeset-release/");
 function isAutomationPull(p) {
@@ -3539,6 +3584,10 @@ const SUGGESTION_STATE_LABELS = {
   approved: "suggestion: approved",
   applying: "suggestion: applying"
 };
+const SUGGESTION_FINAL_LABELS = {
+  applied: "suggestion: applied",
+  declined: "suggestion: declined"
+};
 const SUGGESTION_STATUS_LABEL = {
   "needs-review": "Needs review",
   "changes-requested": "Changes requested",
@@ -3759,8 +3808,8 @@ function suggestionSubject(p) {
   return KIND_SUBJECT[p.kind];
 }
 function suggestionIssueTitle(p) {
-  const t = p.title.trim().replace(/\.$/, "");
-  return `${suggestionSubject(p)}: ${t.charAt(0).toLowerCase()}${t.slice(1)}`;
+  const names2 = [...(p.docs ?? []).map((d) => d.component), ...p.componentSpec?.component ? [p.componentSpec.component] : []];
+  return subjectTitle(suggestionSubject(p), p.title, names2);
 }
 function suggestionLabels(p, opts = {}) {
   return [
@@ -3794,9 +3843,22 @@ function suggestionStatus(i) {
   if (i.outdated) return "outdated";
   return i.review ?? "needs-review";
 }
+function withOutdated(status, outdated) {
+  return outdated && (status === "needs-review" || status === "changes-requested" || status === "approved") ? "outdated" : status;
+}
 function suggestionStateLabel(status) {
+  if (status === "applied" || status === "declined") return SUGGESTION_FINAL_LABELS[status];
   return status in SUGGESTION_STATE_LABELS ? SUGGESTION_STATE_LABELS[status] : null;
 }
+const SUGGESTION_STATUS_LABELS = [...Object.values(SUGGESTION_STATE_LABELS), ...Object.values(SUGGESTION_FINAL_LABELS)];
+function suggestionLabelChanges(labels, status) {
+  if (status === "outdated") return { add: [], remove: [] };
+  const want = suggestionStateLabel(status);
+  return {
+    add: want && !labels.includes(want) ? [want] : [],
+    remove: SUGGESTION_STATUS_LABELS.filter((l) => l !== want && labels.includes(l))
+  };
+}
 const bridgeMcpInstallCommand = (repo) => `claude mcp add bridge -s user -- npx -y @bridge-ds/mcp --repo ${repo?.trim() || "<owner/name>"}`;
 const MARK = "bridge-suggestion";
 const PART_SCHEMA = "bridge.suggestion-part/1";
@@ -4185,82 +4247,403 @@ function suggestionPathProblems(p, config) {
   }
   return [...new Set(out)];
 }
-async function createSuggestionOnGitHub(gh, payload, opts = {}) {
-  const issue = composeSuggestionIssue(payload, { repo: gh.fullName, ...opts });
-  const created = await gh.createIssue({ title: issue.title, body: issue.body, labels: issue.labels, assignees: issue.assignees });
-  for (const [i, part] of issue.parts.entries()) {
-    try {
-      await gh.createIssueComment(created.number, part);
-    } catch (err) {
-      const why = err instanceof Error ? err.message : String(err);
-      throw new GitHubError(err instanceof GitHubError ? err.status : 500, `Suggestion #${created.number} is incomplete: part ${i + 1} of ${issue.parts.length} could not be posted (${why}). Send it again, then close #${created.number}.`);
-    }
-  }
-  const warnings = [];
-  const missing = issue.labels.filter((l) => !created.labels.includes(l));
-  if (created.labels.length && missing.length) warnings.push(`GitHub did not keep these labels on #${created.number}: ${missing.join(", ")}.`);
-  return { number: created.number, url: created.url, sha: issue.sha, parts: issue.parts.length, warnings };
+const SUGGESTION_APPLY_EXIT = {
+  ready: 0,
+  "already-applied": 0,
+  conflict: 3,
+  "not-approved": 1,
+  blocked: 1,
+  refused: 1
+};
+const same = (a, b) => canonicalJson(a) === canonicalJson(b);
+const show = (v) => v === void 0 ? "nothing" : typeof v === "string" ? v : JSON.stringify(v);
+function tokenRoot(config) {
+  const r = config.tokens.root.replace(/\/+$/, "");
+  return r === "." ? "" : r;
 }
-function linkedPullsOf(n, pulls) {
-  return pulls.filter((p) => closingIssueNumbers(p.body).includes(n)).map((p) => ({ number: p.number, url: p.url, state: p.state === "open" ? "open" : "closed", merged: p.state === "merged" }));
+function tokenFileOf(config, path) {
+  const root = tokenRoot(config);
+  if (root && !path.startsWith(`${root}/`)) return null;
+  if (!selectTokenFiles(config, [path]).length) return null;
+  return root ? path.slice(root.length + 1) : path;
 }
-async function listSuggestionsOnGitHub(gh, opts = {}) {
-  const issues = await gh.listIssues({ label: SUGGESTION_LABEL, state: opts.state ?? "open", perPage: opts.perPage ?? 50 });
-  const pulls = opts.pulls ?? (issues.length ? await gh.listPullRequests("all").catch(() => []) : []);
-  return issues.map((i) => listItem(i, pulls));
+function planTokenEdit(set, e, changes) {
+  const base = { type: "token", path: e.path, edit: e, ...e.file ? { file: e.file } : {} };
+  const defsAt = (path) => set.defs.filter((d) => d.path === path && (!e.file || d.file === e.file));
+  const recorded = (file, path = e.path) => changes.find((c) => c.path === path && c.file === file && (e.op === "rename" ? c.kind === "renamed" : true));
+  const conflict = (detail, extra = {}) => ({ op: { ...base, state: "conflict", detail, ...extra }, notes: [] });
+  const done = (detail) => ({ op: { ...base, state: "already-applied", detail }, notes: [] });
+  let result;
+  try {
+    result = applyTokenEdits(set, [e]);
+  } catch (err) {
+    const why = err instanceof Error ? err.message : String(err);
+    switch (e.op) {
+      case "rename": {
+        const hasOld = defsAt(e.path).length > 0;
+        const hasNew = set.defs.some((d) => d.path === e.newPath);
+        if (!hasOld && hasNew) return done(`Already renamed to ${e.newPath}.`);
+        return conflict(hasOld && hasNew ? `Both ${e.path} and ${e.newPath} exist now: rename it by hand.` : `${e.path} no longer exists: ${why}`);
+      }
+      case "remove":
+        if (!defsAt(e.path).length) return done("Already removed.");
+        return conflict(why);
+      case "add": {
+        const existing = defsAt(e.path);
+        if (!existing.length) return conflict(why);
+        const want = (file) => {
+          const c = recorded(file);
+          if (c && c.after !== void 0) return c.after;
+          return coerceValue(e.value, e.type ?? existing.find((d2) => d2.file === file)?.type);
+        };
+        const all = existing.every((d2) => same(d2.value, want(d2.file)));
+        if (all) return done("Already added with the suggested value.");
+        const d = existing.find((x) => !same(x.value, want(x.file)));
+        return conflict(`Someone added ${e.path} with another value since.`, { file: d.file, after: want(d.file), now: d.value });
+      }
+      default:
+        return conflict(defsAt(e.path).length ? why : `${e.path} no longer exists, so its value cannot be set.`);
+    }
+  }
+  if (!result.touched.length) return done("Already has the suggested value.");
+  if (e.op === "set" || e.op === "remove" || e.op === "rename") {
+    for (const d of defsAt(e.path)) {
+      const c = recorded(d.file, e.op === "rename" ? e.newPath ?? e.path : e.path);
+      if (!c) continue;
+      const okNow = same(d.value, c.before) || e.op === "set" && same(d.value, c.after);
+      if (!okNow) return conflict(`${e.path} changed since it was suggested (now ${show(d.value)}, suggested from ${show(c.before)}).`, { file: d.file, before: c.before, after: c.after, now: d.value });
+    }
+  }
+  const verb = e.op === "set" ? "Set" : e.op === "add" ? "Add" : e.op === "remove" ? "Remove" : `Rename to ${e.newPath ?? ""}`;
+  return { op: { ...base, state: "apply", detail: `${verb} in ${result.touched.join(", ")}.` }, files: result.files, notes: result.notes };
 }
-function listItem(i, pulls) {
-  const linkedPrs = linkedPullsOf(i.number, pulls);
-  const cached = suggestionStateFromLabels(i.labels);
-  const t = i.labels.map((l) => /^tier: ([123])$/.exec(l)?.[1]).find(Boolean);
-  return {
-    number: i.number,
-    title: i.title,
-    url: i.url,
-    author: i.author,
-    createdAt: i.createdAt,
-    state: i.state,
-    stateReason: i.stateReason,
-    labels: i.labels,
-    kind: suggestionKindFromLabels(i.labels),
-    tier: t ? Number(t) : void 0,
-    linkedPrs,
-    status: suggestionStatus({ state: i.state, stateReason: i.stateReason, linkedPrs, applied: cached === "applying", review: cached === "applying" ? void 0 : cached })
-  };
+async function planFile(ws, baseSha, f) {
+  const base = { type: "file", path: f.path };
+  const cur = await ws.read(f.path);
+  const curSha = cur?.sha ?? null;
+  const theirs = f.afterSha === null ? null : f.content ?? null;
+  if (curSha === f.afterSha) return { op: { ...base, state: "already-applied", detail: f.afterSha === null ? "Already deleted." : "Already has the suggested content." } };
+  if (curSha === f.beforeSha) return { op: { ...base, state: "apply", detail: f.afterSha === null ? "Delete it." : f.beforeSha === null ? "Create it." : "Replace it with the suggested content." }, content: theirs };
+  if (f.beforeSha === null) return { op: { ...base, state: "conflict", detail: "The suggestion creates this file, but a different one exists now." } };
+  if (!cur) return { op: { ...base, state: "conflict", detail: "The suggestion changes this file, but it was deleted since." } };
+  if (theirs === null) return { op: { ...base, state: "conflict", detail: "The suggestion deletes this file, but it changed since." } };
+  const original = await ws.readAt(baseSha, f.path);
+  if (original === null || gitBlobSha(original) !== f.beforeSha || !ws.merge) {
+    return { op: { ...base, state: "conflict", detail: original === null ? "The file changed since and its version at the suggestion base cannot be read, so it cannot be merged." : "The file changed since and cannot be merged here." } };
+  }
+  const merged = await ws.merge({ path: f.path, ours: cur.text, base: original, theirs });
+  if (!merged.clean) return { op: { ...base, state: "conflict", detail: `The file changed since and the merge has ${merged.conflicts} conflict(s).`, hunks: merged.conflicts } };
+  if (merged.text === cur.text) return { op: { ...base, state: "already-applied", detail: "Already has the suggested lines." } };
+  return { op: { ...base, state: "apply-merged", detail: "The file changed since: merged with the suggested lines, no conflict." }, content: merged.text };
 }
-async function getSuggestionOnGitHub(gh, n, gov, opts = {}) {
-  const [issue, comments, pulls] = await Promise.all([gh.getIssue(n), gh.listIssueComments(n), opts.pulls ? Promise.resolve(opts.pulls) : gh.listPullRequests("all").catch(() => [])]);
-  const parsed = parseSuggestionIssue(issue.body, { comments, author: issue.author || void 0 });
-  const linkedPrs = linkedPullsOf(n, pulls);
-  const applied = comments.flatMap((c) => parseSuggestionAppliedComment(c.body) ?? []);
-  const approvals = parsed.ok ? summarizeSuggestionApprovals(comments, gov, { payloadSha: parsed.sha, author: issue.author }) : void 0;
-  const status = suggestionStatus({
-    state: issue.state,
-    stateReason: issue.stateReason,
-    linkedPrs,
-    applied: parsed.ok && applied.some((a) => a.payloadSha === parsed.sha),
-    outdated: opts.outdated,
-    review: parsed.ok && approvals ? suggestionReviewState(parsed.payload.tier.tier, approvals) : void 0
+async function planSuggestionApply(input) {
+  const { parsed, config, workspace: ws } = input;
+  const payload = parsed.payload;
+  const notes = [];
+  const out = (outcome, message, rest2 = {}) => ({
+    outcome,
+    exitCode: SUGGESTION_APPLY_EXIT[outcome],
+    message,
+    payloadSha: parsed.sha,
+    payload,
+    gate: null,
+    ops: [],
+    writes: [],
+    checks: null,
+    problems: [],
+    notes,
+    ...payload.componentSpec ? { brief: payload.componentSpec.brief } : {},
+    ...rest2
   });
-  return { issue, parsed, comments, approvals, linkedPrs, applied, status };
-}
-async function syncSuggestionStateLabel(gh, n, labels, status) {
-  const want = suggestionStateLabel(status);
-  let ok = true;
-  for (const l of Object.values(SUGGESTION_STATE_LABELS)) {
-    if (l === want || !labels.includes(l)) continue;
+  const problems = suggestionPathProblems(payload, config);
+  if (payload.checks.blocked) problems.push(`It was suggested with a failing check (${payload.checks.blocked}): ask the author to fix it and send it again.`);
+  for (const f of payload.files ?? []) {
+    if (f.afterSha !== null && typeof f.content !== "string") problems.push(`"${f.path}" has no content in the suggestion: it is incomplete, ask the author to send it again.`);
+    else if (f.afterSha !== null && gitBlobSha(f.content) !== f.afterSha) problems.push(`"${f.path}" does not match the content it was suggested with: someone edited it by hand.`);
+  }
+  if (problems.length) return out("refused", "Not applied: the suggestion asks for something Bridge never writes.", { problems: [...new Set(problems)] });
+  if (parsed.edited && !input.acceptEdited) {
+    return out("refused", 'Not applied: the suggestion was edited by hand since Bridge wrote it. Read the change, then apply it with "accept edited" if it is right.', {
+      problems: ["The payload no longer matches the sha Bridge recorded."]
+    });
+  }
+  const root = tokenRoot(config);
+  const tokenFiles = selectTokenFiles(config, await ws.list());
+  const targets = [
+    ...(payload.files ?? []).map((f) => f.path),
+    ...(payload.docs ?? []).map((d) => d.path),
+    ...payload.componentSpec ? [payload.componentSpec.specPath] : [],
+    ...payload.tokens?.edits.length ? tokenFiles.map((f) => root ? `${root}/${f}` : f) : []
+  ];
+  if (ws.isSymlink) {
+    const links = [];
+    for (const p of new Set(targets)) if (await ws.isSymlink(p)) links.push(`"${p}" is a symbolic link (or inside one): Bridge never writes through links.`);
+    if (links.length) return out("refused", "Not applied: the suggestion writes through a symbolic link.", { problems: links });
+  }
+  const governance = input.governance ?? { owners: config.governance.owners, rights: config.governance.rights ?? null, soloOwnerCanApproveBoth: config.governance.soloOwnerCanApproveBoth };
+  const approvals = summarizeSuggestionApprovals(input.comments, governance, { payloadSha: parsed.sha, author: input.author });
+  const review = suggestionReviewState(payload.tier.tier, approvals);
+  const missing = pendingApprovals(payload.tier.tier, approvals);
+  const approved = review === "approved";
+  const gate = { review, missing, approvals, forced: !approved && Boolean(input.forceUnapproved), edited: parsed.edited };
+  const ops = [];
+  const writes = /* @__PURE__ */ new Map();
+  const current = /* @__PURE__ */ new Map();
+  for (const f of tokenFiles) {
+    const r = await ws.read(root ? `${root}/${f}` : f);
+    if (r) current.set(f, r.text);
+  }
+  const before = new LayeredTokenSet(config, current);
+  let set = before;
+  for (const e of payload.tokens?.edits ?? []) {
+    const r = planTokenEdit(set, e, payload.tokens.changes);
+    ops.push(r.op);
+    notes.push(...r.notes);
+    if (r.op.state === "apply" && r.files) {
+      set = new LayeredTokenSet(config, r.files);
+    }
+  }
+  for (const [f, text] of set.files) if (text !== before.files.get(f)) writes.set(set.repoPath(f), text);
+  for (const f of payload.files ?? []) {
+    if (writes.has(f.path)) {
+      notes.push(`${f.path}: the token edits write this file, its copy in the suggestion is not used.`);
+      continue;
+    }
+    const r = await planFile(ws, payload.base.sha, f);
+    ops.push(r.op);
+    if (r.op.state === "apply" || r.op.state === "apply-merged") writes.set(f.path, r.content ?? null);
+  }
+  for (const d of payload.docs ?? []) {
+    const base = { type: "docs", path: d.path };
+    const docs = d.after;
+    let text;
     try {
-      await gh.removeLabel(n, l);
-    } catch {
-      ok = false;
+      const issues = validateDocs(docs);
+      if (issues.length) {
+        problems.push(`${d.path}: ${issues.map((i) => i.message).join(" ")}`);
+        continue;
+      }
+      const cur = await ws.read(d.path);
+      text = docsFileText(docs, cur?.text ?? null);
+      if (cur && text === cur.text) {
+        ops.push({ ...base, state: "already-applied", detail: "The docs already say this." });
+        continue;
+      }
+      ops.push({ ...base, state: "apply", detail: cur ? "Update the changed fields; other fields stay as they are now." : "Create the docs file." });
+      writes.set(d.path, text);
+    } catch (err) {
+      problems.push(`${d.path}: the suggested docs are not a docs.json Bridge can read (${err instanceof Error ? err.message : String(err)}).`);
     }
   }
-  if (want && !labels.includes(want)) ok = await gh.addLabels(n, [want]) && ok;
-  return ok ? null : `The state label on #${n} could not be updated; the status shown in Bridge is still right.`;
-}
-async function reviewSuggestionOnGitHub(gh, n, input, gov) {
-  if (input.event === "request-changes" && !input.message?.trim()) throw new GitHubError(422, "Say what should change, in a sentence or two: the author reads it.");
-  const before = await getSuggestionOnGitHub(gh, n, gov);
+  if (payload.componentSpec) {
+    const s = payload.componentSpec;
+    const text = `${JSON.stringify(s.spec, null, 2)}
+`;
+    const cur = await ws.read(s.specPath);
+    if (cur && cur.text === text) ops.push({ type: "component-spec", path: s.specPath, state: "already-applied", detail: "The spec file is already there." });
+    else {
+      ops.push({ type: "component-spec", path: s.specPath, state: "apply", detail: `Write the spec; the ${s.component} code itself is written from the brief.` });
+      writes.set(s.specPath, text);
+    }
+  }
+  const afterFiles = new Map(set.files);
+  for (const [p, content] of writes) {
+    const tf = tokenFileOf(config, p);
+    if (!tf) continue;
+    if (content === null) afterFiles.delete(tf);
+    else afterFiles.set(tf, content);
+  }
+  const after = new LayeredTokenSet(config, afterFiles);
+  const tokenChanges = diffLayered(before, after);
+  const issueKey2 = (i) => `${i.code}|${i.path ?? ""}|${i.file ?? ""}|${i.message}`;
+  const prevErrors = new Set(validateLayered(before).map(issueKey2));
+  const newErrors = tokenChanges.length ? validateLayered(after).filter((i) => i.level === "error" && !prevErrors.has(issueKey2(i))) : [];
+  let pairs = [];
+  if (config.contrast && tokenChanges.length) {
+    try {
+      pairs = parseContrastChecks((await ws.read(config.contrast.path))?.text);
+    } catch {
+      notes.push(`${config.contrast.path} does not parse: contrast was not checked.`);
+    }
+  }
+  const modes = config.contrast?.modes;
+  const contrast = pairs.length ? contrastDelta(runLayeredContrast(before, pairs, modes), runLayeredContrast(after, pairs, modes)) : [];
+  const newFailures = contrast.filter((d) => d.passBefore && !d.passAfter);
+  const otherFiles = [...writes.keys()].filter((p) => !tokenFileOf(config, p));
+  const tier = classifyRisk({ tokenChanges: tokenChanges.map((c) => ({ kind: c.kind, path: c.path, ...c.kind === "changed" ? { descriptionOnly: c.fields.length > 0 && c.fields.every((x) => x === "description") } : {} })), files: otherFiles.map((path) => ({ path })), config });
+  const tierIncreased = writes.size > 0 && tier.tier > payload.tier.tier;
+  const checks = { tierWhenSuggested: payload.tier.tier, tier, tierIncreased, newErrors, newFailures, contrast, tokenChanges };
+  const rest = { gate, ops, checks, problems };
+  if (problems.length) return out("refused", "Not applied: part of the suggestion is not valid.", rest);
+  const conflicts = ops.filter((o) => o.state === "conflict");
+  if (conflicts.length) {
+    return out("conflict", `Not applied: ${conflicts.length} change(s) conflict with the code now. Ask the author to refresh the suggestion on today's code, or apply those parts by hand.`, rest);
+  }
+  if (!writes.size) return out("already-applied", "Already applied: the code has every change of this suggestion.", rest);
+  if (newErrors.length || newFailures.length) {
+    const why = [newErrors.length ? `${newErrors.length} new validation error(s)` : "", newFailures.length ? `${newFailures.length} contrast pair(s) would fail` : ""].filter(Boolean).join(" and ");
+    return out("blocked", `Not applied: on today's code it would add ${why}. Ask the author to refresh the suggestion.`, rest);
+  }
+  if (tierIncreased && !input.forceUnapproved) {
+    return out("blocked", `Not applied: on today's code it is a tier ${tier.tier} change, it was approved as tier ${payload.tier.tier}. It needs a new approval.`, rest);
+  }
+  if (!approved && !input.forceUnapproved) {
+    const who = review === "changes-requested" ? `changes requested by ${approvals.changesRequested.map((l) => `@${l}`).join(", ")}` : `missing ${missing.map((m) => m === "approval" ? "an approval" : `${m} approval`).join(" and ")}`;
+    return out("not-approved", `Not applied: it is not approved yet (${who}). Ask the owners to review it on the issue.`, rest);
+  }
+  const forced = gate.forced || tierIncreased && Boolean(input.forceUnapproved);
+  return out("ready", `Ready: ${writes.size} file(s) to write${forced ? ", without every approval" : ""}.`, {
+    ...rest,
+    gate: { ...gate, forced },
+    writes: [...writes].map(([path, content]) => ({ path, content })).sort((a, b) => a.path.localeCompare(b.path))
+  });
+}
+function suggestionAppliedComment(plan, where2) {
+  return composeSuggestionAppliedComment({ ...where2, payloadSha: plan.payloadSha, ...plan.gate?.forced ? { forced: true } : {} });
+}
+function suggestionApplyTable(plan) {
+  const label = { "already-applied": "already applied", apply: "apply", "apply-merged": "apply (merged)", conflict: "**conflict**" };
+  const cell2 = (s) => s.replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
+  return ["| Change | Result | Detail |", "| --- | --- | --- |", ...plan.ops.map((o) => `| \`${cell2(o.path)}\` | ${label[o.state]} | ${cell2(o.detail)} |`)].join("\n");
+}
+async function createSuggestionOnGitHub(gh, payload, opts = {}) {
+  const issue = composeSuggestionIssue(payload, { repo: gh.fullName, ...opts });
+  const created = await gh.createIssue({ title: issue.title, body: issue.body, labels: issue.labels, assignees: issue.assignees });
+  for (const [i, part] of issue.parts.entries()) {
+    try {
+      await gh.createIssueComment(created.number, part);
+    } catch (err) {
+      const why = err instanceof Error ? err.message : String(err);
+      throw new GitHubError(err instanceof GitHubError ? err.status : 500, `Suggestion #${created.number} is incomplete: part ${i + 1} of ${issue.parts.length} could not be posted (${why}). Send it again, then close #${created.number}.`);
+    }
+  }
+  const warnings = [];
+  const missing = issue.labels.filter((l) => !created.labels.includes(l));
+  if (created.labels.length && missing.length) warnings.push(`GitHub did not keep these labels on #${created.number}: ${missing.join(", ")}.`);
+  return { number: created.number, url: created.url, sha: issue.sha, parts: issue.parts.length, warnings };
+}
+function linkedPullsOf(n, pulls) {
+  return pulls.filter((p) => closingIssueNumbers(p.body).includes(n)).map((p) => ({ number: p.number, url: p.url, state: p.state === "open" ? "open" : "closed", merged: p.state === "merged" }));
+}
+async function listSuggestionsOnGitHub(gh, opts = {}) {
+  const issues = await gh.listIssues({ label: SUGGESTION_LABEL, state: opts.state ?? "open", perPage: opts.perPage ?? 50 });
+  const pulls = opts.pulls ?? (issues.length ? await gh.listPullRequests("all").catch(() => []) : []);
+  return issues.map((i) => listItem(i, pulls));
+}
+function listItem(i, pulls) {
+  const linkedPrs = linkedPullsOf(i.number, pulls);
+  const cached = suggestionStateFromLabels(i.labels);
+  const t = i.labels.map((l) => /^tier: ([123])$/.exec(l)?.[1]).find(Boolean);
+  return {
+    number: i.number,
+    title: i.title,
+    url: i.url,
+    author: i.author,
+    createdAt: i.createdAt,
+    state: i.state,
+    stateReason: i.stateReason,
+    labels: i.labels,
+    kind: suggestionKindFromLabels(i.labels),
+    tier: t ? Number(t) : void 0,
+    linkedPrs,
+    status: suggestionStatus({ state: i.state, stateReason: i.stateReason, linkedPrs, applied: cached === "applying", review: cached === "applying" ? void 0 : cached })
+  };
+}
+async function getSuggestionOnGitHub(gh, n, gov, opts = {}) {
+  const [issue, comments, pulls] = await Promise.all([gh.getIssue(n), gh.listIssueComments(n), opts.pulls ? Promise.resolve(opts.pulls) : gh.listPullRequests("all").catch(() => [])]);
+  const parsed = parseSuggestionIssue(issue.body, { comments, author: issue.author || void 0 });
+  const linkedPrs = linkedPullsOf(n, pulls);
+  const applied = comments.flatMap((c) => parseSuggestionAppliedComment(c.body) ?? []);
+  const approvals = parsed.ok ? summarizeSuggestionApprovals(comments, gov, { payloadSha: parsed.sha, author: issue.author }) : void 0;
+  const status = suggestionStatus({
+    state: issue.state,
+    stateReason: issue.stateReason,
+    linkedPrs,
+    applied: parsed.ok && applied.some((a) => a.payloadSha === parsed.sha),
+    outdated: opts.outdated,
+    review: parsed.ok && approvals ? suggestionReviewState(parsed.payload.tier.tier, approvals) : void 0
+  });
+  return { issue, parsed, comments, approvals, linkedPrs, applied, status };
+}
+async function syncSuggestionStateLabel(gh, n, labels, status) {
+  const { add, remove } = suggestionLabelChanges(labels, status);
+  let ok = true;
+  for (const l of remove) {
+    try {
+      await gh.removeLabel(n, l);
+    } catch {
+      ok = false;
+    }
+  }
+  if (add.length) ok = await gh.addLabels(n, add) && ok;
+  return ok ? null : `The status label on #${n} could not be updated; the status shown in Bridge is still right.`;
+}
+async function markSuggestionsAppliedOnGitHub(gh, pr) {
+  const applied = [];
+  const warnings = [];
+  for (const n of closingIssueNumbers(pr.body)) {
+    try {
+      const issue = await gh.getIssue(n);
+      if (!issue.labels.includes(SUGGESTION_LABEL)) continue;
+      const w = await syncSuggestionStateLabel(gh, n, issue.labels, "applied");
+      if (w) warnings.push(w);
+      else applied.push(n);
+    } catch (err) {
+      warnings.push(`Suggestion #${n} could not be marked applied (${err instanceof Error ? err.message : String(err)}).`);
+    }
+  }
+  return { applied, warnings };
+}
+function githubSuggestionWorkspace(gh, ref) {
+  let files;
+  return {
+    read: async (path) => await gh.getFile(path, ref) ?? null,
+    readAt: async (sha, path) => await gh.readFile(path, sha).catch(() => void 0) ?? null,
+    list: () => files ??= gh.listFiles(ref)
+  };
+}
+function suggestionTouches(payload, config, path) {
+  if (path === CONFIG_FILE) return true;
+  if ((payload.files ?? []).some((f) => f.path === path)) return true;
+  if ((payload.docs ?? []).some((d) => d.path === path)) return true;
+  if (payload.componentSpec?.specPath === path) return true;
+  return Boolean(payload.tokens?.edits.length) && selectTokenFiles(config, [path]).length > 0;
+}
+const MAX_COMPARE_FILES = 300;
+async function suggestionStalenessOnGitHub(gh, d, input) {
+  const none = (mainSha2, mainMoved) => ({ mainSha: mainSha2, mainMoved, outdated: false, conflicts: [], plan: null });
+  if (!d.parsed.ok || d.issue.state !== "open") return none(null, false);
+  const payload = d.parsed.payload;
+  const ref = input.ref ?? (payload.base.ref || input.config.repo?.defaultBranch || "main");
+  const mainSha = await gh.getBranchSha(ref).catch(() => void 0) ?? null;
+  if (!mainSha) return none(null, false);
+  if (mainSha === payload.base.sha) return none(mainSha, false);
+  const changed = await gh.compare(payload.base.sha, mainSha).catch(() => null);
+  if (changed && changed.files.length < MAX_COMPARE_FILES && !changed.files.some((f) => suggestionTouches(payload, input.config, f.filename))) return none(mainSha, true);
+  try {
+    const plan = await planSuggestionApply({
+      parsed: d.parsed,
+      config: input.config,
+      comments: d.comments,
+      governance: input.governance,
+      author: d.issue.author || null,
+      // Only whether it still applies: approvals and a hand edit are reported apart.
+      forceUnapproved: true,
+      acceptEdited: true,
+      workspace: githubSuggestionWorkspace(gh, mainSha)
+    });
+    const conflicts = plan.ops.filter((o) => o.state === "conflict");
+    return { mainSha, mainMoved: true, outdated: conflicts.length > 0, conflicts, plan };
+  } catch {
+    return none(mainSha, true);
+  }
+}
+function stalenessStatus(status, staleness) {
+  return withOutdated(status, staleness?.outdated);
+}
+async function reviewSuggestionOnGitHub(gh, n, input, gov) {
+  if (input.event === "request-changes" && !input.message?.trim()) throw new GitHubError(422, "Say what should change, in a sentence or two: the author reads it.");
+  const before = await getSuggestionOnGitHub(gh, n, gov);
   if (!before.parsed.ok) throw new GitHubError(422, `#${n} cannot be reviewed: ${before.parsed.message}`);
   if (before.issue.state === "closed") throw new GitHubError(422, `#${n} is closed. Reopen it on GitHub to review it again.`);
   const sha = before.parsed.sha;
@@ -4283,8 +4666,12 @@ async function linkSuggestionPrOnGitHub(gh, n, link) {
   if (!link.pr && !link.branch && !link.commit) throw new GitHubError(422, "Say where it is applied: a pull request number, a branch or a commit.");
   const issue = await gh.getIssue(n);
   await gh.addComment(n, composeSuggestionAppliedComment({ by: link.by, branch: link.branch, commit: link.commit, pr: link.pr, payloadSha: link.payloadSha, forced: link.forced, at: (link.at ?? /* @__PURE__ */ new Date()).toISOString() }));
-  const warning = await syncSuggestionStateLabel(gh, n, issue.labels, "applying");
-  return { warnings: warning ? [warning] : [] };
+  const status = appliedStatus(issue, link.merged);
+  const warning = await syncSuggestionStateLabel(gh, n, issue.labels, status);
+  return { warnings: warning ? [warning] : [], status };
+}
+function appliedStatus(issue, merged) {
+  return merged || issue.state === "closed" && issue.stateReason === "completed" ? "applied" : "applying";
 }
 async function declineSuggestionOnGitHub(gh, n, reason, by) {
   const issue = await gh.getIssue(n);
@@ -4511,265 +4898,6 @@ async function commitFileOnGitHub(gh, input) {
   if (content === cur.text) return "";
   return gh.putFile({ path: input.path, content, branch: input.branch, message: input.message, sha: cur.sha });
 }
-const SUGGESTION_APPLY_EXIT = {
-  ready: 0,
-  "already-applied": 0,
-  conflict: 3,
-  "not-approved": 1,
-  blocked: 1,
-  refused: 1
-};
-const same = (a, b) => canonicalJson(a) === canonicalJson(b);
-const show = (v) => v === void 0 ? "nothing" : typeof v === "string" ? v : JSON.stringify(v);
-function tokenRoot(config) {
-  const r = config.tokens.root.replace(/\/+$/, "");
-  return r === "." ? "" : r;
-}
-function tokenFileOf(config, path) {
-  const root = tokenRoot(config);
-  if (root && !path.startsWith(`${root}/`)) return null;
-  if (!selectTokenFiles(config, [path]).length) return null;
-  return root ? path.slice(root.length + 1) : path;
-}
-function planTokenEdit(set, e, changes) {
-  const base = { type: "token", path: e.path, edit: e, ...e.file ? { file: e.file } : {} };
-  const defsAt = (path) => set.defs.filter((d) => d.path === path && (!e.file || d.file === e.file));
-  const recorded = (file, path = e.path) => changes.find((c) => c.path === path && c.file === file && (e.op === "rename" ? c.kind === "renamed" : true));
-  const conflict = (detail, extra = {}) => ({ op: { ...base, state: "conflict", detail, ...extra }, notes: [] });
-  const done = (detail) => ({ op: { ...base, state: "already-applied", detail }, notes: [] });
-  let result;
-  try {
-    result = applyTokenEdits(set, [e]);
-  } catch (err) {
-    const why = err instanceof Error ? err.message : String(err);
-    switch (e.op) {
-      case "rename": {
-        const hasOld = defsAt(e.path).length > 0;
-        const hasNew = set.defs.some((d) => d.path === e.newPath);
-        if (!hasOld && hasNew) return done(`Already renamed to ${e.newPath}.`);
-        return conflict(hasOld && hasNew ? `Both ${e.path} and ${e.newPath} exist now: rename it by hand.` : `${e.path} no longer exists: ${why}`);
-      }
-      case "remove":
-        if (!defsAt(e.path).length) return done("Already removed.");
-        return conflict(why);
-      case "add": {
-        const existing = defsAt(e.path);
-        if (!existing.length) return conflict(why);
-        const want = (file) => {
-          const c = recorded(file);
-          if (c && c.after !== void 0) return c.after;
-          return coerceValue(e.value, e.type ?? existing.find((d2) => d2.file === file)?.type);
-        };
-        const all = existing.every((d2) => same(d2.value, want(d2.file)));
-        if (all) return done("Already added with the suggested value.");
-        const d = existing.find((x) => !same(x.value, want(x.file)));
-        return conflict(`Someone added ${e.path} with another value since.`, { file: d.file, after: want(d.file), now: d.value });
-      }
-      default:
-        return conflict(defsAt(e.path).length ? why : `${e.path} no longer exists, so its value cannot be set.`);
-    }
-  }
-  if (!result.touched.length) return done("Already has the suggested value.");
-  if (e.op === "set" || e.op === "remove" || e.op === "rename") {
-    for (const d of defsAt(e.path)) {
-      const c = recorded(d.file, e.op === "rename" ? e.newPath ?? e.path : e.path);
-      if (!c) continue;
-      const okNow = same(d.value, c.before) || e.op === "set" && same(d.value, c.after);
-      if (!okNow) return conflict(`${e.path} changed since it was suggested (now ${show(d.value)}, suggested from ${show(c.before)}).`, { file: d.file, before: c.before, after: c.after, now: d.value });
-    }
-  }
-  const verb = e.op === "set" ? "Set" : e.op === "add" ? "Add" : e.op === "remove" ? "Remove" : `Rename to ${e.newPath ?? ""}`;
-  return { op: { ...base, state: "apply", detail: `${verb} in ${result.touched.join(", ")}.` }, files: result.files, notes: result.notes };
-}
-async function planFile(ws, baseSha, f) {
-  const base = { type: "file", path: f.path };
-  const cur = await ws.read(f.path);
-  const curSha = cur?.sha ?? null;
-  const theirs = f.afterSha === null ? null : f.content ?? null;
-  if (curSha === f.afterSha) return { op: { ...base, state: "already-applied", detail: f.afterSha === null ? "Already deleted." : "Already has the suggested content." } };
-  if (curSha === f.beforeSha) return { op: { ...base, state: "apply", detail: f.afterSha === null ? "Delete it." : f.beforeSha === null ? "Create it." : "Replace it with the suggested content." }, content: theirs };
-  if (f.beforeSha === null) return { op: { ...base, state: "conflict", detail: "The suggestion creates this file, but a different one exists now." } };
-  if (!cur) return { op: { ...base, state: "conflict", detail: "The suggestion changes this file, but it was deleted since." } };
-  if (theirs === null) return { op: { ...base, state: "conflict", detail: "The suggestion deletes this file, but it changed since." } };
-  const original = await ws.readAt(baseSha, f.path);
-  if (original === null || gitBlobSha(original) !== f.beforeSha || !ws.merge) {
-    return { op: { ...base, state: "conflict", detail: original === null ? "The file changed since and its version at the suggestion base cannot be read, so it cannot be merged." : "The file changed since and cannot be merged here." } };
-  }
-  const merged = await ws.merge({ path: f.path, ours: cur.text, base: original, theirs });
-  if (!merged.clean) return { op: { ...base, state: "conflict", detail: `The file changed since and the merge has ${merged.conflicts} conflict(s).`, hunks: merged.conflicts } };
-  if (merged.text === cur.text) return { op: { ...base, state: "already-applied", detail: "Already has the suggested lines." } };
-  return { op: { ...base, state: "apply-merged", detail: "The file changed since: merged with the suggested lines, no conflict." }, content: merged.text };
-}
-async function planSuggestionApply(input) {
-  const { parsed, config, workspace: ws } = input;
-  const payload = parsed.payload;
-  const notes = [];
-  const out = (outcome, message, rest2 = {}) => ({
-    outcome,
-    exitCode: SUGGESTION_APPLY_EXIT[outcome],
-    message,
-    payloadSha: parsed.sha,
-    payload,
-    gate: null,
-    ops: [],
-    writes: [],
-    checks: null,
-    problems: [],
-    notes,
-    ...payload.componentSpec ? { brief: payload.componentSpec.brief } : {},
-    ...rest2
-  });
-  const problems = suggestionPathProblems(payload, config);
-  if (payload.checks.blocked) problems.push(`It was suggested with a failing check (${payload.checks.blocked}): ask the author to fix it and send it again.`);
-  for (const f of payload.files ?? []) {
-    if (f.afterSha !== null && typeof f.content !== "string") problems.push(`"${f.path}" has no content in the suggestion: it is incomplete, ask the author to send it again.`);
-    else if (f.afterSha !== null && gitBlobSha(f.content) !== f.afterSha) problems.push(`"${f.path}" does not match the content it was suggested with: someone edited it by hand.`);
-  }
-  if (problems.length) return out("refused", "Not applied: the suggestion asks for something Bridge never writes.", { problems: [...new Set(problems)] });
-  if (parsed.edited && !input.acceptEdited) {
-    return out("refused", 'Not applied: the suggestion was edited by hand since Bridge wrote it. Read the change, then apply it with "accept edited" if it is right.', {
-      problems: ["The payload no longer matches the sha Bridge recorded."]
-    });
-  }
-  const root = tokenRoot(config);
-  const tokenFiles = selectTokenFiles(config, await ws.list());
-  const targets = [
-    ...(payload.files ?? []).map((f) => f.path),
-    ...(payload.docs ?? []).map((d) => d.path),
-    ...payload.componentSpec ? [payload.componentSpec.specPath] : [],
-    ...payload.tokens?.edits.length ? tokenFiles.map((f) => root ? `${root}/${f}` : f) : []
-  ];
-  if (ws.isSymlink) {
-    const links = [];
-    for (const p of new Set(targets)) if (await ws.isSymlink(p)) links.push(`"${p}" is a symbolic link (or inside one): Bridge never writes through links.`);
-    if (links.length) return out("refused", "Not applied: the suggestion writes through a symbolic link.", { problems: links });
-  }
-  const governance = input.governance ?? { owners: config.governance.owners, rights: config.governance.rights ?? null, soloOwnerCanApproveBoth: config.governance.soloOwnerCanApproveBoth };
-  const approvals = summarizeSuggestionApprovals(input.comments, governance, { payloadSha: parsed.sha, author: input.author });
-  const review = suggestionReviewState(payload.tier.tier, approvals);
-  const missing = pendingApprovals(payload.tier.tier, approvals);
-  const approved = review === "approved";
-  const gate = { review, missing, approvals, forced: !approved && Boolean(input.forceUnapproved), edited: parsed.edited };
-  const ops = [];
-  const writes = /* @__PURE__ */ new Map();
-  const current = /* @__PURE__ */ new Map();
-  for (const f of tokenFiles) {
-    const r = await ws.read(root ? `${root}/${f}` : f);
-    if (r) current.set(f, r.text);
-  }
-  const before = new LayeredTokenSet(config, current);
-  let set = before;
-  for (const e of payload.tokens?.edits ?? []) {
-    const r = planTokenEdit(set, e, payload.tokens.changes);
-    ops.push(r.op);
-    notes.push(...r.notes);
-    if (r.op.state === "apply" && r.files) {
-      set = new LayeredTokenSet(config, r.files);
-    }
-  }
-  for (const [f, text] of set.files) if (text !== before.files.get(f)) writes.set(set.repoPath(f), text);
-  for (const f of payload.files ?? []) {
-    if (writes.has(f.path)) {
-      notes.push(`${f.path}: the token edits write this file, its copy in the suggestion is not used.`);
-      continue;
-    }
-    const r = await planFile(ws, payload.base.sha, f);
-    ops.push(r.op);
-    if (r.op.state === "apply" || r.op.state === "apply-merged") writes.set(f.path, r.content ?? null);
-  }
-  for (const d of payload.docs ?? []) {
-    const base = { type: "docs", path: d.path };
-    const docs = d.after;
-    let text;
-    try {
-      const issues = validateDocs(docs);
-      if (issues.length) {
-        problems.push(`${d.path}: ${issues.map((i) => i.message).join(" ")}`);
-        continue;
-      }
-      const cur = await ws.read(d.path);
-      text = docsFileText(docs, cur?.text ?? null);
-      if (cur && text === cur.text) {
-        ops.push({ ...base, state: "already-applied", detail: "The docs already say this." });
-        continue;
-      }
-      ops.push({ ...base, state: "apply", detail: cur ? "Update the changed fields; other fields stay as they are now." : "Create the docs file." });
-      writes.set(d.path, text);
-    } catch (err) {
-      problems.push(`${d.path}: the suggested docs are not a docs.json Bridge can read (${err instanceof Error ? err.message : String(err)}).`);
-    }
-  }
-  if (payload.componentSpec) {
-    const s = payload.componentSpec;
-    const text = `${JSON.stringify(s.spec, null, 2)}
-`;
-    const cur = await ws.read(s.specPath);
-    if (cur && cur.text === text) ops.push({ type: "component-spec", path: s.specPath, state: "already-applied", detail: "The spec file is already there." });
-    else {
-      ops.push({ type: "component-spec", path: s.specPath, state: "apply", detail: `Write the spec; the ${s.component} code itself is written from the brief.` });
-      writes.set(s.specPath, text);
-    }
-  }
-  const afterFiles = new Map(set.files);
-  for (const [p, content] of writes) {
-    const tf = tokenFileOf(config, p);
-    if (!tf) continue;
-    if (content === null) afterFiles.delete(tf);
-    else afterFiles.set(tf, content);
-  }
-  const after = new LayeredTokenSet(config, afterFiles);
-  const tokenChanges = diffLayered(before, after);
-  const issueKey2 = (i) => `${i.code}|${i.path ?? ""}|${i.file ?? ""}|${i.message}`;
-  const prevErrors = new Set(validateLayered(before).map(issueKey2));
-  const newErrors = tokenChanges.length ? validateLayered(after).filter((i) => i.level === "error" && !prevErrors.has(issueKey2(i))) : [];
-  let pairs = [];
-  if (config.contrast && tokenChanges.length) {
-    try {
-      pairs = parseContrastChecks((await ws.read(config.contrast.path))?.text);
-    } catch {
-      notes.push(`${config.contrast.path} does not parse: contrast was not checked.`);
-    }
-  }
-  const modes = config.contrast?.modes;
-  const contrast = pairs.length ? contrastDelta(runLayeredContrast(before, pairs, modes), runLayeredContrast(after, pairs, modes)) : [];
-  const newFailures = contrast.filter((d) => d.passBefore && !d.passAfter);
-  const otherFiles = [...writes.keys()].filter((p) => !tokenFileOf(config, p));
-  const tier = classifyRisk({ tokenChanges: tokenChanges.map((c) => ({ kind: c.kind, path: c.path, ...c.kind === "changed" ? { descriptionOnly: c.fields.length > 0 && c.fields.every((x) => x === "description") } : {} })), files: otherFiles.map((path) => ({ path })), config });
-  const tierIncreased = writes.size > 0 && tier.tier > payload.tier.tier;
-  const checks = { tierWhenSuggested: payload.tier.tier, tier, tierIncreased, newErrors, newFailures, contrast, tokenChanges };
-  const rest = { gate, ops, checks, problems };
-  if (problems.length) return out("refused", "Not applied: part of the suggestion is not valid.", rest);
-  const conflicts = ops.filter((o) => o.state === "conflict");
-  if (conflicts.length) {
-    return out("conflict", `Not applied: ${conflicts.length} change(s) conflict with the code now. Ask the author to refresh the suggestion on today's code, or apply those parts by hand.`, rest);
-  }
-  if (!writes.size) return out("already-applied", "Already applied: the code has every change of this suggestion.", rest);
-  if (newErrors.length || newFailures.length) {
-    const why = [newErrors.length ? `${newErrors.length} new validation error(s)` : "", newFailures.length ? `${newFailures.length} contrast pair(s) would fail` : ""].filter(Boolean).join(" and ");
-    return out("blocked", `Not applied: on today's code it would add ${why}. Ask the author to refresh the suggestion.`, rest);
-  }
-  if (tierIncreased && !input.forceUnapproved) {
-    return out("blocked", `Not applied: on today's code it is a tier ${tier.tier} change, it was approved as tier ${payload.tier.tier}. It needs a new approval.`, rest);
-  }
-  if (!approved && !input.forceUnapproved) {
-    const who = review === "changes-requested" ? `changes requested by ${approvals.changesRequested.map((l) => `@${l}`).join(", ")}` : `missing ${missing.map((m) => m === "approval" ? "an approval" : `${m} approval`).join(" and ")}`;
-    return out("not-approved", `Not applied: it is not approved yet (${who}). Ask the owners to review it on the issue.`, rest);
-  }
-  const forced = gate.forced || tierIncreased && Boolean(input.forceUnapproved);
-  return out("ready", `Ready: ${writes.size} file(s) to write${forced ? ", without every approval" : ""}.`, {
-    ...rest,
-    gate: { ...gate, forced },
-    writes: [...writes].map(([path, content]) => ({ path, content })).sort((a, b) => a.path.localeCompare(b.path))
-  });
-}
-function suggestionAppliedComment(plan, where2) {
-  return composeSuggestionAppliedComment({ ...where2, payloadSha: plan.payloadSha, ...plan.gate?.forced ? { forced: true } : {} });
-}
-function suggestionApplyTable(plan) {
-  const label = { "already-applied": "already applied", apply: "apply", "apply-merged": "apply (merged)", conflict: "**conflict**" };
-  const cell2 = (s) => s.replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
-  return ["| Change | Result | Detail |", "| --- | --- | --- |", ...plan.ops.map((o) => `| \`${cell2(o.path)}\` | ${label[o.state]} | ${cell2(o.detail)} |`)].join("\n");
-}
 function normalizeRepoPath(path) {
   return path.replace(/\\/g, "/").split("/").filter((s) => s && s !== ".").join("/");
 }
@@ -4845,7 +4973,7 @@ export {
   branchWithJiraKey as Z,
   titleWithJiraKey as _,
   parseChangelog as a,
-  assignVersions as a$,
+  allowedMergeMethods as a$,
   formatFigmaSpec as a0,
   figmaDraftBrief as a1,
   parseFigmaOrigin as a2,
@@ -4856,33 +4984,33 @@ export {
   withFigmaOrigin as a7,
   WAITING_FOR_CLAUDE_LABEL as a8,
   DRAFTED_BY_CLAUDE_LABEL as a9,
-  GitHubClient as aA,
-  PULL_STATE_PILL as aB,
-  ProtectedBranchError as aC,
-  REDUCED_MOTION_NOTE as aD,
-  REQUEST_STATUS_LABEL as aE,
-  REVIEW_STATUS_ORDER as aF,
-  SPEC_FIELDS as aG,
-  SUGGESTION_APPLIED_MARK as aH,
-  SUGGESTION_APPLY_EXIT as aI,
-  SUGGESTION_KINDS as aJ,
-  SUGGESTION_LABEL as aK,
-  SUGGESTION_LIMITS as aL,
-  SUGGESTION_REVIEW_MARK as aM,
-  SUGGESTION_STATE_LABELS as aN,
-  SUGGESTION_STATUS_LABEL as aO,
-  SUGGESTION_TOO_LARGE as aP,
-  SuggestionError as aQ,
-  TOKEN_REJECTED_MESSAGE as aR,
-  TOKEN_SETTINGS_URL as aS,
-  TRIGGER_LABELS as aT,
-  UNRELEASED as aU,
-  acceptDocsDraft as aV,
-  acceptDocsText as aW,
-  allowedMergeMethods as aX,
-  anatomyLabel as aY,
-  assertSafeBranch as aZ,
-  assignRequestOnGitHub as a_,
+  EXPLORATION_USE_CASES as aA,
+  GitHubClient as aB,
+  PULL_STATE_PILL as aC,
+  ProtectedBranchError as aD,
+  REDUCED_MOTION_NOTE as aE,
+  REQUEST_STATUS_LABEL as aF,
+  REVIEW_STATUS_LABEL as aG,
+  REVIEW_STATUS_ORDER as aH,
+  SPEC_FIELDS as aI,
+  SUGGESTION_APPLIED_MARK as aJ,
+  SUGGESTION_APPLY_EXIT as aK,
+  SUGGESTION_FINAL_LABELS as aL,
+  SUGGESTION_KINDS as aM,
+  SUGGESTION_LABEL as aN,
+  SUGGESTION_LIMITS as aO,
+  SUGGESTION_REVIEW_MARK as aP,
+  SUGGESTION_STATE_LABELS as aQ,
+  SUGGESTION_STATUS_LABEL as aR,
+  SUGGESTION_STATUS_LABELS as aS,
+  SUGGESTION_TOO_LARGE as aT,
+  SuggestionError as aU,
+  TOKEN_REJECTED_MESSAGE as aV,
+  TOKEN_SETTINGS_URL as aW,
+  TRIGGER_LABELS as aX,
+  UNRELEASED as aY,
+  acceptDocsDraft as aZ,
+  acceptDocsText as a_,
   planComponentPush as aa,
   figmaOriginSection as ab,
   figmaBranchTitle as ac,
@@ -4896,179 +5024,193 @@ export {
   normalizeRepoPath as ak,
   isUnder as al,
   BULK_LIMIT as am,
-  COLOR_FIELDS as an,
-  COMPONENT_SPECS_VERSION as ao,
-  CONFLICT_REASON as ap,
-  DEFAULT_COMPONENT_SPECS_FILE as aq,
-  DEFAULT_PROTECTED_BRANCHES as ar,
-  DOCS_CHANGE_BUMP as as,
-  DOCS_EDITOR_ORIGIN as at,
-  DOCS_KEYS as au,
-  DOCS_MCP_ORIGIN as av,
-  EXPLORATION_CHECK as aw,
-  EXPLORATION_STATUS_LABEL as ax,
-  EXPLORATION_TIER_LABEL as ay,
-  EXPLORATION_USE_CASES as az,
+  CI_STATE_LABEL as an,
+  COLOR_FIELDS as ao,
+  COMPONENT_SPECS_VERSION as ap,
+  CONFLICT_REASON as aq,
+  DEFAULT_COMPONENT_SPECS_FILE as ar,
+  DEFAULT_PROTECTED_BRANCHES as as,
+  DOCS_CHANGE_BUMP as at,
+  DOCS_EDITOR_ORIGIN as au,
+  DOCS_KEYS as av,
+  DOCS_MCP_ORIGIN as aw,
+  EXPLORATION_CHECK as ax,
+  EXPLORATION_STATUS_LABEL as ay,
+  EXPLORATION_TIER_LABEL as az,
   buildReport as b,
-  isMissingPermission as b$,
-  base64ToUtf8 as b0,
-  bridgeMcpInstallCommand as b1,
-  canOverride as b2,
-  canonicalJson as b3,
-  changeTable as b4,
-  changesetBump as b5,
-  classifyAuth as b6,
-  cleanDocs as b7,
-  clearSharedEtags as b8,
-  closingIssueNumbers as b9,
-  draftPushDescription as bA,
-  draftRequestText as bB,
-  effectiveTier as bC,
-  eligibleReviewers as bD,
-  explorationBranch as bE,
-  explorationRules as bF,
-  explorationShareMessage as bG,
-  explorationSlugFromBranch as bH,
-  figmaCell as bI,
-  fileModes as bJ,
-  filterHistory as bK,
-  findOpenDocsProposal as bL,
-  findOpenDocsProposalOnGitHub as bM,
-  firstParagraph as bN,
-  formatDocsJson as bO,
-  friendlyMessage as bP,
-  getSuggestionOnGitHub as bQ,
-  hasSuggestionBlock as bR,
-  hasWriteAccess as bS,
-  hashSpec as bT,
-  iconComponentName as bU,
-  installationFor as bV,
-  isActiveExploration as bW,
-  isAutomationPull as bX,
-  isDocsProposalBranch as bY,
-  isGuardrailPath as bZ,
-  isJiraKey as b_,
-  commitFileOnGitHub as ba,
-  componentContrastPairs as bb,
-  componentMotion as bc,
-  componentsUsingMotionToken as bd,
-  composeChangeset as be,
-  composeSuggestionAppliedComment as bf,
-  composeSuggestionIssue as bg,
-  composeSuggestionReviewComment as bh,
-  continueDocsProposalOnGitHub as bi,
-  contrastDeltaTable as bj,
-  countChanges as bk,
-  coverageSummary as bl,
-  cssModuleClasses as bm,
-  declineComment as bn,
-  declineReasonProblems as bo,
-  declineRequestOnGitHub as bp,
-  declineSuggestionOnGitHub as bq,
-  defaultDocsFooter as br,
-  docsAuthorLine as bs,
-  docsFileText as bt,
-  docsProposal as bu,
-  docsSectionShapes as bv,
-  docsSlug as bw,
-  docsSuggestionPayload as bx,
-  docsText as by,
-  draftChangeLine as bz,
+  installationFor as b$,
+  anatomyLabel as b0,
+  appliedStatus as b1,
+  assertSafeBranch as b2,
+  assignRequestOnGitHub as b3,
+  assignVersions as b4,
+  base64ToUtf8 as b5,
+  bridgeMcpInstallCommand as b6,
+  canOverride as b7,
+  canonicalJson as b8,
+  changeTable as b9,
+  docsSectionShapes as bA,
+  docsSlug as bB,
+  docsSuggestionPayload as bC,
+  docsText as bD,
+  draftChangeLine as bE,
+  draftPushDescription as bF,
+  draftRequestText as bG,
+  effectiveTier as bH,
+  eligibleReviewers as bI,
+  explorationBranch as bJ,
+  explorationRules as bK,
+  explorationShareMessage as bL,
+  explorationSlugFromBranch as bM,
+  figmaCell as bN,
+  fileModes as bO,
+  filterHistory as bP,
+  findOpenDocsProposal as bQ,
+  findOpenDocsProposalOnGitHub as bR,
+  firstParagraph as bS,
+  formatDocsJson as bT,
+  friendlyMessage as bU,
+  getSuggestionOnGitHub as bV,
+  githubSuggestionWorkspace as bW,
+  hasSuggestionBlock as bX,
+  hasWriteAccess as bY,
+  hashSpec as bZ,
+  iconComponentName as b_,
+  changesetBump as ba,
+  classifyAuth as bb,
+  cleanDocs as bc,
+  clearSharedEtags as bd,
+  closingIssueNumbers as be,
+  commitFileOnGitHub as bf,
+  componentContrastPairs as bg,
+  componentMotion as bh,
+  componentsUsingMotionToken as bi,
+  composeChangeset as bj,
+  composeSuggestionAppliedComment as bk,
+  composeSuggestionIssue as bl,
+  composeSuggestionReviewComment as bm,
+  continueDocsProposalOnGitHub as bn,
+  contrastDeltaTable as bo,
+  countChanges as bp,
+  coverageSummary as bq,
+  cssModuleClasses as br,
+  declineComment as bs,
+  declineReasonProblems as bt,
+  declineRequestOnGitHub as bu,
+  declineSuggestionOnGitHub as bv,
+  defaultDocsFooter as bw,
+  docsAuthorLine as bx,
+  docsFileText as by,
+  docsProposal as bz,
   collectHistory as c,
-  suggestionApplyTable as c$,
-  isReleasePull as c0,
-  isTokenRejected as c1,
-  jiraIssueFields as c2,
-  jiraKeyOf as c3,
-  joinRepoPath as c4,
-  linkRequestToExplorationOnGitHub as c5,
-  linkSuggestionPrOnGitHub as c6,
-  linkedPullsOf as c7,
-  listSuggestionsOnGitHub as c8,
-  loadRepoFiles as c9,
-  prNumberFromSubject as cA,
-  prefillDocs as cB,
-  proposeDocsOnGitHub as cC,
-  propsTable as cD,
-  pullState as cE,
-  pushChangeRows as cF,
-  rateLimitMessage as cG,
-  releasePull as cH,
-  reopenEligibility as cI,
-  requestBrief as cJ,
-  requestImagePath as cK,
-  requestIssueTitle as cL,
-  requestStatus as cM,
-  requiredApprovals as cN,
-  requiredPermission as cO,
-  reviewQueue as cP,
-  reviewStatusKind as cQ,
-  reviewSuggestionOnGitHub as cR,
-  reviewersToAsk as cS,
-  sectionsNeedingReview as cT,
-  sha256Hex as cU,
-  shortVariant as cV,
-  shortVariants as cW,
-  specHash as cX,
-  specsUsage as cY,
-  suggestionAllowedRoots as cZ,
-  suggestionAppliedComment as c_,
-  memoryEtagStore as ca,
-  memorySource as cb,
-  mergeGate as cc,
-  missingPermissionMessage as cd,
-  missingProse as ce,
-  modeLabel as cf,
-  needsDocsReview as cg,
-  openPulls as ch,
-  overrideReasonProblem as ci,
-  parseChangesetText as cj,
-  parseJiraKey as ck,
-  parseOverrideComment as cl,
-  parseRepo as cm,
-  parseRequestIssue as cn,
-  parseStructureChange as co,
-  parseSuggestionAppliedComment as cp,
-  parseSuggestionIssue as cq,
-  parseSuggestionReviewComment as cr,
-  parseTier as cs,
-  patchDocsJson as ct,
-  pendingApprovals as cu,
-  permissionLabel as cv,
-  planRestore as cw,
-  planRevert as cx,
-  planSuggestionApply as cy,
-  planToJson as cz,
+  sectionsNeedingReview as c$,
+  isActiveExploration as c0,
+  isAutomationPull as c1,
+  isDocsProposalBranch as c2,
+  isGuardrailPath as c3,
+  isJiraKey as c4,
+  isMissingPermission as c5,
+  isReleasePull as c6,
+  isTokenRejected as c7,
+  jiraIssueFields as c8,
+  jiraKeyOf as c9,
+  parseTier as cA,
+  patchDocsJson as cB,
+  pendingApprovals as cC,
+  permissionLabel as cD,
+  planRestore as cE,
+  planRevert as cF,
+  planSuggestionApply as cG,
+  planToJson as cH,
+  prNumberFromSubject as cI,
+  prefillDocs as cJ,
+  proposeDocsOnGitHub as cK,
+  propsTable as cL,
+  pullState as cM,
+  pushChangeRows as cN,
+  rateLimitMessage as cO,
+  releasePull as cP,
+  reopenEligibility as cQ,
+  requestBrief as cR,
+  requestImagePath as cS,
+  requestIssueTitle as cT,
+  requestStatus as cU,
+  requiredApprovals as cV,
+  requiredPermission as cW,
+  reviewQueue as cX,
+  reviewStatusKind as cY,
+  reviewSuggestionOnGitHub as cZ,
+  reviewersToAsk as c_,
+  joinRepoPath as ca,
+  linkRequestToExplorationOnGitHub as cb,
+  linkSuggestionPrOnGitHub as cc,
+  linkedPullsOf as cd,
+  listSuggestionsOnGitHub as ce,
+  loadRepoFiles as cf,
+  lowerFirstWord as cg,
+  markSuggestionsAppliedOnGitHub as ch,
+  memoryEtagStore as ci,
+  memorySource as cj,
+  mergeGate as ck,
+  missingPermissionMessage as cl,
+  missingProse as cm,
+  modeLabel as cn,
+  needsDocsReview as co,
+  openPulls as cp,
+  overrideReasonProblem as cq,
+  parseChangesetText as cr,
+  parseJiraKey as cs,
+  parseOverrideComment as ct,
+  parseRepo as cu,
+  parseRequestIssue as cv,
+  parseStructureChange as cw,
+  parseSuggestionAppliedComment as cx,
+  parseSuggestionIssue as cy,
+  parseSuggestionReviewComment as cz,
   applyTokenEdits as d,
-  suggestionIssueTitle as d0,
-  suggestionKindFromLabels as d1,
-  suggestionLabels as d2,
-  suggestionPathProblems as d3,
-  suggestionPayloadSha as d4,
-  suggestionReviewState as d5,
-  suggestionShapeProblems as d6,
-  suggestionStateLabel as d7,
-  suggestionSubject as d8,
-  summarizeApprovals as d9,
-  summarizeCi as da,
-  summarizeSuggestionApprovals as db,
-  syncSuggestionStateLabel as dc,
-  titleOf as dd,
-  toChangeSummary as de,
-  tokenCssVar as df,
-  tokenFingerprint as dg,
-  tokenHistory as dh,
-  unsafePathProblem as di,
-  utf8ToBase64 as dj,
-  validateComponentSpec as dk,
-  validateDocs as dl,
-  validateIntegrations as dm,
-  variantName as dn,
-  versionTimeline as dp,
-  webStorageEtagStore as dq,
-  withAuthorLine as dr,
-  withRequestExploration as ds,
-  withoutJiraKey as dt,
+  sha256Hex as d0,
+  shortVariant as d1,
+  shortVariants as d2,
+  specHash as d3,
+  specsUsage as d4,
+  stalenessStatus as d5,
+  subjectTitle as d6,
+  suggestionAllowedRoots as d7,
+  suggestionAppliedComment as d8,
+  suggestionApplyTable as d9,
+  validateIntegrations as dA,
+  variantName as dB,
+  versionTimeline as dC,
+  webStorageEtagStore as dD,
+  withAuthorLine as dE,
+  withOutdated as dF,
+  withRequestExploration as dG,
+  withoutJiraKey as dH,
+  suggestionIssueTitle as da,
+  suggestionKindFromLabels as db,
+  suggestionLabelChanges as dc,
+  suggestionLabels as dd,
+  suggestionPathProblems as de,
+  suggestionPayloadSha as df,
+  suggestionReviewState as dg,
+  suggestionShapeProblems as dh,
+  suggestionStalenessOnGitHub as di,
+  suggestionStateLabel as dj,
+  suggestionSubject as dk,
+  suggestionTouches as dl,
+  summarizeApprovals as dm,
+  summarizeCi as dn,
+  summarizeSuggestionApprovals as dp,
+  syncSuggestionStateLabel as dq,
+  titleOf as dr,
+  toChangeSummary as ds,
+  tokenCssVar as dt,
+  tokenFingerprint as du,
+  tokenHistory as dv,
+  unsafePathProblem as dw,
+  utf8ToBase64 as dx,
+  validateComponentSpec as dy,
+  validateDocs as dz,
   buildHistoryEntry as e,
   coerceValue as f,
   checkLayeredPair as g,
@@ -5092,4 +5234,4 @@ export {
   explorationNote as y,
   explorationNotePath as z
 };
-//# sourceMappingURL=repo-source-73kARDJv.js.map
+//# sourceMappingURL=repo-source-B4jNZhyC.js.map