命令
Audit
/dr-test-audit
为明确限定的测试选择及其保留证据构建只读的结构化报告
概述
/dr-test-audit 是一个可选启用的只读命令,用于审查维护者提供的测试选择及其保留证据。它校验限定范围内的文件与 JSON 结构,并为每个测试附加源码哈希、五字段测试价值卡以及所引用的回执哈希/指针;它不判定测试在语义上是否冗余,也不修改任何测试文件或门禁。
输入与执行
- 读取维护者指定的选择 JSON(使用
templates/test-audit-selection.json以及documentation/reference/test-audit-report.md中的 schema)。选择路径必须相对于声明的项目根目录,并保持在该根目录内。 - 确认选择中仅包含预期的测试文件和显式列出的回执引用 — 不要添加测试、展开 glob、搜索证据或推断缺失的观测结果。
- 使用提供的根目录和选择运行一次报告构建器:
python3 "${DATARIM_RUNTIME:?}/dev-tools/build-test-audit-report.py" --root PROJECT --selection SELECTION.json - 保留其数字退出状态以及 stdout/stderr。退出码为
0时,stdout 即为带版本号的 JSON 报告。退出码非零时,保留固定的诊断代码,绝不可将空报告或失败报告描述为结果。
解读与边界
- 将每个
proposed_action视为用户撰写的待审查建议,而非自动化决策或修改测试的指令。 - 将每条建议与其所选测试的源码哈希、现有的五字段测试价值卡以及显式引用的回执哈希/指针保持关联。
NOT_MEASURED成本字段表示该选择未引用该指标的有效观测结果 — 它们不是零,也不支持性能估算。- 此命令不得运行测试、编辑或删除文件、降低门禁、更改测试计划、发布报告或触发 CI。