@rt-tools/agent-kit 0.5.0 → 0.5.2

package/assets/hooks/grill-gate.sh

@@ -1,15 +1,18 @@
 #!/usr/bin/env bash
+# rt-hook: PreToolUse AskUserQuestion
 # rt-hook: Stop
-# Гард разговора: ход, в котором владельцу задан вопрос, не заканчивается, пока за этот же ход
-# не читались законы и правила. Stop.
+# Гард разговора: вопрос владельцу не задаётся, пока за этот же ход не читались законы и
+# правила. Стоит на двух событиях, и это не дублирование.
 #
-# Зачем именно так. Требование «правила читаются до разговора» записано в правиле ведения
-# работы, а исполнения у него не было: все прочие гарды судят правку файла или команду, а
-# вопрос в чат ни тем, ни другим не является. Поймать его можно только на завершении хода —
-# событие получает путь к записи хода и видит его целиком.
+# Зачем именно так. Требование «правила читаются до разговора» исполнимо ровно до отправки
+# вопроса. Проверка на завершении хода отбивает задним числом: к моменту отказа вопрос уже у
+# владельца, и владелец видит его вместе с отбитым ходом — требование срабатывает, но работу не
+# спасает. Поэтому ход с вопросом судится на инструменте вопроса, до отправки.
 #
-# Перехват инструмента меню вариантов эту дыру не закрывает: вопрос чаще задаётся прозой, и
-# ровно так был задан тот, из-за которого гард заведён.
+# Одним этим перехватом дыра не закрывается: вопрос чаще задаётся прозой, и ровно так был задан
+# тот, из-за которого гард заведён. Прозаический вопрос инструментом не является, и поймать его
+# можно только на завершении хода — событие получает путь к записи хода и видит его целиком.
+# Отсюда два события: меню ловится до отправки, проза — после.
 #
 # Чтением правил считается любой из трёх путей: загрузка правила, чтение файла законов или
 # правил, поиск по ним. Требовать именно загрузку значило бы гнать на неё там, где хватило
@@ -23,10 +26,13 @@ input="$(cat 2>/dev/null)"
 
 command -v jq >/dev/null 2>&1 || exit 0
 
+# Какое событие пришло. У вызова инструмента есть его имя, у завершения хода — нет.
+tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
+
 # Повторный заход по тому же ходу не судится: иначе ход не кончится никогда — гард сказал своё
-# один раз и отпускает.
+# один раз и отпускает. К вызову инструмента это не относится: там судится сам вызов.
 active="$(printf '%s' "$input" | jq -r '.stop_hook_active // false' 2>/dev/null)"
-[ "$active" = "true" ] && exit 0
+[ -z "$tool" ] && [ "$active" = "true" ] && exit 0
 
 transcript="$(printf '%s' "$input" | jq -r '.transcript_path // empty' 2>/dev/null)"
 [ -z "$transcript" ] && exit 0
@@ -61,7 +67,10 @@ read_re="$(printf '%s' "$laws_dir|$rules_dir|$specs_dir" | sed 's/^|*//; s/|*$//
 # бы.
 #
 # Хвост в 400 строк: запись хода растёт всю сессию, а судится только последний ход.
-verdict="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r --arg re "$read_re" '
+# На событии вызова инструмента вопрос уже известен — он и есть вызов; судится только то,
+# читались ли за этот ход правила. На завершении хода вопрос ищется в тексте реплик: меню к
+# этому моменту уже отбито раньше.
+verdict="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r --arg re "$read_re" --arg tool "$tool" '
     def is_input:
         .type == "user"
         and (((.message.content // []) | if type == "array"
@@ -78,19 +87,32 @@ verdict="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r --arg re "$read_re"
           or ((.name == "Bash") and ((.input.command // "") | test($re)))
       ) | any) as $read
     | (($texts | join("\n")) | test("\\?[[:space:]]*$"; "m")) as $asked_prose
-    | ($uses | map(.name == "AskUserQuestion") | any) as $asked_menu
-    | if ($asked_prose or $asked_menu) and ($read | not) then "ask" else "pass" end
+    | ($tool != "") as $asking_now
+    | if ($asked_prose or $asking_now) and ($read | not) then "ask" else "pass" end
 ' 2>/dev/null)"
 
 [ "$verdict" = "ask" ] || exit 0
 
-reason="BLOCKED by grill-gate: в ответе есть вопрос владельцу, а законы и правила за этот ход не читались. Вопрос, ответ на который уже записан, владельцу не задаётся — правило ведения работы. Прогони поиск по словам темы и ответь по найденному; спрашивай только то, что документацией не покрыто:
+if [ -n "$tool" ]; then
+    head="BLOCKED by grill-gate: вопрос владельцу ещё не ушёл, и это единственный момент, когда требование исполнимо."
+else
+    head="BLOCKED by grill-gate: в ответе есть вопрос владельцу, а законы и правила за этот ход не читались."
+fi
+
+reason="$head Вопрос, ответ на который уже записан, владельцу не задаётся — правило ведения работы. Прогони поиск по словам темы и ответь по найденному; спрашивай только то, что документацией не покрыто:
 
     grep -rn -i \"<слово темы>\" $laws_dir $rules_dir $specs_dir
 
 Гард судит один ход: следующий заход не отбивается."
 
-jq -n --arg r "$reason" '{decision:"block",reason:$r}' 2>/dev/null \
-    || printf '{"decision":"block","reason":"grill-gate: прочитай законы и правила по теме, прежде чем спрашивать владельца."}\n'
+# Форма отказа у двух событий разная: вызов инструмента отбивается решением о доступе, а
+# завершение хода — решением о ходе. Одна форма на оба события молча не срабатывает.
+if [ -n "$tool" ]; then
+    jq -n --arg r "$reason" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
+        || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"grill-gate: прочитай законы и правила по теме, прежде чем спрашивать владельца."}}\n'
+else
+    jq -n --arg r "$reason" '{decision:"block",reason:$r}' 2>/dev/null \
+        || printf '{"decision":"block","reason":"grill-gate: прочитай законы и правила по теме, прежде чем спрашивать владельца."}\n'
+fi
 
 exit 0

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

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PostToolUse Edit|Write|MultiEdit|Bash|mcp__webstorm__create_new_file
+# Требует: hooks/profile-check.sh
 # Линтер по следам правки. PostToolUse.
 #
 # Два входа. Правка файла — линтуется один изменённый файл. Перенос файла командой — линтуются
@@ -62,7 +63,13 @@ for profile in "$rt_hooks_dir/../rt-kit/defaults/project.sh" "$rt_hooks_dir/../d
     # shellcheck disable=SC1090
     [ -f "$profile" ] && . "$profile" 2>/dev/null
 done
-command -v rt_lint_for >/dev/null 2>&1 || exit 0
+
+# Слово о нехватке функции профиля: хук, вышедший молча, неотличим от работающего. Файл может
+# быть не разложен — тогда остаётся прежнее поведение, молчаливое.
+# shellcheck disable=SC1090
+[ -f "$rt_hooks_dir/profile-check.sh" ] && . "$rt_hooks_dir/profile-check.sh"
+command -v rt_needs >/dev/null 2>&1 || rt_needs() { command -v "$1" >/dev/null 2>&1; }
+rt_needs rt_lint_for lint-after-edit || exit 0
 
 # --- какие файлы проверяем -------------------------------------------------------------
 
@@ -133,7 +140,7 @@ fi
 # --- отсев того, что линтерами дерева не покрыто ----------------------------------------
 
 lintable() {
-    if command -v rt_is_app_code >/dev/null 2>&1; then
+    if rt_needs rt_is_app_code lint-after-edit; then
         rt_is_app_code "$1" || return 1
     fi
     if [ -n "${RT_LINT_SKIP_RE:-}" ] && printf '%s' "$1" | grep -qE "$RT_LINT_SKIP_RE"; then
@@ -156,7 +163,7 @@ linter_name() {
 
 # --- прогон -----------------------------------------------------------------------------
 
-push_checks="$(command -v rt_push_checks >/dev/null 2>&1 && rt_push_checks 2>/dev/null)"
+push_checks="$(rt_needs rt_push_checks lint-after-edit && rt_push_checks 2>/dev/null)"
 
 report=""
 linters=""

package/assets/hooks/observe.sh

@@ -0,0 +1,90 @@
+#!/usr/bin/env bash
+# Запись наблюдений о слое правил. НЕ гард: объявления `rt-hook:` у него нет, к событиям агента
+# он не подключается. Его источают гарды — тем же приёмом, каким гейт источает карту.
+#
+# Зачем он есть. Правки в тексты пакета шли из головы того, кто их пишет: чем из разложенного
+# пользуются каждый день, чем не пользовались ни разу и обо что спотыкаются по второму кругу,
+# пакету было неизвестно. Часть данных при этом уже собиралась и выбрасывалась — запись загрузок
+# жила во временном каталоге и гибла со сжатием контекста.
+#
+# ЧТО ЗАПИСЫВАЕТСЯ. Только имена ресурсов пакета и счётчики: имя правила или гарда, род события,
+# род файла, версия пакета и признак сессии. Ни путей дерева, ни имён его доменов, ни имени
+# самого дерева — и держится это не памятью зовущего, а `rt_observe_clean`: значение со слэшем
+# не пишется вовсе. Наблюдение уезжает потом в чужой репозиторий, и запрет называть чужое дерево
+# обязан держаться конструкцией.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ. Наблюдение — побочная работа гарда, и любая её поломка молча пропускает
+# действие: недоступный каталог, отсутствие `date`, полный диск. Гард, упавший на записи
+# наблюдения, останавливал бы работу ради статистики.
+
+# Значение, годное к записи. Путь не выносится ни при каких обстоятельствах, остальное чистится
+# до имени и обрезается: длинное значение в наблюдении не значит ничего, кроме утечки.
+rt_observe_clean() {
+    case "$1" in
+        */*) return 0 ;;
+    esac
+    printf '%s' "$1" | LC_ALL=C tr -cd 'A-Za-z0-9._:-' | cut -c1-48
+}
+
+# Признак сессии: считается по её имени и обратно не восстанавливается. Нужен, чтобы сводка
+# знала число заходов, а не только число событий.
+rt_observe_session() {
+    printf '%s' "$1" | cksum 2>/dev/null | cut -d' ' -f1
+}
+
+# Версия пакета, разложившего этот файл. Стоит в шапке, которую ставит раскладка; в исходниках
+# пакета шапки нет, и там версия — `dev`.
+rt_observe_version() {
+    local found
+    found="$(sed -n 's/^# rt-kit v\([^ ]*\) .*/\1/p' "${BASH_SOURCE[0]}" 2>/dev/null | head -1)"
+    printf '%s' "${found:-dev}"
+}
+
+# Каталог наблюдений этого дерева. Пустая строка — записи не будет.
+rt_observe_dir() {
+    local root="${CLAUDE_PROJECT_DIR:-.}" config
+    config="$root/.claude/rt-kit.json"
+    # Выключатель дерева гасит запись целиком, а не частями: пакет стоит и у тех, о ком мы не
+    # знаем. Нечитаемая настройка выключателем не считается — иначе сломанный JSON тихо
+    # выключал бы наблюдения, и понять это было бы нечем.
+    if [ -f "$config" ] && command -v jq >/dev/null 2>&1; then
+        [ "$(jq -r 'if .observe == false then "off" else "on" end' "$config" 2>/dev/null)" = "off" ] && return 0
+    fi
+    printf '%s' "$root/.claude/rt-kit/observations"
+}
+
+# Одно наблюдение: род события и пары `ключ=значение`. Ключ `sid` хешируется, остальные
+# чистятся. Пустое значение поля не заводит.
+#
+#   rt_note gate-deny res=styling-bem kind=scss sid="$sid"
+rt_note() {
+    local kind="$1" dir day stamp line pair key value
+    [ -n "$kind" ] || return 0
+    shift
+
+    dir="$(rt_observe_dir)"
+    [ -n "$dir" ] || return 0
+    mkdir -p "$dir" 2>/dev/null || return 0
+
+    day="$(date -u +%Y-%m-%d 2>/dev/null)" || return 0
+    stamp="$(date -u +%Y-%m-%dT%H:%M:%SZ 2>/dev/null)" || return 0
+    [ -n "$day" ] || return 0
+
+    line="{\"t\":\"$stamp\",\"ev\":\"$(rt_observe_clean "$kind")\""
+    for pair in "$@"; do
+        key="$(rt_observe_clean "${pair%%=*}")"
+        value="${pair#*=}"
+        [ -n "$key" ] || continue
+        if [ "$key" = "sid" ]; then
+            value="$(rt_observe_session "$value")"
+        else
+            value="$(rt_observe_clean "$value")"
+        fi
+        [ -n "$value" ] || continue
+        line="$line,\"$key\":\"$value\""
+    done
+    line="$line,\"v\":\"$(rt_observe_version)\"}"
+
+    printf '%s\n' "$line" >> "$dir/$day.jsonl" 2>/dev/null || return 0
+    return 0
+}

package/assets/hooks/postmortem-guard.sh

@@ -0,0 +1,92 @@
+#!/usr/bin/env bash
+# rt-hook: Stop
+# Гард происшествия: ход, в котором исполнитель признал промах, не заканчивается, пока записи о
+# происшествии нет. Stop.
+#
+# Зачем именно так. Происшествие — заход, в котором исполнитель сделал не то, а слой правил
+# этого не отбил, — исправляемого кода за собой не оставляет. Такой заход кончается извинением
+# в переписке: назавтра механизм промаха пересказывается уже приглаженно, остаются выводы, а из
+# выводов правило не выводится. Разбор случался только тогда, когда владелец требовал его вслух.
+#
+# Ловится признание образцами, а не пониманием смысла: оценку «это был промах» назначал бы тот,
+# кому она мешает, и порог плыл бы. Набор образцов виден, пополняется правкой и промахивается
+# заметно — заход, признавший промах словами вне набора, гард пропускает, и это сказано вслух в
+# договорённости, а не считается закрытым.
+#
+# Ловится на завершении хода, а не на отправке реплики: к моменту признания промах уже случился,
+# и ловить раньше нечего. Этим он отличается от гарда разговора, у которого есть свой инструмент
+# — вопрос владельцу.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ: при любой ошибке, отсутствии записи хода и повторном заходе ход
+# РАЗРЕШАЕТСЯ (exit 0). Сломанный гард не имеет права заклинить разговор.
+
+input="$(cat 2>/dev/null)"
+[ -z "$input" ] && exit 0
+
+command -v jq >/dev/null 2>&1 || exit 0
+
+# Повторный заход по тому же ходу не судится: гард сказал своё один раз и отпускает.
+active="$(printf '%s' "$input" | jq -r '.stop_hook_active // false' 2>/dev/null)"
+[ "$active" = "true" ] && exit 0
+
+transcript="$(printf '%s' "$input" | jq -r '.transcript_path // empty' 2>/dev/null)"
+[ -z "$transcript" ] && exit 0
+[ -f "$transcript" ] || exit 0
+
+root="${CLAUDE_PROJECT_DIR:-.}"
+
+# Каталог записей у дерева свой. Заданный пустым — отказ дерева от требования: дереву, которое
+# записей не ведёт, гард не навязывается.
+notes_dir="${RT_POSTMORTEMS_DIR-docs/postmortems}"
+[ -z "$notes_dir" ] && exit 0
+[ -d "$root/$notes_dir" ] || exit 0
+
+# Образцы признания промаха. Набор открыт и пополняется правкой: полнота его — открытый вопрос
+# договорённости, а не обещание.
+admitted_re='был неправ|был не прав|ошибс|моя ошибк|мой промах|промахнул|проглядел|не проверил|соврал|виноват|извин|прошу прощения|неверно утверждал|утверждение было ложн|принял на веру'
+
+# Ход — это всё, что записано после последнего настоящего ввода владельца. Ответ инструмента
+# приходит той же ролью, поэтому строки с `tool_result` вводом не считаются.
+#
+# Хвост в 400 строк: запись хода растёт всю сессию, а судится только последний ход.
+verdict="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r --arg re "$admitted_re" '
+    def is_input:
+        .type == "user"
+        and (((.message.content // []) | if type == "array"
+                then ([.[] | select(.type == "tool_result")] | length)
+                else 0 end) == 0);
+
+    (map(is_input) | rindex(true)) as $i
+    | (if $i == null then . else .[$i + 1:] end) as $turn
+    | [$turn[] | select(.type == "assistant") | (.message.content // [])[] | select(.type == "text") | .text] as $texts
+    | [$turn[] | select(.type == "assistant") | (.message.content // [])[] | select(.type == "tool_use")] as $uses
+    # Признак нечувствителен к регистру флагом, а не приведением: приведение знает только
+    # латиницу, и «Был неправ» с большой буквы проходило бы мимо набора образцов молча.
+    | (($texts | join("\n")) | test($re; "i")) as $admitted
+    | ($uses | map(
+          ((.name // "") | test("^(Write|Edit|MultiEdit)$"))
+          and ((.input.file_path // "") | test("postmortem"))
+      ) | any) as $wrote
+    | if $admitted and ($wrote | not) then "admit" else "pass" end
+' 2>/dev/null)"
+
+[ "$verdict" = "admit" ] || exit 0
+
+# Запись, сделанная за эту сессию, снимает требование и без правки в этом же ходе: разбор мог
+# лечь файлом ходом раньше — тем, в котором промах и признали.
+if [ -n "$(find "$root/$notes_dir" -name '*.md' -newermt '-1 day' 2>/dev/null | head -1)" ]; then
+    exit 0
+fi
+
+reason="BLOCKED by postmortem-guard: в ответе признан промах, а записи о происшествии в \`$notes_dir/\` за сегодня нет. Происшествие — заход, в котором исполнитель сделал не то, а слой правил этого не отбил, — записывается в тот же заход: назавтра механизм промаха пересказывается уже приглаженно, и правило из него не выводится.
+
+Запись называет: механизм промаха по шагам, что было доступно до него, чем ловилось и что из этого ушло в слой правил. Без последней строки это жалоба, а не разбор.
+
+    $notes_dir/<год>-<месяц>-<день>-<короткое имя>.md
+
+Гард судит один ход: следующий заход не отбивается."
+
+jq -n --arg r "$reason" '{decision:"block",reason:$r}' 2>/dev/null \
+    || printf '{"decision":"block","reason":"postmortem-guard: признан промах — запиши разбор происшествия."}\n'
+
+exit 0

package/assets/hooks/profile-check.sh

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+# Нехватка функции профиля, сказанная вслух. НЕ гард: объявления `rt-hook:` у него нет, к
+# событиям агента он не подключается. Его источают сами гарды — тем же приёмом, каким гейт
+# источает карту, а гарды — запись наблюдений.
+#
+# Зачем он есть. Девять хуков пакета зовут функции профиля дерева, и у пяти проверка стоит до
+# всякого поведения: нет функции — выход с нулём, не сделав ничего. Такой гард хуже
+# отсутствующего: он лежит в дереве, стоит в настройке, виден в списке хуков и читается как
+# работающий. Тишина при этом означает разом три разных вещи — «нечего проверять», «проверять
+# нечем» и «всё в порядке», — и отличить их нечем.
+#
+# ЧТО ГОВОРИТСЯ. Имя функции и файл, в котором её определяют. Один раз за сессию: на каждый
+# вызов та же строка повторялась бы десятки раз за заход и перестала бы читаться.
+#
+# ДЕЙСТВИЕ ВСЁ РАВНО ПРОПУСКАЕТСЯ. Хук сообщает о своей неполноте, а не судит правку: судить её
+# нечем, и отбивать работу из-за ненастроенного дерева он не вправе.
+
+# Куда кладётся отметка «об этом уже сказано». Каталог временных файлов, а не дерево: отметка
+# живёт один заход и в историю не едет.
+rt_needs_mark_dir() {
+    printf '%s' "${TMPDIR:-/tmp}"
+}
+
+# Есть ли функция профиля. Успех — есть, и хук работает дальше. Отказ — нет, и об этом сказано.
+#
+#   rt_needs rt_is_app_code task-flow-guard "$sid"
+#
+# Третий параметр — признак сессии, если хук его знает. Не знает — отметка кладётся на день:
+# без признака «один раз за сессию» превратилось бы в «один раз за всю жизнь машины».
+rt_needs() {
+    command -v "$1" >/dev/null 2>&1 && return 0
+
+    rt_needs_key="${3:-$(date +%Y%m%d 2>/dev/null || printf 'nosession')}"
+    rt_needs_mark="$(rt_needs_mark_dir)/rt-kit-needs-$1-$rt_needs_key"
+    if [ ! -f "$rt_needs_mark" ]; then
+        printf '%s: нет функции %s — её определяют в .claude/rt-kit/project.sh, а умолчание везёт пакет в .claude/rt-kit/defaults/project.sh\n' \
+            "${2:-хук}" "$1" >&2
+        printf 'проверка не работает, действие пропущено\n' >&2
+        : >"$rt_needs_mark" 2>/dev/null || true
+    fi
+
+    return 1
+}

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

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse Edit|Write|MultiEdit|mcp__webstorm__create_new_file
+# Требует: hooks/profile-check.sh
 # Гард якоря для спек. PreToolUse на правке разметки.
 #
 # Спеки адресуют элементы только через этот атрибут. Классы оформления меняются вместе с
@@ -56,10 +57,16 @@ for profile in "$rt_hooks_dir/../rt-kit/defaults/project.sh" "$rt_hooks_dir/../d
     [ -f "$profile" ] && . "$profile" 2>/dev/null
 done
 
+# Слово о нехватке функции профиля: хук, вышедший молча, неотличим от работающего. Файл может
+# быть не разложен — тогда остаётся прежнее поведение, молчаливое.
+# shellcheck disable=SC1090
+[ -f "$rt_hooks_dir/profile-check.sh" ] && . "$rt_hooks_dir/profile-check.sh"
+command -v rt_needs >/dev/null 2>&1 || rt_needs() { command -v "$1" >/dev/null 2>&1; }
+
 # Разметка приложения живёт там же, где его код. Без этой положительной проверки гард
 # распространялся на любой файл разметки на диске — черновик вне дерева отклонялся требованием
 # проставить якоря.
-if command -v rt_is_app_code >/dev/null 2>&1; then
+if rt_needs rt_is_app_code qa-dataid-guard; then
     rt_is_app_code "$path" || exit 0
 fi
 
@@ -75,7 +82,7 @@ added="$(printf '%s' "$input" | jq -r '
 ' 2>/dev/null)"
 [ -z "$added" ] && exit 0
 
-decorative="$(command -v rt_qa_decorative >/dev/null 2>&1 && rt_qa_decorative 2>/dev/null)"
+decorative="$(rt_needs rt_qa_decorative qa-dataid-guard && rt_qa_decorative 2>/dev/null)"
 component_re="${RT_QA_COMPONENT_RE:--}"
 
 # Открывающие теги разбираются ЦЕЛИКОМ: тег занимает несколько строк, и якорь часто стоит не в

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

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse Edit|Write|MultiEdit|mcp__webstorm__create_new_file
+# Требует: hooks/profile-check.sh
 # Гард «ничего не пишется с нуля». PreToolUse на правке кода и разметки.
 #
 # Линтеры знают правила, но не знают ИНВЕНТАРЬ: линтер стилей поймает сырой цвет, линтер кода —
@@ -61,11 +62,17 @@ for profile in "$rt_hooks_dir/../rt-kit/defaults/project.sh" "$rt_hooks_dir/../d
     # shellcheck disable=SC1090
     [ -f "$profile" ] && . "$profile" 2>/dev/null
 done
-command -v rt_reinvented_in >/dev/null 2>&1 || exit 0
+
+# Слово о нехватке функции профиля: хук, вышедший молча, неотличим от работающего. Файл может
+# быть не разложен — тогда остаётся прежнее поведение, молчаливое.
+# shellcheck disable=SC1090
+[ -f "$rt_hooks_dir/profile-check.sh" ] && . "$rt_hooks_dir/profile-check.sh"
+command -v rt_needs >/dev/null 2>&1 || rt_needs() { command -v "$1" >/dev/null 2>&1; }
+rt_needs rt_reinvented_in reuse-first-guard || exit 0
 
 # Правила этого дерева действуют на код этого дерева: без положительной проверки гард требовал
 # бы собирать готовым и в черновике за пределами дерева.
-if command -v rt_is_app_code >/dev/null 2>&1; then
+if rt_needs rt_is_app_code reuse-first-guard; then
     rt_is_app_code "$path" || exit 0
 fi
 

package/assets/hooks/skill-gate.sh

@@ -38,6 +38,7 @@ command -v skill_for >/dev/null 2>&1 || exit 0
 
 req=""
 target=""
+kind=""
 case "$tool" in
     # Инструмент среды заводит файл теми же двумя данными, только называет их иначе — без этой
     # ветки файл заводился мимо гейта.
@@ -61,6 +62,12 @@ case "$tool" in
         # приходит в обычный сервис, а число-настройка в обычный класс.
         written="$(printf '%s' "$input" | jq -r '[.tool_input.content, .tool_input.text, .tool_input.new_string, (.tool_input.edits[]?.new_string)] | map(select(. != null)) | join("\n")' 2>/dev/null)"
         req="$(skill_for edit "$target" "$written" 2>/dev/null)"
+        # Род правки для наблюдения. Одно расширение, без пути и без имени файла: наблюдение
+        # уезжает наружу, и всё, кроме рода, там было бы адресом этого дерева.
+        case "${target##*/}" in
+            *.*) kind="${target##*.}" ;;
+            *) kind="none" ;;
+        esac
         ;;
     # Терминал среды исполняет ту же командную строку и кладёт её в то же поле: без этой ветки
     # коммит из него не требовал правила, тогда как тот же коммит из оболочки требовал.
@@ -77,9 +84,11 @@ case "$tool" in
             [ -n "$inner" ] && target="$inner"
         fi
         req="$(skill_for bash "$target" "" 2>/dev/null)"
+        kind="command"
         ;;
     mcp__claude-in-chrome__*)
         req="$(skill_for browser "$tool" "" 2>/dev/null)"
+        kind="browser"
         ;;
     *) exit 0 ;;
 esac
@@ -108,6 +117,12 @@ done
 [ -z "$want" ] && exit 0
 req="$want"
 
+# Отбитие — наблюдение: правило, которое приходится требовать чаще прочего, и род правки, на
+# котором это происходит, говорят о слое правил больше, чем список загруженного.
+# 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 gate-deny "res=$req" "kind=$kind" "sid=$sid"
+
 reason="Отбито гейтом правил: загрузи правило «${req}» инструментом Skill и повтори действие. Для этой области это происходит один раз за сессию."
 
 # Правило называет свой закон одним словом, а слоёв законов два: общий лежит в корне, закон

package/assets/hooks/skill-loaded.sh

@@ -18,4 +18,11 @@ dir="${TMPDIR:-/tmp}/claude-skill-gate"
 mkdir -p "$dir" 2>/dev/null || exit 0
 printf '%s\n' "$skill" >> "$dir/${sid}.loaded" 2>/dev/null
 
+# Та же загрузка вторым адресом — в наблюдения дерева. Запись выше живёт до сжатия контекста и
+# гибнет вместе с ним: она отвечает гейту на вопрос «загружено ли», и больше ни на что.
+rt_hooks_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# 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 skill-load "res=$skill" "sid=$sid"
+
 exit 0

package/assets/hooks/task-context-load.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: SessionStart startup|resume|compact|clear
+# Требует: hooks/profile-check.sh
 # SessionStart: состояние незаконченной работы уезжает в контекст на каждом запуске сессии.
 #
 # Памятью это не держится по той же причине, что и словарь: замысел читают перед правкой
@@ -28,6 +29,12 @@ for profile in "$rt_hooks_dir/../rt-kit/defaults/project.sh" "$rt_hooks_dir/../d
     [ -f "$profile" ] && . "$profile" 2>/dev/null
 done
 
+# Слово о нехватке функции профиля: хук, вышедший молча, неотличим от работающего. Файл может
+# быть не разложен — тогда остаётся прежнее поведение, молчаливое.
+# shellcheck disable=SC1090
+[ -f "$rt_hooks_dir/profile-check.sh" ] && . "$rt_hooks_dir/profile-check.sh"
+command -v rt_needs >/dev/null 2>&1 || rt_needs() { command -v "$1" >/dev/null 2>&1; }
+
 TASKS_DIR="${RT_TASKS_DIR:-docs/tasks}"
 [ -z "$TASKS_DIR" ] && exit 0
 
@@ -43,13 +50,20 @@ emit() {
 # Ветка под задачу без папки — работа идёт мимо. Сессию не рвём: SessionStart, отбивающий
 # запуск, оставляет владельца без агента вовсе, а правку кода поймает `task-flow-guard`.
 if [ ! -d "$DIR" ]; then
-    if command -v rt_task_branch_ok >/dev/null 2>&1 && rt_task_branch_ok "$branch"; then
+    if rt_needs rt_task_branch_ok task-context-load && rt_task_branch_ok "$branch"; then
         {
             printf 'РАБОТА БЕЗ ПАПКИ ЗАДАЧИ.\n\n'
             printf 'Ветка `%s` названа задачей, а `%s/` нет: ход работы записывать некуда,\n' "$branch" "$DIR"
             printf 'и следующий заход начнёт с расспросов владельца.\n\n'
             printf 'Собрать с образца:\n\n    cp -r %s/_template %s\n\n' "$TASKS_DIR" "$DIR"
-            printf 'Правку кода приложения до этого отбивает гард. Правило — скил `task-flow`.\n'
+            # О соседнем ресурсе — условно и по имени: пакет не знает, разложен ли он здесь,
+            # а сказанное безусловно приходит в контекст каждой сессии и врёт про дерево тем
+            # увереннее, что печатает это сам инструмент.
+            if [ -f "$rt_hooks_dir/task-flow-guard.sh" ]; then
+                printf 'Правку кода приложения до этого отбивает гард `task-flow-guard`. Правило — скил `task-flow`.\n'
+            else
+                printf 'Правило — скил `task-flow`. Гарда `task-flow-guard` в дереве нет: правку кода до этого не отбивает ничто.\n'
+            fi
         } | emit
     fi
     exit 0

package/assets/hooks/task-flow-guard.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse Edit|Write|MultiEdit
+# Требует: hooks/profile-check.sh
 # PreToolUse guard for Edit|Write|MultiEdit: код не пишется раньше замысла.
 #
 # Работа идёт много заходов, и между ними исполнитель не помнит ничего. Замысел, лежащий на
@@ -45,11 +46,17 @@ for profile in "$rt_hooks_dir/../rt-kit/defaults/project.sh" "$rt_hooks_dir/../d
     [ -f "$profile" ] && . "$profile" 2>/dev/null
 done
 
+# Слово о нехватке функции профиля: хук, вышедший молча, неотличим от работающего. Файл может
+# быть не разложен — тогда остаётся прежнее поведение, молчаливое.
+# shellcheck disable=SC1090
+[ -f "$rt_hooks_dir/profile-check.sh" ] && . "$rt_hooks_dir/profile-check.sh"
+command -v rt_needs >/dev/null 2>&1 || rt_needs() { command -v "$1" >/dev/null 2>&1; }
+
 # Признак «правка меняет поведение» — путь, а не оценка на глаз: оценку назначает тот, кому
 # она мешает, и порог плывёт. Где живёт код приложения, знает профиль: правила, тексты, обвязка
 # и зависимости под требование не попадают — иначе разбор задачи нельзя было бы вести до
 # заведения ветки.
-command -v rt_is_app_code >/dev/null 2>&1 || exit 0
+rt_needs rt_is_app_code task-flow-guard || exit 0
 rt_is_app_code "$path" || exit 0
 
 # Каталог папок задач: у дерева он свой, но имя обычно общее.
@@ -70,7 +77,7 @@ 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   # detached HEAD — не про наш случай
 
-if command -v rt_task_branch_ok >/dev/null 2>&1 && ! rt_task_branch_ok "$branch"; then
+if rt_needs rt_task_branch_ok task-flow-guard && ! rt_task_branch_ok "$branch"; then
     deny "BLOCKED by task-flow: правка кода идёт в ветке под задачу, а текущая ветка — '${branch}'. Заведи задачу (npm run task:new -- --title '…' --slug <slug>) и ветку под её номером, затем повтори. Правило — скил task-flow."
 fi