@rt-tools/agent-kit 0.10.0 → 0.12.0

package/assets/defaults/project.sh

@@ -87,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
 
@@ -135,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}"
 
 # Куда кладётся передача захода. Вне дерева: состояние работы живёт в ходе работы и коммитится,
 # а передача его пересказывает для вставки в новый заход и в историю не едет.
@@ -214,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|^\./||' \
@@ -265,9 +317,17 @@ RT_TASK_TITLE_RE="${RT_TASK_TITLE_RE:-^\[[A-Za-z]+-[0-9]+\][[:space:]]+[^[:space
 RT_TASK_NEW_CMD="${RT_TASK_NEW_CMD:-npm run task:new}"
 RT_BOARD_CHECK_CMD="${RT_BOARD_CHECK_CMD:-npm run check:board}"
 
-# Учётная запись, которую ставят исполнителем. Умолчание молчит: у каждого дерева она своя.
+# Учётная запись, которую ставят исполнителем и которой открывают заявку. Умолчание молчит: у
+# каждого дерева она своя, а у иного её нет вовсе.
 RT_TASK_BOT="${RT_TASK_BOT:-}"
 
+# Чем вызову подставляют токен машинной записи и как эта подстановка выглядит целиком. Клиент
+# хостинга держит две записи сразу — залогиненную и ту, чей токен стоит в окружении вызова, — и
+# из текста команды видно только явную подстановку. Оба умолчания молчат: дерево без отдельной
+# машинной записи автора заявки не судит вовсе.
+RT_PULL_TOKEN_VAR="${RT_PULL_TOKEN_VAR:-}"
+RT_PULL_TOKEN_HINT="${RT_PULL_TOKEN_HINT:-}"
+
 # Команда перевода задачи между колонками очереди работ и имя первой колонки — той, из которой
 # задача уходит, когда её берут в работу. Имя без умолчания: колонки дерево называет своими
 # словами, а выдуманное не совпало бы ни с чем и молча выключило бы проверку колонки.

package/assets/defaults/turn-map.md

@@ -0,0 +1,48 @@
+# Карта хода
+
+Это не правило, а его короткая выжимка: правило объясняет, карта называет. Полный текст —
+скил `task-flow`; он же называет паттерн, который ведёт каждое состояние. Чем ход
+кончается — скил `turn-conduct` под тем же законом.
+
+Состояние работы объявлено строкой в разделе «Где стоим» хода работы. Пока обязательное
+действие не сделано, работа стоит в том же состоянии.
+
+## Состояния и обязательные действия
+
+| Состояние                 | Обязательное действие                                  | Ведёт паттерн      |
+| ------------------------- | ------------------------------------------------------ | ------------------ |
+| `просьба-не-разобрана`    | разведка по дереву, затем вопросы                      | `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-archive` |
+| `влито`                   | разбор работы правилами и сверка очереди               | `task-flow-archive` |
+
+Ни у одного состояния обязательное действие не звучит как «ждать». Прогон, разбор владельцем и
+слияние идут без исполнителя и от взгляда быстрее не становятся.
+
+## Чем ход кончается
+
+Способов четыре, и других нет.
+
+| Выход                                              | Чем подтверждается                                              |
+| -------------------------------------------------- | --------------------------------------------------------------- |
+| вопрос владельцу, ответа на который в правилах нет | вопрос задан, и за тот же ход правила читались                  |
+| отказ гарда                                        | отказ назван владельцу, обход не искался                        |
+| заполненное окно там, где сжатия нет               | ход работы дописан, передача написана                           |
+| работа отдана, и следующая начата                  | 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

@@ -11,7 +11,11 @@
 #
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: помощник не назвал профиль — пропуск.
 
-input="$(cat 2>/dev/null)"
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
+
+rt_hook_read
+input="$RT_HOOK_INPUT"
 
 device_id="$("${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/browser-device-id.sh" 2>/dev/null)"
 [ -z "$device_id" ] && exit 0

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

@@ -14,7 +14,11 @@
 #
 # FAIL-OPEN when browser-device-id.sh prints nothing.
 
-input="$(cat 2>/dev/null)"
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
+
+rt_hook_read
+input="$RT_HOOK_INPUT"
 
 device_id="$("${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/browser-device-id.sh" 2>/dev/null)"
 [ -z "$device_id" ] && exit 0

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

@@ -10,6 +10,8 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: помощник не назвал профиль — пропуск. Гард, который не может назвать
 # нужный профиль, ничего не предлагает взамен, и слепой отказ только заводил бы работу в тупик.
 
+. "$(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)"

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

@@ -13,12 +13,16 @@
 #
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: помощник не назвал профиль — пропуск.
 
-input="$(cat 2>/dev/null)"
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
+
+rt_hook_read
+input="$RT_HOOK_INPUT"
 
 device_id="$("${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/browser-device-id.sh" 2>/dev/null)"
 [ -z "$device_id" ] && exit 0
 
-tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
+tool="$(rt_hook_tool)"
 
 # shellcheck disable=SC1090
 [ -f "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" ] \
@@ -43,7 +47,7 @@ case "$tool" in
     *) exit 0 ;;
 esac
 
-cmd="$(printf '%s' "$input" | jq -r '.tool_input.command // empty' 2>/dev/null)"
+cmd="$(rt_hook_cmd)"
 [ -z "$cmd" ] && exit 0
 
 if [ "$tool" = "mcp__webstorm__execute_tool" ] && command -v perl >/dev/null 2>&1; then

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

@@ -20,12 +20,16 @@
 #
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: помощник не назвал профиль — пропуск.
 
-input="$(cat 2>/dev/null)"
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
+
+rt_hook_read
+input="$RT_HOOK_INPUT"
 
 device_id="$("${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/browser-device-id.sh" 2>/dev/null)"
 [ -z "$device_id" ] && exit 0
 
-tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
+tool="$(rt_hook_tool)"
 # У перечисления, переключения и самого выбора свои гарды.
 case "$tool" in
     *list_connected_browsers|*switch_browser|*select_browser) exit 0 ;;

package/assets/hooks/claim-guard.sh

@@ -25,7 +25,11 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: при любой ошибке, нехватке `jq`, отсутствии записи хода или пустом
 # тексте ход РАЗРЕШАЕТСЯ (exit 0). Сломанный гард не имеет права заклинить разговор.
 
-input="$(cat 2>/dev/null)"
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
+
+rt_hook_read
+input="$RT_HOOK_INPUT"
 [ -z "$input" ] && exit 0
 command -v jq >/dev/null 2>&1 || exit 0
 

package/assets/hooks/commit-msg.sh

@@ -15,6 +15,8 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: проверяльщика нет (свежий клон без установленных зависимостей) —
 # пропуск. Формат тогда не проверяется, и это лучше, чем заклинивший коммит.
 
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+
 msg_file="$1"
 [ -z "$msg_file" ] && exit 0
 

package/assets/hooks/conscience-guard.sh

@@ -19,7 +19,11 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: нет `jq`, нет записи хода, роль молчит или отвечает не по форме — ход
 # разрешается. Сломанная совесть не имеет права заклинить разговор.
 
-input="$(cat 2>/dev/null)"
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
+
+rt_hook_read
+input="$RT_HOOK_INPUT"
 [ -z "$input" ] && exit 0
 command -v jq >/dev/null 2>&1 || exit 0
 

package/assets/hooks/constitution-index.sh

@@ -12,6 +12,8 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: любая ошибка начинает сессию без добавленного контекста (exit 0).
 # Сломанный вход не имеет права остановить сессию.
 
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+
 dir="${CLAUDE_PROJECT_DIR:-.}/docs/constitution"
 [ -d "$dir" ] || exit 0
 

package/assets/hooks/dev-server-guard.sh

@@ -14,9 +14,13 @@
 # Где именно подняты приложения, знает профиль проекта: .claude/rt-kit/project.sh, переменная
 # RT_STANDS. Нет профиля — текст отказа остаётся общим, сам гард работает.
 
-input="$(cat 2>/dev/null)"
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
 
-tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
+rt_hook_read
+input="$RT_HOOK_INPUT"
+
+tool="$(rt_hook_tool)"
 case "$tool" in
     Bash | mcp__webstorm__execute_terminal_command | mcp__webstorm__execute_tool) ;;
     # Готовая конфигурация запуска командной строки не показывает — видно только её имя.
@@ -46,7 +50,7 @@ case "$tool" in
     *) exit 0 ;;
 esac
 
-cmd="$(printf '%s' "$input" | jq -r '.tool_input.command // empty' 2>/dev/null)"
+cmd="$(rt_hook_cmd)"
 [ -z "$cmd" ] && exit 0
 
 # Универсальный исполнитель среды передаёт настоящую команду вложенной строкой. Разбирать надо

package/assets/hooks/dispatch.sh

@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+# Диспетчер событий агента. НЕ гард: объявления `rt-hook:` у него нет — наоборот, он читает
+# такие объявления у остальных. В настройке агента он стоит один на событие вместо списка.
+#
+# Зачем он есть. Агент зовёт каждый гард своим процессом и каждому подаёт один и тот же ввод.
+# Гардов на вызове инструмента восемнадцать, и каждый разбирает ввод заново — по шесть-семь
+# вызовов разборщика. Замер этого дерева: восемьсот двадцать шесть миллисекунд на вызов, из
+# которых восемьдесят пять — запуск оболочек, а остальное — повторный разбор одного текста.
+#
+# Что он делает. Читает ввод один раз, разбирает его один раз, кладёт поля в окружение и зовёт
+# ветки события по порядку. Первый ненулевой код возврата отдаётся агенту вместе с выводом
+# гарда — остальные ветки не зовутся: отказ и раньше кончал вызов на первом же гарде.
+#
+# Чего он не делает. Он не судит ничего сам и ни одного гарда не заменяет: файлы остаются как
+# были, меняется точка входа. Событие и образец вызова гард несёт сам, строкой `# rt-hook:` в
+# своей шапке, и карта собирается из них — список, выписанный отдельно, разошёлся бы с набором
+# файлов на первом же добавленном.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ: нет события в доводе, нет каталога гардов, нет разборщика — выход нулём.
+# Сломанный диспетчер не имеет права заклинить работу.
+
+set -u
+
+here="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+. "$here/utf8.sh" 2>/dev/null || true
+
+event="${1:-}"
+[ -z "$event" ] && exit 0
+
+input="$(cat 2>/dev/null)"
+[ -z "$input" ] && exit 0
+
+# Разбор один на все ветки: четыре поля одним вызовом разборщика вместо шести на каждый гард.
+# Значения приходят уже закавыченными для оболочки — `@sh` в разборщике для того и сделан:
+# командная строка держит и кавычки, и переводы строк, и подставить её иначе нельзя.
+assignments="$(printf '%s' "$input" | jq -r '@sh "RT_HOOK_TOOL=\(.tool_name // "") RT_HOOK_CMD=\(.tool_input.command // "") RT_HOOK_FILE=\(.tool_input.file_path // "") RT_HOOK_CWD=\(.cwd // "")"' 2>/dev/null)"
+if [ -n "$assignments" ]; then
+    eval "$assignments" 2>/dev/null || true
+    export RT_HOOK_TOOL RT_HOOK_CMD RT_HOOK_FILE RT_HOOK_CWD
+    # Признак разбора: по нему ветки отличают готовое поле от пустой переменной, случайно
+    # оказавшейся в окружении прогона. Без него пустое значение читается как «поля нет».
+    export RT_HOOK_PARSED=1
+fi
+export RT_HOOK_INPUT="$input"
+
+branches="$(grep -l '^# rt-hook:' "$here"/*.sh 2>/dev/null | sort)"
+[ -z "$branches" ] && exit 0
+
+for branch in $branches; do
+    declaration="$(sed -n 's/^# rt-hook:[[:space:]]*//p' "$branch" 2>/dev/null | head -1)"
+    [ -z "$declaration" ] && continue
+
+    branch_event="${declaration%% *}"
+    [ "$branch_event" = "$event" ] || continue
+
+    # Образец вызова: его нет вовсе — гард зовётся на любом; есть — сверяется с именем
+    # инструмента целиком, а не куском. Звёздочка и точка со звёздочкой значат одно: любой вызов.
+    matcher="${declaration#"$branch_event"}"
+    matcher="${matcher#"${matcher%%[![:space:]]*}"}"
+    if [ -n "$matcher" ] && [ "$matcher" != '*' ] && [ "$matcher" != '.*' ]; then
+        [[ "${RT_HOOK_TOOL:-}" =~ ^(${matcher})$ ]] || continue
+    fi
+
+    printf '%s' "$input" | bash "$branch"
+    code=$?
+    [ "$code" -ne 0 ] && exit "$code"
+done
+
+exit 0

package/assets/hooks/docs-guard.sh

@@ -26,11 +26,15 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: не репозиторий, нет разборщика, битый ввод, пустой список файлов —
 # пропуск.
 
-input="$(cat 2>/dev/null)"
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
+
+rt_hook_read
+input="$RT_HOOK_INPUT"
 [ -z "$input" ] && exit 0
 command -v jq >/dev/null 2>&1 || exit 0
 
-tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
+tool="$(rt_hook_tool)"
 
 decide() {
     # Наблюдение пишется только на отказе: подсказку гард раздаёт и там, где всё в порядке, и
@@ -115,7 +119,7 @@ case "$tool" in
     *) exit 0 ;;
 esac
 
-cmd="$(printf '%s' "$input" | jq -r '.tool_input.command // empty' 2>/dev/null)"
+cmd="$(rt_hook_cmd)"
 
 # Универсальный исполнитель передаёт настоящую команду вложенной строкой. Разбирать надо её,
 # иначе имя команды стоит сразу за кавычкой и ни одно правило до него не дотягивается.
@@ -144,7 +148,7 @@ if printf '%s' "$cmd" | grep -qiE '(^|#)[[:space:]]*Docs-skip:[[:space:]]*[^[:sp
     exit 0
 fi
 
-workdir="$(printf '%s' "$input" | jq -r '.cwd // empty' 2>/dev/null)"
+workdir="$(rt_hook_cwd)"
 [ -z "$workdir" ] && workdir="${CLAUDE_PROJECT_DIR:-.}"
 cd "$workdir" 2>/dev/null || exit 0
 git rev-parse --is-inside-work-tree >/dev/null 2>&1 || exit 0

package/assets/hooks/exam-guard.sh

@@ -18,7 +18,11 @@
 # FAIL-OPEN: нет jq, нет записи хода, чужой инструмент → пропуск. Сломанный гард не должен
 # мешать работать.
 
-input="$(cat 2>/dev/null)"
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
+
+rt_hook_read
+input="$RT_HOOK_INPUT"
 [ -z "$input" ] && exit 0
 command -v jq >/dev/null 2>&1 || exit 0
 
@@ -30,14 +34,14 @@ rt_hooks_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 [ -f "$rt_hooks_dir/roles.sh" ] && . "$rt_hooks_dir/roles.sh" 2>/dev/null
 command -v rt_role_off >/dev/null 2>&1 && rt_role_off strict-teacher && exit 0
 
-tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
+tool="$(rt_hook_tool)"
 # Второй экзамен спрашивается на снятии черновика: работа кончилась, и правила поставки к этому
 # моменту читались давно — между их чтением и этой минутой прошёл весь заход.
 ready=0
 case "$tool" in
     Edit | Write | MultiEdit | mcp__webstorm__create_new_file) ;;
     Bash)
-        cmd="$(printf '%s' "$input" | jq -r '.tool_input.command // empty' 2>/dev/null)"
+        cmd="$(rt_hook_cmd)"
         printf '%s' "$cmd" | grep -qE 'pr[[:space:]]+ready|mr[[:space:]]+update[^|;&]*--ready' || exit 0
         ready=1
         ;;

package/assets/hooks/git-guard-delivery-signature.sh

@@ -10,6 +10,8 @@
 # Вынесен он отсюда потому, что гард дорос до предела длины: предметов в нём пять, и подпись
 # среди них самая отдельная — своя точка проверки, свои условия молчания, свой отказ.
 
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+
 rt_delivery_signature() {
 # --- подпись машинного коммита ------------------------------------------------------------
 #

package/assets/hooks/git-guard-delivery.sh

@@ -30,18 +30,24 @@
 #                          numbered); молчание значит «спросить некого»;
 #   RT_TASK_NEW_CMD      — чем заводится задача;
 #   RT_BOARD_CHECK_CMD   — чем сверяется очередь работ;
-#   RT_TASK_BOT          — учётная запись, которую ставят исполнителем;
+#   RT_TASK_BOT          — учётная запись, которую ставят исполнителем; ею же открывается заявка;
+#   RT_PULL_TOKEN_VAR    — переменная, которой вызову подставляют её токен;
+#   RT_PULL_TOKEN_HINT   — готовая подстановка этого токена, целиком;
 #   RT_COMMIT_EMAIL      — почта, которой подписан машинный коммит; её же левой частью он и
 #                          опознаётся.
 # Отказ называет и то, что не так, и чем это чинится: отказ без действия обходят, а не исполняют.
 #
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: не репозиторий, нет разборщика, битый ввод, нет профиля — пропуск.
 
-input="$(cat 2>/dev/null)"
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
+
+rt_hook_read
+input="$RT_HOOK_INPUT"
 [ -z "$input" ] && exit 0
 command -v jq >/dev/null 2>&1 || exit 0
 
-tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
+tool="$(rt_hook_tool)"
 sid="$(printf '%s' "$input" | jq -r '.session_id // "nosession"' 2>/dev/null)"
 case "$tool" in
     # Терминал среды и универсальный исполнитель кладут команду в то же поле.
@@ -49,7 +55,7 @@ case "$tool" in
     *) exit 0 ;;
 esac
 
-cmd="$(printf '%s' "$input" | jq -r '.tool_input.command // empty' 2>/dev/null)"
+cmd="$(rt_hook_cmd)"
 [ -z "$cmd" ] && exit 0
 
 # Универсальный исполнитель передаёт настоящую команду вложенной строкой. Разбирать надо её,
@@ -63,7 +69,7 @@ if [ "$tool" = "mcp__webstorm__execute_tool" ] && command -v perl >/dev/null 2>&
     [ -n "$inner" ] && cmd="$inner"
 fi
 
-workdir="$(printf '%s' "$input" | jq -r '.cwd // empty' 2>/dev/null)"
+workdir="$(rt_hook_cwd)"
 [ -z "$workdir" ] && workdir="${CLAUDE_PROJECT_DIR:-.}"
 cd "$workdir" 2>/dev/null || exit 0
 git rev-parse --is-inside-work-tree >/dev/null 2>&1 || exit 0
@@ -96,6 +102,11 @@ task_move="${RT_TASK_MOVE_CMD:-npm run task:move}"
 # молча выключило бы проверку.
 backlog_column="${RT_BOARD_BACKLOG:-}"
 task_bot="${RT_TASK_BOT:-}"
+# Личность вызова приходит окружением, а не словом в строке: из текста команды видно только то,
+# подставлен ли токен явно. Дерево, не назвавшее переменной, автора заявки не судит вовсе —
+# у него может не быть отдельной машинной записи.
+pull_token_var="${RT_PULL_TOKEN_VAR:-}"
+pull_token_hint="${RT_PULL_TOKEN_HINT:-}"
 commit_email="${RT_COMMIT_EMAIL:-}"
 tasks_dir="${RT_TASKS_DIR:-}"
 archive_dir="${RT_ARCHIVE_DIR:-}"
@@ -313,6 +324,16 @@ if printf '%s' "$cmd" | grep -qE '(^|[;&|(]|&&|\|\|)[[:space:]]*(gh[[:space:]]+p
             # и «ещё не посчитано» — не «конфликтует».
             printf '%s' "$pull" | jq -e '.conflicting' >/dev/null 2>&1 \
                 && fault "заявка${pull_name} конфликтует с главной веткой. Влей её в свою ветку, разбери конфликт и повтори: снятый черновик читается как «можно вливать», а слить эту заявку нельзя."
+
+            # Автор заявки. На открытии судить было нечем, кроме текста команды: личность вызова
+            # приходит окружением. Здесь она уже названа хостингом, и это последний ход, где
+            # промах ещё исправим — после снятия черновика заявку вливают, а переоткрыть влитую
+            # нельзя. Дерево, не назвавшее машинной записи, автора не судит.
+            if [ -n "$task_bot" ]; then
+                pull_author="$(printf '%s' "$pull" | jq -r '.author // empty' 2>/dev/null)"
+                [ -n "$pull_author" ] && [ "$pull_author" != "$task_bot" ] \
+                    && fault "заявку${pull_name} открыла запись «${pull_author}», а не машинная «${task_bot}». Автор заявки её ревьювером не бывает, и разбор ей назначить нечем. Автора не сменить — закрой заявку и открой заново${pull_token_hint:+, подставив токен: ${pull_token_hint} …}."
+            fi
         fi
     fi
     deny_faults
@@ -438,6 +459,19 @@ if [ -n "$remote_main" ] && [ -n "$local_main" ] && [ "$remote_main" != "$local_
     fault "твоя ссылка origin/${main_branch} отстала от удалённой — ${local_main:0:8} против ${remote_main:0:8}.${age} Гард сравнивает ветку с тем, что лежит в дереве, поэтому молчание первого яруса значит «ссылка не старше ветки», а не «главная ветка влита». Влей и повтори: git fetch origin && git merge origin/${main_branch}."
 fi
 
+# Личность вызова. Клиент хостинга держит две записи сразу — залогиненную и ту, чей токен стоит
+# в окружении вызова, — и какая из них откроет заявку, из текста команды не видно ничем, кроме
+# явной подстановки. Читающие вызовы идут от залогиненной и работают, поэтому пишущий выглядит
+# таким же обычным; промах всплывает шагом позже, на назначении ревьювера: автор заявки её
+# ревьювером не бывает. Чинится это только переоткрытием — автора у заявки не сменить.
+#
+# Судится текст команды, а не ответ хостинга: спросить, чьим токеном пойдёт вызов, до его
+# исполнения нельзя. Дерево, не назвавшее переменной токена, требования не получает.
+if [ -n "$pull_token_var" ] \
+    && ! printf '%s' "$cmd" | grep -qE "(^|[;&|(]|&&|\|\||[[:space:]])${pull_token_var}="; then
+    fault "заявка открывается без токена машинной записи: в команде нет подстановки «${pull_token_var}». Открытая залогиненной записью, она выйдет от владельца — ревьювером его тогда не назначить, и чинится это только переоткрытием.${pull_token_hint:+ Подставь токен: ${pull_token_hint} …}"
+fi
+
 check_task "$number" "заявка с ветки «${branch}»" да
 
 # Всё несошедшееся названо здесь, разом: до этой строки собирались условия, каждое из которых

package/assets/hooks/git-guard-main.sh

@@ -13,10 +13,14 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: не репозиторий, нет гита, открепившийся HEAD, битый ввод — пропуск.
 # Сломанный гард не должен мешать работать.
 
-input="$(cat 2>/dev/null)"
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
+
+rt_hook_read
+input="$RT_HOOK_INPUT"
 [ -z "$input" ] && exit 0
 
-tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
+tool="$(rt_hook_tool)"
 # Терминал среды разработки исполняет ту же командную строку и кладёт её в то же поле. Пока
 # гард проверял только оболочку, весь его смысл обходился сменой инструмента.
 case "$tool" in
@@ -24,7 +28,7 @@ case "$tool" in
     *) exit 0 ;;
 esac
 
-cmd="$(printf '%s' "$input" | jq -r '.tool_input.command // empty' 2>/dev/null)"
+cmd="$(rt_hook_cmd)"
 
 # Универсальный исполнитель среды передаёт настоящую команду вложенной строкой. Разбирать надо
 # её, а не обёртку: иначе имя команды стоит сразу за кавычкой и ни одно правило до него не
@@ -44,7 +48,7 @@ esac
 
 # Коммит выполнится в рабочем каталоге вызова, поэтому и ветку смотрим там же; корень проекта
 # — запасной вариант, и он важен для отдельного рабочего дерева, где ветка своя.
-workdir="$(printf '%s' "$input" | jq -r '.cwd // empty' 2>/dev/null)"
+workdir="$(rt_hook_cwd)"
 [ -z "$workdir" ] && workdir="${CLAUDE_PROJECT_DIR:-.}"
 cd "$workdir" 2>/dev/null || exit 0