docs: BUG-991/992 收口，补真机走查清单

门禁 run 2837 全绿、d2cec179 已部署、retire 迁移已应用。
五条只有真人能验的写成 docs/testing 清单。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0199rbQDTsUbCVw84wc8BTFe

docs/tasks/README.md

@@ -154,8 +154,8 @@
 | — | `PROGRESS-starter-greeting-20260917.md` | 首页开场语改成 claude.ai 式单行问候：`starter-greeting.ts` 的「称呼 + 追问句」五时段十五条收成三个池子（时段 / 星期 / 回访，按 `variantSelection` 确定性取一条），副标题行与 `.starter-salutation` 下线，h1 降到 `clamp(24px, 2.8vw, 30px)`；追问移到输入框占位符「想聊什么都可以」。产品直接拍板，非 Bug，不占 BUG 号 | 待验收 | `codex/starter-greeting-20260917` |
 | `TASK-session-list-rebuild-20260921.md` | `PROGRESS-session-list-rebuild-20260921.md` | **P0 会话列表重建（`e4e73f56` 的返工）**：服务端 `GET /api/sessions` 用 `messages <> '[]'` 排除空咨询，但校正会话的 `messages` 永远是 `[]`（建行写死空数组、创建合同只收空数组、PATCH 忽略、`touch_chat_session_from_rectification_case` 只 bump `updated_at`）→ **全部生时校正会话从侧栏消失**，而客户端 `isListedSidebarSession` 明确放行校正会话，两层规则相反且无跨层对断（BUG-987）；同一提交把副标题换成 `created_at`，排序/分组/游标仍是 `updated_at`，列表可见时间不单调（9/18→9/17→9/7→9/16）（BUG-988）；BUG-928 让步下来的「复用空会话」不 bump 时间，点新建变成跳回 9/17 的旧草稿（BUG-989）。**产品 09-21 拍板**：D1 副标题改最后活动时间（推翻 BUG-929 该条，其余保留）、D2 收掉 `BLOCKED.md:120` 的让步，第一问前不落库、删复用与 `draft`。T1 不得让步，T3 可拆轮。BUG 段 987 起 | **已验收**（经修复单） | `e71e4f92`（Claude 验收：T1/T2/T3 实现均正确；tsc 0 / lint 0 error 119 warning 与基线同 / `npm test` 本机 3640 条 34 红与 `f8d65e48` 逐条一致、净增 5 绿 / `next build --webpack` 通过、`/` Static、首屏 gzip 643,115 较基线 −0.027% / page.tsx 1826→1791。**P1：门禁 run 2832 红、staging 未部署**——新加的真实 Postgres 测试在有 Docker 的门禁机上跑出 `unsupported not filter`，兼容层 `not()` 不支持 `is` 算子，归档分支炸。修复单 `TASK-session-list-rebuild-fix-20260921.md` 已验收通过，`df329fa9` 已部署） |
 | `TASK-session-list-rebuild-fix-20260921.md` | `PROGRESS-session-list-rebuild-fix-20260921.md` | **验收修复单（挡着三条修复上线）**：本地 PG 兼容层 `LocalPostgresQueryBuilder.not()` 只认 `eq` / `cs` 两个算子，`not("archived_at","is",null)` 直接 throw → `GET /api/sessions?archived=1` 落外层 catch 回 500，**侧栏「归档记录」自 `a1956deb`（09-06，BUG-553）起一直打不开**，两周无人发现是因为只有源码正则合同看着它；本轮新加的真实 Postgres 测试第一次真跑到这条路径，把它照出来，于是门禁 run 2832 红、`e71e4f92` 没部署。**决策**：在兼容层补 `is not null / is not true / is not false`，不得反过来改调用方绕开，不得删改测试断言让门禁变绿。与 BUG-926 的 `order()` 缺口同类。BUG 段 990 起 | **已验收通过** | `df329fa9`（Claude 验收：`not()` 增 `isNot` kind，统一走新的 `compileUnaryIsClause` 编译 `is [not] null/true/false`，非法取值仍 throw；`filterClause` 是唯一消费者、已覆盖，未落进兜底分支。**门禁 run 2833 全绿：3653 条 / 3653 过 / 0 红 / 0 skip**，`ok 1238` 即那条真实 Postgres 归档测试；migrate 2834、deploy 2835 成功，`/api/health` 的 `deployment.gitCommit` = `df329fa9`。本机复跑：tsc 0 / lint 0 error 119 warning 未增 / `npm test` 用例名逐条 diff 较 `e71e4f92` **恰好 +2 无删除**、失败清单完全一致 / `next build --webpack` 通过、`/` Static、首屏 gzip 643,116（+1 B）。**顺带查出 BUG-991**：归档视图的 UI 入口在 `92558ee6`（08-22）就被删了，`onToggleArchivedView` 全仓无调用点 → BUG-990 原描述「用户点归档记录后 500」不成立（接口层 500 属实，用户碰不到），已在 Bug 历史更正；归档后看不回来也恢复不了是真问题，待产品决策） |
-| `TASK-archive-retire-20260921.md` | `PROGRESS-archive-retire-20260921.md` | **归档能力整体下线（BUG-991）**：行菜单能「归档」，归档后没有任何界面能列出或恢复它——切换按钮 `session-nav-toggle`（「归档 N」/「返回」）在 `92558ee6`（2026-08-22）被删，但 `onToggleArchivedView` / `archivedCount` / `showingArchived` / `toggleArchivedView()` / `GET /api/sessions?archived=1` / `applyArchiveFilter` 整条链路留着，全仓无渲染调用点；行菜单的「恢复」同样不可达（归档行永远不进 `visibleSessions`）。接口自 `a1956deb`（09-06）起就是 500（BUG-990），一个月没人发现正因为点不到。**产品 09-21 拍板整个下线**（口径：多余入口宁可删除也不修），不装回入口。D2 本轮不删 `archived_at` 列（§7.6 拆两轮），只清空存量；D3 不得回退 BUG-990 的兼容层修复；D4 存量归档会话一律放回列表。**迁移禁止 bump `updated_at`**，否则全部历史会话跳顶、毁掉刚修好的 BUG-988。让步顺序里 T3 必须先于 T1/T2。删除能力不动 | **验收未通过（1 条 P1）** | `5a4b8738`（Claude 验收：**业务三层全部正确**——迁移只清 `archived_at`、无任何 `updated_at` 赋值、`schema_owner` 守卫、幂等；接口删 `?archived=1` 且 PATCH 收到 `archived_at` 回 2xx 不落库；界面行菜单只剩 收藏/重命名/转发/删除，`applyLegacySessionControls` 只删 archived 半边、留 pinned 半边；`local-postgres-not.test.ts` 与删除链路一字未动；`sidebar-contract.test.ts` 新增菜单项锁定断言。tsc 0 / lint 0 error 119 warning / `npm test` 3644 条用例名 diff **+3 无删除**、失败清单与 `df329fa9` 逐条一致 / `/` Static / 首屏 gzip 642,382（−0.11%）。**P1：门禁 run 2836 红在 Python**——`tests/test_session_management_entrypoints.py` 两条源码合同仍要求归档入口存在，本机复现恰好这两条。前序单的自查口径只写了 grep `frontend/src`，扫不到 `tests/` 下的 Python 合同。**同类第四次**（BUG-933/934/939）。修复单 `TASK-archive-retire-fix-20260921.md`） |
-| `TASK-archive-retire-fix-20260921.md` | `PROGRESS-archive-retire-fix-20260921.md` | **验收修复单（挡着归档下线上线）**：`tests/test_session_management_entrypoints.py` 的 `test_chat_history_management_actions_are_exposed` 断言 `toggleArchivedSession` / `showArchivedSessions` / 「已归档，可在左侧归档中恢复。」/「归档」/「恢复」必须出现；`test_archiving_never_calls_the_delete_endpoint` 用 `source.index("function toggleArchivedSession")` 切片，函数没了直接 `ValueError`。**决策**：翻成反向断言而非删文件（反向断言只对 `sidebar-session-row.tsx` 与 `use-session-management.ts` 做，整份 `_home_surface()` 上做「恢复」会误伤）；重写的测试必须保住与归档无关的 `method: mode === "create" ? "POST" : "PATCH"` 合同，并把「归档不走 DELETE」翻成「删除仍走 DELETE」。**F2 防复发**：`frontend/AGENTS.md` 加一条——删改前端符号/类名/可见文案前必须 `git grep -- tests/ frontend/` 而不是只扫 `frontend/`。BUG 段 992 起 | 待验收 | `codex/archive-retire-fix-20260921` |
+| `TASK-archive-retire-20260921.md` | `PROGRESS-archive-retire-20260921.md` | **归档能力整体下线（BUG-991）**：行菜单能「归档」，归档后没有任何界面能列出或恢复它——切换按钮 `session-nav-toggle`（「归档 N」/「返回」）在 `92558ee6`（2026-08-22）被删，但 `onToggleArchivedView` / `archivedCount` / `showingArchived` / `toggleArchivedView()` / `GET /api/sessions?archived=1` / `applyArchiveFilter` 整条链路留着，全仓无渲染调用点；行菜单的「恢复」同样不可达（归档行永远不进 `visibleSessions`）。接口自 `a1956deb`（09-06）起就是 500（BUG-990），一个月没人发现正因为点不到。**产品 09-21 拍板整个下线**（口径：多余入口宁可删除也不修），不装回入口。D2 本轮不删 `archived_at` 列（§7.6 拆两轮），只清空存量；D3 不得回退 BUG-990 的兼容层修复；D4 存量归档会话一律放回列表。**迁移禁止 bump `updated_at`**，否则全部历史会话跳顶、毁掉刚修好的 BUG-988。让步顺序里 T3 必须先于 T1/T2。删除能力不动 | **已验收**（经修复单） | `5a4b8738`（Claude 验收：**业务三层全部正确**——迁移只清 `archived_at`、无任何 `updated_at` 赋值、`schema_owner` 守卫、幂等；接口删 `?archived=1` 且 PATCH 收到 `archived_at` 回 2xx 不落库；界面行菜单只剩 收藏/重命名/转发/删除，`applyLegacySessionControls` 只删 archived 半边、留 pinned 半边；`local-postgres-not.test.ts` 与删除链路一字未动；`sidebar-contract.test.ts` 新增菜单项锁定断言。tsc 0 / lint 0 error 119 warning / `npm test` 3644 条用例名 diff **+3 无删除**、失败清单与 `df329fa9` 逐条一致 / `/` Static / 首屏 gzip 642,382（−0.11%）。**P1：门禁 run 2836 红在 Python**——`tests/test_session_management_entrypoints.py` 两条源码合同仍要求归档入口存在，本机复现恰好这两条。前序单的自查口径只写了 grep `frontend/src`，扫不到 `tests/` 下的 Python 合同。**同类第四次**（BUG-933/934/939）。修复单 `TASK-archive-retire-fix-20260921.md` 已验收通过，`d2cec179` 已部署） |
+| `TASK-archive-retire-fix-20260921.md` | `PROGRESS-archive-retire-fix-20260921.md` | **验收修复单（挡着归档下线上线）**：`tests/test_session_management_entrypoints.py` 的 `test_chat_history_management_actions_are_exposed` 断言 `toggleArchivedSession` / `showArchivedSessions` / 「已归档，可在左侧归档中恢复。」/「归档」/「恢复」必须出现；`test_archiving_never_calls_the_delete_endpoint` 用 `source.index("function toggleArchivedSession")` 切片，函数没了直接 `ValueError`。**决策**：翻成反向断言而非删文件（反向断言只对 `sidebar-session-row.tsx` 与 `use-session-management.ts` 做，整份 `_home_surface()` 上做「恢复」会误伤）；重写的测试必须保住与归档无关的 `method: mode === "create" ? "POST" : "PATCH"` 合同，并把「归档不走 DELETE」翻成「删除仍走 DELETE」。**F2 防复发**：`frontend/AGENTS.md` 加一条——删改前端符号/类名/可见文案前必须 `git grep -- tests/ frontend/` 而不是只扫 `frontend/`。BUG 段 992 起 | **已验收通过** | `d2cec179`（Claude 验收：四个点名的坑全避开——`writeChatSession` 的 POST/PATCH 合同搬进改名后的测试；反向断言只打 `sidebar-session-row.tsx` 与 `use-session-management.ts`，没对整份 `_home_surface()` 禁「恢复」；删除切片改断言 `method: "DELETE"`、删除那条测试一字未动；P3 也顺手做了，迁移测试改为从文件切出 `update` 再执行。**门禁 run 2837 全绿：3656 条 / 3656 过 / 0 红 / 0 skip**，`ok 1240` 是带 Docker 的迁移测试（`archived_at` 归零、`pinned`/`messages`/`updated_at` 逐字节不变、重跑幂等）；migrate 1435 + deploy 1436 成功，`/api/health` 的 `gitCommit` = `d2cec179`、`latestMigration` = `20260921010000_retire_chat_session_archive.sql`。本机：pytest 3 条全绿 / tsc 0 / lint 0 error 119 warning / `npm test` 失败清单与 `5a4b8738` 逐条一致；diff 无 `frontend/src` 改动故未重测构建。**独立变异测试**：把「归档」注回行菜单，Python 合同与 `sidebar-contract.test.ts` 同时转红。观察项：`consultation-smalltalk.test.ts` 三条用例在全量并发下偶发漏报（单跑稳定 30/30、失败数不变），`# tests` 总数因此会 ±3 抖，验收改比用例名列表） |
 
 ### 个人报告