@rt-tools/agent-kit 0.16.1 → 0.17.0

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

@@ -0,0 +1,185 @@
+#!/usr/bin/env bash
+# Общий разбор для гардов хода работы. НЕ гард: объявления `rt-hook:` у него нет, к событиям
+# агента он не подключается. Его источают сами гарды — тем же приёмом, каким они источают общий
+# хвост отказа.
+#
+# Зачем он есть. Требования к ходу работы стоят двумя гардами — папка задачи с замыслом и
+# состоянием отдельно, договорённость о продукте отдельно, — а разбор у обоих один и тот же:
+# какой путь пишет вызов, код ли это приложения, в какой ветке идёт правка и где лежит папка
+# задачи. Разложенный вторым разом, этот разбор расходится молча: правка одного гарда чинит
+# половину случаев, и видно это только там, где второй промолчал.
+#
+# ЧТО ОН ДЕЛАЕТ. Читает ввод, поднимает профиль дерева, вынимает из вызова пути, отбирает среди
+# них первый путь кода приложения, переходит в рабочий каталог правки и называет ветку, корень,
+# каталог папок задач, саму папку и замысел в ней.
+#
+# ЧЕГО ОН НЕ ДЕЛАЕТ. Он ничего не судит и ничего не отбивает: имя ветки, наличие папки, состояние
+# работы и договорённость — дело самих гардов, и отказ печатает тот, чьё это требование.
+#
+# FAIL-OPEN: нет jq, не git-репозиторий, битый ввод, чужой инструмент, нет функции профиля →
+# ответ «судить нечего». Сломанный разбор не должен мешать работать.
+
+# Разбор вызова. Возвращает 0 и ставит переменные, если правка касается кода приложения в ветке
+# с историей; иначе — ненулевой код, и гард выходит молча.
+#
+#   RT_TF_PATH        — путь кода приложения, из-за которого гард вообще судит
+#   RT_TF_BRANCH      — текущая ветка рабочего каталога правки
+#   RT_TF_ROOT        — корень рабочего дерева
+#   RT_TF_TASKS_DIR   — каталог папок задач, как он назван в дереве
+#   RT_TF_MAIN_BRANCH — главная ветка дерева
+#   RT_TF_DIR         — папка этой задачи
+#   RT_TF_PLAN        — замысел в ней
+# Разложенный слой правил судится наравне с кодом приложения. Путями кода он не покрыт нигде —
+# лежит в каталоге законов, в каталоге агента и среди проверок, — и полторы сотни его файлов
+# легли без единого отклика гарда; отбил он двумя ходами позже, на записи в папку задачи. Признак
+# тот же, по которому слой находит гейт правил: шапка раскладки в начале файла. Ресурс пакета, из
+# которого раскладка идёт, шапки не несёт и судится по-прежнему своим путём.
+rt_tf_laid_out() {
+    [ -f "$1" ] || return 1
+    head -n 3 "$1" 2>/dev/null | grep -q 'rt-kit v[^[:space:]]* ·'
+}
+
+rt_task_flow_context() {
+    rt_tf_hooks_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+    # shellcheck disable=SC1090
+    . "$rt_tf_hooks_dir/utf8.sh" 2>/dev/null || true
+    # shellcheck disable=SC1090
+    . "$rt_tf_hooks_dir/hook-input.sh" 2>/dev/null || true
+
+    command -v rt_hook_read >/dev/null 2>&1 || return 1
+    rt_hook_read
+    [ -z "$RT_HOOK_INPUT" ] && return 1
+    command -v jq >/dev/null 2>&1 || return 1
+
+    # Профиль дерева: сперва умолчание пакета, поверх него — надстройка проекта, если она есть.
+    # Читается до разбора пути: пути из команды оболочки вынимает как раз профиль.
+    for rt_tf_profile in \
+        "$rt_tf_hooks_dir/../rt-kit/defaults/project.sh" \
+        "$rt_tf_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 "$rt_tf_profile" ] && . "$rt_tf_profile" 2>/dev/null
+    done
+
+    # Слово о нехватке функции профиля: хук, вышедший молча, неотличим от работающего. Файл может
+    # быть не разложен — тогда остаётся прежнее поведение, молчаливое.
+    # shellcheck disable=SC1090
+    [ -f "$rt_tf_hooks_dir/profile-check.sh" ] && . "$rt_tf_hooks_dir/profile-check.sh"
+    command -v rt_needs >/dev/null 2>&1 || rt_needs() { command -v "$1" >/dev/null 2>&1; }
+
+    rt_tf_tool="$(rt_hook_tool)"
+    rt_tf_candidates=""
+    case "$rt_tf_tool" in
+        # Инструмент редактора заводит файл теми же двумя данными, только называет их иначе —
+        # без этой ветки правка шла бы мимо гарда сменой инструмента.
+        Edit | Write | MultiEdit | mcp__webstorm__create_new_file)
+            rt_tf_candidates="$(printf '%s' "$RT_HOOK_INPUT" | jq -r '.tool_input.file_path // .tool_input.pathInProject // empty' 2>/dev/null)"
+            ;;
+        # Второй ярус: та же правка, положенная командой оболочки. Без него отказ гарда обходится
+        # сменой не инструмента, а способа записи — перенаправлением, `sed -i`, интерпретатором с
+        # heredoc.
+        #
+        # Терминал среды исполняет ту же командную строку и кладёт её в то же поле: без этих двух
+        # имён гард стоял бы объявленным на них и молча пропускал — состояние хуже необъявленного,
+        # потому что снаружи выглядит закрытым.
+        Bash | mcp__webstorm__execute_terminal_command | mcp__webstorm__execute_tool)
+            rt_tf_cmd="$(rt_hook_cmd)"
+            [ -z "$rt_tf_cmd" ] && return 1
+            # Универсальный исполнитель прячет настоящую команду во вложенной строке: без её
+            # разбора путь стоит за кавычкой, и до него не дотягивается ни один образец.
+            if [ "$rt_tf_tool" = "mcp__webstorm__execute_tool" ] && command -v perl >/dev/null 2>&1; then
+                rt_tf_inner="$(printf '%s' "$rt_tf_cmd" | perl -0ne '
+                    if (/--command(?:=|\s+)(?:"((?:[^"\\]|\\.)*)"|\x27([^\x27]*)\x27|(.+))/s) {
+                        print defined $1 ? $1 : (defined $2 ? $2 : $3);
+                    }
+                ' 2>/dev/null)"
+                [ -n "$rt_tf_inner" ] && rt_tf_cmd="$rt_tf_inner"
+            fi
+            rt_needs rt_shell_writes task-flow-guard || return 1
+            rt_needs rt_shell_paths task-flow-guard || return 1
+            rt_shell_writes "$rt_tf_cmd" || return 1
+            rt_tf_candidates="$(rt_shell_paths "$rt_tf_cmd")"
+            ;;
+        *) return 1 ;;
+    esac
+    [ -z "$rt_tf_candidates" ] && return 1
+
+    # Признак «правка меняет поведение» — путь, а не оценка на глаз: оценку назначает тот, кому
+    # она мешает, и порог плывёт. Где живёт код приложения, знает профиль: правила, тексты,
+    # обвязка и зависимости под требование не попадают — иначе разбор задачи нельзя было бы
+    # вести до заведения ветки.
+    rt_needs rt_is_app_code task-flow-guard || return 1
+
+    # Удаление отличается от записи одним: снимаемого может не быть в истории вовсе. Свой
+    # временный каталог под корнем приложений правкой продукта не бывает — снимать его,
+    # восстанавливая ради этого замысел на диске, значит исполнять требование, написанное про
+    # другое действие. Отслеживаемый путь судится по-прежнему: снятый файл кода меняет поведение
+    # так же, как переписанный.
+    rt_tf_removes=0
+    case "${rt_tf_cmd:-}" in
+        *"rm "*) rt_tf_removes=1 ;;
+    esac
+    # Каталог правки: ветка и история смотрятся ниже, а спросить историю нужно уже здесь.
+    rt_tf_askdir="$(rt_hook_cwd)"
+    [ -z "$rt_tf_askdir" ] && rt_tf_askdir="${CLAUDE_PROJECT_DIR:-.}"
+
+    # Судится каждый названный путь: команда пишет столько файлов, сколько в ней стоит, и одного
+    # под требованием довольно, чтобы отбить её целиком.
+    RT_TF_PATH=""
+    while IFS= read -r rt_tf_candidate; do
+        [ -z "$rt_tf_candidate" ] && continue
+        # Снятие того, чего в истории нет, — не правка продукта, а уборка за собой. Спрашивается
+        # путь, как он назван в команде: приклеенный корень уводит вопрос в чужое дерево.
+        if [ "$rt_tf_removes" = 1 ] && git -C "$rt_tf_askdir" rev-parse --is-inside-work-tree >/dev/null 2>&1 &&
+            ! git -C "$rt_tf_askdir" ls-files --error-unmatch -- "$rt_tf_candidate" >/dev/null 2>&1; then
+            continue
+        fi
+        case "$rt_tf_candidate" in
+            /*) ;;
+            *) rt_tf_candidate="${CLAUDE_PROJECT_DIR:-.}/$rt_tf_candidate" ;;
+        esac
+        if rt_is_app_code "$rt_tf_candidate" || rt_tf_laid_out "$rt_tf_candidate"; then
+            RT_TF_PATH="$rt_tf_candidate"
+            break
+        fi
+    done <<EOF
+$rt_tf_candidates
+EOF
+    [ -z "$RT_TF_PATH" ] && return 1
+
+    # Ветку смотрим там, где пойдёт правка: у worktree она своя.
+    rt_tf_workdir="$(rt_hook_cwd)"
+    [ -z "$rt_tf_workdir" ] && rt_tf_workdir="${CLAUDE_PROJECT_DIR:-.}"
+    cd "$rt_tf_workdir" 2>/dev/null || return 1
+    git rev-parse --is-inside-work-tree >/dev/null 2>&1 || return 1
+
+    RT_TF_BRANCH="$(git branch --show-current 2>/dev/null)"
+    [ -z "$RT_TF_BRANCH" ] && return 1   # detached HEAD — не про наш случай
+
+    RT_TF_ROOT="$(git rev-parse --show-toplevel 2>/dev/null)"
+    [ -z "$RT_TF_ROOT" ] && return 1
+
+    # Каталог папок задач: у дерева он свой, но имя обычно общее.
+    RT_TF_TASKS_DIR="${RT_TASKS_DIR:-docs/tasks}"
+    RT_TF_MAIN_BRANCH="${RT_MAIN_BRANCH:-main}"
+    RT_TF_DIR="$RT_TF_ROOT/$RT_TF_TASKS_DIR/$RT_TF_BRANCH"
+    RT_TF_PLAN="$RT_TF_DIR/plan.md"
+
+    return 0
+}
+
+# Отказ гарда хода работы: причина первым параметром, законная форма обхода — вторым. Хвост
+# дописывается здесь, а не в каждом тексте: пропущенный в одном месте, он читается как «у этого
+# отказа ходов нет». Хвост может быть не разложен — тогда его нет, а причина остаётся прежней.
+rt_task_flow_deny() {
+    rt_tf_reason="$1"
+    if command -v rt_deny_tail >/dev/null 2>&1; then
+        rt_tf_tail="$(rt_deny_tail "$2")"
+        [ -n "$rt_tf_tail" ] && rt_tf_reason="$1 ${rt_tf_tail}"
+    fi
+    jq -n --arg r "$rt_tf_reason" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
+        || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"%s"}}\n' "$rt_tf_reason"
+    exit 0
+}

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

@@ -0,0 +1,92 @@
+#!/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/task-flow-context.sh, hooks/task-flow-guard.sh, hooks/deny-tail.sh
+# PreToolUse guard for Edit|Write|MultiEdit: код не пишется раньше договорённости о продукте.
+#
+# Замысел говорит, как работа будет сделана, и молчит о том, о чём договорились с владельцем.
+# Договорённость о продукте — единственный текст, который называет обещанное поведение до кода;
+# написанная после, она пересказывает состоявшееся решение, а не проверяет его.
+#
+# Гард требует одно и ровно одно: замысел называет договорённость строкой `**Драфт:** \`путь\``,
+# и названное существует. Папку задачи, сам замысел и объявленное состояние требует
+# `task-flow-guard`, и до его отказов этот гард не судит ничего: замысла нет на диске — молчит.
+#
+# Требования разведены затем, чтобы дерево могло отказаться от одного, сохранив второе. Пока
+# оба ехали одним файлом, отказ от требования договорённости снимал заодно требование папки
+# задачи и замысла — то есть всё, ради чего гард заводился.
+#
+# Осознанный выход есть: строка `**Поведение:** не меняется — <причина>` в замысле снимает
+# требование договорённости. Пустая причина не принимается, как и у `Docs-skip:`.
+#
+# Правило целиком — скил `task-flow`.
+#
+# FAIL-OPEN: нет jq, не git-репозиторий, битый ввод, чужой инструмент → пропуск. Сломанный
+# гард не должен мешать работать.
+
+rt_hooks_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Разбор вызова — общий у обоих гардов хода работы. Файл может быть не разложен: тогда судить
+# нечем, и гард молчит.
+# shellcheck disable=SC1090
+[ -f "$rt_hooks_dir/task-flow-context.sh" ] && . "$rt_hooks_dir/task-flow-context.sh"
+command -v rt_task_flow_context >/dev/null 2>&1 || exit 0
+
+# Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть. Файл
+# может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+# shellcheck disable=SC1090
+[ -f "$rt_hooks_dir/deny-tail.sh" ] && . "$rt_hooks_dir/deny-tail.sh"
+
+rt_task_flow_context || exit 0
+
+branch="$RT_TF_BRANCH"
+root="$RT_TF_ROOT"
+tasks_dir="$RT_TF_TASKS_DIR"
+plan="$RT_TF_PLAN"
+
+deny() { rt_task_flow_deny "$@"; }
+
+# Замысла нет — это чужое требование, и отказ о нём печатает гард хода работы. Отсюда же уходит
+# и работа с разобранной папкой: замысел с диска к этой минуте снят намеренно.
+[ -f "$plan" ] || exit 0
+
+# Строка обхода: поведение не меняется, договорённость о продукте не нужна. Причина обязана
+# стоять — без неё обход становится умолчанием.
+if grep -qE '^\*\*Поведение:\*\*[[:space:]]*не меняется[[:space:]]*—[[:space:]]*\S' "$plan" 2>/dev/null; then
+    exit 0
+fi
+
+# Договорённость называется одним из двух видов. Первый — отдельный документ в каталоге
+# «предложено»: он переезжает в спек домена, когда работа закрывается. Второй — сам спек домена:
+# дерево, у которого отдельного каталога нет, пишет договорённость прямо в него, и переезжать там
+# нечему — черновик совпадает со спеком с первого дня. Требовать один вид значит навязывать способ
+# записи договорённостей вместе с проверкой того, что работа идёт по замыслу: дерево со вторым
+# способом отказывается от гарда целиком и остаётся без единственной машинной проверки под правило.
+draft="$(sed -n 's/^\*\*Драфт:\*\*[[:space:]]*`\([^`]*\)`.*/\1/p' "$plan" 2>/dev/null | head -1)"
+[ -z "$draft" ] && draft="$(sed -n 's/^\*\*Спек:\*\*[[:space:]]*`\([^`]*\)`.*/\1/p' "$plan" 2>/dev/null | head -1)"
+
+if [ -z "$draft" ]; then
+    deny "BLOCKED by task-flow: в '${tasks_dir}/${branch}/plan.md' не названа договорённость о продукте. Назови её одной из двух строк: '**Драфт:** \`путь\`' — отдельный документ в docs/specs/<домен>/proposed/<фича>/, либо '**Спек:** \`путь\`' — спек домена, в который договорённость пишется прямо. Правило — скил task-flow." \
+        "строка '**Поведение:** не меняется — <причина владельца>' в замысле; пустая причина не принимается"
+fi
+
+case "$draft" in
+    /*) draft_path="$draft" ;;
+    *) draft_path="$root/$draft" ;;
+esac
+
+if [ -e "$draft_path" ]; then
+    exit 0
+fi
+
+# Договорённость, влитая в спек домена, с диска уходит — так и задумано: в главной ветке
+# директории «предложено» быть не должно. Но замысел на неё ссылается до конца работы, и без
+# этой развилки последний коммит PR запирал бы ветку: ни правки по замечаниям разбора, ни
+# записи в журнал изменений после вливания уже не сделать.
+#
+# Влитое от незаведённого отличает история ветки: путь, которого в ней никогда не было,
+# договорённостью не был. Спросить об этом нечем, кроме git, поэтому нет git — отказ остаётся.
+if git -C "$root" log --oneline -1 -- "$draft" 2>/dev/null | grep -q .; then
+    exit 0
+fi
+
+deny "BLOCKED by task-flow: замысел называет договорённость '${draft}', а её на диске нет и в истории ветки не было. Заведи её с образца (docs/specs/_template) или поправь путь в '${tasks_dir}/${branch}/plan.md'. Правило — скил task-flow."

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

@@ -1,6 +1,6 @@
 #!/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
+# Требует: hooks/task-flow-context.sh, hooks/profile-check.sh, hooks/deny-tail.sh
 # PreToolUse guard for Edit|Write|MultiEdit: код не пишется раньше замысла.
 #
 # Работа идёт много заходов, и между ними исполнитель не помнит ничего. Замысел, лежащий на
@@ -8,145 +8,48 @@
 # закоммичены, PR не открыт, а очередь работ показывает задачу начатой и молчит о том, что
 # внутри неё сделано.
 #
-# Гард требует четыре вещи и ровно их: папку задачи по имени ветки, замысел в ней, объявленное
-# в ходе работы состояние — из тех, в которых код правится, — и названную в замысле
-# договорённость о продукте. Полноту написанного он не судит — это за владельцем (решения в
-# законе `docs/constitution/work-conduct.md`).
+# Гард требует три вещи и ровно их: папку задачи по имени ветки, замысел в ней и объявленное в
+# ходе работы состояние — из тех, в которых код правится. Полноту написанного он не судит — это
+# за владельцем (решения в законе `docs/constitution/work-conduct.md`).
 #
-# Состояние судится раньше договорённости и её обхода: обход снимает требование договорённости,
-# а не требование дойти до правки кода. Судится объявленный переход, а не наличие файлов —
-# артефакт, положенный ради снятия отказа, лежит так же, как написанный.
+# Договорённость о продукте требует свой гард — `task-flow-draft-guard`, объявленный на те же
+# события. Разведены они затем, чтобы дерево могло отказаться от одного требования, сохранив
+# второе: пока оба ехали одним файлом, отказ от требования договорённости снимал заодно и
+# требование папки задачи, а держать их вместе дерево не просило никогда.
 #
 # Правило целиком — скил `task-flow`.
 #
-# Осознанный выход есть: строка `**Поведение:** не меняется — <причина>` в замысле снимает
-# требование договорённости. Пустая причина не принимается, как и у `Docs-skip:`.
-#
 # FAIL-OPEN: нет 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; }
-
-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)"
-        ;;
-    # Второй ярус: та же правка, положенная командой оболочки. Без него отказ гарда обходится
-    # сменой не инструмента, а способа записи — перенаправлением, `sed -i`, интерпретатором с
-    # heredoc. Разбор — `2026-08-15-guard-denied-shell-wrote-anyway.md`.
-    #
-    # Терминал среды исполняет ту же командную строку и кладёт её в то же поле: без этих двух
-    # имён гард стоял бы объявленным на них и молча пропускал — состояние хуже необъявленного,
-    # потому что снаружи выглядит закрытым.
-    Bash | mcp__webstorm__execute_terminal_command | mcp__webstorm__execute_tool)
-        cmd="$(rt_hook_cmd)"
-        [ -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
-        rt_needs rt_shell_writes task-flow-guard || exit 0
-        rt_needs rt_shell_paths task-flow-guard || exit 0
-        rt_shell_writes "$cmd" || exit 0
-        candidates="$(rt_shell_paths "$cmd")"
-        ;;
-    *) exit 0 ;;
-esac
-[ -z "$candidates" ] && exit 0
-
-# Признак «правка меняет поведение» — путь, а не оценка на глаз: оценку назначает тот, кому
-# она мешает, и порог плывёт. Где живёт код приложения, знает профиль: правила, тексты, обвязка
-# и зависимости под требование не попадают — иначе разбор задачи нельзя было бы вести до
-# заведения ветки.
-rt_needs rt_is_app_code task-flow-guard || exit 0
-
-# Судится каждый названный путь: команда пишет столько файлов, сколько в ней стоит, и одного
-# под требованием довольно, чтобы отбить её целиком.
-path=""
-while IFS= read -r candidate; do
-    [ -z "$candidate" ] && continue
-    case "$candidate" in
-        /*) ;;
-        *) candidate="${CLAUDE_PROJECT_DIR:-.}/$candidate" ;;
-    esac
-    if rt_is_app_code "$candidate"; then
-        path="$candidate"
-        break
-    fi
-done <<EOF
-$candidates
-EOF
-[ -z "$path" ] && exit 0
-
-# Каталог папок задач: у дерева он свой, но имя обычно общее.
-tasks_dir="${RT_TASKS_DIR:-docs/tasks}"
-main_branch="${RT_MAIN_BRANCH:-main}"
+[ -f "$rt_hooks_dir/task-flow-context.sh" ] && . "$rt_hooks_dir/task-flow-context.sh"
+command -v rt_task_flow_context >/dev/null 2>&1 || exit 0
 
 # Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть. Файл
 # может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
 # shellcheck disable=SC1090
 [ -f "$rt_hooks_dir/deny-tail.sh" ] && . "$rt_hooks_dir/deny-tail.sh"
-command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { :; }
 
-# Отказ: причина первым параметром, законная форма обхода — вторым. Хвост дописывается здесь, а
-# не в каждом тексте: пропущенный в одном месте, он читается как «у этого отказа ходов нет».
-deny() {
-    reason="$1"
-    tail_text="$(rt_deny_tail "$2")"
-    [ -n "$tail_text" ] && reason="$1 ${tail_text}"
-    jq -n --arg r "$reason" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
-        || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"%s"}}\n' "$reason"
-    exit 0
-}
+rt_task_flow_context || exit 0
 
-# Ветку смотрим там же, где пойдёт правка: у worktree она своя.
-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="$RT_TF_BRANCH"
+root="$RT_TF_ROOT"
+tasks_dir="$RT_TF_TASKS_DIR"
+main_branch="$RT_TF_MAIN_BRANCH"
+dir="$RT_TF_DIR"
+plan="$RT_TF_PLAN"
 
-branch="$(git branch --show-current 2>/dev/null)"
-[ -z "$branch" ] && exit 0   # detached HEAD — не про наш случай
+deny() { rt_task_flow_deny "$@"; }
 
 if rt_needs rt_task_branch_ok task-flow-guard && ! rt_task_branch_ok "$branch"; then
     deny "BLOCKED by task-flow: правка кода идёт в ветке под задачу, а текущая ветка — '${branch}'. Заведи задачу (npm run task:new -- --title '…' --slug <slug>) и ветку под её номером, затем повтори. Правило — скил task-flow."
 fi
 
-root="$(git rev-parse --show-toplevel 2>/dev/null)"
-[ -z "$root" ] && exit 0
-dir="$root/$tasks_dir/$branch"
-plan="$dir/plan.md"
-
 # Папка, разобранная коммитом этой ветки, — признак того, что работа отдана. Замысел с диска к
 # этой минуте снят намеренно: уборка стоит до открытия заявки, потому что кнопку слияния
 # нажимает человек на хостинге и закрывающему коммиту места после одобрения не остаётся.
@@ -154,11 +57,11 @@ 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)"
+    [ -n "$(git -C "$root" ls-tree -d --name-only HEAD -- "$tasks_dir/$branch" 2>/dev/null | head -1)" ] && return 1
+    base="$(git -C "$root" 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)"
+    had="$(git -C "$root" ls-tree -d --name-only "$base" -- "$tasks_dir/$branch" 2>/dev/null | head -1)"
+    [ -z "$had" ] && had="$(git -C "$root" log "$base..HEAD" --diff-filter=A --name-only --pretty=format: -- "$tasks_dir/$branch" 2>/dev/null | head -1)"
     [ -n "$had" ]
 }
 
@@ -215,7 +118,7 @@ case "$state" in
         ;;
 esac
 
-# Папка задачи едет в ветку коммитом, а не живёт в одном рабочем дереве. Четыре требования выше
+# Папка задачи едет в ветку коммитом, а не живёт в одном рабочем дереве. Три требования выше
 # смотрят диск, и папка, ни разу не закоммиченная, проходит их все без единого отказа — а
 # признак отданной работы гард берёт из истории, и там её нет. Отказ приходит в последней точке,
 # на открытии заявки, когда папка уже разобрана своими руками: чинить нечего, замысел снят, и
@@ -228,44 +131,9 @@ esac
 #
 # Спрашивается та же история, что и у признака отданной работы: папка стоит в `HEAD` либо её
 # добавлял коммит ветки. Нет git — требования нет: спросить историю нечем.
-if [ -n "$(git rev-parse --verify HEAD 2>/dev/null)" ]; then
-    in_tree="$(git ls-tree -d --name-only HEAD -- "$tasks_dir/$branch" 2>/dev/null | head -1)"
+if [ -n "$(git -C "$root" rev-parse --verify HEAD 2>/dev/null)" ]; then
+    in_tree="$(git -C "$root" ls-tree -d --name-only HEAD -- "$tasks_dir/$branch" 2>/dev/null | head -1)"
     if [ -z "$in_tree" ]; then
         deny "BLOCKED by task-flow: папка задачи '${tasks_dir}/${branch}' лежит в рабочем дереве, а в историю ветки не заведена. Заведи её коммитом (git add ${tasks_dir}/${branch} && git commit), затем повтори: признак отданной работы гард берёт из истории, и с некоммиченной папкой отказ придёт на открытии заявки — когда папка уже разобрана и чинить нечего. Правило — скил task-flow."
     fi
 fi
-
-# Строка обхода: поведение не меняется, договорённость о продукте не нужна. Причина обязана
-# стоять — без неё обход становится умолчанием.
-if grep -qE '^\*\*Поведение:\*\*[[:space:]]*не меняется[[:space:]]*—[[:space:]]*\S' "$plan" 2>/dev/null; then
-    exit 0
-fi
-
-draft="$(sed -n 's/^\*\*Драфт:\*\*[[:space:]]*`\([^`]*\)`.*/\1/p' "$plan" 2>/dev/null | head -1)"
-
-if [ -z "$draft" ]; then
-    deny "BLOCKED by task-flow: в '${tasks_dir}/${branch}/plan.md' не названа договорённость о продукте. Заведи её в docs/specs/<домен>/proposed/<фича>/ и укажи строкой '**Драфт:** \`путь\`'. Правило — скил task-flow." \
-        "строка '**Поведение:** не меняется — <причина владельца>' в замысле; пустая причина не принимается"
-fi
-
-case "$draft" in
-    /*) draft_path="$draft" ;;
-    *) draft_path="$root/$draft" ;;
-esac
-
-if [ -e "$draft_path" ]; then
-    exit 0
-fi
-
-# Договорённость, влитая в спек домена, с диска уходит — так и задумано: в главной ветке
-# директории «предложено» быть не должно. Но замысел на неё ссылается до конца работы, и без
-# этой развилки последний коммит PR запирал бы ветку: ни правки по замечаниям разбора, ни
-# записи в журнал изменений после вливания уже не сделать.
-#
-# Влитое от незаведённого отличает история ветки: путь, которого в ней никогда не было,
-# договорённостью не был. Спросить об этом нечем, кроме git, поэтому нет git — отказ остаётся.
-if git -C "$root" log --oneline -1 -- "$draft" 2>/dev/null | grep -q .; then
-    exit 0
-fi
-
-deny "BLOCKED by task-flow: замысел называет договорённость '${draft}', а её на диске нет и в истории ветки не было. Заведи её с образца (docs/specs/_template) или поправь путь в '${tasks_dir}/${branch}/plan.md'. Правило — скил task-flow."

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

@@ -145,7 +145,14 @@ next_step=""
 
 # Команда, меняющая дерево или его состояние. Чтение и поиск сюда не входят намеренно: ими и
 # заполняется ход, который встал.
-work_re='git (add|commit|push|checkout|merge|rm)|npm run|pnpm (run|exec)|nx (build|test|run)|gh (pr|issue|api|run)|task:(new|move)|mkdir|cp |mv |rm |sed -i|tee |>>?[[:space:]]*[^|&]'
+#
+# Перенаправления вывода здесь нет, и снято оно по разбору: страж отбил два хода из семи,
+# простоявших без работы, а пять засчитал работой ровно по нему. Тело будущей заявки писалось во
+# временный каталог захода — вне рабочего дерева, — а одно из ожиданий несло только отвод потока
+# ошибок в устройство пустоты. Ни то ни другое дерева не меняет, а образцу они были неотличимы
+# от записи в рабочий файл: он видел саму стрелку и не спрашивал, куда она ведёт. Признаком
+# остаются правка файла инструментом правки и перечисленные здесь команды.
+work_re='git (add|commit|push|checkout|merge|rm)|npm run|pnpm (run|exec)|nx (build|test|run)|gh (pr|issue|api|run)|task:(new|move)|mkdir|cp |mv |rm |sed -i|tee '
 
 # Разведка. Те же слова, что и в образце работы, но подкоманда читающая: переключение ветки,
 # подтягивание, просмотр истории, чтение заявок и прогонов. Образец работы называет их работой,

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

@@ -180,7 +180,11 @@ reason="BLOCKED by window-fill-guard: заполнение окна ${pct}% (${f
 2. Закоммить проверенное: незакоммиченное не переживёт перерыв.
 3. Напиши передачу в ${handoff_dir}/ и отдай владельцу путь к ней — что в неё входит, говорит паттерн task-flow-handoff.
 
-Пропускаются при этом: правка ${tasks_dir}/**, запись передачи, команды поставки и сверки, чтение файлов и вопрос владельцу."
+Что после порога проходит:
+- правка ${tasks_dir}/** и ${handoff_dir}/**, чтение любого файла, вопрос владельцу;
+- команда, начинающаяся со слова поставки или сверки: git, клиент хостинга, перевод колонки, npm run check:*.
+
+Команда судится по началу строки: вход в каталог перед ней снимает совпадение, и отбит будет тот же коммит, который прошёл бы без него. Начинай команду с самого слова поставки."
 
 # Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть.
 # Файл может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.

package/assets/laws/delivery.md

@@ -27,6 +27,20 @@
   Правка одного рода остаётся одной задачей, сколько бы файлов она ни задела; объём захода
   говорит, какого размера задачу заводить среди тех, что делятся законно, и делить неделимое не
   даёт.
+- **Работы, идущие одна за другой, ветвятся одна от другой.** Ветка следующей отводится от
+  предыдущей, а не от главной: тогда правка предыдущей лежит в общем предке, и сводить два разных
+  изменения одного файла уже не нужно. Ветки, заведённые от главной подряд, друг о друге не знают,
+  и первое же слияние делает остальные расходящимися — тем вернее, чем ближе работы по предмету:
+  расходятся не сами правки, а строки, куда обе дописали. Цена не исчезает, а переносится: платит
+  её тот, кто ветвится, один раз — вместо того, кто вливает, столько раз, сколько заявок открыто.
+  От главной ветвится первая работа череды и всякая, не связанная с предыдущей.
+- **Череда веток отдаётся снизу вверх, и порядок называется владельцу.** Заявка каждой стоит на
+  предыдущей, а не на главной, поэтому влитая не по порядку тащит за собой всё, что под ней.
+  Порядок известен тому, кто ветвился, и не виден тому, кто вливает: несказанный, он читается как
+  его отсутствие.
+- **Ветка, стоящая под другой, историю не переписывает.** Силовая отправка нижней делает вершину
+  верхней достижимой из её основания, и хостинг закрывает заявку верхней как слитую — при том что
+  в главной ветке её правок нет. Расхождение чинится вливанием, а не переносом истории.
 - **Правка самой поставки проверяется её прогоном, а не рассуждением.** Проверить её иначе нечем:
   она исполняется только там, где выкатывает, и в среде, которой на месте работы нет — с чужими
   правами, чужим хранилищем ключей и чужой сетью. «Проверю после слияния» решением исполнителя не
@@ -60,6 +74,11 @@
 - **Признак режима исполнения объявлен в самом артефакте развёртывания, а не только в составе его
   запуска.** Артефакт поднимают и мимо состава — руками, при разборе, на чужой машине, — и без
   объявления он в этот момент считает себя отладочным, не сказав об этом ничего.
+- **Артефакт развёртывания несёт всё, чем настраивается запускаемое им.** Сборка проверяет, что
+  артефакт собрался, а не что его собственные шаги запуска исполнимы: недостающий файл настройки
+  не виден ни линтеру, ни сборке, ни шагу сборки образа в конвейере — он отказывает на первом
+  подъёме, то есть уже там, куда выкатили. Файл, лежащий рядом в репозитории, внутрь артефакта
+  сам не попадает.
 - **Выкатывается образ того коммита, который выкатывают.** Умолчание «последний» отстаёт от
   главной ветки, и приложение молча возвращается к прежней версии, продолжая отвечать.
 - **Из одного и того же коммита всегда ставятся одни и те же зависимости.** Если версия задана

package/assets/laws/frontend-application.md

@@ -18,6 +18,10 @@
 - **Оформление берётся из общего набора значений, а не пишется числом на месте.** Написанное
   числом расходится с остальным при первой же смене оформления, и найти все такие места
   нечем.
+- **Управляющий элемент не меняет размер, пока идёт начатая им работа.** Готовые наборы
+  элементов на время работы подменяют подпись и значок индикатором ожидания, и элемент
+  сжимается до собственных отступов: он прыгает, сдвигает соседей, а нажатие, которое человек
+  уже начал, уходит мимо.
 - **У каждого класса в разметке есть своё правило стилей.** Класс без правила выглядит
   рабочим и молча ничего не делает.
 - **Набор записей приходит с сервера страницей, а не целиком.** Список, растущий вместе с