/dr-test-audit
Строит read-only структурный отчёт по явно заданной выборке тестов и прикреплённым квитанциям доказательств
Обзор
/dr-test-audit — опциональная read-only команда для ревью явно заданной мейнтейнером выборки тестов и сохранённых доказательств. Она проверяет ограниченную файловую и JSON-структуру и связывает каждый выбранный тест с хешем исходника, пятипольной карточкой ценности теста (Test Value Card) и указанными квитанциями; команда не выносит автоматических решений о семантической избыточности и не изменяет файлы тестов или гейты.
Входные данные и запуск
- Прочитайте JSON-выборку, указанную мейнтейнером (по шаблону
templates/test-audit-selection.jsonи схеме вdocumentation/reference/test-audit-report.md). Путь к выборке должен быть относительным и находиться внутри объявленного корня проекта. - Убедитесь, что выборка содержит только целевые тестовые файлы и явно перечисленные ссылки на квитанции — не добавляйте тесты, не раскрывайте glob-маски и не домысливайте отсутствующие замеры.
- Запустите сборщик отчёта один раз с указанным корнем и файлом выборки:
python3 "${DATARIM_RUNTIME:?}/dev-tools/build-test-audit-report.py" --root PROJECT --selection SELECTION.json - Сохраните числовой код возврата и stdout/stderr. При коде
0в stdout выводится версионированный JSON-отчёт. При ненулевом коде сохраните фиксированный диагностический код и не выдавайте пустой или аварийный вывод за результат.
Интерпретация и границы
- Трактуйте каждое поле
proposed_actionкак авторское предложение для ревью, а не как автоматическое решение или команду менять тесты. - Сохраняйте привязку каждой рекомендации к хешу исходника выбранного теста, пятипольной карточке Test Value Card и явно указанным хешам/указателям квитанций.
- Поля стоимости со значением
NOT_MEASUREDозначают отсутствие валидного наблюдения для данной метрики — это не ноль и не оценка производительности. - Команда не запускает тесты, не редактирует и не удаляет файлы, не ослабляет гейты и не запускает CI.