Jyotisha/docs/tasks/PROGRESS-report-longform-parity-20260905.md

PROGRESS · 长报告对齐全量版并挂入产品（2026-09-05）

工作树：/Users/jesse/Downloads/Copse/astrology/.worktrees/report-longform-parity-20260905 分支：codex/report-longform-parity-20260905 基线：任务书写 d2955c62 之后；开工 origin/staging 为 3fd001ca（含本任务书）；收尾已快进到 18a5a488。 任务书：仓库根 TASK-report-longform-parity-20260905.md 未改 .gitea/workflows/**，不提升 main，不反向同步上游 yinduzhanxing，未把两份真实对标报告入库。 五章 writer / bundle / schema 未改。附录失败不改 personal_reports.status、不触发退款。

并行队列：BUG-535 chart-cap 已在 staging 4ef4c406 / 73c2a1a5 关闭并真实五章 ready，本轮未重做。

任务	状态	说明
0 全量时长与覆盖基线	完成	虚构北京盘；同步生成，不改异步 job
1 调用面 / 装配对齐	完成	三年年度、KP 月度、五系统表、专题三表、Upagraha、KP Lord/Sub、功能吉凶
2 年度层 Muntha / Mudda / Patyayini	完成（诚实标签，见下）	未把 blocked/conflict 涂成可读
3 校时敏感层	完成	无窗「未做校时」；有窗走 provisional + candidate_range
4 成品阅读导航	完成	生成器确定性产出，不依赖 Agent 后处理
5 产品附录存储 + 下载入口	完成	首次请求同步生成 + 缓存；maxDuration=300
6 部署后真实核对	未做	待 staging 部署后按覆盖表抽查

任务 0 · 虚构北京盘 smoke

出生资料按任务书：1990-01-01 12:00，39.9042, 116.4074，tz 8，Raman，--today 2026-09-05 --target-year 2026 --pack full --format markdown。产物只在 /tmp/longform-parity-20260905/，不入库。

指标	装配前（同盘）	本轮装配后
墙钟	20.67s	7.64s
体积	250,819 B / 2605 行 / 155 标题	282,502 B / 2965 行 / 178 标题
旧 Web 参考版	约 188K / 2088 行	已超过
skill 全量版	约 391K / 3634 行	仍薄一截，剩余主要是受限材料与未 vendor 的 professional_parity_closure

止损：单次远低于 5 分钟，任务 5 保持同步生成 + 表缓存。maxDuration = 300 足够。

覆盖对照（标题结构，虚构盘）

差距项	装配后	状态标签
成品阅读导航五块	present	质量门本次 blocked（37/49 passed），不改写正文
2026/2027/2028 年度重点	present	年度层可读壳
大运与时间主线五系统表	present	Vimshottari / Narayana / Yogini / Ashtottari / Kala Chakra 均为 executed + parameter_sensitive
KP 三年流月 + 重点月份	present	parameter_sensitive
Muntha	present	conflict（solar_return 与 tajika 同 profile 不一致，保持仲裁标签）
Mudda Dasha	present	executed / partial_verified
Patyayini	present（外部回放段）	回放 pyjhora_behavior_only / not_multiengine_parity；质量门 patyayini_annual_support=blocked（本地 producer 仍缺）
专题 KP 小表 / 宫位核对 / 月度 MD-AD	present	parameter_sensitive
功能性吉凶与 Yogakaraka	present	used
Upagraha 表	present	parameter_sensitive
KP Lord/Sub、Ruling Planets、ABCD	present	parameter_sensitive
出生时间敏感度 / 未做校时	present	not_rectified
质量门对照表若干受限层	missing	restricted_or_unclosed：jaimini_special_points / tajika_named_yoga / annual_sahams / kranti / alternate_ashtottari（正文另有本地 Saham/Jaimini 段，质量门走受限材料路径，未涂成 closed）

实现要点

引擎调用面

• _export_args 与 API _high_rigor_birth_payload 默认 today / target_year / age；age 不再重复 kwargs。
• cmd_full_reading 补 cmd_kp、_build_natal_foundation_modules（panchanga / upagrahas / bhava_chalit / moon_chart / sudarshana / functional_benefic_malefic）、varga_research_high。
• cmd_kp 算完立即把 Swiss Ephemeris 岁差从 KP 恢复到报告口径（默认 Raman），避免后续本命模块被带跑。
• professional_parity_closure 未 vendor（约 3500 行）。dasha_master_pack 装配失败时用本地 Vimshottari / Narayana / Yogini / Ashtottari / Kala Chakra 填五系统表，不假装外部 dasha oracle 已闭环。
• 无候选窗时 birth_time_sensitivity 保留为 not_rectified /「未做校时」，不再整段消失。
• 成品阅读导航由 _render_finished_reading_navigation 写出。

产品附录

• 迁移 frontend/supabase/migrations/20260905010000_personal_report_longform_appendices.sql：PK=report_id，另有 (user_id, request_id) FK；owner SELECT；service_role 写；错误码无正文。未双写冻结的 frontend/db/migrations。
• POST /api/reports/[reportId]/professional-reference：runtime=nodejs，maxDuration=300；鉴权/同源/本人/主报告 ready 不变；缓存命中直接返回；unavailable → 503「全量数据附录暂不可用」；payload 带 packs:["full"]、today/target_year/age、有窗则 birth_time_accuracy=provisional。缓存写入失败不阻断下载，也不改 personal_reports。
• UI：报告中心与阅读页按钮改为「全量数据附录」；打印通道仍独立。

测试与门禁

• 定向 pytest（test_report_longform_parity + 参考导出 / quality gate / 生时敏感 / KP monthly / calculation profile / annual pack）：全部绿，3 skipped（未 vendor 的 dasha-master gate）。
• ./node_modules/.bin/tsc --noEmit：0
• 定向前端：professional-report-reference-route + personal-report-longform-appendix + entry/view 相关：通过
• tests/database-personal-report-longform-appendices.test.ts：1 pass（owner 可读、他人 0 行、authenticated 不能 insert、appendix unavailable 后 personal_reports.status 仍 ready）
• 未改 .gitea/workflows/**；未跑全量 npm test / 未提升 main。bab07187 的 staging 质量门因此在 database-local-business 表白名单上失败（BUG-548）
• 任务 6 部署后真实用户附录未做

门禁修复（BUG-548）

Gitea run 2416 / job 5696 validate：npm test 唯一失败是 local PostgreSQL applies the reviewed business schema...。实际名单多了 personal_report_longform_appendices。附录定向库测 ok 951。未改 workflow。

让步

• 未 vendor professional_parity_closure.py。五系统表走本地模块状态；辅助大运明细表仍可能缺 master-pack 周期行。
• Patyayini 本地 producer 仍无；只呈现 PyJHora 回放并保持 pyjhora_behavior_only。质量门继续 blocked。
• Muntha conflict 未做 producer 仲裁。
• 质量门整体 blocked（37/49）。对照表里受限材料 missing 保持 missing。
• 附录是首次点击同步生成，不是后台异步 job。7.64s 墙钟支持该选择。
• 任务 6 必须等 staging 部署。

BUG_HISTORY

BUG-548：staging 质量门因 public 表白名单未含附录表失败；产品行为未改。BUG-535 保持 resolved。