@rt-tools/agent-kit 0.5.1 → 0.5.2

package/README.md

@@ -26,6 +26,7 @@ npx agent-kit init      # спросить законы галочками и з
 npx agent-kit sync      # разложить выбранное в docs/constitution/
 npx agent-kit doctor    # что разложено, что отстало, чего не хватает
 npx agent-kit adopt     # отдать пакету файлы, лежащие на его путях не от него
+npx agent-kit stats     # чем пользовались, чем ни разу, обо что спотыкались
 ```
 
 `init` называет и то, чего пакет ждёт от дерева: значения дырок, которые придётся вписать в
@@ -238,6 +239,73 @@ npx agent-kit init --laws access,delivery,verifiability
 
 Отказ хотя бы по одному файлу не пишет ничего: половина разложенного хуже целого.
 
+## Наблюдения и сводка
+
+Правило, которого никто не открывает, не действует, — и узнать об этом было нечем. Гарды пишут
+наблюдения: правило загружено, гейт отбил правку, гард отказал. Строка несёт имя ресурса пакета,
+род события, род правки, версию и признак сессии; путей дерева, имён его доменов и имени его
+самого в ней нет — значение со слэшем не пишется вовсе.
+
+```bash
+npx agent-kit stats --days 3     # за отрезок; без довода — за три дня
+npx agent-kit stats --json       # то же машиночитаемо
+```
+
+Самая ценная строка сводки — не «чем пользовались», а **что разложено и не загружено ни разу**:
+чем пользуются, видно и по работе, а мёртвый ресурс ничем себя не выдаёт.
+
+Наблюдения лежат в `.claude/rt-kit/observations/` файлом на день и снимаются через тридцать
+дней. Запись выключается ключом `"observe": false` в конфиге — целиком, а не частями. Каталог
+просится в список игнорируемого; вписывает его проект — в чужие файлы дерева пакет не пишет.
+
+## Предложения обратно в пакет
+
+Разбор закрытой задачи и раньше ставил каждому предложению адрес — «пакет», «компаньон» или
+«дерево», — но результат оставался в переписке, и правки переносили руками. Теперь предложения
+ложатся файлом в `.claude/rt-kit/proposals/`, блоком на предложение:
+
+```markdown
+## пакет · rules/styling-bem.md
+
+- **место:** раздел «Ловушки», в конец
+- **повод:** что в этой задаче пошло не так без этого правила
+
+> Готовый текст правки.
+```
+
+```bash
+npx agent-kit propose --dry-run   # что уехало бы
+npx agent-kit propose             # завести записи в очереди работ пакета
+```
+
+Наружу уезжает **только адрес «пакет»** и вместе с ним — сводка наблюдений: без цифр
+предложение читается как мнение. Отправленное помечается ссылкой в том же файле и второй раз не
+уезжает. Куда отправлять, пакет берёт из своего манифеста, а не из зашитого в код адреса.
+
+Перед отправкой текст сверяется на адрес дерева — абсолютный путь, имя корня, адрес удалённого
+репозитория. Нашлось — отказ с номером строки, и отбивается вся отправка целиком: «уехало два из
+трёх» читается как «всё в порядке». Файл уезжает в чужой репозиторий, и запрет называть чужое
+дерево держится проверкой, а не памятью того, кто пишет.
+
+### Что для этого нужно
+
+Своего сервера у механизма нет, ключей и учётных записей он не заводит. Наблюдения и сводка
+живут целиком на машине; в сеть ходит только отправка, и только по команде человека.
+
+| Где | Что нужно |
+| --- | --- |
+| у потребителя | `jq` — его требуют и сами гарды |
+| у потребителя | помощник хостинга, вошедший в любую учётную запись: запись заводится от её имени |
+| в репозитории пакета | метка, по которой сведение находит предложения, — заводится один раз |
+
+```bash
+gh label create agent-kit-feedback --description 'Предложение по слою правил, пришедшее из дерева'
+```
+
+Метки нет — отправка отказывает, и понять причину по сообщению помощника нельзя: про метку,
+доступ и собственное отсутствие он говорит одинаково глухо. Поэтому отказ команды называет все
+три сам.
+
 ## Роли и конвейеры
 
 Пакет везёт шесть ролей субагентов и два конвейера из них.

package/assets/commands/agent-kit-digest.md

@@ -0,0 +1,83 @@
+---
+description: Свести накопленные предложения и наблюдения в правки ресурсов пакета правил
+argument-hint: '[пусто | --days N]'
+---
+
+Собери предложения, пришедшие из деревьев, и скажи, что из них становится правкой пакета.
+Отрезок от пользователя: `$ARGUMENTS` (без довода — три дня).
+
+Зовётся **в репозитории самого пакета**, а не в дереве, где он стоит: здесь лежат ресурсы,
+которые предстоит править, и видно всех потребителей сразу. В чужом дереве команда бессмысленна
+— там есть только своя половина картины.
+
+## 1. Собери, что пришло
+
+```bash
+gh issue list --label agent-kit-feedback --state open --limit 100 \
+    --json number,title,body,createdAt
+```
+
+Помощник хостинга и учётная запись машинной работы у каждого дерева свои — как их звать здесь,
+сказано в компаньоне правила `git-workflow`.
+
+Каждая запись заведена командой `agent-kit propose` из дерева, где пакет стоит. В теле — ресурс,
+место, повод, готовый текст и сводка наблюдений того дерева. Имени дерева там нет намеренно:
+различать их можно только по сводке и по времени.
+
+Своё дерево тоже потребитель — его наблюдения читаются прямо:
+
+```bash
+npx agent-kit stats --days <отрезок> --json
+```
+
+## 2. Раздели повторившееся и разовое
+
+Это и есть работа сведения; всё остальное — оформление.
+
+- **Пришло об одном ресурсе из двух и более записей** — правка пакета. Разные деревья
+  споткнулись об одно и то же место, и чинить его надо там, откуда оно к ним приехало.
+- **Пришло однажды и называет то, чего у других нет** — надстройка того дерева, а не пакет.
+  Скажи это прямо и назови, куда именно: `overrides/<ресурс>` для текстов, карта гейта и
+  профиль — для родов файлов и команд.
+- **Пришло однажды, но верно любому дереву** — правка пакета. Числа записей мало: правило,
+  которое молчит о важном, молчит у всех, а споткнулся о него пока один.
+
+Ресурс, о котором пришли **противоречащие** предложения, в правку не идёт вовсе: неси оба
+владельцу. Слой правил, который говорит два разных, хуже слоя, который молчит.
+
+## 3. Посмотри, что говорят наблюдения
+
+Сводка отвечает на то, чего в предложениях нет:
+
+- **правило, разложенное и не загруженное ни разу** — кандидат на сокращение или на запись в
+  карте гейта: правило, которого гейт не требует, никто и не откроет;
+- **правило, которое гейт отбивает чаще прочих** — его либо забывают, либо оно требуется не
+  там; посмотри род правки в той же сводке;
+- **гард, отказывающий чаще прочих** — либо место поставки раз за разом делают не так, либо
+  отказ не называет, чем он снимается.
+
+## 4. Принеси правки
+
+По каждой — ресурс, место, готовый текст и число записей, из которых она вышла. Не правь ничего
+сам: решение принимает владелец, а работа идёт обычным ходом — задача, ветка, папка задачи.
+
+Заведи задачу на то, что владелец принял:
+
+```bash
+npm run task:new -- --title '<что не так>' --slug <короткое-имя> --label enhancement < тело.md
+```
+
+Записи, вошедшие в задачу, закрой ссылкой на неё:
+
+```bash
+gh issue close <номер> --comment 'Вошло в #<номер задачи>.'
+```
+
+## 5. Черновик записи в журнал изменений
+
+Собери его сразу, пока видно, из чего правка выросла: заголовок коммита по формату дерева и
+одна фраза о том, что менялось и почему. Журнал изменений при выпуске собирается из заголовков,
+и переписывать их задним числом — работа заново.
+
+**Выпуск отсюда не запускается.** Это отдельное решение владельца: слияние отчёта пакета не
+публикует. Скажи, что накопилось на выпуск, и остановись.

package/assets/commands/skill-curator.md

@@ -47,7 +47,39 @@ ls -t "${TMPDIR}claude-skill-gate/"*.loaded | head -5
 Инструментом `Agent`, `subagent_type: 'skill-curator'`. В промпт — путь к `.loaded` и сводку
 целиком.
 
-## 4. Отдай результат
+## 4. Выгрузи предложения файлом
+
+Ответ роли живёт в переписке и умирает вместе с ней, а правки в пакет идут из другого дерева и
+в другой день. Поэтому предложения ложатся на диск — их пишешь ты, не роль: файлов она не
+пишет вовсе.
+
+```bash
+mkdir -p .claude/rt-kit/proposals
+cp .claude/rt-kit/templates/proposal.md .claude/rt-kit/proposals/$(date +%F)-<ветка>.md
+```
+
+Дальше — по блоку на предложение, заголовком `## <адрес> · <ресурс>`. Адрес роль уже поставила,
+твоё дело — не потерять его и не переписать текст своими словами.
+
+Файл читает `agent-kit propose`: по заголовку он отбирает то, что уезжает в репозиторий пакета.
+Блок без адреса в заголовке не уедет никуда и останется лежать молча.
+
+## 5. Отправь то, что адресовано пакету
+
+```bash
+npx agent-kit propose --dry-run     # что уехало бы
+npx agent-kit propose               # завести запись в очереди работ пакета
+```
+
+Уезжают только блоки с адресом «пакет», и вместе с ними — сводка наблюдений: без цифр
+предложение читается как мнение. Отправленное помечается ссылкой в том же файле и второй раз
+не уезжает.
+
+Отправка отказывает, если в тексте предложения нашёлся адрес этого дерева — путь, имя корня,
+чужой репозиторий. Это не придирка: файл уезжает в чужой репозиторий целиком. Правь текст, а не
+обходи проверку.
+
+## 6. Отдай результат владельцу
 
 Покажи предложения агента **как есть**: он пишет готовый текст для вставки, и пересказ его
 портит. По каждому скажи своё — согласен или нет и почему; правило, с которым ты не согласен,

package/assets/defaults/gate-map.sh

@@ -111,6 +111,8 @@ skill_for_default() {
             case "$target" in
                 *git\ commit* | *git\ push* | *git\ merge* | *git\ rebase* | *git\ cherry-pick* | *gh\ pr\ * | *glab\ mr\ * | *az\ repos\ *)
                     printf '%s\n' 'git-workflow' ;;
+                *git\ worktree\ add* | *git\ worktree\ remove*)
+                    printf '%s\n' 'git-workflow' ;;
                 *prisma\ migrate* | *prisma\ db\ *) printf '%s\n' 'git-workflow' ;;
                 *curl\ *localhost* | *wget\ *localhost*) printf '%s\n' 'browser-verification' ;;
             esac

package/assets/defaults/project.sh

@@ -125,9 +125,20 @@ rt_report_body_default() {
 # Признак — путь, а не оценка на глаз: оценку назначает тот, кому она мешает, и порог плывёт.
 # Правила, тексты, обвязка и зависимости под требование не попадают — иначе разбор задачи
 # нельзя было бы вести до заведения ветки.
+#
+# Судится путь относительно корня дерева: каталог со словом `projects` в имени встречается и
+# вне репозитория, а правка файла вне корня замыслом этой ветки не распоряжается вовсе. Гарды
+# отдают сюда абсолютный путь целиком, и образец по подстроке совпадал бы с домашним каталогом
+# агента ровно так же, как с кодом дерева.
 rt_is_app_code_default() {
+    root="${CLAUDE_PROJECT_DIR:-$PWD}"
     case "$1" in
-        */apps/* | */libs/* | */projects/*) return 0 ;;
+        "$root"/*) rel="${1#"$root"/}" ;;
+        /*) return 1 ;;
+        *) rel="$1" ;;
+    esac
+    case "$rel" in
+        apps/* | libs/* | projects/*) return 0 ;;
         *) return 1 ;;
     esac
 }

package/assets/docs/GLOSSARY.md

@@ -30,6 +30,9 @@
 | Раскладка                 | Перенос ресурса из пакета в дерево по его роду и настройке слоя                                                                                             |
 | Разложенный файл          | Файл в дереве с шапкой пакета. Правится не на месте, а надстройкой: правка на месте теряется на следующей раскладке                                         |
 | Надстройка                | Файл дерева, который сливается с разложенным по заголовкам разделов                                                                                         |
+| Наблюдение                | Строка о событии слоя правил: правило загружено, гейт отбил, гард отказал. Пишет гард, живёт в дереве, наружу уезжает счётчиками. Журналом не называется    |
+| Сводка                    | Что наблюдения говорят за отрезок дней: чем пользовались, чем ни разу, обо что спотыкались                                                                  |
+| Предложение               | Готовая формулировка правки правил с адресом: пакет, компаньон или дерево. Приносит разбор закрытой задачи, отправляет человек командой                     |
 
 ## Работа
 

package/assets/hooks/docs-guard.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
+# Требует: hooks/profile-check.sh
 # Гард пары «правка и её документ». PreToolUse.
 #
 # Расхождение кода с текстом беззвучно. Ни линтер, ни сборка, ни тесты не читают правила,
@@ -32,6 +33,16 @@ command -v jq >/dev/null 2>&1 || exit 0
 tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
 
 decide() {
+    # Наблюдение пишется только на отказе: подсказку гард раздаёт и там, где всё в порядке, и
+    # счёт, в котором они смешаны, не значит ничего.
+    if [ "$1" = "deny" ]; then
+        # shellcheck disable=SC1090
+        [ -f "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/observe.sh" ] \
+            && . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/observe.sh" 2>/dev/null
+        command -v rt_note >/dev/null 2>&1 \
+            && rt_note guard-deny res=docs-guard "sid=$(printf '%s' "$input" | jq -r '.session_id // "nosession"' 2>/dev/null)"
+    fi
+
     jq -n --arg d "$1" --arg r "$2" \
         '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:$d,permissionDecisionReason:$r}}' 2>/dev/null \
         || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Документ едет тем же коммитом."}}\n'
@@ -47,6 +58,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; }
+
 laws_dir="${RT_LAWS_DIR:-docs/constitution}"
 lib_marker="${RT_LIB_MARKER:-project.json}"
 
@@ -170,7 +187,7 @@ done
 #
 # Контракт и спек домена, гард и его сценарии — что именно, знает профиль: связь у каждого
 # дерева своя, а механика одна.
-if command -v rt_docs_pair_for >/dev/null 2>&1; then
+if rt_needs rt_docs_pair_for docs-guard; then
     while IFS= read -r file; do
         [ -z "$file" ] && continue
         want="$(rt_docs_pair_for "$file" 2>/dev/null)"

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

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse Bash|mcp__webstorm__execute_terminal_command|mcp__webstorm__execute_tool
+# Требует: hooks/profile-check.sh
 # Гард поставки. PreToolUse на заведении ветки и открытии заявки на слияние.
 #
 # Закон о поставке требует трёх вещей, которых обычно не проверяет ничто: правка начинается с
@@ -37,6 +38,7 @@ input="$(cat 2>/dev/null)"
 command -v jq >/dev/null 2>&1 || exit 0
 
 tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
+sid="$(printf '%s' "$input" | jq -r '.session_id // "nosession"' 2>/dev/null)"
 case "$tool" in
     # Терминал среды и универсальный исполнитель кладут команду в то же поле.
     Bash | mcp__webstorm__execute_terminal_command | mcp__webstorm__execute_tool) ;;
@@ -73,7 +75,13 @@ 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_task_branch_ok >/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_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}"
@@ -89,6 +97,13 @@ main_branch="${RT_MAIN_BRANCH:-main}"
 folder_skip_re='Task-folder-skip:[[:space:]]*[^[:space:]"'"'"']{3,}'
 
 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 \
         || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Гард поставки."}}\n'
     exit 0
@@ -112,7 +127,7 @@ folder_in_branch() {
 check_task() {
     number="$1"
     where="$2"
-    command -v rt_task_state >/dev/null 2>&1 || return 0
+    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
 
@@ -173,7 +188,7 @@ if printf '%s' "$cmd" | grep -qE '(^|[;&|(]|&&|\|\|)[[:space:]]*(gh[[:space:]]+p
     printf '%s' "$cmd" | grep -qiE "$folder_skip_re" && exit 0
 
     merge_number="$(printf '%s' "$cmd" | sed -nE 's/.*(pr|mr)[[:space:]]+(merge|update)[[:space:]]+([0-9]+).*/\3/p' | head -1)"
-    if [ -n "$merge_number" ] && command -v rt_report_body >/dev/null 2>&1; then
+    if [ -n "$merge_number" ] && rt_needs rt_report_body git-guard-delivery; then
         body="$(cd "$root" && rt_report_body "$merge_number" 2>/dev/null)"
         [ -n "$body" ] && printf '%s' "$body" | grep -qiE "$folder_skip_re" && exit 0
     fi
@@ -236,6 +251,18 @@ if [ -n "$title" ]; then
     fi
 fi
 
+# Главная ветка влита до открытия отчёта. Отчёт от разошедшейся ветки показывает ревьюверу свою
+# правку вперемешку с чужой, а проверки на нём гоняются от устаревшего основания.
+#
+# Судится локальная вершина главной ветки, без сети: сетевой вызов в разборе команды падал бы
+# вместе со связью и отбивал бы работу вместо промаха. Отсюда и граница — гард ловит ветку,
+# отставшую заведомо; свежесть самой вершины держит `git fetch`, и требует его чеклист.
+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:-несколько} коммитов, а в ветку не влита. Отчёт от разошедшейся ветки показывает ревьюверу правку вперемешку с чужой, а проверки на нём идут от устаревшего основания. Влей и повтори: git fetch origin && git merge origin/${main_branch} — порядок и разбор конфликта в паттерне git-workflow-merge."
+fi
+
 check_task "$number" "заявка с ветки «${branch}»"
 
 # Сейчас папка ещё нужна: правки по замечаниям ревью идут в эту же ветку, а без plan.md их не

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

@@ -67,6 +67,14 @@ fi
 
 reason="Отбито: коммит прямо в «${default}». Работа едет через ветку и PR — правило git-workflow. Заведи ветку отдельным вызовом и коммить в неё: подготовленные изменения при этом сохранятся. Если коммит в ${default} действительно нужен — спроси владельца, сам не обходи."
 
+# Отказ — наблюдение. Имя главной ветки в него не идёт: у деревьев оно своё, а счёт отказов
+# одинаков везде.
+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 guard-deny res=git-guard-main "sid=$(printf '%s' "$input" | jq -r '.session_id // "nosession"' 2>/dev/null)"
+
 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,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse Bash|mcp__webstorm__execute_terminal_command|mcp__webstorm__execute_tool
+# Требует: hooks/profile-check.sh
 # Гард проверок перед пушем. PreToolUse на вызове пуша.
 #
 # Пуш — это вход в конвейер: слияние в главную ветку запускает выкатку, и всё, что не
@@ -60,7 +61,13 @@ 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_push_checks >/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_push_checks git-guard-push-tests || exit 0
 
 main_branch="${RT_MAIN_BRANCH:-main}"
 base=''

package/assets/hooks/grill-gate.sh

@@ -1,15 +1,18 @@
 #!/usr/bin/env bash
+# rt-hook: PreToolUse AskUserQuestion
 # rt-hook: Stop
-# Гард разговора: ход, в котором владельцу задан вопрос, не заканчивается, пока за этот же ход
-# не читались законы и правила. Stop.
+# Гард разговора: вопрос владельцу не задаётся, пока за этот же ход не читались законы и
+# правила. Стоит на двух событиях, и это не дублирование.
 #
-# Зачем именно так. Требование «правила читаются до разговора» записано в правиле ведения
-# работы, а исполнения у него не было: все прочие гарды судят правку файла или команду, а
-# вопрос в чат ни тем, ни другим не является. Поймать его можно только на завершении хода —
-# событие получает путь к записи хода и видит его целиком.
+# Зачем именно так. Требование «правила читаются до разговора» исполнимо ровно до отправки
+# вопроса. Проверка на завершении хода отбивает задним числом: к моменту отказа вопрос уже у
+# владельца, и владелец видит его вместе с отбитым ходом — требование срабатывает, но работу не
+# спасает. Поэтому ход с вопросом судится на инструменте вопроса, до отправки.
 #
-# Перехват инструмента меню вариантов эту дыру не закрывает: вопрос чаще задаётся прозой, и
-# ровно так был задан тот, из-за которого гард заведён.
+# Одним этим перехватом дыра не закрывается: вопрос чаще задаётся прозой, и ровно так был задан
+# тот, из-за которого гард заведён. Прозаический вопрос инструментом не является, и поймать его
+# можно только на завершении хода — событие получает путь к записи хода и видит его целиком.
+# Отсюда два события: меню ловится до отправки, проза — после.
 #
 # Чтением правил считается любой из трёх путей: загрузка правила, чтение файла законов или
 # правил, поиск по ним. Требовать именно загрузку значило бы гнать на неё там, где хватило
@@ -23,10 +26,13 @@ input="$(cat 2>/dev/null)"
 
 command -v jq >/dev/null 2>&1 || exit 0
 
+# Какое событие пришло. У вызова инструмента есть его имя, у завершения хода — нет.
+tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
+
 # Повторный заход по тому же ходу не судится: иначе ход не кончится никогда — гард сказал своё
-# один раз и отпускает.
+# один раз и отпускает. К вызову инструмента это не относится: там судится сам вызов.
 active="$(printf '%s' "$input" | jq -r '.stop_hook_active // false' 2>/dev/null)"
-[ "$active" = "true" ] && exit 0
+[ -z "$tool" ] && [ "$active" = "true" ] && exit 0
 
 transcript="$(printf '%s' "$input" | jq -r '.transcript_path // empty' 2>/dev/null)"
 [ -z "$transcript" ] && exit 0
@@ -61,7 +67,10 @@ read_re="$(printf '%s' "$laws_dir|$rules_dir|$specs_dir" | sed 's/^|*//; s/|*$//
 # бы.
 #
 # Хвост в 400 строк: запись хода растёт всю сессию, а судится только последний ход.
-verdict="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r --arg re "$read_re" '
+# На событии вызова инструмента вопрос уже известен — он и есть вызов; судится только то,
+# читались ли за этот ход правила. На завершении хода вопрос ищется в тексте реплик: меню к
+# этому моменту уже отбито раньше.
+verdict="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r --arg re "$read_re" --arg tool "$tool" '
     def is_input:
         .type == "user"
         and (((.message.content // []) | if type == "array"
@@ -78,19 +87,32 @@ verdict="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r --arg re "$read_re"
           or ((.name == "Bash") and ((.input.command // "") | test($re)))
       ) | any) as $read
     | (($texts | join("\n")) | test("\\?[[:space:]]*$"; "m")) as $asked_prose
-    | ($uses | map(.name == "AskUserQuestion") | any) as $asked_menu
-    | if ($asked_prose or $asked_menu) and ($read | not) then "ask" else "pass" end
+    | ($tool != "") as $asking_now
+    | if ($asked_prose or $asking_now) and ($read | not) then "ask" else "pass" end
 ' 2>/dev/null)"
 
 [ "$verdict" = "ask" ] || exit 0
 
-reason="BLOCKED by grill-gate: в ответе есть вопрос владельцу, а законы и правила за этот ход не читались. Вопрос, ответ на который уже записан, владельцу не задаётся — правило ведения работы. Прогони поиск по словам темы и ответь по найденному; спрашивай только то, что документацией не покрыто:
+if [ -n "$tool" ]; then
+    head="BLOCKED by grill-gate: вопрос владельцу ещё не ушёл, и это единственный момент, когда требование исполнимо."
+else
+    head="BLOCKED by grill-gate: в ответе есть вопрос владельцу, а законы и правила за этот ход не читались."
+fi
+
+reason="$head Вопрос, ответ на который уже записан, владельцу не задаётся — правило ведения работы. Прогони поиск по словам темы и ответь по найденному; спрашивай только то, что документацией не покрыто:
 
     grep -rn -i \"<слово темы>\" $laws_dir $rules_dir $specs_dir
 
 Гард судит один ход: следующий заход не отбивается."
 
-jq -n --arg r "$reason" '{decision:"block",reason:$r}' 2>/dev/null \
-    || printf '{"decision":"block","reason":"grill-gate: прочитай законы и правила по теме, прежде чем спрашивать владельца."}\n'
+# Форма отказа у двух событий разная: вызов инструмента отбивается решением о доступе, а
+# завершение хода — решением о ходе. Одна форма на оба события молча не срабатывает.
+if [ -n "$tool" ]; then
+    jq -n --arg r "$reason" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
+        || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"grill-gate: прочитай законы и правила по теме, прежде чем спрашивать владельца."}}\n'
+else
+    jq -n --arg r "$reason" '{decision:"block",reason:$r}' 2>/dev/null \
+        || printf '{"decision":"block","reason":"grill-gate: прочитай законы и правила по теме, прежде чем спрашивать владельца."}\n'
+fi
 
 exit 0

package/assets/hooks/lint-after-edit.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PostToolUse Edit|Write|MultiEdit|Bash|mcp__webstorm__create_new_file
+# Требует: hooks/profile-check.sh
 # Линтер по следам правки. PostToolUse.
 #
 # Два входа. Правка файла — линтуется один изменённый файл. Перенос файла командой — линтуются
@@ -62,7 +63,13 @@ 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_lint_for >/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_lint_for lint-after-edit || exit 0
 
 # --- какие файлы проверяем -------------------------------------------------------------
 
@@ -133,7 +140,7 @@ fi
 # --- отсев того, что линтерами дерева не покрыто ----------------------------------------
 
 lintable() {
-    if command -v rt_is_app_code >/dev/null 2>&1; then
+    if rt_needs rt_is_app_code lint-after-edit; then
         rt_is_app_code "$1" || return 1
     fi
     if [ -n "${RT_LINT_SKIP_RE:-}" ] && printf '%s' "$1" | grep -qE "$RT_LINT_SKIP_RE"; then
@@ -156,7 +163,7 @@ linter_name() {
 
 # --- прогон -----------------------------------------------------------------------------
 
-push_checks="$(command -v rt_push_checks >/dev/null 2>&1 && rt_push_checks 2>/dev/null)"
+push_checks="$(rt_needs rt_push_checks lint-after-edit && rt_push_checks 2>/dev/null)"
 
 report=""
 linters=""