fix(report): accept section: job progress phases on read-back
Independent Staging Quality Gate / validate (push) Successful in 8m41s
Independent Staging Quality Gate / publish (push) Successful in 1m53s

Heartbeat and GET were parsing progress_phase with a pattern that rejects the colon prefix the writer already persists, which aborted generation after the first chapter.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Jesse_Chen
2026-09-04 20:09:11 +08:00
parent a793edb1ad
commit e27d5dc5a7
5 changed files with 57 additions and 4 deletions
+18 -2
View File
@@ -8125,9 +8125,9 @@
- 触发条件:资料 `birth_time_status``accepted`(不是 `confirmed`),worker 与 create route 因此去查 `agentic_rectification_cases``candidate_accepted` 行。
- 根因:`20260814010000_immutable_skill_registry.sql` 已从该表收回 `service_role` 的表级权限,只许走 security definer RPC。报告链路仍 `from("agentic_rectification_cases").select(...)`。Postgres 三次 `permission denied for table agentic_rectification_cases`(与 job 三次 attempt、默认 5s/10s 重试对齐)。查询失败被映射成可重试 `calculation_unavailable`,报告从未调用引擎。第二读者:create route 同样 `if (error) throw error`,会把创建请求打成 `calculation_unavailable`
- 修复:新增只读 RPC `read_report_candidate_range`(不 re-grant 表权限)。worker 与 create route 经共享 helper 调用;任何读失败降级为无窗口并继续生成。`calculation_unavailable` 只保留给引擎调用失败。legacy 表终态以库约束为准:`confirmed``completed``20260720` 已纳入枚举;前端不再 `.in("status", ["confirmed", "completed"])` 直查)。
- 验证:`tests/report-candidate-range.test.ts` 三态降级;`tests/personal-report-api.test.ts` null 窗口仍 201`tests/database-report-candidate-range.test.ts` 权限矩阵与列白名单。产品侧真实 personal_full 待本修复部署后补。
- 验证:`tests/report-candidate-range.test.ts` 三态降级;`tests/personal-report-api.test.ts` null 窗口仍 201`tests/database-report-candidate-range.test.ts` 权限矩阵与列白名单。staging @ `be6cf145`accepted 档案 `personal_full` 五次 `POST /api/consultation_workflow` 均 200career 章已落库;随后被 BUG-534 打断,完整 ready 待 534 部署后补。
- 防复发:报告 worker 与 create route 不得再直接 SELECT 已收回 `service_role` 权限的校正表;候选窗读失败不得再变成 `calculation_unavailable`
- 相关记录:BUG-524
- 相关记录:BUG-524、BUG-534
- 复发自:无
- 修复版本:待发布
- 编号说明:rebase 到 `origin/staging` 时 BUG-525 已被采集拒答占用,本条落在 BUG-526。
@@ -8244,3 +8244,19 @@
- 相关记录:无
- 复发自:无
- 修复版本:待发布
## BUG-534 | 分章进度 `section:` 让 job 行无法 round-trip,心跳中断、阅读页误报失败
- 状态:resolved
- 首次发现:2026-09-04
- 最近更新:2026-09-04
- 影响面:`personal-report-job-service-core` `recordFromRow`;心跳 RPC 返回解析;`GET /api/reports/:id` 读 generating 行
- 用户现象:standard personal_full 已经调到引擎并写出至少一章后,阅读页变成 `report_generation_failed` /「报告暂时无法读取」。后台 job 停在 `section:theme-*`,心跳不再刷新,直到租约过期才重试。
- 触发条件:worker `onProgress``progress_phase` 写成 `section:<section_id>`SQL 与 `isValidPersonalReportJobProgressPhase` 允许冒号)。随后心跳或 GET 把该行再读进 `recordFromRow`
- 根因:`recordFromRow``operationalCodePattern``^[a-z][a-z0-9_]{0,63}$`)校验 `progress_phase`,不接受冒号。`updateProgress` 写入成功后解析 RETURNING 行抛 `storage_invalid``onProgress` 吞掉非租约错误,生成继续。下一次心跳解析同一行再抛,worker 中止。GET 同一路径变成 HTTP 500。
- 修复:`progress_phase` 改走已有的 `isValidPersonalReportJobProgressPhase`(与 SQL check、写入校验同一套,允许 `section:`)。
- 验证:`personal-report-job-service`:写入 `section:theme-health_pressure` 后心跳与 `getOwnedByRequestId` 仍成功。
- 防复发:job 行 round-trip 不得比写入校验更严。分章进度相位必须能读回。
- 相关记录:BUG-526
- 复发自:无
- 修复版本:待发布