@rt-tools/agent-kit 0.11.0 → 0.13.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/skill-gate-rearm.sh

@@ -13,8 +13,10 @@
 # отбивает.
 
 . "$(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
 
-input="$(cat 2>/dev/null)"
+rt_hook_read
+input="$RT_HOOK_INPUT"
 [ -z "$input" ] && exit 0
 
 sid="$(printf '%s' "$input" | jq -r '.session_id // empty' 2>/dev/null)"

package/assets/hooks/skill-gate.sh

@@ -24,12 +24,14 @@
 # Сломанный гейт не имеет права остановить работу совсем.
 
 . "$(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
 
-input="$(cat 2>/dev/null)"
+rt_hook_read
+input="$RT_HOOK_INPUT"
 [ -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)"
+tool="$(rt_hook_tool)"
 
 # Умолчание карты ищется и рядом с самим хуком: уезжают они вместе.
 rt_hooks_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
@@ -175,6 +177,25 @@ if [ -n "$law" ]; then
         && reason="Отбито гейтом правил: загрузи правило «${req}» инструментом Skill — оно применяет закон ${law_path} к этому дереву — и повтори действие. ${fallback} Для этой области это происходит один раз за сессию."
 fi
 
+# Статья, под которую подпадает эта правка. Правило весит от двадцати до шестидесяти килобайт,
+# и отказ, зовущий его целиком, платит за решение полной ценой правила. Статья говорит о своей
+# применимости сама — разбирает её помощник рядом; нет помощника или нет размеченных статей,
+# отказ остаётся прежним, и это тот же отказ в пользу работы, что и везде.
+#
+# Загрузку правила статья не отменяет: она снимает чтение правила целиком, а не сам отказ.
+# Правило целиком остаётся вторым ходом — для того, кому статьи мало.
+# shellcheck disable=SC1090
+[ -f "$rt_hooks_dir/rule-article.sh" ] && . "$rt_hooks_dir/rule-article.sh" 2>/dev/null
+if [ "$kind" != "command" ] && [ "$kind" != "browser" ] && command -v rt_rule_articles >/dev/null 2>&1; then
+    article="$(rt_rule_articles "$root/$rules_dir/${req}/SKILL.md" "$target" 2>/dev/null)"
+    if [ -n "$article" ]; then
+        reason="Отбито гейтом правил. Под эту правку подпадает статья правила «${req}»:
+
+${article}
+Статья снимает чтение правила целиком, а не отказ: загрузи правило «${req}» инструментом Skill и повтори действие. ${fallback} Для этой области это происходит один раз за сессию."
+    fi
+fi
+
 # Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть.
 # Файл может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
 # shellcheck disable=SC1090

package/assets/hooks/skill-loaded.sh

@@ -8,8 +8,10 @@
 # Хук только наблюдает: он всегда пропускает и ничего не отбивает.
 
 . "$(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
 
-input="$(cat 2>/dev/null)"
+rt_hook_read
+input="$RT_HOOK_INPUT"
 [ -z "$input" ] && exit 0
 
 sid="$(printf '%s' "$input" | jq -r '.session_id // "nosession"' 2>/dev/null)"

package/assets/hooks/sql-guard-request.sh

@@ -11,6 +11,7 @@
 # Три вида ввода: запрос через подключение редактора, команда оболочки и та же команда,
 # завёрнутая в универсальный исполнитель. Инструмент, не названный здесь, гарда не касается.
 . "$(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
 
 sql_read_request() {
     sql=""
@@ -25,7 +26,7 @@ sql_read_request() {
         # Терминал IDE исполняет ту же командную строку и кладёт её в то же поле, что и Bash:
         # без этой ветки весь гард обходился сменой инструмента.
         Bash | mcp__webstorm__execute_terminal_command | mcp__webstorm__execute_tool)
-            cmd="$(printf '%s' "$input" | jq -r '.tool_input.command // empty' 2>/dev/null)"
+            cmd="$(rt_hook_cmd)"
             [ -z "$cmd" ] && exit 0
 
             # Универсальный исполнитель зовёт ЛЮБОЙ инструмент редактора по имени, в том числе

package/assets/hooks/sql-guard.sh

@@ -41,12 +41,14 @@
 # запрос. Доставки запроса внутри такой команды не бывает, так что цена послабления нулевая.
 
 . "$(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
 
-input="$(cat 2>/dev/null)"
+rt_hook_read
+input="$RT_HOOK_INPUT"
 [ -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)"
+tool="$(rt_hook_tool)"
 
 # Рабочий каталог нужен одному правилу — разрешению адреса миграции: `DATABASE_URL`
 # обычно не назван в команде и лежит в `.env` рядом с проектом.

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

@@ -26,8 +26,10 @@
 # гард не должен мешать работать.
 
 . "$(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
 
-input="$(cat 2>/dev/null)"
+rt_hook_read
+input="$RT_HOOK_INPUT"
 [ -z "$input" ] && exit 0
 command -v jq >/dev/null 2>&1 || exit 0
 
@@ -45,7 +47,7 @@ done
 [ -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; }
 
-tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
+tool="$(rt_hook_tool)"
 candidates=""
 case "$tool" in
     # Инструмент редактора заводит файл теми же двумя данными, только называет их иначе —
@@ -61,7 +63,7 @@ case "$tool" in
     # имён гард стоял бы объявленным на них и молча пропускал — состояние хуже необъявленного,
     # потому что снаружи выглядит закрытым.
     Bash | mcp__webstorm__execute_terminal_command | mcp__webstorm__execute_tool)
-        cmd="$(printf '%s' "$input" | jq -r '.tool_input.command // empty' 2>/dev/null)"
+        cmd="$(rt_hook_cmd)"
         [ -z "$cmd" ] && exit 0
         # Универсальный исполнитель прячет настоящую команду во вложенной строке: без её разбора
         # путь стоит за кавычкой, и до него не дотягивается ни один образец.
@@ -108,6 +110,7 @@ EOF
 
 # Каталог папок задач: у дерева он свой, но имя обычно общее.
 tasks_dir="${RT_TASKS_DIR:-docs/tasks}"
+main_branch="${RT_MAIN_BRANCH:-main}"
 
 # Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть. Файл
 # может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
@@ -127,7 +130,7 @@ deny() {
 }
 
 # Ветку смотрим там же, где пойдёт правка: у worktree она своя.
-workdir="$(printf '%s' "$input" | jq -r '.cwd // empty' 2>/dev/null)"
+workdir="$(rt_hook_cwd)"
 [ -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
@@ -144,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

@@ -22,16 +22,21 @@
 #   5. Передача захода написана — окно кончилось.
 #   6. Владелец сказал остановиться.
 #
-# Чего страж не судит. Заход вне ветки задачи и работу без папки: состояние там объявлять
-# негде, и отбивать было бы не за что. Это его известная граница.
+# Работа без ветки и без папки задачи судится вторым признаком. Состояния у неё нет, и первый
+# признак взять неоткуда, — но ход, в котором не было ни одной правки дерева, не кончается и
+# здесь: просьба владельца «разложи», «обнови», «посмотри» живёт без задачи и без ветки, и
+# защищена она была меньше всего. Отпускают такой ход те же четыре вещи: вопрос, отказ гарда,
+# написанная передача и слово владельца об остановке.
 #
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: при любой ошибке, нехватке `jq`, отсутствии записи хода, папки задачи
 # или строки состояния ход РАЗРЕШАЕТСЯ (exit 0). Сломанный страж не имеет права заклинить
 # разговор.
 
 . "$(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
 
-input="$(cat 2>/dev/null)"
+rt_hook_read
+input="$RT_HOOK_INPUT"
 [ -z "$input" ] && exit 0
 command -v jq >/dev/null 2>&1 || exit 0
 
@@ -43,22 +48,25 @@ transcript="$(printf '%s' "$input" | jq -r '.transcript_path // empty' 2>/dev/nu
 [ -z "$transcript" ] && exit 0
 [ -f "$transcript" ] || exit 0
 
-workdir="$(printf '%s' "$input" | jq -r '.cwd // empty' 2>/dev/null)"
+workdir="$(rt_hook_cwd)"
 [ -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
-
 root="$(git rev-parse --show-toplevel 2>/dev/null)"
 [ -z "$root" ] && exit 0
-tasks_dir="${RT_TASKS_DIR:-docs/tasks}"
-progress="$root/$tasks_dir/$branch/progress.md"
-[ -f "$progress" ] || exit 0
 
-state="$(sed -n 's/^[[:space:]]*[-*][[:space:]]*\*\*Состояние:\*\*[[:space:]]*`\([^`]*\)`.*/\1/p' "$progress" 2>/dev/null | head -1)"
-[ -z "$state" ] && exit 0
+# Ветка, папка задачи и строка состояния берутся, пока они есть. Пусто — ход судится вторым
+# признаком, а не отпускается: отсюда раньше уходили нулём, и работа по слову владельца
+# кончалась объявлением намерения молча.
+branch="$(git branch --show-current 2>/dev/null)"
+tasks_dir="${RT_TASKS_DIR:-docs/tasks}"
+progress=""
+state=""
+if [ -n "$branch" ] && [ -f "$root/$tasks_dir/$branch/progress.md" ]; then
+    progress="$root/$tasks_dir/$branch/progress.md"
+    state="$(sed -n 's/^[[:space:]]*[-*][[:space:]]*\*\*Состояние:\*\*[[:space:]]*`\([^`]*\)`.*/\1/p' "$progress" 2>/dev/null | head -1)"
+fi
 
 # Работа, дошедшая до этих двух состояний, чужого шага уже дождалась: дальше её двигает
 # владелец, и ход, закрытый здесь, ничего не роняет.
@@ -66,9 +74,27 @@ 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="$(sed -n 's/^[[:space:]]*[-*][[:space:]]*\*\*Следующий шаг:\*\*[[:space:]]*\(.*\)/\1/p' "$progress" 2>/dev/null | head -1)"
+next_step=""
+[ -n "$progress" ] && next_step="$(sed -n 's/^[[:space:]]*[-*][[:space:]]*\*\*Следующий шаг:\*\*[[:space:]]*\(.*\)/\1/p' "$progress" 2>/dev/null | head -1)"
 [ -z "$next_step" ] && next_step="что стоит в разделе «Где стоим» хода работы"
 
 # Команда, меняющая дерево или его состояние. Чтение и поиск сюда не входят намеренно: ими и
@@ -119,10 +145,14 @@ commands="$(printf '%s' "$verdict" | jq -r '.ran // ""' 2>/dev/null)"
 # Страж сравнивает номер этапа с тем, что лежит в истории ветки, и на выросшем номере требует
 # команды из строки «Чем проверяется» — она стоит в замысле обратными кавычками. Приём, записанный
 # прозой, страж не читает: подтвердить его выводом нечем, и это его известная граница.
-stage_now="$(sed -n 's/^[[:space:]]*[-*][[:space:]]*\*\*Этап:\*\*[[:space:]]*\([0-9][0-9]*\).*/\1/p' "$progress" 2>/dev/null | head -1)"
-stage_was="$(git -C "$root" show "HEAD:$tasks_dir/$branch/progress.md" 2>/dev/null | sed -n 's/^[[:space:]]*[-*][[:space:]]*\*\*Этап:\*\*[[:space:]]*\([0-9][0-9]*\).*/\1/p' | head -1)"
+stage_now=""
+stage_was=""
+if [ -n "$progress" ]; then
+    stage_now="$(sed -n 's/^[[:space:]]*[-*][[:space:]]*\*\*Этап:\*\*[[:space:]]*\([0-9][0-9]*\).*/\1/p' "$progress" 2>/dev/null | head -1)"
+    stage_was="$(git -C "$root" show "HEAD:$tasks_dir/$branch/progress.md" 2>/dev/null | sed -n 's/^[[:space:]]*[-*][[:space:]]*\*\*Этап:\*\*[[:space:]]*\([0-9][0-9]*\).*/\1/p' | head -1)"
+fi
 
-if [ -n "$stage_now" ] && [ -n "$stage_was" ] && [ "$stage_now" -gt "$stage_was" ] 2>/dev/null; then
+if [ -n "$progress" ] && [ -n "$stage_now" ] && [ -n "$stage_was" ] && [ "$stage_now" -gt "$stage_was" ] 2>/dev/null; then
     plan="$root/$tasks_dir/$branch/plan.md"
     # Контракт закрытого этапа, а не начатого: подтверждается то, что объявлено сделанным.
     contract="$(awk -v n="$stage_was" '
@@ -164,7 +194,18 @@ fi
 
 [ "$worked" = "true" ] && exit 0
 
-reason="BLOCKED by turn-exit-guard: работа в состоянии '${state}', а за этот ход по ней не сделано ничего — ни правки, ни команды, меняющей дерево.
+if [ -z "$state" ]; then
+    reason="BLOCKED by turn-exit-guard: за этот ход не сделано ничего — ни правки, ни команды, меняющей дерево. Папки задачи у этой работы нет, и состояние взять неоткуда, но ход это не кончает.
+
+Ход кончается четырьмя способами, и других нет: вопрос владельцу, ответа на который в правилах нет; отказ гарда; заполненное окно захода; отданная работа с начатой следующей. Названная и не запущенная команда выходом не является: строка «сейчас запущу» — объявление намерения, а оно прямо названо ложным концом хода.
+
+Работа по слову владельца — «разложи», «обнови», «посмотри» — идёт без задачи и без ветки, и остановить её нечем, кроме этого признака.
+
+Запусти названное этим же ходом. Владелец сказал остановиться — так и напиши: страж читает его слово, а не пересказ.
+
+Страж судит один ход: следующий заход не отбивается."
+else
+    reason="BLOCKED by turn-exit-guard: работа в состоянии '${state}', а за этот ход по ней не сделано ничего — ни правки, ни команды, меняющей дерево.
 
 Ход кончается четырьмя способами, и других нет: вопрос владельцу, ответа на который в правилах нет; отказ гарда; заполненное окно захода; отданная работа с начатой следующей. Отчёт о сделанном выходом не является — он выглядит работой лучше всякой другой, и пустоты за ним не видно.
 
@@ -173,6 +214,7 @@ reason="BLOCKED by turn-exit-guard: работа в состоянии '${state}
 Сделай его этим же ходом. Владелец сказал остановиться — так и напиши: страж читает его слово, а не пересказ.
 
 Страж судит один ход: следующий заход не отбивается."
+fi
 
 # Общий хвост отказа: два законных хода. Файл может быть не разложен — тогда хвоста нет,
 # а причина отказа остаётся прежней.

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

@@ -31,8 +31,10 @@
 # заходе ход РАЗРЕШАЕТСЯ (exit 0). Сломанный гард не имеет права заклинить разговор.
 
 . "$(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
 
-input="$(cat 2>/dev/null)"
+rt_hook_read
+input="$RT_HOOK_INPUT"
 [ -z "$input" ] && exit 0
 
 command -v jq >/dev/null 2>&1 || exit 0

package/assets/hooks/window-fill-guard.sh

@@ -30,8 +30,10 @@
 # работа РАЗРЕШАЕТСЯ (exit 0). Сломанный гард не имеет права заклинить работу.
 
 . "$(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
 
-input="$(cat 2>/dev/null)"
+rt_hook_read
+input="$RT_HOOK_INPUT"
 [ -z "$input" ] && exit 0
 
 command -v jq >/dev/null 2>&1 || exit 0
@@ -144,9 +146,9 @@ fi
 [ "$event" = "PreToolUse" ] || exit 0
 [ "$pct" -ge "$stop_pct" ] || exit 0
 
-tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
-path="$(printf '%s' "$input" | jq -r '.tool_input.file_path // empty' 2>/dev/null)"
-cmd="$(printf '%s' "$input" | jq -r '.tool_input.command // empty' 2>/dev/null)"
+tool="$(rt_hook_tool)"
+path="$(rt_hook_file)"
+cmd="$(rt_hook_cmd)"
 
 allowed=0
 case "$tool" in

package/assets/laws/work-conduct.md

@@ -1,9 +1,7 @@
 # Закон о ведении работы
 
-Что должно быть верно про то, как работа идёт от просьбы владельца до её закрытия. Работа
-длится дольше одного захода и переживает перерывы: между заходами исполнитель не помнит
-ничего, а владелец помнит и вынужден пересказывать. Пересказ каждый раз выходит короче
-предыдущего, и работа доделывается по обрывку исходной просьбы.
+Закон устанавливает как ведётся работа от момента постановки задачи до её закрытия. Работа
+длится дольше одной сессии и должна сохранять весь контекст и состояние при переходах из одной сессии в другую.
 
 ## Статьи
 
@@ -13,15 +11,13 @@
 - **Пробел закрывается вопросом владельцу, а не догадкой.** Догадка неотличима от знания:
   она попадает в работу молча и обнаруживается только при приёмке, когда переделывать дороже
   всего.
-- **Работа, объявленная сборкой по образцу, начинается с чтения самого образца.** Пересказ
+- **Работа, которая требует изменений по образцу, начинается с чтения самого образца.** Пересказ
   образца образцом не является: по нему собирается понимание того, кто пересказывал, и
   расхождение всплывает на приёмке целой работой, а не строкой. Читается та часть образца,
   которую работа повторяет, и читается целиком — об устройстве чужого дерева по одному его
   файлу не судят.
-- **Образец, названный однажды, доступен каждому заходу работы.** Где он лежит, записано
-  там, где заход найдёт это без владельца. Иначе второй заход собирает по памяти первого,
-  третий — по пересказу второго, и к четвёртому от образца не остаётся ничего, кроме слова
-  «образец».
+- **Образец, указанный в ходе работы должен быть доступен каждой сессии во время работы.**
+  Ссылка на образец нужно указывать непосредственно в файле с описанием прогресса работы.
 - **Вопрос, у которого есть очевидный ответ, работу не останавливает.** Исполнитель называет
   допущение, идёт дальше и записывает его туда же, где идёт работа. Останавливает только тот
   пробел, при котором любая догадка делает работу опасной или бесполезной. Вопрос, заданный

package/assets/patterns/dependencies-upgrade.md

@@ -2,7 +2,7 @@
 name: dependencies-upgrade
 kind: pattern
 rule: dependencies
-description: Паттерн правила dependencies. Брать при подъёме версий пакетов — выбор верхней границы по peer-диапазонам, порядок проверок, граница переформатирования после обновления форматтера, разбор новых правил линтера. Не брать для ветки, коммита и PR — это паттерн git-workflow-commit.
+description: Паттерн правила dependencies. Брать при подъёме версий пакетов — выбор верхней границы по peer-диапазонам, порядок проверок, граница переформатирования после обновления форматтера, разбор новых правил линтера. Не брать для ветки и коммита — это паттерн git-workflow-commit, для PR — git-workflow-pr.
 ---
 
 # Подъём версий

package/assets/patterns/doc-style-write.md

@@ -19,7 +19,7 @@ description: Паттерн правила doc-style. Брать при напи
 
 Само правило укладывается в одно предложение. Следом — не больше двух предложений о том, что
 сломается иначе, и только если из самой фразы это не видно. Обоснование, у которого была
-альтернатива, идёт в «Ловушки» правила, а не в сам закон: разросшийся буллет читают по
+альтернатива, идёт в ловушки — холодную часть правила, — а не в сам закон: разросшийся буллет читают по
 диагонали, а закон говорит, что верно, — не почему когда-то выбрали так.
 
 ```
@@ -41,8 +41,8 @@ description: Паттерн правила doc-style. Брать при напи
 Место исполнения меняется при первом же рефакторинге, и документ, который его называет,
 устаревает молча. Для него заведён отдельный файл — `implementation.md` рядом.
 
-Исключение — «Ловушки» правила: там устройство кода называется прямо, потому что ловушка и
-есть место, где на него наступают.
+Исключение — ловушки в холодной части правила: там устройство кода называется прямо, потому
+что ловушка и есть место, где на него наступают.
 
 ## Без утверждений о будущем