@rt-tools/agent-kit 0.10.0 → 0.12.0

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

@@ -25,17 +25,21 @@
 #
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: не репозиторий, битый ввод, нет профиля — пропуск.
 
-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
     # Терминал среды и универсальный исполнитель кладут команду в то же поле.
     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` отдельным словом. Тем же приёмом, что у гарда поставки: одной
@@ -86,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/glossary-load.sh

@@ -9,6 +9,8 @@
 #
 # FAIL-OPEN: нет файла или нет `jq` — выходим молча. Сессия важнее словаря.
 
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+
 GLOSSARY="${CLAUDE_PROJECT_DIR:-.}/docs/GLOSSARY.md"
 [ -f "$GLOSSARY" ] || exit 0
 command -v jq >/dev/null 2>&1 || exit 0

package/assets/hooks/grill-gate.sh

@@ -22,13 +22,17 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: при любой ошибке, отсутствии записи хода и повторном заходе ход
 # РАЗРЕШАЕТСЯ (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
 
 # Какое событие пришло. У вызова инструмента есть его имя, у завершения хода — нет.
-tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
+tool="$(rt_hook_tool)"
 
 # Повторный заход по тому же ходу не судится: иначе ход не кончится никогда — гард сказал своё
 # один раз и отпускает. К вызову инструмента это не относится: там судится сам вызов.

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

@@ -14,11 +14,15 @@
 #
 # 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
 
-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

@@ -0,0 +1,124 @@
+#!/usr/bin/env bash
+# rt-hook: PreCompact .*
+# Требует: hooks/profile-check.sh
+# Передача захода пишется перед сжатием контекста, а не рукой исполнителя.
+#
+# Заход кончается двумя способами: исполнитель доводит работу до точки и пишет передачу сам —
+# либо контекст переполняется, и сжатие приходит от инструмента. Второй случай раньше терял
+# передачу целиком: писать её в этот момент уже некому, а после сжатия пересказывать нечего.
+# Ночью, когда напомнить некому, так кончается каждый заход.
+#
+# Хук собирает передачу из того, что лежит на диске: ход работы даёт состояние и следующий шаг,
+# дерево — ветку, незакоммиченное и коммиты сверх главной. Ничего от себя он не добавляет:
+# передача пересказывает записанное, а не заменяет его.
+#
+# Написанное руками не затирается молча: файл один, и последняя запись побеждает. Исполнитель,
+# закрывающий заход по правилу, пишет поверх — его передача полнее, потому что он знает то,
+# чего на диске нет.
+#
+# FAIL-OPEN: нет разборщика, пустой ввод, не репозиторий, нет каталога передачи — хук выходит
+# нулём и молчит. Сжатие он не отбивает никогда: остановленное сжатие оставит заход без места.
+
+. "$(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)"
+for profile in "$rt_hooks_dir/../rt-kit/defaults/project.sh" "$rt_hooks_dir/../defaults/project.sh" \
+    "${CLAUDE_PROJECT_DIR:-.}/.claude/rt-kit/defaults/project.sh" "${CLAUDE_PROJECT_DIR:-.}/.claude/rt-kit/project.sh"; do
+    # shellcheck disable=SC1090
+    [ -f "$profile" ] && . "$profile" 2>/dev/null
+done
+
+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)"
+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
+
+handoff_dir="${RT_HANDOFF_DIR:-.claude/handoff}"
+tasks_dir="${RT_TASKS_DIR:-docs/tasks}"
+
+mkdir -p "$root/$handoff_dir" 2>/dev/null || exit 0
+[ -d "$root/$handoff_dir" ] || exit 0
+
+# Ручное сжатие от автоматического отличается одним: при ручном исполнитель у клавиатуры и
+# может дописать передачу сам. Пишется она в обоих случаях — заход, сжатый руками, теряет
+# контекст ровно так же.
+trigger="$(printf '%s' "$input" | jq -r '.trigger // "auto"' 2>/dev/null)"
+[ -z "$trigger" ] && trigger='auto'
+
+# Файл передачи ищут по имени ветки; голове без имени он называется её коротким снимком.
+handoff_name="$branch"
+[ -z "$handoff_name" ] && handoff_name="$head_name"
+
+progress=""
+[ -n "$branch" ] && progress="$root/$tasks_dir/$branch/progress.md"
+
+# Строка раздела «Где стоим» по её названию. Пусто — работа идёт вне папки задачи, и выдумывать
+# за неё состояние нельзя: в передаче тогда стоит то, что известно дереву.
+line_of() {
+    [ -f "$progress" ] || return 0
+    sed -n "s/^[[:space:]]*[-*][[:space:]]*\*\*$1:\*\*[[:space:]]*\(.*\)/\1/p" "$progress" 2>/dev/null | head -1
+}
+
+state="$(line_of 'Состояние')"
+stage="$(line_of 'Этап')"
+next_step="$(line_of 'Следующий шаг')"
+pull="$(line_of 'PR')"
+
+uncommitted="$(git status --short 2>/dev/null | head -20)"
+[ -z "$uncommitted" ] && uncommitted='нет'
+
+ahead="$(git log --oneline origin/main..HEAD 2>/dev/null | head -20)"
+[ -z "$ahead" ] && ahead='нет коммитов сверх главной'
+
+target="$root/$handoff_dir/$handoff_name.md"
+
+{
+    printf '# Передача захода — сжатие контекста (%s)\n\n' "$trigger"
+    printf '**Рабочее дерево:** %s\n' "$root"
+    if [ -n "$branch" ]; then
+        printf '**Ветка:** %s\n\n' "$branch"
+    else
+        printf '**Ветка:** имени нет — отсоединённая голова %s\n\n' "$head_name"
+    fi
+
+    if [ -n "$state" ]; then
+        printf '## Где стоим\n\n'
+        printf -- '- **Состояние:** %s\n' "$state"
+        [ -n "$stage" ] && printf -- '- **Этап:** %s\n' "$stage"
+        [ -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
+
+    printf '## Незакоммиченное\n\n```\n%s\n```\n\n' "$uncommitted"
+    printf '## Коммиты сверх главной\n\n```\n%s\n```\n\n' "$ahead"
+    printf 'Написана хуком перед сжатием контекста. Всё, что здесь стоит, проверяется деревом:\n'
+    printf 'передача пересказывает записанное и описывает минуту, когда её собрали.\n'
+} > "$target" 2>/dev/null
+
+exit 0

package/assets/hooks/hook-input.sh

@@ -0,0 +1,54 @@
+#!/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
+}
+
+# Поля, которые спрашивают все гарды.
+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

@@ -29,13 +29,17 @@
 
 # Сколько файлов линтуется за один перенос. Переезд либы трогает десятки файлов, и прогон по
 # каждому превратил бы хук в минутную паузу; на нарушение границы хватает первых.
+. "$(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" ;;
@@ -52,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/observe.sh

@@ -19,6 +19,8 @@
 
 # Значение, годное к записи. Путь не выносится ни при каких обстоятельствах, остальное чистится
 # до имени и обрезается: длинное значение в наблюдении не значит ничего, кроме утечки.
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+
 rt_observe_clean() {
     case "$1" in
         */*) return 0 ;;

package/assets/hooks/postmortem-guard.sh

@@ -21,7 +21,11 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: при любой ошибке, отсутствии записи хода и повторном заходе ход
 # РАЗРЕШАЕТСЯ (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/proposal-guard.sh

@@ -20,7 +20,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/prose-style-guard.sh

@@ -12,18 +12,22 @@
 #
 # FAIL-OPEN: нет узла, нет проверки, чужой инструмент, не `.md` → пропуск.
 
-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
 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

@@ -25,12 +25,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"
 [ -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

@@ -20,18 +20,22 @@
 # похож на перезапуск — пропуск. Гард без номера судить не берётся: перезапуск последнего
 # упавшего прогона зовут и без него, а угадывать, о каком задании речь, значит отбивать наугад.
 
-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)"
 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
 
 # Профиль дерева: сперва умолчание пакета, поверх него — надстройка проекта, если она есть.

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

@@ -32,12 +32,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"
 [ -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
     # Инструмент среды заводит файл теми же двумя данными, только называет их иначе — без этой
@@ -52,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/roles.sh

@@ -19,6 +19,8 @@
 # Выключена ли роль. Успех — выключена.
 #
 #   rt_role_off strict-teacher && exit 0
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+
 rt_role_off() {
     local role="$1" config
     [ -n "$role" ] || return 1

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
+}

package/assets/hooks/skill-gate-layers.sh

@@ -20,6 +20,8 @@
 
 # Уже названное вторым разом не требуется: отказ, перечисляющий одно правило дважды, читается
 # как два разных требования.
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+
 rt_layer_add() {
     case " $req " in
         *" $1 "*) return 0 ;;

package/assets/hooks/skill-gate-rearm.sh

@@ -12,7 +12,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"
 [ -z "$input" ] && exit 0
 
 sid="$(printf '%s' "$input" | jq -r '.session_id // empty' 2>/dev/null)"

package/assets/hooks/skill-gate.sh

@@ -23,11 +23,15 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: любая ошибка и любой неопознанный путь пропускают правку (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
 
 sid="$(printf '%s' "$input" | jq -r '.session_id // "nosession"' 2>/dev/null)"
-tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
+tool="$(rt_hook_tool)"
 
 # Умолчание карты ищется и рядом с самим хуком: уезжают они вместе.
 rt_hooks_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
@@ -173,6 +177,25 @@ if [ -n "$law" ]; then
         && reason="Отбито гейтом правил: загрузи правило «${req}» инструментом Skill — оно применяет закон ${law_path} к этому дереву — и повтори действие. ${fallback} Для этой области это происходит один раз за сессию."
 fi
 
+# Статья, под которую подпадает эта правка. Правило весит от двадцати до шестидесяти килобайт,
+# и отказ, зовущий его целиком, платит за решение полной ценой правила. Статья говорит о своей
+# применимости сама — разбирает её помощник рядом; нет помощника или нет размеченных статей,
+# отказ остаётся прежним, и это тот же отказ в пользу работы, что и везде.
+#
+# Загрузку правила статья не отменяет: она снимает чтение правила целиком, а не сам отказ.
+# Правило целиком остаётся вторым ходом — для того, кому статьи мало.
+# shellcheck disable=SC1090
+[ -f "$rt_hooks_dir/rule-article.sh" ] && . "$rt_hooks_dir/rule-article.sh" 2>/dev/null
+if [ "$kind" != "command" ] && [ "$kind" != "browser" ] && command -v rt_rule_articles >/dev/null 2>&1; then
+    article="$(rt_rule_articles "$root/$rules_dir/${req}/SKILL.md" "$target" 2>/dev/null)"
+    if [ -n "$article" ]; then
+        reason="Отбито гейтом правил. Под эту правку подпадает статья правила «${req}»:
+
+${article}
+Статья снимает чтение правила целиком, а не отказ: загрузи правило «${req}» инструментом Skill и повтори действие. ${fallback} Для этой области это происходит один раз за сессию."
+    fi
+fi
+
 # Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть.
 # Файл может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
 # shellcheck disable=SC1090

package/assets/hooks/skill-loaded.sh

@@ -7,7 +7,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"
 [ -z "$input" ] && exit 0
 
 sid="$(printf '%s' "$input" | jq -r '.session_id // "nosession"' 2>/dev/null)"