chimera-run-the-projects-own-gate-command

Вы собираетесь запустить контроль качества проекта — линтер, тайпчекер, тесты — и предъявить результат как свидетельство того, что изменение безопасно. Соблазн — сузить («я трогал только chimera/») или ужесточить («--strict наверняка лучше»).

Это не относится к разведке. Запускать pytest tests/test_governed_surfaces.py -x, пока вы итерируете над одним файлом, правильно; правило о том, что после этого можно назвать контролем. Суженный прогон — вспомогательное средство отладки, но никогда не верификация.

1. Найдите, где команда записана, и назначьте канонической ОДНУ запись. В Chimera это цель check в Makefile — make check, — потому что цель исполняема, а строка в прозе является её копией. Три проверки, которые она запускает: ruff check ., mypy chimera и pytest -q.
2. Запускайте каноническую форму байт в байт. Ни добавленного пути, ни добавленного флага, ни подменённого раннера. Учтите, что копия в прозе может отличаться так, что это выглядит косметикой и ею не является: Makefile:21 оборачивает это как uv run --no-sync, CONTRIBUTING.md:105 — как uv run --extra dev --extra desktop. Тот же инструмент, разные окружения — ровно поэтому одна из записей обязана быть источником.
3. Если два источника расходятся, считайте авторитетным workflow CI, запускайте его и правьте устаревший документ тем же PR: CONTRIBUTING.md какое-то время нёс ошибочную строку mypy --strict, а устаревшая инструкция расходится по всем, кто её прочтёт.
4. Если каноническая команда не может выполниться в вашем окружении, говорите, что контроль не запускался. На Windows локальный .venv сломан (litellm требует Rust/MSVC), поэтому контроль запускается в WSL: переносить оболочку можно, править команду нельзя.
5. Приводите команду и её вывод дословно, а не пересказ того, как всё прошло.

Каноническая команда обычно самая медленная, и правило, запрещающее быстрый вариант, подталкивает не запускать вообще ничего. Это исход хуже, чем суженный прогон, честно помеченный как суженный.

Измерьте цену, прежде чем решать, что правило дешёвое, и перемеряйте по мере роста набора тестов. Первая редакция этой карточки утверждала, что полный набор Chimera идёт «около пятнадцати секунд», — число, верное однажды и уехавшее примерно к 100 секундам по четырём измеренным прогонам к моменту написания карточки. Карточка о том, что команды не выдумывают, — плохое место для публикации цифры, не переживающей запуска этой команды.

И сам рецепт может быть неверен. Следовать ему буквально — значит унаследовать его слепые пятна: make check не скажет вам, что тест читает лежащий в gitignore bench/local_lift/results/paired.json, которого в свежем клоне нет. Лечение плохого контроля — менять рецепт в PR, а не тихо запускать у себя улучшенный: приватное улучшение защищает ровно одного человека и оставляет CI, и всех остальных, на старой команде.