Jyotisha/docs/tasks/TASK-rectification-p0-fix-20260915.md

TASK · 验收修复单：page.tsx 超出增长冻结上限，门禁红

• 日期：2026-09-15
• 基线 commit：origin/staging @ f51e494c
• 执行分支：codex/rectification-p0-fix-20260915
• 来源：Claude 对 f51e494c（BUG-699 / 704 / 705 / 706 / 708 / 709）的验收
• 规模：把十来行接线从 page.tsx 搬出去。不改任何行为。

---

1. 验收结论摘要

两份任务书的六条缺陷全部实现且实现方式正确。Linux 门禁实测：

项	结果
tsc --noEmit	0 错
npm run lint	0 error / 119 warning（全部既有）
本轮 8 个合同套件	130 项 全绿
npm run build	exit 0；/ 仍是 ○ Static
首屏 JS gzip-9	584,413 B（对上一次实测 583,660 B，+0.13%）
全量测试	父提交 d3a2c48b fail 32 → f51e494c fail 33

多出来的一条就是本单要修的。除它之外，失败清单与父提交逐条一致（其中 6 条属于同期另一会话的星历 / 星盘页改动，不在本轮范围）。

2. 事故实证

frontend/tests/chart-view-route.test.ts → page.tsx does not grow to host the chart page：

assert.ok((pageSource.match(/\n/g) ?? []).length <= 1951);

实测：

	frontend/src/app/page.tsx 换行数
父提交 d3a2c48b	1951（正好卡在上限）
f51e494c	1964（+13）

d3a2c48b 上单独跑该文件两次全绿，f51e494c 上两次全红，稳定复现，不是抖动。

增长来自 BUG-705 的接线，git diff d3a2c48b..f51e494c -- frontend/src/app/page.tsx 新增的是：

resolveLookupBootstrap,                       // import
const listedSelection = resolveBootstrapSessionSelection({…});
const lookedUp = await resolveLookupBootstrap({ selection, sessions, defaultSessionId, catalog, signal });
if (controller.signal.aborted) return;
nextSessions = lookedUp.sessions;
const bootstrapSelection = lookedUp.selection;
} else if (lookedUp.notice) { setComposerNotice(lookedUp.notice); }

逻辑本身已经在 lib 里（resolveLookupBootstrap 是外部函数，写法是对的），超的只是 page.tsx 里这十来行接线。

违反的是 AGENTS.md §6：

frontend/src/app/page.tsx 已从 4,766 行拆到 2,000 行以下，不得再增长：新逻辑进 frontend/src/hooks/、frontend/src/lib/ 或组件。

上限 1951 是同期另一会话在 830799fa 里按当时行数钉的，等价于「从此不许再长」，与 §6 一致。不得用「上限是别人钉的」当理由去放宽它。

2.1 连带后果：staging 已经 6 个提交没部署

GET https://staging.jyotisha.chat/api/health 的 deployment.gitCommit = 2d7698ea（fix(chat): keep stored rectification titles on open）。它之后有 6 个含门禁路径的提交未部署，f51e494c 是最后一个。

门禁跑 npm test，本单这条红会让它失败。这很可能就是不部署的原因（也可能还叠加了另一会话星历页那几条，需要执行方看 Gitea 的实际日志确认，不要凭猜写结论）。

在修好之前，产品没有任何环境可以实测这六条修复。

---

3. 决策记录

1. 修法是把接线搬出 page.tsx，不是放宽上限。 AGENTS.md §6 是硬约束。
2. 行为零变化。BUG-705 的三分支语义（found / missing / unavailable）不得动。
3. 不碰同期另一会话的星历 / 星盘页改动与它们的失败。

---

4. 硬红线

1. 不得修改 chart-view-route.test.ts 里的 1951 上限，也不得删除或跳过该断言。
2. 不得改变 BUG-705 的行为：lookup 三分支、?c= 在 unavailable 时保留、404 才清 URL 并报 SESSION_MISSING_NOTICE。
3. tsc --noEmit 0 错；npm run lint 0 error。
4. 全量 npm test 的失败数必须从 33 回到 32，且清单与 d3a2c48b 逐条一致。
5. 不得顺手修另一会话那 6 条。

---

5. 任务分解

任务 1 · 把 bootstrap 选择的接线搬出 page.tsx

1.1 把「resolveBootstrapSessionSelection → resolveLookupBootstrap → 得到最终 bootstrapSelection / nextSessions / notice」这一段合成一个调用，放进 frontend/src/lib/home-bootstrap.ts（本轮已经在动这个文件）或一个新的 frontend/src/lib/ 模块。

page.tsx 里应当只剩一次 await 和几个赋值，净行数不高于 d3a2c48b。

1.2 允许的落点按 §6 的优先级：frontend/src/lib/ > frontend/src/hooks/ > 组件。不要为这点接线新开一个 hook——参数式 hook 内部保持 0 个 React hook 的既定模式仍然有效。

1.3 搬完复核：node -e "…(s.match(/\n/g)||[]).length" 对 page.tsx 的结果 ≤ 1951。数字写进 PROGRESS。

验收标准

• npx tsx --test tests/chart-view-route.test.ts fail=0。
• npx tsx --test tests/session-lookup-unlisted.test.ts tests/chat-session-url.test.ts 仍然 fail=0，断言一条未改。
• 全量 npm test fail=32，清单与 d3a2c48b 逐条一致。
• tsc --noEmit 0 错、npm run lint 0 error。

任务 2 · 文档

• docs/tasks/PROGRESS-rectification-p0-fix-20260915.md：搬了什么、page.tsx 前后行数、全量失败数 33 → 32。
• 在 PROGRESS-rectification-open-retitles-session-20260915.md 补一段「验收补正」，写明 Linux 实测数字（本单 §1 的表）与这条超限，以及执行方本机把全量 TAP 记成 Windows 缺口所以没看到。
• 不新增 BUG 编号：这是红线违反 + 合同测试红，没有用户可感知现象，不进 docs/BUG_HISTORY.md。当前最大号是 BUG-709；执行中若发现真实回归从 BUG-710 起。
• 不动 CHANGELOG.md。

---

6. 让步顺序

1. 若搬进 home-bootstrap.ts 会让它承担不该承担的职责，另开一个 frontend/src/lib/ 模块，不要退回 page.tsx。
2. 绝不让步：不得放宽或删除 1951 上限；不得改 BUG-705 的三分支行为；失败数必须回到 32。

---

7. 开工前置命令

cd /workspace/Jyotisha
git status -sb | head -1
git fetch origin --prune
git worktree add -b codex/rectification-p0-fix-20260915 \
  .worktrees/rectification-p0-fix-20260915 origin/staging
cd .worktrees/rectification-p0-fix-20260915/frontend
npm ci
npx tsx --test tests/chart-view-route.test.ts   # 应先看到这条红
node -e "console.log((require('fs').readFileSync('src/app/page.tsx','utf8').match(/\n/g)||[]).length)"

交付：git push origin HEAD:staging，推完核对远端 SHA，并确认 Gitea 门禁转绿、/api/health 的 deployment.gitCommit 追上 staging head。

---

8. 本轮验收确认的欠账（不属于本单）

欠账	说明
npm run test:db 未跑	本轮动了数据库结构（新增 touch_chat_session_from_rectification_case 函数与触发器）。AGENTS.md §7.6 要求动表必须真跑 test:db。执行方与我都没有 Docker/库连接。而且 grep test:db .gitea/workflows/backend-quality-gate.yml 无命中——门禁也不跑 DB 套件，这条目前没有任何自动化覆盖。需要产品在 staging 用 Migrate Staging Database 流程实跑并确认触发器生效。
标题与 updated_at 修补脚本未执行	frontend/scripts/repair-rectification-session-titles.mjs 默认只读，执行方本机没有 SCHEMA_DATABASE_URL，staging 未跑，损坏面数字还空着。需要产品先不带参数跑看行数，确认后加 --apply。
浏览器 / 真机走查	docs/testing/rectification-open-identity-20260915.md、docs/testing/rectification-tiebreak-card-loss-20260915.md
生产	已核对 7b620c7a 没有 use-rectification-surface.ts，不受改名影响，任务 3 不必在生产跑。updated_at 回填是否在生产做由产品定，默认不必。