命令 Audit

/dr-test-audit

为明确限定的测试选择及其保留证据构建只读的结构化报告

概述

/dr-test-audit 是一个可选启用的只读命令,用于审查维护者提供的测试选择及其保留证据。它校验限定范围内的文件与 JSON 结构,并为每个测试附加源码哈希、五字段测试价值卡以及所引用的回执哈希/指针;它不判定测试在语义上是否冗余,也不修改任何测试文件或门禁。

输入与执行

  1. 读取维护者指定的选择 JSON(使用 templates/test-audit-selection.json 以及 documentation/reference/test-audit-report.md 中的 schema)。选择路径必须相对于声明的项目根目录,并保持在该根目录内。
  2. 确认选择中仅包含预期的测试文件和显式列出的回执引用 — 不要添加测试、展开 glob、搜索证据或推断缺失的观测结果。
  3. 使用提供的根目录和选择运行一次报告构建器:
    python3 "${DATARIM_RUNTIME:?}/dev-tools/build-test-audit-report.py" --root PROJECT --selection SELECTION.json
  4. 保留其数字退出状态以及 stdout/stderr。退出码为 0 时,stdout 即为带版本号的 JSON 报告。退出码非零时,保留固定的诊断代码,绝不可将空报告或失败报告描述为结果。

解读与边界

  • 将每个 proposed_action 视为用户撰写的待审查建议,而非自动化决策或修改测试的指令。
  • 将每条建议与其所选测试的源码哈希、现有的五字段测试价值卡以及显式引用的回执哈希/指针保持关联。
  • NOT_MEASURED 成本字段表示该选择未引用该指标的有效观测结果 — 它们不是零,也不支持性能估算。
  • 此命令不得运行测试、编辑或删除文件、降低门禁、更改测试计划、发布报告或触发 CI。