agent-quality-kit 0.6.0 → 0.8.0

package/tool/selfcheck/smoke.sh

@@ -25,6 +25,13 @@ 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)); }
 
+# Node на Windows видит мир глазами Windows, а Git Bash — глазами POSIX: путь вида
+# /tmp/tmp.XXXX, отданный в `node -e`, там не существует, и проверка падает не на том, что
+# проверяет. Поймано дважды на windows-прогоне — сперва на `learn`, потом на установке хука.
+# Поэтому node запускается ИЗ каталога и получает относительный путь: помощник, а не памятка,
+# потому что памятку третий раз забудут ровно так же, как забыли второй.
+node_in() { D="$1"; shift; ( cd "$D" && node "$@" ); }
+
 WORK="$(mktemp -d)"
 trap 'rm -rf "$WORK"' EXIT
 
@@ -164,12 +171,18 @@ done
 # --- 8. храповик: старое пропускает, новое не пускает ------------------------
 # Главный вопрос к храповику: «может ли новый код добавить нарушение и пройти?»
 # Может — значит это советчик, а не гейт.
+# ПОЧЕМУ ПРИМАНКА ИМЕННО gate-not-weakened. У записи должен быть ТОЛЬКО переносимый рецепт:
+# иначе на машине, где стоит ruff или eslint, установка возьмёт рецепт под язык, и проверка
+# станет печатать чужой формат вывода. Так и вышло — прогон был зелёным локально и красным в
+# конвейере ровно потому, что в конвейер добавили ruff: четыре проверки искали в выводе наши
+# «почини: …» и «путь:строка», а получали формат ruff. Прогон, чей исход зависит от того, что
+# случайно стоит на машине, не проверяет ничего.
 R="$WORK/ratchet"; mkdir -p "$R"; cd "$R" || exit 1
 git init -q .
-printf 'def a():\n    print("старое")\n' > old.py
+printf 'x = 1  # noqa\n' > old.py
 node "$CLI" init >/dev/null 2>&1
-node "$CLI" add no-print-in-prod >/dev/null 2>&1
-node "$CLI" ratchet no-print-in-prod >/dev/null 2>&1
+node "$CLI" add gate-not-weakened >/dev/null 2>&1
+node "$CLI" ratchet gate-not-weakened >/dev/null 2>&1
 
 # Судим по вердикту гейта, а не по коду возврата doctor: он ненулевой и по другим
 # причинам (в свежей папке нет .gitignore), и проверка бы врала о храповике.
@@ -179,7 +192,7 @@ case "$OUT" in
   *) ok "храповик пропустил старое нарушение" ;;
 esac
 
-printf 'def b():\n    print("новое")\n' > new.py
+printf 'y = 2  # noqa\n' > new.py
 OUT="$(node "$CLI" doctor --run 2>&1)"
 case "$OUT" in
   *"новых нарушений"*) ok "храповик не пустил новое нарушение" ;;
@@ -189,7 +202,7 @@ esac
 # Второй прогон с тем же новым нарушением обязан краснеть так же. Пока реестр перезаписывался
 # всем текущим списком, одно исправленное нарушение затягивало в долг ВСЕ новые: один красный
 # прогон — и дальше зелено навсегда. «Может ли новый код добавить нарушение и пройти?» — мог.
-printf 'def c():\n    print("ещё одно")\n' > another.py
+printf 'z = 3  # noqa\n' > another.py
 node "$CLI" doctor --run >/dev/null 2>&1
 rm old.py
 OUT="$(node "$CLI" doctor --run 2>&1)"
@@ -199,12 +212,12 @@ case "$OUT2" in
   *) bad "исправление одного нарушения затянуло новые в долг" "второй прогон зелёный" ;;
 esac
 rm -f another.py
-printf 'def a():\n    print("старое")\n' > old.py
-node "$CLI" ratchet no-print-in-prod >/dev/null 2>&1 || true
+printf 'x = 1  # noqa\n' > old.py
+node "$CLI" ratchet gate-not-weakened >/dev/null 2>&1 || true
 
 rm -f new.py old.py
 node "$CLI" doctor --run >/dev/null 2>&1
-if grep -q 'old.py' ratchets/no-print-in-prod.txt; then
+if grep -q 'old.py' ratchets/gate-not-weakened.txt; then
   bad "исправленное осталось в реестре — храповик не затягивается"
 else
   ok "исправленное вычеркнуто из реестра"
@@ -250,27 +263,13 @@ case "$OUT" in
 esac
 cd "$WORK" || exit 1
 
-# --- 8б. проект называет свои каталоги, где печать — интерфейс ---------------
-# Исключение объявляется В МАНИФЕСТЕ и потому видно глазами. Проверяем обе стороны: названный
-# каталог пропускается, все остальные — нет. Исключение, которое прячет всё, бесполезно.
-P="$WORK/printok"; mkdir -p "$P/cli" "$P/src"; cd "$P" || exit 1
-printf 'def a():\n    print("вывод программы")\n' > cli/main.py
-printf 'def b():\n    print("забытая отладка")\n' > src/service.py
-OUT="$(AQK_PRINT_OK_DIRS=cli bash "$ROOT/kit/gates/no-print-in-prod/check.sh" . 2>&1)"
-case "$OUT" in
-  *"cli/main.py"*) bad "названный каталог не исключён" "$OUT" ;;
-  *"src/service.py"*) ok "названный каталог пропущен, остальные проверяются" ;;
-  *) bad "проверка печати не нашла отладку вне названного каталога" "$OUT" ;;
-esac
-cd "$WORK" || exit 1
-
 # --- 9. разбор ошибки: три случая различаются прогоном, а не памятью ---------
 # «Сторожа не было», «сторож был и не сработал», «сторож был и его обошли» — разные починки.
 # Пока их различает человек по памяти, чинят обычно не то. Здесь их различает прогон.
 Y="$WORK/why"; mkdir -p "$Y"; cd "$Y" || exit 1
 git init -q .
 node "$CLI" init >/dev/null 2>&1
-printf 'def a():\n    print("отладка")\n' > x.py
+printf 'q = 1  # noqa\n' > x.py
 
 OUT="$(node "$CLI" why "миграция базы применена задом наперёд" 2>&1)"
 case "$OUT" in
@@ -278,21 +277,21 @@ case "$OUT" in
   *) bad "why не сказал, что сторожа не было" "$OUT" ;;
 esac
 
-OUT="$(node "$CLI" why "отладочная печать уехала в прод" 2>&1)"
+OUT="$(node "$CLI" why "подавление проверки целиком без причины" 2>&1)"
 case "$OUT" in
   *"не поставлен"*) ok "why: запись есть в каталоге, но в проекте не поставлена" ;;
   *) bad "why не отличил «не поставлен» от «не было»" "$OUT" ;;
 esac
 
-node "$CLI" add no-print-in-prod >/dev/null 2>&1
-OUT="$(node "$CLI" why "отладочная печать уехала в прод" 2>&1)"
+node "$CLI" add gate-not-weakened >/dev/null 2>&1
+OUT="$(node "$CLI" why "подавление проверки целиком без причины" 2>&1)"
 case "$OUT" in
   *"его обошли"*) ok "why: сторож стоит и ловит — значит его обошли" ;;
   *) bad "why не отличил «обошли» от «не сработал»" "$OUT" ;;
 esac
 
 rm x.py
-OUT="$(node "$CLI" why "отладочная печать уехала в прод" 2>&1)"
+OUT="$(node "$CLI" why "подавление проверки целиком без причины" 2>&1)"
 case "$OUT" in
   *"этой поломки не видит"*) ok "why: сторож стоит, а поломки не видит" ;;
   *) bad "why не отличил «не сработал» от «обошли»" "$OUT" ;;
@@ -579,11 +578,11 @@ rm -rf "$FBDIR" "$FBPROJ"
 REPDIR="$(mktemp -d)"
 (
   cd "$REPDIR" && git init -q . && mkdir -p src &&
-  printf 'def f():\n    print("debug")\n' > src/a.py &&
+  printf 'a = 1  # noqa\n' > src/a.py &&
   node "$CLI" start > /tmp/aqk-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 '❌ no-print-in-prod'; then
+if [ "$REP_CODE" -ne 0 ] && printf '%s' "$REP_OUT" | grep -q '❌ gate-not-weakened'; then
   ok "report краснеет кодом возврата и называет упавший гейт"
 else
   # Код возврата отчёта не говорит, ПОЧЕМУ он ноль: гейт не сработал, не установился или
@@ -591,7 +590,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/no-print-in-prod/check.sh . 2>&1 | head -2 ); G_CODE=$?
+  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' ' ')»"
 fi
 if [ -f "$REPDIR/.aqk/report.md" ] && grep -q '^## ' "$REPDIR/.aqk/report.md"; then
@@ -631,11 +630,11 @@ rm -rf "$NOTEDIR" "$NOTEHOME"
 # то есть настройка правкой чужого файла, которую затрёт следующий `aqk add`.
 IGNDIR="$(mktemp -d)"
 mkdir -p "$IGNDIR/third-party/inner" "$IGNDIR/src"
-printf 'def f():\n    print("свой")\n' > "$IGNDIR/src/mine.py"
-printf 'def f():\n    print("чужой")\n' > "$IGNDIR/third-party/inner/theirs.py"
-OUT_BEFORE="$(bash "$ROOT/kit/gates/no-print-in-prod/check.sh" "$IGNDIR" 2>&1)"
+printf 'mine = 1  # noqa\n' > "$IGNDIR/src/mine.py"
+printf 'theirs = 1  # noqa\n' > "$IGNDIR/third-party/inner/theirs.py"
+OUT_BEFORE="$(bash "$ROOT/kit/gates/gate-not-weakened/check.sh" "$IGNDIR" 2>&1)"
 printf '# принесено из другого репозитория\nthird-party/\n' > "$IGNDIR/.aqkignore"
-OUT_AFTER="$(bash "$ROOT/kit/gates/no-print-in-prod/check.sh" "$IGNDIR" 2>&1)"
+OUT_AFTER="$(bash "$ROOT/kit/gates/gate-not-weakened/check.sh" "$IGNDIR" 2>&1)"
 if printf '%s' "$OUT_BEFORE" | grep -q 'theirs.py' &&
    ! printf '%s' "$OUT_AFTER" | grep -q 'theirs.py' &&
    printf '%s' "$OUT_AFTER" | grep -q 'mine.py'; then
@@ -893,17 +892,104 @@ rm -rf "$BDIR2"
 # Воспроизводим без Windows: урезаем PATH до одного node — инструментов не видно так же.
 NRDIR="$(mktemp -d)"; NRBIN="$(mktemp -d)"
 ln -sf "$(command -v node)" "$NRBIN/node"
-( cd "$NRDIR" && git init -q . && mkdir -p src && printf 'def f():\n    print("debug")\n' > src/a.py )
+( cd "$NRDIR" && git init -q . && mkdir -p src && printf 'a = 1  # noqa\n' > src/a.py )
 NR_OUT=$( cd "$NRDIR" && PATH="$NRBIN" node "$CLI" start 2>&1 ); NR_CODE=$?
 NR_GATES=$( ls "$NRDIR/gates" 2>/dev/null | grep -cv '^_' )
 if [ "$NR_CODE" -eq 0 ] && [ "$NR_GATES" -ge 5 ] &&
-   [ -f "$NRDIR/gates/no-print-in-prod/check.sh" ]; then
+   [ -f "$NRDIR/gates/gate-not-weakened/check.sh" ]; then
   ok "start пропускает запись без пригодного инструмента и ставит остальные ($NR_GATES)"
 else
   bad "start бросил установку из-за одной записи" "код $NR_CODE, поставлено $NR_GATES, хвост: $(printf '%s' "$NR_OUT" | tail -2 | tr '\n' ' ')"
 fi
 rm -rf "$NRDIR" "$NRBIN"
 
+# --- 48г. подделка не берёт уровень выше первого -------------------------------
+# ЗАЧЕМ. Ступень AQK-2 называлась «гейты доказаны» и проверяла, что существуют две папки.
+# Проект с гейтами `true` — командой, которая всегда отвечает «ок», — проходил порог AQK-3 и
+# получал зелёный значок в README. Проверено прогоном 2026-09-07: три «гейта», ноль защиты,
+# высший уровень. Это `pytest || true` на уровне всего стандарта.
+FAKEDIR="$(mktemp -d)"
+(
+  cd "$FAKEDIR" && git init -q .
+  mkdir -p gates ratchets incidents && printf '# Журнал\n' > incidents/README.md
+  # Манифест пишется целиком, а не правится python-ом: проверка, которая на машине без python3
+  # молча собирает ДРУГОЙ проект, доказывает не то, что называет. Найдено код-ревью 2026-09-07.
+  {
+    echo 'aqk: "0.6.0"'
+    echo 'entry:'
+    echo '  - AGENTS.md'
+    echo 'rules: .aqk/rules'
+    echo 'gates:'
+    echo '  lint: "true"'
+    echo '  test: "true"'
+    echo '  security: "true"'
+    echo 'samples: gates'
+    echo 'ratchets: ratchets'
+    echo 'lessons: incidents'
+  } > .aqk.yml
+  printf '# Свод\n' > AGENTS.md
+  mkdir -p .aqk/rules && printf '# правила\n' > .aqk/rules/general.md
+)
+FAKE_OUT=$( cd "$FAKEDIR" && node "$CLI" doctor --run --min 3 2>&1 ); FAKE_CODE=$?
+FAKE_PROVE=$( cd "$FAKEDIR" && node "$CLI" prove 2>&1 ); FAKE_PCODE=$?
+# Проверяем ИМЕННО ту ступень, что назначена: без этого `grep 'AQK-1|AQK-3'` совпадал всегда,
+# потому что doctor печатает все четыре строки в любом исходе. Пустая проверка хуже отсутствующей.
+if [ "$FAKE_CODE" -ne 0 ] && [ "$FAKE_PCODE" -ne 0 ] &&
+   printf '%s' "$FAKE_OUT" | grep -qE 'AQK-1\.?$|AQK-1[^0-9]' &&
+   printf '%s' "$FAKE_OUT" | grep -qiE '(НЕ пройден|not passed|not reached)'; then
+  ok "гейт «true» не берёт уровень выше первого"
+else
+  bad "подделка получила уровень" "порог: код $FAKE_CODE, доказательство: код $FAKE_PCODE, хвост: $(printf '%s' "$FAKE_OUT" | tail -2 | tr '\n' ' ')"
+fi
+rm -rf "$FAKEDIR"
+
+# --- 48в. отказ установки называет, что поставить ------------------------------
+# ЗАЧЕМ. Запись, у которой остался только рецепт под язык (`no-print-in-prod`, `swallowed-error`,
+# `dead-code`), на машине без нужного инструмента ставиться не может — и это законно. Но отказ
+# обязан быть действием, а не тупиком: «нет команды ни под python, ни общей» не говорит человеку
+# ничего. Правило «находка без действия закрывает окно, а не дефект» — то же самое, что мы
+# требуем от записей каталога, и к собственной программе оно относится так же.
+# Найдено первым прогоном в чужом репозитории (httpx), 2026-09-07.
+NODIR="$(mktemp -d)"; NOBIN="$(mktemp -d)"
+ln -sf "$(command -v node)" "$NOBIN/node"
+( cd "$NODIR" && git init -q . && mkdir -p src && printf 'x = 1\n' > src/a.py && PATH="$NOBIN" node "$CLI" init >/dev/null 2>&1 )
+NO_OUT=$( cd "$NODIR" && PATH="$NOBIN" node "$CLI" add no-print-in-prod 2>&1 ); NO_CODE=$?
+# Имя инструмента в отказе БЫЛО и до этой проверки — не хватало действия. Требуем оба:
+# «ruff не установлен» — это диагноз, «поставь ruff» — это то, ради чего человек читает.
+if [ "$NO_CODE" -ne 0 ] &&
+   printf '%s' "$NO_OUT" | grep -q 'ruff' &&
+   printf '%s' "$NO_OUT" | grep -qiE '(почини|поставь|install)'; then
+  ok "отказ установки называет инструмент И что с ним делать"
+else
+  bad "отказ установки — тупик" "код $NO_CODE, вывод: $(printf '%s' "$NO_OUT" | tr '\n' ' ' | tail -c 200)"
+fi
+rm -rf "$NODIR" "$NOBIN"
+
+# --- 48б. строгий режим приёмки: «не проверено» становится ошибкой -------------
+# ЗАЧЕМ. «Записи не проверить, нет инструмента» — законное состояние на чужой машине и
+# недопустимое на нашей: там инструменты ставит отдельный шаг, и жёлтая тильда вместо красного
+# означает, что шаг не сработал. Ровно так и было: `pipx install vulture` стоял в конвейере с
+# самого его появления, ставил vulture в каталог вне PATH, и запись dead-code не проверялась
+# конвейером ни разу. Проверяем сам переключатель: на записи с заведомо отсутствующим
+# инструментом обычный прогон зелёный, строгий — красный.
+STPKG="$(mktemp -d)"
+cp -r "$ROOT/tool" "$ROOT/kit" "$ROOT/package.json" "$STPKG/" 2>/dev/null
+# Ломаем рецепт одной записи: программы с таким именем на машине нет ни у кого.
+sed -i.bak 's|^  python: vulture .*|  python: aqk-nesuschestvuyuschiy-instrument {dir}|' \
+  "$STPKG/kit/gates/dead-code/gate.yml" 2>/dev/null
+# Переключатель задаётся явно в ОБЕ стороны. Без этого проверка наследовала AQK_GATES_STRICT
+# из окружения — и в конвейере, где он поднят, «обычный» прогон был бы строгим, а проверка
+# переключателя проверяла бы одно и то же дважды.
+ST_SOFT_OUT=$(AQK_GATES_STRICT=0 bash "$STPKG/tool/selfcheck/gates.sh" 2>&1); ST_SOFT=$?
+ST_HARD_OUT=$(AQK_GATES_STRICT=1 bash "$STPKG/tool/selfcheck/gates.sh" 2>&1); ST_HARD=$?
+if [ "$ST_SOFT" -eq 0 ] && [ "$ST_HARD" -ne 0 ] &&
+   printf '%s' "$ST_HARD_OUT" | grep -q 'строгий режим'; then
+  ok "строгий режим делает «не проверено» ошибкой, обычный — нет"
+else
+  bad "строгий режим приёмки не работает" "обычный: $ST_SOFT, строгий: $ST_HARD"
+fi
+rm -rf "$STPKG"
+
 # --- 49. выведенную запись не ставят, а называют преемника --------------------
 # ЗАЧЕМ. Зрелость записи считается по доказательству, и объявить её нельзя — кроме одного
 # состояния: `deprecated`. Оно объявляется, и весь его смысл в отказе: запись, которую всё ещё
@@ -933,11 +1019,11 @@ rm -rf "$DEPKG" "$DEPRJ"
 SCDIR="$(mktemp -d)"
 (
   cd "$SCDIR" && git init -q . && git config user.email t@t && git config user.name t
-  mkdir -p src && printf 'def old():\n    print("старый долг")\n' > src/old.py
+  mkdir -p src && printf 'old = 1  # noqa\n' > src/old.py
   node "$CLI" init >/dev/null 2>&1
-  node "$CLI" add no-print-in-prod >/dev/null 2>&1
+  node "$CLI" add gate-not-weakened >/dev/null 2>&1
   git add -A && git commit -qm "база" >/dev/null 2>&1
-  printf 'def fresh():\n    print("новый долг")\n' > src/fresh.py
+  printf 'fresh = 1  # noqa\n' > src/fresh.py
 )
 SC_WIDE=$( cd "$SCDIR" && node "$CLI" doctor --run 2>&1 )
 SC_NARROW=$( cd "$SCDIR" && node "$CLI" doctor --run --since HEAD 2>&1 )
@@ -957,6 +1043,400 @@ else
 fi
 rm -rf "$SCDIR"
 
+# --- 52. совет по починке не теряется в обрезке --------------------------------
+# ЗАЧЕМ. Все записи каталога печатают «почини: …» последней строкой, а прогон показывал три
+# первые и обрезал остальное — то есть ровно ту строку, ради которой человек смотрит на красное,
+# он не видел никогда. Находка без действия закрывает окно, а не дефект.
+ADIR="$(mktemp -d)"
+(
+  cd "$ADIR" && git init -q . && mkdir -p src
+  for n in a b c d e; do printf '%s = 1  # noqa\n' "$n" > "src/$n.py"; done
+  node "$CLI" init >/dev/null 2>&1
+  node "$CLI" add gate-not-weakened >/dev/null 2>&1
+)
+A_OUT=$( cd "$ADIR" && node "$CLI" doctor --run 2>&1 )
+if printf '%s' "$A_OUT" | grep -qiE '(почини|fix)[[:space:]]*:' &&
+   printf '%s' "$A_OUT" | grep -qE 'py:[0-9]+'; then
+  ok "совет по починке виден при обрезанных находках"
+else
+  bad "совет по починке потерялся" "находок в выводе: $(printf '%s' "$A_OUT" | grep -c 'py:')"
+fi
+rm -rf "$ADIR"
+
+# --- 53. у долга есть цель и срок, и оба с последствием ------------------------
+# ЗАЧЕМ. Реестр, который может только сокращаться, всё равно не знает, когда кончится, — и
+# потому не кончается. Цель и срок без машинного последствия были бы украшением, поэтому
+# проверяем ровно последствия: срок вышел — красное; цель достигнута — сказано вслух.
+RDIR="$(mktemp -d)"
+(
+  cd "$RDIR" && git init -q . && mkdir -p src && printf 'a = 1  # noqa\n' > src/a.py
+  node "$CLI" init >/dev/null 2>&1
+  node "$CLI" add gate-not-weakened >/dev/null 2>&1
+  node "$CLI" ratchet gate-not-weakened >/dev/null 2>&1
+)
+R_REG="$RDIR/ratchets/gate-not-weakened.txt"
+if [ -f "$R_REG" ] && grep -q 'aqk-goal' "$R_REG"; then
+  # Долг снят, новых нарушений нет — зелено.
+  R_BASE=$( cd "$RDIR" && node "$CLI" doctor --run 2>&1 ); R_BASE_CODE=$?
+  # Срок в прошлом — обязано покраснеть без единого нового нарушения.
+  sed -i.bak 's/^# aqk-deadline:.*/# aqk-deadline: 2020-01-01/' "$R_REG"
+  R_LATE=$( cd "$RDIR" && node "$CLI" doctor --run 2>&1 )
+  if printf '%s' "$R_LATE" | grep -qi 'срок\|deadline'; then
+    ok "срок долга вышел — храповик краснеет без новых нарушений"
+  else
+    bad "просроченный долг прошёл молча" "код базового прогона $R_BASE_CODE"
+  fi
+  # Цель заведомо достигнута — храповик обязан сказать, что обёртку пора убрать.
+  sed -i.bak 's/^# aqk-deadline:.*/# aqk-deadline:/; s/^# aqk-goal:.*/# aqk-goal: 99/' "$R_REG"
+  R_DONE=$( cd "$RDIR" && node "$CLI" doctor --run 2>&1 )
+  if printf '%s' "$R_DONE" | grep -qi 'погашен\|paid off'; then
+    ok "цель достигнута — храповик говорит убрать обёртку"
+  else
+    bad "погашенный долг не назван" "$(printf '%s' "$R_DONE" | grep -i ratchet | head -1)"
+  fi
+else
+  bad "реестр долга не создан или без цели" "$R_REG"
+fi
+rm -rf "$RDIR"
+
+# --- 54. упавший гейт не стирает реестр долга ----------------------------------
+# ЗАЧЕМ. Провал без единой разобранной находки — это отказ инструмента, а не чистый прогон.
+# Храповик вычёркивал ВЕСЬ реестр как исправленный, возвращал ноль и — после появления цели —
+# предлагал снять защиту: «долг погашен, убери обёртку». Снятие защиты по итогам прогона,
+# которого не было. Найдено ревью 2026-09-06.
+WDIR="$(mktemp -d)"
+mkdir -p "$WDIR/ratchets"
+printf '# Реестр долга: проба\n# aqk-goal: 0\nsrc/a.py: печать\n' > "$WDIR/ratchets/t.txt"
+W_OUT=$( cd "$WDIR" && bash "$ROOT/kit/ratchet/ratchet.sh" ratchets/t.txt sh -c 'exit 3' 2>&1 ); W_CODE=$?
+W_LEFT=$(grep -c 'src/a.py' "$WDIR/ratchets/t.txt" || true)
+if [ "$W_CODE" -ne 0 ] && [ "$W_LEFT" -eq 1 ] &&
+   ! printf '%s' "$W_OUT" | grep -qi 'погашен'; then
+  ok "упавший гейт не стирает реестр и не предлагает снять защиту"
+else
+  bad "упавший гейт съел реестр" "код $W_CODE, строк долга осталось $W_LEFT"
+fi
+# Директива с опечаткой обязана быть слышной: молчаливо отключённая цель — та же тишина.
+printf '# Реестр\n# aqk-goal: скоро\nsrc/a.py: печать\n' > "$WDIR/ratchets/t.txt"
+W_BAD=$( cd "$WDIR" && bash "$ROOT/kit/ratchet/ratchet.sh" ratchets/t.txt sh -c 'echo "src/a.py: печать"' 2>&1 )
+if printf '%s' "$W_BAD" | grep -qi 'не число'; then
+  ok "опечатка в директиве храповика названа, а не проглочена"
+else
+  bad "нечисловая цель отключилась молча" "$(printf '%s' "$W_BAD" | head -1)"
+fi
+rm -rf "$WDIR"
+
+# --- 55. просроченный долг краснеет и при сужении по дифу ----------------------
+# ЗАЧЕМ. Сообщение храповика про срок называет путь к реестру, а реестра в дифе нет: фильтр по
+# путям отбрасывал единственную строку, находок не оставалось, и гейт печатался зелёным с
+# пометкой «находки вне дифа». То есть `--since` отменял правило SPEC.md §7.6 ровно в том
+# режиме, в котором его и запускают. Найдено ревью 2026-09-06.
+DDIR="$(mktemp -d)"
+(
+  cd "$DDIR" && git init -q . && git config user.email t@t && git config user.name t
+  mkdir -p src && printf 'a = 1  # noqa\n' > src/a.py
+  node "$CLI" init >/dev/null 2>&1
+  node "$CLI" add gate-not-weakened >/dev/null 2>&1
+  node "$CLI" ratchet gate-not-weakened >/dev/null 2>&1
+  sed -i.bak 's/^# aqk-deadline:.*/# aqk-deadline: 2020-01-01/' ratchets/gate-not-weakened.txt
+  git add -A >/dev/null 2>&1 && git commit -qm base >/dev/null 2>&1
+)
+D_WIDE=$( cd "$DDIR" && node "$CLI" doctor --run 2>&1 )
+D_NARROW=$( cd "$DDIR" && node "$CLI" doctor --run --since HEAD 2>&1 )
+if printf '%s' "$D_WIDE" | grep -q 'gate-not-weakened' &&
+   printf '%s' "$D_NARROW" | grep -qE 'gate-not-weakened.*(код|exit)' ; then
+  ok "просроченный долг краснеет и при --since"
+else
+  bad "--since отменил срок долга" "узкий прогон: $(printf '%s' "$D_NARROW" | grep no-print | head -1 | cut -c1-90)"
+fi
+rm -rf "$DDIR"
+
+# --- 56. совещательный гейт показан, но прогон не уронен -----------------------
+# ЗАЧЕМ. Правило вводят в проект, где старый код ему не соответствует. Без третьего пути выбор
+# из двух крайностей: включить и сломать сборку либо не включать вовсе. Проверяем обе стороны:
+# без списка — роняет; со списком — показано и НАЗВАНО, а прогон зелёный. Молчание о
+# совещательном гейте было бы выключенной проверкой, притворяющейся отсутствующей.
+VDIR="$(mktemp -d)"
+(
+  cd "$VDIR" && git init -q . && mkdir -p src && printf 'a = 1  # noqa\n' > src/a.py
+  node "$CLI" init >/dev/null 2>&1
+  node "$CLI" add gate-not-weakened >/dev/null 2>&1
+)
+( cd "$VDIR" && node "$CLI" doctor --run --min 1 >/dev/null 2>&1 ); V_HARD=$?
+printf '\nadvisory:\n  - gate-not-weakened\n' >> "$VDIR/.aqk.yml"
+V_OUT=$( cd "$VDIR" && node "$CLI" doctor --run --min 1 2>&1 ); V_SOFT=$?
+if [ "$V_HARD" -ne 0 ] && [ "$V_SOFT" -eq 0 ] &&
+   printf '%s' "$V_OUT" | grep -qE 'advisory|совещательн' &&
+   printf '%s' "$V_OUT" | grep -q 'src/a.py'; then
+  ok "совещательный гейт показывает находки, называется и не роняет прогон"
+else
+  bad "совещательный режим работает не так" "обычный код $V_HARD, совещательный $V_SOFT"
+fi
+# Опечатка в имени поля обязана быть названа: «advisery:» молча означало бы «совещательных нет»,
+# и правило, которое человек считал введённым, роняло бы сборку.
+sed -i.bak 's/^advisory:/advisery:/' "$VDIR/.aqk.yml"
+V_TYPO=$( cd "$VDIR" && node "$CLI" doctor 2>&1 )
+if printf '%s' "$V_TYPO" | grep -qi 'advisery'; then
+  ok "опечатка в имени поля манифеста названа"
+else
+  bad "опечатка в advisory проглочена" "$(printf '%s' "$V_TYPO" | tail -2 | head -1)"
+fi
+rm -rf "$VDIR"
+
+# --- 81. версия в README и llms.txt та же, что в package.json ---------------
+# Обе строки — инструкция по установке для постороннего: `rev:` для pre-commit и `@vX.Y.Z` для
+# GitHub Action. Устаревшая ставит человеку не тот комплект и молчит об этом: команда проходит,
+# ставится прошлогодняя версия. AGENTS.md требует, чтобы README и llms.txt не расходились, —
+# и без прибора требование не работало: на 2026-09-08 в README стояло v0.6.0, а в llms.txt
+# v0.4.2, отставание на два выпуска. Проверка сравнивает обе с package.json, а не друг с другом:
+# совпасть друг с другом они могут и будучи одинаково устаревшими.
+VERS_BAD=""
+# README.ru.md попал сюда 2026-09-08, при выпуске 0.8.0: в нём стояли v0.6.0 и v0.5.0 —
+# отставание на два и на три выпуска. Проверка его не смотрела, и русский читатель ставил
+# прошлогодний комплект молча. Ровно та же дыра, ради которой проверку и заводили, — просто
+# в файле, который забыли перечислить.
+for VF in README.md README.ru.md llms.txt; do
+  [ -f "$ROOT/$VF" ] || continue
+  # Берём только версии AQK — «v1.2.3» в примерах чужих действий (actions/checkout@v4) не наши.
+  for V in $(grep -oE '(rev:[[:space:]]*|Agent_Quality_Kit@)v[0-9]+\.[0-9]+\.[0-9]+' "$ROOT/$VF" \
+             | grep -oE 'v[0-9]+\.[0-9]+\.[0-9]+' | sort -u); do
+    [ "$V" = "v$PKGVER" ] || VERS_BAD="${VERS_BAD:+$VERS_BAD, }$VF: $V"
+  done
+done
+if [ -z "$VERS_BAD" ]; then
+  ok "версия в обоих README и llms.txt совпадает с package.json (v$PKGVER)"
+else
+  bad "версия в документах разошлась с package.json" "package.json: v$PKGVER; найдено — $VERS_BAD"
+fi
+
+# --- 82. report --since называет, чем доказан диф ---------------------------
+# Три состояния у файла, и разница между вторым и третьим — весь смысл раздела: «проверка
+# обошла и промолчала» не то же самое, что «никто не смотрел». Двух состояний хватило ровно до
+# первого прогона — `tool/commands/doctor.mjs` попал в «никем не проверен», хотя его обходят
+# пять проверок; они молчали, потому что нашли чисто.
+EVDIR="$(mktemp -d)"
+(
+  cd "$EVDIR" || exit 1
+  git init -q . && git config user.email a@b.c && git config user.name t
+  mkdir -p src gates/noisy
+  printf 'x = 1\n' > src/kept.py
+  # Гейт, который печатает путь: по нему файл становится «назван».
+  printf '#!/usr/bin/env sh\necho "src/kept.py:1: нашёл"\nexit 0\n' > gates/noisy/check.sh
+  printf 'aqk: "1"\nentry: [AGENTS.md]\ngates:\n  noisy: "sh gates/noisy/check.sh ."\n' > .aqk.yml
+  printf '# правила\n' > AGENTS.md
+  git add -A >/dev/null 2>&1 && git commit -qm base >/dev/null 2>&1
+  printf 'y = 2\n' > src/quiet.py
+  git add -A >/dev/null 2>&1 && git commit -qm second >/dev/null 2>&1
+) >/dev/null 2>&1
+EV_OUT=$( cd "$EVDIR" && AQK_LANG=ru node "$CLI" report --since HEAD~1 2>&1 )
+EV_FILE="$EVDIR/.aqk/report.md"
+if [ -f "$EV_FILE" ] && grep -q "src/quiet.py" "$EV_FILE" && grep -q "Чем доказан" "$EV_FILE"; then
+  ok "report --since называет, чем доказан диф"
+else
+  bad "report --since не отчитался о покрытии" "$(printf '%s' "$EV_OUT" | tail -2 | head -1)"
+fi
+# Ссылка, которой нет, обязана быть названа: «сравнили не с тем» не должно читаться как «чисто».
+EV_BAD=$( cd "$EVDIR" && AQK_LANG=ru node "$CLI" report --since no-such-ref 2>&1 )
+if printf '%s' "$EV_BAD" | grep -q "no-such-ref"; then
+  ok "report --since называет неразобранную ссылку"
+else
+  bad "report --since проглотил неверную ссылку" "$(printf '%s' "$EV_BAD" | tail -2 | head -1)"
+fi
+rm -rf "$EVDIR"
+
+# --- 84. learn читает только напечатанное человеком --------------------------
+# Поле promptSource отделяет реплику от результата инструмента. Без него первая версия отбора
+# выдавала вставленные пути и ссылки вместо правил — «agent quality kit» 44 раза.
+# Каталог логов кладём ВНУТРЬ проекта и передаём относительным путём. Абсолютный сюда не
+# годится: Git Bash на Windows отдаёт «/tmp/…», а Node в том же окружении читает это как
+# «C:\tmp\…» — переменная указывает в никуда, и проверка падает не по делу.
+LRNP="$(mktemp -d)"; LRN=".cfg"
+# Имя каталога логов спрашиваем у самой программы, а не считаем здесь. На Windows оболочка
+# отдаёт «/tmp/…», а Node видит «C:\Users\…» — две разные строки, и тест падал не по делу.
+# Правило перевода пути в имя сторожит модульная проверка logSlug, здесь проверяется конвейер.
+SLUG=$( cd "$LRNP" && node -e "const {pathToFileURL}=require('node:url');import(pathToFileURL(process.argv[1]).href).then(m=>console.log(m.logSlug(process.cwd())))" "$ROOT/tool/commands/learn.mjs" )
+mkdir -p "$LRNP/$LRN/projects/$SLUG"
+{
+  printf '{"type":"user","promptSource":"typed","timestamp":"2026-09-08T10:00:00Z","message":{"role":"user","content":"никогда не коммить прямо в основную ветку"}}\n'
+  printf '{"type":"user","promptSource":"typed","timestamp":"2026-09-08T10:01:00Z","message":{"role":"user","content":"ок го дальше"}}\n'
+  printf '{"type":"user","timestamp":"2026-09-08T10:02:00Z","message":{"role":"user","content":[{"type":"tool_result","content":"нельзя обязательно всегда"}]}}\n'
+} > "$LRNP/$LRN/projects/$SLUG/s1.jsonl"
+printf '# правила\n- Ничего особенного.\n' > "$LRNP/AGENTS.md"
+printf 'aqk: "1"\nentry: [AGENTS.md]\n' > "$LRNP/.aqk.yml"
+LRN_OUT=$( cd "$LRNP" && CLAUDE_CONFIG_DIR="$LRN" AQK_LANG=ru node "$CLI" learn 2>&1 )
+if printf '%s' "$LRN_OUT" | grep -q "основную ветку" &&
+   ! printf '%s' "$LRN_OUT" | grep -q "го дальше" &&
+   printf '%s' "$LRN_OUT" | grep -q "напечатано человеком: 2"; then
+  ok "learn берёт напечатанное человеком и не берёт вывод инструментов"
+else
+  bad "learn отобрал не то" "$(printf '%s' "$LRN_OUT" | tr '\n' ' ' | cut -c1-150)"
+fi
+# Правило, уже стоящее в точке входа, показывать незачем: команда не пересказывает свод.
+printf '# правила\n- Никогда не коммить прямо в основную ветку.\n' > "$LRNP/AGENTS.md"
+LRN_W=$( cd "$LRNP" && CLAUDE_CONFIG_DIR="$LRN" AQK_LANG=ru node "$CLI" learn 2>&1 )
+if printf '%s' "$LRN_W" | grep -q "уже стоит в точке входа"; then
+  ok "learn молчит о правиле, которое уже записано"
+else
+  bad "learn повторил записанное правило" "$(printf '%s' "$LRN_W" | tr '\n' ' ' | cut -c1-150)"
+fi
+# Читает переписку — значит на диск не пишет ничего. Проверяем буквально.
+if [ ! -d "$LRNP/.aqk" ] || [ -z "$(ls -A "$LRNP/.aqk" 2>/dev/null)" ]; then
+  ok "learn ничего не записал на диск"
+else
+  bad "learn создал файлы" "$(ls -A "$LRNP/.aqk" | tr '\n' ' ')"
+fi
+rm -rf "$LRNP"
+
+# --- 87. --baseline не совмещается с --run и --min ---------------------------
+# `--baseline` выходит с нулём всегда: это осмотр, а не прогон. Совмещённый с порогом он давал
+# конвейер, который НЕ МОЖЕТ покраснеть — порог назван, гейты не запущены, код нулевой. Найдено
+# ревью 2026-09-08. Отказ должен быть громким: молчаливое зелёное здесь дороже сломанной команды.
+BLP="$(mktemp -d)"
+( cd "$BLP" && git init -q . && printf 'aqk: "1"\nentry: [AGENTS.md]\n' > .aqk.yml && printf '# правила\n' > AGENTS.md ) >/dev/null 2>&1
+BL_OK=$( cd "$BLP" && AQK_LANG=ru node "$CLI" doctor --baseline 2>&1 ); BL_OK_C=$?
+BL_BAD=$( cd "$BLP" && AQK_LANG=ru node "$CLI" doctor --baseline --min 1 2>&1 ); BL_BAD_C=$?
+BL_RUN=$( cd "$BLP" && AQK_LANG=ru node "$CLI" doctor --baseline --run 2>&1 ); BL_RUN_C=$?
+if [ "$BL_OK_C" -eq 0 ] && [ "$BL_BAD_C" -ne 0 ] && [ "$BL_RUN_C" -ne 0 ] &&
+   printf '%s' "$BL_BAD" | grep -q "не может покраснеть"; then
+  ok "--baseline с --min и --run отказывает вслух, сам по себе работает"
+else
+  bad "--baseline не отказал на пороге" "коды: сам $BL_OK_C, с --min $BL_BAD_C, с --run $BL_RUN_C"
+fi
+rm -rf "$BLP"
+
+# --- 88. записи каталога не ломаются от цвета в выводе арбитра ---------------
+# Внутри GitHub Actions чужие инструменты КРАСЯТ вывод: там цвет поддержан, вне конвейера они
+# его выключают сами. Разбор по началу строки тогда промахивается — строка начинается с
+# escape-последовательности. Поймано конвейером 2026-09-08 на записи ci-not-hijackable: локально
+# зелёная, в конвейере «формат сменился». Тот же класс уже записан в scope.mjs.
+CLR_BAD=""
+for CG in kit/gates/*/check.sh; do
+  CS=$(basename "$(dirname "$CG")")
+  # Только записи с готовым арбитром: у них вывод чужой, и красит его не наш код.
+  grep -q "^requires:" "$(dirname "$CG")/gate.yml" 2>/dev/null || continue
+  command -v "$(sed -n 's/^requires:[[:space:]]*//p' "$(dirname "$CG")/gate.yml" | head -1 | awk '{print $1}')" >/dev/null 2>&1 || continue
+  PLAIN=$(bash "$CG" "$(dirname "$CG")/green" >/dev/null 2>&1; echo $?)
+  COLOR=$(GITHUB_ACTIONS=true CI=true bash "$CG" "$(dirname "$CG")/green" >/dev/null 2>&1; echo $?)
+  [ "$PLAIN" = "$COLOR" ] || CLR_BAD="${CLR_BAD:+$CLR_BAD, }$CS ($PLAIN vs $COLOR)"
+done
+if [ -z "$CLR_BAD" ]; then
+  ok "вердикт записи не зависит от того, красит ли арбитр вывод"
+else
+  bad "цвет в выводе арбитра меняет вердикт" "$CLR_BAD"
+fi
+
+# --- 89. шапка doctor читает манифест, а не литеральные пути ------------------
+# Отзыв второго пользователя 2026-09-08: у проекта `rules: .temper/rules`, правила на месте,
+# СТУПЕНЬ по манифесту берётся — а шапка рисовала кресты за `.aqk/rules` и `.aqk/docs` и
+# советовала сделать сделанное. Вывод расходился с собственным вердиктом программы, напечатанным
+# на десять строк ниже. Модульная проверка сторожит функцию; эта — то, что её кто-то зовёт.
+LYP="$(mktemp -d)"
+( cd "$LYP" && git init -q . && mkdir -p .temper/rules .temper/docs &&
+  printf 'правило\n' > .temper/rules/r.md && printf 'методичка\n' > .temper/docs/d.md &&
+  printf '# вход\n' > CLAUDE.md && printf '.x\n' > .gitignore &&
+  printf 'aqk: 1\nentry:\n  - CLAUDE.md\nrules: .temper/rules\ndocs: .temper/docs\ngates:\n  smoke: "true"\n' > .aqk.yml ) >/dev/null 2>&1
+LY=$( cd "$LYP" && AQK_LANG=ru node "$CLI" doctor 2>&1 )
+if printf '%s' "$LY" | grep -q "\.temper/rules" &&
+   printf '%s' "$LY" | grep -q "\.temper/docs" &&
+   printf '%s' "$LY" | grep -q "CLAUDE\.md" &&
+   ! printf '%s' "$LY" | grep -q "\.aqk/rules" &&
+   ! printf '%s' "$LY" | grep -q "неизвестное поле"; then
+  ok "шапка doctor берёт правила, методички и вход из манифеста"
+else
+  bad "doctor проверил не то, что объявлено в манифесте" "$(printf '%s' "$LY" | head -8)"
+fi
+rm -rf "$LYP"
+
+# --- 90. блок состояния: тишина не выдаётся за «чисто» -----------------------
+# Читатель этого блока — машина. Человек, увидев пустое место, переспросит; агент примет его
+# за утверждение и пойдёт писать код по несуществующему разрешению. Поэтому главное здесь одно:
+# без прогона блок обязан сказать «неизвестно» СЛОВОМ.
+CTXP="$(mktemp -d)"
+( cd "$CTXP" && git init -q . ) >/dev/null 2>&1
+CTX=$( cd "$CTXP" && AQK_LANG=ru node "$CLI" context 2>&1 ); CTX_C=$?
+if [ "$CTX_C" -eq 0 ] &&
+   printf '%s' "$CTX" | grep -q "НЕИЗВЕСТНО" &&
+   printf '%s' "$CTX" | grep -q "не вычислен" &&
+   ! printf '%s' "$CTX" | grep -q "AGENTS.md"; then
+  ok "context без прогона говорит «неизвестно» и не называет несуществующий свод"
+else
+  bad "context выдал незнание за чистоту" "код $CTX_C: $(printf '%s' "$CTX" | head -5)"
+fi
+
+# --- 91. хук ставится в общий файл и не затирает чужие настройки --------------
+mkdir -p "$CTXP/.claude"
+printf '{ "permissions": { "deny": ["Read(./.env)"] } }\n' > "$CTXP/.claude/settings.json"
+( cd "$CTXP" && AQK_LANG=ru node "$CLI" context --install ) >/dev/null 2>&1
+AGAIN=$( cd "$CTXP" && AQK_LANG=ru node "$CLI" context --install 2>&1 )
+HOOKS=$(node_in "$CTXP" -e 'const s=require("./.claude/settings.json");
+  console.log([s.hooks?.SessionStart?.length, s.permissions?.deny?.length,
+    /[/\\]program\.mjs/.test(JSON.stringify(s.hooks?.SessionStart||[]))].join(" "))' 2>&1)
+if [ "$HOOKS" = "1 1 false" ] && printf '%s' "$AGAIN" | grep -q "уже стоит"; then
+  ok "хук ставится один раз, переносимой командой, чужие настройки целы"
+else
+  bad "установка хука испортила настройки или задвоилась" "разбор: $HOOKS"
+fi
+rm -rf "$CTXP"
+
+# --- 92. полный блок: карта и свод дословно ----------------------------------
+# Решение владельца 2026-09-08, принятое ПОСЛЕ возражения про длину входа: агент читает файлы
+# плохо, и лишние токены — плата за то, чтобы он не ошибался. Раз плата внесена, товар обязан
+# быть доставлен: свод дословно, а не пересказ, и карта команд, а не половина карты.
+FULP="$(mktemp -d)"
+( cd "$FULP" && git init -q . &&
+  printf '# Свод\n\n- Правило-маячок-для-проверки. <!-- aqk: человек -->\n' > AGENTS.md &&
+  printf 'aqk: 1\nentry:\n  - AGENTS.md\n' > .aqk.yml ) >/dev/null 2>&1
+FUL=$( cd "$FULP" && AQK_LANG=ru node "$CLI" context --full 2>&1 )
+SHORT=$( cd "$FULP" && AQK_LANG=ru node "$CLI" context 2>&1 )
+if printf '%s' "$FUL" | grep -q "Правило-маячок-для-проверки" &&
+   printf '%s' "$FUL" | grep -q "doctor --run --since main" &&
+   printf '%s' "$FUL" | grep -q "ЧТО УМЕЕТ ЭТОТ ИНСТРУМЕНТ" &&
+   ! printf '%s' "$SHORT" | grep -q "Правило-маячок-для-проверки"; then
+  ok "context --full несёт карту и свод дословно, обычный — нет"
+else
+  bad "полный блок не донёс свод или карту" "$(printf '%s' "$FUL" | head -4)"
+fi
+
+# --- 93. хук с --full ставится именно с флагом -------------------------------
+( cd "$FULP" && AQK_LANG=ru node "$CLI" context --full --install ) >/dev/null 2>&1
+FLAG=$(node_in "$FULP" -e 'const s=require("./.claude/settings.json");
+  console.log(JSON.stringify(s.hooks?.SessionStart||[]).includes("--full"))' 2>&1)
+if [ "$FLAG" = "true" ]; then
+  ok "хук, поставленный с --full, зовёт полный блок, а не короткий"
+else
+  bad "хук потерял --full — вливался бы короткий блок" "разбор: $FLAG"
+fi
+rm -rf "$FULP"
+
+# --- 94. отсев сгенерированных файлов: края, а не середина -------------------
+# `drop_generated` заменил цикл `while read; do is_generated; done` — два процесса на файл.
+# Замер на шести чужих проектах дал ноль расхождений, но отсеяно там было 5 файлов из 1242:
+# такая сверка почти ничего не доказывает. Набор ниже нарочный, и он сразу нашёл ДВА
+# расхождения, которых на живых проектах не было, — пробел и двоеточие в имени файла.
+GENP="$(mktemp -d)"
+mkg() { printf '%b' "$2" > "$GENP/$1"; }
+mkg 'l1.js'        '// @generated\ncode\n'
+mkg 'l5.js'        'a\nb\nc\nd\n// @generated\n'
+mkg 'l6.js'        'a\nb\nc\nd\ne\n// @generated\n'
+mkg 'upper.js'     '// @GENERATED\n'
+mkg 'donotedit.js' '// Do Not Edit\n'
+mkg 'autogen.js'   '// auto-generated by tool\n'
+mkg 'genby.js'     '// Generated by protoc\n'
+mkg 'cyr.js'       '// сгенерирован автоматически\n'
+mkg 'cyrup.js'     '// СГЕНЕРИРОВАН\n'
+mkg 'with space.js' '// @generated\n'
+mkg 'with:colon.js' '// @generated\n'
+mkg 'clean.js'     'const x = 1;\n'
+: > "$GENP/empty.js"
+KEPT=$( . "$ROOT/kit/gates/_skip.sh"; find "$GENP" -type f | sort | drop_generated | sed "s#$GENP/##" | sort | tr '\n' ' ' )
+# Ожидания абсолютные, а не «как было раньше»: старая функция однажды уйдёт, а края останутся.
+# l6 остаётся намеренно: маркер на шестой строке — это уже не шапка файла.
+if [ "$KEPT" = "clean.js empty.js l6.js " ]; then
+  ok "сгенерированные отсеяны по всем маркерам; пробел, двоеточие и граница 5-й строки учтены"
+else
+  bad "отсев сгенерированных изменился" "осталось: $KEPT"
+fi
+rm -rf "$GENP"
+
 # --- итог -------------------------------------------------------------------
 printf '\n'
 if [ "$FAIL" -eq 0 ]; then