Repository navigation
v0.12.0
Выпуск про одно: первый же запуск показывает, что у вас хорошо, что нет и с чего начать —
вместо двадцати одинаковых крестов и минуты пустого экрана. doctor видит проверки, которые у
проекта уже есть (у восьми живых python-проектов из восьми, а не у трёх), называет брак, который
ваши проверки пропустили в ваших же файлах, и предлагает три первых шага с готовой командой.
И одно исправление, ради которого выпуск не стал ждать недели: на Windows гейты больше не
уезжают в WSL — отчёт с живого проекта, где make check краснел не из-за кода.
Добавлено
doctorпоказывает проверки, которые у проекта УЖЕ есть. Если гейтов в манифесте нет,
он читаетpackage.json(scriptstest,lint,typecheck,check…) иMakefileи
печатает их галочками с источником — и готовую строку дляgates:. Раньше проект с eslint,
mocha и конвейером видел «держит машина 0»: мы считали только свои записи. Предлагаем, а не
вписываем — гейт в чужом манифесте без спроса был бы нашим решением в чужом файле- «Начните с этих трёх». Когда не закрыто больше трёх записей,
doctorвыбирает три: сперва
те, что родились из настоящего отказа (есть запись вincidents/) и закрываются одной
готовой командой под ваш язык. У каждой — команда, которую можно выполнить прямо сейчас, и
адрес инструмента (ruff, eslint, gitleaks, vulture…), и слово про хук перед пушем - Python-проекты тоже видят свои проверки. Кроме
package.jsonиMakefileчитаются
.pre-commit-config.yaml(одной командойpre-commit run --all-files, хуки названы
поимённо), окружения-проверки tox изtox.iniиpyproject.toml(tox -e lint,style,
typing— матрица версий не предлагается) и исполняемыеscripts/test|check|lint. Замер на
восьми живых проектах (requests, click, flask, httpx, black, fastapi, pydantic, rich): свои
проверки видели три из восьми, теперь — все восемь. Шаги конвейера не читаются намеренно:
uv run --locked --group … ${{ matrix.x }}работает только в том конвейере doctorпредостерегает находками пробы, ничего не запуская. Проба подсаживает брак в
копию ваших самых чинимых файлов и знала, какой класс ваши проверки пропустили, — но в
отметку писала одно число, и человек вdoctorне видел ничего. Теперь отметка несёт имена
классов и файлы, аdoctorпечатает их над «начните с этих трёх»:✘ swallowed-error ← src/utils.pyи команду, которой поймать прямо сейчас. Три случая не сливаются: гейт стоял и
проба его гоняла — «стоит, но здесь не ловит»; гейт объявлен, но проба его не гоняла
(поставлен позже или медленный) — «покажет следующая»; гейта нет — совет. Пробы не было —
одна строка о том, что она сделает. Блок для агента (context) называет те же классы по
имени- Поле
tool:у записи каталога — адрес инструмента, которым она проверяет. В совете
показывается адрес того инструмента, которым начинается команда: python-проекту — ruff, а не
ruff и eslint - Строка «идёт» во время
doctor --run. Пока гейт работает, видно, какой именно и какой по
счёту:⋯ smoke [2/10] идёт…; по завершении строка сменяется на ✔ или ✘. То же на секунды
доказательства перед уровнем. Только в терминале: в пайп и в конвейер не пишется ни байта
Исправлено
- Windows: гейты больше не уезжают в WSL. На Windows 10/11 в
System32лежитbash.exe—
заглушка WSL, и в PATH она стоит раньше Git Bash (установщик Git по умолчанию кладёт туда
толькоGit\cmd). Командаbash kit/gates/x/check.sh .запускалась в Linux-подсистеме с
другими программами и путями, и прогон краснел не из-за кода. Теперь все пять мест запуска
(прогон, доказательство, проба, храповик,why) идут через одну точку, которая берёт
bash.exeрядом сgit.exe; явный путь —AQK_BASH.vitalsназывает bash ненайденным,
если есть только заглушка. Отчёт с живого проекта: «через Git Bash все проходят». На ту же
ловушку наступали Claude Code и
Archon - Плавающий отказ
gates.sh(«отклонено: 1 из 29»).printf … | grep -qпри
set -o pipefail:grepвыходит на первом совпадении,printfполучает SIGPIPE, конвейер
возвращает 141 — и раздел README, который есть, объявлялся отсутствующим. Воспроизведено
100 из 100 под нагрузкой; поиск переведён на here-string - Проба не называет класс слепым, если подсадка сломала гейт, который до неё работал.
Сломанный гейт мог быть тем самым ловцом — вердикт «не смогли проверить», а не «никто не
ловит». Найдено пробой на самом комплекте: образец лёг на место общей библиотеки
kit/gates/_skip.sh, двенадцать гейтов вышли с кодом 2 — включая тот, что этот образец
ловит, — и проба назвала класс слепым
npx agent-quality-kit doctor