Skip to content

v0.18.0

Choose a tag to compare

@github-actions github-actions released this 26 Sep 19:25
· 30 commits to main since this release

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

Что может выглядеть иначе после обновления. Под галочками появятся строки «пусто: …» у
гейтов, которым нечего было проверять, — прогон при этом зелёный. protection-not-removed на
снимке без команд печатает совет «подмену команды не вижу»; aqk add любого гейта дописывает
строки команд в снимок, и после этого смена команды гейта без правки снимка — красная. Прогон
с --only/--skip называет себя урезанным, а не «всё объявленное зелёное». doctor --run
пишет .aqk/history.jsonl и .aqk/report.html.

Добавлено

  • README стал коротким: что это, кому и когда, запуск за минуту, установка. Около ста строк
    вместо семисот, логотип в начале. Всё прежнее содержание — целиком в полном руководстве
    docs/guide.md и docs/guide.ru.md; версии и размер пакета в них сверяются той же проверкой,
    что и в README.
  • Новое отдельно от давнего. doctor --run, блок для агента, отчёт для человека и сводка
    задания делят не зелёные гейты на сломанные только что («новое с прошлого зелёного») и
    висящие давно («красный с 13.09, 20 прогонов подряд»). Возраст считается по истории прогонов.
    Повод — отзыв с проекта владельца: давний долг прятал три свежие ошибки, и то, что AQK
    поймал сам, никто не заметил.
  • Отчёт для человека одной страницей — .aqk/report.html. Три ответа на одном экране: что
    защищено, ловит ли защита на деле (по пробе), лучше или хуже, чем в прошлый раз, — и что
    поручить агенту, готовыми командами. doctor --run пишет его каждый раз, aqk report --html
    собирает без прогона. Один файл без сети и зависимостей. Блок для агента велит показать его
    человеку. В GitHub Actions тот же прогон дописывает сводку задания (GITHUB_STEP_SUMMARY) —
    без прав и без нашего действия.
  • История прогонов — .aqk/history.jsonl. Строка на прогон: коммит, уровень, итог каждой
    проверки и пометка урезанного прогона. Из неё отчёт считает «было → стало» по двум последним
    полным прогонам и называет, что сломалось и что починено.

Исправлено

  • Подмена команды гейта при том же имени больше не проходит зелёной. В одном PR команду
    secrets-not-in-code заменили на "true" и добавили в код ключ — doctor --run говорил
    «всё объявленное зелёное», код 0: protection-not-removed сторожил только имена. Теперь снимок
    gates-declared.txt хранит одобренную команду строкой # run имя: команда, и расхождение с
    манифестом красное, с «было» и «стало». Сменить команду можно правкой этой строки — её видно
    в дифе. Снимок старого формата не роняет прогон, а говорит советом, что подмену не видит;
    aqk add любого гейта дописывает недостающие строки и не переписывает записанные. Найдено
    сверкой с судьёй kirder24-code/ai-agent-manager (цикл A5).
  • Урезанный прогон называет себя урезанным. doctor --run --only … при незапущенном
    красном гейте печатал «не запускались: …» и тут же «Всё объявленное зелёное.»; заголовок
    отчёта говорил то же. Теперь — «Всё запущенное зелёное, но прогон урезан: не запускались …».
  • Прогон без единого гейта не называется зелёным. Вместо «Всё объявленное зелёное» —
    «пусто: гейтов не объявлено — прогонять было нечего».
  • «Пусто» больше не выдаётся за «чисто». Сканирующий гейт, не нашедший ни одного файла
    своего типа, молчал с кодом 0 — так же, как на проверенном и чистом проекте (10 из 13
    записей). Теперь он печатает «пусто: … — проверять было нечего», остаётся зелёным, а
    doctor --run показывает строку под галочкой. Если файлы скрыл .aqkignore, это названо.
    env-secrets-not-committed и personal-config-not-shared «пусто» не говорят: для них
    отсутствие файлов и есть чистый ответ.
  • Код в vendor/, coverage/ и других пропускаемых каталогах больше не определяет язык
    проекта.
    Список пропусков был записан дважды — сорок имён у гейтов, восемь у определения
    языков, — и doctor советовал записи по файлам, которые сами записи не читают. Теперь список
    один, в kit/gates/_skip.sh.
  • Осознанно снятая защита снова видна. protection-not-removed печатал «совет: снято
    осознанно …» с кодом 0, а прогон у зелёного гейта показывает только строки-советы и узнавал
    одну метку «почини:». Строка не доходила до человека. Теперь узнаются обе, а модульная
    проверка сверяет каждую метку, которую печатают гейты, с тем, что узнаёт прогон.
  • Неизвестное время гейта в отчёте — прочерк, а не «0.0 с». Строки истории старше поля
    времени показывались нулём, то есть «гейт отработал мгновенно». Единица времени теперь на языке
    отчёта: в английский попадала русская «с».
  • Время в отчёте — местное. Шапка и подписи графика показывали время по Гринвичу: прогон в
    18:47 выглядел как 13:47, то есть как чужой.
  • Мусорный предел больше не выключает гейт. AQK_MAX_DEPTH=abc у complexity-limit и
    AQK_DUP_LINES=abc или -3 у duplicate-code давали зелёный на заведомом браке без единой
    строки. Теперь — код 2, «проверка не состоялась», с именем переменной.
  • deps-are-pinned видит обычный package.json и конвейер, выключивший lock-файл. Первая
    зависимость на новой строке принималась за «зависимостей нет». Теперь ещё и pnpm install --no-frozen-lockfile в .github/workflows при pnpm-lock.yaml — находка с файлом и строкой.
  • Порог --min из мусора — отказ до прогона. --min -1 проходил при любом уровне, --min ""
    становился нулём. Теперь допустима только ступень от 0 до верхней, как у --jobs.
  • Кэш ruff больше не отдаёт вчерашнее «чисто». Ключ его кэша — время изменения файла: правка,
    после которой время вернули прежним (cp -p, tar, unzip), проходила гейт. У рецептов ruff
    теперь --no-cache.
  • Конфигурация анализатора больше не выключает объявленный гейт. Исключение пути в конфиге
    ruff, pylint и vulture снимало находку при нарушении в коде; рецепты теперь отменяют его.
  • Переписанное ожидание теста называется вслух, а прогон предупреждает, когда индекс и рабочая
    копия расходятся: зелёный вердикт относился бы не к тому, что уйдёт в коммит.
npx agent-quality-kit doctor