@rt-tools/agent-kit 0.9.0 → 0.10.0

package/assets/hooks/prose-style-guard.sh

@@ -0,0 +1,73 @@
+#!/usr/bin/env bash
+# rt-hook: PreToolUse Edit|Write|MultiEdit
+# Требует: checks/check-prose-style.mjs, hooks/deny-tail.sh
+# Гард слога: канцелярит и слова, которых в этом дереве не пишут, не уезжают в файл.
+#
+# Правило о текстах требует простых слов, а держалось это памятью того, кто пишет: ни одна
+# формулировочная договорённость не проверялась. Владелец читает написанное и видит машинный
+# слог там, где договорённость требует человеческого.
+#
+# Судится только новый текст правки, а не файл целиком: накопленное чинится отдельной работой, и
+# отбивать за него правку соседней строки — значит сделать гард обходимым по необходимости.
+#
+# FAIL-OPEN: нет узла, нет проверки, чужой инструмент, не `.md` → пропуск.
+
+input="$(cat 2>/dev/null)"
+[ -z "$input" ] && exit 0
+command -v jq >/dev/null 2>&1 || exit 0
+command -v node >/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
+
+path="$(printf '%s' "$input" | jq -r '.tool_input.file_path // empty' 2>/dev/null)"
+case "$path" in
+    *.md) ;;
+    *) exit 0 ;;
+esac
+
+# Описание прошлого и папки задач не судятся: архив не правится вовсе, а ход работы пишется
+# наспех и живёт до слияния.
+case "$path" in
+    */docs/archive/* | */docs/tasks/*) exit 0 ;;
+esac
+
+added="$(printf '%s' "$input" | jq -r '.tool_input.new_string // .tool_input.content // ([.tool_input.edits[]?.new_string] | join("\n")) // empty' 2>/dev/null)"
+[ -z "$added" ] && exit 0
+
+rt_hooks_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+check=""
+for candidate in "$rt_hooks_dir/../checks/check-prose-style.mjs" "$rt_hooks_dir/../rt-kit/checks/check-prose-style.mjs" "${CLAUDE_PROJECT_DIR:-.}/tools/check-prose-style.mjs"; do
+    [ -f "$candidate" ] && check="$candidate" && break
+done
+[ -z "$check" ] && exit 0
+
+tmp="$(mktemp -t prose)" || exit 0
+printf '%s\n' "$added" > "$tmp"
+found="$(node "$check" "$tmp" 2>&1 | grep -- '—' | sed 's|.*proba*[^:]*:|  строка |' | head -8)"
+rm -f "$tmp"
+[ -z "$found" ] && exit 0
+
+reason="BLOCKED by prose-style-guard: в новом тексте канцелярит или слово, которого в этом дереве не пишут.
+
+${found}
+
+Правь текст, а не обходи находку: замена названа у каждой. Слог — правило о текстах, и проверка видит перечисленные признаки, а не стиль вообще: чистый по ней абзац может быть плохим, но грязный плохой точно."
+
+# Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть.
+# Файл может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+# 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":"prose-style-guard: канцелярит в новом тексте."}}\n'
+exit 0

package/assets/hooks/qa-dataid-guard.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse Edit|Write|MultiEdit|mcp__webstorm__create_new_file
-# Требует: hooks/profile-check.sh
+# Требует: hooks/profile-check.sh, hooks/deny-tail.sh
 # Гард якоря для спек. PreToolUse на правке разметки.
 #
 # Спеки адресуют элементы только через этот атрибут. Классы оформления меняются вместе с
@@ -122,6 +122,17 @@ missing="$(printf '%s' "$added" | RT_QA_DECORATIVE="$decorative" RT_QA_COMPONENT
 
 reason="BLOCKED: интерактивные элементы без якоря для спек в ${path##*/}: ${missing}. Спеки адресуют элементы только через этот атрибут: классы оформления меняются вместе с вёрсткой, а поиск по роли и тексту ломается на переводах — оба вида селекторов делают сквозные спеки хрупкими. Проставь якорь через дефис по смыслу элемента; повторяющиеся элементы списка носят ОДИН якорь и различаются атрибутами данных. Если элемент чисто декоративный и спека его никогда не тронет — поставь атрибут пропуска НА САМ ЭТОТ ТЕГ, соседние элементы правки при этом продолжают проверяться."
 
+# Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть.
+# Файл может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+# 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/rerun-guard.sh

@@ -0,0 +1,86 @@
+#!/usr/bin/env bash
+# rt-hook: PreToolUse Bash|mcp__webstorm__execute_terminal_command|mcp__webstorm__execute_tool
+# Требует: hooks/deny-tail.sh
+# Гард перезапуска прогона: упавшее задание не перезапускается, пока его журнал не прочитан.
+#
+# Красное на прогоне бывает двух родов, и со стороны списка они выглядят одинаково: отказ
+# хостинга на шаге подготовки — раннер не скачал действие, ответ `429` — и дефект самой ветки.
+# Первый лечится перезапуском, второй перезапуском не лечится вовсе: та же ветка падает тем же
+# местом, и круг повторяется, пока кто-нибудь не откроет журнал. Три прогона одного дня так и
+# перезапускались подряд.
+#
+# Гард судит ПОРЯДОК, а не причину падения: журнал раньше перезапуска. Что в журнале написано,
+# он не читает и читать не может — красное по существу судит человек.
+#
+# Признак чтения — вызов за тот же ход, показывающий журнал этого задания: номер задания в
+# команде тот же, что и в перезапуске. Номер сверяется, потому что прочитанный журнал соседнего
+# задания о нашем не говорит ничего, а по списку прогонов они стоят рядом.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ: нет `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
+    # Терминал среды и универсальный исполнитель кладут команду в то же поле.
+    Bash | mcp__webstorm__execute_terminal_command | mcp__webstorm__execute_tool) ;;
+    *) exit 0 ;;
+esac
+
+cmd="$(printf '%s' "$input" | jq -r '.tool_input.command // empty' 2>/dev/null)"
+[ -z "$cmd" ] && 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
+
+# Вызов перезапуска: слово перезапуска отдельным словом рядом со словом прогона.
+host_cli="${RT_HOST_CLI:-gh}"
+printf '%s' "$cmd" | grep -qE "(^|[;&|(]|&&|\|\|)[[:space:]]*${host_cli}([[:space:]]|$)" || exit 0
+printf '%s' "$cmd" | grep -qE '(^|[[:space:]])(run|workflow)([[:space:]]|$)' || exit 0
+printf '%s' "$cmd" | grep -qE '(^|[[:space:]])rerun([[:space:]]|$)' || exit 0
+
+# Номер задания. Не назван — гард молчит: судить не о чем.
+run_id="$(printf '%s' "$cmd" | grep -oE '(^|[[:space:]])[0-9]{6,}([[:space:]]|$)' | tr -d ' ' | head -1)"
+[ -z "$run_id" ] && exit 0
+
+transcript="$(printf '%s' "$input" | jq -r '.transcript_path // empty' 2>/dev/null)"
+[ -z "$transcript" ] && exit 0
+[ -f "$transcript" ] || exit 0
+
+# Читался ли журнал ЭТОГО задания за тот же ход. Ход — вызовы после последней реплики владельца:
+# журнал, прочитанный вчера, о сегодняшнем состоянии прогона не говорит ничего.
+seen="$(jq -s -r --arg id "$run_id" '
+    [.[] | select(.type == "assistant") | (.message.content // [])[] | select(.type == "tool_use")
+       | ((.input.command // "") | tostring)] as $used
+    | (($used | join("\n")) | test("run[[:space:]]+view[^\\n]*" + $id + "|" + $id + "[^\\n]*--log")) as $read
+    | if $read then "читал" else "не-читал" end
+' "$transcript" 2>/dev/null)"
+
+[ "$seen" = "читал" ] && exit 0
+
+reason="BLOCKED by rerun-guard: перезапуск задания ${run_id} без прочитанного журнала. Красное на прогоне бывает двух родов, и в списке они выглядят одинаково: отказ хостинга на шаге подготовки лечится перезапуском, дефект ветки — не лечится им вовсе, и круг повторяется, пока журнал не открыт. Прочитай журнал этого задания — ${host_cli} run view ${run_id} --log-failed — и повтори вызов. Гард судит порядок, а не причину падения: что в журнале написано, судишь ты."
+
+# Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть.
+# Файл может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+# 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":"rerun-guard: журнал задания за этот ход не читался."}}\n'
+exit 0

package/assets/hooks/reuse-first-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/profile-check.sh, hooks/deny-tail.sh
 # Гард «ничего не пишется с нуля». PreToolUse на правке кода и разметки.
 #
 # Линтеры знают правила, но не знают ИНВЕНТАРЬ: линтер стилей поймает сырой цвет, линтер кода —
@@ -312,6 +312,17 @@ ${found}
 Порядок действий: 1) открой готовое — барель кита или базовый класс — и используй его; 2) найди в дереве экран, где этот случай уже собран, и повтори сборку; 3) если готового правда не хватает — расширяй его на месте, у готового, а не клонируй рядом: клон забирает правки на себя и расходится с оригиналом с первой же.
 Свой примитив, своя основа и свои инлайновые стили заводятся только с явного одобрения владельца, и спрашивается это до первого написанного файла. Разовое исключение помечается маркером отступления в той же строке, с объяснением, чего именно нет в готовом. Переименованием файла это не обходится."
 
+# Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть.
+# Файл может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+# 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/roles.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+# Состояние роли слоя правил. НЕ гард: объявления `rt-hook:` у него нет, к событиям агента он не
+# подключается. Его источают гарды, стоящие при ролях, — тем же приёмом, каким гейт источает
+# карту, а гарды — профиль дерева.
+#
+# Зачем он есть. Роль, при которой стоит гард, зовётся не по усмотрению исполнителя: гард держит
+# работу, пока роль не сказала своё. Выключить её было нечем — отказ от файла роли в настройке
+# убирал роль и оставлял гард, и дереву, которому роль в эту минуту мешает, оставалось вырезать
+# гард из настроек руками. Теперь дерево называет выключенные роли одним списком, а гард при
+# такой роли выходит молча.
+#
+# Выключается обязательность вызова, а не сама роль: файл роли остаётся разложенным, и позвать
+# её руками можно в любую минуту.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ наоборот: всё, чего не хватило, читается как «роль включена». Нет `jq`,
+# нет настройки, настройка не разбирается — гард работает, как работал. Сломанное чтение,
+# гасящее роль, выключало бы слой правил молча, и заметить это было бы нечем.
+
+# Выключена ли роль. Успех — выключена.
+#
+#   rt_role_off strict-teacher && exit 0
+rt_role_off() {
+    local role="$1" config
+    [ -n "$role" ] || return 1
+    command -v jq >/dev/null 2>&1 || return 1
+    config="${CLAUDE_PROJECT_DIR:-.}/.claude/rt-kit.json"
+    [ -f "$config" ] || return 1
+    [ "$(jq -r --arg role "$role" '
+        if ((.rolesOff // []) | type) == "array" and (((.rolesOff // []) | index($role)) != null)
+        then "off" else "on" end
+    ' "$config" 2>/dev/null)" = "off" ]
+}

package/assets/hooks/skill-gate.sh

@@ -1,5 +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|mcp__claude-in-chrome__.*
+# Требует: hooks/deny-tail.sh
 # Гейт правил: не даёт править файл, пока не загружено правило, под которое он подпадает.
 #
 # Закон и правило, которых никто не открывает, не действуют. Напоминание в подсказке помогает
@@ -172,6 +173,17 @@ if [ -n "$law" ]; then
         && reason="Отбито гейтом правил: загрузи правило «${req}» инструментом Skill — оно применяет закон ${law_path} к этому дереву — и повтори действие. ${fallback} Для этой области это происходит один раз за сессию."
 fi
 
+# Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть.
+# Файл может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+# 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":"Загрузи правило %s и повтори."}}\n' "$req"
 

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

@@ -67,7 +67,8 @@ verdict() {
     if [ -n "$soft" ]; then
         ask "Запрос помечен маркером destructive-ok, но остаётся разрушительным: $1 Подтверди выполнение, если это осознанно."
     fi
-    deny "BLOCKED: $1 Адресуй строки по первичному ключу — \`WHERE id IN ('…','…')\`: так затрагивается ровно столько строк, сколько перечислено, и промах виден до выполнения. Удаление по маске (email LIKE '%test%') однажды унесло вместе с тестовыми записями демонстрационные брони владельца. Если адресация по id действительно не подходит — сначала выполни SELECT с тем же условием, покажи пользователю, что попадает под удаление, и помечай запрос маркером destructive-ok с объяснением."
+    deny "BLOCKED: $1 Адресуй строки по первичному ключу — \`WHERE id IN ('…','…')\`: так затрагивается ровно столько строк, сколько перечислено, и промах виден до выполнения. Удаление по маске (email LIKE '%test%') однажды унесло вместе с тестовыми записями демонстрационные брони владельца. Если адресация по id действительно не подходит — сначала выполни SELECT с тем же условием и покажи пользователю, что попадает под удаление." \
+        "маркер destructive-ok при запросе, с объяснением"
 }
 
 sql_check_destructive() {

package/assets/hooks/sql-guard.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse Bash|mcp__webstorm__execute_sql_query|mcp__webstorm__execute_terminal_command|mcp__webstorm__execute_tool
+# Требует: hooks/deny-tail.sh
 # Гард пишущих запросов к хранилищу. PreToolUse.
 #
 # Правка данных — единственное действие, которое нельзя откатить правкой кода. Удаление по
@@ -69,8 +70,18 @@ done
 
 PROD_DSN="${RT_PROD_DSN:-}"
 
+# Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть. Файл
+# может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+# 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() {
-    jq -n --arg r "$1" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
+    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":"Destructive SQL blocked. Address rows by id."}}\n'
     exit 0
 }

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/profile-check.sh, hooks/deny-tail.sh
 # PreToolUse guard for Edit|Write|MultiEdit: код не пишется раньше замысла.
 #
 # Работа идёт много заходов, и между ними исполнитель не помнит ничего. Замысел, лежащий на
@@ -8,9 +8,14 @@
 # закоммичены, PR не открыт, а очередь работ показывает задачу начатой и молчит о том, что
 # внутри неё сделано.
 #
-# Гард требует три вещи и ровно их: папку задачи по имени ветки, замысел в ней и названную в
-# замысле договорённость о продукте. Полноту написанного он не судит — это за владельцем
-# (решения в законе `docs/constitution/work-conduct.md`).
+# Гард требует четыре вещи и ровно их: папку задачи по имени ветки, замысел в ней, объявленное
+# в ходе работы состояние — из тех, в которых код правится, — и названную в замысле
+# договорённость о продукте. Полноту написанного он не судит — это за владельцем (решения в
+# законе `docs/constitution/work-conduct.md`).
+#
+# Состояние судится раньше договорённости и её обхода: обход снимает требование договорённости,
+# а не требование дойти до правки кода. Судится объявленный переход, а не наличие файлов —
+# артефакт, положенный ради снятия отказа, лежит так же, как написанный.
 #
 # Правило целиком — скил `task-flow`.
 #
@@ -102,9 +107,20 @@ EOF
 # Каталог папок задач: у дерева он свой, но имя обычно общее.
 tasks_dir="${RT_TASKS_DIR:-docs/tasks}"
 
+# Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть. Файл
+# может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+# 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() {
-    jq -n --arg r "$1" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
-        || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"%s"}}\n' "$1"
+    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
 }
 
@@ -130,6 +146,53 @@ 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
 
+# Состояние работы. Артефакт на диске не говорит, дошла ли работа до правки кода: пустой
+# `plan.md`, положенный ради снятия отказа, лежит точно так же, как написанный замысел, и
+# требование снимает сам собой. Единица работы — состояние, а не файл: исполнитель объявляет
+# его строкой в ходе работы, гард судит объявленный переход, а не наличие файлов.
+#
+# Состояние стоит в разделе «Где стоим» и перезаписывается вместе с ним. Имя берётся из
+# перечня — своё имя состоянием не является: перечень называет вход, выход и обязательное
+# действие каждого, и слово вне перечня не говорит ни о чём из трёх.
+progress="$dir/progress.md"
+
+if [ ! -f "$progress" ]; then
+    deny "BLOCKED by task-flow: нет хода работы — '${tasks_dir}/${branch}/progress.md'. В нём объявляется состояние работы, и без него не видно, дошла ли она до правки кода. Собери папку задачи с образца (cp -r ${tasks_dir}/_template ${tasks_dir}/${branch}), затем повтори. Правило — скил task-flow."
+fi
+
+state="$(sed -n 's/^[[:space:]]*[-*][[:space:]]*\*\*Состояние:\*\*[[:space:]]*`\([^`]*\)`.*/\1/p' "$progress" 2>/dev/null | head -1)"
+
+# Обязательное действие состояния. Отказ называет его целиком: исполнитель, которому сказано
+# только «не в том состоянии», переписывает строку состояния вместо того, чтобы сделать шаг.
+state_action() {
+    case "$1" in
+        просьба-не-разобрана) printf '%s' 'разведка по дереву, затем вопросы владельцу' ;;
+        разбор-закрыт) printf '%s' 'договорённость о продукте либо названная причина её отсутствия' ;;
+        договорённость-записана) printf '%s' 'завести задачу, ветку и папку задачи' ;;
+        задача-взята) printf '%s' 'написать замысел' ;;
+        замысел-записан) printf '%s' 'делать первый этап' ;;
+        папка-разобрана) printf '%s' 'снять черновик и попросить владельца влить' ;;
+        влито) printf '%s' 'разбор работы правилами и сверка очереди работ' ;;
+        *) printf '%s' '' ;;
+    esac
+}
+
+if [ -z "$state" ]; then
+    deny "BLOCKED by task-flow: в '${tasks_dir}/${branch}/progress.md' не объявлено состояние работы. Впиши в раздел «Где стоим» строку '- **Состояние:** \`<имя>\`' — имя из перечня состояний правила, — затем повтори. Код правится в состояниях 'этап-идёт', 'этапы-кончились', 'работа-отдана' и 'разбор-кончился'. Правило — скил task-flow."
+fi
+
+case "$state" in
+    # Состояния, в которых код приложения правится. Три последних — не про первый заход:
+    # прогон бывает красным, а разбор — с замечаниями, и починка идёт в ту же ветку.
+    этап-идёт | этапы-кончились | работа-отдана | разбор-кончился) ;;
+    просьба-не-разобрана | разбор-закрыт | договорённость-записана | задача-взята | замысел-записан | папка-разобрана | влито)
+        deny "BLOCKED by task-flow: в ходе работы объявлено состояние '${state}', а код в нём не правится. Обязательное действие этого состояния — $(state_action "$state"). Дошла работа до правки кода — перепиши строку состояния в '${tasks_dir}/${branch}/progress.md' на '- **Состояние:** \`этап-идёт\`'. Правило — скил task-flow."
+        ;;
+    *)
+        deny "BLOCKED by task-flow: в '${tasks_dir}/${branch}/progress.md' объявлено состояние '${state}', а такого в перечне нет. Имя берётся из перечня состояний правила — своё слово не говорит ни о входе, ни о выходе, ни об обязательном действии. Правило — скил task-flow."
+        ;;
+esac
+
 # Строка обхода: поведение не меняется, договорённость о продукте не нужна. Причина обязана
 # стоять — без неё обход становится умолчанием.
 if grep -qE '^\*\*Поведение:\*\*[[:space:]]*не меняется[[:space:]]*—[[:space:]]*\S' "$plan" 2>/dev/null; then
@@ -139,7 +202,8 @@ 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."
+    deny "BLOCKED by task-flow: в '${tasks_dir}/${branch}/plan.md' не названа договорённость о продукте. Заведи её в docs/specs/<домен>/proposed/<фича>/ и укажи строкой '**Драфт:** \`путь\`'. Правило — скил task-flow." \
+        "строка '**Поведение:** не меняется — <причина владельца>' в замысле; пустая причина не принимается"
 fi
 
 case "$draft" in