T1-SD0102-01/2026Technology-Competition
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

chore: 一致性门禁收尾（plan 计数、尾换行、消息与注释润色）

Browse Source
This commit is contained in:
lhl
2026-08-09 17:11:38 +08:00
parent f6172903b8
commit 464423b7ef
3 changed files with 5 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files
_AI_USAGE_LOG.md
+1
View File
@@ -58,3 +58,4 @@
| 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 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 | 测试验证 | 里程碑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 | | 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 |
| 2026-08-09 | 测试验证 | 一致性门禁最终评审收尾修复（Important x1 + Minor x3）：① plan 文档 Interfaces 段 L311-314「五行 LLM 行」→「四行」（与 ==4 护栏一致）；② 测试文件补尾随换行（末字节 " → \n）；③ 断言消息改「异常类存在文档未登记或来源类名失配的 error_code」（覆盖双失败场景）；④ _LLM_ROW_RE 加正则隐式限域注释。覆盖测试 4 passed；pytest 全量 132 passed 覆盖 100.00%，fail_under=99 达标 | docs/superpowers/plans/2026-08-09-error-code-consistency-test.md, tests/test_api_design_consistency.py, _AI_USAGE_LOG.md | deepseek-v4-flash-free |
docs/superpowers/plans/2026-08-09-error-code-consistency-test.md
+1 -1
View File
@@ -28,7 +28,7 @@
- Modify: `_AI_USAGE_LOG.md`（追加一行） - Modify: `_AI_USAGE_LOG.md`（追加一行）
**Interfaces:** **Interfaces:**
- Consumes: `src/genesis/inference/exceptions.py` 的 `LLMError.error_code` 类属性（基类 `None`；四子类 `LLM_TIMEOUT`/`LLM_NETWORK_ERROR`/`LLM_NOT_CONFIGURED`/`LLM_PARSE_ERROR`）；`docs/api-design.md` §7 表格（L311-314 五行 LLM 行，行格式 `| \`CODE\` | 含义 | ... | exceptions.Xxx |`） - Consumes: `src/genesis/inference/exceptions.py` 的 `LLMError.error_code` 类属性（基类 `None`；四子类 `LLM_TIMEOUT`/`LLM_NETWORK_ERROR`/`LLM_NOT_CONFIGURED`/`LLM_PARSE_ERROR`）；`docs/api-design.md` §7 表格（L311-314 四行 LLM 行，行格式 `| \`CODE\` | 含义 | ... | exceptions.Xxx |`）
- Produces: 无（测试文件独立，无下游依赖） - Produces: 无（测试文件独立，无下游依赖）
- [ ] **Step 1: 写失败测试** - [ ] **Step 1: 写失败测试**
tests/test_api_design_consistency.py
+2 -1
View File
@@ -16,6 +16,7 @@ from genesis.inference.exceptions import LLMError
API_DOC = Path(__file__).resolve().parents[1] / "docs/api-design.md" API_DOC = Path(__file__).resolve().parents[1] / "docs/api-design.md"
# §7 表格 LLM 行：| `CODE` | 语义 | ... | exceptions.Xxx | # §7 表格 LLM 行：| `CODE` | 语义 | ... | exceptions.Xxx |
# 当前全文档仅 §7 含 exceptions. 行，此正则隐式限域；若他处新增类似行需加小节锚定。
_LLM_ROW_RE = re.compile( _LLM_ROW_RE = re.compile(
r"^\|\s*`([A-Z][A-Z_]+)`\s*\|.*\|\s*exceptions\.([A-Za-z_]+)\s*\|$" r"^\|\s*`([A-Z][A-Z_]+)`\s*\|.*\|\s*exceptions\.([A-Za-z_]+)\s*\|$"
) )
@@ -51,7 +52,7 @@ def test_error_doc_lists_every_llm_error_code():
if cls.error_code not in mapping or mapping[cls.error_code] != cls.__name__ if cls.error_code not in mapping or mapping[cls.error_code] != cls.__name__
} }
assert not missing, ( assert not missing, (
"异常类表存在文档未登记的 error_code（请同步 api-design.md §7）：\n" "异常类存在文档未登记或来源类名失配的 error_code（请同步 api-design.md §7）：\n"
+ repr(missing) + repr(missing)
) )