test: api §7 与异常树错误码一致性门禁测试（防文档漂移）

_AI_USAGE_LOG.md

@@ -57,3 +57,4 @@
 | 2026-08-09 14:02 | Agent 实现 | LLM 错误码对齐 Task3：engine 失败/parse_error 路径透传 error_code（与 error 同源取最后一次异常）。chat() 循环记 last_error_code=exc.error_code，失败返回 error_code=last_error_code；chat_structured() 三路径：JSONDecodeError 分支置 last_error_code="LLM_PARSE_ERROR"（解析耗尽→parse_error）、LLMError 分支 early return 带 error_code=exc.error_code、循环后 parse_error 用 last_error_code。TDD RED（5 failed，error_code=None）→ GREEN（聚焦 22 passed）；pytest 全量 128 passed 覆盖 100.00%（803 stmts/188 br），fail_under=99 达标；提交见 git log | src/genesis/inference/engine.py, tests/test_inference_engine.py, _AI_USAGE_LOG.md | deepseek-v4-flash-free |
 | 2026-08-09 13:51 | Agent 实现 | LLM 错误码对齐 Task4：api-design §7 补 LLM_NETWORK_ERROR 行（对齐异常树 error_code）。在 docs/api-design.md §7 错误码表 LLM_TIMEOUT 行后插入新行 `| LLM_NETWORK_ERROR | 502 | 网络失败/5xx 重试耗尽 | retry / skip / abort | exceptions.LLMNetworkError |`，保留 LLM_NOT_CONFIGURED/LLM_PARSE_ERROR 与 INTERNAL_ERROR 兜底行不动；纯文档改动，全量回归 128 passed 覆盖 100.00%（803 stmts/188 br），fail_under=99 达标 | docs/api-design.md, _AI_USAGE_LOG.md | deepseek-v4-flash-free |
 | 2026-08-09 | 测试验证 | 里程碑3.1 LLM错误码对齐收尾改动（最终评审 Minor）：① 删除 tests/test_inference_engine.py 中 test_chat_failed_error_code_not_configured 首行未使用变量 client = FakeLLMClient(...)（死代码，未引用，函数自洽性核查通过）；② 补齐 src/genesis/inference/engine.py 文件末尾换行符（最后一字节 ) → \n）。覆盖测试 22 passed；pytest 全量 128 passed，覆盖 100.00%（803 stmts/188 br），fail_under=99 达标；提交见 git log | tests/test_inference_engine.py, src/genesis/inference/engine.py, _AI_USAGE_LOG.md | deepseek-v4-flash-free |
+| 2026-08-09 | 测试验证 | 新增 api §7 ↔ 异常树 error_code 一致性门禁测试（防文档漂移）。新建 tests/test_api_design_consistency.py（4 用例：树→文档 / 文档→树双向断言 + 行数护栏 / 空解析护栏）；首次运行 RED（行数护栏 ==5 与事实 4 冲突，文档与异常各为 4 条/4 个子类，双向一致）→ 修正护栏为 4 → GREEN（聚焦 4 passed）；pytest 全量 132 passed 覆盖 100.00%（803 stmts/188 br），fail_under=99 达标；提交见 git log | tests/test_api_design_consistency.py, _AI_USAGE_LOG.md | deepseek-v4-flash-free |