@rt-tools/agent-kit 0.9.1 → 0.11.0

package/assets/defaults/project.sh

@@ -50,6 +50,27 @@ RT_HOOKS_TESTS="${RT_HOOKS_TESTS:-.claude/hooks/tests/run.sh}"
 # её делают, а всплывает на чужой работе — раскладка отказывает по правленому файлу целиком и не
 # кладёт ни одного другого. Признак — сама настройка раскладки: дерево без неё пакета не ставит,
 # и звать в нём нечего.
+# Тронула ли ветка только тексты. Нулевой код — только тексты, иначе — код.
+#
+# Признак нужен тому дереву, которое дописало в набор гейта тяжёлый шаг: стенд, снимки витрин,
+# сборку образов. Без него такой шаг идёт подряд, чем бы ветка ни была, и пуш коммита, менявшего
+# одну строку в таблице markdown, занимает минуты — за которые владелец успевает прочитать его
+# как зависший и отбить. Правило поставки требует того же от конвейера: ветка, не тронувшая ни
+# строки кода, не поднимает стенда, не снимает кадров и не собирает образов.
+#
+# Текстовой считается ветка, у которой каждый задетый файл — либо `.md`, либо лежит под каталогом
+# текстов. Всё остальное, включая обвязку и настройки, считается кодом: признак обязан ошибаться
+# в сторону лишнего прогона, а не пропущенного. Пустая база означает, что сравнивать не с чем, —
+# тогда признак молчит и гоняется всё.
+rt_push_docs_only_default() {
+    [ -z "$1" ] && return 1
+    changed="$(git diff --name-only "$1"...HEAD 2>/dev/null)"
+    [ -z "$changed" ] && return 1
+    printf '%s\n' "$changed" | grep -qvE "(^${RT_DOCS_DIR:-docs}/|\.md\$)" && return 1
+
+    return 0
+}
+
 rt_push_checks_default() {
     runner="$(rt_runner)"
     root="${CLAUDE_PROJECT_DIR:-.}"
@@ -66,7 +87,8 @@ rt_push_checks_default() {
     [ -x "$root/$RT_HOOKS_TESTS" ] && printf '%s\n' "bash $RT_HOOKS_TESTS"
 
     for check in check-doc-paths check-specs check-file-size check-dupes check-styles \
-        check-lib-layers check-reuse check-schema-drift check-push-gate; do
+        check-lib-layers check-reuse check-schema-drift check-states check-state-next \
+        check-turn-map check-push-gate; do
         [ -f "$root/$RT_CHECKS_DIR/$check.mjs" ] && printf '%s\n' "node $RT_CHECKS_DIR/$check.mjs"
     done
 
@@ -101,6 +123,9 @@ rt_lint_for_default() {
 }
 
 # Каталог папок задач. Пусто — ведения работы папкой в дереве нет, и гард замысла молчит.
+# Каталог текстов проекта: по нему признак состава правки отличает текстовую ветку от кодовой.
+RT_DOCS_DIR="${RT_DOCS_DIR:-docs}"
+
 RT_TASKS_DIR="${RT_TASKS_DIR:-docs/tasks}"
 
 # Каталог записей о законченных работах. Туда переносят то, что объясняет решения закрытой
@@ -111,9 +136,27 @@ RT_ARCHIVE_DIR="${RT_ARCHIVE_DIR:-docs/archive}"
 # Размер окна захода в токенах и пороги стража. Пусто — стража нет: считать долю не от чего, а
 # выведенный из записи захода размер врал бы — модель записана там без пометки о расширенном
 # окне. Дерево задаёт его в настройке агента, переменной окружения того же имени.
+#
+# Теми же двумя числами задаётся порог, на котором инструмент сжимает контекст сам, — а значит и
+# порог, на котором пишется передача захода. В настройке агента им отвечает пара: размер окна
+# автосжатия и доля в процентах, при которой оно приходит. Разъехавшись, они дают заход, который
+# либо сжимается до того, как передача написана, либо доживает до предела окна. Сведены они или
+# нет — говорит разбор состояния раскладки; здесь у пакета своих значений нет, потому что окно
+# принадлежит дереву, а не ему.
+#
+# Сведёнными считаются не совпавшие числа, а разведённые. Порог сжатия обязан стоять НИЖЕ порога
+# остановки: первым срабатывает то, что заход продолжает, а не то, что его останавливает.
+# Совпавшая пара — гонка, и выигрывает её страж: он стоит на вызове инструмента, а сжатие
+# приходит между ходами. Ровно так заход и вставал на пороге вместо того, чтобы продолжиться
+# сжатым, — при том что сверка обе стороны считала настроенными.
+#
+# Насколько ниже — своё число дерева: сжатие идёт не мгновенно, и разница в один процент
+# требование «ниже» удовлетворяет, а работу не спасает. Запас объявляется, а не выводится
+# разницей.
 RT_WINDOW_TOKENS="${RT_WINDOW_TOKENS:-}"
 RT_WINDOW_WARN_PCT="${RT_WINDOW_WARN_PCT:-40}"
 RT_WINDOW_STOP_PCT="${RT_WINDOW_STOP_PCT:-50}"
+RT_WINDOW_MARGIN_PCT="${RT_WINDOW_MARGIN_PCT:-5}"
 
 # Куда кладётся передача захода. Вне дерева: состояние работы живёт в ходе работы и коммитится,
 # а передача его пересказывает для вставки в новый заход и в историю не едет.
@@ -144,6 +187,11 @@ RT_SPECS_DIR="${RT_SPECS_DIR:-docs/specs}"
 # папкой задачи и с архивом. Если общего предка нет, сравнивать не с чем — проверка молчит.
 RT_MAIN_BRANCH="${RT_MAIN_BRANCH:-main}"
 
+# Имя клиента хостинга в строке запуска. По нему гард перезапуска узнаёт вызов: у каждого вида
+# хостинга свой клиент, и угаданное имя не совпадает ни с чем. Умолчание записано под самый
+# распространённый вид; дерево с другим хостингом называет своё.
+RT_HOST_CLI="${RT_HOST_CLI:-gh}"
+
 # Тело PR по его номеру. Обход требования пишут в PR, а в команде слияния его нет — там только
 # номер. Пустой ответ значит «спросить не у кого»: тогда обход ищется только в тексте команды.
 rt_report_body_default() {
@@ -185,19 +233,52 @@ rt_is_app_code_default() {
 # Список намеренно широк, и цена этого названа: команда чтения, в которой стоит имя
 # интерпретатора, будет отбита наравне с командой правки. Узкий список стоил бы дороже —
 # пропущенная форма записи возвращает обход целиком, а найти её можно только промахом.
+#
+# Перенаправление в пустое устройство и в поток ошибок снимается до разбора: файла оно не
+# пишет, а выглядит как перенаправление в файл. Так глушат вывод команды чтения, и без этого
+# `grep -rn x libs/ 2>/dev/null` судится наравне с записью — правило требуется на чтение, а
+# отбитий, пришедшихся не на правку файла, набирается большинство. Настоящая запись рядом с
+# заглушённым потоком остаётся видной: снимается перенаправление, а не команда целиком.
 rt_shell_writes_default() {
-    printf '%s' "$1" | grep -Eq \
-        '>>?[[:space:]]*[^|&>[:space:]]|\btee\b|\bsed\b[^|]*-i|\bperl\b[^|]*-i|\bpython3?\b|\bnode\b|\bruby\b|\bdd\b[^|]*of=|\bcp\b|\bmv\b|\brm\b|\btouch\b|\btruncate\b|\binstall\b|\bpatch\b|\bgit[[:space:]]+(checkout|restore|apply|stash)\b'
+    printf '%s' "$1" \
+        | sed -E 's#(&|[0-9]*)>>?[[:space:]]*/dev/(null|stderr)##g; s#[0-9]*>&[0-9-]##g' \
+        | grep -Eq \
+            '>>?[[:space:]]*[^|&>[:space:]]|\btee\b|\bsed\b[^|]*-i|\bperl\b[^|]*-i|\bpython3?\b|\bnode\b|\bruby\b|\bdd\b[^|]*of=|\bcp\b|\bmv\b|\brm\b|\btouch\b|\btruncate\b|\binstall\b|\bpatch\b|\bgit[[:space:]]+(checkout|restore|apply|stash)\b'
 }
 
 # Пути, названные командой оболочки. Печатает по одному в строке; судит их зовущий.
 #
 # Разбирать оболочку по-настоящему нечем — здесь и не разбирают: из текста вынимается всё, что
 # похоже на путь, и каждое отдаётся признаку. Лишнее он отсеет сам, а пропущенное вернуло бы
-# обход. Кавычки и heredoc снимаются заменой на пробел: путь внутри них тот же самый.
+# обход. Кавычки снимаются заменой на пробел: путь внутри них тот же самый.
+#
+# Тело документа на месте путей не даёт: там лежит текст, который команда кладёт в файл, а
+# чужой путь, названный в нём словами, требовал бы правила под запись, которой нет. Запись
+# замысла так отбивалась трижды подряд, пока пути под каталогом кода не были названы иначе.
+# Судится заголовок команды — именно в нём стоит тот путь, куда команда пишет.
+#
+# Исключение — интерпретатор: ему код приходит телом, и путь записи стоит именно там. Признак
+# ошибается в сторону лишнего чтения тела: имя интерпретатора, стоящее в команде где угодно,
+# возвращает разбор тела целиком.
 rt_shell_paths_default() {
-    printf '%s' "$1" \
-        | tr "\"'\`(),;=" '        ' \
+    text="$(printf '%s' "$1" | tr "\"'\`" '   ')"
+    if ! printf '%s' "$text" \
+        | grep -Eq '(^|[|;&(]|[[:space:]])(python3?|node|ruby|perl|php|deno|bun|bash|sh|zsh)([[:space:]]|$)'; then
+        text="$(printf '%s' "$text" | awk '
+            function trim(s) { sub(/^[ \t]+/, "", s); sub(/[ \t]+$/, "", s); return s }
+            tag != "" { if (trim($0) == tag) tag = ""; next }
+            {
+                print
+                if (match($0, /<<-?[ \t]*[A-Za-z_][A-Za-z0-9_]*/)) {
+                    t = substr($0, RSTART, RLENGTH)
+                    sub(/^<<-?[ \t]*/, "", t)
+                    tag = t
+                }
+            }')"
+    fi
+
+    printf '%s' "$text" \
+        | tr "(),;=" '     ' \
         | tr '[:space:]' '\n' \
         | grep -E '^[A-Za-z0-9_@.-]*/[A-Za-z0-9_@./-]+$' \
         | sed 's|^\./||' \
@@ -239,6 +320,12 @@ RT_BOARD_CHECK_CMD="${RT_BOARD_CHECK_CMD:-npm run check:board}"
 # Учётная запись, которую ставят исполнителем. Умолчание молчит: у каждого дерева она своя.
 RT_TASK_BOT="${RT_TASK_BOT:-}"
 
+# Команда перевода задачи между колонками очереди работ и имя первой колонки — той, из которой
+# задача уходит, когда её берут в работу. Имя без умолчания: колонки дерево называет своими
+# словами, а выдуманное не совпало бы ни с чем и молча выключило бы проверку колонки.
+RT_TASK_MOVE_CMD="${RT_TASK_MOVE_CMD:-npm run task:move}"
+RT_BOARD_BACKLOG="${RT_BOARD_BACKLOG:-}"
+
 # Почта, которой подписан коммит машинной учётной записи. Целым значением, а не образцом:
 # служебный адрес хостинга состоит из числа, логина и домена, а сопоставляется по числу — логин
 # рядом с ним не сверяет никто. Образец «число, плюс, логин» прошёл бы с чужим числом, то есть
@@ -268,6 +355,18 @@ rt_task_state_default() {
     printf '%s' "$state"
 }
 
+# Состояние заявки одним объектом: exists, draft, author, reviewers, reviewed. Спрашивает того
+# же помощника очереди работ, что и состояние задачи, — чтобы гард и сверка одинаково понимали
+# «у заявки есть разбор». Нет узла, нет помощника, нет сети — молчание, и ярус пропускается.
+rt_pull_state_default() {
+    command -v node >/dev/null 2>&1 || return 1
+    [ -f "${RT_BOARD_HELPER:-tools/board.mjs}" ] || return 1
+    state="$(node "${RT_BOARD_HELPER:-tools/board.mjs}" pr "$1" 2>/dev/null)" || return 1
+    [ -z "$state" ] && return 1
+    printf '%s' "$state" | jq -e 'has("offline") | not' >/dev/null 2>&1 || return 1
+    printf '%s' "$state"
+}
+
 # Что в этом дереве считается переизобретением. По строке «образец<таб>чем заменить».
 # Образцы узкие намеренно: гард сверяет только НОВЫЙ текст, и широкий образец отбивал бы
 # правку, которая ничего нового не заводит.
@@ -306,6 +405,8 @@ rt_qa_decorative_default() {
 # Умолчания под общими именами. Надстройка проекта объявит любое из них заново — и позовёт
 # отсюда то же имя с суффиксом `_default` для всего, чего не назвала сама.
 rt_push_checks() { rt_push_checks_default "$@"; }
+rt_push_docs_only() { rt_push_docs_only_default "$@"; }
+
 rt_docs_pair_for() { rt_docs_pair_for_default "$@"; }
 rt_lint_for() { rt_lint_for_default "$@"; }
 rt_task_branch_ok() { rt_task_branch_ok_default "$@"; }
@@ -315,5 +416,6 @@ rt_shell_writes() { rt_shell_writes_default "$@"; }
 rt_shell_paths() { rt_shell_paths_default "$@"; }
 rt_qa_decorative() { rt_qa_decorative_default "$@"; }
 rt_task_state() { rt_task_state_default "$@"; }
+rt_pull_state() { rt_pull_state_default "$@"; }
 rt_report_body() { rt_report_body_default "$@"; }
 rt_handoff_allowed_cmd() { rt_handoff_allowed_cmd_default "$@"; }

package/assets/defaults/turn-map.md

@@ -0,0 +1,46 @@
+# Карта хода
+
+Это не правило, а его короткая выжимка: правило объясняет, карта называет. Полный текст —
+скил `task-flow`; он же называет паттерн, который ведёт каждое состояние.
+
+Состояние работы объявлено строкой в разделе «Где стоим» хода работы. Пока обязательное
+действие не сделано, работа стоит в том же состоянии.
+
+## Состояния и обязательные действия
+
+| Состояние                 | Обязательное действие                                  | Ведёт паттерн      |
+| ------------------------- | ------------------------------------------------------ | ------------------ |
+| `просьба-не-разобрана`    | разведка по дереву, затем вопросы                      | `task-flow-start`  |
+| `разбор-закрыт`           | договорённость о продукте либо причина её отсутствия   | `task-flow-start`  |
+| `договорённость-записана` | завести задачу, ветку и папку                          | `task-flow-start`  |
+| `задача-взята`            | написать замысел                                       | `task-flow-start`  |
+| `замысел-записан`         | делать первый этап                                     | `task-flow-start`  |
+| `этап-идёт`               | доделать этап и отметить в ходе работы                 | `task-flow-resume` |
+| `этапы-кончились`         | прогнать набор и открыть PR черновиком                 | `task-flow-close`  |
+| `работа-отдана`           | взять следующую задачу                                 | `task-flow-resume` |
+| `разбор-кончился`         | влить договорённость, привести тексты, разобрать папку | `task-flow-close`  |
+| `папка-разобрана`         | снять черновик и попросить влить                       | `task-flow-close`  |
+| `влито`                   | разбор работы правилами и сверка очереди               | `task-flow-close`  |
+
+Ни у одного состояния обязательное действие не звучит как «ждать». Прогон, разбор владельцем и
+слияние идут без исполнителя и от взгляда быстрее не становятся.
+
+## Чем ход кончается
+
+Способов четыре, и других нет.
+
+| Выход                                              | Чем подтверждается                                              |
+| -------------------------------------------------- | --------------------------------------------------------------- |
+| вопрос владельцу, ответа на который в правилах нет | вопрос задан, и за тот же ход правила читались                  |
+| отказ гарда                                        | отказ назван владельцу, обход не искался                        |
+| заполненное окно там, где сжатия нет               | ход работы дописан, передача написана                           |
+| работа отдана, и следующая начата                  | PR открыт, и по следующей задаче сделано действие, а не сказано |
+
+Там, где дерево объявило порог сжатия ниже порога остановки, заполненное окно ход не кончает:
+контекст сжимается, передача приходит входом, и работа идёт дальше тем же заходом. Порог
+остановки там — страховка на случай, когда сжатие не пришло.
+
+Всё остальное — продолжение хода. Ходом не кончаются: коммит, записанный замысел, закрытый
+разбор просьбы, прочитанная договорённость, зелёная проверка, сводка о чужом шаге и объявление
+намерения. Переход из состояния в состояние — тем более: обязательное действие сделано, и
+следующее делается тем же ходом. Названо может быть только сделанное.

package/assets/docs/GLOSSARY.md

@@ -30,6 +30,7 @@
 | Раскладка                 | Перенос ресурса из пакета в дерево по его роду и настройке слоя                                                                                                  |
 | Разложенный файл          | Файл в дереве с шапкой пакета. Правится не на месте, а надстройкой: правка на месте теряется на следующей раскладке                                              |
 | Надстройка                | Файл дерева, который сливается с разложенным по заголовкам разделов                                                                                              |
+| Выключенная роль          | Роль, вызов которой дерево перестало считать обязательным: гард при ней молчит. Названа списком в настройке дерева, из раскладки не убирается и зовётся руками   |
 | Наблюдение                | Строка о событии слоя правил: правило загружено, гейт отбил, гард отказал. Пишет гард, живёт в дереве, наружу уезжает счётчиками. Журналом не называется         |
 | Сводка                    | Что наблюдения говорят за отрезок дней: чем пользовались, чем ни разу, обо что спотыкались                                                                       |
 | Предложение               | Готовая формулировка правки правил с адресом: пакет, компаньон или дерево. Приносит разбор закрытой задачи или слово посреди работы, отправляет человек командой |
@@ -37,21 +38,22 @@
 
 ## Работа
 
-| Термин          | Что это                                                                                                                                                                                                                                                                       |
-| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Задача          | Единица работы в очереди работ. Заводится до ветки, и номер её стоит в имени ветки и в заголовке PR                                                                                                                                                                           |
-| PR              | Заявка на слияние: то же название, что у задачи, переведённое в сделанное. Отчётом, пул-реквестом и мёрдж-реквестом не называется — ни в файлах, ни в разговоре                                                                                                               |
-| Очередь работ   | Доска, на которой видно состояние каждой задачи. Ветки она не видит                                                                                                                                                                                                           |
-| Папка задачи    | Одна работа от разбора до слияния: разбор просьбы, замысел, ход работы. Умирает со слиянием — разбирается, и объясняющее решение уезжает в архив                                                                                                                              |
-| Разбор          | Расспрос владельца до первой правки. Записывается его словами и задним числом не переписывается                                                                                                                                                                               |
-| Замысел         | Файл папки задачи: след задачи и этапы с признаками готовности. После написания не правится — с ним сверяют результат при приёмке                                                                                                                                             |
-| Ход работы      | Файл папки задачи: «Где стоим», решения по ходу с причинами, записи заходов. Единственное место, где отмечается сделанное. Журналом не называется                                                                                                                             |
-| След задачи     | Раздел замысла: какие спеки, законы, правила и части кода работа задевает                                                                                                                                                                                                     |
-| Заход           | Одна сессия работы над задачей. Работа живёт дольше одного захода, и между ними её состояние держит только ход работы                                                                                                                                                         |
-| Заполнение окна | Доля места захода, которую он уже занял: вход, запись в кэш, прочитанное из кэша и вывод последнего ответа, делённые на размер окна. Не «расход» и не «бюджет»: речь о месте, а не о деньгах                                                                                  |
-| Передача        | Текст, которым заход закрывается: рабочее дерево, ветка, задача, где лежит ход работы, что сделано, следующий шаг, особенности захода. Кладётся вне дерева и не коммитится                                                                                                    |
-| Эпик            | Серия задач одной темы, выполняемых в назначенном порядке. Живёт в двух местах сразу: карточка в очереди работ с меткой эпика и замысел рядом с ней — что за возможность разрабатывается, какие задачи входят и в каком порядке. Шире одной ветки. Линией работ не называется |
-| Архив           | Записи о состоявшемся: что объясняет закрытое решение. После выкатки не правится                                                                                                                                                                                              |
+| Термин           | Что это                                                                                                                                                                                                                                                                       |
+| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Задача           | Единица работы в очереди работ. Заводится до ветки, и номер её стоит в имени ветки и в заголовке PR                                                                                                                                                                           |
+| PR               | Заявка на слияние: то же название, что у задачи, переведённое в сделанное. Отчётом, пул-реквестом и мёрдж-реквестом не называется — ни в файлах, ни в разговоре                                                                                                               |
+| Очередь работ    | Доска, на которой видно состояние каждой задачи. Ветки она не видит                                                                                                                                                                                                           |
+| Папка задачи     | Одна работа от разбора до слияния: разбор просьбы, замысел, ход работы. Умирает со слиянием — разбирается, и объясняющее решение уезжает в архив                                                                                                                              |
+| Разбор           | Расспрос владельца до первой правки. Записывается его словами и задним числом не переписывается                                                                                                                                                                               |
+| Замысел          | Файл папки задачи: след задачи и этапы с признаками готовности. После написания не правится — с ним сверяют результат при приёмке                                                                                                                                             |
+| Ход работы       | Файл папки задачи: «Где стоим», решения по ходу с причинами, записи заходов. Единственное место, где отмечается сделанное. Журналом не называется                                                                                                                             |
+| Состояние работы | Единица, которой работа ведётся: у каждого состояния названы вход, обязательное действие и выход. Объявляется машиночитаемой строкой в разделе «Где стоим» хода работы — гард судит объявленный переход, а не наличие файлов                                                  |
+| След задачи      | Раздел замысла: какие спеки, законы, правила и части кода работа задевает                                                                                                                                                                                                     |
+| Заход            | Одна сессия работы над задачей. Работа живёт дольше одного захода, и между ними её состояние держит только ход работы                                                                                                                                                         |
+| Заполнение окна  | Доля места захода, которую он уже занял: вход, запись в кэш, прочитанное из кэша и вывод последнего ответа, делённые на размер окна. Не «расход» и не «бюджет»: речь о месте, а не о деньгах                                                                                  |
+| Передача         | Текст, которым заход закрывается: рабочее дерево, ветка, задача, где лежит ход работы, что сделано, следующий шаг, особенности захода. Кладётся вне дерева и не коммитится                                                                                                    |
+| Эпик             | Серия задач одной темы, выполняемых в назначенном порядке. Живёт в двух местах сразу: карточка в очереди работ с меткой эпика и замысел рядом с ней — что за возможность разрабатывается, какие задачи входят и в каком порядке. Шире одной ветки. Линией работ не называется |
+| Архив            | Записи о состоявшемся: что объясняет закрытое решение. После выкатки не правится                                                                                                                                                                                              |
 
 ## Проверки
 

package/assets/hooks/browser-device-id.sh

@@ -8,6 +8,8 @@
 #
 # Файл с идентификатором в репозиторий не коммитится: у каждой машины он свой.
 
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+
 if [ -n "${RT_BROWSER_DEVICE_ID:-}" ]; then
     printf '%s\n' "$RT_BROWSER_DEVICE_ID"
     exit 0

package/assets/hooks/browser-guard-device-id.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse mcp__claude-in-chrome__select_browser
+# Требует: hooks/deny-tail.sh
 # Гард выбора браузера. PreToolUse на выборе браузера расширением.
 #
 # Отклоняет любой профиль, кроме закреплённого: чужой стоит лишнего круга и приводит в браузер,
@@ -10,6 +11,8 @@
 #
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: помощник не назвал профиль — пропуск.
 
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+
 input="$(cat 2>/dev/null)"
 
 device_id="$("${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/browser-device-id.sh" 2>/dev/null)"
@@ -24,5 +27,12 @@ if [ "$requested" = "$device_id" ]; then
     exit 0
 fi
 
-echo "Профиль «${requested}» не тот, что закреплён за проектом. Бери ${device_id} — единственный профиль, где сделан вход." >&2
+# Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть. Файл
+# может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+# shellcheck disable=SC1090
+[ -f "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" ] \
+    && . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" 2>/dev/null
+command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { :; }
+
+echo "Профиль «${requested}» не тот, что закреплён за проектом. Бери ${device_id} — единственный профиль, где сделан вход. $(rt_deny_tail)" >&2
 exit 2

package/assets/hooks/browser-guard-no-asking.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse AskUserQuestion
+# Требует: hooks/deny-tail.sh
 # PreToolUse guard for AskUserQuestion.
 #
 # The browser choice is already made and pinned in browser-device-id.sh — asking again is noise, and the
@@ -13,6 +14,8 @@
 #
 # FAIL-OPEN when browser-device-id.sh prints nothing.
 
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+
 input="$(cat 2>/dev/null)"
 
 device_id="$("${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/browser-device-id.sh" 2>/dev/null)"
@@ -23,5 +26,12 @@ questions="$(printf '%s' "$input" | jq -r '[.tool_input.questions[]? | .question
 
 printf '%s' "$questions" | grep -qiE 'deviceid|device id|(which|what|pick|choose|select)[^.]{0,25}\bbrowser\b|\bbrowser\b[^.]{0,25}(profile|to use)|как(ой|ую)?[^.]{0,15}браузер|брауз[а-я]*[^.]{0,20}(использовать|выбрать|выбор|нужен|запустить)' || exit 0
 
-echo "Do not ask which browser to use — the profile is pinned. Call select_browser with deviceId ${device_id} ('Main' profile)." >&2
+# Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть. Файл
+# может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+# shellcheck disable=SC1090
+[ -f "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" ] \
+    && . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" 2>/dev/null
+command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { :; }
+
+echo "Do not ask which browser to use — the profile is pinned. Call select_browser with deviceId ${device_id} ('Main' profile). $(rt_deny_tail)" >&2
 exit 2

package/assets/hooks/browser-guard-no-listing.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse mcp__claude-in-chrome__(list_connected_browsers|switch_browser)
+# Требует: hooks/deny-tail.sh
 # Гард перечисления и переключения браузеров. PreToolUse.
 #
 # Сессии проекта живут в одном закреплённом профиле. Перечисление и переключение отдают общие
@@ -9,10 +10,19 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: помощник не назвал профиль — пропуск. Гард, который не может назвать
 # нужный профиль, ничего не предлагает взамен, и слепой отказ только заводил бы работу в тупик.
 
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+
 cat >/dev/null 2>&1
 
 device_id="$("${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/browser-device-id.sh" 2>/dev/null)"
 [ -z "$device_id" ] && exit 0
 
-echo "Не перечисляй и не переключай браузеры. Вызови выбор браузера с профилем ${device_id} — единственным, где сделан вход." >&2
+# Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть. Файл
+# может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+# shellcheck disable=SC1090
+[ -f "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" ] \
+    && . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" 2>/dev/null
+command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { :; }
+
+echo "Не перечисляй и не переключай браузеры. Вызови выбор браузера с профилем ${device_id} — единственным, где сделан вход. $(rt_deny_tail)" >&2
 exit 2

package/assets/hooks/browser-guard-no-other-drivers.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse mcp__playwright__.*|mcp__chrome-devtools__.*|Bash
+# Требует: hooks/deny-tail.sh
 # Гард обходных путей к браузеру. PreToolUse.
 #
 # Закрепление профиля чего-то стоит только тогда, когда дверь одна. Здесь перечислены двери,
@@ -12,6 +13,8 @@
 #
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: помощник не назвал профиль — пропуск.
 
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+
 input="$(cat 2>/dev/null)"
 
 device_id="$("${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/browser-device-id.sh" 2>/dev/null)"
@@ -19,8 +22,13 @@ device_id="$("${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/browser-device-id.sh" 2>/de
 
 tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
 
+# shellcheck disable=SC1090
+[ -f "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" ] \
+    && . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" 2>/dev/null
+command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { :; }
+
 deny() {
-    echo "$1 Води браузер закреплённым расширением: выбери профиль ${device_id} и работай его инструментами." >&2
+    echo "$1 Води браузер закреплённым расширением: выбери профиль ${device_id} и работай его инструментами. $(rt_deny_tail)" >&2
     exit 2
 }
 

package/assets/hooks/browser-guard-require-select.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse mcp__claude-in-chrome__.*
+# Требует: hooks/deny-tail.sh
 # Гард свежести выбора браузера. PreToolUse на всех остальных вызовах расширения.
 #
 # ЗАЧЕМ ОН ЕСТЬ — отказ, из которого он вырос: расширение действует на тот браузер, который
@@ -19,6 +20,8 @@
 #
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: помощник не назвал профиль — пропуск.
 
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+
 input="$(cat 2>/dev/null)"
 
 device_id="$("${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/browser-device-id.sh" 2>/dev/null)"
@@ -35,8 +38,16 @@ ttl=300
 sid="$(printf '%s' "$input" | jq -r '.session_id // "nosession"' 2>/dev/null)"
 marker="${TMPDIR:-/tmp}/claude-browser-guard/${sid}"
 
+# Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть. Файл
+# может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+# shellcheck disable=SC1090
+[ -f "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" ] \
+    && . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" 2>/dev/null
+command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { :; }
+
+
 if [ ! -f "$marker" ]; then
-    echo "В этой сессии браузер не выбран. Вызови выбор браузера с профилем ${device_id} до любого другого вызова." >&2
+    echo "В этой сессии браузер не выбран. Вызови выбор браузера с профилем ${device_id} до любого другого вызова. $(rt_deny_tail)" >&2
     exit 2
 fi
 
@@ -46,7 +57,7 @@ age=$(( now - stamped ))
 
 if [ "$age" -gt "$ttl" ]; then
     rm -f "$marker" 2>/dev/null
-    echo "Последний выбор браузера был ${age} с назад (предел ${ttl} с) — на таких перерывах активный браузер расширения уплывает, и это может быть уже не закреплённый профиль. Вызови выбор с профилем ${device_id} заново и повтори." >&2
+    echo "Последний выбор браузера был ${age} с назад (предел ${ttl} с) — на таких перерывах активный браузер расширения уплывает, и это может быть уже не закреплённый профиль. Вызови выбор с профилем ${device_id} заново и повтори. $(rt_deny_tail)" >&2
     exit 2
 fi
 

package/assets/hooks/claim-guard.sh

@@ -0,0 +1,115 @@
+#!/usr/bin/env bash
+# rt-hook: Stop
+# Гард утверждения: сказанное владельцу о состоянии дерева несёт команду, показавшую это. Stop.
+#
+# Зачем именно так. Правило текстов само говорит, что ответ владельцу не читает ни одна
+# проверка: за файл отвечает гейт, за ответ — автор, и цену ошибки в ответе платит владелец.
+# Восемь разборов подряд про одно и то же — готовым названо лежащее на диске, снятыми названы
+# только локальные ветки, проверенным назван набор уже конвейерного, состоянием дерева названа
+# отставшая локальная ссылка. Каждый раз в правило дописывалась статья, и каждый раз промах
+# повторялся: текст читают в начале захода, а утверждение говорят в конце.
+#
+# Что судится: текст, сказанный владельцу за этот ход. Вывод инструмента и записанное в файл
+# сюда не входят — их читают гейт и сверки.
+#
+# Как судится: у каждого слова-утверждения назван свой род команды. Утверждение о зелёном
+# наборе подтверждает прогон набора, о запушенном — вызов пуша, о снятом — вызов удаления.
+# Команда ищется в этом же ходе: состояние дерева меняется, и вывод прошлого хода о нынешнем
+# уже не говорит.
+#
+# Чего гард не судит. Неверный вывод: об образце, судимом по одному его файлу, и о пути, которым
+# человек не пойдёт, машине судить нечем — там нет ни слова-утверждения, ни команды, с которой
+# сверять. Эти случаи держит правило ведения работы, и это известная граница гарда, а не
+# обещание.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ: при любой ошибке, нехватке `jq`, отсутствии записи хода или пустом
+# тексте ход РАЗРЕШАЕТСЯ (exit 0). Сломанный гард не имеет права заклинить разговор.
+
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+
+input="$(cat 2>/dev/null)"
+[ -z "$input" ] && exit 0
+command -v jq >/dev/null 2>&1 || exit 0
+
+# Повторный заход по тому же ходу не судится: гард сказал своё один раз и отпускает.
+active="$(printf '%s' "$input" | jq -r '.stop_hook_active // false' 2>/dev/null)"
+[ "$active" = "true" ] && exit 0
+
+transcript="$(printf '%s' "$input" | jq -r '.transcript_path // empty' 2>/dev/null)"
+[ -z "$transcript" ] && exit 0
+[ -f "$transcript" ] || exit 0
+
+# Ход — всё, что записано после последней настоящей реплики владельца: ответ инструмента
+# приходит той же ролью и репликой не считается.
+turn="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r '
+    def is_input:
+        .type == "user"
+        and (((.message.content // []) | if type == "array"
+                then ([.[] | select(.type == "tool_result")] | length)
+                else 0 end) == 0);
+
+    (map(is_input) | rindex(true)) as $i
+    | (if $i == null then [] else .[$i:] end) as $turn
+    | [$turn[] | select(.type == "assistant") | (.message.content // [])[]
+        | select(.type == "text") | (.text // "")] as $said
+    | [$turn[] | select(.type == "assistant") | (.message.content // [])[]
+        | select(.type == "tool_use") | (.input.command // "")] as $ran
+    | { said: ($said | join("\n")), ran: ($ran | join("\n")) }
+' 2>/dev/null)"
+
+[ -z "$turn" ] && exit 0
+
+said="$(printf '%s' "$turn" | jq -r '.said // ""' 2>/dev/null)"
+ran="$(printf '%s' "$turn" | jq -r '.ran // ""' 2>/dev/null)"
+[ -z "$said" ] && exit 0
+
+# Карта утверждений: что сказано о дереве | чем это показывают | что назвать в отказе.
+#
+# Слово берётся в той форме, в какой его говорят владельцу. Будущее время сюда не идёт:
+# «проверю» и «запущу» утверждениями не являются — они обещание, и врать им нечем.
+claims=(
+    'проверено|прогнал[а]?|тесты (зелёные|прошли)|линт(ер)? (зелёный|прошёл|чистый)|сборка (зелёная|прошла)|набор зелёный|проверки зелёные|спеки зелёные|всё зелен(о|ое)§nx (test|lint|build|run|affected|run-many)|npm (run|test)|pnpm (run|exec|test)|jest|vitest|playwright|check:|run\.sh§команду набора — прогон тестов, линта или сборки'
+    'запушен[аоы]?|запушил[а]?|пуш прошёл|ветка уехала§git push§`git push`'
+    '(PR|правка|ветка|работа)[^.]{0,20}(влит|слит|смержен)|влит[оа] в|слит[оа] в§git merge|gh pr merge§`git merge` или `gh pr merge`'
+    '(ветки|ветка|файлы|файл|папка|каталог)[^.]{0,40}(снят|удал|почищ|вычищ)|снят[оыа] с§git branch|git push .*--delete|git rm|gh api|rm §команду удаления — `git branch -d`, `git push --delete` или `git rm`'
+    'прогон (зелёный|прошёл|кончился)|конвейер зелёный|проверки на PR зелёные§gh run§`gh run list` или `gh run view`'
+    '(работа|правка|задача) готова|можно вливать|PR открыт|черновик снят§gh pr §`gh pr create`, `gh pr view` или `gh pr ready`'
+    'задача заведена|задача (в|переведена в) колонк|колонка переведена§gh issue|gh api|task:new|task:move|board\.mjs§команду очереди работ — заведение задачи или перевод колонки'
+    '(в дереве|в репозитории|здесь|такого файла|такой команды)[^.]{0,30}(нет|не бывает)|не заводили|нигде не встречается§grep|rg |ls |find |git ls-files|git grep|git log|cat §команду поиска — `grep`, `git ls-files` или обход каталога'
+)
+
+for row in "${claims[@]}"; do
+    words="${row%%§*}"
+    rest="${row#*§}"
+    proof="${rest%%§*}"
+    name="${rest#*§}"
+
+    found="$(printf '%s' "$said" | grep -oiE "$words" 2>/dev/null | head -1)"
+    [ -z "$found" ] && continue
+    printf '%s' "$ran" | grep -qiE "$proof" 2>/dev/null && continue
+
+    reason="BLOCKED by claim-guard: владельцу сказано «${found}» — это утверждение о состоянии дерева, а команды, которая его показывает, за этот ход не было.
+
+Утверждение о дереве стоит ровно столько, сколько команда, его показавшая: сказанное без команды владелец читает как проверенный факт и узнаёт о расхождении последним.
+
+Запусти ${name} этим же ходом и назови её вывод — либо убери утверждение из ответа.
+
+Гард судит один ход: следующий заход не отбивается."
+
+    # Общий хвост отказа: два законных хода. Файл может быть не разложен — тогда хвоста нет,
+    # а причина отказа остаётся прежней.
+    # shellcheck disable=SC1090
+    [ -f "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" ] \
+        && . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" 2>/dev/null
+    command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { :; }
+    deny_tail_text="$(rt_deny_tail "")"
+    [ -n "$deny_tail_text" ] && reason="${reason}
+
+${deny_tail_text}"
+
+    jq -n --arg r "$reason" '{decision:"block",reason:$r}' 2>/dev/null \
+        || printf '{"decision":"block","reason":"claim-guard: утверждение о дереве не подтверждено командой."}\n'
+    exit 0
+done
+
+exit 0