@rt-tools/agent-kit 0.3.0 → 0.5.0

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

@@ -1,4 +1,5 @@
 #!/usr/bin/env bash
+# rt-hook: PreToolUse Bash|mcp__webstorm__execute_terminal_command|mcp__webstorm__execute_tool
 # Гард проверок перед пушем. PreToolUse на вызове пуша.
 #
 # Пуш — это вход в конвейер: слияние в главную ветку запускает выкатку, и всё, что не
@@ -6,13 +7,20 @@
 # выборочном прогоне и красные в конвейере: один раз прогонялись только сквозные спеки, другой
 # — только затронутый проект.
 #
-# Гард не верит на слово: он сам гоняет то, что перечислил профиль проекта, и пускает пуш
-# только при нулевом коде возврата. Если прогонщик кэширует результат, набор на неизменившемся
-# дереве занимает секунды, а после правки гоняется заново.
+# Гард не верит на слово: он сам гоняет то, что перечислил профиль дерева, и пускает пуш только
+# при нулевом коде возврата. Если прогонщик кэширует результат, набор на неизменившемся дереве
+# занимает секунды, а после правки гоняется заново.
 #
-# Что гонять, знает профиль: {{projectProfile}}, функция `rt_push_checks` — по команде на
-# строку. Нет профиля или нет функции — гард пропускает: список проверок пакет выдумать не
-# может.
+# Что гонять, знает профиль: функция `rt_push_checks <база>` — по команде на строку. База —
+# ветка, относительно которой считается вклад; пустая означает, что удалённого нет. Функция
+# зовётся из каталога, откуда идёт пуш, и вправе решать по нему сама: шаг, проверки которого в
+# дереве нет, она просто не печатает. Нет профиля или нет функции — гард пропускает: список
+# проверок пакет выдумать не может.
+#
+# База берётся у удалённого, а не у локальной главной ветки: локальная отстаёт или расходится
+# молча. Это уже случалось — локальная стояла на слиянии, стёртом из истории силовым пушем, и
+# набор от неё посчитался бы не тот. Нет сети или нет удалённого — база пустая, и профиль
+# откатывается на полный прогон: гейт может оказаться строже нужного, но НИКОГДА не слабее.
 #
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: не репозиторий, битый ввод, нет профиля — пропуск.
 
@@ -21,6 +29,7 @@ input="$(cat 2>/dev/null)"
 
 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
@@ -40,13 +49,25 @@ 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
+[ -f package.json ] || exit 0
 
-profile="${CLAUDE_PROJECT_DIR:-.}/{{projectProfile}}"
-[ -f "$profile" ] || exit 0
-# shellcheck disable=SC1090
-. "$profile" 2>/dev/null || exit 0
+# Профиль дерева: сперва умолчание пакета, поверх него — надстройка проекта, если она есть.
+# Объявленная в надстройке функция замещает умолчание целиком и вправе позвать его обратно
+# суффиксом `_default`. Нет ни того ни другого — хук пропускает: пустой гард лучше гарда,
+# отбивающего наугад.
+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
 command -v rt_push_checks >/dev/null 2>&1 || exit 0
 
+main_branch="${RT_MAIN_BRANCH:-main}"
+base=''
+if git fetch --quiet origin "$main_branch" 2>/dev/null && git rev-parse --verify --quiet "origin/$main_branch" >/dev/null 2>&1; then
+    base="origin/$main_branch"
+fi
+
 failed=""
 output=""
 while IFS= read -r check; do
@@ -56,14 +77,14 @@ while IFS= read -r check; do
     output="$out"
     break
 done <<EOF
-$(rt_push_checks)
+$(rt_push_checks "$base")
 EOF
 
 [ -z "$failed" ] && exit 0
 
 # Хвост вывода, а не весь: у прогонщика он длинный, а нужна причина отказа.
-tail_out="$(printf '%s' "$output" | tail -n 40)"
-reason="Отбито перед пушем: «${failed}» упала. Пуш — вход в конвейер, и красное отсюда проверяется уже на проде. Почини и повтори.
+tail_out="$(printf '%s' "$output" | tail -n 40 | tr -d '\000')"
+reason="BLOCKED: пуш без зелёного локального прогона. «${failed}» упала — почини и пушь снова, обходить гард нельзя. Пуш — вход в конвейер, и красное отсюда проверяется уже на проде. Хвост вывода:
 
 ${tail_out}"
 

package/assets/hooks/glossary-load.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+# rt-hook: SessionStart startup|resume|compact|clear
+# SessionStart: словарь проекта уезжает в контекст целиком, на каждом запуске сессии.
+#
+# Памятью это не держится: словарь читают перед тем, как написать текст, а разговор с
+# владельцем идёт без чтения — и слово из левой колонки «Так не пишем» всплывает в ответе,
+# хотя в файлах его уже нет. Здесь словарь приходит до первой реплики и действует и на
+# тексты, и на ответы.
+#
+# FAIL-OPEN: нет файла или нет `jq` — выходим молча. Сессия важнее словаря.
+
+GLOSSARY="${CLAUDE_PROJECT_DIR:-.}/docs/GLOSSARY.md"
+[ -f "$GLOSSARY" ] || exit 0
+command -v jq >/dev/null 2>&1 || exit 0
+
+{
+    printf 'СЛОВАРЬ ПРОЕКТА — `docs/GLOSSARY.md`, ниже целиком.\n\n'
+    printf 'Слово отсюда употребляется в том значении, что здесь: и в файлах, и в ответах владельцу.\n'
+    printf 'Раздел «Так не пишем» действует так же — левая колонка не пишется и не произносится нигде.\n'
+    printf 'Слова, которого здесь нет, у читателя нет тоже: оно либо заводится здесь же той же правкой,\n'
+    printf 'либо заменяется тем, что уже есть.\n\n'
+    cat "$GLOSSARY"
+} | jq -Rs '{hookSpecificOutput:{hookEventName:"SessionStart",additionalContext:.}}'

package/assets/hooks/grill-gate.sh

@@ -0,0 +1,96 @@
+#!/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
+
+# Профиль дерева: каталоги законов, правил и спеков у каждого свои, а знать их надо и для
+# признака чтения, и для подсказки в отказе.
+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
+
+# Подстановка без двоеточия намеренно: заданное пустым — это отказ дерева от требования, и
+# подменять его умолчанием нельзя. Умолчание достаётся только тому, кто не задал переменной
+# вовсе.
+laws_dir="${RT_LAWS_DIR-docs/constitution}"
+rules_dir="${RT_RULES_DIR-.claude/skills}"
+specs_dir="${RT_SPECS_DIR-docs/specs}"
+
+# Дерево, у которого нет ни законов, ни правил, требования не получает: читать нечего.
+[ -z "$laws_dir" ] && [ -z "$rules_dir" ] && exit 0
+
+# Образец, по которому вызов инструмента считается чтением правил. Каталоги идут в него как
+# есть: точка в `.claude` совпадает с любым знаком и лишнего сюда не приводит.
+read_re="$(printf '%s' "$laws_dir|$rules_dir|$specs_dir" | sed 's/^|*//; s/|*$//; s/||*/|/g')"
+[ -z "$read_re" ] && exit 0
+
+# Ход — это всё, что записано после последнего настоящего ввода владельца. Ответ инструмента
+# приходит той же ролью `user`, поэтому строки с `tool_result` вводом не считаются: иначе ходом
+# оказался бы кусок после последнего вызова инструмента, и чтение правил в его начале потерялось
+# бы.
+#
+# Хвост в 400 строк: запись хода растёт всю сессию, а судится только последний ход.
+verdict="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r --arg re "$read_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
+    | ($uses | map(
+          (.name == "Skill")
+          or ((.name // "") | test("^(Read|Grep|Glob)$")) and ((.input | tostring) | test($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
+' 2>/dev/null)"
+
+[ "$verdict" = "ask" ] || exit 0
+
+reason="BLOCKED by grill-gate: в ответе есть вопрос владельцу, а законы и правила за этот ход не читались. Вопрос, ответ на который уже записан, владельцу не задаётся — правило ведения работы. Прогони поиск по словам темы и ответь по найденному; спрашивай только то, что документацией не покрыто:
+
+    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'
+
+exit 0

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

@@ -1,11 +1,12 @@
 #!/usr/bin/env bash
+# rt-hook: PostToolUse Edit|Write|MultiEdit|Bash|mcp__webstorm__create_new_file
 # Линтер по следам правки. PostToolUse.
 #
 # Два входа. Правка файла — линтуется один изменённый файл. Перенос файла командой — линтуются
-# файлы по адресу назначения: перенос меняет либу, а вместе с ней и границы, и импорт,
-# законный на прежнем месте, на новом уже запрещён. Ровно так запрещённый импорт уезжает в
-# общую либу молча: файлы перекладываются командой, хук на неё не смотрит, и правило границ
-# сработало бы — но его никто не запустил.
+# файлы по адресу назначения: перенос меняет либу, а вместе с ней и границы, и импорт, законный
+# на прежнем месте, на новом уже запрещён. Ровно так запрещённый импорт уезжает в общую либу
+# молча: файлы перекладываются командой, хук на неё не смотрит, и правило границ сработало бы —
+# но его никто не запустил.
 #
 # Полный набор гоняет гард на пуше, но это конец работы: к моменту, когда правило срабатывает,
 # поверх нарушения лежит десяток правок, и разбор превращается в археологию. Здесь тот же
@@ -15,11 +16,15 @@
 # незаконченный промежуточный файл имеет право быть красным. Чинить их надо до конца задачи —
 # все, включая лежавшие в файле раньше.
 #
-# Чем линтуется файл, знает профиль проекта: {{projectProfile}}, функция `rt_lint_for <файл>`.
+# Что здесь чем зовётся, знает профиль дерева:
+#   rt_lint_for      — чем линтуется этот файл;
+#   rt_is_app_code   — где лежит код, к которому линтеры вообще относятся;
+#   RT_LINT_SKIP_RE  — что из него исключено;
+#   rt_push_checks   — что гоняет гейт пуша. По нему же решается, догонит ли замечание позже:
+#                      линтер, которого в гейте нет, ловит только этот хук.
 # Нет профиля или нет функции — хук молчит.
 #
-# ОТКАЗ В ПОЛЬЗУ РАБОТЫ и молча: нет линтера, файл вне проекта, зелёный результат — пустой
-# вывод.
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ и молча: нет линтера, файл вне дерева, зелёный результат — пустой вывод.
 
 # Сколько файлов линтуется за один перенос. Переезд либы трогает десятки файлов, и прогон по
 # каждому превратил бы хук в минутную паузу; на нарушение границы хватает первых.
@@ -49,46 +54,166 @@ fi
 workdir="$(printf '%s' "$input" | jq -r '.cwd // empty' 2>/dev/null)"
 [ -z "$workdir" ] && workdir="${CLAUDE_PROJECT_DIR:-.}"
 cd "$workdir" 2>/dev/null || exit 0
+[ -f package.json ] || exit 0
 
-profile="${CLAUDE_PROJECT_DIR:-.}/{{projectProfile}}"
-[ -f "$profile" ] || exit 0
-# shellcheck disable=SC1090
-. "$profile" 2>/dev/null || 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
 command -v rt_lint_for >/dev/null 2>&1 || exit 0
 
-files=""
+# --- какие файлы проверяем -------------------------------------------------------------
+
+# Пути назначения всех переносов в команде. Команда бывает составной, поэтому режется по
+# разделителям, и каждый кусок разбирается отдельно.
+collect_moved() {
+    # Перевод строки в конце обязателен: чтение без него теряет последний кусок, а команда
+    # чаще всего состоит ровно из одного.
+    printf '%s\n' "$1" | tr ';&\n' '\n\n\n' | while IFS= read -r segment; do
+        case "$segment" in
+            *"git mv "*) ;;
+            *) continue ;;
+        esac
+
+        # shellcheck disable=SC2086 # разбиение по пробелам здесь и нужно
+        set -- ${segment#*git mv }
+        args=''
+        for arg in "$@"; do
+            case "$arg" in
+                -*) continue ;;
+            esac
+            args="${args}${args:+ }${arg}"
+        done
+
+        # shellcheck disable=SC2086
+        set -- $args
+        [ "$#" -lt 2 ] && continue
+
+        dest=''
+        for arg in "$@"; do dest="$arg"; done
+
+        # Назначение — каталог: имя файла остаётся прежним, меняется только путь.
+        if [ -d "$dest" ]; then
+            for arg in "$@"; do
+                [ "$arg" = "$dest" ] && continue
+                printf '%s/%s\n' "${dest%/}" "${arg##*/}"
+            done
+        else
+            printf '%s\n' "$dest"
+        fi
+    done
+}
+
+# Каталог разворачивается в лежащие в нём файлы: перенос умеет двигать целые слои.
+expand() {
+    if [ -d "$1" ]; then
+        find "$1" -type f \( -name '*.ts' -o -name '*.html' -o -name '*.scss' \) 2>/dev/null
+    elif [ -f "$1" ]; then
+        printf '%s\n' "$1"
+    fi
+}
+
 if [ "$mode" = "edit" ]; then
-    files="$(printf '%s' "$input" | jq -r '.tool_input.file_path // .tool_input.pathInProject // empty' 2>/dev/null)"
+    path="$(printf '%s' "$input" | jq -r '.tool_input.file_path // .tool_input.pathInProject // empty' 2>/dev/null)"
+    [ -z "$path" ] && exit 0
+    # Путь от корня дерева приводится к абсолютному один раз, чтобы образцы не двоились.
+    case "$path" in
+        /*) ;;
+        *) path="${CLAUDE_PROJECT_DIR:-.}/$path" ;;
+    esac
+    candidates="$(expand "$path")"
 else
-    # Пути назначения всех переносов в команде. Команда бывает составной, поэтому режется по
-    # разделителям, и каждый кусок разбирается отдельно. Перевод строки в конце обязателен:
-    # чтение без него теряет последний кусок, а команда чаще всего состоит ровно из одного.
-    files="$(printf '%s\n' "$command_text" | tr ';&\n' '\n\n\n' | awk '
-        /git mv / {
-            sub(/.*git mv /, "");
-            n = split($0, parts, /[[:space:]]+/);
-            for (i = n; i >= 1; i--) {
-                if (parts[i] !~ /^-/ && parts[i] != "") { print parts[i]; break }
-            }
-        }' | head -n "$MAX_FILES")"
+    candidates="$(collect_moved "$command_text" | while IFS= read -r moved; do expand "$moved"; done)"
 fi
 
-[ -z "$files" ] && exit 0
+[ -z "$candidates" ] && exit 0
+
+# --- отсев того, что линтерами дерева не покрыто ----------------------------------------
+
+lintable() {
+    if command -v rt_is_app_code >/dev/null 2>&1; 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
+        return 1
+    fi
+
+    return 0
+}
+
+# Имя линтера в команде — первое слово, которое не запускатель. Оно идёт в заголовок и по нему
+# же ищется гейт пуша.
+linter_name() {
+    printf '%s' "$1" | awk '{
+        for (i = 1; i <= NF; i++) {
+            if ($i ~ /^(npx|pnpm|yarn|bun|npm|exec|run|dlx|--no-install)$/) { continue }
+            print $i; exit
+        }
+    }'
+}
+
+# --- прогон -----------------------------------------------------------------------------
+
+push_checks="$(command -v rt_push_checks >/dev/null 2>&1 && rt_push_checks 2>/dev/null)"
 
 report=""
+linters=""
+covered=1
+checked=0
+
 while IFS= read -r file; do
     [ -z "$file" ] && continue
-    [ -f "$file" ] || continue
+    lintable "$file" || continue
+    [ "$checked" -ge "$MAX_FILES" ] && break
+
     lint="$(rt_lint_for "$file" 2>/dev/null)"
     [ -z "$lint" ] && continue
-    out="$(eval "$lint" 2>&1)" || report="${report}${out}"$'\n'
+    checked=$((checked + 1))
+
+    out="$(eval "$lint" 2>&1)" && continue
+
+    # Линтера нет или он упал сам по себе — это не замечание к файлу, молчим.
+    printf '%s' "$out" | grep -qiE 'command not found|could not determine executable|Cannot find module' && continue
+
+    linter="$(linter_name "$lint")"
+    case " $linters " in
+        *" $linter "*) ;;
+        *) linters="${linters}${linters:+ }${linter}" ;;
+    esac
+    printf '%s' "$push_checks" | grep -qF "$linter" || covered=0
+
+    report="${report}
+${file}:
+$(printf '%s' "$out" | head -c 2500 | tr -d '\000')
+"
 done <<EOF
-$files
+$candidates
 EOF
 
 [ -z "$report" ] && exit 0
 
-jq -n --arg r "Замечания линтера по только что тронутым файлам — чинить до конца задачи, включая те, что лежали в файле раньше:"$'\n'"$report" \
-    '{hookSpecificOutput:{hookEventName:"PostToolUse",additionalContext:$r}}' 2>/dev/null
+# Длинный вывод режем: важен факт и первые нарушения, остальное видно при полном прогоне.
+report="$(printf '%s' "$report" | head -c 6000)"
+
+if [ "$covered" -eq 1 ]; then
+    tail_line="Пуш всё равно не пройдёт, пока набор красный."
+else
+    tail_line="Почини их сейчас: этот линтер в гейт пуша не входит, и отложенное замечание уедет в главную ветку молча."
+fi
+
+if [ "$mode" = "move" ]; then
+    head_line="ЛИНТЕР (${linters}) НАШЁЛ ЗАМЕЧАНИЯ ПОСЛЕ ПЕРЕНОСА. Перенос меняет либу, а вместе с ней границы: импорт, законный на прежнем месте, на новом может быть запрещён."
+else
+    head_line="ЛИНТЕР (${linters}) НАШЁЛ ЗАМЕЧАНИЯ:"
+fi
+
+ctx="${head_line}
+${report}
+
+Почини их до конца задачи — правятся ВСЕ замечания в затронутом файле, и новые, и лежавшие раньше: накопленные нарушения глушат сигнал о свежих. ${tail_line}"
+
+jq -n --arg c "$ctx" '{hookSpecificOutput:{hookEventName:"PostToolUse",additionalContext:$c}}' 2>/dev/null
 
 exit 0

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

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
-# Гард якоря для спек. PreToolUse на правке шаблонов.
+# rt-hook: PreToolUse Edit|Write|MultiEdit|mcp__webstorm__create_new_file
+# Гард якоря для спек. PreToolUse на правке разметки.
 #
 # Спеки адресуют элементы только через этот атрибут. Классы оформления меняются вместе с
 # вёрсткой, а поиск по роли и тексту ломается на переводах — приложение живёт во многих
@@ -8,17 +9,18 @@
 # того, как кто-то заметит его отсутствие.
 #
 # Правило инвертировано: интерактивным считается ЛЮБОЙ составной тег (компонент) и любой тег с
-# привязкой события, кроме помеченных пропуском. Перечислять интерактивные поимённо не выходит
-# — компонентов в источнике вида сотня, и список устаревает молча: забытый в нём компонент
-# проходит без якоря.
+# привязкой события, кроме помеченных декоративными. Перечислять интерактивные поимённо не
+# выходит — компонентов в ките больше сотни, и список устаревает молча: забытый в нём
+# компонент проходит без якоря.
 #
 # Осознанный выход: атрибут пропуска НА САМОМ ТЕГЕ. Маркер, который ищется во всей правке,
 # выключал бы проверку целиком — декоративная ссылка уносила бы с собой кнопку отправки из той
 # же правки.
 #
-# Что здесь не проверяется, знает профиль проекта: {{projectProfile}}, переменная RT_QA_SKIP_RE
-# — образец путей, у которых якорь не требуется (сам источник вида, витрина, корневая
-# разметка).
+# Что здесь чем зовётся, знает профиль дерева:
+#   RT_QA_SKIP_RE      — пути, где якорь не требуется: витрина, корневая разметка, спеки;
+#   RT_QA_COMPONENT_RE — по какому имени тег опознаётся компонентом этого дерева;
+#   rt_qa_decorative   — имена тегов, которые спека не нажимает.
 #
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: нет разборщика, битый ввод, чужой инструмент — пропуск.
 
@@ -29,51 +31,89 @@ command -v perl >/dev/null 2>&1 || exit 0
 
 tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
 case "$tool" in
+    # Инструмент среды заводит файл теми же двумя данными, только называет их иначе — без этой
+    # ветки разметка заводилась мимо всех проверок.
     Edit | Write | MultiEdit | mcp__webstorm__create_new_file) ;;
     *) exit 0 ;;
 esac
 
-target="$(printf '%s' "$input" | jq -r '.tool_input.file_path // .tool_input.pathInProject // empty' 2>/dev/null)"
-case "$target" in
-    *.component.html|*.html) ;;
+path="$(printf '%s' "$input" | jq -r '.tool_input.file_path // .tool_input.pathInProject // empty' 2>/dev/null)"
+# Путь из среды приходит относительным корню дерева, а все образцы ниже написаны от каталога
+# приложения. Приводим к одному виду один раз, чтобы правила не двоились.
+case "$path" in
+    /*) ;;
+    ?*) path="${CLAUDE_PROJECT_DIR:-.}/$path" ;;
+esac
+case "$path" in
+    *.html) ;;
     *) exit 0 ;;
 esac
 
-profile="${CLAUDE_PROJECT_DIR:-.}/{{projectProfile}}"
-if [ -f "$profile" ]; then
+# Профиль дерева: сперва умолчание пакета, поверх него — надстройка проекта, если она есть.
+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
-    . "$profile" 2>/dev/null
-    if [ -n "${RT_QA_SKIP_RE:-}" ] && printf '%s' "$target" | grep -qE "$RT_QA_SKIP_RE"; then
-        exit 0
-    fi
+    [ -f "$profile" ] && . "$profile" 2>/dev/null
+done
+
+# Разметка приложения живёт там же, где его код. Без этой положительной проверки гард
+# распространялся на любой файл разметки на диске — черновик вне дерева отклонялся требованием
+# проставить якоря.
+if command -v rt_is_app_code >/dev/null 2>&1; then
+    rt_is_app_code "$path" || exit 0
+fi
+
+if [ -n "${RT_QA_SKIP_RE:-}" ] && printf '%s' "$path" | grep -qE "$RT_QA_SKIP_RE"; then
+    exit 0
 fi
 
 # Проверяется только НОВЫЙ текст: то, что уже лежало в файле, эта правка не заводила, и
 # требовать якорь у чужой строки — значит отбивать правку соседней.
 added="$(printf '%s' "$input" | jq -r '
-    [.tool_input.content? // empty,
-     .tool_input.text? // empty,
-     .tool_input.new_string? // empty,
-     (.tool_input.edits? // [] | map(.new_string) | join("\n"))] | join("\n")' 2>/dev/null)"
+    [ .tool_input.content?, .tool_input.text?, .tool_input.new_string?, (.tool_input.edits[]?.new_string) ]
+    | map(select(. != null)) | join("\n")
+' 2>/dev/null)"
 [ -z "$added" ] && exit 0
 
-# Открывающие теги без якоря: составной тег (компонент) или тег с привязкой события. Тег с
-# атрибутом пропуска или с самим якорем пропускается.
-offenders="$(printf '%s' "$added" | perl -0ne '
-    my @bad;
-    while (/<([a-zA-Z][a-zA-Z0-9-]*)((?:"[^"]*"|\x27[^\x27]*\x27|[^>"\x27])*)>/gs) {
+decorative="$(command -v rt_qa_decorative >/dev/null 2>&1 && rt_qa_decorative 2>/dev/null)"
+component_re="${RT_QA_COMPONENT_RE:--}"
+
+# Открывающие теги разбираются ЦЕЛИКОМ: тег занимает несколько строк, и якорь часто стоит не в
+# первой из них — построчная проверка врала бы.
+missing="$(printf '%s' "$added" | RT_QA_DECORATIVE="$decorative" RT_QA_COMPONENT_RE="$component_re" perl -0777 -ne '
+    # Комментарии вырезаются до разбора: в них часто лежит разметка-пример («было <button …>,
+    # заменено на переход»). Без этого правка отклонялась из-за элемента, которого в дереве
+    # документа не будет, а обойти отказ можно было только испортив текст самого комментария.
+    s/<!--.*?-->//gs;
+    # Декоративное и структурное: спека такое не нажимает и по нему не проверяет состояние.
+    # Всё остальное считается интерактивным по умолчанию — кит растёт, и умолчание должно быть
+    # в сторону якоря, а не в сторону тишины. Попадание в список НЕ выдаёт индульгенцию: тег с
+    # привязкой события проверяется наравне с прочими.
+    my %decorative = map { $_ => 1 } split /\s+/, ($ENV{RT_QA_DECORATIVE} // "");
+    my $component = $ENV{RT_QA_COMPONENT_RE} || "-";
+    my %seen;
+    while (/<([a-zA-Z][\w-]*)((?:[^<>"\x27]|"[^"]*"|\x27[^\x27]*\x27)*)>/gs) {
         my ($tag, $attrs) = ($1, $2);
-        next if $attrs =~ /qa-dataid/ || $attrs =~ /qa-skip/;
-        my $is_component = $tag =~ /-/;
-        my $has_event    = $attrs =~ /\(\s*[a-zA-Z][\w.]*\s*\)\s*=/;
-        push @bad, "<$tag" if $is_component || $has_event;
+        # Структурные теги каркаса узла документа не порождают: поставленный на них якорь не
+        # найдёт ни один селектор спеки. Требовать его — значит требовать неработающего.
+        next if $tag =~ /^(ng-container|ng-template|ng-content)$/;
+        next if $attrs =~ /\bqa-dataid\b/;
+        # Осознанный отказ помечается на самом теге, а не где-то в той же правке.
+        next if $attrs =~ /\bqa-skip\b/;
+        my $interactive =
+               $attrs =~ /\(\s*[a-zA-Z][\w.:-]*\s*\)\s*=/
+            || $attrs =~ /\b(routerLink|rtButton|href)\b/
+            || $tag =~ /^(button|a|input|select|textarea|form|dialog)$/
+            || ($tag =~ /$component/ && !$decorative{$tag});
+        next unless $interactive;
+        next if $seen{$tag}++;
+        print "<$tag> ";
     }
-    print join(", ", @bad) if @bad;
 ' 2>/dev/null)"
 
-[ -z "$offenders" ] && exit 0
+[ -z "$missing" ] && exit 0
 
-reason="Интерактивный элемент без якоря для спек: ${offenders}. Спеки адресуют элементы только им — классы меняются вместе с вёрсткой, а поиск по тексту ломается на переводах. Значение — через дефис, по смыслу элемента; повторяющиеся элементы списка носят один якорь и различаются атрибутами данных. Декоративный элемент помечается атрибутом пропуска на самом теге."
+reason="BLOCKED: интерактивные элементы без якоря для спек в ${path##*/}: ${missing}. Спеки адресуют элементы только через этот атрибут: классы оформления меняются вместе с вёрсткой, а поиск по роли и тексту ломается на переводах — оба вида селекторов делают сквозные спеки хрупкими. Проставь якорь через дефис по смыслу элемента; повторяющиеся элементы списка носят ОДИН якорь и различаются атрибутами данных. Если элемент чисто декоративный и спека его никогда не тронет — поставь атрибут пропуска НА САМ ЭТОТ ТЕГ, соседние элементы правки при этом продолжают проверяться."
 
 jq -n --arg r "$reason" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
     || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Интерактивный элемент без якоря для спек."}}\n'