agent-quality-kit 0.6.0 → 0.7.0

package/kit/gates/personal-config-not-shared/check.sh

@@ -0,0 +1,103 @@
+#!/usr/bin/env sh
+# Личный файл агента, попавший в git: то, что человек писал для себя, становится обязательным
+# для всех и никем не рецензируется.
+#
+# ЗАЧЕМ. Дело не в опрятности. `CLAUDE.local.md` дописывается ПОСЛЕ общего свода — дословно из
+# документации: "Within each directory, `CLAUDE.local.md` is appended after `CLAUDE.md`, so your
+# personal notes are the last thing Claude reads at that level"
+# (code.claude.com/docs/en/memory, сверено 2026-09-07). Значит личные заметки одного человека
+# читаются последними и перекрывают общие правила команды — у всех, молча.
+# `.claude/settings.local.json` — то же самое для прав: разрешения, которые один человек выдал
+# себе, достаются всем, кто склонировал репозиторий.
+#
+# Оба файла по устройству личные, и документация говорит об этом прямо: "For private
+# per-project preferences that shouldn't be checked into version control… Add `CLAUDE.local.md`
+# to your `.gitignore` so it isn't committed" и "Claude Code keeps it out of git when it creates
+# the file; if you create it by hand, add it to `.gitignore` yourself".
+DIR="${1:-.}"
+# Существование файла проверяется ДО `.`, а не запасной веткой после. Прежняя строка
+# `. файл 2>/dev/null || запасной_вариант` выглядела страховкой и ею не была: под `sh` (dash)
+# неудачный `.` завершает скрипт немедленно, и ветка после `||` не выполняется никогда; под
+# `bash`, которым гейты и запускаются из манифеста, она выполняется, но подставляет только
+# ПЕРЕМЕННУЮ — функции обхода остаются неопределёнными, конвейер печатает пустоту, и проверка
+# выходит с НУЛЁМ. Замерено 2026-09-08 на файле с настоящим нарушением: гейт сказал «чисто».
+SKIP_LIB="$(dirname "$0")/../_skip.sh"
+if [ ! -f "$SKIP_LIB" ]; then
+  echo "рядом с проверкой нет _skip.sh — обход не собран, проверка не состоялась"
+  echo "  почини: скопируй гейт вместе с файлом kit/gates/_skip.sh, он общий на весь каталог"
+  exit 2
+fi
+. "$SKIP_LIB"
+
+# Образцы (gates.sh) читают список отслеживаемых файлов из `.aqk-tracked`: настоящего git внутри
+# каталога комплекта взять неоткуда, а вложенный .git создал бы embedded-репозиторий.
+# В настоящем проекте такого файла не бывает — спрашиваем сам git.
+# Имя с точкой намеренно: файл `TRACKED` в корне проекта — вещь возможная, и он молча
+# подменял бы собой список git. Найдено код-ревью 2026-09-07.
+if [ -f "$DIR/.aqk-tracked" ]; then
+  LIST=$(cat "$DIR/.aqk-tracked")
+else
+  if ! (cd "$DIR" 2>/dev/null && git rev-parse --git-dir >/dev/null 2>&1); then
+    echo "не git-репозиторий — проверять нечего"
+    exit 0
+  fi
+  # core.quotePath=false ОБЯЗАТЕЛЕН. По умолчанию git заворачивает путь с не-ASCII в кавычки
+  # («"\320\264\320\276\320\272/CLAUDE.local.md"»), и якорь «$» в шаблоне ниже не совпадал:
+  # личный свод в каталоге с русским именем пропускался молча. Тот же класс, что CRLF ниже.
+  # Найдено код-ревью 2026-09-07.
+  LIST=$(cd "$DIR" && git -c core.quotePath=false ls-files 2>/dev/null)
+fi
+# Перевод строки Windows. Без снятия «\r» якорь «$» в шаблоне ниже не совпадал, и красный
+# образец с CRLF становился зелёным. Поймано мутационной проверкой до единого прогона в чужом
+# проекте — ровно то, ради чего она написана.
+LIST=$(printf '%s\n' "$LIST" | tr -d '\r')
+[ -z "$LIST" ] && exit 0
+
+# Репозиторий, который целиком является заготовкой проекта, проверять нечем: все файлы в нём —
+# не чьи-то личные, а рыба для будущего проекта. Признак — файл настроек генератора в корне.
+# Замер: в `Frojd/Wagtail-Pipit` обе находки были такими, и обе ложные.
+# `.copier-answers.yml` в этот список НЕ входит, хотя выглядит родственником: copier кладёт его
+# в СГЕНЕРИРОВАННЫЙ проект, а не в шаблон. Шаблон несёт `copier.yml`. Найдено код-ревью
+# 2026-09-07: обычный рабочий репозиторий, собранный из copier-шаблона, целиком выпадал из
+# проверки — молчаливый отказ по причине, не имеющей отношения к предмету.
+for GEN in cookiecutter.json copier.yml copier.yaml; do
+  if [ -f "$DIR/$GEN" ]; then
+    echo "репозиторий — заготовка проекта ($GEN), личных файлов в нём нет по устройству"
+    exit 0
+  fi
+done
+
+# Заготовки — не личные файлы. Замер по выдаче поиска: из двадцати совпадений по имени
+# `CLAUDE.local.md` больше половины оказались `*.example`, `*.template` и файлами внутри
+# `templates/` — их кладут в репозиторий намеренно, чтобы человек скопировал себе.
+# Подстановки генератора (`{{cookiecutter.project_name}}/…`) — оттуда же.
+# `settings.local.json` считается личным ТОЛЬКО внутри `.claude/`: это единственное место,
+# откуда Claude Code его читает. Без привязки к каталогу под проверку попадали
+# `.vscode/settings.local.json` и `node_modules/…/settings.local.json` — чужие файлы с
+# совпавшим именем. Найдено код-ревью 2026-09-07.
+HITS=$(printf '%s\n' "$LIST" \
+  | grep -E '(^|/)(CLAUDE\.local\.md|\.claude/settings\.local\.json)$' \
+  | grep -vE '(^|/)(templates?|examples?|samples?|dist|fixtures?)/' \
+  | grep -vF '{{' \
+  || true)
+
+# Образцы гейтов — не личные файлы. В красном образце другой записи может лежать настоящий
+# `settings.local.json`, и это её предмет, а не наш. Поймано на собственном репозитории:
+# первой находкой стал зелёный образец `hook-actually-fires`.
+if command -v own_samples_filter >/dev/null 2>&1 || type own_samples_filter >/dev/null 2>&1; then
+  HITS=$(printf '%s\n' "$HITS" | own_samples_filter "$DIR" | grep -v '^$' || true)
+fi
+# Каталог самого комплекта: у нас образцы лежат не в `gates/`, а в `kit/gates/`.
+HITS=$(printf '%s\n' "$HITS" | grep -vE '(^|/)kit/gates/[^/]+/(red|green)(/|$)' | grep -v '^$' || true)
+
+[ -z "$HITS" ] && exit 0
+
+printf '%s\n' "$HITS" | while IFS= read -r F; do
+  case "$F" in
+    *CLAUDE.local.md) echo "$F: личный свод отслеживается git — он дописывается ПОСЛЕ общего и перекрывает его у всех" ;;
+    *)                echo "$F: личные права отслеживаются git — разрешения одного человека достались всем" ;;
+  esac
+done
+echo "  почини: убери файл из индекса — git rm --cached <файл> — и добавь его в .gitignore."
+echo "  личное, попавшее в общий репозиторий, никто не рецензирует: его туда никто и не звал."
+exit 1

package/kit/gates/personal-config-not-shared/gate.yml

@@ -0,0 +1,16 @@
+intent: личные файлы агента не раздаются всему проекту через git
+intent_en: an agent's personal files are not shared with the whole project through git
+
+# Там, где агента используют: есть свод, который он читает при запуске. Признак шире, чем
+# `has_agent_config`: настройки заводят не все, а свод — почти каждый.
+trigger:
+  has_agent_entry: true
+
+recipes:
+  any: bash {gate}/check.sh {dir}
+
+proof: incidents/README.md, 2026-09-07 «личное, попавшее в общий репозиторий» — замер по
+  тринадцати чужим репозиториям: шесть настоящих находок в пяти (`shacker/django-todo` раздаёт
+  всем `Read(//Users/shacker/**)` и абсолютные пути со своей машины; `modu-ai/moai-adk`,
+  `garrynewman/Control4.Jailbreak`, `AmyangXYZ/reze-mipo`, `shuigedeng/taotao-cloud-project`),
+  ноль ложных на семи контрольных

package/kit/gates/personal-config-not-shared/green/.aqk-tracked

@@ -0,0 +1,9 @@
+README.md
+CLAUDE.md
+CLAUDE.local.md.example
+templates/CLAUDE.local.md
+docs/settings.local.json.template
+{{cookiecutter.project_name}}/CLAUDE.local.md
+.vscode/settings.local.json
+node_modules/foo/settings.local.json
+src/app.py

package/kit/gates/personal-config-not-shared/red/.aqk-tracked

@@ -0,0 +1,6 @@
+README.md
+CLAUDE.md
+CLAUDE.local.md
+.claude/settings.json
+.claude/settings.local.json
+src/app.py

package/kit/gates/secrets-not-in-code/check.sh

@@ -2,7 +2,19 @@
 # Секрет, попавший в историю, из неё уже не убрать: ветку перепишут, а копии останутся у всех,
 # кто её тянул. Поэтому проверка стоит до коммита, а не «иногда руками».
 DIR="${1:-.}"
-. "$(dirname "$0")/../_skip.sh" 2>/dev/null || SKIP_NAMES=".git .aqk node_modules .venv"
+# Существование файла проверяется ДО `.`, а не запасной веткой после. Прежняя строка
+# `. файл 2>/dev/null || запасной_вариант` выглядела страховкой и ею не была: под `sh` (dash)
+# неудачный `.` завершает скрипт немедленно, и ветка после `||` не выполняется никогда; под
+# `bash`, которым гейты и запускаются из манифеста, она выполняется, но подставляет только
+# ПЕРЕМЕННУЮ — функции обхода остаются неопределёнными, конвейер печатает пустоту, и проверка
+# выходит с НУЛЁМ. Замерено 2026-09-08 на файле с настоящим нарушением: гейт сказал «чисто».
+SKIP_LIB="$(dirname "$0")/../_skip.sh"
+if [ ! -f "$SKIP_LIB" ]; then
+  echo "рядом с проверкой нет _skip.sh — обход не собран, проверка не состоялась"
+  echo "  почини: скопируй гейт вместе с файлом kit/gates/_skip.sh, он общий на весь каталог"
+  exit 2
+fi
+. "$SKIP_LIB"
 # Красный образец — намеренно сломанный код в репозитории. Сканирующий гейт обязан его
 # пропускать, иначе будет вечно краснеть на том, что сам же и положил. Исключение снимается,
 # когда проверяют сам образец: тогда каталог red и есть цель проверки.

package/kit/gates/swallowed-error/README.md

@@ -1,26 +1,44 @@
 # Ошибка не глушится молча
 
-**Намерение.** Ошибка либо обработана и записана в лог, либо проброшена дальше. Третьего нет.
+**Намерение.** Перехваченная и выброшенная ошибка — это отказ, о котором никто не узнал.
+Система продолжает работать «как будто всё хорошо», а причина всплывает через недели и в другом
+месте. Ошибка либо обработана и записана, либо проброшена дальше.
 
-**Какой отказ это поймало.** В разборе 1069 коммитов за 90 дней: **1436 блоков перехвата, из
-которых лишь около 10% пробрасывают ошибку дальше.** Остальные глушат её в лог или возвращают
-пустоту. Цена — три недели поиска источника отказов, которые гасились на месте.
-Запись в журнале: `incidents/README.md`, 2026-08-25.
+**Своей проверки здесь больше нет — так решил замер.** Переносимая версия искала перехват по
+тексту. Прогон по пяти чужим репозиториям (`httpx`, `fastapi`, `zod`, `cobra`, `ripgrep`) дал
+46 находок, и настоящим оказался ровно один класс — пустые `catch (_) {}` в `zod`. Остальное:
 
-**Почему машина, а не внимательность.** Пустой перехват выглядит безобидно и пишется быстрее
-правильного. В ревью на 400 строк он не читается как дефект — он читается как аккуратность.
+```python
+try:
+    if sniffio.current_async_library() == "trio":
+        return True
+except ImportError:   # библиотеки нет — значит не trio. Это не глушение, это ветвление.
+    pass
+```
 
-**Что именно ищется.** Перехват с пустым телом: `except …: pass` и `…: ...` в Python, пустой
-`catch (…) { }`, пустой `.catch(() => {})`.
+```rust
+let _ = self.wtr.write(b"\n")?;   // «?» пробрасывает ошибку. Отброшено только число байт.
+```
 
-**Чего НЕ ловит.** Перехват, который что-то делает, но не то: записал в лог на уровне `debug` и
-вернул пустоту — формально не пустой, по сути тот же тихий отказ. Это остаётся человеку.
+Питоновский `except <узкое исключение>: pass` — законный приём: ловят не ошибку, а её отсутствие.
+Растовый `let _ = …?` вообще ничего не глушит. Отличить это от настоящего глушения можно только
+разбором кода — а разбор уже написан.
 
-**Готовый аналог есть, и он подробнее.** В Python три правила `ruff`
-покрывают разные оттенки: `BLE` — ловля голого исключения, `TRY400` — запись в лог без трейса,
-`SIM105` — перехват ради тишины. В TypeScript — `no-empty` с запретом пустого перехвата.
-Измерено на живом проекте: `TRY400` нашёл 47 мест, которые самописный разбор искал час.
-Рецепты под эти стеки берут готовое; своя проверка — запасная.
+**Готовый аналог — это и есть он сам.**
 
-**Образцы.** `red/` — Python и JavaScript с пустым перехватом. `green/` — тот же код: запись в
-лог и проброс.
+| Стек | Чем |
+|---|---|
+| Python | `ruff --select BLE,TRY400,SIM105` |
+| JavaScript, TypeScript | `eslint no-empty` с `allowEmptyCatch: false` |
+| Go | [`errcheck`](https://github.com/kisielk/errcheck) — канонический инструмент под этот предмет |
+
+**Чего НЕ ловит.** Перехват, который что-то делает, но делает не то: `except: return None`,
+`catch { return [] }`. Формально обработка есть, по сути ошибка потеряна так же. Это видно
+только глазами и на ревью. Для Rust рецепта нет: у `clippy` есть близкие правила
+(`let_underscore_must_use`), но мы их не замеряли, а рецепт без замера — та же догадка,
+из-за которой эта запись и лишилась своей проверки.
+
+**Чем это оплачено.** Проект на Rust, Java, Ruby, PHP по этому пункту не получает ничего.
+
+**Образцы.** `red/loader.py` — `except Exception: pass`. `green/loader.py` — узкое исключение,
+запись в журнал и проброс. Проверяются рецептом `python` (`samples_for`).

package/kit/gates/swallowed-error/gate.yml

@@ -1,13 +1,23 @@
 intent: ошибка не глушится молча — она обработана и записана либо проброшена
 intent_en: an error is not silently swallowed — it is handled and logged, or re-raised
 
+# Только языки, под которые есть готовый разбор кода. Переносимой проверки здесь больше нет:
+# отличить «перехват ради тишины» от законного `except ImportError: pass` можно разбором,
+# а не поиском по тексту.
 trigger:
-  always: true
+  langs: python, javascript, typescript, go
 
 recipes:
-  any: bash {gate}/check.sh {dir}
   # BLE — ловля голого исключения, TRY400 — запись без трейса, SIM105 — перехват ради тишины.
   python: ruff check --select BLE,TRY400,SIM105 {dir}
   typescript: eslint --rule '{"no-empty":["error",{"allowEmptyCatch":false}]}' {dir}
+  javascript: eslint --rule '{"no-empty":["error",{"allowEmptyCatch":false}]}' {dir}
+  # errcheck — канонический инструмент Go под этот же предмет: ошибка присвоена и не проверена.
+  go: errcheck -blank {dir}/...
 
-proof: incidents/README.md — «2026-08-25 разбор 1069 коммитов»: 1436 блоков перехвата, лишь 10% пробрасывают ошибку
+samples_for: python
+
+proof: incidents/README.md, 2026-09-07 «замер по пяти стекам вынес приговор пяти записям» —
+  переносимая версия дала 46 находок на пяти чужих репозиториях, настоящими оказались только
+  пустые `catch {}` в zod; весь питоновский класс `except ImportError: pass` и растовый
+  `let _ = write(..)?` были ложными

package/kit/gates/test-has-assertion/check.sh

@@ -12,7 +12,19 @@
 # исключения. Гейт, спорящий о стиле, выключают целиком, поэтому здесь остались только
 # безусловные случаи — те, где тест не может провалиться ни при каких данных.
 DIR="${1:-.}"
-. "$(dirname "$0")/../_skip.sh" 2>/dev/null || SKIP_NAMES=".git .aqk node_modules .venv"
+# Существование файла проверяется ДО `.`, а не запасной веткой после. Прежняя строка
+# `. файл 2>/dev/null || запасной_вариант` выглядела страховкой и ею не была: под `sh` (dash)
+# неудачный `.` завершает скрипт немедленно, и ветка после `||` не выполняется никогда; под
+# `bash`, которым гейты и запускаются из манифеста, она выполняется, но подставляет только
+# ПЕРЕМЕННУЮ — функции обхода остаются неопределёнными, конвейер печатает пустоту, и проверка
+# выходит с НУЛЁМ. Замерено 2026-09-08 на файле с настоящим нарушением: гейт сказал «чисто».
+SKIP_LIB="$(dirname "$0")/../_skip.sh"
+if [ ! -f "$SKIP_LIB" ]; then
+  echo "рядом с проверкой нет _skip.sh — обход не собран, проверка не состоялась"
+  echo "  почини: скопируй гейт вместе с файлом kit/gates/_skip.sh, он общий на весь каталог"
+  exit 2
+fi
+. "$SKIP_LIB"
 
 # Только файлы тестов. Слово «assert» в обычном коде — не тест, а проверка входа.
 FILES=$(find "$DIR" $(skip_find) -type f \( \

package/kit/gates/test-not-adjusted/README.md

@@ -0,0 +1,79 @@
+# Арбитра не правит тот, кто чинит код
+
+**Намерение.** Когда проверка краснеет, у пишущего два выхода: починить код или подогнать
+проверку. Второй дешевле и с виду неотличим от первого — прогон зелёный, диф маленький.
+Для агента, которому поставлена задача «сделай, чтобы прошло», это выход по умолчанию.
+
+**Откуда взято.** Практики называют этот приём поимённо. В разборе 1154 обсуждений с
+r/programming, r/learnprogramming, **r/ExperiencedDevs** и Hacker News (Baltes, Cheong, Treude,
+[«An Endless Stream of AI Slop»](https://arxiv.org/html/2603.27249v3), январь–сентябрь 2025)
+он идёт в списке конкретных технических приёмов рядом с «casting to `any` to silence type
+errors» и «deleting methods instead of fixing them»:
+
+> «Test subversion»: changing tests to pass broken code rather than fixing underlying issues
+
+Наше собственное правило `kit/rules/testing.md` требует того же с самого начала — и сторожа не
+имело: «Тот, кто чинит код, не правит тест, который этот код проверяет».
+
+**Готовый аналог есть, и он лучше того, что написали бы мы.**
+[`checkwash`](https://github.com/taipei49314/checkwash) (Apache-2.0, чистый stdlib Python, без
+зависимостей, 21 детектор) разбирает диф и находит ослабленные утверждения, снятые проверки,
+подменённые ожидания, изменённые эталонные файлы. Своей проверки здесь нет и не будет —
+это обвязка вокруг него.
+
+Инструмент вышел 1 сентября 2026, последняя версия 5 сентября; его собственная документация
+говорит ровно то, что говорим мы: *«checkwash cannot block when it does not run. A change that
+deletes or disables the checkwash job disarms it in the same diff»* — это как раз то, что
+стерегут наши `gates-run-in-ci`, `ci-actually-fails` и `gate-not-weakened`. Мы дополняем друг
+друга, а не соперничаем.
+
+**Что добавляет запись — и почему это не мелочь.** Замерено 2026-09-07 на образце: код изменён
+на неверный, три точных утверждения заменены на `is not None`. `checkwash` находит все три —
+и **завершается кодом 0**: он понижает их до `warn` по признаку `REPAIR_EVIDENCE` («в дифе есть
+и правка кода, значит похоже на настоящую починку»). То есть ровно тот случай, ради которого
+запись нужна, по умолчанию проходит зелёным.
+
+Поднять порог целиком нельзя — замерено на живой истории `httpx`, последние 40 коммитов:
+
+| Порог | Заблокировано | Чем |
+|---|---|---|
+| по умолчанию (`high`) | 2.5% | одна настоящая находка, но предмет записи пропускается |
+| `--fail-on warn` | 15% | восемь находок из одиннадцати — `CI_WORKFLOW_TOUCHED`, то есть «диф трогает конвейер» |
+| **отбор по правилу (наш)** | **2.5%** | та же настоящая находка **плюс** подгонка арбитра уровня `warn` |
+
+Отбор идёт по правилу: всё уровня `high` и выше, плюс семейство `ASSERT_*` и подмена предмета
+уровня `warn`. Конвейер не наш предмет здесь — его стерегут другие записи.
+
+**Чего НЕ ловит.**
+
+- **`TEST_DISABLED` уровня `warn` — намеренно.** Инструмент сам различает: тест исчез вместе с
+  правкой кода — `warn`, тест исчез без неё — `high` («NO_PROD_CHANGE_IN_DIFF»). Первое обычно
+  законная уборка при снятии возможности: в `httpx` коммит «Graceful upgrade path for 0.28»
+  удалил два теста вместе с самой возможностью. Поднимать это целиком значит красить каждую
+  депрекацию — замер давал 5% вместо 2.5%, и лишняя половина была именно такой. Второе и так
+  `high` и потому попадает под общее правило.
+- **Тест, который был слабым с самого начала.** Запись смотрит на изменение, а не на
+  качество: тест, родившийся тавтологией, — предмет `test-has-assertion`.
+- **Подгонку через данные.** Правку фикстуры или эталонного файла `checkwash` умеет, но наша
+  обвязка её не поднимает выше порога инструмента.
+- **Правку свода правил — намеренно.** `checkwash` поднимает `GUARDRAIL_TOUCHED` до `critical`
+  на любое изменение `AGENTS.md`, `CLAUDE.md`, `.claude/**`. Для нас это худшее из возможных
+  ложных срабатываний: свод — ровно тот файл, ради правки которого комплект существует, его
+  пишет `aqk init`. Отбор идёт **по имени правила**, а не по уровню, и это правило в список не
+  входит. Найдено код-ревью, а не замером: в `httpx` файлов инструкций агенту нет вовсе.
+- **Файл, который инструмент не смог разобрать.** `TEST_FILE_UNPARSEABLE` остаётся `warn` и в
+  наш список не входит: часть дифа окажется неразобранной, а гейт промолчит. Ошибки настройки
+  самого инструмента мы, наоборот, поднимаем в отказ (код 2).
+- **Разрешённое исключение.** Находку, записанную командой `checkwash allow` и попавшую в
+  реестр на базовой стороне дифа, мы не красим. Иначе у команды, разобравшей случай глазами,
+  не остаётся выхода, кроме как выключить проверку целиком. Проверено сквозным прогоном:
+  из трёх находок красного образца после записи исключения остаётся одна.
+- **Проекты без Python.** `checkwash` ставится через `pip`. Запись объявляет это полем
+  `requires`, и `add` отказывает с названной причиной, а не ставит гейт, который встанет
+  с «not found».
+
+**Образцы.** Настоящей истории git внутри каталога комплекта взять неоткуда, поэтому образец —
+это две папки, `before/` и `after/`; проверка собирает из них одноразовый репозиторий с двумя
+коммитами. `red/` — код изменён на неверный, три утверждения заменены на `is not None`.
+`green/` — код и тест выросли вместе: добавлена функция и тест к ней, ни одно утверждение не
+убрано и не ослаблено.

package/kit/gates/test-not-adjusted/check.sh

@@ -0,0 +1,136 @@
+#!/usr/bin/env sh
+# Арбитра правит не тот, кто чинит код. Проверку выполняет `checkwash` — готовый инструмент,
+# который это умеет лучше, чем сумели бы мы. Здесь только обвязка: выбор диапазона, режим
+# образцов и строка совета.
+#
+# ЗАЧЕМ ЭТО ВООБЩЕ. «Test subversion» — правка теста, чтобы прошёл сломанный код, — один из
+# приёмов, которые практики называют поимённо в разборе 1154 обсуждений с Reddit и Hacker News
+# (Baltes, Cheong, Treude, «An Endless Stream of AI Slop», arxiv 2603.27249). Наше собственное
+# правило `kit/rules/testing.md` требует того же и сторожа не имело.
+#
+# ПОЧЕМУ НЕ `--fail-on warn` И НЕ ПОРОГ ПО УМОЛЧАНИЮ. Измерено 2026-09-07 на живой истории
+# `httpx`, последние 40 коммитов:
+#   порог по умолчанию (high) — блокирует 2.5% коммитов, и та единственная блокировка настоящая;
+#   `--fail-on warn`          — блокирует 15%, и восемь из одиннадцати находок уровня warn это
+#                               `CI_WORKFLOW_TOUCHED`, то есть «диф трогает конвейер» вообще.
+# Поднять порог целиком значит красить любую правку конвейера. Поэтому отбор идёт ПО ПРАВИЛУ:
+# всё, что high и выше, плюс подгонка арбитра уровня warn. Именно её инструмент понижает по
+# признаку REPAIR_EVIDENCE — «в дифе есть и правка кода, значит похоже на настоящую починку», —
+# а это ровно тот случай, ради которого запись и заведена: код сломали, тест подогнали.
+# Конвейер здесь не наш предмет: его стерегут `ci-actually-fails` и `gates-run-in-ci`.
+#
+# ОТБОР ИДЁТ ПО ИМЕНИ ПРАВИЛА, А НЕ ПО УРОВНЮ. Первая версия блокировала всё уровня high и выше
+# «на всякий случай» — и ловила `GUARDRAIL_TOUCHED`, который инструмент поднимает до critical на
+# ЛЮБУЮ правку `AGENTS.md`, `CLAUDE.md`, `.claude/**`. Для нас это худшее из возможных ложных
+# срабатываний: свод правил — ровно тот файл, ради правки которого комплект и существует, его
+# пишет `aqk init`. Найдено код-ревью 2026-09-07; замер по `httpx` этого показать не мог —
+# там нет файлов инструкций агенту вовсе.
+#
+# ALWAYS — подгонка арбитра: красим на любом уровне. Именно её инструмент понижает до `warn`
+# по признаку REPAIR_EVIDENCE, и именно она предмет этой записи.
+ALWAYS='ASSERT_REMOVED|ASSERT_WEAKENED|ASSERT_SUBSTITUTED|TEST_PATCHES_SUBJECT|SUBJECT_NORMALIZED|CONFTEST_PATCHES_PROD'
+#
+# HIGH_ONLY — тест исчез. Инструмент сам различает: вместе с правкой кода — `warn` (обычно
+# законная уборка при снятии возможности, так было в коммите `httpx` «Graceful upgrade path for
+# 0.28»); без правки кода — `high` («NO_PROD_CHANGE_IN_DIFF»), и это чистое снятие сигнала.
+# Поднимать первое значит красить каждую депрекацию: замер давал 5% заблокированных коммитов
+# вместо 2.5%, и лишняя половина была именно такой.
+HIGH_ONLY='TEST_DISABLED'
+#
+# Всё остальное — не наш предмет. `CI_WORKFLOW_TOUCHED` стерегут `ci-actually-fails` и
+# `gates-run-in-ci`; `GUARDRAIL_TOUCHED` не стережёт никто, и это правильно: правка свода
+# правил — обычная работа, а не подгонка арбитра.
+
+DIR="${1:-.}"
+
+# Режим образца: рядом лежат before/ и after/. Настоящей истории git внутри каталога комплекта
+# взять неоткуда, а вложенный .git создал бы embedded-репозиторий. Собираем одноразовый.
+if [ -d "$DIR/before" ] && [ -d "$DIR/after" ]; then
+  T=$(mktemp -d) || exit 2
+  cp -R "$DIR/before/." "$T/" 2>/dev/null
+  ( cd "$T" && git init -q . && git config user.email aqk@example && git config user.name aqk &&
+    git add -A && git commit -qm "before" ) >/dev/null 2>&1
+  find "$T" -mindepth 1 -maxdepth 1 ! -name .git -exec rm -rf {} + 2>/dev/null
+  cp -R "$DIR/after/." "$T/" 2>/dev/null
+  ( cd "$T" && git add -A && git commit -qm "after" ) >/dev/null 2>&1
+  REPO="$T"; RANGE="HEAD~1..HEAD"
+else
+  if ! (cd "$DIR" 2>/dev/null && git rev-parse --git-dir >/dev/null 2>&1); then
+    echo "не git-репозиторий — проверять нечего"
+    exit 0
+  fi
+  # Диапазон: по умолчанию последний коммит. Проект может назвать свой — так же, как это
+  # делает `doctor --since`.
+  RANGE="${AQK_TEST_RANGE:-HEAD~1..HEAD}"
+  # Проверяем ТОТ диапазон, который сейчас используется, а не всегда `HEAD~1`. Проект, назвавший
+  # `AQK_TEST_RANGE=origin/main..HEAD`, получал бы «меньше двух коммитов» на клоне без `HEAD~1`,
+  # хотя его диапазон полностью разрешим. Найдено код-ревью 2026-09-07.
+  BASE="${RANGE%%..*}"
+  if ! (cd "$DIR" && git rev-parse -q --verify "$BASE" >/dev/null 2>&1); then
+    echo "$BASE не разрешается — сравнивать не с чем, проверка пропущена"
+    echo "  почини: дай конвейеру историю глубже одного коммита —"
+    echo "  actions/checkout@v4 с fetch-depth: 2, либо назови свой диапазон в AQK_TEST_RANGE."
+    exit 0
+  fi
+  REPO="$DIR"
+fi
+
+if ! command -v checkwash >/dev/null 2>&1; then
+  [ -n "${T:-}" ] && rm -rf "$T"
+  echo "checkwash не установлен — проверять нечем"
+  echo "  почини: pip install checkwash — запись делегирует ему целиком, своей проверки у неё нет."
+  exit 2
+fi
+
+# `--fail-on info` — чтобы инструмент отдал ВСЁ, что нашёл; решение принимаем сами, ниже.
+JSON=$(checkwash check "$RANGE" --repo "$REPO" --format json --fail-on info 2>/dev/null)
+[ -n "${T:-}" ] && rm -rf "$T"
+
+if [ -z "$JSON" ]; then
+  echo "checkwash не дал разбора для $RANGE"
+  echo "  почини: запусти команду руками и посмотри, почему она молчит."
+  echo "  «не смогли проверить» и «нарушений нет» дают одинаково пустой список и разные выводы."
+  exit 2
+fi
+
+# Разбор вывода: json печатается по полю на строку, поэтому пары «rule/severity» собираются
+# построчно. Своего разбора json мы не пишем — нужны два поля, а не структура.
+# Ошибки разбора самого инструмента — это «не смогли проверить», а не «нарушений нет».
+if printf '%s\n' "$JSON" | grep -q '"config_errors": \[$' &&
+   printf '%s\n' "$JSON" | sed -n '/"config_errors": \[/,/\]/p' | grep -q '"'; then
+  printf '%s\n' "$JSON" | sed -n '/"config_errors": \[/,/\]/p'
+  echo "  почини: у checkwash ошибка в настройке — запусти его руками и прочти вывод."
+  exit 2
+fi
+
+# Разбор вывода: json печатается по полю на строку, поэтому поля находки собираются построчно.
+# Своего разбора json мы не пишем — нужны пять полей, а не структура.
+FOUND=$(printf '%s\n' "$JSON" | awk -v always="$ALWAYS" -v highonly="$HIGH_ONLY" '
+  /"allowlisted":/ { al = ($0 ~ /true/) }
+  /"rule":/     { r = $0; sub(/.*"rule":[[:space:]]*"/, "", r); sub(/".*/, "", r) }
+  /"severity":/ { s = $0; sub(/.*"severity":[[:space:]]*"/, "", s); sub(/".*/, "", s) }
+  /"path":/     { p = $0; sub(/.*"path":[[:space:]]*"/, "", p); sub(/".*/, "", p) }
+  /"message":/  { m = $0; sub(/.*"message":[[:space:]]*"/, "", m); sub(/".*/, "", m) }
+  # Печатаем на `unit` — ПОСЛЕДНЕМ поле находки. Поля идут по алфавиту, и `message` стоит
+  # РАНЬШЕ `rule` и `severity`: печать по сообщению подписывала правило от предыдущей находки.
+  /"unit":/     {
+    u = $0
+    sub(/.*"unit":[[:space:]]*/, "", u)      # значение бывает и `null` без кавычек
+    gsub(/^[",[:space:]]+|[",[:space:]]+$/, "", u)
+    if (u == "null") u = ""
+    if (r != "") {
+      # Разрешённое исключение уже разобрано человеком и записано в реестр инструмента со
+      # сроком. Красить его значит не оставить выхода, кроме как выключить проверку целиком.
+      blocking = !al && (r ~ ("^(" always ")$") ||
+                         ((s == "high" || s == "critical") && r ~ ("^(" highonly ")$")))
+      if (blocking) printf "%s:%s: %s — %s [%s]\n", p, (u == "" ? "0" : u), r, m, s
+    }
+    r = ""; s = ""; p = ""; u = ""; m = ""; al = 0
+  }
+')
+
+[ -z "$FOUND" ] && exit 0
+printf '%s\n' "$FOUND"
+echo "  почини: верни утверждение на место, а код приведи в соответствие с ним."
+echo "  тест, подогнанный под сломанный код, — это зелёный прогон без основания."
+exit 1

package/kit/gates/test-not-adjusted/gate.yml

@@ -0,0 +1,19 @@
+intent: арбитра не правит тот, кто чинит код — утверждение не ослабляют, чтобы прошло
+intent_en: whoever fixes the code does not adjust the arbiter — assertions are not weakened to pass
+
+# Там, где есть тесты. Без них подгонять нечего.
+trigger:
+  has_tests: true
+
+recipes:
+  any: bash {gate}/check.sh {dir}
+
+# Программа, без которой запись не работает. По первому слову команды этого не видно: обёртка
+# начинается с `bash`, который есть всегда, и гейт ставился бы, а вставал при первом запуске.
+requires: checkwash
+
+proof: incidents/README.md, 2026-09-07 «арбитра правит тот, кто чинит код» — приём назван
+  практиками в разборе 1154 обсуждений с Reddit и Hacker News (Baltes, Cheong, Treude,
+  arxiv 2603.27249, «test subversion»); замер обвязки по 40 коммитам `httpx` — одна блокировка,
+  настоящая, при 15% на пороге `--fail-on warn` и 2.5% на пороге по умолчанию, который пропускает
+  сам предмет записи

package/kit/gates/test-not-adjusted/green/after/calc.py

@@ -0,0 +1,6 @@
+def add(a, b):
+    return a + b
+
+
+def mul(a, b):
+    return a * b

package/kit/gates/test-not-adjusted/green/after/tests/test_calc.py

@@ -0,0 +1,9 @@
+from calc import add, mul
+
+
+def test_add():
+    assert add(2, 2) == 4
+
+
+def test_mul():
+    assert mul(3, 4) == 12

package/kit/gates/test-not-adjusted/green/before/calc.py

@@ -0,0 +1,2 @@
+def add(a, b):
+    return a + b

package/kit/gates/test-not-adjusted/green/before/tests/test_calc.py

@@ -0,0 +1,5 @@
+from calc import add
+
+
+def test_add():
+    assert add(2, 2) == 4

package/kit/gates/test-not-adjusted/red/after/calc.py

@@ -0,0 +1,2 @@
+def add(a, b):
+    return a + b + 1

package/kit/gates/test-not-adjusted/red/after/tests/test_calc.py

@@ -0,0 +1,5 @@
+from calc import add
+
+
+def test_add():
+    assert add(2, 2) is not None

package/kit/gates/test-not-adjusted/red/before/calc.py

@@ -0,0 +1,2 @@
+def add(a, b):
+    return a + b

package/kit/gates/test-not-adjusted/red/before/tests/test_calc.py

@@ -0,0 +1,7 @@
+from calc import add
+
+
+def test_add():
+    assert add(2, 2) == 4
+    assert add(0, 0) == 0
+    assert add(-1, 1) == 0

package/kit/gates/todo-without-task/README.md

@@ -23,4 +23,10 @@
 поэтому рецепт под эти стеки берёт их. Своя проверка остаётся как запасная — для языков, где
 готового правила нет.
 
+**Замер оправдал переносимую проверку.** Пять чужих репозиториев (`httpx`, `fastapi`, `zod`,
+`cobra`, `ripgrep`) — 51 находка, ложных ноль: маркер `TODO` либо стоит в коде, либо нет,
+двусмысленности здесь нет. На той же ревизии 2026-09-07 две соседние записи лишились своих
+переносимых проверок именно из-за замера — эта его прошла, и потому осталась. В `cobra` и
+`ripgrep`, где `ruff` и eslint неприменимы, она единственная, кто эти маркеры видит.
+
 **Образцы.** `red/` — код с двумя маркерами. `green/` — тот же код, задача заведена, маркера нет.

package/kit/gates/todo-without-task/check.sh

@@ -2,7 +2,19 @@
 # Маркер «доделать потом» — это задача, спрятанная от очереди работ. Её не видно при
 # планировании, о ней не знает никто, кроме того, кто её оставил, и она переживает автора.
 DIR="${1:-.}"
-. "$(dirname "$0")/../_skip.sh" 2>/dev/null || SKIP_NAMES=".git .aqk node_modules .venv"
+# Существование файла проверяется ДО `.`, а не запасной веткой после. Прежняя строка
+# `. файл 2>/dev/null || запасной_вариант` выглядела страховкой и ею не была: под `sh` (dash)
+# неудачный `.` завершает скрипт немедленно, и ветка после `||` не выполняется никогда; под
+# `bash`, которым гейты и запускаются из манифеста, она выполняется, но подставляет только
+# ПЕРЕМЕННУЮ — функции обхода остаются неопределёнными, конвейер печатает пустоту, и проверка
+# выходит с НУЛЁМ. Замерено 2026-09-08 на файле с настоящим нарушением: гейт сказал «чисто».
+SKIP_LIB="$(dirname "$0")/../_skip.sh"
+if [ ! -f "$SKIP_LIB" ]; then
+  echo "рядом с проверкой нет _skip.sh — обход не собран, проверка не состоялась"
+  echo "  почини: скопируй гейт вместе с файлом kit/gates/_skip.sh, он общий на весь каталог"
+  exit 2
+fi
+. "$SKIP_LIB"
 
 # shellcheck disable=SC2086
 # Маркер обязан стоять В КОММЕНТАРИИ. Иначе гейт краснеет на имени переменной с таким же