@rt-tools/agent-kit 0.5.1 → 0.5.2

package/assets/hooks/observe.sh

@@ -0,0 +1,90 @@
+#!/usr/bin/env bash
+# Запись наблюдений о слое правил. НЕ гард: объявления `rt-hook:` у него нет, к событиям агента
+# он не подключается. Его источают гарды — тем же приёмом, каким гейт источает карту.
+#
+# Зачем он есть. Правки в тексты пакета шли из головы того, кто их пишет: чем из разложенного
+# пользуются каждый день, чем не пользовались ни разу и обо что спотыкаются по второму кругу,
+# пакету было неизвестно. Часть данных при этом уже собиралась и выбрасывалась — запись загрузок
+# жила во временном каталоге и гибла со сжатием контекста.
+#
+# ЧТО ЗАПИСЫВАЕТСЯ. Только имена ресурсов пакета и счётчики: имя правила или гарда, род события,
+# род файла, версия пакета и признак сессии. Ни путей дерева, ни имён его доменов, ни имени
+# самого дерева — и держится это не памятью зовущего, а `rt_observe_clean`: значение со слэшем
+# не пишется вовсе. Наблюдение уезжает потом в чужой репозиторий, и запрет называть чужое дерево
+# обязан держаться конструкцией.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ. Наблюдение — побочная работа гарда, и любая её поломка молча пропускает
+# действие: недоступный каталог, отсутствие `date`, полный диск. Гард, упавший на записи
+# наблюдения, останавливал бы работу ради статистики.
+
+# Значение, годное к записи. Путь не выносится ни при каких обстоятельствах, остальное чистится
+# до имени и обрезается: длинное значение в наблюдении не значит ничего, кроме утечки.
+rt_observe_clean() {
+    case "$1" in
+        */*) return 0 ;;
+    esac
+    printf '%s' "$1" | LC_ALL=C tr -cd 'A-Za-z0-9._:-' | cut -c1-48
+}
+
+# Признак сессии: считается по её имени и обратно не восстанавливается. Нужен, чтобы сводка
+# знала число заходов, а не только число событий.
+rt_observe_session() {
+    printf '%s' "$1" | cksum 2>/dev/null | cut -d' ' -f1
+}
+
+# Версия пакета, разложившего этот файл. Стоит в шапке, которую ставит раскладка; в исходниках
+# пакета шапки нет, и там версия — `dev`.
+rt_observe_version() {
+    local found
+    found="$(sed -n 's/^# rt-kit v\([^ ]*\) .*/\1/p' "${BASH_SOURCE[0]}" 2>/dev/null | head -1)"
+    printf '%s' "${found:-dev}"
+}
+
+# Каталог наблюдений этого дерева. Пустая строка — записи не будет.
+rt_observe_dir() {
+    local root="${CLAUDE_PROJECT_DIR:-.}" config
+    config="$root/.claude/rt-kit.json"
+    # Выключатель дерева гасит запись целиком, а не частями: пакет стоит и у тех, о ком мы не
+    # знаем. Нечитаемая настройка выключателем не считается — иначе сломанный JSON тихо
+    # выключал бы наблюдения, и понять это было бы нечем.
+    if [ -f "$config" ] && command -v jq >/dev/null 2>&1; then
+        [ "$(jq -r 'if .observe == false then "off" else "on" end' "$config" 2>/dev/null)" = "off" ] && return 0
+    fi
+    printf '%s' "$root/.claude/rt-kit/observations"
+}
+
+# Одно наблюдение: род события и пары `ключ=значение`. Ключ `sid` хешируется, остальные
+# чистятся. Пустое значение поля не заводит.
+#
+#   rt_note gate-deny res=styling-bem kind=scss sid="$sid"
+rt_note() {
+    local kind="$1" dir day stamp line pair key value
+    [ -n "$kind" ] || return 0
+    shift
+
+    dir="$(rt_observe_dir)"
+    [ -n "$dir" ] || return 0
+    mkdir -p "$dir" 2>/dev/null || return 0
+
+    day="$(date -u +%Y-%m-%d 2>/dev/null)" || return 0
+    stamp="$(date -u +%Y-%m-%dT%H:%M:%SZ 2>/dev/null)" || return 0
+    [ -n "$day" ] || return 0
+
+    line="{\"t\":\"$stamp\",\"ev\":\"$(rt_observe_clean "$kind")\""
+    for pair in "$@"; do
+        key="$(rt_observe_clean "${pair%%=*}")"
+        value="${pair#*=}"
+        [ -n "$key" ] || continue
+        if [ "$key" = "sid" ]; then
+            value="$(rt_observe_session "$value")"
+        else
+            value="$(rt_observe_clean "$value")"
+        fi
+        [ -n "$value" ] || continue
+        line="$line,\"$key\":\"$value\""
+    done
+    line="$line,\"v\":\"$(rt_observe_version)\"}"
+
+    printf '%s\n' "$line" >> "$dir/$day.jsonl" 2>/dev/null || return 0
+    return 0
+}

package/assets/hooks/postmortem-guard.sh

@@ -0,0 +1,92 @@
+#!/usr/bin/env bash
+# rt-hook: Stop
+# Гард происшествия: ход, в котором исполнитель признал промах, не заканчивается, пока записи о
+# происшествии нет. Stop.
+#
+# Зачем именно так. Происшествие — заход, в котором исполнитель сделал не то, а слой правил
+# этого не отбил, — исправляемого кода за собой не оставляет. Такой заход кончается извинением
+# в переписке: назавтра механизм промаха пересказывается уже приглаженно, остаются выводы, а из
+# выводов правило не выводится. Разбор случался только тогда, когда владелец требовал его вслух.
+#
+# Ловится признание образцами, а не пониманием смысла: оценку «это был промах» назначал бы тот,
+# кому она мешает, и порог плыл бы. Набор образцов виден, пополняется правкой и промахивается
+# заметно — заход, признавший промах словами вне набора, гард пропускает, и это сказано вслух в
+# договорённости, а не считается закрытым.
+#
+# Ловится на завершении хода, а не на отправке реплики: к моменту признания промах уже случился,
+# и ловить раньше нечего. Этим он отличается от гарда разговора, у которого есть свой инструмент
+# — вопрос владельцу.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ: при любой ошибке, отсутствии записи хода и повторном заходе ход
+# РАЗРЕШАЕТСЯ (exit 0). Сломанный гард не имеет права заклинить разговор.
+
+input="$(cat 2>/dev/null)"
+[ -z "$input" ] && exit 0
+
+command -v jq >/dev/null 2>&1 || exit 0
+
+# Повторный заход по тому же ходу не судится: гард сказал своё один раз и отпускает.
+active="$(printf '%s' "$input" | jq -r '.stop_hook_active // false' 2>/dev/null)"
+[ "$active" = "true" ] && exit 0
+
+transcript="$(printf '%s' "$input" | jq -r '.transcript_path // empty' 2>/dev/null)"
+[ -z "$transcript" ] && exit 0
+[ -f "$transcript" ] || exit 0
+
+root="${CLAUDE_PROJECT_DIR:-.}"
+
+# Каталог записей у дерева свой. Заданный пустым — отказ дерева от требования: дереву, которое
+# записей не ведёт, гард не навязывается.
+notes_dir="${RT_POSTMORTEMS_DIR-docs/postmortems}"
+[ -z "$notes_dir" ] && exit 0
+[ -d "$root/$notes_dir" ] || exit 0
+
+# Образцы признания промаха. Набор открыт и пополняется правкой: полнота его — открытый вопрос
+# договорённости, а не обещание.
+admitted_re='был неправ|был не прав|ошибс|моя ошибк|мой промах|промахнул|проглядел|не проверил|соврал|виноват|извин|прошу прощения|неверно утверждал|утверждение было ложн|принял на веру'
+
+# Ход — это всё, что записано после последнего настоящего ввода владельца. Ответ инструмента
+# приходит той же ролью, поэтому строки с `tool_result` вводом не считаются.
+#
+# Хвост в 400 строк: запись хода растёт всю сессию, а судится только последний ход.
+verdict="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r --arg re "$admitted_re" '
+    def is_input:
+        .type == "user"
+        and (((.message.content // []) | if type == "array"
+                then ([.[] | select(.type == "tool_result")] | length)
+                else 0 end) == 0);
+
+    (map(is_input) | rindex(true)) as $i
+    | (if $i == null then . else .[$i + 1:] end) as $turn
+    | [$turn[] | select(.type == "assistant") | (.message.content // [])[] | select(.type == "text") | .text] as $texts
+    | [$turn[] | select(.type == "assistant") | (.message.content // [])[] | select(.type == "tool_use")] as $uses
+    # Признак нечувствителен к регистру флагом, а не приведением: приведение знает только
+    # латиницу, и «Был неправ» с большой буквы проходило бы мимо набора образцов молча.
+    | (($texts | join("\n")) | test($re; "i")) as $admitted
+    | ($uses | map(
+          ((.name // "") | test("^(Write|Edit|MultiEdit)$"))
+          and ((.input.file_path // "") | test("postmortem"))
+      ) | any) as $wrote
+    | if $admitted and ($wrote | not) then "admit" else "pass" end
+' 2>/dev/null)"
+
+[ "$verdict" = "admit" ] || exit 0
+
+# Запись, сделанная за эту сессию, снимает требование и без правки в этом же ходе: разбор мог
+# лечь файлом ходом раньше — тем, в котором промах и признали.
+if [ -n "$(find "$root/$notes_dir" -name '*.md' -newermt '-1 day' 2>/dev/null | head -1)" ]; then
+    exit 0
+fi
+
+reason="BLOCKED by postmortem-guard: в ответе признан промах, а записи о происшествии в \`$notes_dir/\` за сегодня нет. Происшествие — заход, в котором исполнитель сделал не то, а слой правил этого не отбил, — записывается в тот же заход: назавтра механизм промаха пересказывается уже приглаженно, и правило из него не выводится.
+
+Запись называет: механизм промаха по шагам, что было доступно до него, чем ловилось и что из этого ушло в слой правил. Без последней строки это жалоба, а не разбор.
+
+    $notes_dir/<год>-<месяц>-<день>-<короткое имя>.md
+
+Гард судит один ход: следующий заход не отбивается."
+
+jq -n --arg r "$reason" '{decision:"block",reason:$r}' 2>/dev/null \
+    || printf '{"decision":"block","reason":"postmortem-guard: признан промах — запиши разбор происшествия."}\n'
+
+exit 0

package/assets/hooks/profile-check.sh

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+# Нехватка функции профиля, сказанная вслух. НЕ гард: объявления `rt-hook:` у него нет, к
+# событиям агента он не подключается. Его источают сами гарды — тем же приёмом, каким гейт
+# источает карту, а гарды — запись наблюдений.
+#
+# Зачем он есть. Девять хуков пакета зовут функции профиля дерева, и у пяти проверка стоит до
+# всякого поведения: нет функции — выход с нулём, не сделав ничего. Такой гард хуже
+# отсутствующего: он лежит в дереве, стоит в настройке, виден в списке хуков и читается как
+# работающий. Тишина при этом означает разом три разных вещи — «нечего проверять», «проверять
+# нечем» и «всё в порядке», — и отличить их нечем.
+#
+# ЧТО ГОВОРИТСЯ. Имя функции и файл, в котором её определяют. Один раз за сессию: на каждый
+# вызов та же строка повторялась бы десятки раз за заход и перестала бы читаться.
+#
+# ДЕЙСТВИЕ ВСЁ РАВНО ПРОПУСКАЕТСЯ. Хук сообщает о своей неполноте, а не судит правку: судить её
+# нечем, и отбивать работу из-за ненастроенного дерева он не вправе.
+
+# Куда кладётся отметка «об этом уже сказано». Каталог временных файлов, а не дерево: отметка
+# живёт один заход и в историю не едет.
+rt_needs_mark_dir() {
+    printf '%s' "${TMPDIR:-/tmp}"
+}
+
+# Есть ли функция профиля. Успех — есть, и хук работает дальше. Отказ — нет, и об этом сказано.
+#
+#   rt_needs rt_is_app_code task-flow-guard "$sid"
+#
+# Третий параметр — признак сессии, если хук его знает. Не знает — отметка кладётся на день:
+# без признака «один раз за сессию» превратилось бы в «один раз за всю жизнь машины».
+rt_needs() {
+    command -v "$1" >/dev/null 2>&1 && return 0
+
+    rt_needs_key="${3:-$(date +%Y%m%d 2>/dev/null || printf 'nosession')}"
+    rt_needs_mark="$(rt_needs_mark_dir)/rt-kit-needs-$1-$rt_needs_key"
+    if [ ! -f "$rt_needs_mark" ]; then
+        printf '%s: нет функции %s — её определяют в .claude/rt-kit/project.sh, а умолчание везёт пакет в .claude/rt-kit/defaults/project.sh\n' \
+            "${2:-хук}" "$1" >&2
+        printf 'проверка не работает, действие пропущено\n' >&2
+        : >"$rt_needs_mark" 2>/dev/null || true
+    fi
+
+    return 1
+}

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

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse Edit|Write|MultiEdit|mcp__webstorm__create_new_file
+# Требует: hooks/profile-check.sh
 # Гард якоря для спек. PreToolUse на правке разметки.
 #
 # Спеки адресуют элементы только через этот атрибут. Классы оформления меняются вместе с
@@ -56,10 +57,16 @@ for profile in "$rt_hooks_dir/../rt-kit/defaults/project.sh" "$rt_hooks_dir/../d
     [ -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; }
+
 # Разметка приложения живёт там же, где его код. Без этой положительной проверки гард
 # распространялся на любой файл разметки на диске — черновик вне дерева отклонялся требованием
 # проставить якоря.
-if command -v rt_is_app_code >/dev/null 2>&1; then
+if rt_needs rt_is_app_code qa-dataid-guard; then
     rt_is_app_code "$path" || exit 0
 fi
 
@@ -75,7 +82,7 @@ added="$(printf '%s' "$input" | jq -r '
 ' 2>/dev/null)"
 [ -z "$added" ] && exit 0
 
-decorative="$(command -v rt_qa_decorative >/dev/null 2>&1 && rt_qa_decorative 2>/dev/null)"
+decorative="$(rt_needs rt_qa_decorative qa-dataid-guard && rt_qa_decorative 2>/dev/null)"
 component_re="${RT_QA_COMPONENT_RE:--}"
 
 # Открывающие теги разбираются ЦЕЛИКОМ: тег занимает несколько строк, и якорь часто стоит не в

package/assets/hooks/reuse-first-guard.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse Edit|Write|MultiEdit|mcp__webstorm__create_new_file
+# Требует: hooks/profile-check.sh
 # Гард «ничего не пишется с нуля». PreToolUse на правке кода и разметки.
 #
 # Линтеры знают правила, но не знают ИНВЕНТАРЬ: линтер стилей поймает сырой цвет, линтер кода —
@@ -61,11 +62,17 @@ for profile in "$rt_hooks_dir/../rt-kit/defaults/project.sh" "$rt_hooks_dir/../d
     # shellcheck disable=SC1090
     [ -f "$profile" ] && . "$profile" 2>/dev/null
 done
-command -v rt_reinvented_in >/dev/null 2>&1 || exit 0
+
+# Слово о нехватке функции профиля: хук, вышедший молча, неотличим от работающего. Файл может
+# быть не разложен — тогда остаётся прежнее поведение, молчаливое.
+# 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; }
+rt_needs rt_reinvented_in reuse-first-guard || exit 0
 
 # Правила этого дерева действуют на код этого дерева: без положительной проверки гард требовал
 # бы собирать готовым и в черновике за пределами дерева.
-if command -v rt_is_app_code >/dev/null 2>&1; then
+if rt_needs rt_is_app_code reuse-first-guard; then
     rt_is_app_code "$path" || exit 0
 fi
 

package/assets/hooks/skill-gate.sh

@@ -38,6 +38,7 @@ command -v skill_for >/dev/null 2>&1 || exit 0
 
 req=""
 target=""
+kind=""
 case "$tool" in
     # Инструмент среды заводит файл теми же двумя данными, только называет их иначе — без этой
     # ветки файл заводился мимо гейта.
@@ -61,6 +62,12 @@ case "$tool" in
         # приходит в обычный сервис, а число-настройка в обычный класс.
         written="$(printf '%s' "$input" | jq -r '[.tool_input.content, .tool_input.text, .tool_input.new_string, (.tool_input.edits[]?.new_string)] | map(select(. != null)) | join("\n")' 2>/dev/null)"
         req="$(skill_for edit "$target" "$written" 2>/dev/null)"
+        # Род правки для наблюдения. Одно расширение, без пути и без имени файла: наблюдение
+        # уезжает наружу, и всё, кроме рода, там было бы адресом этого дерева.
+        case "${target##*/}" in
+            *.*) kind="${target##*.}" ;;
+            *) kind="none" ;;
+        esac
         ;;
     # Терминал среды исполняет ту же командную строку и кладёт её в то же поле: без этой ветки
     # коммит из него не требовал правила, тогда как тот же коммит из оболочки требовал.
@@ -77,9 +84,11 @@ case "$tool" in
             [ -n "$inner" ] && target="$inner"
         fi
         req="$(skill_for bash "$target" "" 2>/dev/null)"
+        kind="command"
         ;;
     mcp__claude-in-chrome__*)
         req="$(skill_for browser "$tool" "" 2>/dev/null)"
+        kind="browser"
         ;;
     *) exit 0 ;;
 esac
@@ -108,6 +117,12 @@ done
 [ -z "$want" ] && exit 0
 req="$want"
 
+# Отбитие — наблюдение: правило, которое приходится требовать чаще прочего, и род правки, на
+# котором это происходит, говорят о слое правил больше, чем список загруженного.
+# 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 gate-deny "res=$req" "kind=$kind" "sid=$sid"
+
 reason="Отбито гейтом правил: загрузи правило «${req}» инструментом Skill и повтори действие. Для этой области это происходит один раз за сессию."
 
 # Правило называет свой закон одним словом, а слоёв законов два: общий лежит в корне, закон

package/assets/hooks/skill-loaded.sh

@@ -18,4 +18,11 @@ dir="${TMPDIR:-/tmp}/claude-skill-gate"
 mkdir -p "$dir" 2>/dev/null || exit 0
 printf '%s\n' "$skill" >> "$dir/${sid}.loaded" 2>/dev/null
 
+# Та же загрузка вторым адресом — в наблюдения дерева. Запись выше живёт до сжатия контекста и
+# гибнет вместе с ним: она отвечает гейту на вопрос «загружено ли», и больше ни на что.
+rt_hooks_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# 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 skill-load "res=$skill" "sid=$sid"
+
 exit 0

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

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: SessionStart startup|resume|compact|clear
+# Требует: hooks/profile-check.sh
 # SessionStart: состояние незаконченной работы уезжает в контекст на каждом запуске сессии.
 #
 # Памятью это не держится по той же причине, что и словарь: замысел читают перед правкой
@@ -28,6 +29,12 @@ for profile in "$rt_hooks_dir/../rt-kit/defaults/project.sh" "$rt_hooks_dir/../d
     [ -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; }
+
 TASKS_DIR="${RT_TASKS_DIR:-docs/tasks}"
 [ -z "$TASKS_DIR" ] && exit 0
 
@@ -43,13 +50,20 @@ emit() {
 # Ветка под задачу без папки — работа идёт мимо. Сессию не рвём: SessionStart, отбивающий
 # запуск, оставляет владельца без агента вовсе, а правку кода поймает `task-flow-guard`.
 if [ ! -d "$DIR" ]; then
-    if command -v rt_task_branch_ok >/dev/null 2>&1 && rt_task_branch_ok "$branch"; then
+    if rt_needs rt_task_branch_ok task-context-load && rt_task_branch_ok "$branch"; then
         {
             printf 'РАБОТА БЕЗ ПАПКИ ЗАДАЧИ.\n\n'
             printf 'Ветка `%s` названа задачей, а `%s/` нет: ход работы записывать некуда,\n' "$branch" "$DIR"
             printf 'и следующий заход начнёт с расспросов владельца.\n\n'
             printf 'Собрать с образца:\n\n    cp -r %s/_template %s\n\n' "$TASKS_DIR" "$DIR"
-            printf 'Правку кода приложения до этого отбивает гард. Правило — скил `task-flow`.\n'
+            # О соседнем ресурсе — условно и по имени: пакет не знает, разложен ли он здесь,
+            # а сказанное безусловно приходит в контекст каждой сессии и врёт про дерево тем
+            # увереннее, что печатает это сам инструмент.
+            if [ -f "$rt_hooks_dir/task-flow-guard.sh" ]; then
+                printf 'Правку кода приложения до этого отбивает гард `task-flow-guard`. Правило — скил `task-flow`.\n'
+            else
+                printf 'Правило — скил `task-flow`. Гарда `task-flow-guard` в дереве нет: правку кода до этого не отбивает ничто.\n'
+            fi
         } | emit
     fi
     exit 0

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

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse Edit|Write|MultiEdit
+# Требует: hooks/profile-check.sh
 # PreToolUse guard for Edit|Write|MultiEdit: код не пишется раньше замысла.
 #
 # Работа идёт много заходов, и между ними исполнитель не помнит ничего. Замысел, лежащий на
@@ -45,11 +46,17 @@ for profile in "$rt_hooks_dir/../rt-kit/defaults/project.sh" "$rt_hooks_dir/../d
     [ -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; }
+
 # Признак «правка меняет поведение» — путь, а не оценка на глаз: оценку назначает тот, кому
 # она мешает, и порог плывёт. Где живёт код приложения, знает профиль: правила, тексты, обвязка
 # и зависимости под требование не попадают — иначе разбор задачи нельзя было бы вести до
 # заведения ветки.
-command -v rt_is_app_code >/dev/null 2>&1 || exit 0
+rt_needs rt_is_app_code task-flow-guard || exit 0
 rt_is_app_code "$path" || exit 0
 
 # Каталог папок задач: у дерева он свой, но имя обычно общее.
@@ -70,7 +77,7 @@ git rev-parse --is-inside-work-tree >/dev/null 2>&1 || exit 0
 branch="$(git branch --show-current 2>/dev/null)"
 [ -z "$branch" ] && exit 0   # detached HEAD — не про наш случай
 
-if command -v rt_task_branch_ok >/dev/null 2>&1 && ! rt_task_branch_ok "$branch"; then
+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
 

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

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PostToolUse .*
+# Требует: hooks/profile-check.sh
 # rt-hook: PreToolUse .*
 # Заполнение окна: заход доводится до логической точки заранее, а не обрывается на середине.
 #
@@ -34,6 +35,12 @@ for profile in "$rt_hooks_dir/../rt-kit/defaults/project.sh" "$rt_hooks_dir/../d
     [ -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; }
+
 window="${RT_WINDOW_TOKENS:-}"
 case "$window" in
     '' | *[!0-9]*) exit 0 ;;
@@ -126,7 +133,7 @@ case "$tool" in
     Bash | mcp__webstorm__execute_terminal_command)
         # Поставка и сверки: коммит, пуш, отчёт, колонка задачи, состояние дерева. Список
         # дописывается профилем дерева — клиент хостинга и имена команд у каждого свои.
-        if command -v rt_handoff_allowed_cmd >/dev/null 2>&1 && rt_handoff_allowed_cmd "$cmd"; then
+        if rt_needs rt_handoff_allowed_cmd window-fill-guard && rt_handoff_allowed_cmd "$cmd"; then
             allowed=1
         fi
         ;;

package/assets/laws/project-documentation.md

@@ -47,3 +47,8 @@
   видит, проверки текстов на них не смотрят, и отказ выглядит сделанным ровно до того, как
   читатель наткнётся на снятое слово в заголовке. Читатель при этом заключает, что от слова
   не отказывались вовсе.
+- **Текст, который переносится в чужое дерево, не описывает состояние этого дерева как факт.**
+  О соседней части он говорит условно и называет её по имени: что в дереве стоит, а чего нет,
+  знает само дерево, а не текст, приехавший в него. Утверждение, сказанное безусловно, врёт тем
+  увереннее, что печатает его сам инструмент, — и поправить его дерево не может, если правки на
+  месте у такого текста не предусмотрено.

package/assets/laws/verifiability.md

@@ -47,3 +47,12 @@
   выключают в настройке инструмента, а не обходят в каждом месте.** Обход приходится повторять
   столько раз, сколько таких мест, и ни в одном из них не написано, зачем он: со стороны это
   выглядит ошибкой автора, а не решением.
+- **Польза правила подтверждается наблюдением за тем, как им пользуются, а не мнением о нём.**
+  Правило, которого не открыли ни разу, и правило, на котором держится половина работы, в тексте
+  выглядят одинаково — и правится первым обычно то, о чём вспомнили, а не то, что мешает.
+  Наблюдение ведётся там же, где идёт работа, и переживает отдельный заход: запись, которая
+  умирает вместе с сессией, отвечает только на вопрос «что было минуту назад».
+- **Наблюдение за работой не выносит наружу ничего, кроме того, что общее у всех.** Имя правила,
+  род события и версия одинаковы везде, где стоит слой правил; путь, домен и имя дерева
+  принадлежат одному дереву и в чужом месте не значат ничего, кроме утечки. Держится это
+  проверкой на выносящей стороне, а не памятью того, кто пишет.

package/assets/laws/work-conduct.md

@@ -13,8 +13,24 @@
 - **Пробел закрывается вопросом владельцу, а не догадкой.** Догадка неотличима от знания:
   она попадает в работу молча и обнаруживается только при приёмке, когда переделывать дороже
   всего.
+- **Вопрос, у которого есть очевидный ответ, работу не останавливает.** Исполнитель называет
+  допущение, идёт дальше и записывает его туда же, где идёт работа. Останавливает только тот
+  пробел, при котором любая догадка делает работу опасной или бесполезной. Вопрос, заданный
+  вместо работы, выглядит добросовестно, а стоит владельцу захода.
+- **Остановка называется первой строкой.** Сообщение, которым исполнитель останавливается,
+  начинается с того, чего он ждёт и что будет, если ответа не будет. Замеры, находки и разбор
+  к этому моменту уже записаны в ход работы — в сообщении владельцу они лишние. Чем подробнее
+  отчёт, тем надёжнее вопрос в нём тонет, и владелец переспрашивает, почему работа стоит.
 - **Владельцу не задаётся вопрос, ответ на который уже записан.** Записанное читают до
   разговора, а не вместо ответа: вопрос о том, что уже решено, обесценивает и остальные.
+- **Вопрос владельцу задаётся после того, как ответ искали в дереве.** Что лежит в дереве,
+  исполнитель узнаёт сам: имя, путь, наличие файла и устройство репозитория он берёт командой,
+  а не у владельца. Вопрос, ответ на который дала бы одна команда, стоит владельцу захода и
+  обесценивает заданные рядом.
+- **Утверждение о дереве стоит ровно столько, сколько команда, его показавшая.** Отрицание —
+  «здесь нет», «этого не заводили», «такого файла не бывает» — произносится только как вывод
+  команды. Не проверенное отрицание опаснее вопроса: вопрос владелец поправит, а факт от
+  исполнителя примет на веру, потому что тот в дерево смотрит.
 - **Решение, однажды записанное, действует, пока его не отменили, и читается до того, как
   принимается заново.** Отменённое решение следа в работе не оставляет — по результату не
   видно ни того, что его принимали, ни того, что от него отказались. Принятое заново оно
@@ -49,6 +65,11 @@
   читается как случайное и отменяется следующим заходом, а отменённое возвращается третьим.
 - **Граница работы названа до её начала.** Не названная вслух граница не существует: правка
   расползается на соседнее, и снимать её приходится вручную.
+- **Действия, которые исполнитель не делает сам, названы списком.** Всё, что уходит за
+  пределы рабочего дерева или не откатывается — запись в общий репозиторий, публикация, отчёт,
+  правка общего документа, — делается по слову владельца, и слово это даётся на действие, а не
+  на работу целиком. Не названная списком граница выводится из общих слов: «делай, что нужно
+  по плану» прочитывается как разрешение на всё, что в плане подразумевалось.
 - **Признак закрытия работы назван до её начала и проверяем.** «Работает» признаком не
   является: под ним каждый заход понимает своё, и работа закрывается тогда, когда надоела.
 - **Начатая и брошенная работа видна.** Брошенное на середине выглядит так же, как
@@ -65,3 +86,21 @@
 - **Незаданный вопрос замечает только тот, кто знает, чего хотел.** Вопрос, которого не
   задали, следа не оставляет: работа выглядит понятой ровно до приёмки, и вывести отсутствие
   вопроса не из чего.
+- **Происшествие названо признаком, а не оценкой заднего числа.** Происшествие — заход, в
+  котором исполнитель сделал не то, а слой правил этого не отбил. Дефект в коде происшествием
+  не является: его объясняет договорённость о продукте. Признак записан один раз, а не
+  выводится каждым заходом заново — иначе его назначает тот, кому он мешает.
+- **Происшествие кончается записью, и запись делается в тот же заход.** Через день механизм
+  промаха пересказывается уже приглаженно: остаются выводы, а из выводов правило не выводится.
+  Запись называет механизм промаха по шагам, что было доступно до него, чем ловилось и что из
+  этого ушло в слой правил.
+- **Запись без правки слоя правил закрытой не считается.** Разбор, из которого не вышло ни
+  предложения, ни правки закона, правила или паттерна, — жалоба: он объясняет случившееся и
+  ничего не меняет, а значит повторится.
+- **Закрытая работа оставляет то, что узнала о правилах, там, откуда это возьмёт машина.**
+  Понимание, добытое одной работой, всего дороже соседней — и живёт оно ровно до конца захода,
+  если осталось в разговоре. Записанное свободным пересказом лежит не хуже, но переносить его
+  приходится руками, и переносится оно ровно до первой занятой недели.
+- **У предложенной правки правил назван адрес: сам слой правил, имена этого дерева или его
+  надстройка.** Без адреса правку кладут туда, где она видна автору, — то есть в своё дерево, —
+  и общее оседает в одном месте, оставаясь неизвестным всем остальным.

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

@@ -212,26 +212,30 @@ npm run task:move -- 86 in-review
 Конвейер видит только отправленное, а отправляется оно пушем. Линтеры, юниты и сценарии хуков
 снимает гейт пуша — ниже то, чего он не знает.
 
-1. **В ветке только та правка, за которой её заводили** — `git diff main...HEAD --stat`. Чужой
+1. **Главная ветка влита в эту ветку** — `git fetch origin && git merge origin/main`.
+   Всё, что проверяется ниже, проверяется от этого основания: PR с разошедшейся ветки
+   показывает ревьюверу правку вперемешку с чужой. Порядок и разбор конфликта — паттерн
+   `git-workflow-merge`.
+2. **В ветке только та правка, за которой её заводили** — `git diff main...HEAD --stat`. Чужой
    домен в списке файлов означает, что правка расползлась, и её надо вернуть в свои границы.
-2. **Ни мока, ни подменённого ответа, ни отладочной строки** — `git diff main...HEAD` читается
+3. **Ни мока, ни подменённого ответа, ни отладочной строки** — `git diff main...HEAD` читается
    целиком, а не по именам файлов. На прод они уезжают молча и портят настоящие данные.
-3. **Документ едет тем же коммитом.** Пару называет `docs-guard`, но спек домена и правку его
+4. **Документ едет тем же коммитом.** Пару называет `docs-guard`, но спек домена и правку его
    поведения он не знает — это остаётся за автором.
-4. **Проверки текстов и раскладки зелёные** — те, что дерево завело в `tools/`. Какие именно
+5. **Проверки текстов и раскладки зелёные** — те, что дерево завело в `tools/`. Какие именно
    есть здесь — `implementation.md` правила.
-5. **Все приложения дерева собираются** — `nx build` по каждому. Гейт пуша сборку не гоняет.
-6. **Видимый текст заведён во всех локалях перевода** — тестом полноты словарей, если дерево
+6. **Все приложения дерева собираются** — `nx build` по каждому. Гейт пуша сборку не гоняет.
+7. **Видимый текст заведён во всех локалях перевода** — тестом полноты словарей, если дерево
    переводится.
-7. **Правка вёрстки подтверждена замером**, а не взглядом, и снята при узком экране — паттерн
+8. **Правка вёрстки подтверждена замером**, а не взглядом, и снята при узком экране — паттерн
    `browser-verification-measure`.
-8. **Правка разметки публичного сайта проверена на прод-сборке по всем локалям перевода** —
+9. **Правка разметки публичного сайта проверена на прод-сборке по всем локалям перевода** —
    паттерн `seo-verify`.
-9. **PR привязан к рабочему элементу**, ревьювер и исполнитель стоят.
-10. **Заголовок PR несёт номер элемента и называет работу сделанной:** `[<номер>] <Что
+10. **PR привязан к рабочему элементу**, ревьювер и исполнитель стоят.
+11. **Заголовок PR несёт номер элемента и называет работу сделанной:** `[<номер>] <Что
 сделано>`, тем же номером, что стоит у элемента и в имени ветки.
-11. **Очередь работ сходится** — `npm run check:board`.
-12. **Состояние PR прочитано, а не выведено из кодов возврата.**
+12. **Очередь работ сходится** — `npm run check:board`.
+13. **Состояние PR прочитано, а не выведено из кодов возврата.**
 
 Сразу после публикации элемент переводится в разбор, и сверка очереди прогоняется ещё раз: до
 открытия PR состояние она не судит, а после открытия расхождение видит.