@bridge-ds/core 0.7.0 → 0.8.0

package/dist/docs-proposal.d.ts

@@ -1,5 +1,5 @@
 import { type ComponentDocsJson } from './docs-draft';
-import type { GitHubClient } from './github-client';
+import type { GitHubClient, PullRequestSummary } from './github-client';
 import { type RiskResult } from './risk';
 /** One component's docs.json, before (null: a new file) and after, at its repo path. */
 export interface DocsFileEdit {
@@ -42,6 +42,68 @@ export interface DocsProposal {
     bump: 'patch';
     labels: string[];
 }
+/** The branch slug of a component's docs: "visually-hidden" for VisuallyHidden or visually-hidden, at most 40 characters. */
+export declare const docsSlug: (nameOrSlug: string) => string;
+/** Section names (as the editor shows them) by who wrote their text in this send. */
+export interface DocsAuthorship {
+    /** Drafted by Claude, kept as Claude wrote it after review. */
+    claude: string[];
+    /** Drafted by Claude, then edited by the person. */
+    edited: string[];
+    /** Written by the person, no Claude draft involved. */
+    written: string[];
+    /** Drafted by Claude, not reviewed yet (they go out marked for review). */
+    pending: string[];
+}
+/**
+ * The author line of a docs proposal: "by a person, no AI" only when no Claude draft is in the text; "drafted by
+ * Claude AI, reviewed and sent by @ana" when the person kept Claude's text as is; "drafted by Claude AI, edited by
+ * @ana" with the edited sections when they changed parts of it.
+ */
+export declare function docsAuthorLine(a: DocsAuthorship, who: string | null | undefined, where?: string): string;
+/** Without an author line from the editor: the docs' own record ("draftedBy": "claude") decides, never "no AI" over it. */
+export declare function defaultDocsFooter(edits: Pick<DocsFileEdit, 'after'>[], origin: DocsOrigin): string;
+/** The body with its author line (the text after the last "---" line) replaced, or added when it has none. */
+export declare function withAuthorLine(body: string, line: string): string;
+/** The open docs proposal of a component: the one a new send continues instead of opening a second one. */
+export interface OpenDocsProposal {
+    number: number;
+    url: string;
+    branch: string;
+    author: string;
+    title: string;
+    updatedAt: string;
+}
+/**
+ * True when `branch` is a docs proposal branch of this component: docs/<slug>-<yyyymmdd>-<id>, with an optional Jira
+ * key before the slug (docs/DS-42-button-...). "button" does not match docs/button-group-... branches. Older MCP
+ * branches used the lowercased name (docs/visuallyhidden-...): they match too.
+ */
+export declare function isDocsProposalBranch(branch: string, component: {
+    name: string;
+    slug?: string | undefined;
+}): boolean;
+type PullLike = Pick<PullRequestSummary, 'number' | 'state' | 'headRef' | 'author' | 'title' | 'url' | 'updatedAt'> & {
+    baseRef?: string | undefined;
+};
+/** The most recently updated open docs proposal of the component (into `base` when given), or null. */
+export declare function findOpenDocsProposal(pulls: PullLike[], component: {
+    name: string;
+    slug?: string | undefined;
+}, base?: string): OpenDocsProposal | null;
+/** Reads the open pull requests and returns the component's open docs proposal, or null. */
+export declare function findOpenDocsProposalOnGitHub(gh: GitHubClient, component: {
+    name: string;
+    slug?: string | undefined;
+}, base?: string): Promise<OpenDocsProposal | null>;
+/**
+ * Adds a send to the open proposal: one commit with the docs.json on its branch (nothing when the text is the same),
+ * and the author line of its description brought up to date. Returns the commit sha, or '' when nothing changed.
+ */
+export declare function continueDocsProposalOnGitHub(gh: GitHubClient, open: Pick<OpenDocsProposal, 'number' | 'branch'>, edit: Pick<DocsFileEdit, 'path' | 'component' | 'after'>, opts?: {
+    authorLine?: string | undefined;
+    message?: string | undefined;
+}): Promise<string>;
 /** One pull request for the docs edits of a draft: branch, title, body, files with a patch changeset, the tier. */
 export declare function docsProposal(edits: DocsFileEdit[], opts: {
     title?: string | undefined;
@@ -50,10 +112,13 @@ export declare function docsProposal(edits: DocsFileEdit[], opts: {
     packageName?: string | undefined;
     changesetDir?: string | undefined;
     origin?: DocsOrigin | undefined;
+    authorLine?: string | undefined;
 }): DocsProposal;
 /**
  * Opens one pull request with the docs edits from the default branch, the Jira key first in the title and the branch
  * name (Jira's GitHub integration links them). Returns its number, link and branch. Labels are best effort.
+ * One open proposal per component: when the component already has one, the edit goes there as a new commit
+ * (`continued`; `unchanged` when it already says this) instead of a second pull request.
  */
 export declare function proposeDocsOnGitHub(gh: GitHubClient, edits: DocsFileEdit[], opts: {
     base: string;
@@ -64,11 +129,17 @@ export declare function proposeDocsOnGitHub(gh: GitHubClient, edits: DocsFileEdi
     origin?: DocsOrigin | undefined;
     extraLabels?: string[] | undefined;
     commitNote?: string | undefined;
+    /** Who wrote the text (docsAuthorLine). Without it, the origin's footer, never "no AI" over a Claude draft. */
+    authorLine?: string | undefined;
+    /** Default true: continue the component's open proposal. False always opens a new one. */
+    continueOpen?: boolean | undefined;
 }): Promise<{
     number: number;
     url: string;
     branch: string;
     title: string;
+    continued: boolean;
+    unchanged: boolean;
 }>;
 /**
  * Rewrites one file on an open branch in one commit (`next` gets the current text). Returns the commit sha, or ''
@@ -80,3 +151,4 @@ export declare function commitFileOnGitHub(gh: GitHubClient, input: {
     message: string;
     next: (text: string) => string;
 }): Promise<string>;
+export {};

package/dist/explorations-github.d.ts

@@ -14,6 +14,8 @@ export interface ExplorationSettings {
         number: number;
         title: string;
     }[] | undefined;
+    /** More labels for the draft pull request, such as the product ones (productMarks). */
+    labels?: string[] | undefined;
 }
 export interface ExplorationSummary {
     number: number;

package/dist/index.js

@@ -1,5 +1,5 @@
-import { u as modeDisplayName, w as modesOf$1, x as isMultiMode, T as TIER_NAMES, y as TIER_AXIS, z as findReferenceProblems, A as evaluatePairs, B as contrastScope, D as contextLabel, S as SINGLE_MODE, E as pathId, F as flattenTokens, G as serializeTokenFile, H as removeToken, I as upsertToken, J as threeWayDiff, K as emptyTokenFile, L as parseTokenFile, M as EXT_ID, N as EXT_SCOPES, n as resolve, O as moveToken, P as effectiveScopes, Q as sameScopes, R as defaultScopes, U as readTokenAt, V as modeFile, W as defaultFile, X as DEFAULT_PROTECTED_BRANCHES, a as assertSafeBranch, Y as ProtectedBranchError, C as CONFIG_FILE, l as loadConfig, Z as ConfigError, _ as DEFAULT_TOKEN_PATHS, c as collectHistory, p as packageDirCandidates, b as parseChangelog, r as releasesFromTags, m as mergeReleases, d as buildReport, $ as applyTokenEdits, a0 as buildHistoryEntry, a1 as resolveBranchPreviews, a2 as tokensPath, a3 as coerceValue, a4 as toConfigJson, a5 as parseContrastChecks, a6 as checkLayeredPair, a7 as classifyRisk, a8 as formatChangeset, a9 as RISK_LABELS, aa as parseJson, ab as serializeJson, ac as plainEqual, ad as toPlain, ae as getEntry, af as fromPlain, ag as previewLinks, ah as slugify, ai as readPreviewComment, aj as findPreviewComment, ak as previewsSettled, f as variantKeyOf, al as canShip, am as whoCanShipSentence, an as unreadableShipTeams, g as layoutOptions, j as buildTokenSet } from "./component-spec-1z2ih4E3.js";
-import { ao, ap, aq, q, o, ar, as, at, au, av, aw, ax, ay, az, aA, aB, aC, aD, aE, aF, aG, aH, aI, aJ, aK, aL, aM, aN, aO, aP, aQ, aR, aS, aT, aU, aV, aW, aX, aY, aZ, a_, a$, b0, b1, b2, b3, b4, b5, b6, b7, b8, b9, ba, bb, bc, bd, be, bf, bg, bh, k, bi, bj, bk, bl, bm, bn, bo, bp, bq, br, bs, bt, bu, bv, bw, bx, by, bz, bA, bB, bC, h, bD, i, bE, bF, bG, bH, bI, bJ, bK, bL, bM, bN, bO, bP, bQ, bR, bS, bT, bU, bV, bW, bX, bY, bZ, b_, b$, e, c0, c1, c2, c3, c4, c5, c6, c7, c8, c9, ca, cb, cc, cd, ce, cf, cg, s, ch, ci, cj, ck, cl, cm, cn, co, cp, cq, cr, t, cs, ct, cu, v, cv, cw, cx, cy } from "./component-spec-1z2ih4E3.js";
+import { u as modeDisplayName, w as modesOf$1, x as isMultiMode, T as TIER_NAMES, y as TIER_AXIS, z as findReferenceProblems, A as evaluatePairs, B as contrastScope, D as contextLabel, S as SINGLE_MODE, E as pathId, F as flattenTokens, G as serializeTokenFile, H as removeToken, I as upsertToken, J as threeWayDiff, K as emptyTokenFile, L as parseTokenFile, M as EXT_ID, N as EXT_SCOPES, n as resolve, O as moveToken, P as effectiveScopes, Q as sameScopes, R as defaultScopes, U as readTokenAt, V as modeFile, W as defaultFile, X as DEFAULT_PROTECTED_BRANCHES, a as assertSafeBranch, Y as ProtectedBranchError, C as CONFIG_FILE, l as loadConfig, Z as ConfigError, _ as DEFAULT_TOKEN_PATHS, c as collectHistory, p as packageDirCandidates, b as parseChangelog, r as releasesFromTags, m as mergeReleases, d as buildReport, $ as applyTokenEdits, a0 as buildHistoryEntry, a1 as resolveBranchPreviews, a2 as tokensPath, a3 as coerceValue, a4 as toConfigJson, a5 as parseContrastChecks, a6 as checkLayeredPair, a7 as classifyRisk, a8 as formatChangeset, a9 as RISK_LABELS, aa as parseJson, ab as serializeJson, ac as plainEqual, ad as toPlain, ae as getEntry, af as fromPlain, ag as previewLinks, ah as slugify, ai as readPreviewComment, aj as findPreviewComment, ak as previewsSettled, f as variantKeyOf, al as canShip, am as whoCanShipSentence, an as unreadableShipTeams, g as layoutOptions, j as buildTokenSet } from "./component-spec-SKuywZqr.js";
+import { ao, ap, aq, q, o, ar, as, at, au, av, aw, ax, ay, az, aA, aB, aC, aD, aE, aF, aG, aH, aI, aJ, aK, aL, aM, aN, aO, aP, aQ, aR, aS, aT, aU, aV, aW, aX, aY, aZ, a_, a$, b0, b1, b2, b3, b4, b5, b6, b7, b8, b9, ba, bb, bc, bd, be, bf, bg, bh, k, bi, bj, bk, bl, bm, bn, bo, bp, bq, br, bs, bt, bu, bv, bw, bx, by, bz, bA, bB, bC, h, bD, i, bE, bF, bG, bH, bI, bJ, bK, bL, bM, bN, bO, bP, bQ, bR, bS, bT, bU, bV, bW, bX, bY, bZ, b_, b$, e, c0, c1, c2, c3, c4, c5, c6, c7, c8, c9, ca, cb, cc, cd, ce, cf, cg, ch, s, ci, cj, ck, cl, cm, cn, co, cp, cq, cr, cs, t, ct, cu, cv, v, cw, cx, cy, cz } from "./component-spec-SKuywZqr.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, h as h2, o as o2, q as q2, r, t as t2, u } from "./layered-BnbmToGs.js";
 const issueKey = (i2) => `${i2.code}|${i2.path ?? ""}|${i2.mode ?? ""}|${i2.code === "file-problem" ? i2.message : ""}`;
@@ -3788,7 +3788,7 @@ Exploration: never merged as is. Promote it to review or close it.`,
   const ctx = { owner: gh.owner, repo: gh.name, packages: s2.packages, apps: s2.apps, ...s2.requests?.length ? { requests: s2.requests } : {} };
   const title = full.jira ? `${full.jira.trim().toUpperCase()} ${explorationPrTitle(full)}` : explorationPrTitle(full);
   const pr = await x.createPullRequest({ title, head: branch, base: s2.base, body: explorationPrBody(full, ctx), draft: true });
-  await x.addLabels(pr.number, [EXPLORATION_LABEL]);
+  await x.addLabels(pr.number, [EXPLORATION_LABEL, ...s2.labels ?? []]);
   await x.updatePullRequest(pr.number, { body: explorationPrBody(full, { ...ctx, pr: pr.number }) }).catch(() => void 0);
   return {
     branch,
@@ -4617,7 +4617,7 @@ function branchWithJiraKey(branch, key) {
 }
 const DOCS_EDITOR_ORIGIN = {
   where: "in the Bridge docs editor",
-  footer: 'Proposed with the Bridge docs editor by a person (no AI involved in this text unless the docs say "draftedBy").',
+  footer: "Written by a person in the Bridge docs editor. No AI involved in this text.",
   label: "source: bridge-web"
 };
 const DOCS_MCP_ORIGIN = {
@@ -4654,13 +4654,69 @@ function cleanDocs(d2) {
 const docsText = (d2) => formatDocsJson(cleanDocs(d2));
 const docsFileText = (d2, original) => patchDocsJson(original, cleanDocs(d2));
 const slugDate = (d2) => d2.toISOString().slice(0, 10).replace(/-/g, "");
+const docsSlug = (nameOrSlug) => nameOrSlug.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase().replace(/[^a-z0-9-]+/g, "-").slice(0, 40);
+const listOf = (xs) => xs.length < 2 ? xs[0] ?? "" : `${xs.slice(0, -1).join(", ")} and ${xs[xs.length - 1]}`;
+function docsAuthorLine(a, who, where = "the Bridge docs editor") {
+  const w = who?.trim() ? `@${who.trim().replace(/^@/, "")}` : "a person";
+  if (!a.claude.length && !a.edited.length && !a.pending.length) return `Written by ${w} in ${where}. No AI involved in this text.`;
+  const head = a.edited.length ? `Drafted by Claude AI, edited by ${w} in ${where}.` : a.claude.length ? `Drafted by Claude AI, reviewed and sent by ${w} in ${where}.` : `Drafted by Claude AI, sent by ${w} in ${where} before review.`;
+  const mixed = [a.edited, a.written, a.pending].some((x) => x.length);
+  return [
+    head,
+    a.edited.length ? `Edited by ${w}: ${listOf(a.edited)}.` : "",
+    a.claude.length && mixed ? `As Claude drafted them: ${listOf(a.claude)}.` : "",
+    a.written.length ? `Written by ${w}: ${listOf(a.written)}.` : "",
+    a.pending.length && (a.claude.length || a.edited.length || a.written.length) ? `Not reviewed yet: ${listOf(a.pending)}.` : ""
+  ].filter(Boolean).join(" ");
+}
+function defaultDocsFooter(edits, origin) {
+  if (origin.label !== DOCS_EDITOR_ORIGIN.label) return origin.footer;
+  const claude = edits.some((e2) => {
+    try {
+      return JSON.parse(e2.after).draftedBy === "claude";
+    } catch {
+      return false;
+    }
+  });
+  return claude ? `Drafted by Claude AI (the docs say "draftedBy": "claude"), sent by a person ${origin.where}.` : origin.footer;
+}
+function withAuthorLine(body, line) {
+  const i2 = body.lastIndexOf("\n---\n");
+  return i2 < 0 ? `${body.trimEnd()}
+
+---
+${line}` : `${body.slice(0, i2 + 5)}${line}`;
+}
+const escapeRe = (s2) => s2.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+function isDocsProposalBranch(branch, component) {
+  const slugs = /* @__PURE__ */ new Set([docsSlug(component.slug ?? component.name), docsSlug(component.name), docsSlug(component.name.toLowerCase())]);
+  return [...slugs].some((s2) => new RegExp(`^docs/(?:[A-Z][A-Z0-9]*-\\d+-)?${escapeRe(s2)}-\\d{8}-[a-z0-9]+$`).test(branch));
+}
+function findOpenDocsProposal(pulls, component, base) {
+  const hit = pulls.filter((p) => p.state === "open" && isDocsProposalBranch(p.headRef, component) && (!base || !p.baseRef || p.baseRef === base)).sort((a, b) => b.updatedAt.localeCompare(a.updatedAt))[0];
+  return hit ? { number: hit.number, url: hit.url, branch: hit.headRef, author: hit.author, title: hit.title, updatedAt: hit.updatedAt } : null;
+}
+async function findOpenDocsProposalOnGitHub(gh, component, base) {
+  return findOpenDocsProposal(await gh.listPullRequests("open"), component, base);
+}
+async function continueDocsProposalOnGitHub(gh, open, edit, opts = {}) {
+  const message = opts.message ?? `docs(${docsSlug(edit.component)}): edit usage guidance in the Bridge docs editor`;
+  const cur = await gh.getFile(edit.path, open.branch);
+  if (cur?.text === edit.after) return "";
+  const sha = await gh.putFile({ path: edit.path, content: edit.after, branch: open.branch, message, sha: cur?.sha });
+  if (opts.authorLine) {
+    const line = opts.authorLine;
+    await gh.getPullRequest(open.number).then((pr) => gh.updatePullRequest(open.number, { body: withAuthorLine(pr.body, line) })).catch(() => void 0);
+  }
+  return sha;
+}
 function docsProposal(edits, opts) {
   const origin = opts.origin ?? DOCS_EDITOR_ORIGIN;
   if (!edits.length) throw new Error("No docs edits in the draft.");
   const names2 = edits.map((e2) => e2.component);
   const list = names2.length === 1 ? names2[0] : `${names2.slice(0, -1).join(", ")} and ${names2[names2.length - 1]}`;
   const title = opts.title?.trim() || `docs(${names2.length === 1 ? edits[0].slug : "components"}): usage guidance for ${list}`;
-  const slug = `${names2.length === 1 ? edits[0].slug : `${edits[0].slug}-and-${names2.length - 1}-more`}`.toLowerCase().replace(/[^a-z0-9-]+/g, "-").slice(0, 40);
+  const slug = docsSlug(names2.length === 1 ? edits[0].slug : `${edits[0].slug}-and-${names2.length - 1}-more`);
   const branch = `docs/${slug}-${slugDate(opts.date)}-${opts.date.getTime().toString(36).slice(-4)}`;
   const csPath = `${opts.changesetDir ?? ".changeset"}/docs-${slug}-${opts.date.getTime().toString(36)}.md`;
   const pkg = opts.packageName ?? "@bridge-ds/react";
@@ -4697,12 +4753,20 @@ Usage guidance for ${list}.
 ${opts.notes.trim()}
 ` : "",
     "---",
-    origin.footer
+    opts.authorLine?.trim() || defaultDocsFooter(edits, origin)
   ].filter((x, i2, a) => !(x === "" && a[i2 - 1] === "")).join("\n");
   return { branch, title, body, files, risk, bump: "patch", labels: ["docs", origin.label, `tier-${risk.tier}`] };
 }
 async function proposeDocsOnGitHub(gh, edits, opts) {
-  const p = docsProposal(edits, { title: opts.title, notes: opts.notes, date: opts.date ?? /* @__PURE__ */ new Date(), origin: opts.origin });
+  if (opts.continueOpen !== false && edits.length === 1) {
+    const e2 = edits[0];
+    const open = await findOpenDocsProposalOnGitHub(gh, { name: e2.component, slug: e2.slug }, opts.base).catch(() => null);
+    if (open) {
+      const sha = await continueDocsProposalOnGitHub(gh, open, e2, { authorLine: opts.authorLine?.trim() || defaultDocsFooter(edits, opts.origin ?? DOCS_EDITOR_ORIGIN) });
+      return { number: open.number, url: open.url, branch: open.branch, title: open.title, continued: true, unchanged: !sha };
+    }
+  }
+  const p = docsProposal(edits, { title: opts.title, notes: opts.notes, date: opts.date ?? /* @__PURE__ */ new Date(), origin: opts.origin, authorLine: opts.authorLine });
   const prTitle = titleWithJiraKey(p.title, opts.jira ?? null);
   const branch = branchWithJiraKey(p.branch, opts.jira ?? null);
   const mainSha = await gh.getBranchSha(opts.base);
@@ -4714,7 +4778,7 @@ ${opts.commitNote ?? "Proposed with the Bridge docs editor."}`, tree, [mainSha])
   await gh.createBranch(branch, commit);
   const pr = await gh.createPullRequest({ title: prTitle, head: branch, base: opts.base, body: p.body, draft: false });
   await gh.addLabels(pr.number, [...p.labels, ...opts.extraLabels ?? []]).catch(() => false);
-  return { number: pr.number, url: pr.url, branch, title: prTitle };
+  return { number: pr.number, url: pr.url, branch, title: prTitle, continued: false, unchanged: false };
 }
 async function commitFileOnGitHub(gh, input) {
   const cur = await gh.getFile(input.path, input.branch);
@@ -5052,6 +5116,7 @@ export {
   conflictRoute,
   ba as contextFor,
   contextLabel,
+  continueDocsProposalOnGitHub,
   bb as contrastDelta,
   bc as contrastDeltaTable,
   bd as contrastLevel,
@@ -5072,6 +5137,7 @@ export {
   decodePicks,
   defaultChoiceFor,
   k as defaultContext,
+  defaultDocsFooter,
   defaultFile,
   bi as defaultProduct,
   defaultScopes,
@@ -5082,6 +5148,7 @@ export {
   bl as detectLayout,
   bm as diffLayered,
   dismissStaleFrom,
+  docsAuthorLine,
   docsFileText,
   docsPrompt,
   docsProposal,
@@ -5089,6 +5156,7 @@ export {
   docsSectionsAnswer,
   docsSectionsResult,
   docsSelectionPrompt,
+  docsSlug,
   docsTaskKeys,
   docsTaskPrompt,
   docsText,
@@ -5132,6 +5200,8 @@ export {
   bt as fileModes,
   bu as filterHistory,
   findExplorationOnGitHub,
+  findOpenDocsProposal,
+  findOpenDocsProposalOnGitHub,
   findPreviewComment,
   bv as findProduct,
   findReferenceProblems,
@@ -5170,6 +5240,7 @@ export {
   isActiveExploration,
   isAlias,
   isAutomationPull,
+  isDocsProposalBranch,
   isDocsSelectionMode,
   isDraftSessionId,
   isExplorationBranch,
@@ -5284,18 +5355,19 @@ export {
   previewsSettled,
   c3 as productForPlace,
   c4 as productLabel,
-  c5 as productOfBranch,
+  c5 as productMarks,
+  c6 as productOfBranch,
   productPreview,
-  c6 as productProblems,
-  c7 as productsOf,
-  c8 as projectOfLabel,
+  c7 as productProblems,
+  c8 as productsOf,
+  c9 as projectOfLabel,
   promoteExplorationOnGitHub,
   promotionPlan,
   proposeDocsOnGitHub,
   propsTable,
   protectLibrary,
   protectRefusal,
-  c9 as protectedBranchesOf,
+  ca as protectedBranchesOf,
   protectionRuleset,
   protectionRulesetName,
   protectionSentence,
@@ -5314,7 +5386,7 @@ export {
   releasesFromTags,
   removeToken,
   removedSide,
-  ca as renderedColor,
+  cb as renderedColor,
   reopenEligibility,
   reopenOnGitHub,
   requestBrief,
@@ -5334,14 +5406,14 @@ export {
   reviewersToAsk,
   r as rgbaToDtcg,
   rgbaToHex,
-  cb as rightsProblems,
+  cc as rightsProblems,
   round3,
   rulesSettingsUrl,
   rulesetTargetsDefault,
-  cc as runLayeredContrast,
-  cd as sameProducts,
+  cd as runLayeredContrast,
+  ce as sameProducts,
   sameScopes,
-  ce as sameToken,
+  cf as sameToken,
   sanitizeDocsReplacement,
   sanitizeDocsResult,
   sanitizeDocsSections,
@@ -5358,12 +5430,12 @@ export {
   shareDescription,
   shareMessage,
   shareState,
-  cf as shipPolicy,
+  cg as shipPolicy,
   shortVariant,
   shortVariants,
   showShare,
   slugify,
-  cg as snapshotUrl,
+  ch as snapshotUrl,
   s as specHash,
   stableCommand,
   startExplorationOnGitHub,
@@ -5371,30 +5443,30 @@ export {
   summarizeApprovals,
   summarizeCi,
   summarizeComponent,
-  ch as summarizeTokenChange,
+  ci as summarizeTokenChange,
   takeMine,
-  ci as tarballAssetName,
-  cj as tarballUrl,
-  ck as teamKey,
-  cl as teamKeyOf,
-  cm as teamUnreadableMessage,
-  cn as teamsIn,
+  cj as tarballAssetName,
+  ck as tarballUrl,
+  cl as teamKey,
+  cm as teamKeyOf,
+  cn as teamUnreadableMessage,
+  co as teamsIn,
   threeWayDiff,
   tintedNeutral,
-  co as titleOf,
+  cp as titleOf,
   titleWithJiraKey,
   t2 as toAlias,
-  cp as toChangeSummary,
+  cq as toChangeSummary,
   toConfigJson,
   toHex,
-  cq as toMap,
+  cr as toMap,
   toOklch,
   toPlain,
-  cr as tokenBump,
+  cs as tokenBump,
   t as tokenCssVar,
   tokenFilesOf,
-  cs as tokenHistory,
-  ct as tokenNode,
+  ct as tokenHistory,
+  cu as tokenNode,
   tokenUsage,
   tokensPath,
   touchesPackages,
@@ -5402,7 +5474,7 @@ export {
   tryTogetherUrl,
   unpicked,
   unreadableShipTeams,
-  cu as unreadableTeams,
+  cv as unreadableTeams,
   updatePendingDrafts,
   upsertToken,
   utf8ToBase64,
@@ -5414,14 +5486,15 @@ export {
   validatePendingDrafts,
   validateProposal,
   validateSet,
-  cv as valueIn,
+  cw as valueIn,
   u as valueToCss,
   valuesEqual,
   variantKeyOf,
-  cw as variantName,
-  cx as versionTimeline,
-  cy as visualImpactProblems,
+  cx as variantName,
+  cy as versionTimeline,
+  cz as visualImpactProblems,
   whoCanShipSentence,
+  withAuthorLine,
   withRequestExploration,
   withoutJiraKey,
   writeDraftResults