Skip to content

v0.13.0

Choose a tag to compare

@github-actions github-actions released this 11 Sep 09:03
· 149 commits to main since this release
6ba3615

Выпуск про одно: всё, что кит печатает зелёным, доказано — отзыв с живого проекта на
TypeScript и Biome нашёл места, где это было не так. Проба больше не засчитывает поимку, когда
гейт упал по своей причине; заявка covers: сверяется правилами того линтера, которым закрыт
гейт, — Biome и eslint, а не только ruff; неустановленная запись — ○, а не красный крест.

И то, что нужно проекту, где проверок больше тридцати: группы и --only / --skip для гейтов,
которым нужен стенд, --jobs N для параллельного прогона, служебные файлы .aqk/ сами уходят
в .gitignore. Новая запись env-secrets-not-committed — пароли в .env, которых не видит ни
один сканер секретов; её доказательство — случаи из журнала, а не придуманный образец.

Что может выглядеть иначе после обновления: init дописывает строки в .gitignore;
отсутствие .aqk/docs и .aqk/rules больше не роняет прогон; внутри конвейера (CI=true)
проба сама не запускается — ставьте её отдельной задачей.

Исправлено

  • Проба засчитывает «поймано» только по делу. Раньше «гейт покраснел после подсадки» и
    «гейт поймал брак» были одним и тем же: код возврата сравнивался, вывод выбрасывался. Отзыв с
    живого проекта на TypeScript и Biome: класс «цвет из токена темы» отмечен пойманным линтером,
    хотя Biome цвета не проверяет, — подсаженный кусок ломал форматирование. Итог «каждый класс
    кем-то ловится» был ложной уверенностью. Теперь поимка подтверждается ПАРОЙ, тем же приёмом,
    каким мы проверяем чужие гейты: гейт обязан назвать подсаженный файл и промолчать на ЗЕЛЁНОМ
    образце той же записи в том же месте. Краснеет и на зелёном — «падает от самой подсадки»;
    файла не назвал — «упал по своей причине»; оба — «поимка не доказана», а не «поймано».
    Воспроизведено на проекте с biome check .: старая проба — «ловит: lint», новая — «покраснело:
    lint (краснеет и на зелёном образце) — поимка не доказана»; настоящая поимка осталась поимкой
  • Заявка covers: сверяется правилами ТОГО линтера, которым закрыт гейт. Раньше коды ruff
    (T20, C901, BLE) искались в любом конфиге, и в проекте на Biome заявка «lint держит
    no-print-in-prod» была «не подтверждена» всегда — хотя noConsole стоял. Теперь линтер гейта
    узнаётся по команде, по npm-скрипту, который она зовёт, или по единственному конфигу линтера;
    правила берутся на его языке: ruff — коды из рецепта, eslint — имена правил из рецепта,
    Biome — новое поле записи biome_rules (имена сверены по схеме конфигурации Biome 2.5.12).
    Исходов стало три: «не подтверждена»; «неверна — у линтера нет такого правила» (у Biome нет
    правила под TODO); «проверить не умею» — тускло, а не обвинением. На живом проекте с Biome
    три ложных «не подтверждена» ушли
  • Проба сама не запускается внутри doctor --run в конвейере. Раз в сто коммитов она
    добавляла 2–3 минуты в случайный прогон CI. Теперь в конвейере (CI, GITHUB_ACTIONS, …)
    печатается одна строка — когда проба подошла по сроку — с советом поставить её отдельной
    задачей; AQK_PROBE=1 включает прежнее поведение. У человека проба по-прежнему идёт сама
  • vitals спрашивает npm view, если прямой запрос к реестру не прошёл. fetch в Node не
    знает прокси и зеркала из .npmrc, и vitals писал «не достучался до реестра» там, где
    npm view работал
  • В aqk help у vitals было undefined вместо описания. Исправлено, и заведён сторож:
    у каждой команды справки обязано быть описание на обоих языках
  • Проба больше не пишет «рабочее дерево не трогается», записывая .aqk/last-probe.md.
    Теперь: «файлы проекта не меняются; итог пробы пишется в .aqk/last-probe.md»

Добавлено

  • doctor --run --jobs N — независимые гейты параллельно. 34 гейта у живого проекта шли друг
    за другом больше минуты, «а быструю проверку, которую долго ждать, перестают запускать». На этом
    репозитории 30 гейтов: около 110 с по одному, 68 с с --jobs 3. По умолчанию выключено: гейты,
    пишущие в одни файлы, вместе падали бы через раз. Каждый гейт выполняется в рабочем потоке тем
    же spawnSync с тем же таймаутом, что и раньше; вывод — в порядке объявления

  • Группы гейтов и doctor --run --only / --skip. Отзыв с живого проекта: гейт цены меряет
    план на засеянной базе — объявишь, и он валит прогон без стенда; уберёшь, и promise-has-gate
    справедливо ругается. Прогон бывал только «всё или ничего». Теперь groups: { stack: [cost] }
    в манифесте и --skip stack в быстром прогоне; принимаются и группы, и имена гейтов.
    Пропущенные названы в выводе и в .aqk/last-run.md строкой «~ не запускался» — блок для
    агента читает их как «неизвестно», а не как зелёные. Неизвестное имя — отказ с причиной

  • Совет — на языке линтера проекта. «Начните с трёх» и находки пробы советовали eslint
    проекту на Biome: комплект читал package.json и Makefile, но не biome.json. Теперь при
    biome.json в корне команда даётся для Biome — одно правило разово:
    npx @biomejs/biome lint --error-on-warnings --only=suspicious/noConsole .. Флаг
    --error-on-warnings обязателен: правило вне рекомендованных Biome ставит на
    «предупреждение», и без флага команда выходила с нулём, напечатав находку. Имена правил и
    поведение проверены на Biome 2.5.12

  • Запись env-secrets-not-committed: пароли из .env не лежат в git. Замер: на
    закоммиченном .env пароль, придуманный человеком (Sup3rS3cret2024), не видят ни наш
    secrets-not-in-code, ни gitleaks 8.30.1 — у него нет ни формата, ни энтропии; .env.local
    не видит даже detect-secrets. Два правила: .env.local/.env.*.local в git — всегда
    находка; остальные .env* — если внутри ключ-секрет с настоящим значением. Не «любой .env»:
    dotenv рекомендует коммитить зашифрованный dotenvx, Next.js — .env.test, в проектах на Vite
    коммитят публичные настройки. Значение секрета в вывод не печатается. Замер на 11 живых
    репозиториях (включая Vite с 16 закоммиченными .env) и на пяти с закоммиченным
    .env.production.local из поиска кода GitHub: гейт краснеет на всех пяти, четыре находки
    настоящие, два ложных срабатывания (фикстуры в tests/ и демо в playgrounds/) закрыты
    исключением. Запись зрелая: случай в журнале шишек

  • Блок для агента говорит, что делать дальше и когда какую команду запускать. Раньше
    context отвечал только «как дела»: уровень, красное, проба. Три первых шага doctor
    знал, а в контекст они не попадали; карта команд жила только в --full, в восьми тысячах
    токенов, где агент её пролистывал. Теперь в коротком блоке:

    • «Дальше» — до трёх шагов из того же расчёта, что у doctor: завести стандарт, если
      .aqk.yml нет; объявить проверки, которые у проекта уже есть; закрыть классы, которые
      проба подсадила и ваши проверки не поймали; «начните с трёх». У каждого — готовая команда
    • «Когда что» — правила «ситуация → команда»: перед коммитом (зависит от того, стоит ли
      хук), после правки проверки (aqk prove), метка арбитра в своде, «проверка мешает — не
      ослабляй, спроси владельца», «готово = aqk report --since main»

    Форма — по документации Claude Code: «чем конкретнее и короче инструкции, тем стабильнее
    Claude им следует»; «"Run npm test before committing" instead of "Test your changes"».
    Блок вырос с ≈375 до ≈500 токенов

Изменено

  • init дописывает служебные файлы .aqk/ в .gitignore. last-run.md, last-probe.md,
    advice-shown, update-checked — состояние машины, их переписывает каждый прогон. Отзыв с
    живого проекта: last-run.md однажды закоммитили, и каждый make check оставлял изменённый
    файл. Методички и правила в .aqk/ по-прежнему коммитятся. Для тех, кто поставил раньше,
    doctor называет служебный файл, который видит git, — с готовой командой git rm --cached
  • Неустановленная запись каталога — ○, а не ✘. Крест в зелёном прогоне глаз читает как
    провал, и через неделю человек перестаёт смотреть на красное вообще. ✘ теперь значит одно:
    упало или пропустило брак
  • Нет .aqk/docs или .aqk/rules — прогон не краснеет. Методички — пособие, проект вправе
    держать их где-то ещё; пункт показан как совет (○). Точка входа, .gitignore и .git
    остаются обязательными
  • Первый doctor показывает главное вверху. Раньше сначала шёл список всех записей по две
    строки на каждую (вторая — «поставить: aqk add …»), и на requests «у вас уже есть» и «начните с
    этих трёх» начинались со строки 84 из 102. Теперь порядок: что уже держит → что у вас уже есть →
    что проверки пропустили → начните с трёх → остальные записи по одной строке с одной общей
    подсказкой → неприменимое. Подсмотрено у agentlint: у них первыми идут пять главных исправлений
npx agent-quality-kit doctor