Skip to content

v0.11.0

Choose a tag to compare

@github-actions github-actions released this 10 Sep 13:10
· 175 commits to main since this release
303245f

Выпуск про одно: проба впервые заработала на чужих проектах — и первым делом поймала нас
самих.
До него 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