Skip to content

ci: ratchet the role-word baseline for approvals.mdx (5 → 9) - #3123

Closed
os-zhuang wants to merge 1 commit into
mainfrom
fix/main-red-followups
Closed

ci: ratchet the role-word baseline for approvals.mdx (5 → 9)#3123
os-zhuang wants to merge 1 commit into
mainfrom
fix/main-red-followups

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

问题:main 的 Lint & Type Check 全红

• content/docs/automation/approvals.mdx: role-word count grew 5 → 9.
New occurrences are banned (ADR-0090 D3).

#3113(docs P1 wave 2,25a19be72)起,main 上每一个 commit 的 Lint & Type Check 都因此失败(含之后无辜的 #3111#3101#3102#3108)。该 PR 给 approvals 页加了 4 处 role 但没同步 ratchet baseline。

为什么是上调 baseline 而不是改文案

这 4 处正是 scripts/check-role-word.mjs 自己 docstring 里点名豁免的那一类:

existing occurrences are frozen in role-word-baseline.json (many are legitimate — the better-auth boundary, ARIA role= in samples, educational "formerly roles" mentions)

具体内容:

  • sys_member.role(owner/admin/member)——better-auth 的真实字段,不是 ADR-0090 D3 要消灭的旧词汇
  • type: 'role'——审批 approver 的真实 spec 枚举值

而且这段文字的用途恰恰是教作者把 position 名写进 type:'role'(还配了 os lint 规则 approval-role-not-membership-tier)。这是边界文档,不是词汇漂移——所以移动 baseline,不动 prose。

验证

$ node scripts/check-role-word.mjs
check-role-word: OK (49 baselined file(s), no new occurrences).

不在本 PR 范围

main 另有一处红:Publish Smoke。它与本问题无关且不是回归——该门由 #3100 于 4 小时前落地,落地 9 分钟后的第一次运行就失败,在 main 上从未绿过。已另开 issue 记录诊断。

🤖 Generated with Claude Code

#3113 (docs P1 wave 2) added four `role` mentions to the approvals page
and left the ADR-0090 D3 vocabulary ratchet red — main's Lint & Type
Check has failed on every commit since.
The new occurrences are the class the ratchet's own docstring exempts
("many are legitimate — the better-auth boundary"): they document
`sys_member.role` (a real better-auth membership tier) and the
`type: 'role'` approver type, precisely to teach authors NOT to put a
position name there. That is boundary documentation, not vocabulary
drift, so the baseline moves rather than the prose.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@os-zhuangos-zhuang added the skip-changeset PR has no user-facing published change; bypasses the changeset gate label Jul 17, 2026
@vercel

vercelBot commented Jul 17, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
specBuildingBuildingPreview, CommentJul 17, 2026 12:05pm

Request Review

@os-zhuang

Copy link
Copy Markdown
ContributorAuthor

作废——role-word baseline 的处置交回 #3113 的作者。

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/xsskip-changesetPR has no user-facing published change; bypasses the changeset gate

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@os-zhuang