agent-quality-kit 0.10.1 → 0.12.0

package/README.md

@@ -14,13 +14,18 @@ Your `AGENTS.md` says what the project promises. Nothing checks that those promi
 that the commands it lists even run. AQK is that missing layer: one command reads the repository,
 reports a level from AQK-0 to AQK-3, and names every guard that is missing.
 
+And one step further than the tools next door: `probe` plants a known defect into a copy of your
+project and checks whether your **declared** guards actually go red. "Tests exist" and "tests
+catch" are different claims — readiness scores measure the first one.
+
 ```bash
 npx agent-quality-kit doctor    # code already exists: your level and what to install
 npx agent-quality-kit start     # no code yet: day-zero guards, right away
 ```
 
 `doctor` only reads. It writes no file and sends nothing anywhere — safe to point at a repository
-you have decided nothing about yet. Nothing to install: `npx` fetches the package (230 KB).
+you have decided nothing about yet. Nothing to install: `npx` fetches the package (574.1 kB, measured 2026-09-10 — nothing guards this number, so check it
+when it matters).
 
 The one exception, named here because it is the only one: with `--brief` (how the hooks run it)
 `doctor` asks the npm registry for its own latest version — **at most once a day, never in CI**,
@@ -41,6 +46,8 @@ Go, Rust, Java, Ruby, PHP, C#, Kotlin, Swift, Scala. Where the project already h
 says so out loud when it falls back.
 
 **Requirements:** Node 18+ and an `sh` shell. Present on macOS, Linux and WSL; Git Bash on Windows.
+On Windows the gates run through Git Bash even when `bash` on your PATH is the WSL stub in
+`System32` — it is found next to `git.exe`; set `AQK_BASH` to point elsewhere.
 
 ### One movement, and everything follows from it
 
@@ -340,7 +347,7 @@ Already using [pre-commit](https://pre-commit.com)? Three lines in the file you
 ```yaml
 repos:
   - repo: https://github.com/arsen-ask-lx/Agent_Quality_Kit
-    rev: v0.10.1
+    rev: v0.12.0
     hooks:
       - id: aqk            # runs what the repository declares; blocks below AQK-1
       # - id: aqk-doctor   # read-only: the level and what is missing, blocks nothing
@@ -361,7 +368,7 @@ layer AQK adds.
 [![on the GitHub Marketplace](https://img.shields.io/badge/GitHub%20Marketplace-Agent%20Quality%20Kit-2ea44f?logo=github)](https://github.com/marketplace/actions/agent-quality-kit-aqk)
 
 ```yaml
-- uses: arsen-ask-lx/Agent_Quality_Kit@v0.10.1
+- uses: arsen-ask-lx/Agent_Quality_Kit@v0.12.0
   with:
     min: 1   # the build fails below AQK-1, or if any declared gate failed
 ```

package/README.ru.md

@@ -14,6 +14,10 @@
 вообще перечисленные там команды. AQK — тот самый недостающий слой: одна команда читает
 репозиторий, называет ступень от AQK-0 до AQK-3 и перечисляет каждого недостающего сторожа.
 
+И один шаг дальше, чем соседние инструменты: `probe` подсаживает заведомый дефект в копию вашего
+проекта и смотрит, покраснеет ли **объявленная** защита. «Тесты есть» и «тесты ловят» — разные
+утверждения, и оценки готовности меряют первое.
+
 ```bash
 npx agent-quality-kit doctor    # код уже есть: уровень и что поставить
 npx agent-quality-kit start     # кода ещё нет: сторожа дня 0 сразу
@@ -21,7 +25,8 @@ npx agent-quality-kit start     # кода ещё нет: сторожа дня
 
 `doctor` только читает: ни одного файла не пишет и никуда ничего не отправляет — его можно
 направить на репозиторий, о котором ещё ничего не решено. Ставить ничего не нужно, `npx` скачает
-пакет сам (230 КБ).
+пакет сам (574.1 kB, замер 2026-09-10 — это число не сторожит никто, так что при случае
+перемерьте).
 
 Единственное исключение, и названо оно здесь именно потому, что единственное: с `--brief`
 (так его запускают хуки) `doctor` спрашивает у реестра npm свою последнюю версию — **не чаще
@@ -43,6 +48,8 @@ TypeScript, Go, Rust, Java, Ruby, PHP, C#, Kotlin, Swift, Scala. Там, где
 сообщает, когда откатилась на переносимый.
 
 **Требуется:** Node 18+ и оболочка `sh`. Есть на macOS, Linux и в WSL; на Windows — Git Bash.
+На Windows гейты идут через Git Bash, даже если `bash` в PATH — заглушка WSL из `System32`:
+он ищется рядом с `git.exe`; другой путь задаётся `AQK_BASH`.
 
 ### Одно движение, из которого следует всё остальное
 
@@ -343,7 +350,7 @@ aqk badge --check  # в конвейере: код 1 в тот день, ког
 ```yaml
 repos:
   - repo: https://github.com/arsen-ask-lx/Agent_Quality_Kit
-    rev: v0.10.1
+    rev: v0.12.0
     hooks:
       - id: aqk            # запускает объявленное; роняет коммит ниже AQK-1
       # - id: aqk-doctor   # только осмотр: уровень и чего не хватает, ничего не роняет
@@ -362,7 +369,7 @@ repos:
 [![в GitHub Marketplace](https://img.shields.io/badge/GitHub%20Marketplace-Agent%20Quality%20Kit-2ea44f?logo=github)](https://github.com/marketplace/actions/agent-quality-kit-aqk)
 
 ```yaml
-- uses: arsen-ask-lx/Agent_Quality_Kit@v0.10.1
+- uses: arsen-ask-lx/Agent_Quality_Kit@v0.12.0
   with:
     min: 1   # сборка падает ниже AQK-1 или если упал любой объявленный гейт
 ```

package/kit/gates/_native.sh

@@ -21,6 +21,10 @@ shift || true
 [ "$#" -gt 0 ] || { echo "нечего запускать: не передана команда инструмента"; exit 2; }
 
 . "$(dirname "$0")/_skip.sh" 2>/dev/null || { echo "не найден _skip.sh рядом с _native.sh"; exit 2; }
+if [ "${AQK_SKIP_READY:-}" != 1 ]; then
+  echo "_skip.sh есть, но обход не собрался — проверка НЕ СОСТОЯЛАСЬ, а не прошла"
+  exit 2
+fi
 
 # Два фильтра, а не один: own_samples_filter прячет образцы гейтов и то, что назвал проект
 # в .aqkignore, а skip_paths_filter — общий список каталогов, который переносимые проверки

package/kit/gates/_skip.sh

@@ -182,3 +182,10 @@ drop_comments() { grep -vE '^[^:]*:[0-9]+:[[:space:]]*(//|\*|#|/\*|--)' ; }
 # `sh` в списке нет намеренно: печать в скрипте — его способ говорить с человеком, и запрет
 # отладочной печати покрасил бы каждый из них.
 only_code() { grep -E "\.($(printf '%s' "$CODE_EXT" | tr ' ' '|'))$"; }
+
+# Метка собранности. Ставится ПОСЛЕДНЕЙ строкой намеренно: она подтверждает, что файл дочитан
+# до конца, а не только начат. Подключающий обязан её проверить — до 2026-09-10 он проверял
+# лишь НАЛИЧИЕ файла, и подмена содержимого давала код 0: гейт печатал «command not found» и
+# объявлял проект чистым. Библиотеку подключает каждая запись каталога, то есть одним
+# испорченным файлом гасился весь набор защит.
+AQK_SKIP_READY=1

package/kit/gates/api-contract-has-arbiter/check.sh

@@ -21,6 +21,13 @@ if [ ! -f "$SKIP_LIB" ]; then
   exit 2
 fi
 . "$SKIP_LIB"
+# Файл на месте — этого мало: подмена содержимого давала код 0. Метка стоит в КОНЦЕ _skip.sh,
+# поэтому проверка ловит и обрыв файла на середине.
+if [ "${AQK_SKIP_READY:-}" != 1 ]; then
+  echo "_skip.sh есть, но обход не собрался — проверка НЕ СОСТОЯЛАСЬ, а не прошла"
+  echo "  почини: замени kit/gates/_skip.sh целым файлом из каталога"
+  exit 2
+fi
 
 # --- есть ли договор ----------------------------------------------------------
 # По имени файла, а не по расположению: спецификацию кладут в корень, в `docs/`, рядом с

package/kit/gates/color-from-token/check.sh

@@ -18,6 +18,13 @@ if [ ! -f "$SKIP_LIB" ]; then
   exit 2
 fi
 . "$SKIP_LIB"
+# Файл на месте — этого мало: подмена содержимого давала код 0. Метка стоит в КОНЦЕ _skip.sh,
+# поэтому проверка ловит и обрыв файла на середине.
+if [ "${AQK_SKIP_READY:-}" != 1 ]; then
+  echo "_skip.sh есть, но обход не собрался — проверка НЕ СОСТОЯЛАСЬ, а не прошла"
+  echo "  почини: замени kit/gates/_skip.sh целым файлом из каталога"
+  exit 2
+fi
 
 # Расширения, где живёт ТЕМИЗИРУЕМЫЙ интерфейс. Своё, а не общий CODE_EXT: там нет ни css, ни
 # vue — они не код в смысле «отладочная печать», но именно в них живёт цвет.

package/kit/gates/commit-explains-itself/check.sh

@@ -15,8 +15,14 @@ if [ -f "$DIR/.aqk-commit-msg" ]; then
   MSG=$(cat "$DIR/.aqk-commit-msg")
 else
   if ! (cd "$DIR" 2>/dev/null && git rev-parse --git-dir >/dev/null 2>&1); then
-    echo "не git-репозиторий — проверять нечего"
-    exit 0
+    # НЕ «проверять нечего», а «проверить нечем»: без истории свидетель слеп, и код 0 здесь
+    # неотличим от «проверено и чисто». Договор комплекта: 0 — чисто, 1 — находка, остальное —
+    # не смогли. Тот же довод уже записан ниже про мелкий клон и в protection-not-removed:
+    # когда свидетель слеп, зеленеть нельзя.
+    echo "не git-репозиторий — историю смотреть нечем, проверка НЕ СОСТОЯЛАСЬ"
+    echo "  почини: запусти проверку в репозитории, либо убери запись из манифеста —"
+    echo "  почини: гейт, который не может посмотреть, не защищает ничего."
+    exit 2
   fi
   # Мелкий клон: у коммита не видно родителя, и git выдаёт всё дерево как изменённое. Состав
   # коммита в этом случае не определить, а требовать отчёт вслепую нельзя — конвейер краснел бы

package/kit/gates/complexity-limit/check.sh

@@ -19,6 +19,13 @@ if [ ! -f "$SKIP_LIB" ]; then
   exit 2
 fi
 . "$SKIP_LIB"
+# Файл на месте — этого мало: подмена содержимого давала код 0. Метка стоит в КОНЦЕ _skip.sh,
+# поэтому проверка ловит и обрыв файла на середине.
+if [ "${AQK_SKIP_READY:-}" != 1 ]; then
+  echo "_skip.sh есть, но обход не собрался — проверка НЕ СОСТОЯЛАСЬ, а не прошла"
+  echo "  почини: замени kit/gates/_skip.sh целым файлом из каталога"
+  exit 2
+fi
 MAX="${AQK_MAX_DEPTH:-5}"
 
 # Тесты исключены намеренно — тем же списком, что и в duplicate-code. Глубокая вложенность в
@@ -36,8 +43,19 @@ find "$DIR" $(skip_find "$DIR") $TESTS -type f \
         # Разметка вложена по природе: пять уровней тегов — это не сложная логика, а обычная
         # вёрстка. Меряя её тем же пределом, гейт краснеет на нормальном коде и его выключают.
         function limit() { return (wf ~ /\.(jsx|tsx|vue|svelte)$/) ? MAX + 3 : MAX }
-        function flush() { if (worst > limit()) print wf ":" wl ": вложенность " worst ", предел " limit() }
-        FNR == 1 { flush(); worst = 0; wl = 0; wf = FILENAME }
+        # Шаг отступа берётся ИЗ ФАЙЛА, а не считается равным четырём. Пока он был прибит к
+        # четырём, проверка видела ВДВОЕ МЕНЬШУЮ вложенность в javascript и typescript, где
+        # общепринятый отступ — два пробела: шесть уровней давали «три» и проходили предел
+        # молча. Замечено 2026-09-10, когда в каталог впервые добавили образец на .js: go и
+        # python отступают на четыре, и на них дефекта не видно в принципе.
+        # Минимум зажат снизу двойкой: файл с одиночным пробелом в продолжении строки иначе
+        # вчетверо завысил бы вложенность и дал ложную тревогу.
+        function unit() { return (step >= 2 && step <= 8) ? step : 4 }
+        function flush() {
+          if (wf != "" && int(worstN / unit()) > limit())
+            print wf ":" wl ": вложенность " int(worstN / unit()) ", предел " limit()
+        }
+        FNR == 1 { flush(); worstN = 0; wl = 0; step = 0; wf = FILENAME }
         /^[[:space:]]*$/ { next }
         {
           # ширина отступа: табуляция считается за четыре пробела. Отступ берётся ОДНИМ
@@ -45,8 +63,8 @@ find "$DIR" $(skip_find "$DIR") $TESTS -type f \
           # символ отступа и стоил больше, чем весь остальной разбор. Замер 2026-09-08 на uv.
           match($0, /^[ \t]*/); ind = substr($0, 1, RLENGTH)
           n = gsub(/\t/, "", ind) * 4 + length(ind)
-          depth = int(n / 4)
-          if (depth > worst) { worst = depth; wl = FNR }
+          if (n > 0 && (step == 0 || n < step)) step = n
+          if (n > worstN) { worstN = n; wl = FNR }
         }
         END { flush() }
       ' > /tmp/.cplx.$$ 2>/dev/null

package/kit/gates/complexity-limit/gate.yml

@@ -4,11 +4,16 @@ intent_en: a function does not grow past the complexity you can hold in your hea
 trigger:
   always: true
 
+# Домашние страницы готовых инструментов, которые зовут рецепты ниже. Адреса сверены
+# по реестру github 2026-09-10, а не написаны по памяти: три выдуманных адреса чужих
+# репозиториев — записанная шишка комплекта.
+tool: https://github.com/astral-sh/ruff · https://github.com/eslint/eslint
+
 recipes:
   # Переносимая мера грубая — глубина вложенности. Готовые правила считают ветвления и
   # инструкции, это точнее; см. kit/docs/ready-made-rules.md
   any: bash {gate}/check.sh {dir}
-  python: ruff check --select C901,PLR0912,PLR0915 {dir}
-  typescript: eslint --rule '{"complexity":["error",10],"max-depth":["error",4]}' {dir}
+  python: ruff check -q --output-format=concise --select C901,PLR0912,PLR0915 {dir}
+  typescript: eslint --no-config-lookup --ignore-pattern 'gates/*/red/**' --ignore-pattern 'gates/*/green/**' --rule '{"complexity":["error",10],"max-depth":["error",4]}' {dir}
 
 proof: incidents/README.md — «2026-08-27 ревизия гейтов», п. 6: 75 функций сложнее нормы, худшая с 29 ветвлениями

package/kit/gates/complexity-limit/red/deep.js

@@ -0,0 +1,15 @@
+export function route(a, b, c, d) {
+  if (a > 0) {
+    if (b > 0) {
+      for (let i = 0; i < c; i++) {
+        switch (d) {
+          case 1:
+            if (a > b) {
+              return 1;
+            }
+        }
+      }
+    }
+  }
+  return 0;
+}

package/kit/gates/dead-code/gate.yml

@@ -10,6 +10,11 @@ trigger:
 # Переносимого рецепта здесь нет намеренно: чтобы понять, вызывают ли функцию, нужен граф
 # вызовов, а не поиск по тексту. Это тот случай, когда без готового инструмента не обойтись —
 # и он есть под каждый распространённый стек.
+# Домашние страницы готовых инструментов, которые зовут рецепты ниже. Адреса сверены
+# по реестру github 2026-09-10, а не написаны по памяти: три выдуманных адреса чужих
+# репозиториев — записанная шишка комплекта.
+tool: https://github.com/jendrikseipp/vulture · https://github.com/webpro-nl/knip
+
 recipes:
   python: vulture --min-confidence 60 {dir}
   typescript: npx --yes knip@6 --directory {dir}

package/kit/gates/duplicate-code/check.sh

@@ -18,6 +18,13 @@ if [ ! -f "$SKIP_LIB" ]; then
   exit 2
 fi
 . "$SKIP_LIB"
+# Файл на месте — этого мало: подмена содержимого давала код 0. Метка стоит в КОНЦЕ _skip.sh,
+# поэтому проверка ловит и обрыв файла на середине.
+if [ "${AQK_SKIP_READY:-}" != 1 ]; then
+  echo "_skip.sh есть, но обход не собрался — проверка НЕ СОСТОЯЛАСЬ, а не прошла"
+  echo "  почини: замени kit/gates/_skip.sh целым файлом из каталога"
+  exit 2
+fi
 WIN="${AQK_DUP_LINES:-8}"
 
 # Тесты исключены намеренно. Повтор в тестах часто осознанный: читаемость там важнее сухости,

package/kit/gates/duplicate-code/gate.yml

@@ -4,6 +4,11 @@ intent_en: the same code does not multiply into copies across the project
 trigger:
   files_gt: 20
 
+# Домашние страницы готовых инструментов, которые зовут рецепты ниже. Адреса сверены
+# по реестру github 2026-09-10, а не написаны по памяти: три выдуманных адреса чужих
+# репозиториев — записанная шишка комплекта.
+tool: https://github.com/kucherenko/jscpd · https://github.com/pylint-dev/pylint
+
 recipes:
   any: bash {gate}/check.sh {dir}
   # jscpd умеет и Python, и TypeScript одним прогоном и считает похожесть, а не совпадение.
@@ -25,6 +30,10 @@ recipes:
   # Родной инструмент стека, а не jscpd: питоновскому проекту незачем ставить Node ради одной
   # проверки. R0801 сравнивает не байты, а разобранный код — переименованная переменная его
   # не обманет, в отличие от переносимого рецепта.
-  python: pylint --disable=all --enable=R0801 --min-similarity-lines=8 {dir}
+  # `--ignore-paths` — исключение на ВХОДЕ, а не фильтром вывода. `aqk add` кладёт красные
+  # образцы в проект, и они по построению дублируют друг друга: без исключения pylint
+  # предъявлял пользователю НАШИ ЖЕ файлы как его дубликаты. Найдено 2026-09-10 табличной
+  # проверкой own-samples в тот час, когда pylint появился на машине.
+  python: pylint --disable=all --enable=R0801 --min-similarity-lines=8 --ignore-paths='.*gates/[^/]+/(red|green)(/|$).*' {dir}
 
 proof: incidents/README.md — «2026-08-25 разбор 1069 коммитов»: число моделей захардкожено в четырёх местах четырьмя разными значениями

package/kit/gates/file-size-limit/check.sh

@@ -18,6 +18,13 @@ if [ ! -f "$SKIP_LIB" ]; then
   exit 2
 fi
 . "$SKIP_LIB"
+# Файл на месте — этого мало: подмена содержимого давала код 0. Метка стоит в КОНЦЕ _skip.sh,
+# поэтому проверка ловит и обрыв файла на середине.
+if [ "${AQK_SKIP_READY:-}" != 1 ]; then
+  echo "_skip.sh есть, но обход не собрался — проверка НЕ СОСТОЯЛАСЬ, а не прошла"
+  echo "  почини: замени kit/gates/_skip.sh целым файлом из каталога"
+  exit 2
+fi
 
 # Один обход и один wc на все файлы разом: на проекте в 36 тысяч файлов цикл с wc на каждый
 # не укладывался в две минуты.