@rt-tools/agent-kit 0.20.0 → 0.21.0

package/assets/checks/check-reuse.mjs

@@ -33,7 +33,17 @@ const SOURCE_ROOTS = CONFIG.sourceRoots;
 const SKIPPED_DIRS = CONFIG.skippedDirs;
 const BACKEND_ROOTS = CONFIG.backendRoots;
 
-const SIGNALS = loadSignals(CONFIG.reuse ?? {}, ROOT);
+// Нехватка признаков — отказ, а не пустая работа: проверка стоит в гейте пуша, и зелёный ответ
+// без единого прочитанного файла неотличим от честного нуля. Отказ печатается строкой, а не
+// стеком вызовов: читает его тот, кто настраивает дерево, а не тот, кто правит эту проверку.
+let SIGNALS;
+try {
+    SIGNALS = loadSignals(CONFIG.reuse ?? {}, ROOT);
+} catch (failure) {
+    console.error(`check-reuse: ${failure.message}`);
+    console.error('\nПравило единообразия — скил `reuse-first`.');
+    process.exit(1);
+}
 
 function count(text, expression) {
     return [...text.matchAll(expression)].length;

package/assets/checks/check-specs.mjs

@@ -52,6 +52,7 @@ import { ROOT } from './rt-kit-checks.config.mjs';
 import { checkRuleImplementation, checkSpecLaws, checkTracedAnchors } from './spec-anchors.mjs';
 import { CONSTITUTION_DIR, REQUIRED_HEADINGS, SPECS_DIR, collectDomains, exists, problems, read, report, walk } from './spec-common.mjs';
 import { checkContract, checkRefusalCodes, procedureRootsOf } from './spec-contract.mjs';
+import { proposedGroups, staleProposed } from './spec-proposed.mjs';
 import { collectReferences, parseScenarios, promisesScreen } from './spec-scenarios.mjs';
 
 // ── прогон ────────────────────────────────────────────────────────────────────
@@ -404,32 +405,16 @@ if (debts.length > 0) {
     uncovered.forEach((scenario) => console.log(`  нет теста ${scenario.id} — ${scenario.title} (${scenario.file}:${scenario.line})`));
 }
 
-/**
- * Договорённость, по которой код уже написан, вливается в спек домена, а её директория
- * удаляется. Оставленная в главной ветке, она читается как предложенное и не выкаченное —
- * то есть как ложь о работающем месяц приложении.
- *
- * Признак — все сценарии директории покрыты тестами: пока хоть один помечен «Не покрыто»,
- * фича не дописана. Падением это не делается: на середине работы часть тестов уже есть, и
- * такая проверка краснела бы всю дорогу.
- */
-const proposed = new Map();
-for (const scenario of byId.values()) {
-    const at = scenario.file.indexOf('/proposed/');
-    if (at === -1) {
-        continue;
-    }
-    const dir = scenario.file.slice(0, scenario.file.indexOf('/', at + '/proposed/'.length));
-    const group = proposed.get(dir) ?? { total: 0, ready: 0 };
-    group.total += 1;
-    if (references.has(scenario.id) && !scenario.uncovered && !scenario.partial) {
-        group.ready += 1;
-    }
-    proposed.set(dir, group);
-}
+const proposed = proposedGroups(byId.values(), references);
 
 const ripe = [...proposed].filter(([, group]) => group.total > 0 && group.total === group.ready);
 if (ripe.length > 0) {
     console.log('\nПора вливать — сценарии закрыты тестами, договорённость ждёт переезда в спек домена:');
     ripe.forEach(([dir, group]) => console.log(`  ${dir} — сценариев ${group.total}`));
 }
+
+const stale = staleProposed([...proposed.keys()]);
+if (stale.length > 0) {
+    console.log('\nЖдёт дольше месяца — привязка в договорённости стареет вместе с кодом, на который показывает:');
+    stale.forEach((record) => console.log(`  ${record.dir} — ${Math.floor(record.ageDays)} суток без правок`));
+}

package/assets/checks/signals/core.json

@@ -8,11 +8,21 @@
       "find": "(window\\.)?(local|session)Storage\\.",
       "instead": "службы хранилища @rt-tools/core"
     },
-    { "key": "raw-media-query", "ext": ".ts", "find": "matchMedia\\(", "instead": "BreakpointsService" },
+    {
+      "key": "raw-media-query",
+      "ext": ".ts",
+      "find": "(^|[^.\\w#$])matchMedia\\(",
+      "strip": "'[^'\\n]*'|\"[^\"\\n]*\"|`[^`]*`",
+      "skipBackendRoots": true,
+      "instead": "BreakpointsService"
+    },
     {
       "key": "raw-window",
       "ext": ".ts",
-      "find": "(^|[^.\\w])(window|document)\\.",
+      "find": "(^|[^.\\w#$])(window|document)\\.",
+      "strip": "'[^'\\n]*'|\"[^\"\\n]*\"|`[^`]*`",
+      "cancel": "(const|let|var)\\s+(window|document)\\b|\\b(window|document)\\s*:\\s*[A-Za-z{(]|\\((window|document)\\s*:",
+      "skipBackendRoots": true,
       "instead": "PlatformService и токены среды @rt-tools/core"
     }
   ]

package/assets/checks/signals.mjs

@@ -54,6 +54,14 @@ function readBundle(name) {
  * Совпавший ключ замещает пакетный: дерево вправе сказать о своём готовом точнее, чем пакет,
  * который его не видел. Файла своих признаков может не быть — это не отказ: пропуск дешевле
  * остановки работы, и объявляют его раньше, чем заводят.
+ *
+ * А вот пустой итог — отказ. Проверка стоит в гейте пуша и отвечает «расхождений 0 в 0
+ * признаках» с нулевым кодом: она объявляет успех, не прочитав ни одного файла, и отличить это
+ * от честного нуля по выводу нельзя — число признаков стоит в той же строке, что и число
+ * расхождений, и читается как подробность. При переезде с редакции, где признаки лежали в самой
+ * проверке, настройка не заведена ещё ни у кого: первый же прогон после обновления врёт молча у
+ * всех потребителей сразу. Судится итог, а не список наборов: дерево, ведущее только свои
+ * признаки, наборов пакета не берёт законно.
  */
 export function loadSignals(config, root) {
     const declared = config.bundles ?? [];
@@ -67,5 +75,14 @@ export function loadSignals(config, root) {
         byKey.set(signal.key, signal);
     }
 
+    if (byKey.size === 0) {
+        const known = bundleNames().join(', ') || 'ни одного';
+        throw new Error(
+            `признаков не объявлено ни одного: ни набора в «reuse.bundles», ни своего файла признаков. ` +
+                `Проверка прошла бы, не прочитав ни одного файла, и зелёный ответ означал бы только это. ` +
+                `Наборы при пакете: ${known}; свои признаки называются полем «reuse.signals».`
+        );
+    }
+
     return [...byKey.values()];
 }

package/assets/checks/spec-proposed.mjs

@@ -0,0 +1,122 @@
+/**
+ * Договорённости, ждущие переезда в спек домена.
+ *
+ * Договорённость, по которой код уже написан, вливается в спек домена, а её директория
+ * удаляется. Оставленная в главной ветке, она читается как предложенное и не выкаченное — то
+ * есть как ложь о работающем месяц приложении.
+ *
+ * Второй вопрос к ней — возраст. Привязка в договорённости стареет молча: объявление, на которое
+ * она показывает, переезжает вместе с соседней работой, а сверять договорённость с кодом никто
+ * не станет, пока она не вольётся. Три такие пролежали месяц, и промах нашёлся ровно при
+ * вливании — то есть в тот час, когда чинить его дороже всего.
+ *
+ * Ни то, ни другое падением не делается: на середине работы часть тестов уже есть, а сама работа
+ * законно идёт неделями — красная сверка отбивала бы пуш каждой ветки, включая ту, которая
+ * договорённость и дописывает.
+ */
+import { execFileSync } from 'node:child_process';
+
+import { ROOT } from './rt-kit-checks.config.mjs';
+import { SPECS_DIR } from './spec-common.mjs';
+
+/** За сколько суток без правок договорённость считается залежавшейся. */
+const STALE_PROPOSED_DAYS = 30;
+
+/** Сутки в миллисекундах — считать возраст удобнее в них. */
+const DAY_MS = 24 * 60 * 60 * 1000;
+
+/**
+ * Каталоги договорённостей со счётом их сценариев.
+ *
+ * Готовой считается та, у которой все сценарии закрыты тестами: пока хоть один помечен «Не
+ * покрыто», фича не дописана.
+ */
+export function proposedGroups(scenarios, references) {
+    const proposed = new Map();
+
+    for (const scenario of scenarios) {
+        const at = scenario.file.indexOf('/proposed/');
+
+        if (at === -1) {
+            continue;
+        }
+
+        const dir = scenario.file.slice(0, scenario.file.indexOf('/', at + '/proposed/'.length));
+        const group = proposed.get(dir) ?? { total: 0, ready: 0 };
+        group.total += 1;
+
+        if (references.has(scenario.id) && !scenario.uncovered && !scenario.partial) {
+            group.ready += 1;
+        }
+
+        proposed.set(dir, group);
+    }
+
+    return proposed;
+}
+
+/**
+ * Дата последнего коммита у каждого каталога договорённости.
+ *
+ * Один проход по истории вместо вызова на каталог: лог идёт новыми вперёд, поэтому первая
+ * встреченная дата каталога и есть последняя. Каталог, которого в истории ещё нет, приехал этой
+ * же веткой и старым быть не может.
+ *
+ * Возраст меряется историей, а не временем файла на диске: свежий чекаут делает все каталоги
+ * одновременными, а дня в тексте договорённости нет вовсе. Тот же довод стоит у возраста записей
+ * описания прошлого.
+ */
+function lastCommits(dirs) {
+    if (dirs.length === 0) {
+        return new Map();
+    }
+
+    let log;
+
+    try {
+        log = execFileSync('git', ['log', '--format=%cI', '--name-only', '--', SPECS_DIR], {
+            cwd: ROOT,
+            encoding: 'utf8',
+            maxBuffer: 64 * 1024 * 1024,
+        });
+    } catch {
+        return new Map();
+    }
+
+    const dates = new Map();
+    let current = null;
+
+    for (const line of log.split('\n')) {
+        if (line === '') {
+            continue;
+        }
+
+        const dir = dirs.find((candidate) => line.startsWith(`${candidate}/`));
+
+        if (dir === undefined) {
+            current = line.includes('/') ? current : line;
+            continue;
+        }
+
+        if (current !== null && !dates.has(dir)) {
+            dates.set(dir, current);
+        }
+    }
+
+    return dates;
+}
+
+/** Договорённости, лежащие без правок дольше срока: путь и возраст в сутках, старые впереди. */
+export function staleProposed(dirs, now = Date.now()) {
+    const dates = lastCommits(dirs);
+
+    return dirs
+        .map((dir) => {
+            const committed = dates.get(dir);
+            const ageDays = committed === undefined ? 0 : (now - new Date(committed).getTime()) / DAY_MS;
+
+            return { dir, ageDays };
+        })
+        .filter((record) => record.ageDays > STALE_PROPOSED_DAYS)
+        .sort((one, other) => other.ageDays - one.ageDays);
+}

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

@@ -11,6 +11,9 @@
 #
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: помощник не назвал профиль — пропуск.
 
+# Своё имя в наблюдениях: отбой пишет общий хвост отказа, а не сам гард.
+RT_GUARD_NAME=browser-guard-device-id
+
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
 

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

@@ -14,6 +14,9 @@
 #
 # FAIL-OPEN when browser-device-id.sh prints nothing.
 
+# Своё имя в наблюдениях: отбой пишет общий хвост отказа, а не сам гард.
+RT_GUARD_NAME=browser-guard-no-asking
+
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
 

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

@@ -10,6 +10,9 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: помощник не назвал профиль — пропуск. Гард, который не может назвать
 # нужный профиль, ничего не предлагает взамен, и слепой отказ только заводил бы работу в тупик.
 
+# Своё имя в наблюдениях: отбой пишет общий хвост отказа, а не сам гард.
+RT_GUARD_NAME=browser-guard-no-listing
+
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
 
 cat >/dev/null 2>&1

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

@@ -19,6 +19,9 @@
 #
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: помощник не назвал профиль — пропуск.
 
+# Своё имя в наблюдениях: отбой пишет общий хвост отказа, а не сам гард.
+RT_GUARD_NAME=browser-guard-no-other-drivers
+
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
 

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

@@ -20,6 +20,9 @@
 #
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: помощник не назвал профиль — пропуск.
 
+# Своё имя в наблюдениях: отбой пишет общий хвост отказа, а не сам гард.
+RT_GUARD_NAME=browser-guard-require-select
+
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
 

package/assets/hooks/claim-guard.sh

@@ -31,6 +31,9 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: при любой ошибке, нехватке `jq`, отсутствии записи хода или пустом
 # тексте ход РАЗРЕШАЕТСЯ (exit 0). Сломанный гард не имеет права заклинить разговор.
 
+# Своё имя в наблюдениях: отбой пишет общий хвост отказа, а не сам гард.
+RT_GUARD_NAME=claim-guard
+
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
 

package/assets/hooks/conscience-guard.sh

@@ -19,6 +19,9 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: нет `jq`, нет записи хода, роль молчит или отвечает не по форме — ход
 # разрешается. Сломанная совесть не имеет права заклинить разговор.
 
+# Своё имя в наблюдениях: отбой пишет общий хвост отказа, а не сам гард.
+RT_GUARD_NAME=conscience-guard
+
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
 

package/assets/hooks/deny-tail.sh

@@ -16,6 +16,13 @@
 #
 # ЧЕГО ХВОСТ НЕ ДЕЛАЕТ. Он не судит, годится ли обход в этом случае: это решает владелец. И он не
 # заменяет причины отказа — она стоит перед ним и называет промах поимённо.
+#
+# ЗАПИСЬ ОТБОЯ ИДЁТ ОТСЮДА ЖЕ. Хвост — единственное место, через которое проходит каждый отказ:
+# правило дерева требует называть два законных хода при любом отказе, и гард, который отказывает
+# мимо хвоста, нарушает его раньше, чем теряет счёт. Написанная в самом гарде, запись стояла в
+# пяти гардах из тридцати, и сводка отвечала по этой пятой части. Гард объявляет себя строкой
+# `RT_GUARD_NAME=<имя>` у себя вверху; не объявивший не пишет ничего — так своё отбитие считает
+# сам гейт правил.
 
 # Хвост отказа строкой. Первый параметр — законная форма обхода, если она у отказа есть; пусто —
 # значит законной формы нет вовсе, и говорится об этом прямо.
@@ -23,6 +30,11 @@
 #   reason="BLOCKED: <причина>. $(rt_deny_tail 'строка `Docs-skip: <причина>` в теле коммита')"
 #   reason="BLOCKED: <причина>. $(rt_deny_tail)"
 rt_deny_tail() {
+    # shellcheck disable=SC1090
+    [ -f "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/guard-note.sh" ] \
+        && . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/guard-note.sh" 2>/dev/null
+    command -v rt_guard_note >/dev/null 2>&1 && rt_guard_note
+
     if [ -n "$1" ]; then
         printf 'Ходов отсюда два: починить названное и повторить вызов — либо принести владельцу цену обхода и ждать его слова. Законная форма обхода: %s. Молча мимо гарда правка не кладётся: он отбивает один вызов, а обойдённый снимает требование со всего дерева и молчит об этом.' "$1"
         return 0

package/assets/hooks/dev-server-guard.sh

@@ -14,6 +14,9 @@
 # Где именно подняты приложения, знает профиль проекта: .claude/rt-kit/project.sh, переменная
 # RT_STANDS. Нет профиля — текст отказа остаётся общим, сам гард работает.
 
+# Своё имя в наблюдениях: отбой пишет общий хвост отказа, а не сам гард.
+RT_GUARD_NAME=dev-server-guard
+
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
 

package/assets/hooks/docs-guard.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse Edit|Write|MultiEdit|NotebookEdit|Bash|mcp__webstorm__create_new_file|mcp__webstorm__execute_terminal_command|mcp__webstorm__execute_tool
-# Требует: hooks/profile-check.sh, hooks/deny-tail.sh
+# Требует: hooks/profile-check.sh, hooks/deny-tail.sh, hooks/guard-note.sh
 # Гард пары «правка и её документ». PreToolUse.
 #
 # Расхождение кода с текстом беззвучно. Ни линтер, ни сборка, ни тесты не читают правила,
@@ -26,6 +26,9 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: не репозиторий, нет разборщика, битый ввод, пустой список файлов —
 # пропуск.
 
+# Своё имя в наблюдениях: отбой пишет общий хвост отказа, а не сам гард.
+RT_GUARD_NAME=docs-guard
+
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
 
@@ -37,16 +40,6 @@ command -v jq >/dev/null 2>&1 || exit 0
 tool="$(rt_hook_tool)"
 
 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
-
     reason="$2"
     if [ "$1" = "deny" ]; then
         # shellcheck disable=SC1090

package/assets/hooks/exam-guard.sh

@@ -33,6 +33,9 @@
 # FAIL-OPEN: нет jq, нет записи хода, чужой инструмент → пропуск. Сломанный гард не должен
 # мешать работать.
 
+# Своё имя в наблюдениях: отбой пишет общий хвост отказа, а не сам гард.
+RT_GUARD_NAME=exam-guard
+
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
 

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

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse Bash|mcp__webstorm__execute_terminal_command|mcp__webstorm__execute_tool
-# Требует: hooks/git-guard-delivery-folder.sh, hooks/git-guard-delivery-conflict.sh, hooks/profile-check.sh, hooks/deny-tail.sh
+# Требует: hooks/git-guard-delivery-folder.sh, hooks/git-guard-delivery-conflict.sh, hooks/profile-check.sh, hooks/deny-tail.sh, hooks/guard-note.sh
 # Гард поставки. PreToolUse на заведении ветки, пуше и открытии заявки на слияние.
 #
 # Закон о поставке требует трёх вещей, которых обычно не проверяет ничто: правка начинается с
@@ -39,6 +39,9 @@
 #
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: не репозиторий, нет разборщика, битый ввод, нет профиля — пропуск.
 
+# Своё имя в наблюдениях: отбой пишет общий хвост отказа, а не сам гард.
+RT_GUARD_NAME=git-guard-delivery
+
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
 
@@ -131,9 +134,6 @@ folder_skip_re='(^|#)[[:space:]]*Task-folder-skip:[[:space:]]*[^[:space:]<"'"'"'
 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"
 
     # Хвост отказа: два законных хода и форма обхода вторым параметром.
     # shellcheck disable=SC1090

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

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 # rt-hook: PreToolUse Bash|mcp__webstorm__execute_terminal_command|mcp__webstorm__execute_tool
-# Требует: hooks/deny-tail.sh
+# Требует: hooks/deny-tail.sh, hooks/guard-note.sh
 # Гард главной ветки. PreToolUse на вызове коммита.
 #
 # Коммит в главную ветку минует ветку, PR и разбор, а поставка построена на них целиком —
@@ -13,6 +13,9 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: не репозиторий, нет гита, открепившийся HEAD, битый ввод — пропуск.
 # Сломанный гард не должен мешать работать.
 
+# Своё имя в наблюдениях: отбой пишет общий хвост отказа, а не сам гард.
+RT_GUARD_NAME=git-guard-main
+
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
 
@@ -72,14 +75,6 @@ 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)"
-
 # Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть.
 # Файл может быть не разложен — тогда хвоста нет, а причина отказа остаётся прежней.
 # shellcheck disable=SC1090

package/assets/hooks/git-guard-push-tests.sh

@@ -25,6 +25,9 @@
 #
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: не репозиторий, битый ввод, нет профиля — пропуск.
 
+# Своё имя в наблюдениях: отбой пишет общий хвост отказа, а не сам гард.
+RT_GUARD_NAME=git-guard-push-tests
+
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
 

package/assets/hooks/grill-gate.sh

@@ -33,6 +33,9 @@
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: при любой ошибке, отсутствии записи хода и повторном заходе ход
 # РАЗРЕШАЕТСЯ (exit 0). Сломанный гард не имеет права заклинить разговор.
 
+# Своё имя в наблюдениях: отбой пишет общий хвост отказа, а не сам гард.
+RT_GUARD_NAME=grill-gate
+
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
 

package/assets/hooks/guard-note.sh

@@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+# Запись отбоя гарда. НЕ гард: объявления `rt-hook:` у него нет, к событиям агента он не
+# подключается. Его источает общий хвост отказа — единственное место, через которое проходит
+# каждый отказ.
+#
+# Зачем он есть. Запись отбоя стояла в самом гарде пятью строками: подключение записи, проверка
+# наличия функции, вызов с именем и признаком сессии. Написать их в каждом гарде не вышло — из
+# тридцати их написали в пяти, и сводка наблюдений отвечала по этой пятой части: гард, который
+# отбивать умеет, а записывать нет, не значится в ней ни отбивавшим, ни молчащим, и вопрос «стоял
+# и не работал» по нему не задать вовсе.
+#
+# КАК ГАРД ЗАЯВЛЯЕТ О СЕБЕ. Одной строкой `RT_GUARD_NAME=<имя>` у себя вверху. Заявка добровольна
+# и точна: хук, который своё отбитие считает сам — как гейт правил, — её не ставит, и второй раз
+# то же событие в счёт не идёт.
+#
+# ЧТО ЗАПИСЫВАЕТСЯ. Имя гарда и признак сессии. Чистит значения и решает, писать ли вообще, сама
+# запись наблюдений; здесь только сборка вызова.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ. Записи может не быть вовсе — файла нет, дерево выключило наблюдения,
+# каталог недоступен. Гард, упавший на записи отбоя, останавливал бы работу ради статистики.
+
+# Отбой гарда в наблюдения. Имя берётся из `RT_GUARD_NAME`, признак сессии — из ввода хука;
+# без имени не пишется ничего.
+rt_guard_note() {
+    local rt_gn_dir rt_gn_sid rt_gn_name
+    # Умолчание, а не голое чтение: гард бывает написан с обрывом на необъявленной переменной, и
+    # запись, читающая её голой, роняет такой гард целиком — на каждом вызове, а не на отказе.
+    rt_gn_name="${RT_GUARD_NAME:-}"
+    [ -n "$rt_gn_name" ] || return 0
+
+    rt_gn_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+    # shellcheck disable=SC1090
+    [ -f "$rt_gn_dir/observe.sh" ] && . "$rt_gn_dir/observe.sh" 2>/dev/null
+    command -v rt_note >/dev/null 2>&1 || return 0
+
+    rt_gn_sid="$(printf '%s' "${RT_HOOK_INPUT:-}" | jq -r '.session_id // empty' 2>/dev/null)"
+
+    if [ -n "$rt_gn_sid" ]; then
+        rt_note guard-deny "res=$rt_gn_name" "sid=$rt_gn_sid"
+    else
+        rt_note guard-deny "res=$rt_gn_name"
+    fi
+
+    return 0
+}

package/assets/hooks/handoff-entry-guard.sh

@@ -14,6 +14,9 @@
 #
 # FAIL-OPEN: нет `jq`, нет записи хода, передачи в реплике нет → пропуск.
 
+# Своё имя в наблюдениях: отбой пишет общий хвост отказа, а не сам гард.
+RT_GUARD_NAME=handoff-entry-guard
+
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
 . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true