Repository navigation
v0.13.0
Выпуск про одно: всё, что кит печатает зелёным, доказано — отзыв с живого проекта на
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, ниgitleaks8.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 им следует»; «"Runnpm testbefore 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