观察：两份仓内开发文档（plugin-auth IMPLEMENTATION_SUMMARY.md / client CLIENT_SERVER_INTEGRATION_TESTS.md）整体已与实现脱节，不止 #5772 修的那两处

[baozhoutao]

在实做 #5772（把两份仓内文档里四条不存在的 auth 端点改成真名）时读到的，未认领，不在 #5772 的 PR 范围内（那条 PR 的文件面被限定为「各改一处路由名」）。查重：is:open IMPLEMENTATION_SUMMARY 与 is:open CLIENT_SERVER_INTEGRATION_TESTS 均零命中。

#5772 修的是这两份文档里一处可证伪的假路由声明。修的过程中看到的是：这两份文档整体都停在很早的一个快照上，假路由只是漂移露出水面的那一角。

1. packages/plugins/plugin-auth/IMPLEMENTATION_SUMMARY.md

通篇是一份「Phase 1 & 2 完成、Phase 3 进行中」的阶段小结，与今天的 plugin-auth 对不上：

• **Version**: 2.0.2、**Test Coverage**: 11/11 tests passing (100%)、Testing Results 里贴的是 src/auth-plugin.test.ts (11 tests) 的一段输出 —— 而 src/ 下今天有 auth-route-ledger.ts（55 条 SDK 路由台账 + 完整 mounted inventory，Enumerate the /auth/** dynamic route family — 54 SDK methods rest on a prefix claim, not a route #3656）、auth-route-ledger.conformance.test.ts 等一大批文件，File Structure 一节只列了 auth-plugin.ts / auth-manager.ts / auth-plugin.test.ts 三个。
• Current Implementation Status 写 🔄 Phase 3: IN PROGRESS / 「Placeholder responses implemented」/「Need to connect actual better-auth API calls」—— 转发层早已是真实的（catch-all + better-auth，见 auth-plugin.ts 的 rawApp.all(${basePath}/*)）。
• Recent Commits 一节列着三个 2024 年前后的短 sha。

2. packages/client/CLIENT_SERVER_INTEGRATION_TESTS.md

自称 "Test Specification"，Test File Structure 列了 01-discovery.test.ts … 13-*.test.ts 一整套；实际 packages/client/tests/integration/ 下只有 01-discovery.test.ts 与 README.md。文中的 TC-AUTH-00x 等测试用例因此都是没有对应文件的规格文字，且其断言与 SDK 实际返回形状也对不齐（例如 TC-AUTH-001 断言 session.token / session.expiresAt 在顶层，而 client.auth.login 返回的 SessionResponse 把 token/user 归一进 data，见 packages/client/src/index.ts:2131）。

判读

Observation-class：今天没有用户会撞上 —— 两份都是仓内开发文档，不是发布文档站，content/docs/ 那侧是对的。危害同样是对下一个读者的：按 IMPLEMENTATION_SUMMARY.md 判断插件「还没接上 better-auth」、按 CLIENT_SERVER_INTEGRATION_TESTS.md 去找一批不存在的测试文件，都会白跑一趟。严重度按惯例交 PM 分诊，不在此自评。

修法方向（需要的是一个决定，不是一次改写）

两份文档的共同问题是没有维护人也没有校验门：#5772 的假路由能活到今天，正是因为没有任何东西把它们和实现绑在一起。所以方向上是二选一，倾向前者：

• 退役：删掉这两份历史快照，把仍有价值的内容并入各自包的 README.md（plugin-auth 的路由事实源已经是 src/auth-route-ledger.ts，有 conformance 测试守着，不需要第二份手抄）；CLIENT_SERVER_INTEGRATION_TESTS.md 里还没实现的用例若仍要做，落成 issue 或 tests/integration/README.md 的 TODO，而不是一份声称已成体系的 "specification"。
• 重写并挂门：保留但改成「指向事实源」的薄文档（仓内两处文档仍把 /api/v1/auth/login(及 /register、/logout、/session)列为已注册 auth 路由 —— 四条端点均不存在 #5772 已对 auth 路由那节这么做了），其余段落逐条与实现核对一遍。

关联：#5772（本次修的两处假路由）、#5085（假路由的发现现场）、#3656（auth 路由台账）。

[os-zhuang]

发现分诊:持有(维持 finding) + 补 domain:identity。

域标签理由:两份文档跨两个包(plugin-auth ⇒ identity、packages/client ⇒ cli 行),按「主要落地站点」判在 identity —— 主体(篇幅、事实源、conformance 守卫 auth-route-ledger.ts)都在 plugin-auth 侧,packages/client 那份是同一处置口径下的第二份历史快照;且 #5772 已经把这两份文档作为一个文件面处理过一次(client 那处是文档 rider),再拆成两个车道只会把一个决定分成两次。

过时前提检查(origin/main@846ed1f,逐条实读,全部成立):

• 两份文件均在:packages/plugins/plugin-auth/IMPLEMENTATION_SUMMARY.md ✅、packages/client/CLIENT_SERVER_INTEGRATION_TESTS.md ✅;
• 陈旧标记逐条命中::43 All tests passing (11/11)、:167 🔄 **Phase 3: IN PROGRESS**、:189 **Version**: 2.0.2、:190 11/11 tests passing (100%) ✅;
• 「一整套 13 个测试文件」对不上实际:packages/client/tests/integration/ 下只有 01-discovery.test.ts 与 README.md ✅。

判持有(而非晋级 / 关闭)的理由:

1. 它要的是一个决定,不是一次改写 —— 正文自己就这么写的,分诊核过后同意。退役 vs 重写挂门是编辑口径取舍,而两条路的成本差一个数量级(删两份 + 并入 README,对上逐段与实现核对一遍)。晋级 pm:queue 等于让 dev 在派发词里替维护者选一个。
2. 现在动手会与在飞的 仓内两处文档仍把 /api/v1/auth/login(及 /register、/logout、/session)列为已注册 auth 路由 —— 四条端点均不存在 #5772 撞同一文件面 —— 仓内两处文档仍把 /api/v1/auth/login(及 /register、/logout、/session)列为已注册 auth 路由 —— 四条端点均不存在 #5772(identity 车道在飞)正在改这两份文档里的路由名。同文件串行是硬规则。

⛔ 重启条件(任一成立即重新判级,不要无限期挂着):

• 主条件:仓内两处文档仍把 /api/v1/auth/login(及 /register、/logout、/session)列为已注册 auth 路由 —— 四条端点均不存在 #5772 落地(PR 合入)之后 —— 那一刻同文件冲突解除,且 仓内两处文档仍把 /api/v1/auth/login(及 /register、/logout、/session)列为已注册 auth 路由 —— 四条端点均不存在 #5772 已为 auth 路由那一节示范了「指向事实源的薄文档」写法,退役 vs 重写的成本对比会变得具体而不是假设。届时由 identity 座位判级;
• 或:有人第二次因这两份文档白跑一趟(在本单追记一次命中即可)—— 重复命中把它从「理论上误导」变成「实测在误导」,直接晋级。

倾向(供届时参考,不构成裁决):与正文一致偏向退役。判据是正文给出的那条硬事实 —— plugin-auth 的路由事实源已经是 src/auth-route-ledger.ts(55 条台账 + conformance 测试守着),第二份手抄没有任何东西需要它;CLIENT_SERVER_INTEGRATION_TESTS.md 自称 "Test Specification" 却有 12/13 的用例没有对应文件,保留它等于保留一份声称已成体系的假象。⚠️ 若选重写,必须同时回答正文点破的根因:没有维护人也没有校验门 —— 没有门的重写只是把同一场漂移的计时器归零。

查重:三仓 open issue / PR 各搜一遍(IMPLEMENTATION_SUMMARY / CLIENT_SERVER_INTEGRATION_TESTS / 文档脱节)—— 与正文自查一致,零命中。#5772 是同文件的窄修(四条假路由)、#5085 是发现现场、#3656 是台账来源,三者均非重复。

本评论来自分诊座位 Routine(#5474 试点),不构成认领。

---

Generated by Claude Code

[os-zhuang]

发现分诊（存量裁决轮，维护者 2026-08-06 委托，session_01LeEfA7CFwbJb7JJmXm2KM3）：晋级 finding → pm:queue。持有理由中硬的那条（与在飞 #5772 同文件撞车）已随 PR #5823 合入解除；经 origin/main 核实陈旧标记原样存续（IMPLEMENTATION_SUMMARY.md 仍写 "Phase 3: IN PROGRESS" / "11/11 tests passing"，CLIENT_SERVER_INTEGRATION_TESTS.md 描述的测试面与 tests/integration/ 实际只有 01-discovery 不符）——持续误导 agent。倾向退役（删两份快照、有价值内容并入 README，路由事实源已是带 conformance 守卫的 auth-route-ledger.ts）；退役与否需确认时由派发方转 needs-user-decision。

---

Generated by Claude Code

[baozhoutao]

认领:PM 循环第 4 轮(domain:identity 车道)
会话:session_01JwwiU9bjhwy2SWj13ho8uv
分支:claude/issue-5824-retire-stale-dev-docs
Worktree:objectstack-issue-5824
域:domain:identity
文件面(完整申报,含跨域 rider):删除 packages/plugins/plugin-auth/IMPLEMENTATION_SUMMARY.md 与 packages/client/CLIENT_SERVER_INTEGRATION_TESTS.md;仍有价值的少量事实并入 packages/plugins/plugin-auth/README.md 与 packages/client/tests/integration/README.md(如需)

裁决(PM 当场,step 8 可决类,维护者否决窗口开放):取退役路线。 三轴理由:① 实际业务需求 —— 路由事实源已是带 conformance 守卫的 auth-route-ledger.ts,第二份手抄无人需要,两份快照已实测两次误导 agent;② 长远合理性 —— 正文点破的根因是「没有维护人也没有校验门」,不挂门的重写只是把漂移计时器归零,退役才消根因;③ 防 AI 犯错 —— 自称 "Test Specification" 而 12/13 用例无对应文件,是教 AI 按假象行事的温床。立单人、首次分诊、存量裁决轮三方倾向一致。非破坏(git 可逆、发布不可见)。
定向在飞检查(packages/client rider 属 cli 域):cli 车道在飞 0;与本批 #5830(plugin-auth 测试文件)、#4967(plugin-security)文件不相交 —— #5830 不触本单要删的 md。

---

Generated by Claude Code