Jyotisha/docs/tasks/PROGRESS-report-candidate-range-20260904.md

PROGRESS · BUG-526 报告链路不得直读已收权的校正表（2026-09-04）

工作树：/Users/jesse/Downloads/Copse/astrology/.worktrees/report-candidate-range-20260904 分支：codex/report-candidate-range-20260904 基线：任务书写 cce919fe；开工 origin/staging HEAD 为 846b6064（含本任务书）。 任务书：仓库根 TASK-report-candidate-range-read-20260904.md 未恢复 service_role 表级权限，未改表/列/RLS/既有 grant，未改 worker 其余生成管线，未改 .gitea/workflows/**，不提升 main。

任务	状态	BUG
1 两处读取降级 + 语义修正	完成	BUG-526
2 只读 RPC + test:db	完成（本文件定向套件已绿；全量 test:db 见下方门禁输出）	BUG-526
3 部署后真实 personal_full	进行中（引擎已通；被 BUG-534 打断）	BUG-526 / BUG-534
4 BUG-526 收口	完成（修复版本待 staging SHA）	BUG-526

实现要点

• 共享 helper frontend/src/lib/report-candidate-range.ts：只调 read_report_candidate_range。permission denied / 抛错 → warn（仅 event + reason 错误码）→ null；空行 → null 且不 warn。非法时钟或 start > end 也当无窗口。
• worker generate 与 POST /api/reports 的 loadCandidateRange 都走 helper，不再 from("agentic_rectification_cases") / from("birth_time_rectification_cases")。
• 迁移 20260904010000_read_report_candidate_range.sql：security definer、search_path=''、revoke public/anon/authenticated、grant execute 只给 service_role。返回值只有 start_time / end_time。
• completed 枚举： 任务书以为它不在 birth_time_rectification_cases 状态枚举里。20260720010000_conversational_rectification_schema.sql 已纳入 confirmed 与 completed 两个终态。RPC 使用这两值；前端不再维护一份 .in("status", …) 列表。abandoned 不取窗。

测试

• tests/report-candidate-range.test.ts：permission denied / throw / 空行三态；合法窗；敏感度输入无窗口；源码锁两处调用。
• tests/personal-report-api.test.ts：loadCandidateRange 返回 null 时 create 仍 201，不是 calculation_unavailable。原「只信 confirmed/completed 直读」改为 RPC helper 源码锁。
• tests/database-report-candidate-range.test.ts：service_role 可 execute，anon/authenticated 不可；表 SELECT 仍 denied；无行返回空；窗口 JSON 只有两列；legacy confirmed 行优先。

让步

无。未 re-grant 表权限。

门禁解堵

7ee7f825 的 CSS 合同脱节已由 0be51e65 / BUG-532 合入 staging，本单不再改那条测试。

门禁输出

• ./node_modules/.bin/tsc --noEmit：0
• npm run lint：0 error / 74 warning（既有，未动）
• 定向：report-candidate-range + personal-report-api + personal-report-worker + migration 源码锁 75 pass
• npm run test:db（tsx --test --test-concurrency=1 tests/database-*.test.ts）：35 pass, 0 fail（含新 RPC 套件）。第一次全量 34/35，database-admin-identity 迁移在套件开头失败，单跑即过，属 Docker 争用。
• 非数据库 tsx --test tests/*.test.ts：2626 pass；当时 2 fail 为 CSS 合同（已由 0be51e65 修）与 identity-auth-integration（与并行 test:db 抢 fixture，单跑已过）。

任务 3 · staging 实测（be6cf145）

health：gitCommit=be6cf145，latestMigration=20260904010000_read_report_candidate_range.sql。RPC 对 candidate_accepted 行返回窗口。无 report_candidate_range_unavailable。

request 3c4d8311-d222-494b-8174-b8e731204fd2（standard 五主题）：

项	结果
创建	generating，未在 16 秒内 calculation_unavailable
引擎	5× POST /api/consultation_workflow 200（11:48:17–11:50:03Z）；租约恢复后又 5×
章节	theme-career ready 1776 chars；theme-health_pressure ready 1581 chars（attempt 2）
telemetry	career finishReason=stop inputTokens=5866 elapsedMs=10765；health 首次 tripwire×2（无 length）
阅读页	GET 500 report_generation_failed（假失败）

随后 worker 心跳停在 section:theme-health_pressure。根因是 BUG-534：recordFromRow 不接受 section:。为避免第三次租约耗尽把报告标成 calculation_unavailable，将该 job 租约延长到 15:06Z，等 534 部署后再过期恢复。