Команда Audit

/dr-test-audit

Строит read-only структурный отчёт по явно заданной выборке тестов и прикреплённым квитанциям доказательств

Обзор

/dr-test-audit — опциональная read-only команда для ревью явно заданной мейнтейнером выборки тестов и сохранённых доказательств. Она проверяет ограниченную файловую и JSON-структуру и связывает каждый выбранный тест с хешем исходника, пятипольной карточкой ценности теста (Test Value Card) и указанными квитанциями; команда не выносит автоматических решений о семантической избыточности и не изменяет файлы тестов или гейты.

Входные данные и запуск

  1. Прочитайте JSON-выборку, указанную мейнтейнером (по шаблону templates/test-audit-selection.json и схеме в documentation/reference/test-audit-report.md). Путь к выборке должен быть относительным и находиться внутри объявленного корня проекта.
  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 как авторское предложение для ревью, а не как автоматическое решение или команду менять тесты.
  • Сохраняйте привязку каждой рекомендации к хешу исходника выбранного теста, пятипольной карточке Test Value Card и явно указанным хешам/указателям квитанций.
  • Поля стоимости со значением NOT_MEASURED означают отсутствие валидного наблюдения для данной метрики — это не ноль и не оценка производительности.
  • Команда не запускает тесты, не редактирует и не удаляет файлы, не ослабляет гейты и не запускает CI.