osmWorkflow/.trellis/tasks/08-25-rc-p2-repo-split/prd.md

Phase 2：拆仓库

父任务：.trellis/tasks/08-25-road-compiler-extraction/ 技术设计：父任务 design.md §1.3（消费方式）、§2（模块清单）

Goal

把 packages/road-compiler/ 拆成保留 git 历史的独立仓库， 宿主改为锁版本依赖 + 子进程调用消费。

Requirements

R2.1 保留 git 历史 🔴

• 用 git subtree split 或 git filter-repo 拆出，不得用 cp + git init
• 理由（父任务 R3.2）：1695 行几何逻辑的 blame 是踩坑记录， 丢了以后没人敢改 compileGeometry 里任何一行
• 验证：新仓库内 git log --follow src/compile/native-road.js 能看到 08-13 native-road-compiler 以来的完整历史

R2.2 子进程为主契约

• 宿主 build-area.js 改为 execFileSync 调编译器 CLI， 解析 NATIVE_ROAD_COMPILE_DONE stdout 标记（父任务 design §1.3）
• in-process require 可保留为可选优化路径，但不得是唯一路径
• 与既有 QGIS / GDAL / Blender 调用方式一致 （见 .trellis/spec/pipeline/external-tools.md）

R2.3 锁版本依赖

• 开发期：file: 或 workspace 依赖
• 稳定后：git tag / 私有 npm，宿主 package.json 锁具体版本，不用 latest
• 契约版本 native-road-package/v1 与包版本分开演进： 包可以发 patch，契约版本只在破坏性变更时升

R2.4 K4：workbench 依赖自持

• road-workbench 的 OpenLayers 从新仓库自己的 node_modules 提供
• import map 路径相应调整

R2.5 基线迁移

• Phase 0 的三区域基线 JSON 搬进新仓库当测试语料（父任务 R4 第三条）
• 新仓库 CI/test 能独立跑 parity，无需宿主在场
• 同时宿主保留一份，用于验证升级编译器版本后产物未变

R2.6 契约文档迁移

• docs/native-road-package-v1.md 搬进新仓库
• 宿主 .trellis/spec/pipeline/ 留指针，说明契约由编译器仓库拥有

Acceptance Criteria

• AC2.1 新仓库 git log --follow 能追到搬迁前的历史
• AC2.2 新仓库 npm test 在未 clone 宿主的机器上通过
• AC2.3 宿主从锁版本依赖构建，三区域 parity 对基线全绿
• AC2.4 build-area.js 走子进程路径，NATIVE_ROAD_COMPILE_DONE 被正确解析
• AC2.5 宿主 package.json 依赖为具体版本，非 latest / 非 *
• AC2.6 编译器仓库对宿主反向依赖数为 0（父任务 AC8，grep 验证）
• AC2.7 npm run road:workbench 在新仓库内独立可跑

依赖与顺序

• 前置：Phase 1 完成且 AC1.1–AC1.8 全绿
• 阻塞：Phase 3、Phase 4

待决策（进入本阶段时定）

项	选项
仓库名	road-compiler / native-road-compiler / osm-road-compiler
托管	GitHub 私有 / 公开 / 内部 git
分发	git tag 依赖 / 私有 npm registry
宿主过渡期	是否保留 packages/road-compiler/ 一段时间做双跑对照

Out of Scope

• layer manifest（Phase 3）
• drawtonomy 扩展（Phase 4）
• 任何编译器内部逻辑改动 —— 本阶段代码内容不变，只换位置与消费方式