Repository navigation
v0.11.0
Выпуск про одно: проба впервые заработала на чужих проектах — и первым делом поймала нас
самих. До него probe запускалась у одного репозитория из семи; замер на десяти живых
проектах (chalk, execa, axios, dependency-cruiser, express, requests, click, flask, httpx,
black — от 377 до 6494 коммитов, с установленными зависимостями и объявленными СОБСТВЕННЫМИ
командами каждого) показал, что механика была недостижима для настоящего кода.
Пока её чинили, вскрылись четыре места, где наши же проверки молча зеленели там, где не
могли работать. Это тот самый класс, против которого написан весь стандарт.
Изменено — поведение, которое может покраснеть у вас
- Гейт, читающий историю, без репозитория выходит с кодом 2, а не 0. Раньше
commit-explains-itselfиtest-not-adjustedв каталоге без git отвечали «проверять нечего»
и код 0 — то есть «не смогли посмотреть» было неотличимо от «проверено и чисто». Договор
комплекта: 0 чисто, 1 находка, ВСЁ ОСТАЛЬНОЕ «не смогли». Если вы гоняете эти записи вне
репозитория, прогон станет красным — и это правда, а не регресс - Рецепты
ruffполучили-q --output-format=concise, рецептыeslint—
--no-config-lookupи исключение образцов. Причина в «Исправлено» ниже
Добавлено
- Проба работает на любом проекте. Образец подсаживается в КОПИЮ ПРОЕКТА, гейт запускается
в ней своей командой КАК ЕСТЬ — в неё больше ничего не подставляется. Раньше пробовать можно
было только команды, кончающиеся каталогом; замер на семи чужих репозиториях: у шести из семи
команды такие (xo,eslint lib/**/*.js,mocha --require…,pytest), и проба не
запускалась вовсе. Способ не выдуман — так двадцать лет устроено мутационное тестирование:
Stryker копирует проект во временный каталог, симлинкуетnode_modulesи гоняет родную
команду. Копируется РАБОЧЕЕ ДЕРЕВО, а не HEAD: комплект зовут из хука до коммита - Сухой прогон по чистой песочнице — без него «покраснел от подсадки» неотличимо от «был
красным и до неё». Гейт, красный до подсадки, и гейт, позеленевший от неё, из суждения
исключаются: засчитывать чужой долг за свою поимку нельзя - Проба видит JavaScript. Красные и зелёные образцы
.jsдля шести записей; семьи
расширений — образец.jsгодится файлам.mjsи.cjs. До этого в каталоге было 28
записей и НОЛЬ образцов на.js, то есть проба была слепа к самому распространённому языку
и к собственному коду комплекта - Цена пробы перестала расти файлами. Длительности берутся из сухого прогона, гейты идут от
быстрых к медленным, на первом красном — ранний выход, слишком медленные исключаются и
НАЗЫВАЮТСЯ ПОИМЁННО. Замер: 103 секунды вместо таймаута на 600 doctorназывает ЧЕЛОВЕКУ, сколько обещаний не сторожит машина. Числа считались и
печатались давно — но только в блокеcontext, который читает АГЕНТ. Единственный, кто
обязан помнить о непроверяемом обещании, был единственным, кому о нём не сообщали. Найдено не
нами: отчёт живого проекта
Исправлено
- Проверка, которая не может работать, зеленела. Подмена общей библиотеки
kit/gates/_skip.shдавала код 0: гейт печатал «command not found» и объявлял проект чистым.
Библиотеку подключает КАЖДАЯ запись каталога — одним испорченным файлом гасился весь набор
защит. Теперь библиотека ставит метку последней строкой (так ловится и обрыв файла на
середине), и все двенадцать подключений её проверяют - Родной рецепт выдавал НАШИ ЖЕ красные образцы за находки пользователя.
aqk addкладёт
их в проект — без нихproveничего не докажет, — и они существуют, чтобы быть
неправильными.ruffперешёл на многострочные блоки, а обход построчный и вырезать блок не
может. Итог: поставил запись при установленном ruff — получил вечно красный конвейер на
файлах, которые положили МЫ - Рецепты
eslintне запускались вовсе. ESLint 9+ требуетeslint.config.*; четыре записи
каталога на javascript и typescript у пользователя молча падали с кодом 2. Исключение теперь
на ВХОДЕ, а не фильтром вывода: ESLint 10 выкинул однострочные форматы из ядра, и подгонять
фильтр под формат каждого инструмента — гонка, которую не выиграть - Проба выдавала «не проверено» за «чисто». Итог считался одним числом: исходов три, веток
было две, иunknownмолча падал в «поймано всё». Проба, где ЕДИНСТВЕННАЯ запись вернула
«инструмент не установлен», печатала «каждый применимый класс кем-то ловится» - Проба врала о манифесте. При объявленных гейтах, которым некуда подставить каталог, она
говорила «гейтов не объявлено, сначала aqk add» — и отправляла заводить то, что уже заведено - Проба завышала число втрое. Считала класс × файл: шесть классов на трёх горячих файлах
превращались в «18 непокрытых». Считали события, а называли их сущностями — ровно тот приём,
который ловим у других complexity-limitбыл вдвое слеп к JavaScript. Мерил вложенность делением отступа на
четыре, а в JS отступ — два пробела: шесть уровней давали «три» и проходили предел молча.
Дефект был невидим, пока в каталоге не было ни одного образца на.js- §10
PROJECT.mdутверждал, что соседи не про готовность к работе агентов. Неправда:
Factory Agent Readiness (9 столпов, 5 ступеней, 100+ сигналов) иkodustech/agent-readiness
(109 звёзд, 39 проверок) — ровно про неё. Соседи названы поимённо и с размером - Числа в обещаниях разошлись с фактом. Пакет: обещано «230 КБ» в трёх живых местах, на
деле 574. Методички: «13 файлов, 4312 строк» против 14 и 4663
Границы, названные вслух
- Обещание вне точки входа не проверяет НИЧТО, и стандарт об этом даже не сообщал.
Расширять область нельзя дёшево: распознаватель ловит любой выделенный пункт списка и на
связанных документах утонет в ложных срабатываниях - Свойства работающей системы — скорость, память, поведение под нагрузкой — чтением файлов
не проверяются вовсе. Это граница замысла, а не пробел - Правило со сторожем-человеком не сторожит никто. В нашем собственном своде так помечено
12 правил из 14
npx agent-quality-kit doctor