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-zhuang os-zhuang added the skip-changeset PR has no user-facing published change; bypasses the changeset gate label Jul 17, 2026
@vercel

vercel Bot commented Jul 17, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
spec Building Building Preview, Comment Jul 17, 2026 12:05pm

Request Review

@os-zhuang

Copy link
Copy Markdown
Contributor Author

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

@os-zhuang os-zhuang closed this Jul 17, 2026
@os-zhuang
os-zhuang deleted the fix/main-red-followups branch July 17, 2026 12:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/xs skip-changeset PR 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