Repository navigation
v0.18.0
Выпуск про одно: 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