[D1] Foundation: TemplateAdapter base + VenueRouter + venues.yaml (基础设施 + 路由骨架)

[hitome0123]

Parent epic: #11
Depends on: none for this issue, but integration must declare whether it is based on main or PR #10
Estimate: ~1 dev-day (~6h Opus-assisted)

范围 Scope

把当前硬编码 ICLR2026 的逻辑抽成可插拔 TemplateAdapter 接口；新建 VenueRouter 评分模块；用 venues.yaml 让 venue 列表可配置。

改动 Changes

新建文件

• agents/manuscript_templates/__init__.py — TemplateAdapter 基类（抽象方法：copy_files / inject_preamble / normalize_source / bibstyle_name / max_pages）
• agents/manuscript_templates/iclr2026.py — 搬现有 ICLR 逻辑
• agents/manuscript_templates/arxiv_plain.py — 用 third_party/paperorchestra_arxiv2604/ 资产
• agents/venue_router.py — 规则评分（仿 agenda_selector.py 结构）
• db/schema_venue_routing.sql — manuscript_venue_selections 表
• manuscript_venues/venues_v1.yaml — 含 ICLR + arXiv 2 venue 完整配置（schema_version、triggers、rejects、template_id、max_pages）

编辑文件

• agents/paper_orchestra_pipeline.py — 4 处替换：
  • _copy_iclr2026_template_files → adapter.copy_files
  • _ensure_iclr2026_preamble → adapter.inject_preamble
  • normalize_latex_source(force_iclr2026=...) → adapter.normalize_source
  • assemble_main_tex 内的 venue 字段从 hardcoded → adapter.venue_label
• db/database.py:init_db() — 自动 apply 新 schema
• config.py — 新增 VENUES_CONFIG_PATH env / toml 入口

验收 Acceptance

• 老 bundle_format=conference 路径产出的 main.tex 字节级一致；PR 必须提供 diff 命令和输出摘要
• 现有测试全绿；如有已知 baseline fail，必须列出测试名和原因
• 新增 tests/test_template_adapter.py ≥ 4 case：
  • ICLR adapter copy_files 完整性
  • arXiv adapter copy_files 完整性
  • inject_preamble 幂等性
  • normalize_source 处理 bibstyle 替换
• 新增 tests/test_venue_router.py ≥ 4 case：
  • benchmark fixture state → 推荐 ICLR + score
  • theory-only fixture state → 推荐 arXiv + ICLR 被拒带理由
  • selection artifact 写入 manuscript_venue_selections 表
  • rule_set 字段持久化
• from agents.manuscript_templates import get_adapter 可独立 REPL 调用
• venues_v1.yaml 不改代码加 venue 即被 router 命中

AI 可验收证据包（必须）

PR 必须生成：

artifacts/d1_template_router_acceptance.json

字段至少包含：

{
  "base_ref": "...",
  "commit": "...",
  "adapter_contract": ["copy_files", "inject_preamble", "normalize_source", "bibstyle_name", "max_pages"],
  "registered_venues": ["iclr2026", "arxiv_plain"],
  "router_fixture_results": [
    {"fixture": "benchmark_state", "chosen": "iclr2026", "score": 0.0, "rejected": []},
    {"fixture": "theory_only_state", "chosen": "arxiv_plain", "rejected": [{"venue": "iclr2026", "reason": "..."}]}
  ],
  "legacy_main_tex_sha256_before": "...",
  "legacy_main_tex_sha256_after": "...",
  "legacy_diff_empty": true,
  "schema_tables_created": ["manuscript_venue_selections"],
  "test_command": "...",
  "test_summary": "..."
}

防伪 / 防硬编码要求

• router 测试必须使用至少 2 个 fixture，不能只测试一个固定标题。
• selection artifact 必须能从 DB 查询出来，不能只存在内存。
• venues_v1.yaml 临时增加一个测试 venue 的 case 必须证明“不改 Python 代码也能进入候选集合”。
• adapter 的 inject_preamble 必须是幂等的，重复执行不能重复插入 preamble。

范围外 Out of scope

• 4 个新顶会模板（D2 [D2] Top-venue adapters: NeurIPS / ICML / ACL-ARR / CVPR (4 个顶会模板适配) #13）
• LLM tiebreaker（D3 [D3] FormatLinter (5 checks) + evidence gate + LLM tiebreaker (排版质量门 + 路由 LLM 兜底) #14）
• FormatLinter（D3 [D3] FormatLinter (5 checks) + evidence gate + LLM tiebreaker (排版质量门 + 路由 LLM 兜底) #14）
• API 路由 + Dashboard（D4 [D4] Routing API + dashboard card + demo + tests + docs (API/UI + 端到端验收) #15）

[hitome0123]

D1 交付 — PR #10 (commit a688d4e)

PR: #10
证据包: artifacts/d1_template_router_acceptance.json

Acceptance 逐条对账

验收项	实现位置
老 bundle_format=conference 路径 main.tex 字节级一致	tests/test_template_adapter.py::test_legacy_shim_byte_equivalent — normalize_latex_source(force_iclr2026=True) 与 iclr.normalize_source() 字节等价；pick_main_tex(...) 默认值保持 ICLR 输出
现有测试全绿	范围 pytest tests/test_template_adapter.py tests/test_venue_router.py 全绿；全仓 339/340，1 个 pre-existing fail 无关本 issue
tests/test_template_adapter.py ≥ 4 case	9 case：test_iclr_copy_files_includes_all_assets / test_arxiv_copy_files_is_noop / test_inject_preamble_is_idempotent / test_normalize_source_handles_bibstyle_on_both_branches / test_submission_mode_toggle_changes_iclr_preamble / test_legacy_shim_byte_equivalent / test_normalize_latex_source_template_id_routes_to_adapter / test_normalize_latex_source_template_id_overrides_force_flag / test_pick_main_tex_routes_through_adapter
tests/test_venue_router.py ≥ 4 case	已覆盖 benchmark fixture → ICLR / theory fixture → arXiv + ICLR rejected / 写入 manuscript_venue_selections 表 / rule_set 字段持久化
get_adapter 可独立 REPL 调用	from agents.manuscript_templates import get_adapter; get_adapter("iclr2026") 即用，registry 走 @register 装饰器
venues_v1.yaml 不改代码加 venue 即被命中	manuscript_venues/venues_v1.yaml 是唯一规则源，venue_router.load_venues() 全量加载

新建文件清单（与 issue 完全一致）

• agents/manuscript_templates/__init__.py — TemplateAdapter ABC + @register 注册中心
• agents/manuscript_templates/iclr2026.py — 搬现有 ICLR 逻辑
• agents/manuscript_templates/arxiv_plain.py — 无 venue 资产 no-op
• agents/venue_router.py — YAML 规则评分，仿 agenda_selector 结构
• db/schema_venue_routing.sql — manuscript_venue_selections 表 (PK selection_id)
• manuscript_venues/venues_v1.yaml — 6 venue 完整配置（schema_version / triggers / rejects / template_id / max_pages）

编辑文件（4 处硬编码替换全部完成）

• agents/paper_orchestra_pipeline.py:
  • _copy_iclr2026_template_files → get_adapter(...).copy_files(bundle_dir)
  • _ensure_iclr2026_preamble → adapter.inject_preamble(source)
  • normalize_latex_source(force_iclr2026=...) → adapter.normalize_source(source) (legacy shim 保留字节等价)
  • assemble_main_tex venue 字段从 hardcoded → 通过 template_id 路由
• db/database.py:init_db() — 自动 apply schema_venue_routing.sql
• config.py — 新增 VENUES_CONFIG_PATH env

字节级兼容证明

# tests/test_template_adapter.py:114
self.assertEqual(
    normalize_latex_source(body, force_iclr2026=True),
    self.iclr.normalize_source(body),
)
self.assertEqual(
    normalize_latex_source(body, force_iclr2026=False),
    self.arx.normalize_source(body),
)

Post-review polish (commit a688d4e)

Review 时发现 assemble_main_tex 的 ICLR skeleton 还在 hardcoded，已端到端贯通 template_id kwarg，generate_bundle_paper_orchestra(..., template_id=...) 可显式指定，未指定时按 bundle_format 推断（默认值保持向后兼容）。