fix: restore upstream sync consultation contracts
This commit is contained in:
Jesse_Chen
@@ -0,0 +1,113 @@
|
||||
# PROGRESS · 上游同步验收修复单（2026-09-04）
|
||||
|
||||
任务书：`TASK-upstream-sync-fix-20260903.md`
|
||||
工作树：`/Users/jesse/Downloads/Copse/astrology/.worktrees/upstream-sync-fix-20260903`
|
||||
分支：`codex/upstream-sync-fix-20260903`
|
||||
实际开工基线：`origin/staging` @ `779717f48c7ce08f9c731663f2203dae19c250c3`
|
||||
原任务书验收基线：`origin/staging` @ `c1e3f32a`
|
||||
|
||||
当前状态：本地修复与验证完成，改动仍在独立工作树且未提交。本记录未声明提交、推送或部署完成。
|
||||
|
||||
## 1. 非原生主题恢复 `degraded`
|
||||
|
||||
`scripts/jyotish_api_server.py` 重建 `ai_prompt_pack` 时，先合并既有 `evidence_snapshot`，再刷新本次请求的 birth / ayanamsa / core 等字段。这样不会丢掉上游已装配的 `strict_workflow_contracts`，报告适配器仍可识别 `upstream_contract_available=true`。
|
||||
|
||||
预期合同：
|
||||
|
||||
- `general` / `timing` / `family` / `education` / `migration` / `annual`：`degraded`；
|
||||
- 上述主题的 adapter：`upstream_contract_available=true`；
|
||||
- `career` / `marriage` / `wealth` / `health`：继续为 `supported`。
|
||||
|
||||
真实 HTTP 十主题 smoke 全部返回 HTTP 200：`career` / `marriage` / `wealth` / `health` 为 `supported`；`education` / `migration` / `family` / `annual` / `timing` / `general` 为 `degraded`，且六个非原生主题的 `upstream_contract_available=true`。耗时 70.82s，脱敏结果保存于 `/tmp/upstream-sync-fix-http-smoke.json`；本地 API 已停止。
|
||||
|
||||
## 2. finance 严格证据口径
|
||||
|
||||
### Yogi / Avayogi 断言取舍
|
||||
|
||||
| 原值 | 新值 | 原因 |
|
||||
| --- | --- | --- |
|
||||
| Yogi 点公式为 `Sun + Moon` | `Sun + Moon + 93°20′`；`formula_profile=pyjhora_yogi_sphuta_v1` | 接受任务书决策：旧公式漏掉 Pushya 起点常量，改为 PyJHora Yogi Sphuta 标准式。 |
|
||||
| Avayogi 由旧 Yogi 点派生 | `Yogi + 186°40′` | 与新的标准 Yogi Sphuta 点配套计算。 |
|
||||
| 示例 Yogi 点 `20° / Bharani / 1宫` | `113.3333° / Ashlesha / 4宫`；Avayogi 点锁定 `300°` | 同一虚构夹具按标准公式重算后的确定性结果，不保留旧错误期望。 |
|
||||
| `Yogi=Venus`、`duplicate_yogi=Mars`、`Avayogi=Saturn` | `Yogi=Mercury`、`duplicate_yogi=Moon`、`Avayogi=Mars` | 点位重算后对应星曜随之变化。 |
|
||||
| `level=strong`，存在 `lagna_yogi_tight_orb`、`yogi_planet_is_2l` 和三条 strong signals | `level=weak`，距离 `93.3333°`，tight-orb / wealth-lord links / signals 为空 | 新点位不再满足旧强钩子条件，弱 Yogi 不得抬高财富主判据或写入 `yogi_active`。 |
|
||||
| `primary_source=dhana_yogi_hooks`、source diversity `2`、支持源 `dhana+yogi` | `primary_source=dhana_yogas`、source diversity `1`、支持源仅 `dhana` | Yogi 仅作 modifier；该夹具的新 Yogi 为 weak，不能计作独立财富支持源。 |
|
||||
|
||||
### D11 与 confidence cap
|
||||
|
||||
- `d11_rudramsa` 保留在 finance 证据包中，但定位为**支持项**，不是严格证据的必需项，也不是主判据。
|
||||
- `wealth_promise_strength` 继续作为财富承诺的主判据。
|
||||
- `confidence_cap` 回归根因：finance 的 `missing_evidence` 过滤表未把新增的 `d11_rudramsa` 列入非阻断证据。结果是没有 D11 时，即使 Shadbala 分量完整，也会被误判为缺必需证据并把 cap 从 `medium-high` 压到 `low`。
|
||||
- 修复：把 `d11_rudramsa` 纳入非阻断集合；不改完整 Shadbala 用例原有的 `medium-high` 断言。
|
||||
- MCP 公开边界继续使用 `finance`：统一路由器内部 canonical `wealth` 会映射回公开名称；当 `annual` / `timing` 时间词先命中、但问题同时有明确财富关键词时，在 MCP strict 边界以 `wealth` 重新解析，避免漏装 finance 的 VedAstro / external evidence。
|
||||
- 旧 source-pack 元数据恢复到当前 Next.js 真路径：`frontend_interpretation_layer` 指向 report interpretation packs，`frontend_planet_house_details` 指向 `personal-report-generation.ts`，覆盖仍为 `9_planets_x_12_houses`。
|
||||
|
||||
对应 Bug：`BUG-515`。
|
||||
|
||||
## 3. 模板注册表引用取舍
|
||||
|
||||
没有复制缺失的 `references/mevg_chinese_full_layer_and_practice_audit_2026_08_26.md`；四个模板保留，改指向仓内已有且语义直接匹配的规范：
|
||||
|
||||
| 模板 | 新引用 | 取舍理由 |
|
||||
| --- | --- | --- |
|
||||
| `dual_luminary_timing_context` | `references/transit-comprehensive-guide.md` | 模板要求 Moon、Lagna/Sun、Dasha 与 transit 的交叉检查，综合行运指南比缺失的通用审计文档更直接。 |
|
||||
| `seventh_house_topic_split` | `references/house-domain-planet-mapping.md` | 模板核心是区分婚恋、合同、公众与对手等七宫主题，宫位—领域映射是本仓直接真源。 |
|
||||
| `empty_window_not_success` | `references/prediction-boundary-protocol.md` | “没有阻碍不等于成功”属于预测边界与置信度约束，应由边界协议承载。 |
|
||||
| `dasha_boundary_not_event_date` | `references/mandatory-verification-gate-protocol.md` | 换运边界不能直接写成事件日，需要多重 Dasha、transit、命盘承诺及外部验证门共同收敛。 |
|
||||
|
||||
其余 `source_refs` 保留不变。
|
||||
|
||||
## 4. quick CORE 扩列
|
||||
|
||||
`scripts/run_quality_gate.py` 的 `CORE_PYTEST_TARGETS` 新增：
|
||||
|
||||
- `tests/test_consultation_workflow_domains.py`
|
||||
- `tests/test_mcp_strict_workflow_finance.py`
|
||||
- `tests/test_interpretation_template_registry.py`
|
||||
- `tests/test_vedastro_external_technique_evidence.py`
|
||||
|
||||
目的：让本次发现的主题合同、finance 严格证据、模板引用与 VedAstro 外部证据回归进入自动 staging 快速门，而不是只在全量测试中暴露。
|
||||
|
||||
## 5. 本地验证实证
|
||||
|
||||
### 聚焦 pytest
|
||||
|
||||
以下集合共收集并通过 88 条测试，墙钟耗时 31.71s：
|
||||
|
||||
- `tests/test_consultation_workflow_domains.py`：31 条；
|
||||
- `tests/test_mcp_strict_workflow_finance.py`：37 条；
|
||||
- `tests/test_interpretation_template_registry.py`：2 条；
|
||||
- `tests/test_vedastro_external_technique_evidence.py`：10 条；
|
||||
- `tests/test_api_server_growth_contract.py`：3 条；
|
||||
- `tests/test_consultation_engine_field_bridge.py`：5 条。
|
||||
|
||||
### 模板 validator
|
||||
|
||||
`scripts/validate_interpretation_templates.py` 退出 0：`valid=true`、`problem_count=0`、`template_count=15`（约 0.04s）。
|
||||
|
||||
### quick gate
|
||||
|
||||
首次运行因独立 worktree 没有安装前端依赖而在 `npm test` 报 `tsx: command not found`；执行 `npm ci` 后重跑通过。没有运行 `npm audit fix`，避免把依赖升级混入本修复单；`frontend/node_modules/` 受 `.gitignore` 排除，不是交付文件。
|
||||
|
||||
最终结果：
|
||||
|
||||
- Python CORE：585 passed、1 skipped、183 warnings；
|
||||
- 前端测试：2628 passed、0 failed、0 skipped；
|
||||
- lint：0 errors、74 warnings；
|
||||
- Next build：通过；
|
||||
- `scripts/run_quality_gate.py --profile quick`：退出 0，墙钟 575.45s。
|
||||
|
||||
完整日志：`/tmp/upstream-sync-fix-quick-gate.log`。
|
||||
|
||||
### 文件守卫
|
||||
|
||||
- `scripts/jyotish_api_server.py`：11200 行，与 `HEAD` 同文件行数一致，满足“不增长”红线；
|
||||
- `git diff --check`：通过；
|
||||
- `frontend/node_modules/`：无 Git tracked 文件。
|
||||
|
||||
## 交付边界
|
||||
|
||||
- 本工作树改动目前**未提交**。
|
||||
- 未 push 到任何远端；`origin/staging` 未因本工作树前进。
|
||||
- 未触发 CI、迁移或部署。
|
||||
- 未检查或声称 staging `/api/health` 已包含本修复。
|
||||
@@ -99,7 +99,7 @@
|
||||
| 任务书 | 进度 | 主题 | 状态 | 落点 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| `TASK-upstream-sync-20260903.md` | `PROGRESS-upstream-sync-20260903.md`、`PROGRESS-upstream-capabilities-20260903.md` | 上游快照推进到 `a6f47abd`、引擎三方合并、health 三窗 / VedAstro REST 桥 / 专业报告导出 / 新字段接聊天与报告 / 校正解冻三项 | 已验收（带修复单） | 0/1/2/4/6：`45d13258`、`f2241463`、`734d2059`；3/5/7：`c2f23131`～`6063c1f7`（BUG-514）。staging 已部署 `6063c1f7`。未过项全在 `TASK-upstream-sync-fix-20260903.md` |
|
||||
| `TASK-upstream-sync-fix-20260903.md` | — | 非原生主题合同回 `degraded`（**P1，已随 6063c1f7 上 staging：timing/general 主题回执 blocked**）、finance 严格证据口径与 confidence_cap（7 红）、模板注册表缺引用（4 problems）、vedastro 外部证据 4 红、门禁 CORE 扩列 | 待领取 | 分支 `codex/upstream-sync-fix-20260903`；2026-09-04 复核：任务 3/5/7 合入后本单各项仍原样 |
|
||||
| `TASK-upstream-sync-fix-20260903.md` | `PROGRESS-upstream-sync-fix-20260903.md` | 非原生主题恢复 `degraded`、finance Yogi/D11/confidence cap、模板注册表引用、VedAstro/MCP finance 路由与 quick CORE 扩列 | 本地验证完成 | 独立 worktree 基线 `779717f4`；BUG-515。88 条聚焦回归与 quick gate 通过，十主题 HTTP smoke 符合合同；未提交、未推送、未部署 |
|
||||
|
||||
## 命名与归档
|
||||
|
||||
|
||||
Reference in New Issue
Block a user