quant_engine/docs/handoff/2026-08-21-post-execution-ledger.md

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 持久化和展示；核心层继续保持无数据库写入。