feat(orchestrator): 会话状态机实现 + cancelled/resume(T3 架构审查整改)

- Issue3: 新建 src/genesis/state_machine.py(9 状态白名单转移)
  - cancel 记录 cancelled_from 进 cancelled 终态,resume 回中断点
  - 仅执行中状态可取消(awaiting_*/done 不可),非法转移抛 StateTransitionError
- 同步 agent-runtime-design.md §3.2(状态图/规则表 9 状态 + cancelled 行)
- 新增 10 用例(含覆盖补齐 2 项),全量 177 passed / 100.00%(981 stmts/252 br)
This commit is contained in:
lhl
2026-08-12 09:39:34 +08:00
parent cf9600e437
commit 2f4397a8d6
4 changed files with 251 additions and 8 deletions
+1
View File
@@ -72,3 +72,4 @@
| 2026-08-11 | 架构设计 | 整体架构工程审查(plan-eng-reviewSCOPE_REDUCED 模式):Step0 裁定移除 Qdrant 抽象+Redis 双实现(单一 Chroma+InMemory);Section1 架构 7 issuejsonschema 真校验/解析降级链/cancelled+resume 状态/引擎层注入防护/删死配置/v1 rerank/记忆完整实现);Section2 代码质量 3 issueDRY helper/全异步化/局部变量);Section4 性能 2 issueCJK token 估算/串行约束文档化);Outside Voice 8 项全接受(文档同步/bge-m3/resolver/黄金集/DataGate 机制化/QA 护栏+fallback/任务持久化/docx 原型提前);产出 17 项 Implementation Tasks JSONL;报告 docs/architecture-eng-review.md | docs/architecture-eng-review.md, _AI_USAGE_LOG.md | deepseek-v4-flash-free |
| 2026-08-11 | Agent 实现 | T1(架构审查整改):chat_structured 接入 jsonschema 真校验。pyproject.toml 新增 jsonschema>=4.23 依赖;engine.py 在 json.loads 后调用 jsonschema.validateschema 非空时),校验失败按解析失败重试(新增 except jsonschema.ValidationError 分支,带校验错误信息重试);新增 3 用例(违规重试成功/违规耗尽 parse_error 含校验详情/合法一次通过);TDD 验证 RED{'a':'not_a_number'} 未被拒直接返回)→ GREEN(聚焦 4 passed)→ 全量 163 passed 覆盖 100.00%936 stmts/238 br),fail_under=99 达标 | pyproject.toml, src/genesis/inference/engine.py, tests/test_inference_engine.py, _AI_USAGE_LOG.md | deepseek-v4-flash-free |
| 2026-08-11 | Agent 实现 | T2(架构审查整改):chat_structured 解析重试走降级链(Issue2)+ 模型名局部变量(Issue10)。engine.py 重构 chat_structured:外层 attempts 轮次循环 + 内层降级链 names 遍历(首选成功 ok/降级成功 fallback);解析/校验失败即时追加错误信息供备用模型重试可见;LLMError 不再 early return 而继续降级链,全部失败按 last_was_parse_error 区分 parse_error/failed;删除 4 处重复 _model_names(None)[0] 调用;同步更新 7 个既有用例脚本数量与断言(降级链语义:network 失败用例显式 retry_count=0);新增 2 用例(解析重试降级 fallback/网络失败降级 fallback);TDD 验证 RED(解析重试仍用首选模型)→ GREEN(聚焦 27 passed)→ 全量 165 passed 覆盖 100.00%941 stmts/242 br),fail_under=99 达标 | src/genesis/inference/engine.py, tests/test_inference_engine.py, _AI_USAGE_LOG.md | deepseek-v4-flash-free |
| 2026-08-11 | Agent 实现 | T3(架构审查整改):会话状态机实现 + cancelled/resumeIssue3)。新建 src/genesis/state_machine.pySessionStateMachine9 状态白名单转移 + StateTransitionError 对应 api §7 STATE_TRANSITION_INVALID 409cancel 记录 cancelled_from 进 cancelled 终态,resume 回中断点;仅执行中状态可取消,awaiting_*/done 不可;状态集含 8 设计态 + cancelled);同步 agent-runtime-design.md §3.2 状态图/规则表(9 状态 + cancelled 行);新增 10 用例(正常流转/非法转移拒绝/done 终态/cancel 记录/resume 回中断点/非 cancelled 不可 resume/cancelled 不可任意跳转/循环 cancel-resume/未知初始/目标状态防御);TDD 验证 REDModuleNotFoundError)→ GREEN(聚焦 10 passed)→ 覆盖补齐 2 用例 → 全量 177 passed 覆盖 100.00%981 stmts/252 br),fail_under=99 达标 | src/genesis/state_machine.py, tests/test_state_machine.py, docs/agent-runtime-design.md, _AI_USAGE_LOG.md | deepseek-v4-flash-free |