# Post-execution daily Ledger handoff

## 状态

- 分支：`codex/post-execution-ledger-20260821`
- 基线：`codex/core-contracts-20260821`（PR #2，尚未获用户确认合并）
- 本分支不得直接合并到 `main`；先等待 PR #2 合并，再整理基线并创建独立 PR。
- 无账户、券商、数据库或实盘副作用。

## 已完成

- 新增稀疏调仓、完整交易日估值的 `simulate_daily_ledger_with_audit()`。
- 显式分离 execution price 与 valuation price，支持下一日 open 成交、当日 close 估值。
- 成交记录补齐 `side / quantity / price`，并提供 `trades_frame`。
- 提供平台中立的 `ledger_frame`，不携带 `run_id`，不写数据库。
- 新增 `run_factor_backtest_research()`：PIT 因子、下一交易日执行、日频 NAV、首日成本收益和标准绩效。
- 研究区间从首条有效信号日开始，排除因子预热行情对绩效的稀释。

## 验证

- `pytest -q --cov=src --cov-report=term-missing`：500 passed，total coverage 91%。
- `mypy --strict src/`：14 source files passed。
- 本阶段文件 scoped Ruff：passed。
- 全仓 Ruff：仅既有 governance tests 的 13 个 PT009 基线问题。
- workspace verify/status：通过；仅提示功能分支不是引导基线 `main`。
- 全局 Gitea workflow check：通过，23 个既有警告。

## 继续步骤

1. 获得用户对 PR #2 的明确合并确认并按 L2 流程合并。
2. 将本分支整理到更新后的 `main`，重新运行相同全量验证。
3. 为 Ledger 阶段创建独立 PR，执行唯一一次最终 `ship --ready`，等待用户确认合并。
4. 后续在 `research_results` 增加业务投影适配器，再由 `research_platform` 持久化和展示；核心层继续保持无数据库写入。