agent-quality-kit 0.8.0 → 0.10.0

package/tool/selfcheck/smoke.sh

@@ -23,7 +23,15 @@ PASS=0
 FAIL=0
 
 ok()   { printf '  \033[32m✔\033[0m  %s\n' "$1"; PASS=$((PASS + 1)); }
-bad()  { printf '  \033[31m✘\033[0m  %s\n' "$1"; printf '      %s\n' "${2:-}"; FAIL=$((FAIL + 1)); }
+# Упавшие называются ПОИМЁННО И С ПРИЧИНОЙ в итоге, а не только по ходу. Прогон запускают гейтом, а вывод
+# упавшего гейта обрезается — и причина, напечатанная в середине двухсот строк, до глаз не
+# доезжает. Час поисков в конвейере 2026-09-09 стоил ровно этого: список красных был, а увидеть
+# его было нельзя. Имени мало: следующий круг конвейера показал имя и не показал причину —
+# она печатается сразу под находкой, то есть в середине, которую обрезка и съедает.
+FAILED_NAMES=""
+bad()  { printf '  \033[31m✘\033[0m  %s\n' "$1"; printf '      %s\n' "${2:-}"; FAIL=$((FAIL + 1));
+         FAILED_NAMES="${FAILED_NAMES:+$FAILED_NAMES
+  }$1 — ${2:-без пояснения}"; }
 
 # Node на Windows видит мир глазами Windows, а Git Bash — глазами POSIX: путь вида
 # /tmp/tmp.XXXX, отданный в `node -e`, там не существует, и проверка падает не на том, что
@@ -35,6 +43,26 @@ node_in() { D="$1"; shift; ( cd "$D" && node "$@" ); }
 WORK="$(mktemp -d)"
 trap 'rm -rf "$WORK"' EXIT
 
+# ГЕРМЕТИЧНОСТЬ. Три строки, каждая закрывает свой класс отказов, найденный сплошным чтением
+# и замерами 2026-09-09. Прогон обязан давать один и тот же ответ на любой машине и в любой
+# день — иначе «116 зелёных» означает не «работает», а «сегодня совпало».
+#
+# 1. TMPDIR внутрь $WORK. В файле 65 вызовов `mktemp -d` и ОДИН trap — на $WORK. Прерванный
+#    прогон оставлял 64 каталога, а два из них несут по копии всего дерева (`cp -r tool kit`,
+#    ≈4000 файлов). Одна строка вместо правки шестидесяти пяти: mktemp читает TMPDIR, и вся
+#    временная работа попадает под уже существующую уборку.
+# 2. HOME в песочницу. Комплект пишет `~/.config/aqk/feedback-shown` — просьбу про звезду
+#    показывают один раз НА МАШИНУ. Из 65 фикстур свой HOME задавали 8. Значит на машине
+#    разработчика (отметка лежит с сентября) `init` молчит, а на свежем раннере — говорит:
+#    один и тот же прогон получает РАЗНЫЙ ввод. Плюс прогон гадил в настоящий домашний каталог.
+# 3. AQK_UPDATE=0. `doctor --brief` ходит в реестр npm по сети с таймаутом 3 с — и только вне
+#    конвейера (`updateWanted` выключается при CI). То есть локально тесты сетевые, а в
+#    конвейере нет. Сеть в тестах — отдельный класс флейков во всех разборах; здесь она ещё и
+#    делает две среды разными по построению.
+export TMPDIR="$WORK/tmp"; mkdir -p "$TMPDIR"
+export HOME="$WORK/home"; export USERPROFILE="$HOME"; mkdir -p "$HOME"
+export AQK_UPDATE=0
+
 printf '\n\033[1mtool/selfcheck/smoke.sh\033[0m\n\n'
 
 # --- 1. синтаксис самой программы ------------------------------------------
@@ -345,10 +373,24 @@ if [ -f "$BLOBDIR/GOD_AI.md" ]; then
     bad "blob собрал не все методички" "в kit/docs $EXPECT_MD, в склейке $GOT_MD"
   fi
   # Ссылки на соседние файлы внутри склейки ведут в никуда: соседей рядом больше нет.
-  if grep -qE '\]\((?!https?:)[^)]*\.md\)' "$BLOBDIR/GOD_AI.md" 2>/dev/null; then
+  #
+  # ДВА ПРОХОДА, А НЕ ОПЕРЕЖАЮЩАЯ ПРОВЕРКА. Здесь стояло `grep -qE '...(?!https?:)...'`, и это
+  # была ЛОЖЬ: `(?!` — синтаксис PCRE, в POSIX ERE его нет. GNU grep печатает предупреждение и
+  # не находит ничего, ugrep падает с ошибкой разбора — в обоих случаях `if` уходит в `else`, и
+  # проверка печатала зелёное НА ЛЮБЫХ ДАННЫХ. Ровно тот грех, ради поимки которого написан весь
+  # комплект, внутри прибора, который его ищет. Найдено сплошным чтением 2026-09-09.
+  #
+  # Поэтому же ниже проверяется САМА ПРОВЕРКА: подделываем склейку с относительной ссылкой и
+  # требуем, чтобы её нашли. Без этого следующая такая опечатка снова проедет зелёной.
+  rel_links() { grep -oE '\]\([^)]+\.md[^)]*\)' "$1" 2>/dev/null | grep -vE '^\]\(https?:' | grep -q .; }
+  printf '%s' "$(cat "$BLOBDIR/GOD_AI.md")" > "$BLOBDIR/doctored.md"
+  printf '\nсм. [соседний файл](other.md)\n' >> "$BLOBDIR/doctored.md"
+  if rel_links "$BLOBDIR/GOD_AI.md"; then
     bad "в склейке остались ссылки на соседние файлы" "внутри одного файла они ведут в никуда"
+  elif ! rel_links "$BLOBDIR/doctored.md"; then
+    bad "проверка ссылок не может покраснеть" "подделанная склейка с относительной ссылкой прошла"
   else
-    ok "ссылки на соседние файлы в склейке сняты"
+    ok "ссылки на соседние файлы сняты, и проверка это умеет заметить"
   fi
 else
   bad "blob не создал GOD_AI.md" "$BLOBDIR"
@@ -579,7 +621,7 @@ REPDIR="$(mktemp -d)"
 (
   cd "$REPDIR" && git init -q . && mkdir -p src &&
   printf 'a = 1  # noqa\n' > src/a.py &&
-  node "$CLI" start > /tmp/aqk-start.log 2>&1
+  node "$CLI" start > "$WORK/start.log" 2>&1
 )
 REP_OUT=$( cd "$REPDIR" && node "$CLI" report 2>&1 ); REP_CODE=$?
 if [ "$REP_CODE" -ne 0 ] && printf '%s' "$REP_OUT" | grep -q '❌ gate-not-weakened'; then
@@ -591,7 +633,7 @@ else
   G_LS=$( cd "$REPDIR" && ls gates 2>&1 | tr '\n' ' ' )
   G_DECL=$( cd "$REPDIR" && sed -n '/^gates:/,$p' .aqk.yml 2>/dev/null | grep -cE '^[[:space:]]+[A-Za-z0-9_-]+:' )
   G_OUT=$( cd "$REPDIR" && bash gates/gate-not-weakened/check.sh . 2>&1 | head -2 ); G_CODE=$?
-  bad "report не отличает красное от зелёного" "код отчёта $REP_CODE; гейт напрямую: код $G_CODE, вывод «$(printf '%s' "$G_OUT" | tr '\n' ' ')»; в gates/: «$G_LS»; объявлено гейтов: $G_DECL; хвост start: «$(tail -4 /tmp/aqk-start.log 2>/dev/null | tr '\n' ' ')»"
+  bad "report не отличает красное от зелёного" "код отчёта $REP_CODE; гейт напрямую: код $G_CODE, вывод «$(printf '%s' "$G_OUT" | tr '\n' ' ')»; в gates/: «$G_LS»; объявлено гейтов: $G_DECL; хвост start: «$(tail -4 "$WORK/start.log" 2>/dev/null | tr '\n' ' ')»"
 fi
 if [ -f "$REPDIR/.aqk/report.md" ] && grep -q '^## ' "$REPDIR/.aqk/report.md"; then
   ok "report сохраняет .aqk/report.md"
@@ -1437,6 +1479,481 @@ else
 fi
 rm -rf "$GENP"
 
+# --- 95. covers: запись закрыта другим арбитром, но только объявленным ---------
+# Просьба первого чужого пользователя, названная им первой: у него complexity-limit,
+# no-print-in-prod и swallowed-error держит biome, а doctor каждый прогон печатал «применимо,
+# но не поставлено: 5» — неправду. Неправда в СОБСТВЕННОМ выводе дороже всех прочих: весь
+# стандарт стоит на том, что вывод не врёт. Но поле не признание на слово: гейт, который
+# «закрывает», обязан быть объявлен в gates:, иначе covers становится способом объявить защиту,
+# которой нет. Проверяются оба конца сразу.
+COVP="$(mktemp -d)"
+( cd "$COVP" && git init -q . && mkdir -p src rules &&
+  printf 'const x=1;\n' > src/a.ts && printf '# вход\n' > AGENTS.md &&
+  printf 'правило\n' > rules/r.md && printf '.x\n' > .gitignore &&
+  printf 'aqk: 1\nentry: [AGENTS.md]\nrules: rules\ngates:\n  lint: "true"\ncovers:\n  lint: [no-print-in-prod, swallowed-error]\n  biome: [duplicate-code]\n' > .aqk.yml ) >/dev/null 2>&1
+COV=$( cd "$COVP" && AQK_LANG=ru node "$CLI" doctor 2>&1 )
+if printf '%s' "$COV" | grep -q "закрыто другим арбитром 2" &&
+   printf '%s' "$COV" | grep -q "covers называет гейт, которого нет" &&
+   printf '%s' "$COV" | grep -q "biome" &&
+   ! printf '%s' "$COV" | grep -q "неизвестное поле"; then
+  ok "covers снимает запись с долга — и только когда закрывающий гейт объявлен"
+else
+  bad "covers посчитан неверно" "$(printf '%s' "$COV" | grep -E 'Итого|covers' | head -3)"
+fi
+rm -rf "$COVP"
+
+# --- 96. язык вывода — настройка проекта, а не машины -------------------------
+# Просьба первого чужого пользователя: «язык берётся из LC_ALL/LANG, а на Windows их просто нет:
+# русский проект получает английский вывод». Проверяются оба конца порядка сразу: манифест
+# сильнее локали, но переменная окружения сильнее манифеста — иначе у человека, набравшего
+# AQK_LANG=en руками, не остаётся способа получить английский.
+LNGP="$(mktemp -d)"
+( cd "$LNGP" && git init -q . && printf '# вход\n' > AGENTS.md &&
+  printf 'aqk: 1\nlang: ru\nentry: [AGENTS.md]\n' > .aqk.yml ) >/dev/null 2>&1
+BY_MAN=$( cd "$LNGP" && env -u AQK_LANG LANG=en_US.UTF-8 LC_ALL=en_US.UTF-8 node "$CLI" context 2>&1 | head -1 )
+BY_ENV=$( cd "$LNGP" && AQK_LANG=en node "$CLI" context 2>&1 | head -1 )
+if printf '%s' "$BY_MAN" | grep -q "состояние этого репозитория" &&
+   printf '%s' "$BY_ENV" | grep -q "the state of this repository"; then
+  ok "язык берётся из манифеста поверх локали, а переменная окружения — поверх манифеста"
+else
+  bad "порядок выбора языка нарушен" "по манифесту: $BY_MAN | по окружению: $BY_ENV"
+fi
+rm -rf "$LNGP"
+
+# --- 97. совет про браузер у агента — только тому, кому он нужен --------------
+# Решение владельца 2026-09-08: инструмент, дающий агенту браузер, надо рекомендовать. Но совет,
+# показанный не тому, стоит доверия всем остальным советам — та же норма, что у записей каталога.
+# Проверяются все три конца: интерфейс есть и сервера нет → совет; интерфейса нет → тишина;
+# сервер уже стоит → тишина.
+BRWP="$(mktemp -d)"
+( cd "$BRWP" && git init -q . && mkdir -p src && printf 'body{color:#fff}\n' > src/a.css &&
+  printf 'export const A=1\n' > src/a.tsx && printf '# вход\n' > AGENTS.md ) >/dev/null 2>&1
+WITH_UI=$( cd "$BRWP" && AQK_LANG=ru node "$CLI" doctor 2>&1 )
+( cd "$BRWP" && printf '{"mcpServers":{"b":{"command":"npx","args":["-y","chrome-devtools-mcp@1.9.0"]}}}\n' > .mcp.json )
+WITH_SRV=$( cd "$BRWP" && AQK_LANG=ru node "$CLI" doctor 2>&1 )
+NOUIP="$(mktemp -d)"
+( cd "$NOUIP" && git init -q . && printf 'print(1)\n' > a.py && printf '# вход\n' > AGENTS.md ) >/dev/null 2>&1
+NO_UI=$( cd "$NOUIP" && AQK_LANG=ru node "$CLI" doctor 2>&1 )
+if printf '%s' "$WITH_UI" | grep -q "нет браузера" &&
+   ! printf '%s' "$WITH_SRV" | grep -q "нет браузера" &&
+   ! printf '%s' "$NO_UI" | grep -q "нет браузера"; then
+  ok "совет про браузер даётся проекту с интерфейсом и молчит, когда сервер уже есть"
+else
+  bad "совет про браузер показан не тому" "с ui: $(printf '%s' "$WITH_UI" | grep -c 'нет браузера'), с сервером: $(printf '%s' "$WITH_SRV" | grep -c 'нет браузера'), без ui: $(printf '%s' "$NO_UI" | grep -c 'нет браузера')"
+fi
+rm -rf "$BRWP" "$NOUIP"
+
+# --- 98. заявка covers сверяется, а не принимается на слово -------------------
+# Поле covers завели утром того же дня, и тогда же честно записали: оно снимает запись с долга
+# ПО СЛОВУ человека. К вечеру это перестало быть теорией: запуск на настоящем ruff.toml из живого
+# проекта показал девятнадцать групп правил в extend-select и НЕ пойманный print() — группы T20
+# среди них нет. Заявка «no-print-in-prod держит наш lint» была бы ложной, а запись ушла бы из
+# долга. Поле, снимающее неправду из вывода, само стало бы способом её произвести.
+CVUP="$(mktemp -d)"
+( cd "$CVUP" && git init -q . && printf 'x=1\n' > a.py && printf '# вход\n' > AGENTS.md &&
+  printf 'aqk: 1\nentry: [AGENTS.md]\ngates:\n  lint: "ruff check ."\ncovers:\n  lint: [no-print-in-prod]\n' > .aqk.yml ) >/dev/null 2>&1
+( cd "$CVUP" && printf 'extend-select = ["I","B","UP","SIM"]\n' > ruff.toml )
+WITHOUT=$( cd "$CVUP" && AQK_LANG=ru node "$CLI" doctor 2>&1 )
+( cd "$CVUP" && printf 'extend-select = ["I","B","UP","SIM","T20"]\n' > ruff.toml )
+WITHT20=$( cd "$CVUP" && AQK_LANG=ru node "$CLI" doctor 2>&1 )
+if printf '%s' "$WITHOUT" | grep -q "заявка не подтверждена" &&
+   printf '%s' "$WITHOUT" | grep -q "T20" &&
+   ! printf '%s' "$WITHT20" | grep -q "заявка не подтверждена"; then
+  ok "covers сверяется с кодами правил: без T20 говорит вслух, с T20 молчит"
+else
+  bad "сверка заявки covers не работает" "без T20: $(printf '%s' "$WITHOUT" | grep -c 'не подтверждена'), с T20: $(printf '%s' "$WITHT20" | grep -c 'не подтверждена')"
+fi
+rm -rf "$CVUP"
+
+# --- 99. краткий режим: присутствие видно, совет не надоедает -----------------
+# Хук pre-commit молчит на успехе — это его умолчание. Комплект, который всё держит, для
+# человека неотличим от невставленного: «скачал и че дальше» — дословная жалоба владельца.
+# Это ровно тот порок, против которого написан комплект, только у нас самих.
+# Проверяются три вещи сразу: строка есть всегда; совет приходит один раз, а не на каждый
+# прогон; переменная его выключает.
+BRFP="$(mktemp -d)"
+( cd "$BRFP" && git init -q . && printf 'x=1\n' > a.py && printf '# вход\n' > AGENTS.md &&
+  printf '.x\n' > .gitignore && mkdir -p rules .aqk/docs && printf 'п\n' > rules/r.md &&
+  printf 'aqk: 1\nentry: [AGENTS.md]\nrules: rules\ngates:\n  ok: "true"\n' > .aqk.yml ) >/dev/null 2>&1
+B1=$( cd "$BRFP" && AQK_LANG=ru node "$CLI" doctor --run --min 1 --brief 2>&1 ); B1C=$?
+B2=$( cd "$BRFP" && AQK_LANG=ru node "$CLI" doctor --run --min 1 --brief 2>&1 )
+rm -f "$BRFP/.aqk/advice-shown"
+B3=$( cd "$BRFP" && AQK_ADVICE=0 AQK_LANG=ru node "$CLI" doctor --run --min 1 --brief 2>&1 )
+if [ "$B1C" -eq 0 ] &&
+   printf '%s' "$B1" | grep -qE "^(❖ )?AQK  держит" &&
+   printf '%s' "$B1" | grep -q "поставить:" &&
+   printf '%s' "$B2" | grep -qE "^(❖ )?AQK  держит" &&
+   ! printf '%s' "$B2" | grep -q "поставить:" &&
+   ! printf '%s' "$B3" | grep -q "поставить:" &&
+   [ "$(printf '%s\n' "$B2" | wc -l)" -le 2 ]; then
+  ok "краткий режим: строка есть всегда, совет один раз в сутки и выключается"
+else
+  bad "краткий режим ведёт себя не так" "первый: $(printf '%s' "$B1" | head -1) · второй строк: $(printf '%s\n' "$B2" | wc -l)"
+fi
+rm -rf "$BRFP"
+
+# --- 100. в awk-программах гейтов нет повторителей {n} ------------------------
+# Часть сборок mawk не понимает повторители в регулярках. Условие с {4} не
+# совпадает НИКОГДА, и гейт молча выходит с нулём на собственном красном образце: ровно тот
+# отказ, против которого написан комплект. Поймано сборкой docker-образа 2026-09-08 — на хосте
+# gawk, и ни один прогон не краснел. Проверка статическая и потому дешёвая; настоящий прогон
+# под старым awk делает задание `image` в конвейере — там образ, в котором дефект и нашёлся.
+# ВАЖНО, ЧТО ИМЕННО СБОРКА: mawk 1.3.4 20240123 (ubuntu-latest, эта машина) повторители
+# ПОНИМАЕТ, mawk 1.3.4 20200120 (node:22-slim) — нет. Замерено 2026-09-09. Поэтому «прогнать
+# под mawk» ничего не значит без указания, под каким,
+# а прочитать исходники — можем.
+AWKBAD=""
+for G in "$ROOT"/kit/gates/*/check.sh "$ROOT"/kit/gates/_skip.sh; do
+  [ -f "$G" ] || continue
+  # Только строки внутри awk-программ; комментарии оболочки (#) не считаем.
+  # Только регулярки AWK: `t ~ /…/` и образец-действие `/…/ {`. Шаблоны для grep, лежащие в
+  # переменных оболочки, сюда не попадают намеренно — GNU grep и busybox grep повторители
+  # понимают оба, и краснеть на них значит краснеть на нормальном укладе.
+  HIT=$(sed 's/^[[:space:]]*#.*$//' "$G" | grep -nE '(~[[:space:]]*/|^[[:space:]]*/)' \
+        | grep -E '\{[0-9]+(,[0-9]*)?\}' | head -2)
+  [ -n "$HIT" ] && AWKBAD="${AWKBAD:+$AWKBAD; }$(basename "$(dirname "$G")"): $(printf '%s' "$HIT" | head -1 | cut -c1-60)"
+done
+if [ -z "$AWKBAD" ]; then
+  ok "в проверках каталога нет повторителей {n} — они не работают под mawk"
+else
+  bad "повторитель {n} в проверке: под mawk она молчит" "$AWKBAD"
+fi
+
+# --- 101. проверка версии: раз в сутки, не в конвейере, молча при отказе ------
+# До этой строки комплект не делал ни одного исходящего запроса. Раз делает — обязан делать
+# ровно то, что о нём написано: спрашивать реестр не чаще раза в сутки и НЕ спрашивать в
+# конвейере. Само наличие новой версии здесь не проверяется — она зависит от реестра, а
+# проверка, зависящая от чужого сервера, краснеет по чужой воле. Сравнение версий проверено
+# модульно; здесь — то, что вокруг него.
+UPDP="$(mktemp -d)"
+( cd "$UPDP" && git init -q . && printf 'x=1\n' > a.py && printf '# вход\n' > AGENTS.md &&
+  printf '.x\n' > .gitignore && mkdir -p rules .aqk/docs && printf 'п\n' > rules/r.md &&
+  printf 'aqk: 1\nentry: [AGENTS.md]\nrules: rules\ngates:\n  ok: "true"\n' > .aqk.yml ) >/dev/null 2>&1
+( cd "$UPDP" && env -u CI -u GITHUB_ACTIONS AQK_LANG=ru node "$CLI" doctor --run --min 1 --brief ) >/dev/null 2>&1
+ASKED=$([ -f "$UPDP/.aqk/update-checked" ] && echo да || echo нет)
+rm -f "$UPDP/.aqk/update-checked"
+( cd "$UPDP" && CI=true AQK_LANG=ru node "$CLI" doctor --run --min 1 --brief ) >/dev/null 2>&1
+IN_CI=$([ -f "$UPDP/.aqk/update-checked" ] && echo да || echo нет)
+rm -f "$UPDP/.aqk/update-checked"
+( cd "$UPDP" && env -u CI AQK_UPDATE=0 AQK_LANG=ru node "$CLI" doctor --run --min 1 --brief ) >/dev/null 2>&1
+OFF=$([ -f "$UPDP/.aqk/update-checked" ] && echo да || echo нет)
+# «нет сети» — тоже допустимый исход первого случая: молчание при отказе и есть требование.
+if [ "$IN_CI" = "нет" ] && [ "$OFF" = "нет" ]; then
+  ok "версия спрашивается вне конвейера ($ASKED), не спрашивается в конвейере и при AQK_UPDATE=0"
+else
+  bad "проверка версии спрашивает там, где не должна" "вне CI: $ASKED, в CI: $IN_CI, выключено: $OFF"
+fi
+rm -rf "$UPDP"
+
+# --- 102. строка манифеста, которую разбор не понял, называется вслух ---------
+# Найдено случайно 2026-09-09: подсадили падающий гейт с именем «плохой», чтобы посмотреть на
+# вывод, — прогон вышел с НУЛЁМ. Гейт не упал: его не существовало. Разбор берёт имена только
+# латиницей, а строку, не подошедшую под это, выбрасывал без единого слова. Человек видит
+# проверку в файле, а её нет — наш класс в чистом виде, и хуже опечатки в имени поля: ту мы
+# называем с 2026-09-06, а эту не называли вовсе.
+UNPP="$(mktemp -d)"
+( cd "$UNPP" && git init -q . && printf '# вход\n' > AGENTS.md &&
+  printf 'aqk: 1\nentry: [AGENTS.md]\nlang: ru\ngates:\n  ok: "true"\n  плохой: "false"\n' > .aqk.yml ) >/dev/null 2>&1
+UNP=$( cd "$UNPP" && node "$CLI" doctor 2>&1 )
+( cd "$UNPP" && printf 'aqk: 1\nentry: [AGENTS.md]\nlang: ru\ngates:\n  ok: "true"\n  bad: "false"\n' > .aqk.yml )
+OKM=$( cd "$UNPP" && node "$CLI" doctor 2>&1 )
+if printf '%s' "$UNP" | grep -q "НЕ ДЕЙСТВУЕТ" &&
+   printf '%s' "$UNP" | grep -q "строка 6" &&
+   ! printf '%s' "$OKM" | grep -q "НЕ ДЕЙСТВУЕТ"; then
+  ok "непонятая строка манифеста называется с номером, понятая — молчит"
+else
+  bad "потерянная строка манифеста не названа" "$(printf '%s' "$UNP" | grep -c 'НЕ ДЕЙСТВУЕТ') на кириллице, $(printf '%s' "$OKM" | grep -c 'НЕ ДЕЙСТВУЕТ') на латинице"
+fi
+rm -rf "$UNPP"
+
+# --- 103. vitals: отказ роняет, выбор и незнание — нет ------------------------
+# `doctor` смотрит на репозиторий, `prove` — на гейты, `context` — на состояние. На саму
+# обвязку не смотрел никто: стоят ли инструменты объявленных гейтов, прописан ли хук в
+# .git/hooks НА САМОМ ДЕЛЕ. Раньше это выяснялось красным гейтом посреди коммита.
+# Первая версия ставила крест хуку, которого нет, — и на нашем же репозитории вышло два креста
+# за сознательное решение (pre-commit локально не ставим, гоняем в CI). Команда, которая кричит
+# «сломано» про выбор, перестаёт читаться вместе с настоящими отказами. Проверяются оба конца.
+VITP="$(mktemp -d)"
+( cd "$VITP" && git init -q . && printf '# вход\n' > AGENTS.md &&
+  printf 'aqk: 1\nentry: [AGENTS.md]\nlang: ru\ngates:\n  ok: "true"\n' > .aqk.yml ) >/dev/null 2>&1
+VOK=$( cd "$VITP" && AQK_LANG=ru node "$CLI" vitals 2>&1 ); VOK_C=$?
+( cd "$VITP" && printf 'aqk: 1\nentry: [AGENTS.md]\nlang: ru\ngates:\n  lint: "инструментакоторогонет ."\n' > .aqk.yml )
+VBAD=$( cd "$VITP" && AQK_LANG=ru node "$CLI" vitals 2>&1 ); VBAD_C=$?
+if [ "$VOK_C" -eq 0 ] && [ "$VBAD_C" -eq 1 ] &&
+   printf '%s' "$VBAD" | grep -q "НЕ НАЙДЕНЫ" &&
+   printf '%s' "$VOK" | grep -q "хук pre-commit"; then
+  ok "vitals: пропавший инструмент роняет прогон, отсутствие хука — нет"
+else
+  bad "vitals путает отказ с выбором" "исправный код $VOK_C, сломанный код $VBAD_C"
+fi
+rm -rf "$VITP"
+
+# --- 106. совещательный гейт назван всегда и не роняет прогон никогда ---------
+# Два отказа, найденные 2026-09-09 сверкой документации с кодом. ПЕРВЫЙ: зелёный совещательный
+# печатался обычной галочкой — гейт, который уронить сборку НЕ МОЖЕТ, по выводу неотличим от
+# того, который может, и список `advisory:` был виден только в день, когда он покраснел. Ровно
+# та тишина, против которой написан стандарт, только про сам прибор. ВТОРОЙ: при `--since` гейт,
+# чей вывод не содержит путей, шёл через ветку «сузить нечем» с безусловным failed++ — то есть
+# совещательный ронял прогон. Проверено сравнением с кодом до починки: было 1, стало 0.
+# Команда гейта — ФАЙЛ, а не строка с `;`. На windows `spawnSync(shell: true)` запускает
+# cmd.exe, а не sh: там `echo x; exit 1` печатается целиком и выходит с НУЛЁМ. Первая версия
+# этой проверки так и провалилась в конвейере на windows — фикстура, а не код. Заодно урок про
+# сам тест: утверждение «зелёный помечен» искало подстроку «совещательный», которая есть и в
+# пометке КРАСНОГО совещательного, — то есть проходило бы и при полном отсутствии починки.
+# Теперь ищется текст, который бывает только на зелёной строке.
+ADVP="$(mktemp -d)"
+(
+  cd "$ADVP" && git init -q . && git config user.email a@b && git config user.name a
+  printf '# вход\n' > AGENTS.md && mkdir -p r && printf 'x\n' > r/a.md
+  printf '#!/bin/sh\necho "вердикт без путей"\nexit 1\n' > noscope.sh
+  printf '#!/bin/sh\nexit 0\n' > quiet.sh
+  printf 'aqk: 1\nentry: [AGENTS.md]\nrules: r\ngates:\n  adv: "bash quiet.sh"\nadvisory:\n  - adv\n' > .aqk.yml
+  git add -A && git commit -qm "Сделано: основа. Не уверен: ничего"
+) >/dev/null 2>&1
+ADVBASE=$( cd "$ADVP" && git rev-parse --abbrev-ref HEAD )
+( cd "$ADVP" && git checkout -qb feat && printf 'y\n' > r/b.md && git add -A &&
+  git commit -qm "Сделано: файл. Не уверен: ничего" ) >/dev/null 2>&1
+ADVGREEN=$( cd "$ADVP" && AQK_LANG=ru node "$CLI" doctor --run --min 1 2>&1 )
+( cd "$ADVP" && printf 'aqk: 1\nentry: [AGENTS.md]\nrules: r\ngates:\n  adv: "bash noscope.sh"\nadvisory:\n  - adv\n' > .aqk.yml )
+( cd "$ADVP" && node "$CLI" doctor --run --min 1 --since "$ADVBASE" >/dev/null 2>&1 ); ADV_C=$?
+( cd "$ADVP" && printf 'aqk: 1\nentry: [AGENTS.md]\nrules: r\ngates:\n  adv: "bash noscope.sh"\n' > .aqk.yml )
+( cd "$ADVP" && node "$CLI" doctor --run --min 1 --since "$ADVBASE" >/dev/null 2>&1 ); BLOCK_C=$?
+if printf '%s' "$ADVGREEN" | grep -q "уронить прогон не может" && [ "$ADV_C" -eq 0 ] && [ "$BLOCK_C" -eq 1 ]; then
+  ok "совещательный назван и на зелёном, и не роняет прогон даже когда сузить нечем"
+else
+  bad "совещательный гейт неотличим или роняет прогон" "зелёный помечен: $(printf '%s' "$ADVGREEN" | grep -c 'уронить прогон не может'), код совещательного $ADV_C, код блокирующего $BLOCK_C"
+fi
+rm -rf "$ADVP"
+
+# --- 107. prove пропускает запись без её программы, а не обвиняет её ----------
+# ТО ЖЕ, ЧТО НАШЁЛ ВТОРОЙ ПОЛЬЗОВАТЕЛЬ, ТОЛЬКО ДРУГОЙ ДВЕРЬЮ. Переносимый рецепт бывает обёрткой
+# вокруг готового инструмента: первое слово команды тогда `bash`, и по нему не видно, чего не
+# хватает. Без программы обёртка краснеет на ОБОИХ образцах, и prove объявлял исправный гейт
+# сломанным — «краснеет на исправном коде». От prove зависят ступень AQK-2 и значок, то есть
+# отсутствие чужой программы отбирало у проекта уровень. Обвинение вместо диагноза.
+# Приёмка (gates.sh) и мутационная проверка поле `requires` читают давно; prove — не читал.
+# Проверено 2026-09-09 на своём же репозитории: не стояли slopcheck и zizmor, prove дал два
+# обвинения и код 1. Проверяются ОБА конца: без поля — обвинение и код 1, с полем — пропуск и 0.
+PRVP="$(mktemp -d)"
+(
+  cd "$PRVP" && git init -q . && printf '# вход\n' > AGENTS.md && mkdir -p r s/wrap/red s/wrap/green
+  printf 'x\n' > s/wrap/red/a.txt && printf 'x\n' > s/wrap/green/a.txt
+  # Обёртка вокруг программы, которой на машине нет: краснеет на обоих образцах.
+  printf '#!/bin/sh\nпрограммыкоторойнет "$1" || exit 2\n' > wrap.sh
+  # Настоящая проверка: prove требует, чтобы хоть один гейт был ДОКАЗАН, иначе проект,
+  # у которого всё недоказуемо, получал бы уровень ни за что. Команда обязана кончаться
+  # каталогом — иначе подставлять образец некуда, и гейт сам станет недоказуемым.
+  printf '#!/bin/sh\ngrep -rq НЕЛЬЗЯ "$1" && exit 1\nexit 0\n' > real.sh
+  printf 'aqk: 1\nentry: [AGENTS.md]\nrules: r\nsamples: s\ngates:\n  wrap: "sh wrap.sh ."\n  real: "sh real.sh ."\n' > .aqk.yml
+) >/dev/null 2>&1
+# Второй гейт обязан быть доказуемым: prove требует хотя бы одного доказанного.
+( cd "$PRVP" && mkdir -p s/real/red s/real/green &&
+  printf 'НЕЛЬЗЯ\n' > s/real/red/a.txt && printf 'можно\n' > s/real/green/a.txt )
+PRV_NOREQ=$( cd "$PRVP" && AQK_LANG=ru node "$CLI" prove 2>&1 ); PRV_NOREQ_C=$?
+( cd "$PRVP" && printf 'intent: обёртка\nrequires: программыкоторойнет\nrecipes:\n  any: "sh wrap.sh {dir}"\n' > s/wrap/gate.yml )
+PRV_REQ=$( cd "$PRVP" && AQK_LANG=ru node "$CLI" prove 2>&1 ); PRV_REQ_C=$?
+# Тот же вопрос задаёт `vitals`, и до 2026-09-09 он отвечал на него иначе: печатал «все
+# инструменты на месте», потому что смотрел только на ПЕРВОЕ СЛОВО команды — `sh`, который есть
+# всегда. Две команды об одном репозитории говорили разное; читатель верил той, что зеленее.
+PRV_VIT=$( cd "$PRVP" && AQK_LANG=ru node "$CLI" vitals 2>&1 )
+if [ "$PRV_NOREQ_C" -ne 0 ] && [ "$PRV_REQ_C" -eq 0 ] &&
+   printf '%s' "$PRV_REQ" | grep -q "НЕ ПРОВЕРЕНА здесь" &&
+   printf '%s' "$PRV_VIT" | grep -q "программыкоторойнет"; then
+  ok "prove и vitals одинаково видят программу из requires: пропуск, а не обвинение"
+else
+  bad "prove путает «нечем проверить» со «сломан», либо vitals её не видит" \
+      "без поля код $PRV_NOREQ_C, с полем код $PRV_REQ_C, vitals назвал: $(printf '%s' "$PRV_VIT" | grep -c 'программыкоторойнет')"
+fi
+rm -rf "$PRVP"
+
+# --- 104. опись в AGENTS.md покрывает все исходники ---------------------------
+# AGENTS.md — первое, что читает агент, и раздел «Где что лежит» для него карта. Карта,
+# отставшая от дерева, хуже её отсутствия: агент уверен, что видел всё. Проверено 2026-09-09 —
+# в описи не было восьми файлов из четырнадцати добавленных за неделю (`brief.mjs`, `banner.mjs`
+# и шесть `units-*.mjs`), и заметить это можно было только сверкой руками. Тот же класс, что
+# «гейт объявлен и не существует»: расхождение молчит.
+MISSING=""
+for F in "$ROOT"/tool/lib/*.mjs "$ROOT"/tool/commands/*.mjs "$ROOT"/tool/selfcheck/* "$ROOT"/tool/selfcheck/*/*; do
+  B=$(basename "$F")
+  grep -qF "$B" "$ROOT/AGENTS.md" || MISSING="$MISSING $B"
+done
+if [ -z "$MISSING" ]; then
+  ok "опись «Где что лежит» называет каждый исходник"
+else
+  bad "AGENTS.md не называет файлы" "$MISSING"
+fi
+
+# --- 105. два README не расходятся структурно --------------------------------
+# AGENTS.md требует, чтобы README и его перевод не расходились, и до сегодня требование не
+# работало: на 2026-09-09 в английском было 23 раздела, в русском 22 — «Первый прогон на
+# настоящем проекте» отсутствовал целиком, а «Как ввести правило» стояло в другом разделе.
+# Читатель одного языка получал инструкцию, которой у читателя другого не было. Сверяется
+# ПОСЛЕДОВАТЕЛЬНОСТЬ уровней, а не тексты: заголовки на разных языках сравнивать нельзя.
+# Строки внутри ``` не считаются: в примере .aqkignore есть строка, начинающаяся с #.
+levels() {
+  awk '/^```/ { inf = !inf; next } !inf && /^#/ { sub(/[^#].*/, ""); print }' "$1"
+}
+if [ "$(levels "$ROOT/README.md")" = "$(levels "$ROOT/README.ru.md")" ]; then
+  ok "README.md и README.ru.md несут одни и те же разделы ($(levels "$ROOT/README.md" | wc -l | tr -d ' '))"
+else
+  bad "README и перевод разошлись структурно" \
+      "англ. $(levels "$ROOT/README.md" | wc -l | tr -d ' '), рус. $(levels "$ROOT/README.ru.md" | wc -l | tr -d ' ')"
+fi
+
+# --- 108. init доходит до конца, когда дом недоступен для записи ---------------
+# НАШЁЛ КОНВЕЙЕР, А НЕ ПРОГОН. Одноразовая пометка «просьбу про звезду уже показывали» пишется
+# в $HOME/.config/aqk. В контейнере, запущенном `--user 1001:127`, у этого uid нет записи в
+# /etc/passwd, homedir() даёт «/», и mkdir падает с EACCES на «/.config» — роняя ВЕСЬ init.
+# То есть любой, кто набрал команду из нашей же документации по docker, получал падение вместо
+# установки. Локально не воспроизводилось по случайности: uid разработчика 1000 совпадает с
+# пользователем `node` в образе, у которого дом есть; на раннере uid 1001 — не совпадает.
+# Удобство не имеет права ронять работу команды. Молчать о нём тоже нельзя — это swallowed-error.
+HOMEP="$(mktemp -d)"; HOMEH="$(mktemp -d)"
+chmod 500 "$HOMEH" 2>/dev/null
+# На windows chmod прав не отнимает: там эта проверка ничего не проверяет и говорит об этом,
+# а не зеленеет молча. Тот же приём, что «НЕ ПРОВЕРЕНА здесь» в приёмке каталога.
+if ( : > "$HOMEH/проба" ) 2>/dev/null; then
+  rm -f "$HOMEH/проба"
+  ok "init при недоступном доме — НЕ ПРОВЕРЕНА здесь: chmod прав не отнимает"
+else
+  ( cd "$HOMEP" && git init -q . ) >/dev/null 2>&1
+  HOMEOUT=$( cd "$HOMEP" && HOME="$HOMEH" AQK_LANG=ru node "$CLI" init 2>&1 ); HOME_C=$?
+  if [ "$HOME_C" -eq 0 ] && [ -f "$HOMEP/.aqk.yml" ] &&
+     printf '%s' "$HOMEOUT" | grep -q "запомнить не удалось"; then
+    ok "init доходит до конца при недоступном доме и называет, чего не смог"
+  else
+    bad "init падает или молчит, когда дом недоступен для записи" \
+        "код $HOME_C, манифест $([ -f "$HOMEP/.aqk.yml" ] && echo есть || echo нет)"
+  fi
+fi
+chmod 700 "$HOMEH" 2>/dev/null; rm -rf "$HOMEP" "$HOMEH"
+
+# --- 109. probe: находит слепоту и не выдаёт её за покрытие ---------------------
+# ЗАЧЕМ КОМАНДА. `doctor` говорит «держит машина N» — N из чего? `prove` доказывает, что гейт
+# ловит брак НА СВОЁМ образце. Ни один не отвечает: что в ЭТОМ репозитории не прикрыто ничем.
+# Замер 2026-09-09 на самом комплекте: настоящий файл, подсаженные проглоченная ошибка и печать,
+# 21 объявленный гейт — покраснело НОЛЬ. Узнать об этом было нечем.
+# Проверяются ОБА конца: класс, который объявленный гейт ловит, обязан быть зелёным, а тот,
+# которого не ловит никто, — красным. Проверка одного конца пропустила бы команду, которая
+# всегда говорит «не прикрыто», и команду, которая всегда говорит «прикрыто».
+PRBP="$(mktemp -d)"
+(
+  cd "$PRBP" && git init -q . && git config user.email a@b && git config user.name a
+  mkdir -p src && printf 'def send(to):\n    return 1\n' > src/mailer.py
+  git add -A && git commit -qm "feat: почта"
+  printf '# правка\n' >> src/mailer.py && git add -A && git commit -qm "fix: письма не уходили"
+  node "$CLI" init && node "$CLI" add todo-without-task
+  # Коммитим ВСЁ, что положили init и add: иначе дерево грязное ещё до пробы, и проверка
+  # «probe ничего не пишет» меряла бы мою же фикстуру, а не команду.
+  git add -A && git commit -qm "Сделано: комплект. Не уверен: ничего"
+) >/dev/null 2>&1
+PRB=$( cd "$PRBP" && AQK_LANG=ru node "$CLI" probe --top 1 2>&1 ); PRB_C=$?
+# Слепое: secrets-not-in-code не объявлен, образец под .py у него есть — обязан быть красным.
+# Прикрытое: todo-without-task объявлен — обязан быть зелёным и назвать, кто поймал.
+if [ "$PRB_C" -eq 0 ] &&
+   printf '%s' "$PRB" | grep -q "НЕ ЛОВИТ НИКТО" &&
+   printf '%s' "$PRB" | grep -q "ловит: todo-without-task" &&
+   printf '%s' "$PRB" | grep -q "починок в истории: 1"; then
+  ok "probe: слепые классы названы, прикрытый назван поимённо, прогон не уронен"
+else
+  bad "probe не различает слепое и прикрытое" "код $PRB_C, слепых $(printf '%s' "$PRB" | grep -c 'НЕ ЛОВИТ'), пойманных $(printf '%s' "$PRB" | grep -c 'ловит:')"
+fi
+# КОД человека проба не трогает: образец живёт во временном каталоге. Если бы он попал в
+# репозиторий, команда осмотра стала бы командой правки — и её выключили бы в тот же день.
+# Своя отметка каденции — исключение, и единственное: она лежит в `.aqk/`, там же, где отчёт
+# прогона, и без неё каденция невозможна (следующий прогон не узнает, что проба была).
+# Проверяется именно это разделение: за пределами `.aqk/` — ни следа.
+DIRTY=$( cd "$PRBP" && git status --porcelain | grep -cv ' \.aqk/' )
+if [ "$DIRTY" -eq 0 ]; then
+  ok "probe не трогает код: пишет только свою отметку в .aqk/"
+else
+  bad "probe оставил следы вне .aqk/" "$(cd "$PRBP" && git status --porcelain | grep -v ' \.aqk/' | head -3 | tr '\n' ' ')"
+fi
+rm -rf "$PRBP"
+
+# --- 111. проба случается САМА, один раз, и попадает агенту в контекст -----------
+# ГЛАВНОЕ В ЭТОЙ ПРОВЕРКЕ — не механика, а замысел. Владелец сформулировал так: «команду, о
+# которой надо вспомнить, агент не вспомнит, а человек о ней не узнает». Это тот же класс, что
+# файл, который можно не прочитать, — и весь комплект написан против него. Значит `probe`,
+# оставленная ручной, отвечает на важнейший вопрос и не задаётся никем.
+# Проверяются три вещи, и каждая — отдельный способ провалиться:
+#   1. прогон делает пробу САМ, когда её не делали;
+#   2. второй прогон подряд её НЕ повторяет — иначе каденция превращается в шум;
+#   3. агент узнаёт результат из блока состояния, не зная про команду.
+CADP="$(mktemp -d)"
+(
+  cd "$CADP" && git init -q . && git config user.email a@b && git config user.name a
+  mkdir -p src && printf 'def s():\n    return 1\n' > src/a.py
+  git add -A && git commit -qm "feat: старт"
+  printf '# п\n' >> src/a.py && git add -A && git commit -qm "fix: не работало"
+  node "$CLI" init && node "$CLI" add todo-without-task
+) >/dev/null 2>&1
+CTX0=$( cd "$CADP" && AQK_LANG=ru node "$CLI" context 2>&1 )
+RUN1=$( cd "$CADP" && AQK_LANG=ru node "$CLI" doctor --run 2>&1 )
+RUN2=$( cd "$CADP" && AQK_LANG=ru node "$CLI" doctor --run 2>&1 )
+CTX1=$( cd "$CADP" && AQK_LANG=ru node "$CLI" context 2>&1 )
+if printf '%s' "$CTX0" | grep -q "НЕИЗВЕСТНО" &&
+   printf '%s' "$RUN1" | grep -q "ещё не делали" &&
+   ! printf '%s' "$RUN2" | grep -q "ещё не делали" &&
+   printf '%s' "$CTX1" | grep -q "Не прикрыто ничем"; then
+  ok "проба запускается прогоном сама, не повторяется и попадает агенту в контекст"
+else
+  bad "каденция пробы не работает" \
+      "до: $(printf '%s' "$CTX0" | grep -c 'НЕИЗВЕСТНО'), первый: $(printf '%s' "$RUN1" | grep -c 'ещё не делали'), второй: $(printf '%s' "$RUN2" | grep -c 'ещё не делали'), после: $(printf '%s' "$CTX1" | grep -c 'Не прикрыто')"
+fi
+# Выключатель обязан быть у всего, что случается само: иначе первый же, кому это помешало,
+# выключит весь прогон, а не одну пробу.
+CADP2="$(mktemp -d)"
+( cd "$CADP2" && git init -q . && git config user.email a@b && git config user.name a
+  mkdir -p src && printf 'def s():\n    return 1\n' > src/a.py
+  git add -A && git commit -qm "feat: старт"
+  node "$CLI" init && node "$CLI" add todo-without-task ) >/dev/null 2>&1
+OFF=$( cd "$CADP2" && AQK_PROBE=0 AQK_LANG=ru node "$CLI" doctor --run 2>&1 )
+if ! printf '%s' "$OFF" | grep -q "ещё не делали"; then
+  ok "AQK_PROBE=0 выключает пробу, не трогая прогон"
+else
+  bad "проба игнорирует выключатель" "AQK_PROBE=0 не подействовал"
+fi
+rm -rf "$CADP" "$CADP2"
+
+# --- переехавшие проверки: встроенный раннер --------------------------------
+# ПОЧЕМУ ЗДЕСЬ МОСТ, А НЕ ВТОРАЯ КОМАНДА. Проверки переезжают на `node --test` по одной, и всё
+# это время у прогона обязана оставаться ОДНА точка входа и ОДИН счётчик: два числа в двух
+# местах через месяц разойдутся, и никто не заметит, что половина не запускается.
+#
+# ЗАЧЕМ ПЕРЕЕЗД. У встроенного раннера есть то, чего нет у этого файла и не появится: свой
+# каталог и уборка на каждую проверку, таймаут на каждую, точечный перезапуск одной по имени
+# (`--test-name-pattern`). Диагностика отказа падает с сорока секунд до одной. Проверено на
+# Node 20.20.2 — той версии, что стоит в конвейере.
+NODE_SMOKE="$ROOT/tool/selfcheck/smoke"
+if [ -d "$NODE_SMOKE" ]; then
+  NS_OUT=$(cd "$ROOT" && node --test --test-reporter=tap "$NODE_SMOKE"/*.test.mjs 2>&1)
+  # Разбираем только верхний уровень TAP: вложенные строки идут с отступом.
+  while IFS= read -r NS_LINE; do
+    case "$NS_LINE" in
+      "ok "*)     ok "${NS_LINE#*- }" ;;
+      "not ok "*)
+        # ОБЪЯСНЕНИЕ ОБЯЗАНО ДОЕХАТЬ. Первая редакция моста печатала только «не прошло» и совет
+        # запустить вручную — то есть отправляла гадать ровно там, где ответ уже был получен.
+        # Стоило это трёх кругов конвейера: проверка падала только на раннере, а сообщение
+        # утверждения оставалось в выводе, который мост выбрасывал. TAP кладёт его в блок после
+        # строки `not ok`, полем `error:`.
+        # TAP кладёт многострочное сообщение блочным скаляром: строка `error: |-`, а сам текст
+        # идёт следующими строками с отступом. Первая редакция брала только строку `error:` и
+        # печатала «|-» — то есть снова ничего.
+        NS_WHY=$(printf '%s\n' "$NS_OUT" | awk '
+          /^[[:space:]]+error:/ { inerr = 1; sub(/^[[:space:]]*error:[[:space:]]*/, ""); if ($0 != "|-" && $0 != "") print; next }
+          inerr && /^[[:space:]]+(code|stack|failureType|type|duration_ms):/ { inerr = 0 }
+          inerr && /^[[:space:]]*\.\.\.[[:space:]]*$/ { inerr = 0 }
+          inerr { sub(/^[[:space:]]+/, ""); print }
+        ' | head -6 | tr '\n' ' ')
+        bad "${NS_LINE#*- }" "${NS_WHY:-подробности: node --test $NODE_SMOKE/*.test.mjs}" ;;
+    esac
+  done <<EOF
+$(printf '%s\n' "$NS_OUT" | grep -E '^(ok|not ok) ')
+EOF
+fi
+
 # --- итог -------------------------------------------------------------------
 printf '\n'
 if [ "$FAIL" -eq 0 ]; then
@@ -1445,5 +1962,10 @@ else
   printf '  \033[31mпровалено: %s из %s\033[0m\n\n' "$FAIL" "$((PASS + FAIL))"
 fi
 
-printf '  \033[2mне покрыто: содержание документов, установка с GitHub через npx\033[0m\n\n'
+printf '  \033[2mне покрыто: СОДЕРЖАНИЕ документов (сверяется опись и структура, не текст),\n  установка с GitHub через npx\033[0m\n\n'
+
+# ИМЕНА УПАВШИХ — САМОЙ ПОСЛЕДНЕЙ СТРОКОЙ, и это не косметика. Прогон запускают гейтом, а вывод
+# упавшего гейта обрезается: видно голову и хвост. Значит единственное место, где список
+# гарантированно доедет до глаз, — конец. Проверено прогоном с нарочно сломанной проверкой.
+[ "$FAIL" -eq 0 ] || printf '  \033[31mупало: %s\033[0m\n\n' "$FAILED_NAMES"
 exit "$FAIL"