@rt-tools/agent-kit 0.9.1 → 0.10.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/profile-check.sh, hooks/deny-tail.sh
 # Гард поставки. PreToolUse на заведении ветки, пуше и открытии заявки на слияние.
 #
 # Закон о поставке требует трёх вещей, которых обычно не проверяет ничто: правка начинается с
@@ -90,6 +90,11 @@ rt_needs rt_task_branch_ok git-guard-delivery || exit 0
 title_re="${RT_TASK_TITLE_RE:-^\[[A-Za-z]+-[0-9]+\][[:space:]]+[^[:space:]]}"
 task_new="${RT_TASK_NEW_CMD:-npm run task:new}"
 board_check="${RT_BOARD_CHECK_CMD:-npm run check:board}"
+task_move="${RT_TASK_MOVE_CMD:-npm run task:move}"
+# Первая колонка очереди работ — та, из которой задача уходит, когда её берут. Умолчания у неё
+# нет: имена колонок дерево называет своими словами, а выдуманное имя не совпало бы ни с чем и
+# молча выключило бы проверку.
+backlog_column="${RT_BOARD_BACKLOG:-}"
 task_bot="${RT_TASK_BOT:-}"
 commit_email="${RT_COMMIT_EMAIL:-}"
 tasks_dir="${RT_TASKS_DIR:-}"
@@ -108,18 +113,43 @@ main_branch="${RT_MAIN_BRANCH:-main}"
 folder_skip_re='(^|#)[[:space:]]*Task-folder-skip:[[:space:]]*[^[:space:]<"'"'"'][^[:space:]"'"'"']{2,}'
 
 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=git-guard-delivery "sid=$sid"
 
-    jq -n --arg r "$1" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
+    # Хвост отказа: два законных хода и форма обхода вторым параметром.
+    # shellcheck disable=SC1090
+    [ -f "$rt_hooks_dir/deny-tail.sh" ] && . "$rt_hooks_dir/deny-tail.sh" 2>/dev/null
+    reason="$1"
+    command -v rt_deny_tail >/dev/null 2>&1 && 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
 }
 
+# Несошедшиеся условия копятся и называются разом. Отказ по первому промаху заставляет чинить
+# их по одному: исполнитель правит основание, повторяет вызов, упирается в заголовок, правит
+# заголовок, упирается в задачу — и цена отказа растёт на каждом круге, хотя всё несошедшееся
+# было известно уже на первом. Готовность к поставке — одно состояние, и называется оно целиком.
+faults=''
+
+fault() {
+    faults="${faults}${faults:+
+}— $1"
+}
+
+# Отказ по накопленному. Пусто — вызывающая сторона идёт дальше.
+deny_faults() {
+    [ -z "$faults" ] && return 0
+    deny "BLOCKED: работа к поставке не готова. Несошедшееся названо целиком — чтобы чинить его
+одним заходом, а не по одному промаху на круг:
+
+${faults}"
+}
+
 # Подсказка вместо отказа: на открытии PR папка ещё нужна. Решения подсказка не несёт,
 # команда идёт дальше своим ходом.
 hint() {
@@ -138,20 +168,33 @@ folder_in_branch() {
 check_task() {
     number="$1"
     where="$2"
+    # Колонку спрашивают там, где она уже должна быть переставлена. На заведении ветки её ещё
+    # не двигали — паттерн работы переставляет колонку следующей командой, — и требование здесь
+    # отбивало бы первую же команду работы вместе с той, которая его и снимает.
+    judge_column="${3:-нет}"
     rt_needs rt_task_state git-guard-delivery || return 0
     state="$(cd "$root" && rt_task_state "$number" 2>/dev/null)" || return 0
     [ -z "$state" ] && return 0
 
     printf '%s' "$state" | jq -e '.exists' >/dev/null 2>&1 \
-        || deny "BLOCKED: ${where} ссылается на задачу #${number}, которой нет. Проверь номер или заведи задачу — ${task_new}."
+        || fault "${where} ссылается на задачу #${number}, которой нет. Проверь номер или заведи задачу — ${task_new}."
     printf '%s' "$state" | jq -e '.open' >/dev/null 2>&1 \
-        || deny "BLOCKED: задача #${number} закрыта, а у задачи одна ветка. Работа за закрытой задачей заводится новой задачей — ${task_new}."
+        || fault "задача #${number} закрыта, а у задачи одна ветка. Работа за закрытой задачей заводится новой задачей — ${task_new}."
     printf '%s' "$state" | jq -e '.onBoard' >/dev/null 2>&1 \
-        || deny "BLOCKED: задачи #${number} нет в очереди работ — правка за ней не видна. Очередь к репозиторию не привязана и задачу сама не забирает; добавь её и сверь — ${board_check}."
+        || fault "задачи #${number} нет в очереди работ — правка за ней не видна. Очередь к репозиторию не привязана и задачу сама не забирает; добавь её и сверь — ${board_check}."
     printf '%s' "$state" | jq -e '.assigned' >/dev/null 2>&1 \
-        || deny "BLOCKED: у задачи #${number} нет исполнителя — по очереди работ не видно, кто её взял. Поставь исполнителя${task_bot:+: }${task_bot}."
+        || fault "у задачи #${number} нет исполнителя — по очереди работ не видно, кто её взял. Поставь исполнителя${task_bot:+: }${task_bot}."
     printf '%s' "$state" | jq -e '.numbered' >/dev/null 2>&1 \
-        || deny "BLOCKED: заголовок задачи #${number} не начинается с её номера — одну работу придётся узнавать по тексту названия. Поправь заголовок и сверь очередь — ${board_check}."
+        || fault "заголовок задачи #${number} не начинается с её номера — одну работу придётся узнавать по тексту названия. Поправь заголовок и сверь очередь — ${board_check}."
+
+    # Колонка задачи. Ответ очереди работ отдаёт её давно, и не читал её никто: колонку судила
+    # только сверка очереди, то есть уже после того, как PR открыт. Задача, оставшаяся в первой
+    # колонке, читается по очереди как невзятая — работа при этом сделана и выложена.
+    if [ -n "$backlog_column" ] && [ "$judge_column" = "да" ]; then
+        column="$(printf '%s' "$state" | jq -r '.status // empty' 2>/dev/null)"
+        [ "$column" = "$backlog_column" ] \
+            && fault "задача #${number} стоит в колонке «${column}» — по очереди работ она не взята, хотя работа по ней идёт. Переставь её: ${task_move}."
+    fi
 
     return 0
 }
@@ -171,70 +214,109 @@ if [ -n "$branch_arg" ]; then
         rt_task_branch_ok "$branch_arg" \
             || deny "BLOCKED: имя ветки «${branch_arg}» не той формы, что принята здесь. Номер у ветки тот же, что у задачи и у заголовка заявки на слияние."
         check_task "$(printf '%s' "$branch_arg" | sed -nE 's/^[A-Za-z]+-([0-9]+).*/\1/p')" "ветка «${branch_arg}»"
+
+        # Условия поставки, известные уже здесь, спрашиваются здесь. Прежде их спрашивали на
+        # пуше и на открытии PR — то есть после того, как работа сделана: основание чинится
+        # мержем с разбором конфликта, а подпись коммитов — переписыванием всей ветки. В
+        # начале работы обе стоят одну команду.
+        #
+        # Основание: вершина главной ветки обязана лежать в том, от чего растёт новая ветка.
+        # Ветка, заведённая от вчерашнего основания, узнаёт об этом на открытии PR — и узнаёт
+        # так, что владелец видит её конфликтующей.
+        #
+        # Судится названное основание, а не вершина рабочей копии: команда, которой основание
+        # как раз и берут свежим — `git checkout -b <ветка> origin/<главная>`, — иначе
+        # отбивалась бы наравне с той, у которой основание вчерашнее.
+        base_arg="$(printf '%s' "$cmd" | sed -nE 's/.*git[[:space:]]+(checkout[[:space:]]+-b|switch[[:space:]]+-c)[[:space:]]+[^[:space:];&|]+[[:space:]]+([^[:space:];&|-][^[:space:];&|]*).*/\2/p' | head -1)"
+        base_ref="${base_arg:-HEAD}"
+        if git rev-parse --verify --quiet "refs/remotes/origin/${main_branch}" >/dev/null 2>&1 \
+            && git rev-parse --verify --quiet "$base_ref" >/dev/null 2>&1 \
+            && ! git merge-base --is-ancestor "origin/${main_branch}" "$base_ref" 2>/dev/null; then
+            behind="$(git rev-list --count "${base_ref}..origin/${main_branch}" 2>/dev/null)"
+            fault "ветка вырастет из основания, в котором нет вершины «${main_branch}» — она ушла вперёд на ${behind:-несколько} коммитов. Возьми свежее основание: git fetch origin && git checkout -b ${branch_arg} origin/${main_branch}."
+        fi
+
+        # Второй ярус: локальная ссылка на главную ветку сама могла протухнуть, и тогда молчание
+        # первого яруса значит «основание не старше моей ссылки», а не «основание свежее».
+        # Ответа нет — ярус молчит, как и везде, где гард ходит в сеть.
+        remote_head="$(GIT_HTTP_LOW_SPEED_LIMIT=1000 GIT_HTTP_LOW_SPEED_TIME=5 GIT_TERMINAL_PROMPT=0 \
+            git ls-remote origin "refs/heads/${main_branch}" 2>/dev/null | cut -f1)"
+        local_head="$(git rev-parse --verify --quiet "refs/remotes/origin/${main_branch}" 2>/dev/null)"
+        if [ -n "$remote_head" ] && [ -n "$local_head" ] && [ "$remote_head" != "$local_head" ]; then
+            fault "твоя ссылка origin/${main_branch} отстала от удалённой — ${local_head:0:8} против ${remote_head:0:8}. Ветка вырастет из вчерашнего дерева, и увидит это владелец на открытии заявки. Подтяни и повтори: git fetch origin."
+        fi
+
+        # Подпись: почта машинной записи объявлена деревом, а рабочая копия её не знает —
+        # значит первый же коммит уедет за чужой подписью, и чинить это придётся после пуша
+        # силовой отправкой.
+        if [ -n "$commit_email" ]; then
+            tree_email="$(git config user.email 2>/dev/null)"
+            [ -n "$tree_email" ] && [ "$tree_email" != "$commit_email" ] \
+                && fault "рабочая копия подписывает коммиты как «${tree_email}», а дерево объявило почтой машинной записи «${commit_email}». Первый же коммит уедет за чужой подписью: git config user.email \"${commit_email}\"."
+        fi
+
+        deny_faults
     fi
     # Ветка без номера законна и живёт локально: заявка с неё не откроется.
     exit 0
 fi
 
 # --- подпись машинного коммита ------------------------------------------------------------
+# Предмет живёт помощником рядом — `git-guard-delivery-signature.sh`: гард дорос до предела
+# длины, и подпись среди его предметов самая отдельная. Нет помощника — подпись не судится, а
+# работа идёт дальше: это тот же отказ в пользу работы, что и у остальных условий.
+# shellcheck disable=SC1090
+[ -f "$rt_hooks_dir/git-guard-delivery-signature.sh" ] \
+    && . "$rt_hooks_dir/git-guard-delivery-signature.sh" 2>/dev/null
+command -v rt_delivery_signature >/dev/null 2>&1 && rt_delivery_signature
+
+# --- снятие черновика --------------------------------------------------------------------
 #
-# Служебный адрес хостинга состоит из числа, логина и домена, а сопоставляется по числу: логин
-# рядом с ним не сверяет никто. Коммит с чужим числом хостинг припишет постороннему человеку, и
-# изнутри это выглядит верным — имя учётной записи в истории то самое. Так одиннадцать коммитов
-# и уехали в главную ветку за чужой подписью; нашёл это владелец, читая историю глазами.
-#
-# Точка — пуш: до него подпись переписывается на месте всей веткой сразу, после — только силовой
-# отправкой. На коммите гард не стоит: почта задаётся переменными самой команды, и разбор её из
-# текста ловил бы ту же строку, которая и так перед глазами у набравшего её.
-#
-# Судится коммит, НАЗВАВШИЙСЯ машинной записью: её логин стоит именем автора либо левой частью
-# почты. Опознавать по самой почте нельзя — она в таком коммите как раз и неверна, а требовать
-# машинную подпись от каждого коммита значило бы отбивать работу, сделанную человеком своими
-# руками в том же дереве.
+# Ревьювера до этой правки не спрашивал никто. Он стоял прозой в правиле, а хостинг запрос
+# разбора на самого себя принимает молча и не создаёт: разбор при этом выглядит запрошенным.
+# Раньше снятия черновика спросить негде — до открытия заявки ревьювера нет вовсе, — а само
+# снятие и есть тот ход, которым работа объявляется готовой.
 #
-# Логин читается из объявленной почты, а не объявляется вторым свойством: два объявления одного
-# логина разошлись бы молча. Исполнителем задачи он тоже не бывает — в дереве, где хостинг
-# ограничил машинную запись, исполнителем ставят человека, а коммит остаётся машинным.
+# Ярус сетевой, и молчит он так же, как ярус состояния задачи: нет ответа — нет требования.
 #
-# Вызов пуша узнаётся по двум признакам сразу — команда `git` в начале строки или за
-# разделителем и слово `push` отдельным словом. Одной подстрокой «git push» его не поймать:
-# помощник учётных данных и заголовок запроса ставятся ключами `-c` между ними.
-# Пробный пуш не отправляет ничего, и подпись у него не спрашивают.
-if printf '%s' "$cmd" | grep -qE '(^|[;&|(]|&&|\|\|)[[:space:]]*git([[:space:]]|$)' \
-    && printf '%s' "$cmd" | grep -qE '(^|[[:space:]])push([[:space:]]|$)' \
-    && ! printf '%s' "$cmd" | grep -q -- '--dry-run'; then
-    # Два условия молчания. Дерево, не назвавшее почты машинной записи, требования не получает:
-    # своей машинной записи у пакета нет, а выдуманная отбивала бы работу в чужом дереве.
-    # Вершины главной ветки нет — вклад считать не от чего.
-    #
-    # Судится вклад ветки, а не вся история: влитое в главную этой веткой уже не чинится, и
-    # отказ за него отбивал бы работу вместо промаха.
-    if [ -n "$commit_email" ] \
-        && git rev-parse --verify --quiet "refs/remotes/origin/${main_branch}" >/dev/null 2>&1; then
-        # Левая часть служебного адреса: `<число>+<логин>` либо просто логин.
-        bot_login="${commit_email%%@*}"
-        bot_login="${bot_login##*+}"
-
-        strangers=''
-        while IFS="$(printf '\t')" read -r short author email; do
-            [ -z "$short" ] && continue
-            login="${email%%@*}"
-            login="${login##*+}"
-            [ "$author" = "$bot_login" ] || [ "$login" = "$bot_login" ] || continue
-            [ "$email" = "$commit_email" ] && continue
-            strangers="${strangers}${strangers:+, }${short} <${email}>"
-        done <<EOF
-$(git log --format='%h%x09%an%x09%ae' "origin/${main_branch}..HEAD" 2>/dev/null)
-EOF
-
-        [ -n "$strangers" ] \
-            && deny "BLOCKED: машинный коммит подписан не той почтой, что объявлена деревом. Хостинг сопоставляет служебный адрес по числу в нём, и коммит с чужим числом он припишет постороннему человеку — изнутри промах не виден, потому что имя учётной записи рядом верное. Расходятся: ${strangers}. Объявлено: ${commit_email} — почта берётся оттуда, а не набирается по памяти. Перепиши подпись до пуша, после него это чинит только силовая отправка:
-    последний коммит — GIT_AUTHOR_NAME=\"${bot_login}\" GIT_AUTHOR_EMAIL=\"${commit_email}\" GIT_COMMITTER_NAME=\"${bot_login}\" GIT_COMMITTER_EMAIL=\"${commit_email}\" git commit --amend --no-edit --reset-author
-    весь вклад ветки — git filter-branch -f --env-filter 'GIT_AUTHOR_EMAIL=\"${commit_email}\"; GIT_COMMITTER_EMAIL=\"${commit_email}\"' origin/${main_branch}..HEAD"
+# Возврат заявки в черновик под требование не подпадает: он делает ровно то, чего гард и
+# добивается, — снимает с работы вид готовой.
+if printf '%s' "$cmd" | grep -qE '(^|[;&|(]|&&|\|\|)[[:space:]]*(gh[[:space:]]+pr[[:space:]]+ready|glab[[:space:]]+mr[[:space:]]+update[^|;&]*--ready)([[:space:]]|$)' \
+    && ! printf '%s' "$cmd" | grep -q -- '--undo'; then
+    # Ссылка на заявку необязательна: без неё клиент берёт заявку текущей ветки, и это самая
+    # короткая форма вызова. Требовать номер значило бы снимать всё требование одним пробелом.
+    # Поэтому берётся первый довод, каким бы он ни был — номер, адрес или имя ветки, — а его
+    # отсутствие означает «спроси про текущую ветку».
+    pull_ref="$(printf '%s' "$cmd" | sed -nE 's/.*(gh[[:space:]]+pr[[:space:]]+ready|glab[[:space:]]+mr[[:space:]]+update)[[:space:]]+([^[:space:];&|-][^[:space:];&|]*).*/\2/p' | head -1)"
+    if rt_needs rt_pull_state git-guard-delivery; then
+        pull="$(cd "$root" && rt_pull_state "$pull_ref" 2>/dev/null)" || pull=''
+        if [ -n "$pull" ] && printf '%s' "$pull" | jq -e '.exists' >/dev/null 2>&1; then
+            # Номер берётся из ответа, а если его там нет — из самой команды: заявка,
+            # названная адресом или именем ветки, в отказе должна остаться узнаваемой.
+            pull_name="$(printf '%s' "$pull" | jq -r '.number // empty' 2>/dev/null)"
+            # Номер пишется с решёткой, а имя ветки или адрес — в кавычках: решётка перед
+            # адресом читается как опечатка, а не как ссылка на заявку.
+            [ -z "$pull_name" ] && pull_name="$pull_ref"
+            case "$pull_name" in
+                '') ;;
+                *[!0-9]*) pull_name=" «${pull_name}»" ;;
+                *) pull_name=" #${pull_name}" ;;
+            esac
+            printf '%s' "$pull" | jq -e '.reviewed' >/dev/null 2>&1 \
+                || fault "у заявки${pull_name} нет разбора: ревьювер не запрошен и отзыва никто не оставлял. Снятый черновик читается как «можно вливать», а вливать некому — назначь ревьювера и повтори."
+
+            # Конфликт приезжает в отданную заявку чужим слиянием, без единого действия её
+            # автора: основание, проверенное на открытии, к моменту снятия черновика уже
+            # вчерашнее. Снятый черновик читается как «можно вливать», а вливать нечего —
+            # владелец открывает заявку и находит там конфликт. Молчание при неизвестной
+            # сливаемости остаётся: хостинг считает её заново после каждой правки главной ветки,
+            # и «ещё не посчитано» — не «конфликтует».
+            printf '%s' "$pull" | jq -e '.conflicting' >/dev/null 2>&1 \
+                && fault "заявка${pull_name} конфликтует с главной веткой. Влей её в свою ветку, разбери конфликт и повтори: снятый черновик читается как «можно вливать», а слить эту заявку нельзя."
+        fi
     fi
+    deny_faults
 fi
-# Своего выхода у этой точки нет: пуш бывает и составной командой, а второе её звено судят
-# разделы ниже.
 
 # --- слияние заявки ----------------------------------------------------------------------
 #
@@ -314,11 +396,11 @@ fi
 
 if [ -n "$title" ]; then
     printf '%s' "$title" | grep -qE "$title_re" \
-        || deny "BLOCKED: заголовок заявки не начинается с номера задачи. В списке заявок тела не видно, а строка связи живёт именно там — без номера в заголовке PR с задачей не сопоставить."
+        || fault "заголовок заявки не начинается с номера задачи. В списке заявок тела не видно, а строка связи живёт именно там — без номера в заголовке PR с задачей не сопоставить."
     title_number="$(printf '%s' "$title" | sed -nE 's/^\[[A-Za-z]+-([0-9]+)\].*/\1/p')"
     if [ -n "$number" ] && [ -n "$title_number" ]; then
         [ "$title_number" = "$number" ] \
-            || deny "BLOCKED: в заголовке заявки номер ${title_number}, у ветки — ${number}. Задача, ветка и PR несут один и тот же номер."
+            || fault "в заголовке заявки номер ${title_number}, у ветки — ${number}. Задача, ветка и PR несут один и тот же номер."
     fi
 fi
 
@@ -336,7 +418,7 @@ fi
 if git rev-parse --verify --quiet "refs/remotes/origin/${main_branch}" >/dev/null 2>&1 \
     && ! git merge-base --is-ancestor "origin/${main_branch}" HEAD 2>/dev/null; then
     behind="$(git rev-list --count "HEAD..origin/${main_branch}" 2>/dev/null)"
-    deny "BLOCKED: «${main_branch}» ушла вперёд на ${behind:-несколько} коммитов, а в ветку не влита. PR от разошедшейся ветки показывает ревьюверу правку вперемешку с чужой, а проверки на нём идут от устаревшего основания. Влей и повтори: git fetch origin && git merge origin/${main_branch} — порядок и разбор конфликта в паттерне git-workflow-merge."
+    fault "«${main_branch}» ушла вперёд на ${behind:-несколько} коммитов, а в ветку не влита. PR от разошедшейся ветки показывает ревьюверу правку вперемешку с чужой, а проверки на нём идут от устаревшего основания. Влей и повтори: git fetch origin && git merge origin/${main_branch} — порядок и разбор конфликта в паттерне git-workflow-merge."
 fi
 
 # Второй ярус: локальная ссылка сама могла протухнуть. Ответа нет — ярус молчит.
@@ -353,10 +435,14 @@ if [ -n "$remote_main" ] && [ -n "$local_main" ] && [ "$remote_main" != "$local_
     if [ -n "$fetched_at" ]; then
         age=" Последний git fetch — $(( ( $(date +%s) - fetched_at ) / 60 )) мин. назад."
     fi
-    deny "BLOCKED: твоя ссылка origin/${main_branch} отстала от удалённой — ${local_main:0:8} против ${remote_main:0:8}.${age} Гард сравнивает ветку с тем, что лежит в дереве, поэтому молчание первого яруса значит «ссылка не старше ветки», а не «главная ветка влита». Влей и повтори: git fetch origin && git merge origin/${main_branch}."
+    fault "твоя ссылка origin/${main_branch} отстала от удалённой — ${local_main:0:8} против ${remote_main:0:8}.${age} Гард сравнивает ветку с тем, что лежит в дереве, поэтому молчание первого яруса значит «ссылка не старше ветки», а не «главная ветка влита». Влей и повтори: git fetch origin && git merge origin/${main_branch}."
 fi
 
-check_task "$number" "заявка с ветки «${branch}»"
+check_task "$number" "заявка с ветки «${branch}»" да
+
+# Всё несошедшееся названо здесь, разом: до этой строки собирались условия, каждое из которых
+# прежде отбивало вызов в одиночку.
+deny_faults
 
 # Сейчас папка ещё нужна: правки по замечаниям ревью идут в эту же ветку, а без plan.md их не
 # пропустит гард хода работы. Поэтому здесь только напоминание. Требование стоит на слиянии —

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

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse Bash|mcp__webstorm__execute_terminal_command|mcp__webstorm__execute_tool
+# Требует: hooks/deny-tail.sh
 # Гард главной ветки. PreToolUse на вызове коммита.
 #
 # Коммит в главную ветку минует ветку, PR и разбор, а поставка построена на них целиком —
@@ -75,6 +76,17 @@ rt_hooks_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 command -v rt_note >/dev/null 2>&1 \
     && rt_note guard-deny res=git-guard-main "sid=$(printf '%s' "$input" | jq -r '.session_id // "nosession"' 2>/dev/null)"
 
+# Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть.
+# Файл может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+# shellcheck disable=SC1090
+[ -f "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" ] \
+    && . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" 2>/dev/null
+command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { :; }
+deny_tail_text="$(rt_deny_tail "")"
+[ -n "$deny_tail_text" ] && reason="${reason}
+
+${deny_tail_text}"
+
 jq -n --arg r "$reason" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
     || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Коммит в главную ветку отбит. Заведи ветку."}}\n'
 

package/assets/hooks/git-guard-push-tests.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/profile-check.sh, hooks/deny-tail.sh
 # Гард проверок перед пушем. PreToolUse на вызове пуша.
 #
 # Пуш — это вход в конвейер: слияние в главную ветку запускает выкатку, и всё, что не
@@ -43,13 +43,49 @@ cmd="$(printf '%s' "$input" | jq -r '.tool_input.command // empty' 2>/dev/null)"
 # ключами `-c` между ними, и ровно этой формой здесь и пушат. Пока признаком была подстрока,
 # весь набор гейта на таком пуше не гонялся вовсе, а молчание гарда читалось как «зелено».
 printf '%s' "$cmd" | grep -qE '(^|[;&|(]|&&|\|\|)[[:space:]]*git([[:space:]]|$)' || exit 0
-printf '%s' "$cmd" | grep -qE '(^|[[:space:]])push([[:space:]]|$)' || exit 0
+
+# Отложенная правка пушем не бывает: `git stash push` кладёт правку в тайник этой же машины и
+# наружу не отправляет ничего. Слово `push` в ней стоит отдельным, и без этой строки гард гонял
+# на ней весь набор, а потом отбивал вызов на первой красной проверке — то есть отбивал команду,
+# которая ничего никуда не отправляет. Тайник вырезается из строки, и признак считается по
+# остатку: в составной команде рядом с ним может стоять и настоящий пуш.
+probe="$(printf '%s' "$cmd" | sed -E 's/git[[:space:]]+stash[[:space:]]+push/git stash/g')"
+printf '%s' "$probe" | grep -qE '(^|[[:space:]])push([[:space:]]|$)' || exit 0
 
 # Пробный пуш ничего не отправляет: гонять ради него весь набор незачем.
 case "$cmd" in
     *--dry-run*) exit 0 ;;
 esac
 
+# Переключение ветки в той же команде отбивается целиком.
+#
+# Гард — это разбор команды ДО её запуска: набор он гоняет в том дереве, какое лежит сейчас.
+# Составная «переключиться и запушить» проходит гейт по ПРЕЖНЕЙ ветке — молча, проверяя не то.
+# Отказа при этом нет, и зелёный набор читается как проверка того, что уходит на хостинг.
+# Поймано это было случайно: гейт отбил пуш красной проверкой длины файла, которого в пушимой
+# ветке нет вовсе — он смотрел ветку, с которой в этой же команде уходили.
+#
+# Судится переключение на существующую ветку. Заведение новой (`checkout -b`, `switch -c`)
+# сюда не попадает: у свежей ветки дерево то же самое, что и было.
+if printf '%s' "$cmd" | grep -qE '(^|[;&|(]|&&|\|\|)[[:space:]]*git[[:space:]]+(checkout|switch)[[:space:]]+' &&
+    ! printf '%s' "$cmd" | grep -qE 'git[[:space:]]+(checkout[[:space:]]+-b|switch[[:space:]]+-c)([[:space:]]|$)'; then
+    reason="BLOCKED: переключение ветки и пуш одной командой. Набор гейта гоняется в том дереве, какое лежит на момент разбора команды, — то есть по ПРЕЖНЕЙ ветке, а не по той, что уходит на хостинг. Зелёный набор при этом читается как проверка ушедшего, хотя проверял он другое. Раздели вызовы: сперва переключись, затем отдельной командой пушь."
+    # Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть.
+    # Файл может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+    # shellcheck disable=SC1090
+    [ -f "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" ] \
+        && . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" 2>/dev/null
+    command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { :; }
+    deny_tail_text="$(rt_deny_tail "")"
+    [ -n "$deny_tail_text" ] && reason="${reason}
+
+${deny_tail_text}"
+
+    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
+fi
+
 workdir="$(printf '%s' "$input" | jq -r '.cwd // empty' 2>/dev/null)"
 [ -z "$workdir" ] && workdir="${CLAUDE_PROJECT_DIR:-.}"
 cd "$workdir" 2>/dev/null || exit 0
@@ -99,6 +135,17 @@ reason="BLOCKED: пуш без зелёного локального прого
 
 ${tail_out}"
 
+# Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть.
+# Файл может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+# shellcheck disable=SC1090
+[ -f "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" ] \
+    && . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" 2>/dev/null
+command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { :; }
+deny_tail_text="$(rt_deny_tail "")"
+[ -n "$deny_tail_text" ] && reason="${reason}
+
+${deny_tail_text}"
+
 jq -n --arg r "$reason" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
     || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Проверки перед пушем не прошли."}}\n'
 

package/assets/hooks/grill-gate.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse AskUserQuestion
+# Требует: hooks/deny-tail.sh
 # rt-hook: Stop
 # Гард разговора: вопрос владельцу не задаётся, пока за этот же ход не читались законы и
 # правила. Стоит на двух событиях, и это не дублирование.
@@ -105,6 +106,17 @@ reason="$head Вопрос, ответ на который уже записан
 
 Гард судит один ход: следующий заход не отбивается."
 
+# Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть.
+# Файл может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+# shellcheck disable=SC1090
+[ -f "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" ] \
+    && . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" 2>/dev/null
+command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { :; }
+deny_tail_text="$(rt_deny_tail "")"
+[ -n "$deny_tail_text" ] && reason="${reason}
+
+${deny_tail_text}"
+
 # Форма отказа у двух событий разная: вызов инструмента отбивается решением о доступе, а
 # завершение хода — решением о ходе. Одна форма на оба события молча не срабатывает.
 if [ -n "$tool" ]; then

package/assets/hooks/handoff-entry-guard.sh

@@ -0,0 +1,71 @@
+#!/usr/bin/env bash
+# rt-hook: PreToolUse Edit|Write|MultiEdit
+# Требует: rules/task-flow.md, hooks/deny-tail.sh
+# Гард входа из передачи: заход, начатый с передачи, не правит файлов, пока не загружено правило
+# ведения работы.
+#
+# Передача написана прошлым заходом, лежит вне дерева и не читается ни одной проверкой. Её
+# читают как задание — и берутся за работу мимо правила: состояние не сверено с деревом, числа
+# взяты на веру, порядок входа исполняется по памяти. Порядок, записанный только словами,
+# исполняется, пока о нём помнят.
+#
+# Заход узнаётся по первой реплике владельца: в ней назван путь к передаче либо её текст.
+# Загрузка правила — по вызову инструмента правил за тот же заход.
+#
+# FAIL-OPEN: нет `jq`, нет записи хода, передачи в реплике нет → пропуск.
+
+input="$(cat 2>/dev/null)"
+[ -z "$input" ] && exit 0
+command -v jq >/dev/null 2>&1 || exit 0
+
+tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
+case "$tool" in
+    Edit | Write | MultiEdit) ;;
+    *) exit 0 ;;
+esac
+
+transcript="$(printf '%s' "$input" | jq -r '.transcript_path // empty' 2>/dev/null)"
+[ -z "$transcript" ] && exit 0
+[ -f "$transcript" ] || exit 0
+
+# Имя правила ведения работы у дерева своё, но каталог передач общий: гард смотрит оба признака.
+rule="${RT_TASK_FLOW_RULE:-task-flow}"
+
+verdict="$(jq -s -r --arg rule "$rule" '
+    [.[] | select(.type == "user") | .message.content
+       | if type == "string" then . elif type == "array"
+         then (map(if type == "object" then (.text // "") else "" end) | join("\n")) else "" end] as $said
+    | [.[] | select(.type == "assistant") | (.message.content // [])[] | select(.type == "tool_use")
+       | ((.name // "") + " " + ((.input.skill // .input.command // "") | tostring))] as $used
+    | (($said | join("\n")) | test("handoff|передач[аи][[:space:]]+захода")) as $from_handoff
+    | (($used | join("\n")) | test("Skill[[:space:]]+" + $rule + "|skills/" + $rule)) as $loaded
+    | if ($from_handoff and ($loaded | not)) then "нет-правила" else "ладно" end
+' "$transcript" 2>/dev/null)"
+
+[ "$verdict" = "нет-правила" ] || exit 0
+
+reason="BLOCKED by handoff-entry-guard: заход начат с передачи, а правило ведения работы за него не загружено.
+
+Передача написана прошлым заходом, лежит вне дерева и не читается ни одной проверкой: всё, что в ней стоит, проверяется деревом. Порядок входа — четыре шага:
+
+    1. правило ведения работы и паттерн возвращения — первым движением;
+    2. ветка и состояние работы читаются в дереве, а не в передаче;
+    3. числа из передачи пересчитываются на текущем коммите;
+    4. следующий шаг берётся из хода работы.
+
+Загрузи правило и повтори правку."
+
+# Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть.
+# Файл может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+# shellcheck disable=SC1090
+[ -f "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" ] \
+    && . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" 2>/dev/null
+command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { :; }
+deny_tail_text="$(rt_deny_tail "")"
+[ -n "$deny_tail_text" ] && reason="${reason}
+
+${deny_tail_text}"
+
+jq -n --arg r "$reason" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
+    || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"handoff-entry-guard: правило ведения работы не загружено."}}\n'
+exit 0

package/assets/hooks/postmortem-guard.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: Stop
+# Требует: hooks/deny-tail.sh
 # Гард происшествия: ход, в котором исполнитель признал промах, не заканчивается, пока записи о
 # происшествии нет. Stop.
 #
@@ -86,6 +87,17 @@ reason="BLOCKED by postmortem-guard: в ответе признан промах
 
 Гард судит один ход: следующий заход не отбивается."
 
+# Общий хвост отказа: два законных хода. Файл может быть не разложен — тогда хвоста нет,
+# а причина отказа остаётся прежней.
+# shellcheck disable=SC1090
+[ -f "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" ] \
+    && . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" 2>/dev/null
+command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { :; }
+deny_tail_text="$(rt_deny_tail "")"
+[ -n "$deny_tail_text" ] && reason="${reason}
+
+${deny_tail_text}"
+
 jq -n --arg r "$reason" '{decision:"block",reason:$r}' 2>/dev/null \
     || printf '{"decision":"block","reason":"postmortem-guard: признан промах — запиши разбор происшествия."}\n'
 

package/assets/hooks/proposal-guard.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: Stop
+# Требует: hooks/deny-tail.sh
 # Гард предложения: ход, в котором владелец сказал завести или отправить предложение слою правил,
 # не заканчивается, пока отправки не было. Stop.
 #
@@ -87,6 +88,17 @@ reason="BLOCKED by proposal-guard: владелец сказал завести
 
 Гард судит один ход: следующий заход не отбивается."
 
+# Общий хвост отказа: два законных хода. Файл может быть не разложен — тогда хвоста нет,
+# а причина отказа остаётся прежней.
+# shellcheck disable=SC1090
+[ -f "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" ] \
+    && . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" 2>/dev/null
+command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { :; }
+deny_tail_text="$(rt_deny_tail "")"
+[ -n "$deny_tail_text" ] && reason="${reason}
+
+${deny_tail_text}"
+
 jq -n --arg r "$reason" '{decision:"block",reason:$r}' 2>/dev/null \
     || printf '{"decision":"block","reason":"proposal-guard: владелец просил предложение — отправь его командой пакета."}\n'