目标
实现 Goal-FlowRun 终态绑定和 flow_run finalize 幂等流程,同步所有文档。
实现要点
Goal 终态绑定 (
src/plugin/goal.ts)goal.complete存在 FlowRunRef 时:- 读取精确 FlowRun → 检查 status 为
completed - 非
completed→ 返回FLOW_RUN_INCOMPLETE - 存在引用但缺失 FlowRun → 返回
FLOW_RUN_NOT_FOUND
- 读取精确 FlowRun → 检查 status 为
- Goal 写入失败可重试,不重复合并或修改 Stage
flow_run finalize(src/flowrun/index.ts)finalizeFlowRun(parentIssueNumber):- 确认所有 Task 为
merged - code Stage: 确认所有 Task TDD/实现已合并 →
pass - test Stage: 聚合各 PR 的 regression/CI/coverage →
pass - review Stage: 聚合 reviewer + acceptance →
pass - merge Stage: 确认所有 mergeResult 通过 →
pass
- 确认所有 Task 为
- 幂等:重复调用不影响已完成的 Stage
- 全局
canMerge()在此处使用(非 Task 级合并)
文档同步
docs/guides/architecture.md:新增 TDD 三层约束模型架构描述docs/guides/configuration.md:新增 TDD policy/enforcement/mode 配置说明docs/guides/usage.md:新增 TDD 工作流(Advisory→Runtime→Repository Quality)使用指南assets/prompts/bootstrap.md:更新 TDD enforcement 默认配置说明
验收标准
- [ ] Goal blocker 测试:非 completed FlowRun 阻止 Goal complete
- [ ]
flow_run finalize幂等测试 - [ ] Goal/FlowRun 跨操作测试:Goal 写入失败后重试恢复
- [ ] 文档构建通过(
npm run docs:build) - [ ] 所有文档无死链
Worktree
- 路径:
.worktree/tdd-e3-goal-binding/ - 分支:
feat/tdd-e3-goal-binding