Jyotisha/docs/tasks/PROGRESS-dasha-unify-20261013.md

# PROGRESS · dasha-unify · 2026-10-16

分支 `codex/dasha-unify-20261013`，从 `origin/staging` `b9cbe9aa` 拉出。issue #69。

## 结论

`/api/dasha` 除 Vimshottari 外改为调用完整解读同一批模块。没有真实现的体系返回「未实现」，不再编周期。占位文件 `scripts/extended_dashas.py`、`scripts/conditional_dashas.py` 已删除。Ashtottari 在已判定适用、且月亮落在起运星宿组内时，第一段从出生时刻减去已走过的部分起算。Narayana 仍标「旧算法」，没有换成 Rath 版。

## 映射（最终）

| 注册键 | 实现 |
| --- | --- |
| vimshottari | 原 handler 分支，`domain_calculation_service.compute_vimshottari_timeline` |
| yogini / ashtottari / kalachakra | 与完整解读相同的函数和入参。Ashtottari 额外带月亮经度 |
| panchottari、satabdika、chaturaaseeti、shasti_hayani、shodasottari、dwadashottari、dwisaptati、shattrimsa | 独立模块 `calculate_*`，入参与 `conditional_birth_info` 相同，并带 `PYJHORA_PARENT_SEEDED_EQUAL_SPLIT_PROFILE`。不传强制出表档，不适用的盘主运为空 |
| narayana | `narayana_dasha_full_report` + `label_legacy_narayana` |
| shoola | `rashi_dashas_native.calculate_rashi_dashas` 的 `shoola` 段（`shoola_forward_md_direct_ad_v1`） |
| chara | 400，消息含 `/api/dasha/chara` |
| 其余 | 400，`dasha system not implemented` |

`precision`：权威实现为 `engine_module`。删掉 `generic` 和 `calculator`。

## 基线红 / 修后绿

开工时测试还没写，没有在旧代码上跑新 pytest。占位输出用 `git show HEAD:scripts/extended_dashas.py` 复现（虚构盘、月宿 22）：

| 体系 | 占位前 3 段 |
| --- | --- |
| panchottari | Ketu 1990-01-01、Venus 2002-01-01、Sun 2014-01-01 |
| satabdika | Ketu 1990-01-01、Venus 2001-01-01、Sun 2012-01-02 |
| chaturaaseeti | Ketu 1990-01-01、Venus 1999-01-01、Sun 2008-01-02 |
| narayana | Pisces 3 年、Capricorn 6 年、Aquarius 9 年 |

修后 `tests/test_dasha_api_engine_parity.py`：9 通过，0 失败。接口主运与完整解读同一模块逐项相等。Panchottari / Satabdika / Chaturshitisama 在标准出表档下，主运起始日与 PyJHora 4.8.7 逐日相同。Ashtottari 三张盘（虚构盘走默认规则族，一张公开盘走 Rahu 规则族，另一张公开盘走默认规则族）起止日与 PyJHora 相差不超过 1 天，起运星一致，出生时刻落在第一段内，当前大运与按日期查表一致。

## 自测

| 检查 | 命令 | 结果 |
| --- | --- | --- |
| 任务书 pytest 加年长对齐 | `.venv\Scripts\python.exe -m pytest` 任务书第 8 节文件 + `tests/test_dasha_year_length_alignment.py` | 247 通过，0 失败，退出码 0 |
| release 门 | `.venv\Scripts\python.exe tests\run_all.py` | 102/102，失败 0，0.2 秒 |
| 排盘字节 | 清空 `scratch/local/api_chart_cache` 后 `_compute_chart_sync`，对照开工前基线 | 94348 字节。8 处差异全是语义缓存的 `cache_created_at` / `cache_expires_at`。`available_dashas` 与 `dasha_count` 35 未变 |
| 全量解读字节 | 同一虚构盘、`PYTHONHASHSEED=0`、`VEDASTRO_ENABLE_NETWORK=0`、today 与 transit-date 2026-01-01 | 去掉墙钟字段后 3492 条差异：3490 条在 `modules.ashtottari_dasha`；另外 2 条是顶层 `result_hash` 与 `result_binding.result_hash`（同一哈希，因 Ashtottari 进入绑定载荷）。`input_hash` 未变。其余模块 diff 为空 |

类方法数基线：原值 218，新值 217，原因是删除 `_fallback_dasha_periods`，没有新增方法。行数基线仍是 10924（实测 10906，净减少，不下调基线）。

## T4 年数表

已改为引用 `scripts/dasha_common.py` 的 `VIMSHOTTARI_YEARS`（顺序 Ketu、Venus、Sun、Moon、Mars、Rahu、Jupiter、Saturn、Mercury）。替换前用 `HEAD` 字面量核对 `list(items)` 一致的文件：

- `scripts/jyotish_engine.py` 的 `DASHA_YEARS`
- `scripts/dasha_calculator.py`、`scripts/dasha_calculator_enhanced.py` 的 `VIMSHOTTARI_PERIODS`
- `scripts/vimshottari_subperiod_timeline.py` 的 `DASHA_YEARS`
- `scripts/event_prediction_model.py` 的 `DASHA_YEARS`
- `scripts/nakshatra_dasha.py` 的 Vimshottari 年数表（`calc_ashtottari_dasha` 未改）
- `scripts/prashna.py` 的 `VIM_DURATIONS`
- `scripts/validate.py` 的 `DASHA_YEARS`
- `scripts/kp_system.py` 的年限列表 `[7, 20, 6, 10, 7, 18, 16, 19, 17]`，按原 `KP_LORDS` 顺序取共享表
- `scripts/tajika.py` 两处函数内字面量

未换、也未改：冻结的 `scripts/dasha_analyzer.py`；`scripts/divisional_charts_extended.py` 根上没有这份年数表；`scripts/research/offline_research_20260926_lib.py` 属于研究脚本。六个条件大运的 `_birth_lord_and_balance` 改为一行调用。2000 个固定种子月亮经度与源码副本公式 `==`，0 差异。`shastihayani`、`dwadashottari` 的余额函数未动。

## 冻结文件

`sealed_holdout_rerun` 的 PRODUCTION / RESEARCH 与 `minute_rectification_holdout_v3.json` 的 `frozen_scoring.files` 均未出现在本次 diff 中。未改 `narayana_dasha.py`、`narayana_rath.py`、`narayana_legacy_label.py`、`domain_calculation_service.py`、`dasha_analyzer.py`。

## 历史证据未改

`references/oracle/full_technique_invocation_matrix_2026_07_22.json`、`references/oracle/rectification_missing_layer_integration_plan_2026_07_19.json` 仍写着已删除文件的路径。`references/cross_project_contract/sync_ledger.json` 只提到测试文件名。这些 JSON 不改。

## 偏离

- 入参构造放在 `scripts/dasha_registry.py`，没有从 `cmd_full_reading` 抽出共享函数，避免改动全量解读里 Yogini / Kalachakra 的出生信息。等价由对照测试锁住。
- `scripts/orchestrator_bridge.py` 的 Ashtottari 调用已经从盘面带上月亮经度，这次没有改代码。
- `nakshatra_dasha.calc_ashtottari_dasha`（从 Mars 起算）前端没有读取。全量解读字节对照里它没有变化。留到后续阶段，不在本单替换。
- 新 pytest 没有在改代码之前跑红。红的证据是上面从 `HEAD` 复现的占位输出，加上任务书第 2.1 节的对照表。
- PyJHora 4.8.7 只装在本工作树的虚拟环境里做对照，没有写入依赖清单。