@rt-tools/agent-kit 0.3.0 → 0.5.0

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

@@ -1,35 +1,51 @@
 #!/usr/bin/env bash
+# rt-hook: PreToolUse Edit|Write|MultiEdit|mcp__webstorm__create_new_file
 # Гард «ничего не пишется с нуля». PreToolUse на правке кода и разметки.
 #
-# Линтеры знают правила, но не знают ИНВЕНТАРЬ: линтер стилей поймает сырой цвет, линтер кода
-# — нетипизированное значение, но ни один из них не знает, что готовое сообщение уже написано,
-# и молча пропустит свою область оповещения с текстом, кнопкой и стилями. Гард закрывает ровно
+# Линтеры знают правила, но не знают ИНВЕНТАРЬ: линтер стилей поймает сырой цвет, линтер кода —
+# нетипизированное значение, но ни один из них не знает, что готовое сообщение уже написано, и
+# молча пропустит свою область оповещения с текстом, кнопкой и стилями. Гард закрывает ровно
 # эту дыру: сверяет то, что пишется, с тем, что в дереве уже есть.
 #
 # Правило целиком — `reuse-first`.
 #
-# Что считается переизобретением, знает профиль проекта: {{projectProfile}}, функция
-# `rt_reinvented_in <файл>` — печатает по строке «образец<таб>чем заменить». Нет профиля или
-# нет функции — гард пропускает: инвентарь дерева пакет знать не может.
+# Что считается переизобретением, знает профиль дерева: функция `rt_reinvented_in <файл>`
+# печатает по строке на правило, четырьмя полями через табуляцию:
 #
-# Осознанный выход: строка с маркером отступления пропускается — для случаев, которых в
-# готовом действительно нет. Маркер объясняет, чего именно не хватает; «эти строки были здесь
-# раньше» причиной не считается, и оттого проверяется только НОВЫЙ текст.
+#   <над чем>  <образец>  <образец отмены>  <чем заменить>
+#
+# «Над чем» — `added` (только новый текст правки) или `whole` (правка вместе с содержимым
+# файла). Второе нужно там, где признак виден только целиком: наследование основы и метка
+# процедуры в точечную правку не попадают. «Образец отмены» гасит правило: маппер, который уже
+# наследует общую основу, переизобретением не является; пустое поле не гасит ничего.
+#
+# Функция получает путь и вправе решать по нему сама — заглянуть в инвентарь кита, различить
+# слой дерева, промолчать на файле, который уже существует. Нет профиля или нет функции — гард
+# пропускает: инвентарь дерева пакет знать не может.
+#
+# Образцы разбирает `perl`: конъюнкция и отрицание пишутся заглядыванием вперёд, а без них
+# самодельный оверлей не отличить от липкой шапки, а нативную кнопку — от кнопки кита.
+#
+# Осознанный выход: маркер отступления в тексте правки. Он объясняет, чего именно не хватает;
+# «эти строки были здесь раньше» причиной не считается, и оттого проверяется только НОВЫЙ текст.
 #
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: нет разборщика, битый ввод, чужой инструмент — пропуск.
 
 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
 
 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" ;;
@@ -39,43 +55,98 @@ case "$path" in
     *) 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
+# Профиль дерева: сперва умолчание пакета, поверх него — надстройка проекта, если она есть.
+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_reinvented_in >/dev/null 2>&1 || exit 0
 
+# Правила этого дерева действуют на код этого дерева: без положительной проверки гард требовал
+# бы собирать готовым и в черновике за пределами дерева.
+if command -v rt_is_app_code >/dev/null 2>&1; then
+    rt_is_app_code "$path" || exit 0
+fi
+
+# Готовое собирается там, где ему и место: внутри кита нативные контролы и примитивы уместны,
+# витрина и спеки — тоже не забота этого гарда.
+if [ -n "${RT_REUSE_SKIP_RE:-}" ] && printf '%s' "$path" | grep -qE "$RT_REUSE_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
 
-found=""
-while IFS="$(printf '\t')" read -r pattern replacement; do
+# Явный отказ от правила: готового такого нет, автор это осознал и пометил. Считается по
+# исходному тексту правки, до вычёркивания ниже: маркер обычно и стоит на строке, которая уже
+# лежит в файле, и вычеркнутый маркер отбивал бы правку соседней строки.
+case "$added" in
+    *native-ok*) exit 0 ;;
+esac
+
+# Перенос — не написание заново. Строку, которая уже лежит в файле, гард из проверяемого текста
+# вычёркивает: блок, переехавший вместе с экраном из одного места файла в другое, отбивался
+# наравне с новым, и маркер отступления приходилось ставить вслепую.
+#
+# Сверка идёт без отступов: при переезде блок меняет отступ, оставаясь тем же кодом.
+if [ -f "$path" ]; then
+    added="$(
+        printf '%s' "$added" | awk '
+            NR == FNR {
+                line = $0
+                gsub(/^[ \t]+|[ \t]+$/, "", line)
+                if (line != "") { existing[line] = 1 }
+                next
+            }
+            {
+                line = $0
+                gsub(/^[ \t]+|[ \t]+$/, "", line)
+                if (line == "" || !(line in existing)) { print }
+            }
+        ' "$path" - 2>/dev/null
+    )"
+    [ -z "${added//[[:space:]]/}" ] && exit 0
+fi
+
+# Признак, который виден только целиком по файлу (наследование основы, метка процедуры),
+# считается по итоговому содержимому: точечная правка приносит кусок без объявления класса.
+whole="$added"
+if [ -f "$path" ]; then
+    whole="$added
+$(cat "$path" 2>/dev/null)"
+fi
+
+has_re() {
+    printf '%s' "$1" | RT_RE="$2" perl -0777 -ne 'exit(/$ENV{RT_RE}/s ? 0 : 1)' 2>/dev/null
+}
+
+found=''
+while IFS="$(printf '\t')" read -r scope pattern cancel replacement; do
     [ -z "$pattern" ] && continue
-    # Строка с маркером отступления снимается до сверки — вместе с ней снимается и повод.
-    printf '%s\n' "$added" | grep -v 'native-ok' | grep -qE "$pattern" || continue
-    found="${found}  ${pattern} — есть готовое: ${replacement}"$'\n'
+    case "$scope" in
+        whole) text="$whole" ;;
+        *) text="$added" ;;
+    esac
+    has_re "$text" "$pattern" || continue
+    [ -n "$cancel" ] && has_re "$text" "$cancel" && continue
+    found="${found}
+  - ${replacement}"
 done <<EOF
-$(rt_reinvented_in "$path")
+$(rt_reinvented_in "$path" 2>/dev/null)
 EOF
 
 [ -z "$found" ] && exit 0
 
-reason="Написано своё там, где готовое уже есть:
-
+reason="BLOCKED: это уже написано. Файл: ${path##*/}
 ${found}
-Работа начинается с чтения готового, а не с чистого файла — правило reuse-first. Недостающий вариант заводится у готового, а не клонируется рядом: клон забирает правки на себя и расходится с оригиналом с первой же. Если готового здесь правда не хватает, поставь маркер отступления в той же строке и объясни, чего именно нет."
+
+Порядок действий: 1) открой готовое — барель кита или базовый класс — и используй его; 2) найди в дереве экран, где этот случай уже собран, и повтори сборку; 3) если готового правда не хватает — расширяй его на месте, у готового, а не клонируй рядом: клон забирает правки на себя и расходится с оригиналом с первой же.
+Свой примитив, своя основа и свои инлайновые стили заводятся только с явного одобрения владельца, и спрашивается это до первого написанного файла. Разовое исключение помечается маркером отступления в той же строке, с объяснением, чего именно нет в готовом. Переименованием файла это не обходится."
 
 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/skill-gate-rearm.sh

@@ -1,4 +1,5 @@
 #!/usr/bin/env bash
+# rt-hook: SessionStart compact|clear
 # Взвод гейта заново. SessionStart(compact|clear).
 #
 # Гейт помнит загруженное правило по идентификатору сессии и дальше пропускает эту область

package/assets/hooks/skill-gate.sh

@@ -1,4 +1,5 @@
 #!/usr/bin/env bash
+# rt-hook: PreToolUse Edit|Write|MultiEdit|Bash
 # Гейт правил: не даёт править файл, пока не загружено правило, под которое он подпадает.
 #
 # Закон и правило, которых никто не открывает, не действуют. Напоминание в подсказке помогает
@@ -6,9 +7,17 @@
 # для каждой области, а после загрузки правила та же область проходит молча — повторов нет, и
 # стоит это почти ничего.
 #
-# Карта «файл — правило» живёт не здесь: она знает имена этого дерева, а хук их знать не может.
-# Её пишет проект в {{gateMap}} — функцией `skill_for <род вызова> <цель>`, печатающей имя
-# правила. Нет карты — гейт пропускает всё: пустой гейт лучше гейта, отбивающего наугад.
+# Карта «файл — правило» живёт не здесь, а в двух файлах рядом, и это не дублирование.
+# Умолчание — `.claude/rt-kit/defaults/gate-map.sh` — везёт пакет: деревья этой мастерской
+# устроены одинаково, и переписывать одну и ту же карту в каждом заново значило бы заводить
+# столько её редакций, сколько репозиториев. Надстройку — `.claude/rt-kit/gate-map.sh` — пишет
+# проект, и она необязательна: витрина, свой род файлов, чужая раскладка есть не у всех.
+# Обе объявляют `skill_for <род вызова> <цель> <текст правки>`, печатающую имена правил через
+# пробел; надстройка грузится второй и вправе позвать умолчание обратно — `skill_for_default`.
+# Нет ни одной — гейт пропускает всё: пустой гейт лучше гейта, отбивающего наугад.
+#
+# Род вызова — `edit`, `bash` или `browser`. Браузерная проверка — единственная область, где
+# правило нужно не под правку файла, а под инструмент: врут там не файлы, а стенд и координаты.
 #
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: любая ошибка и любой неопознанный путь пропускают правку (exit 0).
 # Сломанный гейт не имеет права остановить работу совсем.
@@ -19,16 +28,20 @@ input="$(cat 2>/dev/null)"
 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
+# Умолчание карты ищется и рядом с самим хуком: уезжают они вместе.
+rt_hooks_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+for map in "$rt_hooks_dir/../rt-kit/defaults/gate-map.sh" "$rt_hooks_dir/../defaults/gate-map.sh" "${CLAUDE_PROJECT_DIR:-.}/.claude/rt-kit/defaults/gate-map.sh" "${CLAUDE_PROJECT_DIR:-.}/.claude/rt-kit/gate-map.sh"; do
+    # shellcheck disable=SC1090
+    [ -f "$map" ] && . "$map" 2>/dev/null
+done
 command -v skill_for >/dev/null 2>&1 || exit 0
 
 req=""
 target=""
 case "$tool" in
-    Edit|Write|MultiEdit)
+    # Инструмент среды заводит файл теми же двумя данными, только называет их иначе — без этой
+    # ветки файл заводился мимо гейта.
+    Edit|Write|MultiEdit|mcp__webstorm__create_new_file)
         target="$(printf '%s' "$input" | jq -r '.tool_input.file_path // .tool_input.pathInProject // empty' 2>/dev/null)"
         [ -z "$target" ] && exit 0
         # Путь от корня проекта приводится к абсолютному один раз: иначе карту пришлось бы
@@ -43,25 +56,72 @@ case "$tool" in
             "${CLAUDE_PROJECT_DIR:-.}"/*) ;;
             *) exit 0 ;;
         esac
-        req="$(skill_for edit "$target" 2>/dev/null)"
+        # Текст правки идёт карте вторым доводом: есть правила, которые вступают не от того,
+        # ЧТО за файл правится, а от того, ЧТО в него пишут, — обращение к среде исполнения
+        # приходит в обычный сервис, а число-настройка в обычный класс.
+        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)"
         ;;
-    Bash)
+    # Терминал среды исполняет ту же командную строку и кладёт её в то же поле: без этой ветки
+    # коммит из него не требовал правила, тогда как тот же коммит из оболочки требовал.
+    Bash|mcp__webstorm__execute_terminal_command|mcp__webstorm__execute_tool)
         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)"
+        # Универсальный исполнитель прячет настоящую команду во вложенной строке.
+        if [ "$tool" = "mcp__webstorm__execute_tool" ] && command -v perl >/dev/null 2>&1; then
+            inner="$(printf '%s' "$target" | perl -0ne '
+                if (/--command(?:=|\s+)(?:"((?:[^"\\]|\\.)*)"|\x27([^\x27]*)\x27|(.+))/s) {
+                    print defined $1 ? $1 : (defined $2 ? $2 : $3);
+                }
+            ' 2>/dev/null)"
+            [ -n "$inner" ] && target="$inner"
+        fi
+        req="$(skill_for bash "$target" "" 2>/dev/null)"
+        ;;
+    mcp__claude-in-chrome__*)
+        req="$(skill_for browser "$tool" "" 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
+root="${CLAUDE_PROJECT_DIR:-.}"
+rules_dir="${RT_RULES_DIR:-.claude/skills}"
+want=""
+for name in $req; do
+    # Правила, которого в дереве нет, гейт не требует. Карта умолчания называет и то, от чего
+    # дерево отказалось списком: правило предметной области, чужой род файлов. Отказ «загрузи
+    # правило X» на такое имя — отказ без действия: загружать нечего, и работа встаёт совсем.
+    [ -f "$root/$rules_dir/${name}/SKILL.md" ] || continue
+    # Принимается и голое имя правила, и имя с областью каталога («<каталог>:<имя>»).
+    if [ -f "$loaded" ] && grep -qE "^([^:]*:)?$(printf '%s' "$name" | sed 's/[][\.*^$/]/\\&/g')$" "$loaded" 2>/dev/null; then
+        continue
+    fi
+    want="$name"
+    break
+done
+[ -z "$want" ] && exit 0
+req="$want"
 
 reason="Отбито гейтом правил: загрузи правило «${req}» инструментом Skill и повтори действие. Для этой области это происходит один раз за сессию."
+
+# Правило называет свой закон одним словом, а слоёв законов два: общий лежит в корне, закон
+# приложения — в каталоге под ним. Путь ищется, а не собирается из имени, иначе отказ ведёт в
+# несуществующий файл ровно у тех правил, чей закон предметен.
+laws_dir="${RT_LAWS_DIR:-docs/constitution}"
+law="$(sed -n 's/^law:[[:space:]]*//p' "$root/$rules_dir/${req}/SKILL.md" 2>/dev/null | head -1)"
+if [ -n "$law" ]; then
+    law_path="$laws_dir/${law}.md"
+    [ -f "$root/$law_path" ] || law_path="$laws_dir/application/${law}.md"
+    [ -f "$root/$law_path" ] \
+        && reason="Отбито гейтом правил: загрузи правило «${req}» инструментом Skill — оно применяет закон ${law_path} к этому дереву — и повтори действие. Для этой области это происходит один раз за сессию."
+fi
+
 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

@@ -1,4 +1,5 @@
 #!/usr/bin/env bash
+# rt-hook: PostToolUse Skill
 # Запись о загруженном правиле. PostToolUse на инструменте `Skill`.
 #
 # Гейт обязан знать, загружено правило или нет, а спросить об этом ему некого: инструмент о