@rt-tools/agent-kit 0.11.0 → 0.13.0

package/assets/hooks/git-guard-push-tests.sh

@@ -26,25 +26,27 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: не репозиторий, битый ввод, нет профиля — пропуск.
 
 . "$(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
 
-input="$(cat 2>/dev/null)"
+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
     # Терминал среды и универсальный исполнитель кладут команду в то же поле.
     Bash | mcp__webstorm__execute_terminal_command | mcp__webstorm__execute_tool) ;;
     *) exit 0 ;;
 esac
 
-cmd="$(printf '%s' "$input" | jq -r '.tool_input.command // empty' 2>/dev/null)"
+cmd="$(rt_hook_cmd)"
 
 # Вызов пуша узнаётся по двум признакам сразу — команда `git` в начале строки или за
 # разделителем и слово `push` отдельным словом. Тем же приёмом, что у гарда поставки: одной
 # подстрокой «git push» пуш не поймать — помощник учётных данных и заголовок запроса ставятся
 # ключами `-c` между ними, и ровно этой формой здесь и пушат. Пока признаком была подстрока,
 # весь набор гейта на таком пуше не гонялся вовсе, а молчание гарда читалось как «зелено».
-printf '%s' "$cmd" | grep -qE '(^|[;&|(]|&&|\|\|)[[:space:]]*git([[:space:]]|$)' || exit 0
+printf '%s' "$cmd" | grep -qE "${RT_CMD_BOUND}git([[:space:]]|\$)" || exit 0
 
 # Отложенная правка пушем не бывает: `git stash push` кладёт правку в тайник этой же машины и
 # наружу не отправляет ничего. Слово `push` в ней стоит отдельным, и без этой строки гард гонял
@@ -69,7 +71,7 @@ esac
 #
 # Судится переключение на существующую ветку. Заведение новой (`checkout -b`, `switch -c`)
 # сюда не попадает: у свежей ветки дерево то же самое, что и было.
-if printf '%s' "$cmd" | grep -qE '(^|[;&|(]|&&|\|\|)[[:space:]]*git[[:space:]]+(checkout|switch)[[:space:]]+' &&
+if printf '%s' "$cmd" | grep -qE "${RT_CMD_BOUND}git[[:space:]]+(checkout|switch)[[:space:]]+" &&
     ! printf '%s' "$cmd" | grep -qE 'git[[:space:]]+(checkout[[:space:]]+-b|switch[[:space:]]+-c)([[:space:]]|$)'; then
     reason="BLOCKED: переключение ветки и пуш одной командой. Набор гейта гоняется в том дереве, какое лежит на момент разбора команды, — то есть по ПРЕЖНЕЙ ветке, а не по той, что уходит на хостинг. Зелёный набор при этом читается как проверка ушедшего, хотя проверял он другое. Раздели вызовы: сперва переключись, затем отдельной командой пушь."
     # Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть.
@@ -88,7 +90,7 @@ ${deny_tail_text}"
     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/grill-gate.sh

@@ -23,14 +23,16 @@
 # РАЗРЕШАЕТСЯ (exit 0). Сломанный гард не имеет права заклинить разговор.
 
 . "$(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
 
-input="$(cat 2>/dev/null)"
+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)"
 
 # Повторный заход по тому же ходу не судится: иначе ход не кончится никогда — гард сказал своё
 # один раз и отпускает. К вызову инструмента это не относится: там судится сам вызов.

package/assets/hooks/handoff-entry-guard.sh

@@ -15,12 +15,14 @@
 # FAIL-OPEN: нет `jq`, нет записи хода, передачи в реплике нет → пропуск.
 
 . "$(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
 
-input="$(cat 2>/dev/null)"
+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)"
 case "$tool" in
     Edit | Write | MultiEdit) ;;
     *) exit 0 ;;

package/assets/hooks/handoff-write.sh

@@ -20,8 +20,10 @@
 # нулём и молчит. Сжатие он не отбивает никогда: остановленное сжатие оставит заход без места.
 
 . "$(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
 
-input="$(cat 2>/dev/null)"
+rt_hook_read
+input="$RT_HOOK_INPUT"
 [ -z "$input" ] && exit 0
 
 command -v jq >/dev/null 2>&1 || exit 0
@@ -33,13 +35,21 @@ for profile in "$rt_hooks_dir/../rt-kit/defaults/project.sh" "$rt_hooks_dir/../d
     [ -f "$profile" ] && . "$profile" 2>/dev/null
 done
 
-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
 
+# Пустое имя ветки хук не останавливает. На отсоединённой голове имени нет, а всё, что едет в
+# передачу, лежит в дереве и доступно целиком: имя нужно только файлу. Прежний выход нулём был
+# полным молчанием — сжатие приходило без передачи, и заход после него начинал с пустого места.
 branch="$(git branch --show-current 2>/dev/null)"
-[ -z "$branch" ] && exit 0
+head_name=""
+if [ -z "$branch" ]; then
+    head_name="$(git rev-parse --short HEAD 2>/dev/null)"
+    [ -z "$head_name" ] && head_name='detached'
+    head_name="detached-$head_name"
+fi
 
 root="$(git rev-parse --show-toplevel 2>/dev/null)"
 [ -z "$root" ] && exit 0
@@ -56,7 +66,12 @@ mkdir -p "$root/$handoff_dir" 2>/dev/null || exit 0
 trigger="$(printf '%s' "$input" | jq -r '.trigger // "auto"' 2>/dev/null)"
 [ -z "$trigger" ] && trigger='auto'
 
-progress="$root/$tasks_dir/$branch/progress.md"
+# Файл передачи ищут по имени ветки; голове без имени он называется её коротким снимком.
+handoff_name="$branch"
+[ -z "$handoff_name" ] && handoff_name="$head_name"
+
+progress=""
+[ -n "$branch" ] && progress="$root/$tasks_dir/$branch/progress.md"
 
 # Строка раздела «Где стоим» по её названию. Пусто — работа идёт вне папки задачи, и выдумывать
 # за неё состояние нельзя: в передаче тогда стоит то, что известно дереву.
@@ -76,12 +91,16 @@ uncommitted="$(git status --short 2>/dev/null | head -20)"
 ahead="$(git log --oneline origin/main..HEAD 2>/dev/null | head -20)"
 [ -z "$ahead" ] && ahead='нет коммитов сверх главной'
 
-target="$root/$handoff_dir/$branch.md"
+target="$root/$handoff_dir/$handoff_name.md"
 
 {
     printf '# Передача захода — сжатие контекста (%s)\n\n' "$trigger"
     printf '**Рабочее дерево:** %s\n' "$root"
-    printf '**Ветка:** %s\n\n' "$branch"
+    if [ -n "$branch" ]; then
+        printf '**Ветка:** %s\n\n' "$branch"
+    else
+        printf '**Ветка:** имени нет — отсоединённая голова %s\n\n' "$head_name"
+    fi
 
     if [ -n "$state" ]; then
         printf '## Где стоим\n\n'
@@ -90,6 +109,8 @@ target="$root/$handoff_dir/$branch.md"
         [ -n "$next_step" ] && printf -- '- **Следующий шаг:** %s\n' "$next_step"
         [ -n "$pull" ] && printf -- '- **PR:** %s\n' "$pull"
         printf '\nХод работы целиком — `%s/%s/progress.md`; замысел рядом с ним.\n\n' "$tasks_dir" "$branch"
+    elif [ -z "$branch" ]; then
+        printf '## Где стоим\n\nИмени у головы нет, папки задачи при ней тоже: состояние работы взять неоткуда. Читающая сторона ищет передачу по имени ветки, а не найдя его — по последней записи каталога.\n\n'
     else
         printf '## Где стоим\n\nПапки задачи у этой ветки нет: состояние работы взять неоткуда.\n\n'
     fi

package/assets/hooks/hook-input.sh

@@ -0,0 +1,77 @@
+#!/usr/bin/env bash
+# Общее чтение ввода хука. НЕ гард: объявления `rt-hook:` у него нет, к событиям агента он не
+# подключается. Его источают сами гарды — тем же приёмом, каким они источают общий хвост отказа.
+#
+# Зачем он есть. Ввод приходит одним объектом, и каждому гарду из него нужны те же поля: имя
+# инструмента, командная строка, путь правки, рабочий каталог. Пока каждый доставал их сам, один
+# вызов агента стоил больше сотни разборов одного и того же текста — по шесть-семь на гард,
+# восемнадцать гардов на событие. Разбор стоит шесть миллисекунд, запуск оболочки — пять.
+#
+# Как это работает. Диспетчер разбирает ввод однажды и кладёт поля в окружение. Гард спрашивает
+# их отсюда: есть в окружении — берёт готовое, нет — разбирает сам. Второе — это прямой вызов:
+# так гарды зовут наборы сценариев, и работать они обязаны и без диспетчера.
+#
+# ПОЧЕМУ ЧТЕНИЕ ПОТОКА — ОТДЕЛЬНАЯ КОМАНДА, А НЕ ЗНАЧЕНИЕ. Подстановка команд исполняется в
+# подоболочке, и всё, что она запомнила, умирает вместе с ней: первый вызов вычитал бы поток, а
+# второй получил бы пустоту — и гард пропустил бы вызов, который обязан был отбить. Поэтому поток
+# читается командой `rt_hook_read`, кладущей ввод в переменную текущей оболочки, а не функцией,
+# возвращающей его через подстановку.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ: нет разборщика, битый ввод, пустое поле — пустая строка. Сломанное
+# чтение не имеет права заклинить работу: гард на пустом поле выходит нулём.
+
+# Читает ввод в `RT_HOOK_INPUT`, если его там ещё нет. Зовётся командой, а не подстановкой.
+rt_hook_read() {
+    [ -n "${RT_HOOK_INPUT:-}" ] && return 0
+
+    RT_HOOK_INPUT="$(cat 2>/dev/null)"
+    export RT_HOOK_INPUT
+    return 0
+}
+
+# Поле ввода по имени переменной и пути в объекте: `rt_hook_field RT_HOOK_TOOL '.tool_name'`.
+# Переменная окружения главнее разбора — её кладёт диспетчер, разобравший ввод один раз.
+rt_hook_field() {
+    local name="$1" path="$2"
+
+    # Готовому верят только по признаку разбора, а не по тому, что переменная объявлена. Пустая
+    # переменная в окружении означает «поля нет», и без признака она неотличима от «поле есть и
+    # оно пустое»: гард переставал разбирать ввод и пропускал вызовы, которые обязан был отбить.
+    # Наборы поймали это шестнадцатью провалами — окружение прогона несло пустые значения.
+    if [ "${RT_HOOK_PARSED:-}" = '1' ] && [ -n "${!name+x}" ]; then
+        printf '%s' "${!name}"
+        return 0
+    fi
+
+    rt_hook_read
+    printf '%s' "$RT_HOOK_INPUT" | jq -r "${path} // empty" 2>/dev/null
+}
+
+# НАЧАЛО ВЫЗОВА В КОМАНДНОЙ СТРОКЕ. Приставка образца, которым гард узнаёт свой вызов: команда
+# стоит в начале строки, за разделителем — и после любого числа присваиваний переменных
+# окружения перед её именем.
+#
+# Присваивания входят сюда потому, что вызов с ними — обычная форма, и часть набора требует её
+# прямо: личность вызова, открывающего заявку, видна из команды только явной подстановкой
+# токена. Признак, не знавший о присваиваниях, на этой форме слепнул молча — он не отказывал и
+# не предупреждал, он не считал вызов вызовом, и весь предмет гарда оставался несудимым. Так
+# прошли мимо своих гардов пуш, открытие заявки, снятие черновика и слияние: коммит с чужой
+# подписью уехал в главную ветку, а запрет на слияние агентом снимался подстановкой токена.
+#
+# Значение присваивания берётся без пробелов: `ИМЯ="a b"` в кавычках сюда не подпадает, и вызов
+# за ним останется несудимым. Пробел внутри значения перед вызовом встречается редко, а
+# образец, разбирающий кавычки, ошибается в другую сторону — считает вызовом то, что им не
+# является. Признак обязан ошибаться в сторону лишнего срабатывания: гард, не узнавший вызов,
+# молчит и выглядит исправным, а сработавший на лишнем виден сразу и правится.
+#
+# Само по себе присваивание вызовом не считается: за ним обязано стоять имя команды.
+#
+# Объявлено это одним местом, а не литералом в каждом гарде: разойдясь, копии чинятся по одной
+# и молчат о том, что остальные остались слепыми.
+RT_CMD_BOUND='(^|[;&|(]|&&|\|\|)[[:space:]]*([A-Za-z_][A-Za-z0-9_]*=[^[:space:]]*[[:space:]]+)*'
+
+# Поля, которые спрашивают все гарды.
+rt_hook_tool() { rt_hook_field RT_HOOK_TOOL '.tool_name'; }
+rt_hook_cmd() { rt_hook_field RT_HOOK_CMD '.tool_input.command'; }
+rt_hook_file() { rt_hook_field RT_HOOK_FILE '.tool_input.file_path'; }
+rt_hook_cwd() { rt_hook_field RT_HOOK_CWD '.cwd'; }

package/assets/hooks/lint-after-edit.sh

@@ -30,14 +30,16 @@
 # Сколько файлов линтуется за один перенос. Переезд либы трогает десятки файлов, и прогон по
 # каждому превратил бы хук в минутную паузу; на нарушение границы хватает первых.
 . "$(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
 
 MAX_FILES=12
 
-input="$(cat 2>/dev/null)"
+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)"
 case "$tool" in
     Edit | Write | MultiEdit | mcp__webstorm__create_new_file) mode="edit" ;;
     Bash) mode="move" ;;
@@ -54,7 +56,7 @@ if [ "$mode" = "move" ]; then
     esac
 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
 [ -f package.json ] || exit 0

package/assets/hooks/override-write-guard.sh

@@ -0,0 +1,107 @@
+#!/usr/bin/env bash
+# rt-hook: PreToolUse Write|Bash|mcp__webstorm__create_new_file|mcp__webstorm__execute_terminal_command|mcp__webstorm__execute_tool
+# Требует: hooks/deny-tail.sh
+# Гард затирания надстройки: запись поверх — не то же самое, что правка.
+#
+# Надстройка дерева сливается с ресурсом пакета по разделу «## »: раздел, который дерево
+# переписало, замещает пакетный, а остальные приходят из пакета. Файл надстройки поэтому
+# накапливается — разделы в него дописывают разные ветки и разные заходы, — и выглядит он как
+# обычный текст, который можно положить целиком.
+#
+# Положенный целиком, он уносит с собой все разделы, которых эта правка не касалась. Пропажу не
+# видно ничем: раскладка сходится, проверки зелёные, а пакетный раздел молча вернулся на место
+# того, что дерево о себе говорило. Заметит это тот, кто через месяц удивится, почему правило
+# снова требует чужих имён.
+#
+# ЧТО СУДИТСЯ. Запись файла целиком поверх существующей непустой надстройки: инструмент записи,
+# перенаправление `>`, `tee` без дописывания, копирование поверх. Дописывание в конец — `>>`,
+# `tee -a` — и правка по месту проходят: они ничего не уносят.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ: нет `jq`, битый ввод, чужой инструмент, файла нет, файл пуст —
+# правка РАЗРЕШАЕТСЯ. Сломанный гард не имеет права заклинить работу.
+
+. "$(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
+
+rt_hooks_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# shellcheck disable=SC1090
+[ -f "$rt_hooks_dir/deny-tail.sh" ] && . "$rt_hooks_dir/deny-tail.sh" 2>/dev/null
+command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { printf ''; }
+
+deny() {
+    # shellcheck disable=SC1090
+    [ -f "$rt_hooks_dir/observe.sh" ] && . "$rt_hooks_dir/observe.sh" 2>/dev/null
+    command -v rt_note >/dev/null 2>&1 && rt_note guard-deny res=override-write-guard
+
+    reason="$1 $(rt_deny_tail "$2")"
+    jq -n --arg r "$reason" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
+        || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Гард затирания надстройки."}}\n'
+    exit 0
+}
+
+# Цели записи поверх, названные командой прямо. Дописывание сюда не входит: `>>` прячется до
+# разбора и обратно не разворачивается, `tee` берётся только без довода о дописывании.
+rt_overwrite_targets() {
+    tr "\"'\`" '   ' \
+        | sed -E 's/>>/\
+APPEND/g' \
+        | sed -E 's/>/\
+>/g' \
+        | sed -nE '
+            s/^>[[:space:]]*([^[:space:]|&;]+).*/\1/p
+            s/(^|.*[[:space:]])tee[[:space:]]+([^-[:space:]][^[:space:]|&;]*).*/\2/p
+            s/(^|.*[[:space:]])(cp|mv|install)[[:space:]]+([^[:space:]]+[[:space:]]+)+([^[:space:]|&;]+).*/\4/p
+        ' \
+        | sort -u
+}
+
+tool="$(rt_hook_tool)"
+candidates=""
+case "$tool" in
+    Write | mcp__webstorm__create_new_file)
+        candidates="$(printf '%s' "$input" | jq -r '.tool_input.file_path // .tool_input.pathInProject // empty' 2>/dev/null)"
+        ;;
+    Bash | mcp__webstorm__execute_terminal_command | mcp__webstorm__execute_tool)
+        cmd="$(rt_hook_cmd)"
+        [ -z "$cmd" ] && exit 0
+        candidates="$(printf '%s' "$cmd" | rt_overwrite_targets)"
+        ;;
+    *) exit 0 ;;
+esac
+[ -z "$candidates" ] && exit 0
+
+root="${CLAUDE_PROJECT_DIR:-.}"
+overrides_dir="${RT_OVERRIDES_DIR:-.claude/rt-kit/overrides}"
+
+while IFS= read -r candidate; do
+    [ -z "$candidate" ] && continue
+    case "$candidate" in
+        /*) relative="${candidate#"$root"/}" ;;
+        *)
+            relative="$candidate"
+            candidate="$root/$candidate"
+            ;;
+    esac
+    case "$relative" in "$overrides_dir"/*) ;; *) continue ;; esac
+    [ -f "$candidate" ] || continue
+
+    lines="$(wc -l <"$candidate" 2>/dev/null | tr -d ' ')"
+    [ -z "$lines" ] && continue
+    [ "$lines" -eq 0 ] && continue
+
+    sections="$(grep -c '^## ' "$candidate" 2>/dev/null || printf '0')"
+    resource="${relative#"$overrides_dir"/}"
+
+    deny "BLOCKED by override-write-guard: «${relative}» — надстройка этого дерева, и в ней уже лежит ${lines} строк, разделов «## » — ${sections}. Запись целиком уносит все разделы, которых эта правка не касалась, и на их место молча возвращается пакетный текст ресурса «${resource}»: раскладка после этого сходится, проверки зелёные, а сказанного деревом о себе больше нет. Правь по месту — правкой раздела, а не записью файла." \
+        "новый раздел дописывается в конец: надстройка сливается с пакетным ресурсом по заголовку «## », и пакетный текст замещается только теми разделами, которые дерево назвало"
+done <<EOF
+$candidates
+EOF
+
+exit 0

package/assets/hooks/postmortem-guard.sh

@@ -22,8 +22,10 @@
 # РАЗРЕШАЕТСЯ (exit 0). Сломанный гард не имеет права заклинить разговор.
 
 . "$(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
 
-input="$(cat 2>/dev/null)"
+rt_hook_read
+input="$RT_HOOK_INPUT"
 [ -z "$input" ] && exit 0
 
 command -v jq >/dev/null 2>&1 || exit 0

package/assets/hooks/proposal-guard.sh

@@ -21,8 +21,10 @@
 # заходе ход РАЗРЕШАЕТСЯ (exit 0). Сломанный гард не имеет права заклинить разговор.
 
 . "$(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
 
-input="$(cat 2>/dev/null)"
+rt_hook_read
+input="$RT_HOOK_INPUT"
 [ -z "$input" ] && exit 0
 
 command -v jq >/dev/null 2>&1 || exit 0

package/assets/hooks/prose-style-guard.sh

@@ -13,19 +13,21 @@
 # FAIL-OPEN: нет узла, нет проверки, чужой инструмент, не `.md` → пропуск.
 
 . "$(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
 
-input="$(cat 2>/dev/null)"
+rt_hook_read
+input="$RT_HOOK_INPUT"
 [ -z "$input" ] && exit 0
 command -v jq >/dev/null 2>&1 || exit 0
 command -v node >/dev/null 2>&1 || exit 0
 
-tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
+tool="$(rt_hook_tool)"
 case "$tool" in
     Edit | Write | MultiEdit) ;;
     *) exit 0 ;;
 esac
 
-path="$(printf '%s' "$input" | jq -r '.tool_input.file_path // empty' 2>/dev/null)"
+path="$(rt_hook_file)"
 case "$path" in
     *.md) ;;
     *) exit 0 ;;

package/assets/hooks/qa-dataid-guard.sh

@@ -26,13 +26,15 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: нет разборщика, битый ввод, чужой инструмент — пропуск.
 
 . "$(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
 
-input="$(cat 2>/dev/null)"
+rt_hook_read
+input="$RT_HOOK_INPUT"
 [ -z "$input" ] && exit 0
 command -v jq >/dev/null 2>&1 || exit 0
 command -v perl >/dev/null 2>&1 || exit 0
 
-tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
+tool="$(rt_hook_tool)"
 case "$tool" in
     # Инструмент среды заводит файл теми же двумя данными, только называет их иначе — без этой
     # ветки разметка заводилась мимо всех проверок.

package/assets/hooks/rerun-guard.sh

@@ -21,19 +21,21 @@
 # упавшего прогона зовут и без него, а угадывать, о каком задании речь, значит отбивать наугад.
 
 . "$(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
 
-input="$(cat 2>/dev/null)"
+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)"
 case "$tool" in
     # Терминал среды и универсальный исполнитель кладут команду в то же поле.
     Bash | mcp__webstorm__execute_terminal_command | mcp__webstorm__execute_tool) ;;
     *) exit 0 ;;
 esac
 
-cmd="$(printf '%s' "$input" | jq -r '.tool_input.command // empty' 2>/dev/null)"
+cmd="$(rt_hook_cmd)"
 [ -z "$cmd" ] && exit 0
 
 # Профиль дерева: сперва умолчание пакета, поверх него — надстройка проекта, если она есть.
@@ -47,7 +49,7 @@ done
 
 # Вызов перезапуска: слово перезапуска отдельным словом рядом со словом прогона.
 host_cli="${RT_HOST_CLI:-gh}"
-printf '%s' "$cmd" | grep -qE "(^|[;&|(]|&&|\|\|)[[:space:]]*${host_cli}([[:space:]]|$)" || exit 0
+printf '%s' "$cmd" | grep -qE "${RT_CMD_BOUND}${host_cli}([[:space:]]|\$)" || exit 0
 printf '%s' "$cmd" | grep -qE '(^|[[:space:]])(run|workflow)([[:space:]]|$)' || exit 0
 printf '%s' "$cmd" | grep -qE '(^|[[:space:]])rerun([[:space:]]|$)' || exit 0
 

package/assets/hooks/reuse-first-guard.sh

@@ -33,13 +33,15 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: нет разборщика, битый ввод, чужой инструмент — пропуск.
 
 . "$(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
 
-input="$(cat 2>/dev/null)"
+rt_hook_read
+input="$RT_HOOK_INPUT"
 [ -z "$input" ] && exit 0
 command -v jq >/dev/null 2>&1 || exit 0
 command -v perl >/dev/null 2>&1 || exit 0
 
-tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
+tool="$(rt_hook_tool)"
 shell_cmd=""
 case "$tool" in
     # Инструмент среды заводит файл теми же двумя данными, только называет их иначе — без этой
@@ -54,7 +56,7 @@ case "$tool" in
     # имён гард стоял бы объявленным на них и молча пропускал — состояние хуже необъявленного,
     # потому что снаружи выглядит закрытым.
     Bash | mcp__webstorm__execute_terminal_command | mcp__webstorm__execute_tool)
-        shell_cmd="$(printf '%s' "$input" | jq -r '.tool_input.command // empty' 2>/dev/null)"
+        shell_cmd="$(rt_hook_cmd)"
         [ -z "$shell_cmd" ] && exit 0
         # Универсальный исполнитель прячет настоящую команду во вложенной строке: без её разбора
         # путь стоит за кавычкой, и до него не дотягивается ни один образец.

package/assets/hooks/rule-article.sh

@@ -0,0 +1,99 @@
+#!/usr/bin/env bash
+# Разбор признака применимости у статьи правила. Помощник: своего события не объявляет, его
+# подключает тот, кому нужен текст статьи, — гейт правил в своём отказе.
+#
+# Правило весит от двадцати до шестидесяти килобайт, а под конкретную правку подпадает одна его
+# статья. Отказ, зовущий правило целиком, платит за решение полной ценой правила — и учит не
+# тому: дешевле не читать лишнего, то есть работать хуже разведанным.
+#
+# Признак стоит при самой статье: карта гейта знает путь и правило, но не знает, какая из двух
+# десятков статей про этот путь. Статья знает о себе всё.
+#
+#   - **Заголовок статьи.** Текст статьи, как обычно.
+#     <!-- rt-when: *.scss *.css -->
+#
+# Комментарий не виден в собранной разметке и не мешает читать статью; образцы разделены
+# пробелом и сверяются с путём правки самой оболочкой, а не поиском по словам: поиск называет не
+# ту статью и молчит об этом.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ: статья без признака законна, правило без единого признака — тоже. Не
+# нашлось ни одной подошедшей статьи — печатается пусто, и зовущий остаётся при прежнем отказе.
+
+# Статьи правила, чей признак совпал с путём правки. Доводы: файл правила, путь правки.
+# Печатает текст подошедших статей целиком, по статье, разделяя их пустой строкой.
+rt_rule_articles() {
+    rule_file="$1"
+    edited="$2"
+    [ -f "$rule_file" ] || return 0
+    [ -n "$edited" ] || return 0
+
+    # Статьи выбираются в два прохода: сперва номера строк, где стоят признаки, и сами образцы,
+    # затем — текст той статьи, чей образец совпал. Сопоставление делает оболочка: `case` знает
+    # правила путей, а разборщик текста — нет.
+    while IFS=' ' read -r line patterns; do
+        [ -n "$line" ] || continue
+        hit=''
+        # Образцы разбираются под выключенным раскрытием имён: `*.scss` в цикле развернулось бы
+        # в имена файлов рабочего каталога, и статья выбиралась бы по тому, где стоял вызов.
+        # Разделитель задаётся здесь же — внешний мог быть переопределён тем, кто нас позвал.
+        set -f
+        old_ifs="$IFS"
+        IFS=' '
+        # shellcheck disable=SC2086
+        set -- $patterns
+        IFS="$old_ifs"
+        set +f
+        for pattern in "$@"; do
+            [ -n "$pattern" ] || continue
+            # shellcheck disable=SC2254
+            case "$edited" in
+                $pattern) hit=1; break ;;
+            esac
+            # Образец без каталога сверяется и с именем файла: статья говорит «про такие файлы»,
+            # а правка приходит полным путём.
+            # shellcheck disable=SC2254
+            case "${edited##*/}" in
+                $pattern) hit=1; break ;;
+            esac
+        done
+        [ -n "$hit" ] || continue
+        rt_rule_article_at "$rule_file" "$line"
+    done <<EOF
+$(rt_rule_article_marks "$rule_file")
+EOF
+}
+
+# Признаки правила: строка «номер строки — образцы». Отдельной функцией, потому что её же зовёт
+# сверка полноты текстов: правило, у которого признак записан не той формой, тихо остаётся без
+# статьи в отказе, и заметить это нечем.
+rt_rule_article_marks() {
+    [ -f "$1" ] || return 0
+    grep -n 'rt-when:' "$1" 2>/dev/null \
+        | sed -e 's/^\([0-9]*\):.*rt-when:[[:space:]]*/\1 /' -e 's/[[:space:]]*-->.*$//'
+}
+
+# Текст статьи, внутри которой стоит строка с признаком. Статья начинается ближайшим сверху
+# пунктом списка верхнего уровня и кончается перед следующим таким пунктом или перед строкой без
+# отступа: продолжение статьи всегда идёт с отступом.
+rt_rule_article_at() {
+    awk -v mark="$2" '
+        NR <= mark && /^- / { start = NR }
+        { line[NR] = $0 }
+        END {
+            if (!start) { exit }
+            for (i = start + 1; i <= NR; i++) {
+                if (line[i] ~ /^- / || (line[i] !~ /^[ \t]/ && line[i] != "")) { break }
+                stop = i
+            }
+            if (!stop) { stop = start }
+            last = start
+            for (i = start; i <= stop; i++) {
+                if (line[i] ~ /rt-when:/) { continue }
+                if (line[i] == "" && i == stop) { continue }
+                print line[i]
+                last = i
+            }
+            print ""
+        }
+    ' "$1" 2>/dev/null
+}