osmWorkflow/.trellis/tasks/archive/2026-08/08-25-rc-p2-repo-split/implement.md

Phase 2 执行计划

执行前提：用户已在最新 P2 规划摘要后明确批准。发布目标已定为私有 https://git.app.que01.top/que01/road-compiler.git，首发 tag 为 v0.1.0。

1. 导出并核验历史

• 创建临时 export 分支或临时 clone，使用 git subtree split --prefix=packages/road-compiler 或 git filter-repo --path packages/road-compiler/ --path-rename packages/road-compiler/: 导出。
• 在导出仓库验证 git log --follow src/compile/native-road.js 包含 2026-08-13 以来的 native compiler 历史。
• 在私有 https://git.app.que01.top/que01/road-compiler.git 创建并推送独立仓库；创建带注释的 v0.1.0 tag。

2. 使编译器仓库自持

• 将 CLI 作为 package bin 入口，接受由宿主写出的 RoadCompilerInput JSON，并继续输出唯一的 NATIVE_ROAD_COMPILE_DONE JSON 标记。
• 补全 package.json、锁文件和 ol 依赖；workbench vendor 文件从自身安装目录提供。
• 迁入 docs/native-road-package-v1.md、两个 baseline 和它们的测试驱动，新增独立 README。
• 在不含宿主文件的临时 clone 内执行依赖安装、单元测试、两区域 parity 与 workbench 启动测试。
• grep 验证没有 area-config、config/areas、宿主项目名或宿主相对路径引用。

3. 宿主改为外部 CLI 消费

• 将 compiler 以精确 git tag v0.1.0 安装到宿主并记录 lockfile；禁止范围版本、latest、* 和裸分支。
• 将 toRoadCompilerInput() 序列化到每个区域的 pipeline staging 目录，传给 compiler CLI。
• 在 build-area.js 的 blender 前置阶段调用 CLI。沿用管线的 spawnSync / runCommand 失败语义（启动错误、exit status、signal）和直通日志；缓冲或 tee stdout 后，解析恰好一个完成标记并验证其 areaId、output 与当前区域匹配。
• 将 host workbench 的 fresh compile 回调切换到同一 CLI，不改变 fresh-process 行为。
• 把所有 host 对 packages/road-compiler/** 的直接 import 替换成已安装包的公开 API 或 CLI；两个区域 parity 均通过后删除 in-host 副本。
• 将宿主 pipeline spec 改为指向编译器仓库所拥有的契约文档。

4. 验证与发布门

新仓库（干净 clone）：

npm ci
npm test
npm run test:road-parity
npm run road:workbench -- --config test/fixtures/fengshu-er-road.input.json --no-compile

宿主两个有效区域的逐字节 parity：

node scripts/road-parity.js --config config/areas/fengshu-er-road.json \
  --compare .trellis/tasks/08-25-road-compiler-extraction/baseline/fengshu-er-road.json
node scripts/road-parity.js --config config/areas/nantaizi-lake-innovation-valley.json \
  --compare .trellis/tasks/08-25-road-compiler-extraction/baseline/nantaizi-lake-innovation-valley.json

• 为 CLI 标记成功、缺失、重复、非法 JSON、areaId 不匹配和 output 不匹配补测试。
• 跑 package 单测、宿主 native-road / workbench / traffic signals / turn-lane-arrows 测试，以及两个 parity 检查。
• 使用 trellis-check 做最终跨层检查；Blender 完整构建需以提权方式运行，原因是 macOS Metal 初始化不能在沙箱内启动。

Rollback

• 外部仓库和已发布 tag 保留不动；在宿主 revert 消费改造即可回到 P1 边界。
• 若按决定临时保留 in-host 副本，可将依赖回指该副本以恢复；该退路不取代 host parity 验证。