chore(task): archive complex junction lifecycle stage

This commit is contained in:
que01 committed 2026-09-08 15:42:10 +08:00
1 parent a5f64a2349
commit 6896f8a554
6 files changed
+3 -3

No files matched your search

@@ -0,0 +1,3 @@
{"file": ".trellis/spec/backend/direct-edit-api.md", "reason": "Solver, preview/save/rebase and persistence contracts."}
{"file": ".trellis/spec/frontend/direct-edit-client.md", "reason": "Shared gesture, session, preview and UI ownership contracts."}
{"file": ".trellis/tasks/09-08-complex-junction-editing/research/implementation-audit.md", "reason": "Verified source gaps and reusable implementation boundaries."}
@@ -0,0 +1,28 @@
# 拓扑变更与事务一致性设计
## 边界与数据流
遵守父设计 ../09-08-complex-junction-editing/design.md;实现现状依据 ../09-08-complex-junction-editing/research/implementation-audit.md。
1. 用 01 稳定来源与 topology fingerprint 扩展 replay 状态和原因;几何版本变更走 recheck。
2. 将 cluster 配置变更与活动手势/未保存草稿协调,明确变更生效后重新获取 manifest 的次序。
3. 审查 PreviewRequester 与 EditSession 的序列、作用域、abort 和 load 行为,沿用一个会话控制器。
4. 补齐 App 的保存/编译分步状态及恢复提示;测试多标签页版本竞争与异步响应竞争。
## 影响文件
- `src/compile/direct-edit-solver.js`
- `workbench/server.js`
- `workbench/client/src/edit/session.ts`
- `workbench/client/src/edit/preview-request.ts`
- `workbench/client/src/hooks/useDirectEditSession.ts`
- `workbench/client/src/App.tsx`
- `workbench/client/src/junction/workspace.ts`
## 兼容与失败行为
保留 node 路口现有文档与操作语义;新字段必须经过 validator、序列化、API 和客户端类型的完整往返。缺失或歧义来源显式只读/失效,不能通过数组下标修复引用。preview 不落盘,保存沿用版本冲突保护。
## 回滚
按本切片独立提交;出现回归时先关闭新增能力入口,保留约束读取与诊断。不得删除已保存的约束或回滚其他任务的改动。
@@ -0,0 +1,3 @@
{"file": ".trellis/spec/backend/direct-edit-api.md", "reason": "Solver, preview/save/rebase and persistence contracts."}
{"file": ".trellis/spec/frontend/direct-edit-client.md", "reason": "Shared gesture, session, preview and UI ownership contracts."}
{"file": ".trellis/tasks/09-08-complex-junction-editing/research/implementation-audit.md", "reason": "Verified source gaps and reusable implementation boundaries."}
@@ -0,0 +1,29 @@
# 拓扑变更与事务一致性执行计划
## 启动门槛
- [ ] 最终规划获实现确认,前置条件满足:04 验收通过;本任务不替代 02 必需的保存安全门槛。
- [ ] 读取父设计、research 及本任务 JSONL 中相关 spec;确认工作区无其他人的冲突修改。
## 顺序
- [ ] 用 01 稳定来源与 topology fingerprint 扩展 replay 状态和原因;几何版本变更走 recheck。
- [ ] 将 cluster 配置变更与活动手势/未保存草稿协调,明确变更生效后重新获取 manifest 的次序。
- [ ] 审查 PreviewRequester 与 EditSession 的序列、作用域、abort 和 load 行为,沿用一个会话控制器。
- [ ] 补齐 App 的保存/编译分步状态及恢复提示;测试多标签页版本竞争与异步响应竞争。
## 验证
- `node test/workbench-edit-api.js`
- `node test/direct-edit-solver.js`
- `npm run test:client`
- `npm run test:client:unit`
- `npm run test:e2e`
优先运行受影响脚本;新增跨层行为必须有非空编辑改变几何的断言。浏览器需要的服务器端口和依赖按项目配置启动。环境失败与代码失败分别记录,不使用未执行检查作为通过证据。
## 完成门槛
- [ ] PRD 每条验收关联具体测试或人工场景及结果。
- [ ] 相邻子任务接口兼容,普通路口回归通过;不存在仅 UI 状态变化而实际几何不变的路径。
- [ ] 按 trellis-check 完成质量检查,更新已实现契约并保存提交/验证记录后归档。
@@ -0,0 +1,27 @@
# 拓扑变更与事务一致性
## 目标
使复杂路口编辑在成员调整、重编译、刷新和快速切换时保持可解释且不丢失用户修改。
## 前置
04 验收通过;本任务不替代 02 必需的保存安全门槛。父需求与范围边界见 ../09-08-complex-junction-editing/prd.md。
## 需求
- R1:成员重排不失效;成员增删、合并/拆分或来源消失后,编辑只能精确重放或明确报告失效/歧义。
- R2:有未保存编辑时调整成员或离开路口沿用应用/放弃/停留语义,不静默清空。
- R3:切换对象和路口时迟到预览不能覆盖新选择,手势取消、错误恢复和撤销历史正确。
- R4:版本冲突无写入;保存成功但编译失败时明确告知已保存,允许重试编译。
## 验收
- [ ] A1:删除被编辑来源后约束显示 stale/conflicted,不按最近距离或编号改绑;恢复拓扑可重新检查。
- [ ] A2:快速 A→B→A 切换并反序返回预览,画面只接受当前作用域的最新结果。
- [ ] A3:保存冲突、保存失败、保存后编译失败、刷新及重新导入分别有可恢复状态。
- [ ] A4:有其他路口约束的全局文档在局部编辑及放弃操作后仍完整保留。
## 范围边界
只交付本切片;不得为了开放 UI 跳过后端几何消费、来源解析或保存校验。父任务排除的自由拓扑/设施绘制与信号配时不在本任务内。
@@ -0,0 +1,34 @@
{
"id": "cj-05-lifecycle",
"name": "cj-05-lifecycle",
"title": "复杂路口 05:拓扑变更与事务一致性",
"description": "使复杂路口编辑在成员调整、重编译、刷新和快速切换时保持可解释且不丢失用户修改。",
"status": "completed",
"dev_type": "fullstack",
"scope": "junction",
"package": null,
"priority": "P2",
"creator": "dingkang",
"assignee": "dingkang",
"createdAt": "2026-09-08",
"completedAt": "2026-09-08",
"branch": null,
"base_branch": "main",
"worktree_path": null,
"commit": null,
"pr_url": null,
"subtasks": [],
"children": [],
"parent": "09-08-complex-junction-editing",
"relatedFiles": [
"src/compile/direct-edit-solver.js",
"workbench/server.js",
"workbench/client/src/edit/session.ts",
"workbench/client/src/edit/preview-request.ts",
"workbench/client/src/hooks/useDirectEditSession.ts",
"workbench/client/src/App.tsx",
"workbench/client/src/junction/workspace.ts"
],
"notes": "依赖:04 验收通过;本任务不替代 02 必需的保存安全门槛。规划已补齐,等待最终评审后启动;不表示实现已完成。",
"meta": {}
}