@rt-tools/agent-kit 0.1.0 → 0.3.0

package/assets/hooks/git-guard-delivery.sh

@@ -0,0 +1,110 @@
+#!/usr/bin/env bash
+# Гард поставки. PreToolUse на заведении ветки и открытии PR.
+#
+# Закон о поставке требует трёх вещей, которых обычно не проверяет ничто: правка начинается с
+# задачи, видимой в очереди работ; задача, ветка и отчёт несут один номер; у задачи есть
+# исполнитель. Держатся они памятью — и не удерживаются: задачи стоят вне очереди, исполнитель
+# не проставлен, а большинство влитых PR приходит с веток, за которыми задачи не стояло вовсе.
+#
+# Гард стоит в двух точках, и в каждой требует того, что в этот момент исправимо:
+#
+#   заведение ветки — имя с номером разбирается на месте; имя без номера пропускается:
+#       локальная ветка под пробу законна, в главную она не поедет, потому что PR с неё не
+#       откроется;
+#   открытие PR — ветка обязана нести номер, а заголовок — начинаться с того же номера.
+#
+# Форму имени ветки и номер в заголовке знает профиль проекта: {{projectProfile}}, функция
+# `rt_task_branch_ok <имя>` и переменная RT_TASK_TITLE_RE. Нет профиля — гард пропускает: форму
+# имени пакет выдумать не может.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ: не репозиторий, нет разборщика, битый ввод — пропуск.
+
+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
+
+if [ "$tool" = "mcp__webstorm__execute_tool" ] && command -v perl >/dev/null 2>&1; then
+    inner="$(printf '%s' "$cmd" | perl -0ne '
+        if (/--command(?:=|\s+)(?:"((?:[^"\\]|\\.)*)"|\x27([^\x27]*)\x27|(.+))/s) {
+            print defined $1 ? $1 : (defined $2 ? $2 : $3);
+        }
+    ' 2>/dev/null)"
+    [ -n "$inner" ] && cmd="$inner"
+fi
+
+profile="${CLAUDE_PROJECT_DIR:-.}/{{projectProfile}}"
+[ -f "$profile" ] || exit 0
+# shellcheck disable=SC1090
+. "$profile" 2>/dev/null || exit 0
+command -v rt_task_branch_ok >/dev/null 2>&1 || exit 0
+
+deny() {
+    jq -n --arg r "$1" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
+        || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Гард поставки."}}\n'
+    exit 0
+}
+
+# --- заведение ветки ---------------------------------------------------------------------
+branch_arg=''
+if printf '%s' "$cmd" | grep -qE '(^|[;&|[:space:]])git[[:space:]]+(checkout[[:space:]]+-b|switch[[:space:]]+-c)[[:space:]]'; then
+    branch_arg="$(printf '%s' "$cmd" | sed -nE 's/.*git[[:space:]]+(checkout[[:space:]]+-b|switch[[:space:]]+-c)[[:space:]]+([^[:space:];&|]+).*/\2/p' | head -1)"
+    branch_arg="${branch_arg%\'}"; branch_arg="${branch_arg#\'}"
+    branch_arg="${branch_arg%\"}"; branch_arg="${branch_arg#\"}"
+fi
+
+if [ -n "$branch_arg" ]; then
+    # Имя, притворяющееся веткой под задачу, но не совпадающее с формой, — это промах в имени,
+    # а не осознанная беззадачная ветка. Ловится до первого коммита.
+    if printf '%s' "$branch_arg" | grep -qE '^[A-Za-z]+-[0-9]+' && ! rt_task_branch_ok "$branch_arg"; then
+        deny "Имя ветки «${branch_arg}» не той формы, что принята здесь. Номер у ветки тот же, что у задачи и у заголовка PR."
+    fi
+    exit 0
+fi
+
+# --- открытие PR -------------------------------------------------------------------------
+case "$cmd" in
+    *gh\ pr\ create*) ;;
+    *) exit 0 ;;
+esac
+
+workdir="$(printf '%s' "$input" | jq -r '.cwd // empty' 2>/dev/null)"
+[ -z "$workdir" ] && workdir="${CLAUDE_PROJECT_DIR:-.}"
+cd "$workdir" 2>/dev/null || exit 0
+
+branch="$(git branch --show-current 2>/dev/null)"
+[ -z "$branch" ] && exit 0   # открепившийся HEAD — не про этот случай
+
+# Локальная ветка без номера законна, а PR с неё — уже нет: правка, доезжающая до главной
+# ветки, начинается с задачи. Это единственное место, где беззадачная ветка упирается.
+rt_task_branch_ok "$branch" \
+    || deny "PR с ветки «${branch}», за которой не стоит задачи. Правка начинается с задачи, видимой в очереди работ: заведи её и перенеси работу в ветку с её номером."
+
+number="$(printf '%s' "$branch" | sed -nE 's/^[A-Za-z]+-([0-9]+).*/\1/p')"
+
+title=''
+if command -v perl >/dev/null 2>&1; then
+    title="$(printf '%s' "$cmd" | perl -0ne '
+        if (/--title(?:=|\s+)(?:"((?:[^"\\]|\\.)*)"|\x27([^\x27]*)\x27|([^\s]+))/s) {
+            print defined $1 ? $1 : (defined $2 ? $2 : $3);
+        }
+    ' 2>/dev/null)"
+fi
+
+if [ -n "$title" ] && [ -n "$number" ]; then
+    title_number="$(printf '%s' "$title" | sed -nE 's/^\[[A-Za-z]+-([0-9]+)\].*/\1/p')"
+    [ -z "$title_number" ] \
+        && deny "Заголовок PR не начинается с номера задачи. В списке PR тела не видно, а строка связи живёт именно там — без номера в заголовке отчёт с задачей не сопоставить."
+    [ "$title_number" = "$number" ] \
+        || deny "В заголовке PR номер ${title_number}, у ветки — ${number}. Задача, ветка и отчёт несут один и тот же номер."
+fi
+
+exit 0

package/assets/hooks/git-guard-main.sh

@@ -0,0 +1,72 @@
+#!/usr/bin/env bash
+# Гард главной ветки. PreToolUse на вызове коммита.
+#
+# Коммит в главную ветку минует ветку, PR и разбор, а поставка построена на них целиком —
+# правило `git-workflow`. Прямой коммит туда почти всегда промах: «остался на главной после
+# слияния предыдущего PR».
+#
+# Имя главной ветки не зашито строкой: сначала спрашивается указатель удалённого репозитория,
+# затем пробуются существующие `origin/main` и `origin/master`, и лишь в конце берётся `main`.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ: не репозиторий, нет гита, открепившийся HEAD, битый ввод — пропуск.
+# Сломанный гард не должен мешать работать.
+
+input="$(cat 2>/dev/null)"
+[ -z "$input" ] && 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)"
+
+# Универсальный исполнитель среды передаёт настоящую команду вложенной строкой. Разбирать надо
+# её, а не обёртку: иначе имя команды стоит сразу за кавычкой и ни одно правило до него не
+# дотягивается.
+if [ "$tool" = "mcp__webstorm__execute_tool" ] && command -v perl >/dev/null 2>&1; then
+    inner="$(printf '%s' "$cmd" | perl -0ne '
+        if (/--command(?:=|\s+)(?:"((?:[^"\\]|\\.)*)"|\x27([^\x27]*)\x27|(.+))/s) {
+            print defined $1 ? $1 : (defined $2 ? $2 : $3);
+        }
+    ' 2>/dev/null)"
+    [ -n "$inner" ] && cmd="$inner"
+fi
+case "$cmd" in
+    *git\ commit*) ;;
+    *) exit 0 ;;
+esac
+
+# Коммит выполнится в рабочем каталоге вызова, поэтому и ветку смотрим там же; корень проекта
+# — запасной вариант, и он важен для отдельного рабочего дерева, где ветка своя.
+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   # открепившийся HEAD — не про этот случай
+
+default="$(git symbolic-ref --quiet --short refs/remotes/origin/HEAD 2>/dev/null | sed 's#^origin/##')"
+if [ -z "$default" ]; then
+    for candidate in main master; do
+        if git show-ref --verify --quiet "refs/remotes/origin/$candidate" 2>/dev/null; then
+            default="$candidate"
+            break
+        fi
+    done
+fi
+[ -z "$default" ] && default="main"
+
+[ "$branch" = "$default" ] || exit 0
+
+reason="Отбито: коммит прямо в «${default}». Работа едет через ветку и PR — правило git-workflow. Заведи ветку отдельным вызовом и коммить в неё: подготовленные изменения при этом сохранятся. Если коммит в ${default} действительно нужен — спроси владельца, сам не обходи."
+
+jq -n --arg r "$reason" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
+    || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Коммит в главную ветку отбит. Заведи ветку."}}\n'
+
+exit 0

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

@@ -0,0 +1,73 @@
+#!/usr/bin/env bash
+# Гард проверок перед пушем. PreToolUse на вызове пуша.
+#
+# Пуш — это вход в конвейер: слияние в главную ветку запускает выкатку, и всё, что не
+# проверено локально, проверяется уже на проде. Сюда дважды подряд уезжают правки, зелёные в
+# выборочном прогоне и красные в конвейере: один раз прогонялись только сквозные спеки, другой
+# — только затронутый проект.
+#
+# Гард не верит на слово: он сам гоняет то, что перечислил профиль проекта, и пускает пуш
+# только при нулевом коде возврата. Если прогонщик кэширует результат, набор на неизменившемся
+# дереве занимает секунды, а после правки гоняется заново.
+#
+# Что гонять, знает профиль: {{projectProfile}}, функция `rt_push_checks` — по команде на
+# строку. Нет профиля или нет функции — гард пропускает: список проверок пакет выдумать не
+# может.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ: не репозиторий, битый ввод, нет профиля — пропуск.
+
+input="$(cat 2>/dev/null)"
+[ -z "$input" ] && 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)"
+case "$cmd" in
+    *git\ push*) ;;
+    *) exit 0 ;;
+esac
+
+# Пробный пуш ничего не отправляет: гонять ради него весь набор незачем.
+case "$cmd" in
+    *--dry-run*) exit 0 ;;
+esac
+
+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
+
+profile="${CLAUDE_PROJECT_DIR:-.}/{{projectProfile}}"
+[ -f "$profile" ] || exit 0
+# shellcheck disable=SC1090
+. "$profile" 2>/dev/null || exit 0
+command -v rt_push_checks >/dev/null 2>&1 || exit 0
+
+failed=""
+output=""
+while IFS= read -r check; do
+    [ -z "$check" ] && continue
+    out="$(eval "$check" 2>&1)" && continue
+    failed="$check"
+    output="$out"
+    break
+done <<EOF
+$(rt_push_checks)
+EOF
+
+[ -z "$failed" ] && exit 0
+
+# Хвост вывода, а не весь: у прогонщика он длинный, а нужна причина отказа.
+tail_out="$(printf '%s' "$output" | tail -n 40)"
+reason="Отбито перед пушем: «${failed}» упала. Пуш — вход в конвейер, и красное отсюда проверяется уже на проде. Почини и повтори.
+
+${tail_out}"
+
+jq -n --arg r "$reason" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
+    || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Проверки перед пушем не прошли."}}\n'
+
+exit 0

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

@@ -0,0 +1,94 @@
+#!/usr/bin/env bash
+# Линтер по следам правки. PostToolUse.
+#
+# Два входа. Правка файла — линтуется один изменённый файл. Перенос файла командой — линтуются
+# файлы по адресу назначения: перенос меняет либу, а вместе с ней и границы, и импорт,
+# законный на прежнем месте, на новом уже запрещён. Ровно так запрещённый импорт уезжает в
+# общую либу молча: файлы перекладываются командой, хук на неё не смотрит, и правило границ
+# сработало бы — но его никто не запустил.
+#
+# Полный набор гоняет гард на пуше, но это конец работы: к моменту, когда правило срабатывает,
+# поверх нарушения лежит десяток правок, и разбор превращается в археологию. Здесь тот же
+# линтер, но по затронутым файлам — секунды, сразу после действия, пока контекст ещё свой.
+#
+# Замечания возвращаются добавленным контекстом, а не отказом: действие уже применено, и
+# незаконченный промежуточный файл имеет право быть красным. Чинить их надо до конца задачи —
+# все, включая лежавшие в файле раньше.
+#
+# Чем линтуется файл, знает профиль проекта: {{projectProfile}}, функция `rt_lint_for <файл>`.
+# Нет профиля или нет функции — хук молчит.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ и молча: нет линтера, файл вне проекта, зелёный результат — пустой
+# вывод.
+
+# Сколько файлов линтуется за один перенос. Переезд либы трогает десятки файлов, и прогон по
+# каждому превратил бы хук в минутную паузу; на нарушение границы хватает первых.
+MAX_FILES=12
+
+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
+    Edit | Write | MultiEdit | mcp__webstorm__create_new_file) mode="edit" ;;
+    Bash) mode="move" ;;
+    *) exit 0 ;;
+esac
+
+# Отсев до всякой работы: хук висит на каждой команде оболочки, а перенос среди них — редкость.
+command_text=""
+if [ "$mode" = "move" ]; then
+    command_text="$(printf '%s' "$input" | jq -r '.tool_input.command // empty' 2>/dev/null)"
+    case "$command_text" in
+        *"git mv "*) ;;
+        *) exit 0 ;;
+    esac
+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
+
+profile="${CLAUDE_PROJECT_DIR:-.}/{{projectProfile}}"
+[ -f "$profile" ] || exit 0
+# shellcheck disable=SC1090
+. "$profile" 2>/dev/null || exit 0
+command -v rt_lint_for >/dev/null 2>&1 || exit 0
+
+files=""
+if [ "$mode" = "edit" ]; then
+    files="$(printf '%s' "$input" | jq -r '.tool_input.file_path // .tool_input.pathInProject // empty' 2>/dev/null)"
+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")"
+fi
+
+[ -z "$files" ] && exit 0
+
+report=""
+while IFS= read -r file; do
+    [ -z "$file" ] && continue
+    [ -f "$file" ] || continue
+    lint="$(rt_lint_for "$file" 2>/dev/null)"
+    [ -z "$lint" ] && continue
+    out="$(eval "$lint" 2>&1)" || report="${report}${out}"$'\n'
+done <<EOF
+$files
+EOF
+
+[ -z "$report" ] && exit 0
+
+jq -n --arg r "Замечания линтера по только что тронутым файлам — чинить до конца задачи, включая те, что лежали в файле раньше:"$'\n'"$report" \
+    '{hookSpecificOutput:{hookEventName:"PostToolUse",additionalContext:$r}}' 2>/dev/null
+
+exit 0

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

@@ -0,0 +1,81 @@
+#!/usr/bin/env bash
+# Гард якоря для спек. PreToolUse на правке шаблонов.
+#
+# Спеки адресуют элементы только через этот атрибут. Классы оформления меняются вместе с
+# вёрсткой, а поиск по роли и тексту ломается на переводах — приложение живёт во многих
+# локалях. Оба вида селекторов делают сквозные спеки хрупкими, поэтому якорь один и ставится
+# по умолчанию, а не дописывается потом: элемент без атрибута попадает в спеку только после
+# того, как кто-то заметит его отсутствие.
+#
+# Правило инвертировано: интерактивным считается ЛЮБОЙ составной тег (компонент) и любой тег с
+# привязкой события, кроме помеченных пропуском. Перечислять интерактивные поимённо не выходит
+# — компонентов в источнике вида сотня, и список устаревает молча: забытый в нём компонент
+# проходит без якоря.
+#
+# Осознанный выход: атрибут пропуска НА САМОМ ТЕГЕ. Маркер, который ищется во всей правке,
+# выключал бы проверку целиком — декоративная ссылка уносила бы с собой кнопку отправки из той
+# же правки.
+#
+# Что здесь не проверяется, знает профиль проекта: {{projectProfile}}, переменная RT_QA_SKIP_RE
+# — образец путей, у которых якорь не требуется (сам источник вида, витрина, корневая
+# разметка).
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ: нет разборщика, битый ввод, чужой инструмент — пропуск.
+
+input="$(cat 2>/dev/null)"
+[ -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)"
+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) ;;
+    *) exit 0 ;;
+esac
+
+profile="${CLAUDE_PROJECT_DIR:-.}/{{projectProfile}}"
+if [ -f "$profile" ]; then
+    # 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
+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)"
+[ -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) {
+        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;
+    }
+    print join(", ", @bad) if @bad;
+' 2>/dev/null)"
+
+[ -z "$offenders" ] && exit 0
+
+reason="Интерактивный элемент без якоря для спек: ${offenders}. Спеки адресуют элементы только им — классы меняются вместе с вёрсткой, а поиск по тексту ломается на переводах. Значение — через дефис, по смыслу элемента; повторяющиеся элементы списка носят один якорь и различаются атрибутами данных. Декоративный элемент помечается атрибутом пропуска на самом теге."
+
+jq -n --arg r "$reason" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
+    || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Интерактивный элемент без якоря для спек."}}\n'
+
+exit 0

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

@@ -0,0 +1,83 @@
+#!/usr/bin/env bash
+# Гард «ничего не пишется с нуля». PreToolUse на правке кода и разметки.
+#
+# Линтеры знают правила, но не знают ИНВЕНТАРЬ: линтер стилей поймает сырой цвет, линтер кода
+# — нетипизированное значение, но ни один из них не знает, что готовое сообщение уже написано,
+# и молча пропустит свою область оповещения с текстом, кнопкой и стилями. Гард закрывает ровно
+# эту дыру: сверяет то, что пишется, с тем, что в дереве уже есть.
+#
+# Правило целиком — `reuse-first`.
+#
+# Что считается переизобретением, знает профиль проекта: {{projectProfile}}, функция
+# `rt_reinvented_in <файл>` — печатает по строке «образец<таб>чем заменить». Нет профиля или
+# нет функции — гард пропускает: инвентарь дерева пакет знать не может.
+#
+# Осознанный выход: строка с маркером отступления пропускается — для случаев, которых в
+# готовом действительно нет. Маркер объясняет, чего именно не хватает; «эти строки были здесь
+# раньше» причиной не считается, и оттого проверяется только НОВЫЙ текст.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ: нет разборщика, битый ввод, чужой инструмент — пропуск.
+
+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
+    Edit | Write | MultiEdit | mcp__webstorm__create_new_file) ;;
+    *) exit 0 ;;
+esac
+
+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 | *.scss | *.ts) ;;
+    *) exit 0 ;;
+esac
+
+# Правила этого дерева действуют на файлы этого дерева: без проверки корня гард требовал бы
+# верстать готовым и в черновике за пределами репозитория.
+case "$path" in
+    "${CLAUDE_PROJECT_DIR:-.}"/*) ;;
+    *) exit 0 ;;
+esac
+
+profile="${CLAUDE_PROJECT_DIR:-.}/{{projectProfile}}"
+[ -f "$profile" ] || exit 0
+# shellcheck disable=SC1090
+. "$profile" 2>/dev/null || exit 0
+command -v rt_reinvented_in >/dev/null 2>&1 || exit 0
+
+# Только новый текст: строка, уже лежавшая в файле, этой правкой не заводилась.
+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)"
+[ -z "$added" ] && exit 0
+
+found=""
+while IFS="$(printf '\t')" read -r pattern replacement; do
+    [ -z "$pattern" ] && continue
+    # Строка с маркером отступления снимается до сверки — вместе с ней снимается и повод.
+    printf '%s\n' "$added" | grep -v 'native-ok' | grep -qE "$pattern" || continue
+    found="${found}  ${pattern} — есть готовое: ${replacement}"$'\n'
+done <<EOF
+$(rt_reinvented_in "$path")
+EOF
+
+[ -z "$found" ] && exit 0
+
+reason="Написано своё там, где готовое уже есть:
+
+${found}
+Работа начинается с чтения готового, а не с чистого файла — правило reuse-first. Недостающий вариант заводится у готового, а не клонируется рядом: клон забирает правки на себя и расходится с оригиналом с первой же. Если готового здесь правда не хватает, поставь маркер отступления в той же строке и объясни, чего именно нет."
+
+jq -n --arg r "$reason" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
+    || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Написано своё там, где готовое уже есть."}}\n'
+
+exit 0

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

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+# Взвод гейта заново. SessionStart(compact|clear).
+#
+# Гейт помнит загруженное правило по идентификатору сессии и дальше пропускает эту область
+# молча. Сжатие контекста и очистка выносят из контекста САМ ТЕКСТ правила, но идентификатор
+# сессии оставляют прежним — без этого хука гейт продолжал бы пропускать, пока агент работает
+# по пересказу вместо самого правила.
+#
+# Снятие записи заставляет каждую область загрузить своё правило заново.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ: любая ошибка пропускает. Хук удаляет временный файл и ничего не
+# отбивает.
+
+input="$(cat 2>/dev/null)"
+[ -z "$input" ] && exit 0
+
+sid="$(printf '%s' "$input" | jq -r '.session_id // empty' 2>/dev/null)"
+[ -z "$sid" ] && exit 0
+
+rm -f "${TMPDIR:-/tmp}/claude-skill-gate/${sid}.loaded" 2>/dev/null
+
+exit 0

package/assets/hooks/skill-gate.sh

@@ -0,0 +1,68 @@
+#!/usr/bin/env bash
+# Гейт правил: не даёт править файл, пока не загружено правило, под которое он подпадает.
+#
+# Закон и правило, которых никто не открывает, не действуют. Напоминание в подсказке помогает
+# ровно до первой спешки, поэтому требование держит хук: правка отбивается ОДИН раз на сессию
+# для каждой области, а после загрузки правила та же область проходит молча — повторов нет, и
+# стоит это почти ничего.
+#
+# Карта «файл — правило» живёт не здесь: она знает имена этого дерева, а хук их знать не может.
+# Её пишет проект в {{gateMap}} — функцией `skill_for <род вызова> <цель>`, печатающей имя
+# правила. Нет карты — гейт пропускает всё: пустой гейт лучше гейта, отбивающего наугад.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ: любая ошибка и любой неопознанный путь пропускают правку (exit 0).
+# Сломанный гейт не имеет права остановить работу совсем.
+
+input="$(cat 2>/dev/null)"
+[ -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)"
+
+map="${CLAUDE_PROJECT_DIR:-.}/{{gateMap}}"
+[ -f "$map" ] || exit 0
+# shellcheck disable=SC1090
+. "$map" 2>/dev/null || exit 0
+command -v skill_for >/dev/null 2>&1 || exit 0
+
+req=""
+target=""
+case "$tool" in
+    Edit|Write|MultiEdit)
+        target="$(printf '%s' "$input" | jq -r '.tool_input.file_path // .tool_input.pathInProject // empty' 2>/dev/null)"
+        [ -z "$target" ] && exit 0
+        # Путь от корня проекта приводится к абсолютному один раз: иначе карту пришлось бы
+        # писать в двух формах, и вторая расходилась бы с первой молча.
+        case "$target" in
+            /*) ;;
+            ?*) target="${CLAUDE_PROJECT_DIR:-.}/$target" ;;
+        esac
+        # Правила этого дерева действуют на файлы этого дерева. Без проверки корня гейт ловил
+        # бы и соседний репозиторий на той же машине.
+        case "$target" in
+            "${CLAUDE_PROJECT_DIR:-.}"/*) ;;
+            *) exit 0 ;;
+        esac
+        req="$(skill_for edit "$target" 2>/dev/null)"
+        ;;
+    Bash)
+        target="$(printf '%s' "$input" | jq -r '.tool_input.command // empty' 2>/dev/null)"
+        [ -z "$target" ] && exit 0
+        req="$(skill_for bash "$target" 2>/dev/null)"
+        ;;
+    *) exit 0 ;;
+esac
+
+[ -z "$req" ] && exit 0
+
+# Принимается и голое имя правила, и имя с областью каталога («<каталог>:<имя>»).
+loaded="${TMPDIR:-/tmp}/claude-skill-gate/${sid}.loaded"
+if [ -f "$loaded" ] && grep -qE "^([^:]*:)?$(printf '%s' "$req" | sed 's/[][\.*^$/]/\\&/g')$" "$loaded" 2>/dev/null; then
+    exit 0
+fi
+
+reason="Отбито гейтом правил: загрузи правило «${req}» инструментом Skill и повтори действие. Для этой области это происходит один раз за сессию."
+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"
+
+exit 0

package/assets/hooks/skill-loaded.sh

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+# Запись о загруженном правиле. PostToolUse на инструменте `Skill`.
+#
+# Гейт обязан знать, загружено правило или нет, а спросить об этом ему некого: инструмент о
+# своих прошлых вызовах не рассказывает. Поэтому загрузка записывается здесь, по сессии.
+#
+# Хук только наблюдает: он всегда пропускает и ничего не отбивает.
+
+input="$(cat 2>/dev/null)"
+[ -z "$input" ] && exit 0
+
+sid="$(printf '%s' "$input" | jq -r '.session_id // "nosession"' 2>/dev/null)"
+skill="$(printf '%s' "$input" | jq -r '.tool_input.skill // empty' 2>/dev/null)"
+[ -z "$skill" ] && exit 0
+
+dir="${TMPDIR:-/tmp}/claude-skill-gate"
+mkdir -p "$dir" 2>/dev/null || exit 0
+printf '%s\n' "$skill" >> "$dir/${sid}.loaded" 2>/dev/null
+
+exit 0