@rt-tools/agent-kit 0.12.0 → 0.13.0

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

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse Bash|mcp__webstorm__execute_terminal_command|mcp__webstorm__execute_tool
-# Требует: hooks/profile-check.sh, hooks/deny-tail.sh
+# Требует: hooks/git-guard-delivery-folder.sh, hooks/profile-check.sh, hooks/deny-tail.sh
 # Гард поставки. PreToolUse на заведении ветки, пуше и открытии заявки на слияние.
 #
 # Закон о поставке требует трёх вещей, которых обычно не проверяет ничто: правка начинается с
@@ -152,6 +152,12 @@ fault() {
 }— $1"
 }
 
+# Условия о папке задачи вынесены соседним файлом: у папки свой предмет, свой обход и своя
+# запись в архиве, а вместе с разбором команды и очередью работ они переросли предел длины.
+# Подключается он после `deny` и `fault` — обе зовутся изнутри.
+# shellcheck disable=SC1090
+[ -f "$rt_hooks_dir/git-guard-delivery-folder.sh" ] && . "$rt_hooks_dir/git-guard-delivery-folder.sh" 2>/dev/null
+
 # Отказ по накопленному. Пусто — вызывающая сторона идёт дальше.
 deny_faults() {
     [ -z "$faults" ] && return 0
@@ -161,21 +167,6 @@ deny_faults() {
 ${faults}"
 }
 
-# Подсказка вместо отказа: на открытии PR папка ещё нужна. Решения подсказка не несёт,
-# команда идёт дальше своим ходом.
-hint() {
-    jq -n --arg c "$1" '{hookSpecificOutput:{hookEventName:"PreToolUse",additionalContext:$c}}' 2>/dev/null
-    exit 0
-}
-
-# Есть ли папка задачи в ветке. Смотрим содержимое ветки, а не рабочее дерево: если папку
-# удалили, но не закоммитили, проверка прошла бы, а папка всё равно уехала бы в main. Имя
-# ветки подставляем целиком, вместе с косой: у ветки вида `chore/312-slug` папка лежит во
-# вложенном каталоге.
-folder_in_branch() {
-    git ls-tree -d --name-only HEAD -- "$1" 2>/dev/null | head -1
-}
-
 check_task() {
     number="$1"
     where="$2"
@@ -292,7 +283,7 @@ command -v rt_delivery_signature >/dev/null 2>&1 && rt_delivery_signature
 #
 # Возврат заявки в черновик под требование не подпадает: он делает ровно то, чего гард и
 # добивается, — снимает с работы вид готовой.
-if printf '%s' "$cmd" | grep -qE '(^|[;&|(]|&&|\|\|)[[:space:]]*(gh[[:space:]]+pr[[:space:]]+ready|glab[[:space:]]+mr[[:space:]]+update[^|;&]*--ready)([[:space:]]|$)' \
+if printf '%s' "$cmd" | grep -qE "${RT_CMD_BOUND}(gh[[:space:]]+pr[[:space:]]+ready|glab[[:space:]]+mr[[:space:]]+update[^|;&]*--ready)([[:space:]]|\$)" \
     && ! printf '%s' "$cmd" | grep -q -- '--undo'; then
     # Ссылка на заявку необязательна: без неё клиент берёт заявку текущей ветки, и это самая
     # короткая форма вызова. Требовать номер значило бы снимать всё требование одним пробелом.
@@ -341,59 +332,20 @@ fi
 
 # --- слияние заявки ----------------------------------------------------------------------
 #
-# Папку задачи разбирают тем же PR, что и работу. После слияния этого уже никто не сделает:
-# работа перешла к следующей задаче, а PR закрыт. Раньше слияния требовать нельзя — пока идёт
-# ревью, plan.md нужен на диске, иначе гард хода работы не даст править код.
+# Второй рубеж того же условия, что стоит на открытии заявки: он ловит слияние, идущее командой.
 # Команду ищем от начала строки или после разделителя, а не где угодно в тексте. Иначе гард
 # отбивает сообщение, где `gh pr merge` просто упомянут в кавычках, — так он и сработал на
 # правке этого же текста. Полностью подстроку в кавычках так не отсечь, но случайное упоминание
 # внутри слова или пути мимо уже не пройдёт.
-if printf '%s' "$cmd" | grep -qE '(^|[;&|(]|&&|\|\|)[[:space:]]*(gh[[:space:]]+pr[[:space:]]+merge|glab[[:space:]]+mr[[:space:]]+merge|az[[:space:]]+repos[[:space:]]+pr[[:space:]]+update)([[:space:]]|$)'; then
-    [ -n "$tasks_dir" ] || exit 0   # ведения работы папкой в дереве нет
-
-    merge_branch="$(git branch --show-current 2>/dev/null)"
-    [ -z "$merge_branch" ] && exit 0
-    rt_task_branch_ok "$merge_branch" || exit 0   # за беззадачной веткой папки не стоит
-
-    folder="$tasks_dir/$merge_branch"
-
-    # Сначала ищем обход в самой команде — это работает и без сети. Если читать только
-    # тело PR, то без сети гард отбил бы слияние, причина которого в этом теле и написана.
-    printf '%s' "$cmd" | grep -qiE "$folder_skip_re" && exit 0
-
-    merge_number="$(printf '%s' "$cmd" | sed -nE 's/.*(pr|mr)[[:space:]]+(merge|update)[[:space:]]+([0-9]+).*/\3/p' | head -1)"
-    if [ -n "$merge_number" ] && rt_needs rt_report_body git-guard-delivery; then
-        body="$(cd "$root" && rt_report_body "$merge_number" 2>/dev/null)"
-        [ -n "$body" ] && printf '%s' "$body" | grep -qiE "$folder_skip_re" && exit 0
-    fi
-
-    lying="$(folder_in_branch "$folder")"
-    [ -n "$lying" ] \
-        && deny "BLOCKED: в ветке осталась папка задачи «${lying}» — она уедет в главную. Разобрать её потом будет некому: работа перейдёт к следующей задаче, а этот PR закроется. Перенеси в «${archive_dir:-архив}» то, что объясняет принятые решения, остальное удали и повтори. Если работа вливается частями, поставь в тело PR строку «Task-folder-skip: <причина>»."
-
-    # Запись в архиве спрашиваем только у ветки, которая папку удалила. Иначе проверка
-    # цеплялась бы к работе, у которой папки и не было. Без общего предка с главной веткой
-    # сравнивать не с чем — тогда молчим.
-    [ -n "$archive_dir" ] || exit 0
-    base="$(git merge-base "$main_branch" HEAD 2>/dev/null)"
-    [ -z "$base" ] && exit 0
-
-    had="$(git ls-tree -d --name-only "$base" -- "$folder" 2>/dev/null | head -1)"
-    [ -z "$had" ] && had="$(git log "$base..HEAD" --diff-filter=A --name-only --pretty=format: -- "$folder" 2>/dev/null | head -1)"
-    [ -z "$had" ] && exit 0
-
-    gained="$(git diff --name-only --diff-filter=A "$base" HEAD -- "$archive_dir" 2>/dev/null | head -1)"
-    [ -z "$gained" ] \
-        && deny "BLOCKED: папку задачи удалили, но в «${archive_dir}» ветка ничего не добавила. Удалить проще, чем разобрать, — и вместе с папкой пропадает разбор просьбы, единственная запись слов владельца. Перенеси то, что объясняет принятые решения, одним файлом с понятным именем и повтори."
-
-    exit 0
+if printf '%s' "$cmd" | grep -qE "${RT_CMD_BOUND}(gh[[:space:]]+pr[[:space:]]+merge|glab[[:space:]]+mr[[:space:]]+merge|az[[:space:]]+repos[[:space:]]+pr[[:space:]]+update)([[:space:]]|\$)"; then
+    rt_delivery_merge_folder
 fi
 
 # --- открытие заявки на слияние ----------------------------------------------------------
 # Команду ищем от начала строки или после разделителя — по той же причине, что и слияние:
 # упоминание в кавычках командой не является.
 printf '%s' "$cmd" \
-    | grep -qE '(^|[;&|(]|&&|\|\|)[[:space:]]*(gh[[:space:]]+pr[[:space:]]+create|glab[[:space:]]+mr[[:space:]]+create|az[[:space:]]+repos[[:space:]]+pr[[:space:]]+create)([[:space:]]|$)' \
+    | grep -qE "${RT_CMD_BOUND}(gh[[:space:]]+pr[[:space:]]+create|glab[[:space:]]+mr[[:space:]]+create|az[[:space:]]+repos[[:space:]]+pr[[:space:]]+create)([[:space:]]|\$)" \
     || exit 0
 
 branch="$(git branch --show-current 2>/dev/null)"
@@ -474,17 +426,17 @@ fi
 
 check_task "$number" "заявка с ветки «${branch}»" да
 
+# Папка задачи разбирается до открытия заявки, а не после одобрения. Прежде здесь стояло
+# напоминание, а требование — на слиянии: считалось, что папка нужна на диске всё время
+# разбора, потому что правку по замечаниям без замысла отбивает гард хода работы. Владелец же
+# вливает, как только видит зелёное, и закрывающему коммиту места не остаётся — трижды подряд
+# папка уехала в главную неразобранной, а гард слияния этого не видел вовсе: кнопку нажимает
+# человек на хостинге, и до него гард не достаёт. Разбор переехал сюда, а замысел после уборки
+# гард хода работы берёт из истории ветки, а не с диска.
+rt_delivery_open_folder
+
 # Всё несошедшееся названо здесь, разом: до этой строки собирались условия, каждое из которых
 # прежде отбивало вызов в одиночку.
 deny_faults
 
-# Сейчас папка ещё нужна: правки по замечаниям ревью идут в эту же ветку, а без plan.md их не
-# пропустит гард хода работы. Поэтому здесь только напоминание. Требование стоит на слиянии —
-# там папка уже не нужна, а вред от неё как раз и наступает.
-if [ -n "$tasks_dir" ]; then
-    lying="$(folder_in_branch "$tasks_dir/$branch")"
-    [ -n "$lying" ] \
-        && hint "В ветке лежит папка задачи «${lying}». Разбери её до слияния, этим же PR: потом за неё уже никто не возьмётся. На слиянии это будет отказ, а не напоминание."
-fi
-
 exit 0

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

@@ -46,7 +46,7 @@ cmd="$(rt_hook_cmd)"
 # подстрокой «git push» пуш не поймать — помощник учётных данных и заголовок запроса ставятся
 # ключами `-c` между ними, и ровно этой формой здесь и пушат. Пока признаком была подстрока,
 # весь набор гейта на таком пуше не гонялся вовсе, а молчание гарда читалось как «зелено».
-printf '%s' "$cmd" | grep -qE '(^|[;&|(]|&&|\|\|)[[:space:]]*git([[:space:]]|$)' || exit 0
+printf '%s' "$cmd" | grep -qE "${RT_CMD_BOUND}git([[:space:]]|\$)" || exit 0
 
 # Отложенная правка пушем не бывает: `git stash push` кладёт правку в тайник этой же машины и
 # наружу не отправляет ничего. Слово `push` в ней стоит отдельным, и без этой строки гард гонял
@@ -71,7 +71,7 @@ esac
 #
 # Судится переключение на существующую ветку. Заведение новой (`checkout -b`, `switch -c`)
 # сюда не попадает: у свежей ветки дерево то же самое, что и было.
-if printf '%s' "$cmd" | grep -qE '(^|[;&|(]|&&|\|\|)[[:space:]]*git[[:space:]]+(checkout|switch)[[:space:]]+' &&
+if printf '%s' "$cmd" | grep -qE "${RT_CMD_BOUND}git[[:space:]]+(checkout|switch)[[:space:]]+" &&
     ! printf '%s' "$cmd" | grep -qE 'git[[:space:]]+(checkout[[:space:]]+-b|switch[[:space:]]+-c)([[:space:]]|$)'; then
     reason="BLOCKED: переключение ветки и пуш одной командой. Набор гейта гоняется в том дереве, какое лежит на момент разбора команды, — то есть по ПРЕЖНЕЙ ветке, а не по той, что уходит на хостинг. Зелёный набор при этом читается как проверка ушедшего, хотя проверял он другое. Раздели вызовы: сперва переключись, затем отдельной командой пушь."
     # Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть.

package/assets/hooks/hook-input.sh

@@ -47,6 +47,29 @@ rt_hook_field() {
     printf '%s' "$RT_HOOK_INPUT" | jq -r "${path} // empty" 2>/dev/null
 }
 
+# НАЧАЛО ВЫЗОВА В КОМАНДНОЙ СТРОКЕ. Приставка образца, которым гард узнаёт свой вызов: команда
+# стоит в начале строки, за разделителем — и после любого числа присваиваний переменных
+# окружения перед её именем.
+#
+# Присваивания входят сюда потому, что вызов с ними — обычная форма, и часть набора требует её
+# прямо: личность вызова, открывающего заявку, видна из команды только явной подстановкой
+# токена. Признак, не знавший о присваиваниях, на этой форме слепнул молча — он не отказывал и
+# не предупреждал, он не считал вызов вызовом, и весь предмет гарда оставался несудимым. Так
+# прошли мимо своих гардов пуш, открытие заявки, снятие черновика и слияние: коммит с чужой
+# подписью уехал в главную ветку, а запрет на слияние агентом снимался подстановкой токена.
+#
+# Значение присваивания берётся без пробелов: `ИМЯ="a b"` в кавычках сюда не подпадает, и вызов
+# за ним останется несудимым. Пробел внутри значения перед вызовом встречается редко, а
+# образец, разбирающий кавычки, ошибается в другую сторону — считает вызовом то, что им не
+# является. Признак обязан ошибаться в сторону лишнего срабатывания: гард, не узнавший вызов,
+# молчит и выглядит исправным, а сработавший на лишнем виден сразу и правится.
+#
+# Само по себе присваивание вызовом не считается: за ним обязано стоять имя команды.
+#
+# Объявлено это одним местом, а не литералом в каждом гарде: разойдясь, копии чинятся по одной
+# и молчат о том, что остальные остались слепыми.
+RT_CMD_BOUND='(^|[;&|(]|&&|\|\|)[[:space:]]*([A-Za-z_][A-Za-z0-9_]*=[^[:space:]]*[[:space:]]+)*'
+
 # Поля, которые спрашивают все гарды.
 rt_hook_tool() { rt_hook_field RT_HOOK_TOOL '.tool_name'; }
 rt_hook_cmd() { rt_hook_field RT_HOOK_CMD '.tool_input.command'; }

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

@@ -0,0 +1,107 @@
+#!/usr/bin/env bash
+# rt-hook: PreToolUse Write|Bash|mcp__webstorm__create_new_file|mcp__webstorm__execute_terminal_command|mcp__webstorm__execute_tool
+# Требует: hooks/deny-tail.sh
+# Гард затирания надстройки: запись поверх — не то же самое, что правка.
+#
+# Надстройка дерева сливается с ресурсом пакета по разделу «## »: раздел, который дерево
+# переписало, замещает пакетный, а остальные приходят из пакета. Файл надстройки поэтому
+# накапливается — разделы в него дописывают разные ветки и разные заходы, — и выглядит он как
+# обычный текст, который можно положить целиком.
+#
+# Положенный целиком, он уносит с собой все разделы, которых эта правка не касалась. Пропажу не
+# видно ничем: раскладка сходится, проверки зелёные, а пакетный раздел молча вернулся на место
+# того, что дерево о себе говорило. Заметит это тот, кто через месяц удивится, почему правило
+# снова требует чужих имён.
+#
+# ЧТО СУДИТСЯ. Запись файла целиком поверх существующей непустой надстройки: инструмент записи,
+# перенаправление `>`, `tee` без дописывания, копирование поверх. Дописывание в конец — `>>`,
+# `tee -a` — и правка по месту проходят: они ничего не уносят.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ: нет `jq`, битый ввод, чужой инструмент, файла нет, файл пуст —
+# правка РАЗРЕШАЕТСЯ. Сломанный гард не имеет права заклинить работу.
+
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
+
+rt_hook_read
+input="$RT_HOOK_INPUT"
+[ -z "$input" ] && exit 0
+command -v jq >/dev/null 2>&1 || exit 0
+
+rt_hooks_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# shellcheck disable=SC1090
+[ -f "$rt_hooks_dir/deny-tail.sh" ] && . "$rt_hooks_dir/deny-tail.sh" 2>/dev/null
+command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { printf ''; }
+
+deny() {
+    # 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 guard-deny res=override-write-guard
+
+    reason="$1 $(rt_deny_tail "$2")"
+    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
+}
+
+# Цели записи поверх, названные командой прямо. Дописывание сюда не входит: `>>` прячется до
+# разбора и обратно не разворачивается, `tee` берётся только без довода о дописывании.
+rt_overwrite_targets() {
+    tr "\"'\`" '   ' \
+        | sed -E 's/>>/\
+APPEND/g' \
+        | sed -E 's/>/\
+>/g' \
+        | sed -nE '
+            s/^>[[:space:]]*([^[:space:]|&;]+).*/\1/p
+            s/(^|.*[[:space:]])tee[[:space:]]+([^-[:space:]][^[:space:]|&;]*).*/\2/p
+            s/(^|.*[[:space:]])(cp|mv|install)[[:space:]]+([^[:space:]]+[[:space:]]+)+([^[:space:]|&;]+).*/\4/p
+        ' \
+        | sort -u
+}
+
+tool="$(rt_hook_tool)"
+candidates=""
+case "$tool" in
+    Write | mcp__webstorm__create_new_file)
+        candidates="$(printf '%s' "$input" | jq -r '.tool_input.file_path // .tool_input.pathInProject // empty' 2>/dev/null)"
+        ;;
+    Bash | mcp__webstorm__execute_terminal_command | mcp__webstorm__execute_tool)
+        cmd="$(rt_hook_cmd)"
+        [ -z "$cmd" ] && exit 0
+        candidates="$(printf '%s' "$cmd" | rt_overwrite_targets)"
+        ;;
+    *) exit 0 ;;
+esac
+[ -z "$candidates" ] && exit 0
+
+root="${CLAUDE_PROJECT_DIR:-.}"
+overrides_dir="${RT_OVERRIDES_DIR:-.claude/rt-kit/overrides}"
+
+while IFS= read -r candidate; do
+    [ -z "$candidate" ] && continue
+    case "$candidate" in
+        /*) relative="${candidate#"$root"/}" ;;
+        *)
+            relative="$candidate"
+            candidate="$root/$candidate"
+            ;;
+    esac
+    case "$relative" in "$overrides_dir"/*) ;; *) continue ;; esac
+    [ -f "$candidate" ] || continue
+
+    lines="$(wc -l <"$candidate" 2>/dev/null | tr -d ' ')"
+    [ -z "$lines" ] && continue
+    [ "$lines" -eq 0 ] && continue
+
+    sections="$(grep -c '^## ' "$candidate" 2>/dev/null || printf '0')"
+    resource="${relative#"$overrides_dir"/}"
+
+    deny "BLOCKED by override-write-guard: «${relative}» — надстройка этого дерева, и в ней уже лежит ${lines} строк, разделов «## » — ${sections}. Запись целиком уносит все разделы, которых эта правка не касалась, и на их место молча возвращается пакетный текст ресурса «${resource}»: раскладка после этого сходится, проверки зелёные, а сказанного деревом о себе больше нет. Правь по месту — правкой раздела, а не записью файла." \
+        "новый раздел дописывается в конец: надстройка сливается с пакетным ресурсом по заголовку «## », и пакетный текст замещается только теми разделами, которые дерево назвало"
+done <<EOF
+$candidates
+EOF
+
+exit 0

package/assets/hooks/rerun-guard.sh

@@ -49,7 +49,7 @@ done
 
 # Вызов перезапуска: слово перезапуска отдельным словом рядом со словом прогона.
 host_cli="${RT_HOST_CLI:-gh}"
-printf '%s' "$cmd" | grep -qE "(^|[;&|(]|&&|\|\|)[[:space:]]*${host_cli}([[:space:]]|$)" || exit 0
+printf '%s' "$cmd" | grep -qE "${RT_CMD_BOUND}${host_cli}([[:space:]]|\$)" || exit 0
 printf '%s' "$cmd" | grep -qE '(^|[[:space:]])(run|workflow)([[:space:]]|$)' || exit 0
 printf '%s' "$cmd" | grep -qE '(^|[[:space:]])rerun([[:space:]]|$)' || exit 0
 

package/assets/hooks/rule-source-guard.sh

@@ -0,0 +1,126 @@
+#!/usr/bin/env bash
+# rt-hook: PreToolUse Edit|Write|MultiEdit|Bash|mcp__webstorm__create_new_file|mcp__webstorm__execute_terminal_command|mcp__webstorm__execute_tool
+# Требует: hooks/profile-check.sh, hooks/deny-tail.sh
+# Гард места правки: слой правил чинится там, где сломано, а не там, где виден.
+#
+# Слой правил правит тот же исполнитель, которым слой правил управляет, и разницы между
+# «исполняю правило» и «правлю правило» в дереве не видно ничем: разложенная копия лежит рядом
+# с обычными файлами и правится так же. Правка доходит до диска и не доходит до места, где
+# промах чинится: в дереве она видна, в пакете её нет, а через месяц раскладка отказывает по
+# правленому файлу целиком — и цену платит тот, кто в этот день правил соседний ресурс.
+#
+# Знал об этом только `sync --check`, и говорил он на следующей раскладке, то есть в чужой
+# ветке и чужим ходом. Гард говорит в минуту правки и называет адрес: источник пакета, если
+# дерево его держит, иначе — надстройку.
+#
+# ЧТО СУДИТСЯ. Файл, который правят, несёт шапку раскладки: `rt-kit v<версия> · <ресурс> ·
+# <дайджест>`. Ресурс из неё и есть адрес: `<источники>/<ресурс>` в дереве пакета,
+# `.claude/rt-kit/overrides/<ресурс>` у потребителя.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ: нет `jq`, битый ввод, чужой инструмент, файла нет, шапки в нём нет,
+# не git-репозиторий — правка РАЗРЕШАЕТСЯ. Сломанный гард не имеет права заклинить работу.
+
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
+
+rt_hook_read
+input="$RT_HOOK_INPUT"
+[ -z "$input" ] && exit 0
+command -v jq >/dev/null 2>&1 || exit 0
+
+rt_hooks_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+for profile in "$rt_hooks_dir/../rt-kit/defaults/project.sh" "$rt_hooks_dir/../defaults/project.sh" "${CLAUDE_PROJECT_DIR:-.}/.claude/rt-kit/defaults/project.sh" "${CLAUDE_PROJECT_DIR:-.}/.claude/rt-kit/project.sh"; do
+    # shellcheck disable=SC1090
+    [ -f "$profile" ] && . "$profile" 2>/dev/null
+done
+
+# 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; }
+
+# shellcheck disable=SC1090
+[ -f "$rt_hooks_dir/deny-tail.sh" ] && . "$rt_hooks_dir/deny-tail.sh" 2>/dev/null
+command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { printf ''; }
+
+deny() {
+    # 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 guard-deny res=rule-source-guard
+
+    reason="$1 $(rt_deny_tail "$2")"
+    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
+}
+
+# Цели записи, названные командой прямо. Печатает по одной в строке.
+rt_write_targets() {
+    tr "\"'\`" '   ' \
+        | sed -E 's/>>?/\n>/g' \
+        | sed -nE '
+            s/^>[[:space:]]*([^[:space:]|&;]+).*/\1/p
+            s/(^|.*[[:space:]])tee[[:space:]]+(-a[[:space:]]+)?([^[:space:]|&;]+).*/\3/p
+            s/(^|.*[[:space:]])sed[[:space:]]+-i[[:space:]]+([^[:space:]]+[[:space:]]+)*([^[:space:]|&;]+)$/\3/p
+            s/(^|.*[[:space:]])(cp|mv|install)[[:space:]]+([^[:space:]]+[[:space:]]+)+([^[:space:]|&;]+).*/\4/p
+        ' \
+        | sort -u
+}
+
+tool="$(rt_hook_tool)"
+candidates=""
+case "$tool" in
+    Edit | Write | MultiEdit | mcp__webstorm__create_new_file)
+        candidates="$(printf '%s' "$input" | jq -r '.tool_input.file_path // .tool_input.pathInProject // empty' 2>/dev/null)"
+        ;;
+    Bash | mcp__webstorm__execute_terminal_command | mcp__webstorm__execute_tool)
+        cmd="$(rt_hook_cmd)"
+        [ -z "$cmd" ] && exit 0
+        # Здесь берётся не общий признак записи, а цель, названная в команде прямо:
+        # перенаправление, `tee`, правка на месте, копирование поверх. Общий признак широк
+        # намеренно — в нём и имя интерпретатора, — и запуск разложенной проверки читался бы
+        # как правка её самой. Отбитие на чтении стоит дороже пропуска: гард, мешающий читать,
+        # выключают в первый же день.
+        #
+        # Снятие копии сюда не входит намеренно: снятый файл раскладка кладёт заново, и так
+        # чинят копию, которую переписал форматтер.
+        candidates="$(printf '%s' "$cmd" | rt_write_targets)"
+        ;;
+    *) exit 0 ;;
+esac
+[ -z "$candidates" ] && exit 0
+
+root="${CLAUDE_PROJECT_DIR:-.}"
+
+# Каталог источников пакета в этом дереве. Есть он только у дерева, которое пакет и везёт; у
+# потребителя источника нет вовсе, и адрес правки у него один — надстройка.
+sources=""
+if rt_needs rt_kit_sources_dir rule-source-guard; then
+    sources="$(rt_kit_sources_dir 2>/dev/null)"
+fi
+
+while IFS= read -r candidate; do
+    [ -z "$candidate" ] && continue
+    case "$candidate" in
+        /*) ;;
+        *) candidate="$root/$candidate" ;;
+    esac
+    [ -f "$candidate" ] || continue
+
+    # Шапка стоит в начале файла, но не первой строкой: у сценария её отодвигает `#!`, у
+    # правила — заголовок с именем и родом ресурса. Десяти строк хватает обоим, а читать файл
+    # целиком нельзя: гард стоит на каждой правке.
+    resource="$(head -12 "$candidate" 2>/dev/null | sed -nE 's/.*rt-kit v[^ ]+ · ([^ ]+) · [0-9a-f]+.*/\1/p' | head -1)"
+    [ -z "$resource" ] && continue
+
+    if [ -n "$sources" ] && [ -f "$root/$sources/$resource" ]; then
+        deny "BLOCKED by rule-source-guard: «${candidate#"$root"/}» разложен пакетом, и правка на его месте теряется на следующей раскладке — а до тех пор раскладка отказывает по этому файлу целиком, и цену платит тот, кто в этот день правит соседний ресурс. Ресурс — «${resource}». Правь источник: ${sources}/${resource} — потом собери пакет и разложи." \
+            "правка, верная только этому дереву, идёт в надстройку .claude/rt-kit/overrides/${resource} — она сливается по разделу «## » и раскладку переживает"
+    fi
+
+    deny "BLOCKED by rule-source-guard: «${candidate#"$root"/}» разложен пакетом @rt-tools/agent-kit, и правка на его месте теряется на следующей раскладке. Ресурс — «${resource}». Правь надстройку: .claude/rt-kit/overrides/${resource} — она сливается по разделу «## » и раскладку переживает." \
+        "то, что верно любому дереву, правится в самом пакете и приезжает сюда новой редакцией"
+done <<EOF
+$candidates
+EOF
+
+exit 0

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

@@ -110,6 +110,7 @@ EOF
 
 # Каталог папок задач: у дерева он свой, но имя обычно общее.
 tasks_dir="${RT_TASKS_DIR:-docs/tasks}"
+main_branch="${RT_MAIN_BRANCH:-main}"
 
 # Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть. Файл
 # может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
@@ -146,6 +147,23 @@ root="$(git rev-parse --show-toplevel 2>/dev/null)"
 dir="$root/$tasks_dir/$branch"
 plan="$dir/plan.md"
 
+# Папка, разобранная коммитом этой ветки, — признак того, что работа отдана. Замысел с диска к
+# этой минуте снят намеренно: уборка стоит до открытия заявки, потому что кнопку слияния
+# нажимает человек на хостинге и закрывающему коммиту места после одобрения не остаётся.
+# Правка после уборки — это правка по замечаниям разбора, и требовать под неё замысла значило
+# бы запирать ветку собственным порядком. Признак берётся из истории ветки, а не с диска:
+# снесённая, но не закоммиченная папка отданной работы не означает.
+folder_archived() {
+    [ -n "$(git ls-tree -d --name-only HEAD -- "$tasks_dir/$branch" 2>/dev/null | head -1)" ] && return 1
+    base="$(git merge-base "$main_branch" HEAD 2>/dev/null)"
+    [ -z "$base" ] && return 1
+    had="$(git ls-tree -d --name-only "$base" -- "$tasks_dir/$branch" 2>/dev/null | head -1)"
+    [ -z "$had" ] && had="$(git log "$base..HEAD" --diff-filter=A --name-only --pretty=format: -- "$tasks_dir/$branch" 2>/dev/null | head -1)"
+    [ -n "$had" ]
+}
+
+folder_archived && exit 0
+
 if [ ! -f "$plan" ]; then
     deny "BLOCKED by task-flow: нет замысла — '${tasks_dir}/${branch}/plan.md'. Собери папку задачи с образца (cp -r ${tasks_dir}/_template ${tasks_dir}/${branch}) и заполни шапку, след задачи и этапы, затем повтори. Правило — скил task-flow."
 fi

package/assets/hooks/turn-exit-guard.sh

@@ -74,6 +74,23 @@ case "$state" in
     работа-отдана | влито) exit 0 ;;
 esac
 
+# То же самое, но объявить это на диске уже нечем: папка задачи разбирается до открытия заявки,
+# и ход работы уезжает вместе с ней. Признак берётся из истории ветки — папка, снятая её
+# коммитом. Без этой ветки хвост работы судился бы вторым признаком, то есть отбивался бы за
+# ход, в котором исполнитель ждёт чужого прогона и ничего в дереве не двигает.
+folder_archived() {
+    [ -n "$branch" ] || return 1
+    [ -n "$(git ls-tree -d --name-only HEAD -- "$tasks_dir/$branch" 2>/dev/null | head -1)" ] && return 1
+    main_branch="${RT_MAIN_BRANCH:-main}"
+    base="$(git merge-base "$main_branch" HEAD 2>/dev/null)"
+    [ -z "$base" ] && return 1
+    had="$(git ls-tree -d --name-only "$base" -- "$tasks_dir/$branch" 2>/dev/null | head -1)"
+    [ -z "$had" ] && had="$(git log "$base..HEAD" --diff-filter=A --name-only --pretty=format: -- "$tasks_dir/$branch" 2>/dev/null | head -1)"
+    [ -n "$had" ]
+}
+
+[ -z "$progress" ] && folder_archived && exit 0
+
 # Следующий шаг из хода работы — его страж и называет в отказе: исполнитель, которому сказано
 # только «работа не кончена», перечитывает ту же строку сам.
 next_step=""

package/assets/patterns/git-workflow-pr.azure.md

@@ -114,17 +114,17 @@ az repos pr update --id 205 --description "$(cat тело.md)"
 
 ## Оставшийся шаг
 
-После одобрения ветка получает ещё один коммит — разбор папки задачи, — и только потом
-вливается. До этого коммита вливать рано: папка уедет в главную ветку неразобранной.
+Папка задачи разобрана коммитом `<sha>` — за работой убрано. Осталось дождаться прогона и снять
+черновик; до этого кнопка слияния заблокирована хостингом.
 ```
 
 Раздел «Оставшийся шаг» стоит последним и переписывается тем же вызовом, что и остальное тело,
-— в тот ход, которым папка разбирается и снимается черновик:
+— в тот ход, которым снимается черновик:
 
 ```markdown
 ## Оставшийся шаг
 
-Не осталось: папка задачи разобрана коммитом `<sha>`, черновик снят. Можно вливать.
+Не осталось: прогон зелёный, черновик снят. Можно вливать.
 ```
 
 Стоит он там потому, что решение о слиянии принимается на этой странице, а не в переписке:

package/assets/patterns/git-workflow-pr.github.md

@@ -141,17 +141,17 @@ Closes #86
 
 ## Оставшийся шаг
 
-После одобрения ветка получает ещё один коммит — разбор папки задачи, — и только потом
-вливается. До этого коммита вливать рано: папка уедет в главную ветку неразобранной.
+Папка задачи разобрана коммитом `<sha>` — за работой убрано. Осталось дождаться прогона и снять
+черновик; до этого кнопка слияния заблокирована хостингом.
 ```
 
 Раздел «Оставшийся шаг» стоит последним и переписывается тем же вызовом, что и остальное тело,
-— в тот ход, которым папка разбирается и снимается черновик:
+— в тот ход, которым снимается черновик:
 
 ```markdown
 ## Оставшийся шаг
 
-Не осталось: папка задачи разобрана коммитом `<sha>`, черновик снят. Можно вливать.
+Не осталось: прогон зелёный, черновик снят. Можно вливать.
 ```
 
 Стоит он там потому, что решение о слиянии принимается на этой странице, а не в переписке:

package/assets/patterns/git-workflow-pr.gitlab.md

@@ -125,17 +125,17 @@ Closes #86
 
 ## Оставшийся шаг
 
-После одобрения ветка получает ещё один коммит — разбор папки задачи, — и только потом
-вливается. До этого коммита вливать рано: папка уедет в главную ветку неразобранной.
+Папка задачи разобрана коммитом `<sha>` — за работой убрано. Осталось дождаться прогона и снять
+черновик; до этого кнопка слияния заблокирована хостингом.
 ```
 
 Раздел «Оставшийся шаг» стоит последним и переписывается тем же вызовом, что и остальное
-описание, — в тот ход, которым папка разбирается и снимается черновик:
+описание, — в тот ход, которым снимается черновик:
 
 ```markdown
 ## Оставшийся шаг
 
-Не осталось: папка задачи разобрана коммитом `<sha>`, черновик снят. Можно вливать.
+Не осталось: прогон зелёный, черновик снят. Можно вливать.
 ```
 
 Стоит он там потому, что решение о слиянии принимается на этой странице, а не в переписке: