@rt-tools/agent-kit 0.5.0 → 0.5.2

package/assets/commands/next-session.md

@@ -0,0 +1,122 @@
+---
+description: Закрытие захода — главная ветка подтянута, влитые ветки сняты, передача написана
+argument-hint: '[пусто | <что дописать в передачу от себя>]'
+---
+
+Закрой заход: приведи дерево к главной ветке, убери влитые ветки и напиши передачу для
+следующего захода. Дописка владельца к передаче: `$ARGUMENTS`
+
+Вызывается **последним действием захода** — после того, как работа закоммичена, а отчёт открыт
+или влит. Команда ничего не мержит, не пушит и не открывает: закрытие захода — уборка, а не
+поставка.
+
+## 1. Прочитай профиль дерева
+
+Имя главной ветки, каталог папок задач и каталог передачи у каждого дерева свои:
+
+```bash
+for profile in .claude/rt-kit/defaults/project.sh .claude/rt-kit/project.sh; do
+    [ -f "$profile" ] && . "$profile"
+done
+printf 'главная: %s · задачи: %s · передача: %s\n' \
+    "${RT_MAIN_BRANCH:-main}" "${RT_TASKS_DIR:-docs/tasks}" "${RT_HANDOFF_DIR:-.claude/handoff}"
+```
+
+Зашивать эти имена в команду нельзя: в первом же дереве, которое зовёт главную ветку иначе,
+уборка уедет не туда.
+
+## 2. Остановись, если в дереве есть незакоммиченное
+
+```bash
+git status --short
+```
+
+Непустой вывод — конец команды. Назови файлы владельцу и не трогай ни веток, ни главной: смена
+ветки уносит правку за собой или отбивается на полпути, а решает, что с ней делать, владелец.
+
+Неотслеживаемый файл — тоже незакоммиченное. Скажи о нём отдельной строкой: он мог остаться от
+работы, которую бросили.
+
+## 3. Пойми, по правилу ли ведётся работа
+
+```bash
+git fetch --prune --quiet
+branch="$(git branch --show-current)"
+```
+
+Работа идёт **по правилу**, если имя ветки несёт номер задачи — это `rt_task_branch_ok` из
+профиля — или если в каталоге папок задач лежит папка с именем ветки. Отчёт **влит**, когда
+коммиты ветки уже есть в удалённой главной:
+
+```bash
+git merge-base --is-ancestor HEAD "origin/${RT_MAIN_BRANCH:-main}" && echo влит || echo 'не влит'
+```
+
+## 4. Приведи дерево к главной ветке
+
+- **Работа по правилу и отчёт влит** — задача закрыта, ветка больше не нужна:
+
+    ```bash
+    git switch "${RT_MAIN_BRANCH:-main}" && git pull --ff-only
+    ```
+
+- **Всё остальное** — работа не кончилась, и ветка остаётся местом, где она продолжится:
+
+    ```bash
+    git merge "origin/${RT_MAIN_BRANCH:-main}"
+    ```
+
+    Конфликт разбирается сейчас, а не в начале следующего захода: назови его владельцу и
+    останови команду до его решения.
+
+## 5. Убери ветки
+
+Снимаются только влитые в главную: их коммиты есть в ней, и восстанавливать нечего.
+
+```bash
+git branch --merged "${RT_MAIN_BRANCH:-main}" \
+    | grep -vE "^\*|^\s*${RT_MAIN_BRANCH:-main}$" \
+    | xargs -r git branch -d
+```
+
+Невлитую ветку **не сноси**. Назови её владельцу вместе с числом коммитов, которых нет в
+главной, — по ним видно, что именно потеряется, если её снести:
+
+```bash
+for b in $(git branch --no-merged "${RT_MAIN_BRANCH:-main}" --format='%(refname:short)'); do
+    printf '%s: %s коммитов мимо главной\n' "$b" "$(git rev-list --count "${RT_MAIN_BRANCH:-main}..$b")"
+done
+```
+
+Мёртвые ссылки на удалённые ветки снял `git fetch --prune` шагом 3.
+
+## 6. Напиши передачу
+
+Что в ней стоит и в какой форме — паттерн `task-flow-handoff`; здесь только место и порядок.
+Файл один на ветку и лежит вне истории дерева:
+
+```bash
+mkdir -p "${RT_HANDOFF_DIR:-.claude/handoff}"
+# файл — ${RT_HANDOFF_DIR:-.claude/handoff}/<ветка>.md
+```
+
+Имя берётся от той ветки, в которой шла работа, — не от той, куда команда перешла шагом 4.
+
+К тому, что требует паттерн, эта команда добавляет своё: что она убрала — снятые ветки,
+состояние главной, оставшееся невлитым. Следующий заход начинается ровно с этого.
+
+Заход, кончившийся ничем, передачу пишет тоже: «пробовали так — не вышло, потому что» стоит
+дороже пустого файла. Дописку владельца из `$ARGUMENTS` вставь своим разделом, не пересказывая.
+
+## 7. Отдай итог
+
+Последней строкой — путь к передаче: владелец вставляет её в новый заход одной вставкой. Перед
+ней: что стало с главной веткой, какие ветки сняты, какие остались невлитыми. Содержание
+передачи не пересказывай — владелец её и так прочитает.
+
+## Чего команда не делает
+
+- не мержит отчёт и не пушит: это поставка, и вслепую она не делается;
+- не сносит невлитую ветку и не трогает папку задачи;
+- не коммитит передачу — она лежит вне дерева намеренно, иначе рядом с ходом работы заводится
+  вторая запись об одном и том же.

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

@@ -51,7 +51,15 @@ skill_for_default() {
     case "$kind" in
         edit)
             case "$target" in
-                # Файлы самого агента правятся без правила: правило на них — это оно само.
+                # Правило и паттерн — такая же договорённость, как спек: обязательные разделы,
+                # утверждение с привязкой, граница между статьёй закона и утверждением правила.
+                # Ветка стоит раньше общего исключения и раньше `*.md`: под исключением текст
+                # правила переписывался без единого требования, а `*.md` увёл бы его в правило
+                # формулировок — оно про слова, не про устройство.
+                */.claude/skills/*.md) printf '%s\n' 'spec-driven' ;;
+
+                # Остальные файлы самого агента правятся без правила: правило на них — это оно
+                # само.
                 */.claude/skills/* | */.claude/agents/* | */.claude/commands/* | */.claude/workflows/*) return 0 ;;
 
                 # Тексты проекта. Спек держит устройство домена, закон — договорённость,
@@ -61,6 +69,18 @@ skill_for_default() {
                 */docs/constitution/*) printf '%s\n' 'spec-driven' ;;
                 *.md) printf '%s\n' 'doc-style' ;;
 
+                # Конфиги линтеров — то же самое, только запреты в них исполняемые: они и есть
+                # исполнение правил про типы и про оформление, а комментарии в них пересказывают
+                # эти правила поимённо. Правились без единого правила под рукой.
+                */eslint.config.mjs | */eslint.config.js) printf '%s\n' 'typescript-conventions' ;;
+                */stylelint.config.js | */stylelint.config.mjs) printf '%s\n' 'styling-bem' ;;
+
+                # Проверка повторов исполняет утверждения правила об общем коде и требуется
+                # только им: правило о раскладке либ говорит про неё одной строкой с отсылкой,
+                # а привязки её признаков стоят при общем коде. Два отказа подряд на правку двух
+                # строк комментария стоят захода, а второе прочитанное правило не пригождается.
+                */tools/check-dupes.mjs | */tools/dupes-allowlist.json) printf '%s\n' 'shared-code' ;;
+
                 # Поставка: состав зависимостей — это то, что приезжает на прод. Правка
                 # скриптов зависимостью не является, и правило про версии на неё не вступает.
                 # Оговорка: удаление зависимости приходит правкой без номера версии и сюда не
@@ -91,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

@@ -77,6 +77,30 @@ RT_TASKS_DIR="${RT_TASKS_DIR:-docs/tasks}"
 # удалить проще, чем разобрать, а слова владельца больше нигде не записаны.
 RT_ARCHIVE_DIR="${RT_ARCHIVE_DIR:-docs/archive}"
 
+# Размер окна захода в токенах и пороги стража. Пусто — стража нет: считать долю не от чего, а
+# выведенный из записи захода размер врал бы — модель записана там без пометки о расширенном
+# окне. Дерево задаёт его в настройке агента, переменной окружения того же имени.
+RT_WINDOW_TOKENS="${RT_WINDOW_TOKENS:-}"
+RT_WINDOW_WARN_PCT="${RT_WINDOW_WARN_PCT:-40}"
+RT_WINDOW_STOP_PCT="${RT_WINDOW_STOP_PCT:-50}"
+
+# Куда кладётся передача захода. Вне дерева: состояние работы живёт в ходе работы и коммитится,
+# а передача его пересказывает для вставки в новый заход и в историю не едет.
+RT_HANDOFF_DIR="${RT_HANDOFF_DIR:-.claude/handoff}"
+
+# Команды, которые проходят после порога остановки: ими заход закрывается. Отбить их значило бы
+# отобрать у него единственный способ закончиться. Вызов считается по началу строки или сразу за
+# разделителем — упоминание команды в тексте командой не является.
+rt_handoff_allowed_cmd_default() {
+    case "$1" in
+        git\ * | *[\;\&\|]\ *git\ * | *\$\(git\ *) return 0 ;;
+        gh\ * | */gh\ * | glab\ * | */glab\ * | az\ * | */az\ *) return 0 ;;
+        *task:move* | *check:* | mkdir\ -p\ * | cat\ * | ls\ *) return 0 ;;
+    esac
+
+    return 1
+}
+
 # Где лежат тексты, которые читают до вопроса владельцу: законы, правила и договорённости о
 # продукте. По ним гард разговора судит, читалось ли за ход хоть что-то, и их же называет в
 # подсказке. Пусто у законов и правил разом — дерево этого требования не получает: читать
@@ -101,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
 }
@@ -202,3 +237,4 @@ rt_is_app_code() { rt_is_app_code_default "$@"; }
 rt_qa_decorative() { rt_qa_decorative_default "$@"; }
 rt_task_state() { rt_task_state_default "$@"; }
 rt_report_body() { rt_report_body_default "$@"; }
+rt_handoff_allowed_cmd() { rt_handoff_allowed_cmd_default "$@"; }

package/assets/docs/GLOSSARY.md

@@ -0,0 +1,77 @@
+# Словарь проекта
+
+Слова, которые в этом дереве значат что-то определённое. Читается перед тем, как написать спек,
+правило, комментарий, тело коммита или описание отчёта: слово отсюда употребляется в том
+значении, что здесь, а слово не отсюда либо заводится здесь же, либо заменяется простым.
+
+Термины одного домена живут в разделе «Терминология» его спека — здесь только те, что проходят
+сквозь весь проект.
+
+Разделы ниже везёт пакет: это слова слоя правил, и значат они одно и то же везде, где он стоит.
+Предметные слова дерево дописывает своими разделами через надстройку — они сливаются сюда по
+заголовкам, и правка пакета их не трогает.
+
+## Слой правил
+
+| Термин                    | Что это                                                                                                                                                     |
+| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Закон                     | Файл в каталоге конституции. Говорит, что должно быть верно, и не знает ни путей, ни имён файлов. Верен для любого приложения этого класса                  |
+| Законы приложения         | Слой законов, верных только для этого приложения: деньги, локали, доступ. Предметность в них законна — она их предмет                                       |
+| Правило                   | Скил с `kind: rule`. Привязывает закон к этому дереву: чем это здесь названо и где лежит                                                                    |
+| Паттерн                   | Скил с `kind: pattern`. Готовый код и порядок действий; стоит при правиле                                                                                   |
+| Компаньон                 | Файл `implementation.md` рядом с правилом: имена и пути этого дерева. Пакет знает приём, но не знает имён — их пишет проект                                 |
+| Спек                      | Описание домена: как он работает. Говорит об установившемся, а не о предстоящем                                                                             |
+| Домен                     | Предмет, у которого свой спек. Выросший домен делится на поддомены, а не на соседние домены                                                                 |
+| Сценарий                  | Наблюдаемое поведение под номером `SC-<ПРЕФИКС>-<НОМЕР>`. Номер стоит в заголовке теста                                                                     |
+| Привязка                  | Строка `` `файл:символ` `` в компаньоне или в спутнике спека — место, где утверждение исполняется                                                           |
+| Спутник                   | Файл рядом со спеком или правилом: компаньон, перечень сценариев                                                                                            |
+| Договорённость о продукте | Как продукт себя поведёт, записанное до кода. Единственное место, где спек говорит о будущем; после выкатки вливается в спек домена, а директория удаляется |
+| Ресурс                    | Единица того, что везёт пакет правил: закон, правило, паттерн, гард, проверка, роль, команда, конвейер, шаблон, умолчание, документ                         |
+| Раскладка                 | Перенос ресурса из пакета в дерево по его роду и настройке слоя                                                                                             |
+| Разложенный файл          | Файл в дереве с шапкой пакета. Правится не на месте, а надстройкой: правка на месте теряется на следующей раскладке                                         |
+| Надстройка                | Файл дерева, который сливается с разложенным по заголовкам разделов                                                                                         |
+| Наблюдение                | Строка о событии слоя правил: правило загружено, гейт отбил, гард отказал. Пишет гард, живёт в дереве, наружу уезжает счётчиками. Журналом не называется    |
+| Сводка                    | Что наблюдения говорят за отрезок дней: чем пользовались, чем ни разу, обо что спотыкались                                                                  |
+| Предложение               | Готовая формулировка правки правил с адресом: пакет, компаньон или дерево. Приносит разбор закрытой задачи, отправляет человек командой                     |
+
+## Работа
+
+| Термин          | Что это                                                                                                                                                                                      |
+| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Задача          | Единица работы в очереди работ. Заводится до ветки, и номер её стоит в имени ветки и в заголовке отчёта                                                                                      |
+| Отчёт           | Заявка на слияние: то же название, что у задачи, переведённое в сделанное                                                                                                                    |
+| Очередь работ   | Доска, на которой видно состояние каждой задачи. Ветки она не видит                                                                                                                          |
+| Папка задачи    | Одна работа от разбора до слияния: разбор просьбы, замысел, ход работы. Умирает со слиянием — разбирается, и объясняющее решение уезжает в архив                                             |
+| Разбор          | Расспрос владельца до первой правки. Записывается его словами и задним числом не переписывается                                                                                              |
+| Замысел         | Файл папки задачи: след задачи и этапы с признаками готовности. После написания не правится — с ним сверяют результат при приёмке                                                            |
+| Ход работы      | Файл папки задачи: «Где стоим», решения по ходу с причинами, записи заходов. Единственное место, где отмечается сделанное. Журналом не называется                                            |
+| След задачи     | Раздел замысла: какие спеки, законы, правила и части кода работа задевает                                                                                                                    |
+| Заход           | Одна сессия работы над задачей. Работа живёт дольше одного захода, и между ними её состояние держит только ход работы                                                                        |
+| Заполнение окна | Доля места захода, которую он уже занял: вход, запись в кэш, прочитанное из кэша и вывод последнего ответа, делённые на размер окна. Не «расход» и не «бюджет»: речь о месте, а не о деньгах |
+| Передача        | Текст, которым заход закрывается: рабочее дерево, ветка, задача, где лежит ход работы, что сделано, следующий шаг, особенности захода. Кладётся вне дерева и не коммитится                   |
+| Линия работ     | Файл с порядком задач и зависимостями между ними, когда из одного разбора вышло несколько задач. Шире одной ветки                                                                            |
+| Архив           | Записи о состоявшемся: что объясняет закрытое решение. После выкатки не правится                                                                                                             |
+
+## Проверки
+
+| Термин                | Что это                                                                                                                     |
+| --------------------- | --------------------------------------------------------------------------------------------------------------------------- |
+| Гард                  | Хук агента, который отбивает действие до того, как оно сделано, и говорит, чем отказ снимается                              |
+| Гейт                  | Требование, которое пропускает действие один раз за сессию после того, как выполнено: загружено правило, пройдены проверки  |
+| Отказ в пользу работы | Устройство гарда, при котором любая его поломка пропускает действие. Сломанный гард не имеет права остановить работу совсем |
+| Прогон                | Запуск набора сценариев. «Тесты гоняются», а не «запускаются в работу»                                                      |
+| Сверка                | Проверка, которая ничего не правит, а называет расхождения: раскладки с пакетом, спеков с кодом, очереди работ с ветками    |
+| Замер                 | Число, снятое с работающего приложения. Взгляд на экран замером не является                                                 |
+
+## Так не пишем
+
+| Так не пишем               | Пишем так                                                                                      |
+| -------------------------- | ---------------------------------------------------------------------------------------------- |
+| спека (о тесте)            | тест — файл рядом с исходником; спек — документ. Одна буква разницы, а значения противоположны |
+| таска, тикет               | задача                                                                                         |
+| пул-реквест, мёрдж-реквест | отчёт, а действие — слияние                                                                    |
+| джоба, пайплайн            | конвейер и его шаг                                                                             |
+| хендофф                    | передача                                                                                       |
+| бэклог                     | очередь работ                                                                                  |
+| контекст-виндоу            | окно захода, а его доля — заполнение окна                                                      |
+| скилл, скилы               | правило, паттерн или скил без закона — по тому, что это на самом деле                          |

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=''