Skip to content

v0.12.0

Choose a tag to compare

@github-actions github-actions released this 11 Sep 05:33
· 167 commits to main since this release
8086480

Выпуск про одно: первый же запуск показывает, что у вас хорошо, что нет и с чего начать —
вместо двадцати одинаковых крестов и минуты пустого экрана. doctor видит проверки, которые у
проекта уже есть (у восьми живых python-проектов из восьми, а не у трёх), называет брак, который
ваши проверки пропустили в ваших же файлах, и предлагает три первых шага с готовой командой.

И одно исправление, ради которого выпуск не стал ждать недели: на Windows гейты больше не
уезжают в WSL
— отчёт с живого проекта, где make check краснел не из-за кода.

Добавлено

  • doctor показывает проверки, которые у проекта УЖЕ есть. Если гейтов в манифесте нет,
    он читает package.json (scripts test, 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