@rt-tools/agent-kit 0.9.0 → 0.10.0

package/assets/checks/check-styles.mjs

@@ -33,7 +33,7 @@ import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import { basename, dirname, join } from 'node:path';
 
-import { allowlistOf, CONFIG, ROOT } from './rt-kit-checks.config.mjs';
+import { allowlistOf, baselineOf, CONFIG, ROOT, parseAllowlist } from './rt-kit-checks.config.mjs';
 
 const ALLOWLIST = allowlistOf('styles');
 const SOURCE_ROOTS = CONFIG.sourceRoots;
@@ -51,9 +51,9 @@ const USE_RE = /@(?:use|forward)\s+['"]([^'"]+)['"]/g;
 /** Строка списка известного: имя класса и перечень файлов при нём */
 const KEY_RE = /^elem (\S+) @ (.*)$/;
 
-const allowlist = JSON.parse(readFileSync(join(ROOT, ALLOWLIST), 'utf8'));
-const known = new Set([...(allowlist.accepted ?? []), ...(allowlist.debt ?? [])]);
-const debt = new Set(allowlist.debt ?? []);
+const allowlist = parseAllowlist('styles');
+const known = allowlist.keys;
+const debt = new Set(allowlist.debt.keys());
 
 /** Строки списка по имени класса: перечень файлов в ключ входит, но сверяется отдельно */
 const knownByName = new Map();
@@ -223,7 +223,7 @@ for (const [name, files] of [...usedIn].sort(([first], [second]) => first.locale
 }
 
 if (process.argv.includes('--baseline')) {
-    console.log(JSON.stringify({ ...allowlist, debt: findings.map((finding) => finding.key).sort() }, null, 4));
+    console.log(baselineOf(findings.map((finding) => finding.key).sort(), allowlist));
     process.exit(0);
 }
 

package/assets/checks/lib-common.mjs

@@ -9,7 +9,7 @@
 import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
 import { join } from 'node:path';
 
-import { CONFIG, ROOT, readAllowlist } from './rt-kit-checks.config.mjs';
+import { CONFIG, ROOT, parseAllowlist } from './rt-kit-checks.config.mjs';
 
 const FAMILIES = CONFIG.families;
 /**
@@ -60,8 +60,8 @@ const isLib = (path) => existsSync(join(ROOT, path, 'project.json'));
  * нет вовсе, и прямое чтение роняло проверку отказом «нет такого файла» — то есть первая же
  * установка получала поломку вместо отчёта о том, что долгов нет.
  */
-const allowlist = readAllowlist('lib-layers');
-const pathsOf = (key) => (allowlist[key] ?? []).map((exception) => exception.path);
+const allowlist = parseAllowlist('lib-layers', ['notDomains', 'legacyDomains', 'legacyLibs', 'singleLayerDomains', 'accepted', 'debt']);
+const pathsOf = (key) => [...allowlist[key].keys()];
 
 /** Паттерн `<корень>/x/*` покрывает и сам каталог `<корень>/x`: исключение снимается целиком */
 const matches = (patterns, path) =>

package/assets/checks/rt-kit-checks.config.mjs

@@ -187,8 +187,92 @@ export const allowlistOf = (name) => join(CONFIG.allowlistDir, `${name}-allowlis
  */
 export const readAllowlist = (name) => {
     const path = join(ROOT, allowlistOf(name));
+    if (!existsSync(path)) {
+        return {};
+    }
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    } catch (error) {
+        // Нечитаемая настройка — это не пустой список, и молчать о ней нельзя: проверка,
+        // прочитавшая пустоту вместо перечня, назовёт долгом всё дерево разом.
+        console.error(`${allowlistOf(name)}: список известного не прочитан — не разбирается как JSON: ${error.message}`);
+        process.exit(1);
+    }
+};
+
+/**
+ * Разбор списка принятого: запись отвечает за себя сама.
+ *
+ * Причина, написанная прозой на весь список, за отдельную строку не отвечает: список пустеет и
+ * наполняется, а причина остаётся прежней — строка, внесённая позже, выглядит покрытой ею. Так
+ * и вышло у четырёх списков дерева: шапка говорила о разобранном долге, а под ней лежало
+ * принятое, которого в тот день ещё не было.
+ *
+ * Поэтому форма одна на все списки: сторона — объект, где ключ говорит, что принято, а
+ * значение несёт причину и номер задачи, которой запись внесена. Стороны называет зовущий:
+ * у большинства списков это `accepted` и `debt`, у иных свои имена, а разбор у всех один. Номер — это дорога
+ * к разговору, в котором заглушить разрешили: без него запись объясняет сама себя, а спросить
+ * о ней некого.
+ *
+ * Отказ называет файл и саму запись: список читают не целиком, а по строке, и «где-то здесь
+ * неверная запись» стоит того же, что и молчание.
+ */
+export const parseAllowlist = (name, sides = ['accepted', 'debt']) => {
+    const file = allowlistOf(name);
+    const raw = readAllowlist(name);
+    const key = CONFIG.board.taskKey;
+    const taskForm = key ? new RegExp(`^${key}-\\d+$`) : /^[A-Za-z]+-\d+$/;
+    const refuse = (message) => {
+        console.error(`${file}: ${message}`);
+        process.exit(1);
+    };
+    const parseSide = (side) => {
+        const entries = raw[side];
+        if (entries === undefined) {
+            return new Map();
+        }
+        if (Array.isArray(entries) || typeof entries !== 'object' || entries === null) {
+            refuse(`«${side}» записан не объектом — у записи нет места ни для причины, ни для номера задачи`);
+        }
+        const parsed = new Map();
+        for (const [entry, value] of Object.entries(entries)) {
+            if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+                refuse(`«${entry}» записан без причины — рядом с записью стоят «reason» и «task»`);
+            }
+            if (typeof value.reason !== 'string' || value.reason.trim() === '') {
+                refuse(`у «${entry}» пустая причина — заглушённое без причины через месяц не отличить от забытого`);
+            }
+            if (typeof value.task !== 'string' || !taskForm.test(value.task)) {
+                refuse(`у «${entry}» нет номера задачи вида «${key || 'КЛЮЧ'}-<номер>» — спросить о записи будет некого`);
+            }
+            parsed.set(entry, { reason: value.reason, task: value.task });
+        }
+
+        return parsed;
+    };
+    const parsed = Object.fromEntries(sides.map((side) => [side, parseSide(side)]));
+
+    return { ...parsed, keys: new Set(sides.flatMap((side) => [...parsed[side].keys()])) };
+};
+
+/**
+ * Заготовка списка принятого для режима пересъёмки: прежние записи сохраняются целиком, а
+ * новые приходят с пустой причиной и пустым номером задачи.
+ *
+ * Пустые поля здесь намеренны. Пересъёмка — это помощник, а не разрешение: заглушить проверку
+ * можно только словом владельца, и записать его должен человек. Разбор такую запись отбивает,
+ * поэтому список, снятый пересъёмкой и не заполненный, дальше гейта не проходит.
+ */
+export const baselineOf = (keys, parsed, side = 'debt') => {
+    const entryOf = (key) => parsed.debt?.get(key) ?? parsed.accepted?.get(key) ?? { reason: '', task: '' };
+    const fresh = keys.filter((key) => !parsed.keys.has(key));
+    if (fresh.length > 0) {
+        console.error(`новых записей ${fresh.length} — у каждой заполняются «reason» и «task», иначе разбор списка отбивает прогон`);
+    }
+    const filled = Object.fromEntries(keys.map((key) => [key, entryOf(key)]));
+    const rest = Object.fromEntries([...(parsed.accepted ?? new Map())].filter(([key]) => !keys.includes(key)));
 
-    return existsSync(path) ? JSON.parse(readFileSync(path, 'utf8')) : {};
+    return JSON.stringify(side === 'accepted' ? { accepted: filled } : { accepted: rest, debt: filled }, null, 4);
 };
 
 /** Есть ли в дереве то, без чего проверке нечего делать. Нет — она выходит с нулём и говорит это. */

package/assets/defaults/project.sh

@@ -50,6 +50,27 @@ RT_HOOKS_TESTS="${RT_HOOKS_TESTS:-.claude/hooks/tests/run.sh}"
 # её делают, а всплывает на чужой работе — раскладка отказывает по правленому файлу целиком и не
 # кладёт ни одного другого. Признак — сама настройка раскладки: дерево без неё пакета не ставит,
 # и звать в нём нечего.
+# Тронула ли ветка только тексты. Нулевой код — только тексты, иначе — код.
+#
+# Признак нужен тому дереву, которое дописало в набор гейта тяжёлый шаг: стенд, снимки витрин,
+# сборку образов. Без него такой шаг идёт подряд, чем бы ветка ни была, и пуш коммита, менявшего
+# одну строку в таблице markdown, занимает минуты — за которые владелец успевает прочитать его
+# как зависший и отбить. Правило поставки требует того же от конвейера: ветка, не тронувшая ни
+# строки кода, не поднимает стенда, не снимает кадров и не собирает образов.
+#
+# Текстовой считается ветка, у которой каждый задетый файл — либо `.md`, либо лежит под каталогом
+# текстов. Всё остальное, включая обвязку и настройки, считается кодом: признак обязан ошибаться
+# в сторону лишнего прогона, а не пропущенного. Пустая база означает, что сравнивать не с чем, —
+# тогда признак молчит и гоняется всё.
+rt_push_docs_only_default() {
+    [ -z "$1" ] && return 1
+    changed="$(git diff --name-only "$1"...HEAD 2>/dev/null)"
+    [ -z "$changed" ] && return 1
+    printf '%s\n' "$changed" | grep -qvE "(^${RT_DOCS_DIR:-docs}/|\.md\$)" && return 1
+
+    return 0
+}
+
 rt_push_checks_default() {
     runner="$(rt_runner)"
     root="${CLAUDE_PROJECT_DIR:-.}"
@@ -101,6 +122,9 @@ rt_lint_for_default() {
 }
 
 # Каталог папок задач. Пусто — ведения работы папкой в дереве нет, и гард замысла молчит.
+# Каталог текстов проекта: по нему признак состава правки отличает текстовую ветку от кодовой.
+RT_DOCS_DIR="${RT_DOCS_DIR:-docs}"
+
 RT_TASKS_DIR="${RT_TASKS_DIR:-docs/tasks}"
 
 # Каталог записей о законченных работах. Туда переносят то, что объясняет решения закрытой
@@ -144,6 +168,11 @@ RT_SPECS_DIR="${RT_SPECS_DIR:-docs/specs}"
 # папкой задачи и с архивом. Если общего предка нет, сравнивать не с чем — проверка молчит.
 RT_MAIN_BRANCH="${RT_MAIN_BRANCH:-main}"
 
+# Имя клиента хостинга в строке запуска. По нему гард перезапуска узнаёт вызов: у каждого вида
+# хостинга свой клиент, и угаданное имя не совпадает ни с чем. Умолчание записано под самый
+# распространённый вид; дерево с другим хостингом называет своё.
+RT_HOST_CLI="${RT_HOST_CLI:-gh}"
+
 # Тело PR по его номеру. Обход требования пишут в PR, а в команде слияния его нет — там только
 # номер. Пустой ответ значит «спросить не у кого»: тогда обход ищется только в тексте команды.
 rt_report_body_default() {
@@ -239,6 +268,12 @@ RT_BOARD_CHECK_CMD="${RT_BOARD_CHECK_CMD:-npm run check:board}"
 # Учётная запись, которую ставят исполнителем. Умолчание молчит: у каждого дерева она своя.
 RT_TASK_BOT="${RT_TASK_BOT:-}"
 
+# Команда перевода задачи между колонками очереди работ и имя первой колонки — той, из которой
+# задача уходит, когда её берут в работу. Имя без умолчания: колонки дерево называет своими
+# словами, а выдуманное не совпало бы ни с чем и молча выключило бы проверку колонки.
+RT_TASK_MOVE_CMD="${RT_TASK_MOVE_CMD:-npm run task:move}"
+RT_BOARD_BACKLOG="${RT_BOARD_BACKLOG:-}"
+
 # Почта, которой подписан коммит машинной учётной записи. Целым значением, а не образцом:
 # служебный адрес хостинга состоит из числа, логина и домена, а сопоставляется по числу — логин
 # рядом с ним не сверяет никто. Образец «число, плюс, логин» прошёл бы с чужим числом, то есть
@@ -268,6 +303,18 @@ rt_task_state_default() {
     printf '%s' "$state"
 }
 
+# Состояние заявки одним объектом: exists, draft, author, reviewers, reviewed. Спрашивает того
+# же помощника очереди работ, что и состояние задачи, — чтобы гард и сверка одинаково понимали
+# «у заявки есть разбор». Нет узла, нет помощника, нет сети — молчание, и ярус пропускается.
+rt_pull_state_default() {
+    command -v node >/dev/null 2>&1 || return 1
+    [ -f "${RT_BOARD_HELPER:-tools/board.mjs}" ] || return 1
+    state="$(node "${RT_BOARD_HELPER:-tools/board.mjs}" pr "$1" 2>/dev/null)" || return 1
+    [ -z "$state" ] && return 1
+    printf '%s' "$state" | jq -e 'has("offline") | not' >/dev/null 2>&1 || return 1
+    printf '%s' "$state"
+}
+
 # Что в этом дереве считается переизобретением. По строке «образец<таб>чем заменить».
 # Образцы узкие намеренно: гард сверяет только НОВЫЙ текст, и широкий образец отбивал бы
 # правку, которая ничего нового не заводит.
@@ -306,6 +353,8 @@ rt_qa_decorative_default() {
 # Умолчания под общими именами. Надстройка проекта объявит любое из них заново — и позовёт
 # отсюда то же имя с суффиксом `_default` для всего, чего не назвала сама.
 rt_push_checks() { rt_push_checks_default "$@"; }
+rt_push_docs_only() { rt_push_docs_only_default "$@"; }
+
 rt_docs_pair_for() { rt_docs_pair_for_default "$@"; }
 rt_lint_for() { rt_lint_for_default "$@"; }
 rt_task_branch_ok() { rt_task_branch_ok_default "$@"; }
@@ -315,5 +364,6 @@ rt_shell_writes() { rt_shell_writes_default "$@"; }
 rt_shell_paths() { rt_shell_paths_default "$@"; }
 rt_qa_decorative() { rt_qa_decorative_default "$@"; }
 rt_task_state() { rt_task_state_default "$@"; }
+rt_pull_state() { rt_pull_state_default "$@"; }
 rt_report_body() { rt_report_body_default "$@"; }
 rt_handoff_allowed_cmd() { rt_handoff_allowed_cmd_default "$@"; }

package/assets/docs/GLOSSARY.md

@@ -30,6 +30,7 @@
 | Раскладка                 | Перенос ресурса из пакета в дерево по его роду и настройке слоя                                                                                                  |
 | Разложенный файл          | Файл в дереве с шапкой пакета. Правится не на месте, а надстройкой: правка на месте теряется на следующей раскладке                                              |
 | Надстройка                | Файл дерева, который сливается с разложенным по заголовкам разделов                                                                                              |
+| Выключенная роль          | Роль, вызов которой дерево перестало считать обязательным: гард при ней молчит. Названа списком в настройке дерева, из раскладки не убирается и зовётся руками   |
 | Наблюдение                | Строка о событии слоя правил: правило загружено, гейт отбил, гард отказал. Пишет гард, живёт в дереве, наружу уезжает счётчиками. Журналом не называется         |
 | Сводка                    | Что наблюдения говорят за отрезок дней: чем пользовались, чем ни разу, обо что спотыкались                                                                       |
 | Предложение               | Готовая формулировка правки правил с адресом: пакет, компаньон или дерево. Приносит разбор закрытой задачи или слово посреди работы, отправляет человек командой |
@@ -37,21 +38,22 @@
 
 ## Работа
 
-| Термин          | Что это                                                                                                                                                                                                                                                                       |
-| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Задача          | Единица работы в очереди работ. Заводится до ветки, и номер её стоит в имени ветки и в заголовке PR                                                                                                                                                                           |
-| PR              | Заявка на слияние: то же название, что у задачи, переведённое в сделанное. Отчётом, пул-реквестом и мёрдж-реквестом не называется — ни в файлах, ни в разговоре                                                                                                               |
-| Очередь работ   | Доска, на которой видно состояние каждой задачи. Ветки она не видит                                                                                                                                                                                                           |
-| Папка задачи    | Одна работа от разбора до слияния: разбор просьбы, замысел, ход работы. Умирает со слиянием — разбирается, и объясняющее решение уезжает в архив                                                                                                                              |
-| Разбор          | Расспрос владельца до первой правки. Записывается его словами и задним числом не переписывается                                                                                                                                                                               |
-| Замысел         | Файл папки задачи: след задачи и этапы с признаками готовности. После написания не правится — с ним сверяют результат при приёмке                                                                                                                                             |
-| Ход работы      | Файл папки задачи: «Где стоим», решения по ходу с причинами, записи заходов. Единственное место, где отмечается сделанное. Журналом не называется                                                                                                                             |
-| След задачи     | Раздел замысла: какие спеки, законы, правила и части кода работа задевает                                                                                                                                                                                                     |
-| Заход           | Одна сессия работы над задачей. Работа живёт дольше одного захода, и между ними её состояние держит только ход работы                                                                                                                                                         |
-| Заполнение окна | Доля места захода, которую он уже занял: вход, запись в кэш, прочитанное из кэша и вывод последнего ответа, делённые на размер окна. Не «расход» и не «бюджет»: речь о месте, а не о деньгах                                                                                  |
-| Передача        | Текст, которым заход закрывается: рабочее дерево, ветка, задача, где лежит ход работы, что сделано, следующий шаг, особенности захода. Кладётся вне дерева и не коммитится                                                                                                    |
-| Эпик            | Серия задач одной темы, выполняемых в назначенном порядке. Живёт в двух местах сразу: карточка в очереди работ с меткой эпика и замысел рядом с ней — что за возможность разрабатывается, какие задачи входят и в каком порядке. Шире одной ветки. Линией работ не называется |
-| Архив           | Записи о состоявшемся: что объясняет закрытое решение. После выкатки не правится                                                                                                                                                                                              |
+| Термин           | Что это                                                                                                                                                                                                                                                                       |
+| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Задача           | Единица работы в очереди работ. Заводится до ветки, и номер её стоит в имени ветки и в заголовке PR                                                                                                                                                                           |
+| PR               | Заявка на слияние: то же название, что у задачи, переведённое в сделанное. Отчётом, пул-реквестом и мёрдж-реквестом не называется — ни в файлах, ни в разговоре                                                                                                               |
+| Очередь работ    | Доска, на которой видно состояние каждой задачи. Ветки она не видит                                                                                                                                                                                                           |
+| Папка задачи     | Одна работа от разбора до слияния: разбор просьбы, замысел, ход работы. Умирает со слиянием — разбирается, и объясняющее решение уезжает в архив                                                                                                                              |
+| Разбор           | Расспрос владельца до первой правки. Записывается его словами и задним числом не переписывается                                                                                                                                                                               |
+| Замысел          | Файл папки задачи: след задачи и этапы с признаками готовности. После написания не правится — с ним сверяют результат при приёмке                                                                                                                                             |
+| Ход работы       | Файл папки задачи: «Где стоим», решения по ходу с причинами, записи заходов. Единственное место, где отмечается сделанное. Журналом не называется                                                                                                                             |
+| Состояние работы | Единица, которой работа ведётся: у каждого состояния названы вход, обязательное действие и выход. Объявляется машиночитаемой строкой в разделе «Где стоим» хода работы — гард судит объявленный переход, а не наличие файлов                                                  |
+| След задачи      | Раздел замысла: какие спеки, законы, правила и части кода работа задевает                                                                                                                                                                                                     |
+| Заход            | Одна сессия работы над задачей. Работа живёт дольше одного захода, и между ними её состояние держит только ход работы                                                                                                                                                         |
+| Заполнение окна  | Доля места захода, которую он уже занял: вход, запись в кэш, прочитанное из кэша и вывод последнего ответа, делённые на размер окна. Не «расход» и не «бюджет»: речь о месте, а не о деньгах                                                                                  |
+| Передача         | Текст, которым заход закрывается: рабочее дерево, ветка, задача, где лежит ход работы, что сделано, следующий шаг, особенности захода. Кладётся вне дерева и не коммитится                                                                                                    |
+| Эпик             | Серия задач одной темы, выполняемых в назначенном порядке. Живёт в двух местах сразу: карточка в очереди работ с меткой эпика и замысел рядом с ней — что за возможность разрабатывается, какие задачи входят и в каком порядке. Шире одной ветки. Линией работ не называется |
+| Архив            | Записи о состоявшемся: что объясняет закрытое решение. После выкатки не правится                                                                                                                                                                                              |
 
 ## Проверки
 

package/assets/hooks/browser-guard-device-id.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse mcp__claude-in-chrome__select_browser
+# Требует: hooks/deny-tail.sh
 # Гард выбора браузера. PreToolUse на выборе браузера расширением.
 #
 # Отклоняет любой профиль, кроме закреплённого: чужой стоит лишнего круга и приводит в браузер,
@@ -24,5 +25,12 @@ if [ "$requested" = "$device_id" ]; then
     exit 0
 fi
 
-echo "Профиль «${requested}» не тот, что закреплён за проектом. Бери ${device_id} — единственный профиль, где сделан вход." >&2
+# Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть. Файл
+# может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+# shellcheck disable=SC1090
+[ -f "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" ] \
+    && . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" 2>/dev/null
+command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { :; }
+
+echo "Профиль «${requested}» не тот, что закреплён за проектом. Бери ${device_id} — единственный профиль, где сделан вход. $(rt_deny_tail)" >&2
 exit 2

package/assets/hooks/browser-guard-no-asking.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse AskUserQuestion
+# Требует: hooks/deny-tail.sh
 # PreToolUse guard for AskUserQuestion.
 #
 # The browser choice is already made and pinned in browser-device-id.sh — asking again is noise, and the
@@ -23,5 +24,12 @@ questions="$(printf '%s' "$input" | jq -r '[.tool_input.questions[]? | .question
 
 printf '%s' "$questions" | grep -qiE 'deviceid|device id|(which|what|pick|choose|select)[^.]{0,25}\bbrowser\b|\bbrowser\b[^.]{0,25}(profile|to use)|как(ой|ую)?[^.]{0,15}браузер|брауз[а-я]*[^.]{0,20}(использовать|выбрать|выбор|нужен|запустить)' || exit 0
 
-echo "Do not ask which browser to use — the profile is pinned. Call select_browser with deviceId ${device_id} ('Main' profile)." >&2
+# Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть. Файл
+# может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+# shellcheck disable=SC1090
+[ -f "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" ] \
+    && . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" 2>/dev/null
+command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { :; }
+
+echo "Do not ask which browser to use — the profile is pinned. Call select_browser with deviceId ${device_id} ('Main' profile). $(rt_deny_tail)" >&2
 exit 2

package/assets/hooks/browser-guard-no-listing.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse mcp__claude-in-chrome__(list_connected_browsers|switch_browser)
+# Требует: hooks/deny-tail.sh
 # Гард перечисления и переключения браузеров. PreToolUse.
 #
 # Сессии проекта живут в одном закреплённом профиле. Перечисление и переключение отдают общие
@@ -14,5 +15,12 @@ cat >/dev/null 2>&1
 device_id="$("${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/browser-device-id.sh" 2>/dev/null)"
 [ -z "$device_id" ] && exit 0
 
-echo "Не перечисляй и не переключай браузеры. Вызови выбор браузера с профилем ${device_id} — единственным, где сделан вход." >&2
+# Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть. Файл
+# может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+# shellcheck disable=SC1090
+[ -f "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" ] \
+    && . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" 2>/dev/null
+command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { :; }
+
+echo "Не перечисляй и не переключай браузеры. Вызови выбор браузера с профилем ${device_id} — единственным, где сделан вход. $(rt_deny_tail)" >&2
 exit 2

package/assets/hooks/browser-guard-no-other-drivers.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse mcp__playwright__.*|mcp__chrome-devtools__.*|Bash
+# Требует: hooks/deny-tail.sh
 # Гард обходных путей к браузеру. PreToolUse.
 #
 # Закрепление профиля чего-то стоит только тогда, когда дверь одна. Здесь перечислены двери,
@@ -19,8 +20,13 @@ device_id="$("${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/browser-device-id.sh" 2>/de
 
 tool="$(printf '%s' "$input" | jq -r '.tool_name // empty' 2>/dev/null)"
 
+# shellcheck disable=SC1090
+[ -f "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" ] \
+    && . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" 2>/dev/null
+command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { :; }
+
 deny() {
-    echo "$1 Води браузер закреплённым расширением: выбери профиль ${device_id} и работай его инструментами." >&2
+    echo "$1 Води браузер закреплённым расширением: выбери профиль ${device_id} и работай его инструментами. $(rt_deny_tail)" >&2
     exit 2
 }
 

package/assets/hooks/browser-guard-require-select.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse mcp__claude-in-chrome__.*
+# Требует: hooks/deny-tail.sh
 # Гард свежести выбора браузера. PreToolUse на всех остальных вызовах расширения.
 #
 # ЗАЧЕМ ОН ЕСТЬ — отказ, из которого он вырос: расширение действует на тот браузер, который
@@ -35,8 +36,16 @@ ttl=300
 sid="$(printf '%s' "$input" | jq -r '.session_id // "nosession"' 2>/dev/null)"
 marker="${TMPDIR:-/tmp}/claude-browser-guard/${sid}"
 
+# Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть. Файл
+# может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
+# shellcheck disable=SC1090
+[ -f "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" ] \
+    && . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" 2>/dev/null
+command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { :; }
+
+
 if [ ! -f "$marker" ]; then
-    echo "В этой сессии браузер не выбран. Вызови выбор браузера с профилем ${device_id} до любого другого вызова." >&2
+    echo "В этой сессии браузер не выбран. Вызови выбор браузера с профилем ${device_id} до любого другого вызова. $(rt_deny_tail)" >&2
     exit 2
 fi
 
@@ -46,7 +55,7 @@ age=$(( now - stamped ))
 
 if [ "$age" -gt "$ttl" ]; then
     rm -f "$marker" 2>/dev/null
-    echo "Последний выбор браузера был ${age} с назад (предел ${ttl} с) — на таких перерывах активный браузер расширения уплывает, и это может быть уже не закреплённый профиль. Вызови выбор с профилем ${device_id} заново и повтори." >&2
+    echo "Последний выбор браузера был ${age} с назад (предел ${ttl} с) — на таких перерывах активный браузер расширения уплывает, и это может быть уже не закреплённый профиль. Вызови выбор с профилем ${device_id} заново и повтори. $(rt_deny_tail)" >&2
     exit 2
 fi
 

package/assets/hooks/claim-guard.sh

@@ -0,0 +1,113 @@
+#!/usr/bin/env bash
+# rt-hook: Stop
+# Гард утверждения: сказанное владельцу о состоянии дерева несёт команду, показавшую это. Stop.
+#
+# Зачем именно так. Правило текстов само говорит, что ответ владельцу не читает ни одна
+# проверка: за файл отвечает гейт, за ответ — автор, и цену ошибки в ответе платит владелец.
+# Восемь разборов подряд про одно и то же — готовым названо лежащее на диске, снятыми названы
+# только локальные ветки, проверенным назван набор уже конвейерного, состоянием дерева названа
+# отставшая локальная ссылка. Каждый раз в правило дописывалась статья, и каждый раз промах
+# повторялся: текст читают в начале захода, а утверждение говорят в конце.
+#
+# Что судится: текст, сказанный владельцу за этот ход. Вывод инструмента и записанное в файл
+# сюда не входят — их читают гейт и сверки.
+#
+# Как судится: у каждого слова-утверждения назван свой род команды. Утверждение о зелёном
+# наборе подтверждает прогон набора, о запушенном — вызов пуша, о снятом — вызов удаления.
+# Команда ищется в этом же ходе: состояние дерева меняется, и вывод прошлого хода о нынешнем
+# уже не говорит.
+#
+# Чего гард не судит. Неверный вывод: об образце, судимом по одному его файлу, и о пути, которым
+# человек не пойдёт, машине судить нечем — там нет ни слова-утверждения, ни команды, с которой
+# сверять. Эти случаи держит правило ведения работы, и это известная граница гарда, а не
+# обещание.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ: при любой ошибке, нехватке `jq`, отсутствии записи хода или пустом
+# тексте ход РАЗРЕШАЕТСЯ (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
+
+# Ход — всё, что записано после последней настоящей реплики владельца: ответ инструмента
+# приходит той же ролью и репликой не считается.
+turn="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r '
+    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:] end) as $turn
+    | [$turn[] | select(.type == "assistant") | (.message.content // [])[]
+        | select(.type == "text") | (.text // "")] as $said
+    | [$turn[] | select(.type == "assistant") | (.message.content // [])[]
+        | select(.type == "tool_use") | (.input.command // "")] as $ran
+    | { said: ($said | join("\n")), ran: ($ran | join("\n")) }
+' 2>/dev/null)"
+
+[ -z "$turn" ] && exit 0
+
+said="$(printf '%s' "$turn" | jq -r '.said // ""' 2>/dev/null)"
+ran="$(printf '%s' "$turn" | jq -r '.ran // ""' 2>/dev/null)"
+[ -z "$said" ] && exit 0
+
+# Карта утверждений: что сказано о дереве | чем это показывают | что назвать в отказе.
+#
+# Слово берётся в той форме, в какой его говорят владельцу. Будущее время сюда не идёт:
+# «проверю» и «запущу» утверждениями не являются — они обещание, и врать им нечем.
+claims=(
+    'проверено|прогнал[а]?|тесты (зелёные|прошли)|линт(ер)? (зелёный|прошёл|чистый)|сборка (зелёная|прошла)|набор зелёный|проверки зелёные|спеки зелёные|всё зелен(о|ое)§nx (test|lint|build|run|affected|run-many)|npm (run|test)|pnpm (run|exec|test)|jest|vitest|playwright|check:|run\.sh§команду набора — прогон тестов, линта или сборки'
+    'запушен[аоы]?|запушил[а]?|пуш прошёл|ветка уехала§git push§`git push`'
+    '(PR|правка|ветка|работа)[^.]{0,20}(влит|слит|смержен)|влит[оа] в|слит[оа] в§git merge|gh pr merge§`git merge` или `gh pr merge`'
+    '(ветки|ветка|файлы|файл|папка|каталог)[^.]{0,40}(снят|удал|почищ|вычищ)|снят[оыа] с§git branch|git push .*--delete|git rm|gh api|rm §команду удаления — `git branch -d`, `git push --delete` или `git rm`'
+    'прогон (зелёный|прошёл|кончился)|конвейер зелёный|проверки на PR зелёные§gh run§`gh run list` или `gh run view`'
+    '(работа|правка|задача) готова|можно вливать|PR открыт|черновик снят§gh pr §`gh pr create`, `gh pr view` или `gh pr ready`'
+    'задача заведена|задача (в|переведена в) колонк|колонка переведена§gh issue|gh api|task:new|task:move|board\.mjs§команду очереди работ — заведение задачи или перевод колонки'
+    '(в дереве|в репозитории|здесь|такого файла|такой команды)[^.]{0,30}(нет|не бывает)|не заводили|нигде не встречается§grep|rg |ls |find |git ls-files|git grep|git log|cat §команду поиска — `grep`, `git ls-files` или обход каталога'
+)
+
+for row in "${claims[@]}"; do
+    words="${row%%§*}"
+    rest="${row#*§}"
+    proof="${rest%%§*}"
+    name="${rest#*§}"
+
+    found="$(printf '%s' "$said" | grep -oiE "$words" 2>/dev/null | head -1)"
+    [ -z "$found" ] && continue
+    printf '%s' "$ran" | grep -qiE "$proof" 2>/dev/null && continue
+
+    reason="BLOCKED by claim-guard: владельцу сказано «${found}» — это утверждение о состоянии дерева, а команды, которая его показывает, за этот ход не было.
+
+Утверждение о дереве стоит ровно столько, сколько команда, его показавшая: сказанное без команды владелец читает как проверенный факт и узнаёт о расхождении последним.
+
+Запусти ${name} этим же ходом и назови её вывод — либо убери утверждение из ответа.
+
+Гард судит один ход: следующий заход не отбивается."
+
+    # Общий хвост отказа: два законных хода. Файл может быть не разложен — тогда хвоста нет,
+    # а причина отказа остаётся прежней.
+    # shellcheck disable=SC1090
+    [ -f "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" ] \
+        && . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" 2>/dev/null
+    command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { :; }
+    deny_tail_text="$(rt_deny_tail "")"
+    [ -n "$deny_tail_text" ] && reason="${reason}
+
+${deny_tail_text}"
+
+    jq -n --arg r "$reason" '{decision:"block",reason:$r}' 2>/dev/null \
+        || printf '{"decision":"block","reason":"claim-guard: утверждение о дереве не подтверждено командой."}\n'
+    exit 0
+done
+
+exit 0