Files

T

Co-Authored-By: Claude Code <noreply@anthropic.com>

2026-09-24 22:02:26 +08:00

PROGRESS · TASK-staging-gate-fix-20260924 · 2026-09-24

基线与范围

基线：origin/staging = 6dc6510c1b789399f9bc6c94b999b63d4e8bb381（任务书记录的代码提交 f125fae0 已在该历史中）。工作树开工前已执行 git status -sb 与 git fetch origin --prune，随后以当前 origin/staging 重置到干净基线。
本轮只执行非破坏性 T1–T3 与允许写入记录；未删除、清空、替换任何 raw-appendix 文件或其测试。T4 保留为用户批准/权限 blocked。
不改 workflow、数据库、依赖、main、DNS、其它 worktree；未 push。

断言	原值	新值	原因
`chat-navigation-a11y-contract.test.ts` bootstrap retry	`window.location.reload()` 硬刷新	断言 `retryHomeBootstrap(...)`，并断言 helper 清空错误、回到账户阶段、调用 provider reload；同时保留 `window.location.reload()` 禁止断言	D2 已批准局部重试；不能把已验收行为改回整页刷新
`new-chat-recovery.test.ts` activation slice	以已删除的 `if (modelCatalogResult.unavailable)` 作终点	以稳定的 `if (parsedSessions.fallbackSessionIds.length > 0)` 作终点	模型失败现走 fatal screen，源码合同不得依赖删除语句
`consultation-recovery.test.ts` bootstrap start	以 `let reservedConsultation ... = null` 作起点	以 `const storedPending = dropRectificationStoredPending(` 作稳定起点	并行预取改变初始化右值，恢复逻辑行为未变
`consultation-recovery.test.ts` pending/global ordering	要求 stored pending 分支源码先于 `fetchActiveConsultationStatus`	仅要求 pending 分支存在并检查其 request/session 参数	T1/D2 将全局状态与模型目录并行预取；源码顺序不再代表优先级，避免锁错误实现形状
`new-chat-recovery.test.ts` / `consultation-recovery.test.ts` shared boundaries	依赖易变语句/初始化形状	使用稳定、行为相关锚点并保留真实函数执行	同型源码脆弱合同再次触发（BUG-933/934/939/992）；不删除测试、不弱化行为断言

modelCatalogResult.unavailable 在 frontend/tests 中应为 0 命中；T4 raw-appendix 测试不触碰。

原值：frontend/src/app/(app)/page.tsx 1858 行（本轮工作树初始 staging）；任务书要求回到任务书基线 edc9c22c 的 1849 行。
新值：将错误屏重试的 5 行状态清理抽到 frontend/src/lib/home-bootstrap.ts 的 retryHomeBootstrap，并合并不改变语义的 import 空白/相邻声明行；page 当前 1847 行，低于任务书要求的 ≤1849。
原因：保持错误屏与局部重试行为不变；仅删除空白并合并 import 声明，不删除业务逻辑或 hook。

原值：仅在 typeof payload.credits === "number" 时调用 notifyBalanceChanged；订阅订单 credits 缺失时不广播。
新值：支付状态 paid 后无条件调用 notifyBalanceChanged(typeof payload.credits === "number" ? payload.credits : 0)。
原因：page.tsx 余额监听只触发 refreshAccount()，支付成功不能因订阅响应缺失点数而静默不刷新；未知余额使用 0 仅作为事件载荷，服务端刷新仍是权威值。既有点数订单行为保持。
回归断言：frontend/tests/billing-panel.test.ts 已从仅检查 credits 类型改为锁定 paid 分支无条件调用，并记录订阅响应缺少 credits 时使用 0 载荷的原值/新值/原因。

raw-appendix 三件套及 frontend/tests/personal-report-raw-appendix.test.ts 原样保留；没有删除、清空、替换或借其它工具绕过权限。
docs/testing/report-reader-actions-20260924.md、docs/tasks/PROGRESS-report-reader-actions-20260924.md 当前未由本轮创建；若权限允许，待用户批准后由协调主会话补齐。T4 删除及其全仓零命中验收均 blocked。

已执行静态 diff、源代码切片检查、行数检查：page 从 1858 降至 1847；git status -sb 干净起步，当前仅本轮列出的代码/测试/记录有修改。frontend/tests 中 modelCatalogResult.unavailable 命中为 0；raw-appendix 三件套仍各有源码命中并保留。
本环境是 Windows，工作树无 frontend/node_modules；tsx、tsc、eslint、next 均不可用，故定向测试、tsc、lint、build 和全量测试未执行，未声称通过。
未找到可用 Linux runner 或 Linux 日志。任务书提供的 Linux 基线：edc9c22c 3807 条、56 条失败；当前 f125fae0 3809 条、61 条失败，新增 5 条名称已列于任务书。本轮无法实际重跑 Linux 全量并逐条 diff，Linux 当前失败名单/新增必须为 0 验收 blocked。
tsc、lint、定向测试、build、Linux 全量测试和失败名单逐条比较均待具备 Node 依赖的 Linux 环境后运行；不得将环境缺口写成通过。

在 Linux/Node 20 环境安装或使用现有依赖，运行全量前端测试并与 edc9c22c 失败名单逐条比较，新增必须为 0。
同环境运行 ./node_modules/.bin/tsc --noEmit、npm run lint、5 条定向测试、npm run build。
用户批准并解除权限后再处理 T4；当前不 push、不部署。