Skip to content

v0.19.0

Latest

Choose a tag to compare

@github-actions github-actions released this 27 Sep 14:21
· 1 commit to main since this release

Выпуск про одно: «поставил» не значит «работает» — и 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.sh here-документ перебивал трубу, и скрипт насчитывал
    ноль рукописных копий при любых данных (результат нигде не опубликован). Остальное — долг под
    храповиком 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