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

453 lines
11 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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**