Skip to content

feat(flowguard): 阶段状态迁移矩阵 + 项目级文档校验 + 模块栈覆盖对照 - #3

Merged
loong10k merged 1 commit into
mainfrom
feat/stage-transition-matrix-and-project-validation
Sep 23, 2026
Merged

loong10k merged 1 commit into
mainfrom
feat/stage-transition-matrix-and-project-validation

Conversation

@loong10k

Copy link
Copy Markdown
Contributor

摘要

按 codegraph 深析的优化清单落地 P0/P1/P2 改进,一个 PR 闭环。

变更

  • P0-1 迁移合法性矩阵:stage_docs.LEGAL(单一事实源 + 全矩阵测试)——满足态互跳/重复写拒绝(封 accepted→accepted 洗白、skipped↔accepted 直跳);回改走 in_progress;正文变更派生的 invalidated 允许直接重新验收;pending/invalidated 不可写入
  • P0-2 项目级文档校验:02 ADR 追加式格式(feature 标注 + 状态枚举)、07 规范集覆盖全部已注册模块栈、10 发布内容功能引用须已知 task-id;接线到 stage advance --status accepted 与 validate 命令
  • P1-3 detect 接线:detect.detect 从孤儿变为 07 模块栈覆盖对照的数据源(废物利用)
  • P1-4:ARTIFACT_STAGE 映射单源 registry.ARTIFACTS
  • P1-5:README quick start 4→6 命令(双语)+ validate 提示
  • P2:state_lock fcntl/msvcrt 跨平台自适应;新增 test_state_tools 直接单测(锁互斥/原子写失败保旧文/原子创建不覆盖)

验证

  • python3 -m unittest discover -s tests 219 全绿(+20 新测试:迁移矩阵 8、state 工具 5、校验器 5、其他);parity + 链接审计通过
  • 迁移矩阵与既有 32 个 docs 管线测试零冲突(校准过 pending→accepted 合法流)

- stage_docs 增 LEGAL 迁移矩阵(单一事实源 + 全矩阵测试):满足态互跳/
  重复写拒绝,回改走 in_progress;invalidated(正文已变)允许直接重新验收;
  pending/invalidated 不可作为写入目标
- 项目级文档验收补内容校验:02 ADR 追加式格式、07 规范集覆盖全部已注册
  模块栈(detect.detect 接线)、10 发布内容功能引用须已知 task-id
- validate 命令同步校验 02/07/10
- ARTIFACT_STAGE 映射单源 registry.ARTIFACTS
- state_lock 跨平台:fcntl/msvcrt 自适应
- 新增 test_stage_transitions/test_state_tools 与校验器单测;219 测试全绿
- README quick start 4→6 命令(双语)
@loong10k
loong10k merged commit 2a1ce97 into main Sep 23, 2026
1 check passed
@loong10k
loong10k deleted the feat/stage-transition-matrix-and-project-validation branch September 23, 2026 17:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant