chore(task): archive 08-19-gaode-junction-reference

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

.trellis/tasks/archive/2026-08/08-19-gaode-junction-reference/implement.md

@@ -0,0 +1,53 @@
+# Validation Implementation Plan
+
+进度标记于 2026-08-21。
+
+1. [x] Add a read-only reference inspection utility or library helper that validates GeoJSON,
+   converts GCJ-02 to WGS84, computes bounds/center, and associates the sample with OSM node
+   `8005332807`. — `scripts/lib/gaode-junction-reference.js` + `scripts/inspect-junction-reference.js`
+2. [x] Add focused tests for coordinate conversion, malformed input rejection, spatial association,
+   and the no-reference fallback. — `npm run test:gaode-junction-reference`
+3. [x] Add a diagnostic comparison between the reference footprint and native
+   `intersection_surface.geojson`, including center offset, envelope overlap, and approach headings.
+   — 复杂路口的面写在 `road_surface.geojson`（`complex_part`）而非 `intersection_surface`，
+   原实现匹配不到、恒返回 `nativeIntersection: null`。已扩展为可回落到复杂路口簇
+   （新增 `--native-road-surface` / `--cluster-id`，schema 升至 v2）。
+4. [x] Add a reference-backed, parameterized junction template and dispatch it only for
+   explicitly enabled samples. — 实际实现为 `complex-junction-v1`，非原计划的 cross 模板，
+   范围变更见 prd.md「Scope Drift」。
+5. [x] Preserve connector, movement, signal, and stop-line generation; validate containment against
+   the new surface. — A/B 实测通过，数据见 prd.md「Verification Log」。
+6. [x] Run native-road, preflight, preview-traffic, and package-contract tests, plus the sample
+   comparison. Inspect the generated overlay/diagnostic manually.
+   — 2026-08-21 全绿：`test:gaode-junction-reference`、`test:native-road`、`test:road-workbench`、
+   `test:preflight`、`test:native-preview-traffic`、`test:package-contract`、`test:traffic-signals`，
+   外加 `road:check` → `ok: true, errors: []`。人工视觉确认仍待用户。
+7. [x] Stop at validation. Do not commit,
+   and do not modify the source OSM or reference GeoJSON. — 未 commit；参考 GeoJSON 未改；
+   源 OSM 有改动但来自人工 JOSM 编辑，非管线写入。
+
+## 本次会话追加的修复（2026-08-21）
+
+- 车道中心线与车道标线越过斑马线：`compileLaneCenterlines` 现接收模板已产出的斑马线/停止线，
+  新增 `trimLaneOutsideControls`（按到路口中心的半径定向后再裁剪，因为车道几何两种朝向都存在）。
+  拓扑几何 `coordinates` 保持完整，仅裁剪发布几何与标线源几何。
+  实测越线要素 20 → 0，分隔线越界 2 → 0，connector 356 / movement 370 前后一致。
+- 新增诊断 `complex-junction-configured-radius-ignored`、`lane-centerline-fully-inside-control`。
+- 删除死函数 `clusterApproachRing`。
+- **复杂路口人行道转角**（`complex-junction.js`）：直条带被裁在簇边界后，相邻两臂的步行带
+  各自留一个断头，中间整个楔形无覆盖。现沿圆角已定义的路缘补一条 2 m 宽转角带。
+  - 复用同一函数作用域内已算好的 `curve` / `tangents` / `edges` / `apex`，不重新拟合曲线
+  - 新增 `armCarriesSidewalk`（按臂的外向方向翻转道路自身的 `sidewalkLeft/Right`）、
+    `edgeRunToRadius`、`offsetPolylineAwayFromCenter`、`ringSelfIntersects`
+  - 经 `islands` 通道并入 `generatedComplexSidewalks`
+  - 自交或几何无效时跳过并报 `complex-junction-sidewalk-corner-fallback`，不硬塞坏几何
+  - 实测：人行道要素 7 → 8；生成角 1（平分线 286°，241°→331°，57 顶点）；无自交；
+    与两侧条带均相接；面积采样 331 点中 0 点落在车行道内
+  - **限制**：全区 139 条路仅 3 条带人行道，4 个角中只有 286° 两侧齐备，
+    其余 3 个角当前不产出，缺少验证样本
+
+## Rollback Points
+
+- Delete/disable the optional reference configuration to restore the default native path.
+- Remove only the reference diagnostic output; existing native-road outputs remain authoritative.
+- Do not overwrite existing layers until the comparison is accepted.