Skip to content

docs(adr): renumber pinyin-search ADR 0097 → 0098 — resolve the second 0097 collision - #3070

Merged
os-zhuang merged 1 commit into
mainfrom
claude/adr-0098-pinyin-renumber
Jul 16, 2026
Merged

docs(adr): renumber pinyin-search ADR 0097 → 0098 — resolve the second 0097 collision#3070
os-zhuang merged 1 commit into
mainfrom
claude/adr-0098-pinyin-renumber

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

解决 ADR 编号的第二次撞号:#3032 的状态治理把连接器 ADR 从 0096 改号到 0097(执行面身份准入 ADR 保留 0096),但同日落地的拼音搜索 ADR 也占了 0097——同一冲突在上一个编号槽位复现。

处置(沿用 #3032 的同一决策规则)

  • 连接器 ADR 保留 0097:它的改号已经传播进代码注释、测试标题、zod describe/message 字符串(全仓 125 处引用),再动它代价大且无收益;
  • 更新的拼音 ADR 迁往空闲的 0098

变更(3 文件,纯文档/元数据)

文件变更
docs/adr/0097-pinyin-search-companion-column.md0098-...重命名 + 标题行 ADR-0097:ADR-0098:
content/docs/deployment/environment-variables.mdxOS_SEARCH_PINYIN_ENABLED 条目的 (ADR-0097)(ADR-0098)
.changeset/pinyin-search-companion.md(#2486, ADR-0097)(#2486, ADR-0098)(未发布的 changeset,可安全编辑)

审计说明

全仓 grep 分类了每一处 ADR-0097 引用:拼音语义的只有上述 3 处;拼音实现的代码注释只引用 ADR-0045/0049/0061/0079/0093(无需改代码);125 处连接器语义引用全部保留;CHANGELOG 按 #3032 惯例作为历史记录不动;docs/PRIORITIZATION.md 及其他 ADR 无拼音 ADR 交叉引用;0098 槽位确认空闲。

Refs #3032(第一次撞号的处置)、#2486(拼音 ADR 的跟踪 issue)。

🤖 Generated with Claude Code

https://claude.ai/code/session_01Pbmw3pMqNJfPbkvwh9Fkjs


Generated by Claude Code

…d 0097 collision
The #3032 status-hygiene sweep renumbered the declarative-connector ADR
0096 → 0097 (the execution-surface ADR kept 0096), but the pinyin-search ADR
had landed as 0097 on the same day — recreating the exact collision one slot
up. Same resolution policy as #3032: the connector ADR keeps 0097 (its
renumber is already propagated through code comments, tests, and zod
strings), and the newer pinyin ADR moves to the free 0098 slot.
Pinyin-semantic references were audited repo-wide and updated in the only
three places they exist: the ADR file itself (renamed + title), the
OS_SEARCH_PINYIN_ENABLED entry in content/docs/deployment/
environment-variables.mdx, and the pending pinyin-search-companion changeset
(unreleased, so safe to edit). The pinyin implementation's code comments cite
ADR-0045/0049/0061/0079/0093 only — no code changes needed. All 125
connector-semantic ADR-0097 references are untouched; CHANGELOG history is
left as historical record (same as #3032).
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Pbmw3pMqNJfPbkvwh9Fkjs
@vercel

vercelBot commented Jul 16, 2026

Copy link
Copy Markdown

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

ProjectDeploymentActionsUpdated (UTC)
specBuildingBuildingPreview, CommentJul 16, 2026 2:48pm

Request Review

@github-actionsgithub-actionsBot added documentation Improvements or additions to documentation tooling size/xs labels Jul 16, 2026
@os-zhuang
os-zhuang marked this pull request as ready for review July 16, 2026 14:54
@os-zhuang
os-zhuang merged commit 3cdda79 into mainJul 16, 2026
14 of 15 checks passed
@os-zhuang
os-zhuang deleted the claude/adr-0098-pinyin-renumber branch July 16, 2026 14:54
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentationImprovements or additions to documentationsize/xstooling

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@os-zhuang@claude