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.mdx OS_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

vercel Bot commented Jul 16, 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 16, 2026 2:48pm

Request Review

@github-actions github-actions Bot 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 main Jul 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 free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/xs tooling

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants