agent-quality-kit 0.6.0 → 0.8.0

package/README.md

@@ -63,6 +63,48 @@ tooling: [the dark factory and the minimum that isn't optional](kit/docs/ai/proj
    a promise without an exit code is just a sentence
 ```
 
+## Every command
+
+```
+aqk doctor              what this repository is at, and what is missing
+aqk doctor --run        run every gate the manifest declares
+aqk doctor --run --since main    only what the diff introduced
+aqk doctor --run --min 1         fail a pipeline below a level
+aqk doctor --baseline   the minimum a project needs, confirmed by a run
+
+aqk init                lay the kit into an existing repository
+aqk start               start a new project from the kit
+aqk add <name>          install one guard from the catalogue
+aqk new <name>          scaffold a guard of your own
+aqk find <text>         find a guard by intent
+aqk why <name>          what failure this guard was written for
+
+aqk prove               run every declared gate against its own samples:
+                        red on the red one, quiet on the green one
+aqk report              the report form, assembled by a run
+aqk report --since main  ...plus what proves this diff, file by file
+aqk badge               write the level badge into the README
+aqk badge --check       fail if the badge disagrees with a run
+
+aqk context             the repository state in one block, for an agent's context:
+                        level, what is red now, rules nobody enforces, ratchets
+aqk context --full      the same plus the command map and the rulebook verbatim (~7000
+                        tokens against ~375: the price of an agent that does not guess)
+aqk context --install   put a SessionStart hook into .claude/settings.json
+                        (add --full to install the full block)
+
+aqk learn               rule candidates from local transcripts:
+                        said out loud, never written down
+aqk note "..."          write a bruise into the journal
+aqk ratchet <name>      a debt registry for a declared gate: may only get shorter
+aqk blob                every guide as a single file
+```
+
+Exit codes: `0` pass, `1` below the level or a gate failed. Two exceptions, both deliberate:
+`learn` never fails a build — it reads transcripts and prints to the terminal only, writing
+nothing. And `--baseline` is an inspection, not a run: it always exits `0`, so combining it with
+`--run` or `--min` is refused outright rather than handing you a pipeline that cannot go red.
+
 ## What this looks like
 
 Someone else's project, three files, nothing configured:
@@ -123,6 +165,7 @@ The whole standard is one `.aqk.yml` file in the repository root:
 aqk: 1
 entry:  [AGENTS.md]        # what the agent reads first
 rules:  .aqk/rules         # where the standards live
+docs:   .aqk/docs          # where the guides live (optional; this is the default)
 gates:                     # what must pass — as commands, not as prose
   lint: "npm run lint"
   secrets-not-in-code: "bash gates/secrets-not-in-code/check.sh ."
@@ -196,7 +239,7 @@ Already using [pre-commit](https://pre-commit.com)? Three lines in the file you
 ```yaml
 repos:
   - repo: https://github.com/arsen-ask-lx/Agent_Quality_Kit
-    rev: v0.6.0
+    rev: v0.8.0
     hooks:
       - id: aqk            # runs what the repository declares; blocks below AQK-1
       # - id: aqk-doctor   # read-only: the level and what is missing, blocks nothing
@@ -217,7 +260,7 @@ layer AQK adds.
 [![on the GitHub Marketplace](https://img.shields.io/badge/GitHub%20Marketplace-Agent%20Quality%20Kit-2ea44f?logo=github)](https://github.com/marketplace/actions/agent-quality-kit-aqk)
 
 ```yaml
-- uses: arsen-ask-lx/Agent_Quality_Kit@v0.5.0
+- uses: arsen-ask-lx/Agent_Quality_Kit@v0.8.0
   with:
     min: 1   # the build fails below AQK-1, or if any declared gate failed
 ```
@@ -260,6 +303,22 @@ Every `doctor --run` rewrites `.aqk/last-run.md` — a short report of what actu
 long it took. The list of gates in the manifest says nothing about how many of them are alive
 right now; the report does. The file is ephemeral — keep it in your own `.gitignore`.
 
+### Introducing a rule into a live project
+
+Three ways, and each has a price. A big clean-up is put off forever because it is big. The
+ratchet turns existing violations into debt and blocks new ones — right once the rule is agreed.
+And while it is still being argued about, an advisory gate shows findings without failing the run:
+
+```yaml
+advisory:
+  - complexity-limit
+```
+
+Declared in the manifest, not passed as a flag. A flag that says "fail nothing" downgrades every
+check at once, is invisible in the diff, and is never named in the summary — that is
+`continue-on-error`, which this tool marks red elsewhere. The list is printed on **every** run:
+an advisory gate everyone forgot about is a switched-off check.
+
 ## When a bug slips past the guards
 
 ```bash

package/README.ru.md

@@ -64,6 +64,48 @@ flowchart LR
    обещание без кода возврата — просто предложение
 ```
 
+## Все команды
+
+```
+aqk doctor              где этот репозиторий и чего в нём не хватает
+aqk doctor --run        прогнать все гейты, объявленные в манифесте
+aqk doctor --run --since main    только то, что внёс диф
+aqk doctor --run --min 1         уронить конвейер ниже ступени
+aqk doctor --baseline   обязательный минимум проекта, подтверждённый прогоном
+
+aqk init                разложить комплект в существующий репозиторий
+aqk start               начать новый проект с комплектом
+aqk add <имя>           поставить один гейт из каталога
+aqk new <имя>           завести свой гейт по форме
+aqk find <текст>        найти гейт по намерению
+aqk why <имя>           какой отказ этот гейт поймал
+
+aqk prove               прогнать каждый объявленный гейт по его образцам:
+                        красный на красном, тишина на зелёном
+aqk report              форма отчёта, собранная прогоном
+aqk report --since main  ...и чем доказан этот диф, файл за файлом
+aqk badge               вписать значок уровня в README
+aqk badge --check       упасть, если значок расходится с прогоном
+
+aqk context             состояние репозитория одним блоком, для контекста агента:
+                        уровень, что красное сейчас, правила без арбитра, храповики
+aqk context --full      то же плюс карта команд и свод правил дословно (≈7000 токенов
+                        против ≈375 — плата за то, чтобы агент не догадывался)
+aqk context --install   поставить хук SessionStart в .claude/settings.json
+                        (с --full ставится полный блок)
+
+aqk learn               кандидаты в правила из локальной переписки:
+                        что сказано вслух и не записано
+aqk note "..."          записать шишку в журнал
+aqk ratchet <имя>       реестр долга для объявленного гейта: может только укорачиваться
+aqk blob                все методички одним файлом
+```
+
+Коды возврата: `0` — прошло, `1` — ниже ступени или упал гейт. Два исключения, оба намеренные:
+`learn` не роняет сборку никогда — он читает переписку и печатает только в терминал, не записывая
+ничего. А `--baseline` — осмотр, а не прогон: он выходит с нулём всегда, поэтому вместе с `--run`
+или `--min` он теперь отказывает вслух, а не выдаёт конвейер, который не может покраснеть.
+
 ## Что это выглядит так
 
 Чужой проект, три файла, ничего не настроено:
@@ -124,6 +166,7 @@ Issue» — ничего не постится сама, только текст
 aqk: 1
 entry:  [AGENTS.md]        # что агент читает первым
 rules:  .aqk/rules         # где стандарты
+docs:   .aqk/docs          # где методички (необязательно, это и есть умолчание)
 gates:                     # что обязано пройти — командами, не словами
   lint: "npm run lint"
   secrets-not-in-code: "bash gates/secrets-not-in-code/check.sh ."
@@ -198,7 +241,7 @@ aqk badge --check  # в конвейере: код 1 в тот день, ког
 ```yaml
 repos:
   - repo: https://github.com/arsen-ask-lx/Agent_Quality_Kit
-    rev: v0.6.0
+    rev: v0.8.0
     hooks:
       - id: aqk            # запускает объявленное; роняет коммит ниже AQK-1
       # - id: aqk-doctor   # только осмотр: уровень и чего не хватает, ничего не роняет
@@ -217,7 +260,7 @@ repos:
 [![в GitHub Marketplace](https://img.shields.io/badge/GitHub%20Marketplace-Agent%20Quality%20Kit-2ea44f?logo=github)](https://github.com/marketplace/actions/agent-quality-kit-aqk)
 
 ```yaml
-- uses: arsen-ask-lx/Agent_Quality_Kit@v0.5.0
+- uses: arsen-ask-lx/Agent_Quality_Kit@v0.8.0
   with:
     min: 1   # сборка падает ниже AQK-1 или если упал любой объявленный гейт
 ```
@@ -304,6 +347,22 @@ Ruff, ESLint и gitleaks и так находят плохой код — AQK з
 [`agents-lint`](https://github.com/giacomo/agents-lint) делает это лучше, другую — потому что
 91 находка из 120 оказалась законным приёмом.
 
+### Как ввести правило в живой проект
+
+Три способа, и у каждого своя цена. Большая чистка откладывается навсегда, потому что она
+большая. Храповик превращает старые нарушения в долг и блокирует новые — верно, когда правило
+уже принято. А пока о правиле спорят, совещательный гейт показывает находки, не роняя прогон:
+
+```yaml
+advisory:
+  - complexity-limit
+```
+
+Объявлением в манифесте, а не флагом. Флаг «не роняй ничего» понижает все проверки разом, не
+виден в дифе и не назван в итоге — это тот самый `continue-on-error`, который мы сами красим.
+Список печатается **каждый** прогон: совещательный гейт, о котором забыли, — это выключенная
+проверка.
+
 ## Методички одним файлом
 
 ```bash

package/kit/docs/ai/agent-harness-playbook.md

@@ -193,7 +193,7 @@
 |---|---|---|---|
 | `block-dangerous-commands.sh` | PreToolUse (Bash **и** PowerShell) | exit 2 + причина в stderr на необратимое: force-push, reset --hard, `DROP DATABASE`, `TRUNCATE`, `docker volume rm`, `rm -rf /` | fail-safe: не распарсил JSON → грепай сырой ввод. Штатный сброс дев-БД (`compose down -v`) — НЕ блокировать |
 | `auto-format.sh` | PostToolUse (Write\|Edit) | `ruff format` + `ruff check --fix` на изменённый `.py` | агент физически не оставляет неотформатированный код, контекст не тратится |
-| `stop-gate.sh` | Stop | красный `ruff` по прод-путям → exit 2 + хвост ошибок → агент чинит, а не «сдаёт» | обязателен гард `stop_hook_active` (иначе вечный цикл); проверять только СВОЙ домен, не параллельную работу человека |
+| `stop-gate.sh` | Stop | красный `ruff` по прод-путям → exit 2 + хвост ошибок → агент чинит, а не «сдаёт» | обязателен гард `stop_hook_active`; проверять только СВОЙ домен, не параллельную работу человека. Поле настоящее — Stop и SubagentStop получают его на вход; но вечного цикла не будет и без гарда: «Claude Code overrides the hook and ends the turn after 8 consecutive blocks» (code.claude.com/docs/en/hooks, раздел Stop input, сверено 2026-09-07). Цена ошибки — восемь ходов, а не вечность |
 
 - [ ] ⚠️ **Грабля №1 (Windows): `jq` нет в Git Bash.** Хук с `command -v jq || exit 0` молча
       превращается в no-op — защита «есть», но не работает. Парсить JSON через

package/kit/docs/ready-made-rules.md

@@ -174,10 +174,12 @@ ruff check --select TRY400 --statistics .     # сколько находок У
 К осени 2026 появился отдельный класс инструментов — линтеры не кода, а того, что читает агент:
 `AGENTS.md`, `CLAUDE.md`, файлы навыков, конфиги хуков и MCP. Писать своё здесь незачем.
 
-| Инструмент | Что проверяет | Состояние на 2026-09-06 |
+| Инструмент | Что проверяет | Состояние — дата замера в самой ячейке |
 |---|---|---|
-| [`agnix`](https://github.com/agent-sh/agnix) | 455 правил: структура `CLAUDE.md`/`AGENTS.md`/`SKILL.md`, синтаксис конфигов MCP и хуков, соглашения об именах, **мёртвые ссылки на файлы**. Есть автопочинка и LSP | 404 ⭐, Rust, активен. `npm i -g agnix`, `brew`, `pip`, `cargo` |
-| [`agents-lint`](https://github.com/giacomo/agents-lint) | мёртвые npm-скрипты, упомянутые в `AGENTS.md`, устаревшие рамки, деревья каталогов в контексте | 13 ⭐, TypeScript, последний коммит март 2026 |
+| [`agnix`](https://github.com/agent-sh/agnix) | 455 правил: структура `CLAUDE.md`/`AGENTS.md`/`SKILL.md`, синтаксис конфигов MCP и хуков, соглашения об именах, **мёртвые ссылки на файлы**. Есть автопочинка и LSP | 404 ⭐, Rust, активен на 2026-09-06. `npm i -g agnix`, `brew`, `pip`, `cargo` |
+| [`agents-lint`](https://github.com/giacomo/agents-lint) | мёртвые npm-скрипты, упомянутые в `AGENTS.md`, устаревшие рамки, деревья каталогов в контексте | 13 ⭐, TypeScript, последний коммит март 2026 — снято 2026-09-06 |
+| [`claudelint`](https://github.com/pdugan20/claudelint) | 116 правил: схема `.claude/settings.json`, синтаксис правил доступа, имена переменных окружения, ссылки на несуществующие файлы, разбор навыков, плагинов, MCP и LSP. Ловит `"allow": ["*"]` | TypeScript, MIT, коммит 2026-09-08. `npx claude-code-lint`. **Код возврата 0 даже на находке**, если её строгость — `warn`: блокирует только `--strict`. Проверено прогоном 0.8.0 |
+| [`slopcheck`](https://github.com/mattschaller/slopcheck) — **не путать с `0xToxSec/slopcheck`, это разные проекты** | имена npm-пакетов из команд установки в `.md`, `.mdc`, `.yml`, `.yaml`, `.json`, `.cursorrules` сверяет с реестром: пакет, которого не существует, — приманка для захвата имени | MIT, ноль зависимостей, TypeScript, пуш 2026-09-06. `npx slopcheck .`, код возврата 1 на находке — проверено прогоном 0.2.0 от 2026-09-08. Без сети выходит с нулём: «не проверено» у него неотличимо от «чисто» |
 
 ```bash
 npm install -g agnix && agnix --strict .
@@ -187,7 +189,13 @@ npm install -g agnix && agnix --strict .
 формат, существование путей, наличие скриптов. Ни один не спрашивает, **подкреплено ли обещание
 командой с кодом возврата**. «Мы никогда не коммитим секреты» — грамматически безупречная
 строка, на которую ни один из них ничего не скажет. Разделение простое: обвес агента проверяет
-`agnix`, исполнимость обещаний — `promise-has-gate`.
+`agnix`, права и схему настроек — `claudelint`, исполнимость обещаний — `promise-has-gate`.
+
+**Одну дыру в обвесе пришлось закрыть самим.** Имя события хука: ошибка в нём не показывается,
+хук просто не вызывается. У `claudelint` правило `hooks-invalid-event` есть в исходниках, но
+живой прогон версии 0.8.0 на файле с `"PoToolUse"` даёт «No problems found». Замер по 48 чужим
+настройкам нашёл шесть таких хуков в четырёх репозиториях — среди них `typecheck && test` перед
+коммитом, не запускавшийся ни разу. Это запись `hook-actually-fires`.
 
 ## А если проект не на Python?
 
@@ -201,6 +209,23 @@ npm install -g agnix && agnix --strict .
 **Одна строка в существующей записи — самый дешёвый и самый ценный вклад.** Намерение уже
 доказано отказом, образцы уже лежат, проверять нечего кроме самой команды.
 
+## Приёмы агента, названные практиками: чем закрыт каждый
+
+Список взят из разбора 1154 обсуждений с r/programming, r/learnprogramming, r/ExperiencedDevs
+и Hacker News (Baltes, Cheong, Treude, «An Endless Stream of AI Slop», arxiv 2603.27249,
+январь–сентябрь 2025). Это не подборка мнений, а размеченный корпус.
+
+| Приём | Чем закрыт |
+|---|---|
+| «test subversion»: правка теста, чтобы прошёл сломанный код | [`checkwash`](https://github.com/taipei49314/checkwash) — запись `test-not-adjusted` делегирует ему целиком |
+| «deleting methods instead of fixing them» | он же, детектор `TEST_DISABLED` |
+| «casting to `any` to silence type errors» | `@typescript-eslint/no-explicit-any`. Своей записи нет намеренно: замер по `zod` — 769 вхождений на 501 файл, первый прогон даёт стену |
+| «using `setTimeout` as a band-aid fix» | ничем. Замера нет, риск ложных высок: `setTimeout` законен сплошь и рядом |
+| «hallucinating external services, then mocking» | ничем. Отличить выдуманную службу от настоящей статически нечем |
+| выдуманная зависимость (slopsquatting) | [`slopcheck`](https://github.com/mattschaller/slopcheck) — тот, что лежит в npm под этим именем; на нём стоит запись `no-phantom-package`. **Проектов с именем `slopcheck` два**: [`0xToxSec/slopcheck`](https://github.com/0xToxSec/slopcheck) тоже MIT, но последний пуш апрель 2026 и в npm его нет. Проверено 2026-09-08 |
+| подавление проверки без адреса | наш `gate-not-weakened` плюс `eslint-plugin-eslint-comments`, `flake8-noqa` |
+| шаг конвейера, который не может провалиться | наш `ci-actually-fails`; у `checkwash` есть смежный `CI_WORKFLOW_TOUCHED` |
+
 ## Если готового нет
 
 Тогда свой гейт — и в его `README.md` пишется, **что именно проверено**: какой инструмент

package/kit/gates/README.md

@@ -70,6 +70,26 @@
 Плюс шестое, без которого запись не принимается: **доказательство** — реальный отказ, который
 она поймала. «Это хорошая практика» не принимается.
 
+## Находка обязана кончаться действием
+
+Проверка, покрасневшая молча, ничем не лучше молчащей. Проверка, сказавшая «плохо» и не
+сказавшая «делай так», — немногим лучше: человек, открывший тридцать находок, хочет команду,
+а не оценку.
+
+Поэтому последняя строка вывода — совет, и он начинается с метки:
+
+```
+  почини: замени на вызов системы логов — тогда запись попадёт в общий журнал
+```
+
+Приёмка требует эту строку на красном образце, а `doctor --run` печатает её **всегда**: находки
+обрезаются до трёх, совет не обрезается никогда. До этой правки строка существовала для приёмки
+и не существовала для человека — обрезка съедала ровно её.
+
+Требование действует для записей с переносимым рецептом. Запись, целиком делегирующая готовому
+инструменту, печатает вывод этого инструмента, и требовать от чужого вывода нашу строку значит
+требовать невозможного.
+
 ## Зрелость записи не пишут руками
 
 Седьмого поля нет: зрелость **считается** из доказательства. Ссылается `proof` на журнал шишек —
@@ -90,6 +110,24 @@ lifecycle: deprecated
 superseded_by: no-print-in-prod
 ```
 
+## Программа, без которой запись не работает
+
+**`requires:`** называет её явно. Нужно там, где переносимый рецепт — обёртка вокруг готового
+инструмента: первое слово команды тогда `bash`, который есть всегда, и по нему не видно, чего
+не хватает. Без этого поля гейт ставился бы и вставал при первом же запуске с «not found» —
+отсутствие сигнала неотличимо от успеха.
+
+```yaml
+recipes:
+  any: bash {gate}/check.sh {dir}
+requires: checkwash
+```
+
+`add` отказывает с названной причиной и говорит, что поставить. Приёмка и мутационная проверка
+пропускают запись со словами «НЕ ПРОВЕРЕНА здесь — нужен «…»». Строгий режим
+(`AQK_GATES_STRICT=1`, поднят в нашем конвейере) делает такой пропуск ошибкой: на машине,
+которая инструменты сама и ставит, «нечем проверить» обязано быть красным.
+
 ## Запись без переносимого рецепта
 
 Иногда переносимой проверки быть не может: чтобы понять, вызывают ли функцию, нужен граф
@@ -193,6 +231,8 @@ samples_for: python
 | `has_deps: true` | есть файл зависимостей |
 | `has_tests: true` | есть каталог тестов или файлы вида `*_test.*` |
 | `has_env: true` | есть файл окружения |
+| `has_agent_entry: true` | агента здесь используют: есть `CLAUDE.md`, `AGENTS.md`, каталог `.claude`, `.cursor/rules` или инструкции copilot |
+| `has_agent_config: true` | есть настройки самого агента: `.claude/settings.json`, `.claude/settings.local.json`, `.claude/hooks.json`, `.claude/hooks/hooks.json`. Второй файл лежит в `.gitignore` — признак сработает у человека и не сработает в конвейере |
 | `has_ui: true` | есть стили или однофайловые компоненты (`.css`, `.scss`, `.vue`, `.svelte`, `.astro`) |
 
 Любое из `has_*` принимает и `false` — «показывать тем, у кого этого нет». Условие, которого

package/kit/gates/_skip.sh

@@ -72,8 +72,68 @@ include_code() {
 # Сгенерированный файл не правят руками — предъявлять его размер или сложность человеку
 # бессмысленно и вредно: он выключит проверку целиком.
 # Опознаём по общепринятой шапке в первых пяти строках.
+# Регистр кириллицы `grep -i` сворачивает НЕ ВЕЗДЕ: на linux сворачивает, в Git Bash под
+# Windows — нет. Шапка `// СГЕНЕРИРОВАН` там не находилась никогда, и узнали мы об этом только
+# 2026-09-08, когда нарочный набор впервые прогнали на windows-задании. Это не регрессия правки,
+# а старая дыра, которую нечем было увидеть: на живых шести проектах таких шапок не было.
+# Поэтому кириллица перечисляется явно, а не доверяется флагу: три написания, которые бывают
+# на деле, — строчное в комментарии, с заглавной в начале фразы и капсом в баннере.
+GENERATED_MARKERS='@generated|do not edit|autogenerated|auto-generated|generated by|сгенерирован|Сгенерирован|СГЕНЕРИРОВАН'
+
+# Один файл: сгенерирован ли он. Осталось для тех, кто спрашивает про ОДИН файл
+# (gate-not-weakened сверяет строку находки, а не список путей).
 is_generated() {
-  head -5 "$1" 2>/dev/null | grep -qiE '@generated|do not edit|autogenerated|auto-generated|generated by|сгенерирован'
+  head -5 "$1" 2>/dev/null | grep -qiE "$GENERATED_MARKERS"
+}
+
+# СПИСОК файлов на stdin (по пути в строке) → тот же список без сгенерированных.
+#
+# ЗАЧЕМ ОТДЕЛЬНО ОТ is_generated. Цикл `while read; do is_generated; done` запускает ДВА
+# процесса на каждый файл — head и grep. Замерено 2026-09-08 на 748 файлах проекта uv:
+# обход и отбор 12 мс, подсчёт строк одним wc 37 мс, а этот цикл — 3862 мс. Сто крат от
+# всего остального, и ни микросекунды из них не потрачено на сравнение строк: платили за
+# fork+exec. Медленным был не язык — медленным было количество запусков.
+#
+# ПОЧЕМУ ИМЕННО grep, А НЕ awk. Соблазн был собрать всё одним awk с `nextfile`. Отвергнуто:
+# `nextfile` — расширение, а `tolower` на кириллице врёт в mawk и busybox-awk, и «сгенерирован»
+# перестал бы находиться там, где сейчас находится. Здесь ТОТ ЖЕ grep с ТЕМИ ЖЕ флагами, что
+# и в is_generated, — значит совпадение считается ровно так же, как раньше, и меняется только
+# число запусков. Равенство вывода проверено на шести чужих проектах: 0 расхождений.
+#
+# `-m1` останавливает grep на первом совпадении в файле, `/dev/null` заставляет его печатать
+# имя файла даже когда xargs передал ровно один путь.
+drop_generated() {
+  LIST=$(mktemp) || { cat; return; }
+  GEN=$(mktemp) || { rm -f "$LIST"; cat; return; }
+  cat > "$LIST"
+  # Пути передаются через НОЛЬ-разделитель: xargs по умолчанию рвёт по пробелам, и файл
+  # «src/my component.tsx» уехал бы в grep двумя несуществующими путями. Поймано нарочным
+  # набором до выпуска: старый цикл `while read` пробелы держал, и потерять это было нельзя.
+  tr '\n' '\0' < "$LIST" \
+    | xargs -0 -r grep -niE -m1 -e "$GENERATED_MARKERS" /dev/null 2>/dev/null \
+    | awk -v list="$LIST" '
+        # Строка вывода grep — «путь:номер:текст», и разобрать её по первому двоеточию нельзя:
+        # в пути тоже бывает двоеточие, а в тексте находки — тем более. Поэтому путь не
+        # угадывается, а СВЕРЯЕТСЯ со списком, который мы сами и передали: идём по двоеточиям
+        # слева направо, пока префикс не совпадёт с известным путём. Двоеточие в имени файла
+        # редкость, но «редко» и «никогда» — разные вещи, а тихо оставленный сгенерированный
+        # файл даёт находки на чужом коде.
+        BEGIN { while ((getline l < list) > 0) known[l] = 1 }
+        {
+          rest = $0; prefix = ""
+          while ((i = index(rest, ":")) > 0) {
+            prefix = prefix substr(rest, 1, i - 1)
+            rest = substr(rest, i + 1)
+            if (prefix in known) {
+              if (match(rest, /^[0-9]+:/) && substr(rest, 1, RLENGTH - 1) + 0 <= 5) print prefix
+              break
+            }
+            prefix = prefix ":"
+          }
+        }
+      ' | sort -u > "$GEN"
+  if [ -s "$GEN" ]; then grep -vxF -f "$GEN" "$LIST"; else cat "$LIST"; fi
+  rm -f "$LIST" "$GEN"
 }
 
 # Для grep: --exclude-dir на каждое имя. Образцы гейтов сюда не входят — см. own_samples_filter:

package/kit/gates/ci-actually-fails/README.md

@@ -29,6 +29,18 @@
 для них — законная настройка, каковой она и является: незаконной её делает то, ЧТО под ней
 стоит, а это знает только проект.
 
+**Исход переспрашивают — маска законна.** `continue-on-error` иногда стоит не ради прощения
+провала, а чтобы дать выполниться шагам ПОСЛЕ проверки; вердикт выносится отдельным шагом
+`if: steps.<id>.outcome == 'failure'` → `exit 1`. Так устроен `pre-commit.yml` в `fastapi`:
+проверка идёт под маской, потом чинит файлы и пушит их в ветку, и только в конце роняет
+сборку. Такой шаг больше не находка. Условие узкое: в файле должна быть И ссылка на исход,
+И падение — переспросить исход и ничего с ним не сделать значит простить провал длиннее на
+три строки, и это по-прежнему красное (образец `red/.github/workflows/soft.yml`).
+
+Замер 2026-09-07 по пяти чужим репозиториям: молчал на всех пяти. На `fastapi` — по
+случайности, слово-примета не совпало с именем шага «Run prek - pre-commit»; назови они его
+«Run lint», гейт покрасил бы законный уклад. Дефект найден разбором молчания, а не находки.
+
 **Чего НЕ ловит.**
 
 - **Проверку, которую не по чему опознать.** Задача `mutation-diff` с именем «Mutation score on

package/kit/gates/ci-actually-fails/check.sh

@@ -33,6 +33,19 @@ fi
 
 BAD=""
 for F in $CI; do
+  # Шаги, чей исход ПЕРЕСПРАШИВАЮТ ниже: `continue-on-error` на них стоит не ради прощения
+  # провала, а чтобы дали выполниться шагам после — а вердикт выносится отдельным шагом
+  # `if: steps.<id>.outcome == 'failure'` → `exit 1`. Найдено замером по fastapi
+  # (`.github/workflows/pre-commit.yml`): проверка идёт под маской, потом чинит файлы и пушит
+  # их в ветку, и только в конце роняет сборку. Гейт молчал там по случайности — слово-примета
+  # не совпало; назови они шаг «lint», он покрасил бы законный уклад.
+  #
+  # Засчитывается только когда в файле есть И ссылка на исход, И падение: переспросить исход и
+  # ничего с ним не сделать — то же самое прощение, только длиннее.
+  REDEEMED=""
+  if tr -d '\r' < "$F" | grep -qE '^[[:space:]]*(-[[:space:]]+)?run[[:space:]]*:.*(exit[[:space:]]+1|^[[:space:]]*false[[:space:]]*$)'; then
+    REDEEMED=$(tr -d '\r' < "$F" | sed -n "s/.*steps\.\([A-Za-z0-9_-]*\)\.\(outcome\|conclusion\|result\).*/\1/p" | sort -u)
+  fi
   # Разбор ПО ШАГАМ, а не по строкам. Построчно проверка врала в обе стороны: законный
   # `continue-on-error` на шаге выгрузки отчёта красил соседний шаг с тестами, а слово «test»
   # внутри перечисления типов коммита («feat|fix|test|chore») делало проверкой строку, которая
@@ -40,7 +53,7 @@ for F in $CI; do
   #
   # Шаг начинается элементом списка («- ») или ключом верхнего уровня: так устроен и github,
   # и gitlab, где `allow_failure` живёт на уровне задачи.
-  RES=$(tr -d '\r' < "$F" | awk -v runners="$RUNNERS" -v words="$WORDS" -v keys="$KEYS" -v file="$F" '
+  RES=$(tr -d '\r' < "$F" | awk -v runners="$RUNNERS" -v words="$WORDS" -v keys="$KEYS" -v file="$F" -v redeemed="$REDEEMED" '
     function isComment(l) { return l ~ /^[[:space:]]*#/ }
     function looksLikeCheck(l,   j, nk) {
       if (isComment(l)) return 0
@@ -62,10 +75,17 @@ for F in $CI; do
       return !isComment(l) && l ~ /^[[:space:]]*(continue-on-error|allow_failure|ignore_failure)[[:space:]]*:[[:space:]]*(true|yes)/
     }
     function isBoundary(l) { return l ~ /^[[:space:]]*-[[:space:]]/ || l ~ /^[A-Za-z_.-]+[[:space:]]*:/ }
+    # Исход этого шага переспрашивают ниже — маска на нём законна.
+    function isRedeemed(id,   j, nr) {
+      if (id == "") return 0
+      nr = split(redeemed, R, "\n")
+      for (j = 1; j <= nr; j++) if (R[j] != "" && R[j] == id) return 1
+      return 0
+    }
     function flush(   ) {
-      if (blockStart && blockCheck && blockMask)
+      if (blockStart && blockCheck && blockMask && !isRedeemed(blockId))
         printf "%s:%d: проверка не может провалиться — шаг под %s\n", file, blockCheckLine, blockMaskText
-      blockStart = 0; blockCheck = 0; blockMask = 0
+      blockStart = 0; blockCheck = 0; blockMask = 0; blockId = ""
     }
     {
       # Гашение прямо в команде красится только для ЗАКРЫТОГО списка запускалок: «|| true» на
@@ -79,6 +99,9 @@ for F in $CI; do
       if (!blockStart) blockStart = NR
       if (!blockCheck && looksLikeCheck($0)) { blockCheck = 1; blockCheckLine = NR }
       if (isMask($0)) { blockMask = 1; blockMaskText = $0; sub(/^[[:space:]]+/, "", blockMaskText) }
+      if (!isComment($0) && $0 ~ /^[[:space:]]*(-[[:space:]]+)?id[[:space:]]*:/) {
+        blockId = $0; sub(/^[^:]*:[[:space:]]*/, "", blockId); gsub(/[[:space:]"'"'"']/, "", blockId)
+      }
     }
     END { flush() }' 2>/dev/null)
   [ -z "$RES" ] || BAD="$BAD$RES

package/kit/gates/ci-actually-fails/green/.github/workflows/ci.yml

@@ -12,3 +12,19 @@ jobs:
       - name: выгрузить отчёт
         run: bash scripts/upload-report.sh
         continue-on-error: true
+
+      # Законный уклад: шаг помечен continue-on-error не для того, чтобы простить провал, а
+      # чтобы дать выполниться шагам после него; вердикт выносится ниже, по его исходу.
+      # Найдено замером по fastapi (.github/workflows/pre-commit.yml): проверка прогоняется
+      # под continue-on-error, потом чинит файлы и пушит их в ветку, а в конце падает, если
+      # проверка была красной. Гейт, красящий такое, требует убрать то, без чего уклад не
+      # работает, — и его выключат целиком.
+      - name: линтер
+        id: lint
+        run: ruff check .
+        continue-on-error: true
+      - name: применить починки и запушить
+        run: bash scripts/push-fixes.sh
+      - name: провалить сборку, если линтер был красным
+        if: steps.lint.outcome == 'failure'
+        run: exit 1

package/kit/gates/ci-actually-fails/red/.github/workflows/soft.yml

@@ -0,0 +1,15 @@
+# Исход проверки переспрашивают — и ничего с ним не делают. Ровно то же прощение, что и
+# голый continue-on-error, только длиннее на три строки и убедительнее на вид.
+name: soft
+on: [push]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: линтер
+        id: lint
+        run: ruff check .
+        continue-on-error: true
+      - name: сказать вслух
+        if: steps.lint.outcome == 'failure'
+        run: echo "линтер был красным"

package/kit/gates/ci-not-hijackable/README.md

@@ -0,0 +1,56 @@
+# Конвейер не отдаёт чужому коду свои права и секреты
+
+**Намерение.** Конвейер выполняется с правами репозитория и с доступом к его секретам. Три
+способа отдать их постороннему живут не в коде, а в двадцати строках yaml:
+
+- **подвижная метка вместо SHA.** `uses: some/action@v1` — это указатель, который владелец
+  действия может перевести на другой код в любой момент, и он же перевёдется у всех, кто на
+  метку сослался;
+- **`pull_request_target` вместе с выкачиванием ветки автора PR.** Триггер даёт секреты
+  основного репозитория, а код берётся у постороннего;
+- **`permissions: write-all`** на весь рабочий поток вместо нужного права нужному заданию.
+
+Ни одну из трёх обычная проверка кода не увидит: это не код, это настройка.
+
+**Какой отказ это поймало.** Собственный. На момент заведения записи у комплекта было **13
+находок высокой строгости и 5 средней**, среди них десять действий, закреплённых меткой вместо
+SHA, `id-token: write` на уровне всего потока и пять вызовов `checkout`, оставляющих учётные
+данные в `.git/config`.
+
+**Почему порог именно такой.** Замер 2026-09-08 по шести настоящим репозиториям:
+
+| проект | High | Medium |
+|---|---|---|
+| `express` | 0 | 0 |
+| `flask` | 0 | 0 |
+| `uv` | 0 | 0 |
+| `httpx` | 4 | 4 |
+| `gin` | 18 | 0 |
+| `ripgrep` | 19 | 8 |
+
+Половина держит ноль. Порог взят с тех, кто его держит, а не выдуман: он достижим, и это
+доказано чужой практикой, а не нашим мнением.
+
+**Готовый аналог есть, и мы его зовём.** [`zizmor`](https://github.com/zizmorcore/zizmor) (MIT,
+6459 звёзд, статический разбор GitHub Actions). Его же гоняет `flask` отдельным заданием
+конвейера. Своего разбора yaml мы не писали. Обёртка отвечает за порог (`--min-severity medium`)
+и за то, чтобы «не проверено» не выдавалось за «чисто»: `--no-exit-codes` разводит «нашлись
+находки» и «инструмент не отработал», а отсутствие итоговой строки в выводе даёт код 2.
+
+**Образцы.** `red/` — рабочий поток с `pull_request_target`, выкачиванием ветки автора PR,
+`permissions: write-all` и незакреплённым действием. `green/` — тот же поток на `pull_request`,
+с правами только на чтение, действием по SHA и `persist-credentials: false`.
+
+**Чего НЕ ловит.**
+
+- **Только GitHub Actions.** GitLab CI, Jenkins, Buildkite не проверяются: zizmor их не читает.
+- **Не выполняет конвейер.** Разбор статический: он видит опасный уклад, но не видит, что делает
+  скрипт внутри `run:`. Скачивание и выполнение чужого кода строкой `curl … | sh` внутри шага —
+  предмет другой проверки, и её у нас нет.
+- **Не сторожит SHA после закрепления.** Закреплённое действие может оказаться заброшенным или
+  уязвимым; «закреплено» и «безопасно» — разные утверждения. Обновление закреплённых SHA — работа
+  для dependabot, а не для этой записи.
+- **Точечное гашение с причиной остаётся возможным.** `# zizmor: ignore[правило] причина` снимает
+  находку, и это осознанный уклад: наш собственный `gate-not-weakened` требует, чтобы подавление
+  было точечным и с названной причиной, а не порогом на весь файл. Мы сами пользуемся этим дважды
+  и обе причины написали вслух.