@rt-tools/agent-kit 0.9.1 → 0.11.0

package/assets/hooks/handoff-write.sh

@@ -0,0 +1,103 @@
+#!/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
+
+input="$(cat 2>/dev/null)"
+[ -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="$(printf '%s' "$input" | jq -r '.cwd // empty' 2>/dev/null)"
+[ -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
+
+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'
+
+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/$branch.md"
+
+{
+    printf '# Передача захода — сжатие контекста (%s)\n\n' "$trigger"
+    printf '**Рабочее дерево:** %s\n' "$root"
+    printf '**Ветка:** %s\n\n' "$branch"
+
+    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"
+    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/lint-after-edit.sh

@@ -29,6 +29,8 @@
 
 # Сколько файлов линтуется за один перенос. Переезд либы трогает десятки файлов, и прогон по
 # каждому превратил бы хук в минутную паузу; на нарушение границы хватает первых.
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+
 MAX_FILES=12
 
 input="$(cat 2>/dev/null)"

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

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: Stop
+# Требует: hooks/deny-tail.sh
 # Гард происшествия: ход, в котором исполнитель признал промах, не заканчивается, пока записи о
 # происшествии нет. Stop.
 #
@@ -20,6 +21,8 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: при любой ошибке, отсутствии записи хода и повторном заходе ход
 # РАЗРЕШАЕТСЯ (exit 0). Сломанный гард не имеет права заклинить разговор.
 
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+
 input="$(cat 2>/dev/null)"
 [ -z "$input" ] && exit 0
 
@@ -86,6 +89,17 @@ reason="BLOCKED by postmortem-guard: в ответе признан промах
 
 Гард судит один ход: следующий заход не отбивается."
 
+# Общий хвост отказа: два законных хода. Файл может быть не разложен — тогда хвоста нет,
+# а причина отказа остаётся прежней.
+# 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":"postmortem-guard: признан промах — запиши разбор происшествия."}\n'
 

package/assets/hooks/proposal-guard.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: Stop
+# Требует: hooks/deny-tail.sh
 # Гард предложения: ход, в котором владелец сказал завести или отправить предложение слою правил,
 # не заканчивается, пока отправки не было. Stop.
 #
@@ -19,6 +20,8 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: при любой ошибке, нехватке `jq`, отсутствии записи хода и повторном
 # заходе ход РАЗРЕШАЕТСЯ (exit 0). Сломанный гард не имеет права заклинить разговор.
 
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+
 input="$(cat 2>/dev/null)"
 [ -z "$input" ] && exit 0
 
@@ -87,6 +90,17 @@ reason="BLOCKED by proposal-guard: владелец сказал завести
 
 Гард судит один ход: следующий заход не отбивается."
 
+# Общий хвост отказа: два законных хода. Файл может быть не разложен — тогда хвоста нет,
+# а причина отказа остаётся прежней.
+# 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":"proposal-guard: владелец просил предложение — отправь его командой пакета."}\n'
 

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

@@ -0,0 +1,75 @@
+#!/usr/bin/env bash
+# rt-hook: PreToolUse Edit|Write|MultiEdit
+# Требует: checks/check-prose-style.mjs, hooks/deny-tail.sh
+# Гард слога: канцелярит и слова, которых в этом дереве не пишут, не уезжают в файл.
+#
+# Правило о текстах требует простых слов, а держалось это памятью того, кто пишет: ни одна
+# формулировочная договорённость не проверялась. Владелец читает написанное и видит машинный
+# слог там, где договорённость требует человеческого.
+#
+# Судится только новый текст правки, а не файл целиком: накопленное чинится отдельной работой, и
+# отбивать за него правку соседней строки — значит сделать гард обходимым по необходимости.
+#
+# FAIL-OPEN: нет узла, нет проверки, чужой инструмент, не `.md` → пропуск.
+
+. "$(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
+command -v node >/dev/null 2>&1 || exit 0
+
+tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
+case "$tool" in
+    Edit | Write | MultiEdit) ;;
+    *) exit 0 ;;
+esac
+
+path="$(printf '%s' "$input" | jq -r '.tool_input.file_path // empty' 2>/dev/null)"
+case "$path" in
+    *.md) ;;
+    *) exit 0 ;;
+esac
+
+# Описание прошлого и папки задач не судятся: архив не правится вовсе, а ход работы пишется
+# наспех и живёт до слияния.
+case "$path" in
+    */docs/archive/* | */docs/tasks/*) exit 0 ;;
+esac
+
+added="$(printf '%s' "$input" | jq -r '.tool_input.new_string // .tool_input.content // ([.tool_input.edits[]?.new_string] | join("\n")) // empty' 2>/dev/null)"
+[ -z "$added" ] && exit 0
+
+rt_hooks_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+check=""
+for candidate in "$rt_hooks_dir/../checks/check-prose-style.mjs" "$rt_hooks_dir/../rt-kit/checks/check-prose-style.mjs" "${CLAUDE_PROJECT_DIR:-.}/tools/check-prose-style.mjs"; do
+    [ -f "$candidate" ] && check="$candidate" && break
+done
+[ -z "$check" ] && exit 0
+
+tmp="$(mktemp -t prose)" || exit 0
+printf '%s\n' "$added" > "$tmp"
+found="$(node "$check" "$tmp" 2>&1 | grep -- '—' | sed 's|.*proba*[^:]*:|  строка |' | head -8)"
+rm -f "$tmp"
+[ -z "$found" ] && exit 0
+
+reason="BLOCKED by prose-style-guard: в новом тексте канцелярит или слово, которого в этом дереве не пишут.
+
+${found}
+
+Правь текст, а не обходи находку: замена названа у каждой. Слог — правило о текстах, и проверка видит перечисленные признаки, а не стиль вообще: чистый по ней абзац может быть плохим, но грязный плохой точно."
+
+# Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть.
+# Файл может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+# 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" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
+    || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"prose-style-guard: канцелярит в новом тексте."}}\n'
+exit 0

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

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse Edit|Write|MultiEdit|mcp__webstorm__create_new_file
-# Требует: hooks/profile-check.sh
+# Требует: hooks/profile-check.sh, hooks/deny-tail.sh
 # Гард якоря для спек. PreToolUse на правке разметки.
 #
 # Спеки адресуют элементы только через этот атрибут. Классы оформления меняются вместе с
@@ -25,6 +25,8 @@
 #
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: нет разборщика, битый ввод, чужой инструмент — пропуск.
 
+. "$(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
@@ -122,6 +124,17 @@ missing="$(printf '%s' "$added" | RT_QA_DECORATIVE="$decorative" RT_QA_COMPONENT
 
 reason="BLOCKED: интерактивные элементы без якоря для спек в ${path##*/}: ${missing}. Спеки адресуют элементы только через этот атрибут: классы оформления меняются вместе с вёрсткой, а поиск по роли и тексту ломается на переводах — оба вида селекторов делают сквозные спеки хрупкими. Проставь якорь через дефис по смыслу элемента; повторяющиеся элементы списка носят ОДИН якорь и различаются атрибутами данных. Если элемент чисто декоративный и спека его никогда не тронет — поставь атрибут пропуска НА САМ ЭТОТ ТЕГ, соседние элементы правки при этом продолжают проверяться."
 
+# Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть.
+# Файл может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+# 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" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
     || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Интерактивный элемент без якоря для спек."}}\n'
 

package/assets/hooks/rerun-guard.sh

@@ -0,0 +1,88 @@
+#!/usr/bin/env bash
+# rt-hook: PreToolUse Bash|mcp__webstorm__execute_terminal_command|mcp__webstorm__execute_tool
+# Требует: hooks/deny-tail.sh
+# Гард перезапуска прогона: упавшее задание не перезапускается, пока его журнал не прочитан.
+#
+# Красное на прогоне бывает двух родов, и со стороны списка они выглядят одинаково: отказ
+# хостинга на шаге подготовки — раннер не скачал действие, ответ `429` — и дефект самой ветки.
+# Первый лечится перезапуском, второй перезапуском не лечится вовсе: та же ветка падает тем же
+# местом, и круг повторяется, пока кто-нибудь не откроет журнал. Три прогона одного дня так и
+# перезапускались подряд.
+#
+# Гард судит ПОРЯДОК, а не причину падения: журнал раньше перезапуска. Что в журнале написано,
+# он не читает и читать не может — красное по существу судит человек.
+#
+# Признак чтения — вызов за тот же ход, показывающий журнал этого задания: номер задания в
+# команде тот же, что и в перезапуске. Номер сверяется, потому что прочитанный журнал соседнего
+# задания о нашем не говорит ничего, а по списку прогонов они стоят рядом.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ: нет `jq`, нет записи хода, номер задания в команде не назван, вызов не
+# похож на перезапуск — пропуск. Гард без номера судить не берётся: перезапуск последнего
+# упавшего прогона зовут и без него, а угадывать, о каком задании речь, значит отбивать наугад.
+
+. "$(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
+
+tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
+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)"
+[ -z "$cmd" ] && 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
+
+# Вызов перезапуска: слово перезапуска отдельным словом рядом со словом прогона.
+host_cli="${RT_HOST_CLI:-gh}"
+printf '%s' "$cmd" | grep -qE "(^|[;&|(]|&&|\|\|)[[:space:]]*${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
+
+# Номер задания. Не назван — гард молчит: судить не о чем.
+run_id="$(printf '%s' "$cmd" | grep -oE '(^|[[:space:]])[0-9]{6,}([[:space:]]|$)' | tr -d ' ' | head -1)"
+[ -z "$run_id" ] && exit 0
+
+transcript="$(printf '%s' "$input" | jq -r '.transcript_path // empty' 2>/dev/null)"
+[ -z "$transcript" ] && exit 0
+[ -f "$transcript" ] || exit 0
+
+# Читался ли журнал ЭТОГО задания за тот же ход. Ход — вызовы после последней реплики владельца:
+# журнал, прочитанный вчера, о сегодняшнем состоянии прогона не говорит ничего.
+seen="$(jq -s -r --arg id "$run_id" '
+    [.[] | select(.type == "assistant") | (.message.content // [])[] | select(.type == "tool_use")
+       | ((.input.command // "") | tostring)] as $used
+    | (($used | join("\n")) | test("run[[:space:]]+view[^\\n]*" + $id + "|" + $id + "[^\\n]*--log")) as $read
+    | if $read then "читал" else "не-читал" end
+' "$transcript" 2>/dev/null)"
+
+[ "$seen" = "читал" ] && exit 0
+
+reason="BLOCKED by rerun-guard: перезапуск задания ${run_id} без прочитанного журнала. Красное на прогоне бывает двух родов, и в списке они выглядят одинаково: отказ хостинга на шаге подготовки лечится перезапуском, дефект ветки — не лечится им вовсе, и круг повторяется, пока журнал не открыт. Прочитай журнал этого задания — ${host_cli} run view ${run_id} --log-failed — и повтори вызов. Гард судит порядок, а не причину падения: что в журнале написано, судишь ты."
+
+# Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть.
+# Файл может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+# 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" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
+    || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"rerun-guard: журнал задания за этот ход не читался."}}\n'
+exit 0

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

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse Edit|Write|MultiEdit|Bash|mcp__webstorm__create_new_file|mcp__webstorm__execute_terminal_command|mcp__webstorm__execute_tool
-# Требует: hooks/profile-check.sh
+# Требует: hooks/profile-check.sh, hooks/deny-tail.sh
 # Гард «ничего не пишется с нуля». PreToolUse на правке кода и разметки.
 #
 # Линтеры знают правила, но не знают ИНВЕНТАРЬ: линтер стилей поймает сырой цвет, линтер кода —
@@ -32,6 +32,8 @@
 #
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: нет разборщика, битый ввод, чужой инструмент — пропуск.
 
+. "$(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
@@ -312,6 +314,17 @@ ${found}
 Порядок действий: 1) открой готовое — барель кита или базовый класс — и используй его; 2) найди в дереве экран, где этот случай уже собран, и повтори сборку; 3) если готового правда не хватает — расширяй его на месте, у готового, а не клонируй рядом: клон забирает правки на себя и расходится с оригиналом с первой же.
 Свой примитив, своя основа и свои инлайновые стили заводятся только с явного одобрения владельца, и спрашивается это до первого написанного файла. Разовое исключение помечается маркером отступления в той же строке, с объяснением, чего именно нет в готовом. Переименованием файла это не обходится."
 
+# Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть.
+# Файл может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+# 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" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
     || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Написано своё там, где готовое уже есть."}}\n'
 

package/assets/hooks/roles.sh

@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+# Состояние роли слоя правил. НЕ гард: объявления `rt-hook:` у него нет, к событиям агента он не
+# подключается. Его источают гарды, стоящие при ролях, — тем же приёмом, каким гейт источает
+# карту, а гарды — профиль дерева.
+#
+# Зачем он есть. Роль, при которой стоит гард, зовётся не по усмотрению исполнителя: гард держит
+# работу, пока роль не сказала своё. Выключить её было нечем — отказ от файла роли в настройке
+# убирал роль и оставлял гард, и дереву, которому роль в эту минуту мешает, оставалось вырезать
+# гард из настроек руками. Теперь дерево называет выключенные роли одним списком, а гард при
+# такой роли выходит молча.
+#
+# Выключается обязательность вызова, а не сама роль: файл роли остаётся разложенным, и позвать
+# её руками можно в любую минуту.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ наоборот: всё, чего не хватило, читается как «роль включена». Нет `jq`,
+# нет настройки, настройка не разбирается — гард работает, как работал. Сломанное чтение,
+# гасящее роль, выключало бы слой правил молча, и заметить это было бы нечем.
+
+# Выключена ли роль. Успех — выключена.
+#
+#   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
+    command -v jq >/dev/null 2>&1 || return 1
+    config="${CLAUDE_PROJECT_DIR:-.}/.claude/rt-kit.json"
+    [ -f "$config" ] || return 1
+    [ "$(jq -r --arg role "$role" '
+        if ((.rolesOff // []) | type) == "array" and (((.rolesOff // []) | index($role)) != null)
+        then "off" else "on" end
+    ' "$config" 2>/dev/null)" = "off" ]
+}

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,6 +12,8 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: любая ошибка пропускает. Хук удаляет временный файл и ничего не
 # отбивает.
 
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+
 input="$(cat 2>/dev/null)"
 [ -z "$input" ] && exit 0
 

package/assets/hooks/skill-gate.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse Edit|Write|MultiEdit|Bash|mcp__webstorm__create_new_file|mcp__webstorm__execute_terminal_command|mcp__webstorm__execute_tool|mcp__claude-in-chrome__.*
+# Требует: hooks/deny-tail.sh
 # Гейт правил: не даёт править файл, пока не загружено правило, под которое он подпадает.
 #
 # Закон и правило, которых никто не открывает, не действуют. Напоминание в подсказке помогает
@@ -22,6 +23,8 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: любая ошибка и любой неопознанный путь пропускают правку (exit 0).
 # Сломанный гейт не имеет права остановить работу совсем.
 
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+
 input="$(cat 2>/dev/null)"
 [ -z "$input" ] && exit 0
 
@@ -172,6 +175,17 @@ if [ -n "$law" ]; then
         && reason="Отбито гейтом правил: загрузи правило «${req}» инструментом Skill — оно применяет закон ${law_path} к этому дереву — и повтори действие. ${fallback} Для этой области это происходит один раз за сессию."
 fi
 
+# Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть.
+# Файл может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+# 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" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
     || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Загрузи правило %s и повтори."}}\n' "$req"
 

package/assets/hooks/skill-loaded.sh

@@ -7,6 +7,8 @@
 #
 # Хук только наблюдает: он всегда пропускает и ничего не отбивает.
 
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+
 input="$(cat 2>/dev/null)"
 [ -z "$input" ] && exit 0
 

package/assets/hooks/sql-guard-parse.sh

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

package/assets/hooks/sql-guard-request.sh

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

package/assets/hooks/sql-guard-target.sh

@@ -18,6 +18,8 @@
 # подключения, и по одному SQL отличить прод от локальной копии невозможно. Поэтому
 # подключения опознаются в лицо. Список сверяется вызовом list_database_connections;
 # добавили новое — допишите сюда, иначе оно попадёт в «неизвестные» ниже.
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+
 sql_resolve_target() {
     is_prod=""
     PROD_CONNECTIONS="${RT_PROD_CONNECTIONS:-}"

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

@@ -7,6 +7,8 @@
 
 # Глаголы ищутся в сегментах ВЫЗОВА, а не по всей строке: иначе слово из шаблона поиска в
 # соседнем звене цепочки объявляло записью читающую команду.
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+
 sql_detect_write() {
     is_write=""
     write_scope="$segments"
@@ -67,7 +69,8 @@ verdict() {
     if [ -n "$soft" ]; then
         ask "Запрос помечен маркером destructive-ok, но остаётся разрушительным: $1 Подтверди выполнение, если это осознанно."
     fi
-    deny "BLOCKED: $1 Адресуй строки по первичному ключу — \`WHERE id IN ('…','…')\`: так затрагивается ровно столько строк, сколько перечислено, и промах виден до выполнения. Удаление по маске (email LIKE '%test%') однажды унесло вместе с тестовыми записями демонстрационные брони владельца. Если адресация по id действительно не подходит — сначала выполни SELECT с тем же условием, покажи пользователю, что попадает под удаление, и помечай запрос маркером destructive-ok с объяснением."
+    deny "BLOCKED: $1 Адресуй строки по первичному ключу — \`WHERE id IN ('…','…')\`: так затрагивается ровно столько строк, сколько перечислено, и промах виден до выполнения. Удаление по маске (email LIKE '%test%') однажды унесло вместе с тестовыми записями демонстрационные брони владельца. Если адресация по id действительно не подходит — сначала выполни SELECT с тем же условием и покажи пользователю, что попадает под удаление." \
+        "маркер destructive-ok при запросе, с объяснением"
 }
 
 sql_check_destructive() {

package/assets/hooks/sql-guard.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse Bash|mcp__webstorm__execute_sql_query|mcp__webstorm__execute_terminal_command|mcp__webstorm__execute_tool
+# Требует: hooks/deny-tail.sh
 # Гард пишущих запросов к хранилищу. PreToolUse.
 #
 # Правка данных — единственное действие, которое нельзя откатить правкой кода. Удаление по
@@ -39,6 +40,8 @@
 # пропускаются целиком — иначе слова «drop» и «update» в описании коммита читались бы как
 # запрос. Доставки запроса внутри такой команды не бывает, так что цена послабления нулевая.
 
+. "$(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
@@ -69,8 +72,18 @@ done
 
 PROD_DSN="${RT_PROD_DSN:-}"
 
+# Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть. Файл
+# может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+# 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() {
-    jq -n --arg r "$1" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
+    reason="$1"
+    tail_text="$(rt_deny_tail "$2")"
+    [ -n "$tail_text" ] && reason="$1 ${tail_text}"
+    jq -n --arg r "$reason" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
         || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Destructive SQL blocked. Address rows by id."}}\n'
     exit 0
 }