Files
road-compiler/.trellis/workspace/dingkang/journal-1.md
T
2026-09-17 11:16:02 +08:00

12 KiB
Raw Blame History

Journal - dingkang (Part 1)

AI development session journal Started: 2026-08-26


Session 1: Complete direct edit document and revision foundation

Date: 2026-08-27 Task: Complete direct edit document and revision foundation Branch: feat/direct-edit-documents

Summary

Completed the v2 direct-edit document, immutable revision storage, and area-config snapshot foundation.

Main Changes

  • Added validated native-road-edits/v2 documents, revisions, content-addressed OSM, and snapshot-only compilation.

Git Commits

Hash Message
93f09e3 (see git log)
3500237 (see git log)
c0c8a16 (see git log)
ba8eaba (see git log)

Testing

  • [OK] npm run format:check; npm run test; npm run test:client; npm run test:client:unit; npm run build

Status

[OK] Completed

Next Steps

  • Start the direct-edit solver and API child task.

Session 2: Direct-edit handle manifest

Date: 2026-08-27 Task: Continue direct-edit-solver-api, step 2 Git Commit: ab63d23

Summary

Added junction reserve calculation, six-kind handle manifest generation, and shared native feature ID builders. The solver remains pure and empty documents remain an identity transform for compiled geometry.

Testing

  • [OK] npm test; npm run format:check; npm run test:client; npm run test:client:unit; npm run build

Next Steps

  • Implement the six constraint kinds and invariant diagnostics (step 3).

Session 3: Direct-edit constraint solving

Date: 2026-08-27 Task: Continue direct-edit-solver-api, step 3 Git Commit: 0eb404d

Summary

Activated all six constraint kinds, added transactional validation and blocking diagnostics, and wired road profiles and junction plans into geometry compilation.

Testing

  • [OK] npm test; npm run format:check; npm run test:client; npm run test:client:unit; npm run build

Next Steps

  • Implement exact/recheck/pending/conflicted/stale replay matching (step 4).

Session 4: Direct-edit replay matching

Date: 2026-08-27 Task: Continue direct-edit-solver-api, step 4 Git Commit: 735ce69

Summary

Added exact-anchor replay classification, snapshot candidate fallback, stale lane-boundary handling, and compiler-geometry recheck propagation.

Testing

  • [OK] npm test; npm run format:check; npm run test:client; npm run test:client:unit; npm run build

Next Steps

  • Add the read-only edit-state and edit-preview endpoints (step 5).

Session 5: Read-only edit APIs

Date: 2026-08-27 Task: Continue direct-edit-solver-api, step 5 Git Commit: 41c314f

Summary

Added GET /api/edit-state and POST /api/edit-preview. Preview compiles from the draft document without writing active files and returns sequence, degraded status, diagnostics, handles, and derived layers.

Testing

  • [OK] npm test; npm run format:check; npm run test:client; npm run test:client:unit; npm run build

Next Steps

  • Implement edit/revision/rebase writes with expected-version protection (step 6).

Session 6: Edit persistence and rebase APIs

Date: 2026-08-27 Task: Complete direct-edit-solver-api, step 6 Git Commit: f3f763f

Summary

Added atomic active-document saves with expected-version 409 protection, revision checkpoint creation, and read-only revision rebase status summaries. Existing state/session responses now expose active revision and document version.

Testing

  • [OK] npm test; npm run format:check; npm run test:client; npm run test:client:unit; npm run build

Next Steps

  • Run the solver-api quality review, then archive the child task before starting the map-editor child task.

Session 2: Archive direct-edit solver API

Date: 2026-08-27 Task: Archive direct-edit solver API Branch: feat/direct-edit-documents

Summary

Completed the direct-edit solver/API quality gate, documented the pure resolver and preview/save/revision/rebase contracts, and archived 08-26-direct-edit-solver-api. Next: activate the map-editor child task.

Git Commits

Hash Message
a26d4be (see git log)

Status

[OK] Completed

Session 3: Fix junction control marking handles

Date: 2026-08-28 Task: Fix junction control marking handles Branch: feat/direct-edit-documents

Summary

Fixed junction control handle visibility and drag preview resolution; verified client and solver tests.

Git Commits

Hash Message
11f4d74 (see git log)

Status

[OK] Completed

Session 4: Lane maneuver workbench editor

Date: 2026-09-01 Task: Lane maneuver workbench editor Branch: feat/direct-edit-documents

Summary

Added default workbench selection and a discrete editor for lane-maneuver overrides; turn arrows group by lane plus maneuver, lane centerlines support unmarked lanes, and direction arrows remain display-only.

Git Commits

Hash Message
e48eb15 (see git log)
3d13576 Outline selected turn arrows

Status

[OK] Completed

Session 5: Complex junction shape classification

Date: 2026-09-07 Task: Complex junction shape classification Branch: feat/direct-edit-documents

Summary

Added compiler-owned complex junction shape classification, arm-envelope core geometry, safe fallback, JunctionTools shape summaries, and real OSM regression coverage.

Git Commits

Hash Message
a359f88 (see git log)

Status

[OK] Completed

Session 6: JunctionTools 结构与规范契约

Date: 2026-09-07 Task: JunctionTools 结构与规范契约 Branch: feat/direct-edit-documents

Summary

完成 JunctionTools Stage 0:新增 junctionStructure 对象契约、cn-urban-default 规范档、范围评估与覆盖十字/T 字/偏置/多臂/单行场景的测试;全量 npm test 与 format:check 通过。归档任务提交为 91e088b。

Git Commits

Hash Message
61cf276 (see git log)

Status

[OK] Completed

Session 7: 归档已完成道路编辑任务

Date: 2026-09-07 Task: 归档已完成道路编辑任务 Branch: feat/direct-edit-documents

Summary

核对并归档直接操纵道路编辑工作台、斑马线元素级编辑器实验、复杂路口手动切换与独立浏览三个已完成任务;保留未跟踪的 test-results 生成文件。

Git Commits

Hash Message
d61c86e (see git log)

Status

[OK] Completed

Session 8: JunctionTools Stage 1 功能实现

Date: 2026-09-07 Task: JunctionTools Stage 1 功能实现 Branch: feat/direct-edit-documents

Summary

完成 Stage 1:编译器统一投影 junctionStructure,state/edit-state/edit-preview 暴露标准档与诊断,JunctionWorkspace 增加只读结构与标准面板;后端回归、客户端单测、类型检查、构建和格式检查全部通过。

Git Commits

Hash Message
fc7fe81 (see git log)

Status

[OK] Completed

Session 9: JunctionTools Stage 2 选择与作用域

Date: 2026-09-07 Task: JunctionTools Stage 2 选择与作用域 Branch: feat/direct-edit-documents

Summary

完成 Stage 2 首个交互闭环:地图设施、工作区列表和诊断统一 selectedObjectKey;工作区对象列表可高亮,参数组复用现有统一值/单独定制/重置机制。前后端回归、客户端单测、类型检查、格式检查和构建通过。

Git Commits

Hash Message
de6ef8e (see git log)

Status

[OK] Completed

Session 10: JunctionTools Stage 3 几何校验

Date: 2026-09-07 Task: JunctionTools Stage 3 几何校验 Branch: feat/direct-edit-documents

Summary

完成 Stage 3:保存入口复用 direct-edit solver,阻塞路口几何参数返回 400 且不写入;新增回归测试。npm test、客户端单测/类型检查、format:check、build 全部通过。

Git Commits

Hash Message
63c6cef (see git log)

Status

[OK] Completed

Session 11: JunctionTools Stage 4 参考几何

Date: 2026-09-07 Task: JunctionTools Stage 4 参考几何 Branch: feat/direct-edit-documents

Summary

完成 Stage 4:参考 GeoJSON 作为独立只读图层接入,支持显示开关、透明度调整、GCJ-02 到 WGS84 来源摘要,并保持不影响 native 输出与编辑保存。全量后端回归、客户端单测、类型检查、格式检查和构建通过。

Git Commits

Hash Message
92ab2ed (see git log)

Status

[OK] Completed

Session 12: JunctionTools Stage 5 高级设施

Date: 2026-09-07 Task: JunctionTools Stage 5 高级设施 Branch: feat/direct-edit-documents

Summary

完成 Stage 5 基础交付:仅依据显式编译证据投影导流岛、中央分隔、人行道转角;道路臂补充人行/非机动车连接状态;信号设施保留与横道关联。完整后端回归、客户端单测、类型检查、格式检查和构建通过。

Git Commits

Hash Message
0065c3e (see git log)

Status

[OK] Completed

Session 13: Complex junction stable identity

Date: 2026-09-08 Task: Complex junction stable identity Branch: feat/direct-edit-documents

Summary

完成复杂路口第 1 阶段:权威外部拓扑、稳定 arm/corner/facility 标识、作用域投影、信号 provenance、地图与列表选择;180 客户端测试及 11 浏览器回归通过,完整后端/类型/构建/格式通过。第 1 子任务已归档,宽度编辑等后续阶段尚未启动。

Git Commits

Hash Message
bd8b55e (see git log)
0a5a229 (see git log)

Status

[OK] Completed

Session 14: 复杂路口车行道宽度编辑

Date: 2026-09-08 Task: 复杂路口车行道宽度编辑 Branch: feat/direct-edit-documents

Summary

完成复杂路口外部车行道宽度的约束、编译、预览、保存与工作台编辑闭环。

Main Changes

  • 新增稳定 cluster-carriageway 宽度锚点及重放校验。
  • JunctionTools 复用现有手柄、预览和保存流程编辑宽度。

Git Commits

Hash Message
c4bcbe8 (see git log)

Testing

  • [OK] npm test、客户端检查、构建、格式检查和 Playwright 11/11 通过。

Status

[OK] Completed

Next Steps

  • 继续 03 阶段的收口与角部局部编辑。

Session 15: Complete junction layer seam audit

Date: 2026-09-17 Task: Complete junction layer seam audit Branch: main

Summary

完成接缝专项并归档:修复相邻复杂路口两端裁切,13 场景、1446 接口及破坏性反例通过;类型检查和岛体位移回归通过。npm test 保留既有 fixture 差异,format:check 保留既有设施文件格式问题。绕障专项仅规划与初审,父任务保持归档。

Git Commits

Hash Message
cfb3593 (see git log)
b9c38b0 (see git log)

Status

[OK] Completed

Session 16: Preserve complex junction exclusion pavement

Date: 2026-09-17 Task: Preserve complex junction exclusion pavement Branch: main

Summary

完成最终铺装排除区保留并归档:先填补施工空洞再扣除显式排除区;真实 OSM 1 平方米孔洞最终交集降至零。多孔洞、切断和入口阻断回归通过;无排除区输出保持一致。自动绕障与车辆路径规划仍未实现。

Git Commits

Hash Message
818d91d (see git log)

Status

[OK] Completed