Repository navigation
Выпуск про одно: «поставил» не значит «работает» — и AQK теперь говорит, что поставить.
aqk adopt засчитывает проверку, только если она объявлена, краснеет на заведомом браке и идёт
в конвейере. doctor называет инструменты, которые подходят проекту и нигде не стоят, — словами
человека и с командой установки, — и показывает, какие правила .aqk/rules держит проверка, а
какие только человек. Про четырнадцать сторонних инструментов AQK знает, как каждый незаметно
выключают, — по их официальной документации, с дословной цитатой.
Что может выглядеть иначе после обновления. В doctor два новых блока: сводка по папке
правил («держит проверка — N, человек — M» и команды aqk add для обещанных, но не поставленных
проверок) и «Что ещё стоит поставить». Если npx не смог запустить инструмент (нет сети, нет
прав на кеш), гейт отвечает «не смогли проверить» (код 2), а не «находка». entry-commands-exist
в проекте на CMake или autotools пишет «цели make не проверены» вместо обвинения. Правила в
.aqk/rules несут пометки <!-- aqk: … -->; чтобы обновить уже разложенные копии, удалите папку
.aqk/rules и запустите aqk init — без --force, он перезаписывает и .aqk.yml.
Добавлено
doctorсоветует, что поставить, — словами человека. Блок «Что ещё стоит поставить»: до
трёх инструментов вне каталога, которые подходят репозиторию по его признакам и не стоят ни в
одной проверке, — что поймает, как поставить и как доказать (aqk adopt). Пример: «schemathesis —
есть описание API — расхождение API с его описанием…». Попутно найдено: у axe и k6 в условии стояли
признаки, которыхdoctorне вычисляет (has_frontend,has_server), — совет по ним не сработал
бы никогда; теперь это сторожит приёмкаunits-tools.mjs. Новый признакhas_gh_actions(zizmor
проверяет только GitHub Actions).- У каждого правила
.aqk/rulesназван сторож, иdoctorговорит, чего не хватает. 47 правил
размечены<!-- aqk: … -->: 12 держит запись каталога, 35 — человек.doctorпечатает сводку и
по каждой обещанной правилами проверке, которой нет в манифесте, — командуaqk add. Разметку
сторожитunits-rules.mjs: пометка обязана вести в существующую запись, русская и английская
копии — совпадать. Повод — замеры 2026 года: правило текстом агент соблюдает всё хуже с каждой
новой функцией, а файлы правил не поднимают долю решённых задач. - Две новые методички.
engineering-glossary.md— словарь понятий, которыми ставят задачу
агенту и проверяют его код (связанность, DRY, идемпотентность, N+1, законы Люссера, Гудхарта,
Конвея, Хайрама, рамки RED/USE/DORA, 29 признанных стандартов).agent-evaluation-2026-06.md—
исследования весны 2026 о подгонке под проверку: названия всех работ arXiv сверены заново, три
числа поправлены по аннотациям. - Гейт
private-names— закрытые проекты владельца не попадают в публичный репозиторий.
Сверяет каждое слово файлов с отпечатками SHA-256 запрещённых имён: самих имён в репозитории нет,
и в выводе слово не печатается. Сверка нашла 83 упоминания закрытого проекта в текущих файлах —
убраны; снимок его проверок (kit/docs/ai/quality-gates-checklist.md) удалён целиком. - JavaScript комплекта — под biome (гейт
biome,tool/selfcheck/biome.sh,biome.json).
Выбран замером наtool/: eslint с рекомендуемыми правилами — 50 замечаний, biome — 88, из них
43 про оформление; по сути оба нашли одно. biome — одна программа без пакетов в нашем
package.json. Правила оформления выключены, предупреждения считаются находками
(--error-on-warnings). Неиспользуемые импорты (9) и переменные (2) убраны сразу, остальные 36
замечаний — долг под храповиком. - Скрипты оболочки комплекта — под shellcheck (гейт
shellcheck,tool/selfcheck/shellcheck.sh).
Первый прогон: 88 замечаний. Две ошибки исправлены сразу, одна из них настоящая — в
research/corpus/handwritten-vs-generated.shhere-документ перебивал трубу, и скрипт насчитывал
ноль рукописных копий при любых данных (результат нигде не опубликован). Остальное — долг под
храповикомratchets/shellcheck.txt: новое замечание не пройдёт. Сведения о shellcheck — в
kit/tools/: порог-S errorпрячет предупреждения, в том числе подстановку без кавычек. - Поле манифеста
own_samples:— образцы проверок, написанных самим проектом.npm test,
make check, свои скрипты доказываются по<own_samples>/<имя>/red|green, отдельно от
каталога записей (samples:): там образец своей проверки читался бы как новая запись. Так же
принято снаружи — у semgrep тест правила лежит рядом с правилом. У самого AQK:checks/gates,
образцы для всех семи собственных прогонов и дляdead-code— все 31 гейт комплекта
доказаны. Свои образцы берутся раньше образцов каталога: запись бывает поставлена не тем
рецептом, под который написаны её образцы (у насdead-codeна knip, а образцы записи —
питоновские). - Доказательство подсадкой — только в
aqk proveиaqk adopt.doctor --run,badgeи
reportего пропускают и называют это: копия проекта и три прогона гейта втрое дороже самого
гейта (на AQK — 3 с → 22 с). В нашем конвейереproveидёт отдельным шагом заданияcheck, и
общее время от этого не растёт — его задаёт задание windows. proveдоказывает любую команду проекта, а не только команду из каталога. Раньше
npm run lint,make check,ruff checkсо своим конфигом назывались «недоказуемыми»:
подставить каталог образца было некуда. Теперь дерево красного образца кладётся по своим путям
в копию проекта, команда идёт как есть и обязана покраснеть; на зелёном — промолчать. Копия
сначала проверяется чистой: команда, красная без подсадки, называется отдельной причиной.
Рабочее дерево не меняется.aqk adopt <гейт>— договор установки: «поставил» не значит «работает». Код 0, только
если гейт объявлен, у него есть красный и зелёный образцы, он доказан на них и идёт в
конвейере. Для каждого непройденного шага — что именно сделать и куда положить. «Прочитать
официальную документацию» печатается шагом для агента и не засчитывается: машина его не
проверяет. Повод — замер того же дня: Stryker по умолчанию не роняет сборку никогда
(thresholds.break: null), и у 96 из 149 настоящих файлов его настроек на GitHub порога нет.
Сводка для агента теперь велитadoptпосле любой установки инструмента.- Сведения о сторонних инструментах —
kit/tools/: ruff, eslint, biome, knip, Stryker, jscpd, vulture, gitleaks, zizmor, mutmut, schemathesis, k6, axe.adoptопознаёт
инструмент по команде гейта (и по скриптуpackage.json, который она зовёт) и говорит, не
заглушён ли он:ruff --exit-zero,ruff check --fixбез--exit-non-zero-on-fix,ruff formatбез--check, eslint с правиламиwarnи без--max-warnings 0, eslint с
--no-error-on-unmatched-pattern; biome с правиламиwarnбез--error-on-warnings, правила
info(не роняют никогда),--no-errors-on-unmatched,--skip-parse-errors; knip с
--no-exit-codeили--max-issuesбольше нуля; Stryker безthresholds.break(задаётся только в
файле настроек — из команды его не передать) и сallowEmpty; jscpd с--exit-code 0и без
--fail-on-empty; vulture с--min-confidenceвыше 60 (прячет все неиспользуемые функции и
классы); gitleaks с--exit-code 0; zizmor с--no-exit-codes,--format=sarifи--fix.
mutmut не роняет проверку ни при каком числе выживших мутантов — документация об этом молчит,
установлено замером (mutmut 3.8.0:runиresultsвыходят с нулём), и правило помечено как
замер, а не цитата; в починке — обёртка, проверенная на том же проекте. schemathesis, сужённый
до--checks not_a_server_error; k6 безthresholdsв скрипте теста (скрипт читается по пути из
команды) и с--no-thresholds; axe без--exit.
Каждое правило — с дословной цитатой из официальной
документации и адресом; цитаты сверяет с исходникомtool/selfcheck/tools-quotes.mjs, примеры
каждого правила прогоняетunits-tools.mjs.
Изменено
- Пуш и выпуск быстрее, проверок столько же.
smoke.shзапускает свои две части — 113
проверок оболочки и 192 проверкиnode --test— одновременно, а не одну за другой: локально
98 → ≈70 с, счёт тот же, 305. Конвейер на Windows разложен на три параллельных задания
(каталог, две частиsmoke) вместо одного одиннадцатиминутного. Выпуск больше не повторяет
прогон гейтов, а требует зелёного конвейера на этом же коммите — то есть ещё и Windows с
образом, которых прежний шаг выпуска не смотрел.
Исправлено
checkwashподнят с 0.3.4 до 0.4.2 — в конвейере и локально. 0.3.4 объявлял «тест пропал»,
когда в файл тестов добавляли случаи в массив; в 0.4.2 этого нет, образцы записи
test-not-adjustedна новой версии доказаны заново (aqk adopt).entry-commands-existбольше не обвиняет проект на CMake. Если Makefile создаёт генератор
сборки (CMake, autotools), цели make называются «не проверены», а не «нет такой цели»; общее
правило%:(Makefile Sphinx) принимает любую цель; «make» в комментарии#внутри блока кода —
текст. Найдено при подготовке письма в чужой репозиторий: все четыре находки оказались ложными.aqk proveбольше не подписывает сбой проверки как «команда пустая»: это «НЕ СМОГЛИ доказать —
сбой самой проверки», жёлтым, с причиной и хвостом вывода — как и «красная без подсадки».- npm, не сумевший запустить инструмент, — «не смогли проверить», а не находка.
npx knip
без кеша (контейнер без домашнего каталога), без сети или с недоступным реестром выходит с кодом
1 — тем же, каким knip сообщает о мёртвом коде, и AQK объявлял исправный гейт сломанным.
Подпись собственной неудачи npm —npm error code E…(npm ERR! code E…у старых версий), кроме
ELIFECYCLE: так старый npm подписывает упавший скрипт, то есть находку. Правило в двух копиях —
tool/lib/execution.mjsиkit/gates/_native.sh, сверка вsmoke/gate-errors.test.mjs. aqk proveпечатает под сломанным гейтом последние строки его вывода: «покраснел на зелёном»
без причины отправлял гадать.aqk noteбольше не принимает любой эмодзи за отметку итога. Проверка стояла как
/[✅🔧📜👤]/без флагаu: три отметки из четырёх — пары суррогатов, и класс символов
совпадал с их половинками, то есть с 😀 тоже. Нашёл biome, поставленный на сам комплект.- Две строки каталога (
needRulesMissing,needGates) были вставлены дважды, и вторая молча
затирала первую. Нашёл тот же линтер. - Проверки комплекта больше не плавают от загрузки машины. 148 мест вида
printf "$X" | grep -qвsmoke.sh,gates.shиkit/ratchet/ratchet.shподpipefail:
grep -qвыходит, найдя совпадение,printfполучает SIGPIPE, и найденное читается как
ненайденное — чем больше текст и занятее машина, тем чаще. Нашлось, когдаsmokeпокраснел на
исправном коде только подprove. Теперь текст подаётся строкой (функцияhas), возврат
ловушки сторожитunits-verdict.mjs. smoke.sh,gates.sh,mutation.shвыходят с кодом 0 или 1, а не с числом провалов. Два
провала давали код 2 — по договору гейтов «не смогли проверить», а не находка; 256 провалов
дали бы 0. Сторожитunits-verdict.mjs.- Копия проекта для подсадки — репозиторий, а не папка.
clone --shared(полсекунды, работает
из мелкого клона конвейера) плюс рабочее дерево поверх: проверки, читающие историю и индекс,
в копии больше не падают сбоем. Чистая копия гоняется только тогда, когда зелёный образец
покраснел, — два прогона вместо трёх. syntax.shпроверяет и новые файлы, ещё не добавленные в git, а вне репозитория обходит
каталог сам. Прежде он бралgit ls-files: новый файл с ошибкой синтаксиса проходил зелёным,
а вне git список был пуст и проверка отвечала «чисто». Пустой список теперь — «не смогли
проверить», код 2. Нашёл договор установки: подсаженный в копию проекта сломанный файл прошёл.- Рецепт
duplicate-codeпод JavaScript и TypeScript зовётjscpd@5.3 … --fail-on-empty.
Прежнийjscpd@5без флага выходил с нулём, если фильтр--formatне пропустил ни одного
файла, — «клонов нет», когда не проверено ничего. Флага нет в 5.1, аnpxотдаёт то, что
лежит в кеше, поэтому версия закреплена до 5.3. Нашло новое правилоkit/tools/jscpd.jsonна
нашем же рецепте. - Прогон, сделанный после коммита, больше не называется «старее последнего коммита». Время в
.aqk/last-run.mdпишется по Гринвичу, а читалось как местное: в UTC+5 любой прогон в первые
пять часов после коммита объявлялся агенту устаревшим. Теперь читается по Гринвичу, пишется с
секундами, а человеку и агенту показывается по местным часам. doctorбез--runбольше не пишет «45 гейтов не запускалось», когда прогон был полчаса
назад: он называет последний прогон — когда и сколько зелёных из скольких.- Ступень AQK-1 называет настоящую причину. Если в манифесте
rules:указывает на
несуществующую папку,doctorтак и говорит, а не просит «укажи rules». Строка раскладки про
эту папку больше не называет её «советом»: без неё ступень не засчитывается. vitalsговорит, если конвейер закрепил старую версию AQK: на GitHub проверки тогда слабее,
чем на машине. Прогон это не роняет.- Упавший раннер
node --testбольше не выглядит зелёным вsmoke.sh. Если он не дал ни
одного результата или вышел с ошибкой без упавшей проверки, мост молчал и итог считался
чистым. Теперь это отдельная красная строка.
npx agent-quality-kit doctor