@rt-tools/agent-kit 0.7.0 → 0.8.1

package/assets/checks/check-reuse.mjs

@@ -8,11 +8,13 @@
  * видно ни одному из них. Эта проверка отвечает на другой вопрос — «а сколько такого в
  * дереве сейчас», — и потому смотрит на файл целиком, а не на правку.
  *
- * Признаки те же, что у гарда, и берутся оттуда же: расходиться им нельзя, иначе правка
- * проходит гард и падает на гейте. Отличий два. Первое: инвентарь кита не читается — гард
- * спрашивает диск, потому что отвечает одной правке, а сплошной проверке важно накопленное,
- * и пропавший пакет молча обнулял бы сводку. Второе: маркер `native-ok` снимает свою
- * строку, а не весь файл.
+ * Признаки не лежат здесь: они объявлены наборами по пакетам rt-tools, и дерево называет в
+ * настройке проверок те, что берёт. Тот же список читает гард — расходиться им нельзя, иначе
+ * правка проходит гард и падает на гейте. Свои признаки дерево дописывает своим файлом.
+ *
+ * Отличий от гарда два. Первое: инвентарь кита не читается — гард спрашивает диск, потому что
+ * отвечает одной правке, а сплошной проверке важно накопленное, и пропавший пакет молча
+ * обнулял бы сводку. Второе: маркер `native-ok` снимает свою строку и следующую, а не весь файл.
  *
  * Накопленное к моменту заведения проверки лежит в tools/reuse-allowlist.json и отказом не
  * считается: гейт падает на новом расхождении, а старое остаётся видимым числом в сводке.
@@ -24,109 +26,40 @@ import { readFileSync, readdirSync } from 'node:fs';
 import { join } from 'node:path';
 
 import { allowlistOf, CONFIG, ROOT } from './rt-kit-checks.config.mjs';
+import { loadSignals } from './signals.mjs';
 
 const ALLOWLIST = allowlistOf('reuse');
 const SOURCE_ROOTS = CONFIG.sourceRoots;
 const SKIPPED_DIRS = CONFIG.skippedDirs;
 const BACKEND_ROOTS = CONFIG.backendRoots;
 
-/**
- * Признак расхождения: чем он виден в тексте и на что готовое его меняет. Порядок строк —
- * порядок в сводке, поэтому родственные признаки стоят рядом.
- */
-const SIGNALS = [
-    {
-        key: 'input',
-        ext: '.html',
-        find: (text) => count(text, /<input\b/g),
-        instead: 'rt-input / rt-input-number / rt-checkbox / rt-file-input',
-    },
-    { key: 'textarea', ext: '.html', find: (text) => count(text, /<textarea\b/g), instead: 'rt-textarea' },
-    { key: 'select', ext: '.html', find: (text) => count(text, /<select\b/g), instead: 'rt-select / rt-multiselect' },
-    {
-        key: 'button',
-        ext: '.html',
-        find: (text) => count(withoutKitButtons(text), /<button\b/g),
-        instead: 'button[rtButton] / rt-icon-button',
-    },
-    { key: 'table', ext: '.html', find: (text) => count(text, /<table\b/g), instead: 'rt-table' },
-    { key: 'dialog', ext: '.html', find: (text) => count(text, /<dialog\b/g), instead: 'rt-dialog' },
-    { key: 'alert', ext: '.html', find: (text) => count(text, /role="alert"/g), instead: 'rt-message' },
-
-    { key: 'overlay', ext: '.scss', find: fullScreenOverlays, instead: 'rt-dialog / rt-aside / rt-bottom-sheet' },
-    {
-        key: 'backdrop',
-        ext: '.scss',
-        find: (text) => count(text, /backdrop-filter|background(-color)?: *(rgba\( *0 *, *0 *, *0|rgb\( *0 +0 +0)/g),
-        instead: 'backdrop рисует rt-dialog',
-    },
-    { key: 'z-index', ext: '.scss', find: (text) => count(text, /z-index: *\d{4,}/g), instead: 'слой оверлеев кита уже выше' },
-    { key: 'spin', ext: '.scss', find: (text) => count(text, /@keyframes[^{]*(spin|rotate|loading)/g), instead: 'rt-spinner' },
-    {
-        key: 'shimmer',
-        ext: '.scss',
-        find: (text) => count(text, /@keyframes[^{]*(shimmer|skeleton|pulse)/g),
-        instead: 'rt-skeleton / rt-skeleton-wrapper',
-    },
-
-    { key: 'inline-template', ext: '.component.ts', find: (text) => count(text, /^ *template: *['"`]/gm), instead: 'шаблон в своём .html' },
-    // Список стилей открывается своей строкой, а строка с кавычкой идёт следующей
-    {
-        key: 'inline-styles',
-        ext: '.component.ts',
-        find: (text) => count(text, /^ *styles: *(\[\s*)?['"`\n]/gm),
-        instead: 'стили в своём .scss',
-    },
-    {
-        key: 'value-accessor',
-        ext: '.component.ts',
-        find: (text) => (/ControlValueAccessor|NG_VALUE_ACCESSOR/.test(text) && !/extends VmFormControlBase/.test(text) ? 1 : 0),
-        instead: 'VmFormControlBase',
-    },
-    {
-        key: 'mapper-base',
-        ext: '.mapper.ts',
-        // На бэкенде перевод сущности написан свободными функциями — это долг `Q-S-1`,
-        // а не место для этой проверки. Где лежит бэкенд, знает настройка дерева: зашитый здесь
-        // корень молча проверял бы фронтовым мерилом чужой код у всякого, кто держит его иначе.
-        skip: (path) => BACKEND_ROOTS.some((root) => path.startsWith(root)),
-        find: (text) => (/class +[A-Za-z0-9_]+Mapper/.test(text) && !/extends BaseMapper/.test(text) ? 1 : 0),
-        instead: 'BaseMapper и this.typeCast',
-    },
-    {
-        key: 'procedure-mark',
-        ext: '.procedure.ts',
-        find: (text) => (/export class/.test(text) && !/@ConnectProcedure/.test(text) ? 1 : 0),
-        instead: '@ConnectProcedure()',
-    },
-    {
-        key: 'aside-base',
-        ext: '.component.ts',
-        onlyNamed: /aside[^/]*\.component\.ts$/,
-        find: (text) => (/export class/.test(text) && !/extends VmRouteAsideComponent/.test(text) ? 1 : 0),
-        instead: 'VmRouteAsideComponent',
-    },
-];
+const SIGNALS = loadSignals(CONFIG.reuse ?? {}, ROOT);
 
 function count(text, expression) {
     return [...text.matchAll(expression)].length;
 }
 
-/** `button[rtButton]` — предписанный вариант, а подстрока `<button` у него та же */
-function withoutKitButtons(text) {
-    return text.replace(/<button\b[^>]*rtButton[^>]*>/gs, '');
-}
-
-/** Хост, растянутый на весь экран: `inset: 0` либо все четыре стороны в нуле */
-function fullScreenOverlays(text) {
-    if (!/position: *fixed/.test(text)) {
+/**
+ * Сколько раз признак виден в тексте.
+ *
+ * `strip` вычёркивает предписанный вариант до счёта: у кнопки кита та же подстрока `<button`, и
+ * без вычёркивания она считалась бы нарушением сама по себе. `all` требует совпадения всех
+ * образцов разом — так описан хост, растянутый на весь экран. `cancel` гасит признак целиком:
+ * основа уже унаследована, готовое уже позвано.
+ */
+function found(signal, text) {
+    const body = signal.strip ? text.replace(new RegExp(signal.strip, 'gs'), '') : text;
+    if (signal.cancel && new RegExp(signal.cancel).test(body)) {
+        return 0;
+    }
+    if (signal.all?.some((one) => !new RegExp(one).test(body))) {
         return 0;
     }
-    const stretched =
-        /inset: *0/.test(text) ||
-        (/(^|[^-])top: *0/.test(text) && /left: *0/.test(text) && /right: *0/.test(text) && /bottom: *0/.test(text));
+    if (signal.mode === 'presence') {
+        return new RegExp(signal.find).test(body) ? 1 : 0;
+    }
 
-    return stretched ? 1 : 0;
+    return count(body, new RegExp(signal.find, signal.flags ?? 'g'));
 }
 
 function collectFiles(dir) {
@@ -152,14 +85,16 @@ function judged(path) {
 }
 
 /**
- * Строка с маркером — осознанное отступление, названное автором. Снимается только она сама:
- * весь файл маркер не гасит, иначе один разрешённый случай прикрывал бы соседние.
+ * Маркер — осознанное отступление, названное автором. Снимается строка, где он стоит, и та, что
+ * идёт следом: в разметке маркер ставится комментарием над кодом, потому что форматировщик
+ * разносит длинный тег по строкам и уводит первый атрибут со строки имени тега — признак считает
+ * имя тега, а маркер оказывается ниже. Дальше следующей строки маркер не достаёт: весь файл он
+ * не гасит, иначе один разрешённый случай прикрывал бы соседние.
  */
 function withoutMarked(text) {
-    return text
-        .split('\n')
-        .filter((line) => !line.includes('native-ok'))
-        .join('\n');
+    const lines = text.split('\n');
+
+    return lines.filter((line, index) => !line.includes('native-ok') && !lines[index - 1]?.includes('native-ok')).join('\n');
 }
 
 const allowlist = JSON.parse(readFileSync(join(ROOT, ALLOWLIST), 'utf8'));
@@ -171,12 +106,13 @@ for (const root of SOURCE_ROOTS) {
     for (const path of collectFiles(root).filter(judged).sort()) {
         const text = withoutMarked(readFileSync(join(ROOT, path), 'utf8'));
         for (const signal of SIGNALS) {
-            if (!path.endsWith(signal.ext) || signal.skip?.(path) || (signal.onlyNamed && !signal.onlyNamed.test(path))) {
+            const skipped = signal.skipBackendRoots && BACKEND_ROOTS.some((root) => path.startsWith(root));
+            if (!path.endsWith(signal.ext) || skipped || (signal.onlyNamed && !new RegExp(signal.onlyNamed).test(path))) {
                 continue;
             }
-            const found = signal.find(text);
-            if (found > 0) {
-                findings.push({ key: `${signal.key} ×${found} @ ${path}`, instead: signal.instead });
+            const times = found(signal, text);
+            if (times > 0) {
+                findings.push({ key: `${signal.key} ×${times} @ ${path}`, instead: signal.instead });
             }
         }
     }

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

@@ -48,6 +48,14 @@ const DEFAULTS = {
      * вносится только исходник. Пусто — переносимых текстов дерево не держит.
      */
     portableDirs: [],
+    /**
+     * Признаки единообразия: какие наборы дерево берёт и где лежат его собственные.
+     *
+     * Наборы режутся по пакетам, чьё готовое они называют, и дерево объявляет только те, что
+     * ставит: признак о готовом из пакета, которого в дереве нет, отвечает ложно. Пусто —
+     * признаков нет вовсе, и гард с проверкой об этом говорят, а не молчат.
+     */
+    reuse: { bundles: [], signals: '' },
     /** Где лежат спеки доменов; пусто — их в дереве нет, и сверка спеков не запускается. */
     specsDir: 'docs/specs',
     tasksDir: 'docs/tasks',

package/assets/checks/signals/angular.json

@@ -0,0 +1,19 @@
+{
+    "about": "Признаки самого фреймворка: ничьих имён не называют и верны любому дереву на Angular.",
+    "signals": [
+        { "key": "inline-template", "ext": ".component.ts", "find": "^ *template: *['\"`]", "flags": "gm", "instead": "шаблон в своём .html" },
+        {
+            "key": "inline-styles",
+            "ext": ".component.ts",
+            "find": "^ *styles: *(\\[\\s*)?['\"`\\n]",
+            "flags": "gm",
+            "instead": "стили в своём .scss"
+        },
+        {
+            "key": "decorator-io",
+            "ext": ".ts",
+            "find": "@(Input|Output|ViewChild|ViewChildren|ContentChild)\\(",
+            "instead": "input(), output(), viewChild(), contentChild()"
+        }
+    ]
+}

package/assets/checks/signals/core.json

@@ -0,0 +1,19 @@
+{
+  "about": "Признаки пакета @rt-tools/core: директивы BEM, доступ к среде и хранилищу браузера.",
+  "signals": [
+    { "key": "class-binding", "ext": ".html", "find": "\\[ngClass\\]|\\[class\\.", "instead": "директивы rtBlock, rtElem, [rtMod]" },
+    {
+      "key": "raw-storage",
+      "ext": ".ts",
+      "find": "(window\\.)?(local|session)Storage\\.",
+      "instead": "службы хранилища @rt-tools/core"
+    },
+    { "key": "raw-media-query", "ext": ".ts", "find": "matchMedia\\(", "instead": "BreakpointsService" },
+    {
+      "key": "raw-window",
+      "ext": ".ts",
+      "find": "(^|[^.\\w])(window|document)\\.",
+      "instead": "PlatformService и токены среды @rt-tools/core"
+    }
+  ]
+}

package/assets/checks/signals/store.json

@@ -0,0 +1,14 @@
+{
+  "about": "Признаки пакета @rt-tools/store: своё хранилище состояния вместо базового.",
+  "signals": [
+    {
+      "key": "store-base",
+      "ext": ".service.ts",
+      "mode": "presence",
+      "scope": "whole",
+      "find": "new BehaviorSubject|private +readonly +state *=",
+      "cancel": "extends +Base(Async)?StoreService",
+      "instead": "BaseStoreService / BaseAsyncStoreService"
+    }
+  ]
+}

package/assets/checks/signals/ui-kit-v2.json

@@ -0,0 +1,48 @@
+{
+  "about": "Признаки пакета @rt-tools/ui-kit-v2: нативный контрол там, где кит везёт свой.",
+  "signals": [
+    { "key": "input", "ext": ".html", "find": "<input\\b", "instead": "rt-input / rt-input-number / rt-file-input / rt-checkbox" },
+    { "key": "textarea", "ext": ".html", "find": "<textarea\\b", "instead": "rt-textarea" },
+    { "key": "select", "ext": ".html", "find": "<select\\b", "instead": "rt-select / rt-multiselect" },
+    {
+      "key": "button",
+      "ext": ".html",
+      "strip": "<button\\b[^>]*rtButton[^>]*>",
+      "find": "<button\\b",
+      "instead": "button[rtButton] / rt-icon-button / rt-split-button"
+    },
+    { "key": "table", "ext": ".html", "find": "<table\\b", "instead": "rt-table" },
+    { "key": "dialog", "ext": ".html", "find": "<dialog\\b", "instead": "rt-dialog" },
+    { "key": "alert", "ext": ".html", "find": "role=\"alert\"", "instead": "rt-message / rt-toast" },
+    {
+      "key": "overlay-inset",
+      "ext": ".scss",
+      "mode": "presence",
+      "find": "position: *fixed",
+      "all": ["inset: *0"],
+      "instead": "rt-dialog / rt-aside / rt-bottom-sheet"
+    },
+    {
+      "key": "overlay-sides",
+      "ext": ".scss",
+      "mode": "presence",
+      "find": "position: *fixed",
+      "all": ["(^|[^-])top: *0", "left: *0", "right: *0", "bottom: *0"],
+      "instead": "rt-dialog / rt-aside / rt-bottom-sheet"
+    },
+    {
+      "key": "backdrop",
+      "ext": ".scss",
+      "find": "backdrop-filter|background(-color)?: *(rgba\\( *0 *, *0 *, *0|rgb\\( *0 +0 +0)",
+      "instead": "подложку рисует rt-dialog"
+    },
+    { "key": "z-index", "ext": ".scss", "find": "z-index: *\\d{4,}", "instead": "слой перекрытий кита уже выше" },
+    { "key": "spin", "ext": ".scss", "find": "@keyframes[^{]*(spin|rotate|loading)", "instead": "rt-spinner" },
+    {
+      "key": "shimmer",
+      "ext": ".scss",
+      "find": "@keyframes[^{]*(shimmer|skeleton|pulse)",
+      "instead": "rt-skeleton / rt-skeleton-wrapper"
+    }
+  ]
+}

package/assets/checks/signals/ui-kit.json

@@ -0,0 +1,11 @@
+{
+  "about": "Признаки пакета @rt-tools/ui-kit: нативный контрол там, где кит везёт свой.",
+  "signals": [
+    { "key": "input", "ext": ".html", "find": "<input\\b", "instead": "rtui-dynamic-input / rtui-checkbox / rtui-toggle" },
+    { "key": "button", "ext": ".html", "find": "<button\\b", "instead": "rtui-button / rtui-multi-button" },
+    { "key": "table", "ext": ".html", "find": "<table\\b", "instead": "rtui-table / rtui-table-container" },
+    { "key": "dialog", "ext": ".html", "find": "<dialog\\b", "instead": "rtui-modal / rtui-aside-panel" },
+    { "key": "alert", "ext": ".html", "find": "role=\"alert\"", "instead": "rtui-snack-bar / rtui-info-badge" },
+    { "key": "spin", "ext": ".scss", "find": "@keyframes[^{]*(spin|rotate|loading)", "instead": "rtui-spinner" }
+  ]
+}

package/assets/checks/signals/utils.json

@@ -0,0 +1,15 @@
+{
+  "about": "Признаки пакета @rt-tools/utils: основа перевода сущности и приведение типов.",
+  "signals": [
+    {
+      "key": "mapper-base",
+      "ext": ".mapper.ts",
+      "mode": "presence",
+      "scope": "whole",
+      "skipBackendRoots": true,
+      "find": "class +[A-Za-z0-9_]+Mapper",
+      "cancel": "extends +BaseMapper",
+      "instead": "BaseMapper и this.typeCast"
+    }
+  ]
+}

package/assets/checks/signals.mjs

@@ -0,0 +1,71 @@
+/**
+ * Наборы признаков единообразия: что дерево объявило своим и что при этом читается.
+ *
+ * Признак не лежит в коде проверки. Пакет режет признаки по своим пакетам — у кита свои, у
+ * хранилища свои, — а дерево называет в настройке проверок те, что берёт. Набор, который дерево
+ * не назвало, не читается вовсе: признак о готовом из пакета, которого в дереве нет, отвечает
+ * ложно ровно так же, как имя чужого приложения.
+ *
+ * Тот же список читает гард на правке. Общий файл — единственное, чем гард на оболочке и
+ * проверка на JS могут быть связаны: расходиться им нельзя, иначе правка проходит гард и падает
+ * на гейте.
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+/** Наборы лежат рядом с этим файлом: он и сам ресурс пакета, и раскладывается вместе с ними. */
+export const BUNDLES_DIR = join(dirname(fileURLToPath(import.meta.url)), 'signals');
+
+export function bundleNames() {
+    if (!existsSync(BUNDLES_DIR)) {
+        return [];
+    }
+
+    return readdirSync(BUNDLES_DIR)
+        .filter((name) => name.endsWith('.json'))
+        .map((name) => name.slice(0, -'.json'.length))
+        .sort();
+}
+
+/**
+ * Разбор набора: шапка раскладки снимается до JSON.
+ *
+ * Раскладка ставит её первой строкой и комментирует незнакомое расширение решёткой — в JSON
+ * комментария нет, и без снятия разбор падает на первом же символе.
+ */
+function parseSignals(text) {
+    return JSON.parse(text.replace(/^#[^\n]*\n/, '')).signals ?? [];
+}
+
+function readBundle(name) {
+    const path = join(BUNDLES_DIR, `${name}.json`);
+    if (!existsSync(path)) {
+        const known = bundleNames().join(', ') || 'ни одного';
+        throw new Error(`набор признаков «${name}» при пакете не найден; есть: ${known}`);
+    }
+
+    return parseSignals(readFileSync(path, 'utf8'));
+}
+
+/**
+ * Признаки объявленных наборов, а поверх них — свои признаки дерева.
+ *
+ * Совпавший ключ замещает пакетный: дерево вправе сказать о своём готовом точнее, чем пакет,
+ * который его не видел. Файла своих признаков может не быть — это не отказ: пропуск дешевле
+ * остановки работы, и объявляют его раньше, чем заводят.
+ */
+export function loadSignals(config, root) {
+    const declared = config.bundles ?? [];
+    const signals = declared.flatMap(readBundle);
+
+    const ownPath = config.signals ? join(root, config.signals) : null;
+    const own = ownPath && existsSync(ownPath) ? parseSignals(readFileSync(ownPath, 'utf8')) : [];
+
+    const byKey = new Map(signals.map((signal) => [signal.key, signal]));
+    for (const signal of own) {
+        byKey.set(signal.key, signal);
+    }
+
+    return [...byKey.values()];
+}

package/assets/defaults/project.sh

@@ -220,20 +220,22 @@ rt_task_state_default() {
 # Образцы узкие намеренно: гард сверяет только НОВЫЙ текст, и широкий образец отбивал бы
 # правку, которая ничего нового не заводит.
 rt_reinvented_in_default() {
+    # Четыре поля через табуляцию: над чем, образец, образец отмены, чем заменить. Пустое поле
+    # пишется пустым — их читают по одному, и схлопывание третьего уносило совет в отмену.
     case "$1" in
         *.ts)
-            printf '%s\t%s\n' '@(Input|Output|ViewChild|ViewChildren|ContentChild)\(' 'input(), output(), viewChild(), contentChild() — реактивный вход и выход'
-            printf '%s\t%s\n' 'get [a-zA-Z]+\(\)[[:space:]]*(:|\{)' 'computed(): производное значение сигналом, а не геттером'
-            ;;
-        *.html)
-            printf '%s\t%s\n' '\[ngClass\]|\[class\.' 'директивы класса кита'
+            printf '%s\t%s\t%s\t%s\n' 'added' 'get [a-zA-Z]+\(\)[[:space:]]*(:|\{)' '' 'computed(): производное значение сигналом, а не геттером'
             ;;
         *.scss)
-            printf '%s\t%s\n' '#[0-9a-fA-F]{3}([0-9a-fA-F]{3})?\b' 'токен оформления вместо записанного цвета'
+            printf '%s\t%s\t%s\t%s\n' 'added' '#[0-9a-fA-F]{3}([0-9a-fA-F]{3})?\b' '' 'токен оформления вместо записанного цвета'
             ;;
     esac
 }
 
+# Где лежат наборы признаков единообразия — они раскладываются рядом с проверками, а раскладка
+# проверок у каждого дерева своя. Читают их и гард на правке, и сплошная сверка.
+RT_REUSE_SIGNALS_DIR="${RT_REUSE_SIGNALS_DIR:-tools/signals}"
+
 # Где якорь для спек не требуется. Витрина, корневая разметка и сборка — общее у всех деревьев;
 # своё дерево дописывает надстройкой.
 RT_QA_SKIP_RE="${RT_QA_SKIP_RE:-/node_modules/|/dist/|\.stories\.html\$|/src/index\.html\$}"

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

@@ -132,8 +132,90 @@ has_re() {
     printf '%s' "$1" | RT_RE="$2" perl -0777 -ne 'exit(/$ENV{RT_RE}/s ? 0 : 1)' 2>/dev/null
 }
 
+# Что дерево объявило своим: наборы признаков и файл собственных. Настройка проверок — та же,
+# что читает сплошная проверка; каталог наборов называет профиль дерева, потому что раскладка
+# проверок у каждого дерева своя.
+rt_checks_json="${CLAUDE_PROJECT_DIR:-.}/.claude/rt-kit/checks.json"
+rt_bundles=''
+rt_own_signals=''
+if [ -f "$rt_checks_json" ]; then
+    rt_bundles="$(jq -r '.reuse.bundles[]? // empty' "$rt_checks_json" 2>/dev/null | tr '\n' ' ')"
+    own="$(jq -r '.reuse.signals // empty' "$rt_checks_json" 2>/dev/null)"
+    [ -n "$own" ] && rt_own_signals="${CLAUDE_PROJECT_DIR:-.}/$own"
+fi
+rt_signals_dir="${CLAUDE_PROJECT_DIR:-.}/${RT_REUSE_SIGNALS_DIR:-tools/signals}"
+
+# Признаки объявленных наборов: те же файлы читает сплошная проверка. Ключ признака совпал с
+# ключом дерева — побеждает дерево: оно видит своё готовое, а пакет его не видел.
+signals_json() {
+    [ -n "$rt_signals_dir" ] || return 0
+    [ -d "$rt_signals_dir" ] || return 0
+    # Шапка раскладки снимается до разбора: в JSON комментария нет, и с ней разбор падает.
+    for name in $rt_bundles; do
+        file="$rt_signals_dir/$name.json"
+        [ -f "$file" ] && grep -v '^# rt-kit ' "$file" | jq -c '.signals[]?' 2>/dev/null
+    done
+    [ -n "$rt_own_signals" ] && [ -f "$rt_own_signals" ] && grep -v '^# rt-kit ' "$rt_own_signals" | jq -c '.signals[]?' 2>/dev/null
+}
+
+# Поля читаются по одному, а не разбором строки: таб в `IFS` — пробельный разделитель, и пустое
+# поле в середине схлопывается, из-за чего совет уезжает в образец отмены и гасит признак молча.
+field() { printf '%s' "$1" | jq -r "$2 // empty" 2>/dev/null; }
+
 found=''
-while IFS="$(printf '\t')" read -r scope pattern cancel replacement; do
+signals_seen=0
+while IFS= read -r signal; do
+    [ -z "$signal" ] && continue
+    signals_seen=1
+    ext="$(field "$signal" '.ext')"
+    case "$ext" in
+        '') ;;
+        *) case "$path" in *"$ext") ;; *) continue ;; esac ;;
+    esac
+    only_named="$(field "$signal" '.onlyNamed')"
+    if [ -n "$only_named" ]; then
+        printf '%s' "${path##*/}" | grep -qE "$only_named" || continue
+    fi
+
+    case "$(field "$signal" '.scope')" in
+        whole) text="$whole" ;;
+        *) text="$added" ;;
+    esac
+
+    pattern="$(field "$signal" '.find')"
+    [ -z "$pattern" ] && continue
+    strip="$(field "$signal" '.strip')"
+    [ -n "$strip" ] && text="$(printf '%s' "$text" | RT_RE="$strip" perl -0777 -pe 's/$ENV{RT_RE}//gs' 2>/dev/null)"
+
+    has_re "$text" "$pattern" || continue
+
+    cancel="$(field "$signal" '.cancel')"
+    [ -n "$cancel" ] && has_re "$text" "$cancel" && continue
+
+    skip_signal=''
+    while IFS= read -r one; do
+        [ -z "$one" ] && continue
+        has_re "$text" "$one" || skip_signal=1
+    done <<ALL
+$(printf '%s' "$signal" | jq -r '.all[]? // empty' 2>/dev/null)
+ALL
+    [ -n "$skip_signal" ] && continue
+
+    found="${found}
+  - $(field "$signal" '.instead')"
+done <<EOF
+$(signals_json | jq -s -c 'reduce .[] as $one ({}; .[$one.key] = $one) | .[]' 2>/dev/null)
+EOF
+
+# Функция профиля остаётся вторым источником: деревья её уже написали. Поля читаются построчно,
+# по тем же четырём колонкам, что объявлены выше.
+while IFS= read -r line; do
+    [ -z "$line" ] && continue
+    signals_seen=1
+    scope="$(printf '%s' "$line" | cut -f1)"
+    pattern="$(printf '%s' "$line" | cut -f2)"
+    cancel="$(printf '%s' "$line" | cut -f3)"
+    replacement="$(printf '%s' "$line" | cut -f4)"
     [ -z "$pattern" ] && continue
     case "$scope" in
         whole) text="$whole" ;;
@@ -147,6 +229,13 @@ done <<EOF
 $(rt_reinvented_in "$path" 2>/dev/null)
 EOF
 
+# Гард без единого признака неотличим от гарда, которому нечего отбивать. Правку он пропускает —
+# останавливать работу за ненастроенное дерево не за что, — но говорит, чем это настраивается.
+if [ "$signals_seen" = 0 ]; then
+    printf '%s\n' 'reuse-first-guard: признаков нет — объявите наборы ключом `reuse.bundles` в настройке проверок' >&2
+    exit 0
+fi
+
 [ -z "$found" ] && exit 0
 
 reason="BLOCKED: это уже написано. Файл: ${path##*/}

package/assets/patterns/reuse-first-extend.md

@@ -45,6 +45,36 @@ grep -rn "<похожий приём>" libs/admin libs/site --include='*.html' |
 Спрашивается до того, как написан первый файл. То же относится к своей базе и к своему
 инлайновому стилю.
 
+## Своё готовое объявляется признаком
+
+Заведённое с одобрения владельца видит только тот, кто о нём знает. Чтобы следующий его не
+обошёл, дерево дописывает признак в свой файл признаков — тот, что назван ключом
+`reuse.signals` в настройке проверок:
+
+```json
+{
+    "key": "<короткое имя признака>",
+    "ext": ".ts",
+    "mode": "presence",
+    "scope": "whole",
+    "find": "implements +<интерфейс, который закрывает основа>",
+    "cancel": "extends +<основа>",
+    "instead": "<основа> — она уже держит <что именно>"
+}
+```
+
+Область объявляется явно. `whole` читает правку вместе с содержимым файла и берётся там, где
+признак судит устройство класса: наследование и метка объявлены один раз и в точечную правку не
+попадают, поэтому признак без `whole` молчит всегда. `added` читает только добавленный текст и
+берётся там, где признак судит саму строку — сырой тег, свой стиль.
+
+Отмена `cancel` обязательна везде, где готовое можно позвать законно: без неё признак отбивает и
+того, кто основу уже унаследовал. Пустой её не оставляют — признак без отмены объявляется без
+этого поля вовсе.
+
+Ключ, совпавший с пакетным, замещает его: дерево вправе сказать о своём готовом точнее, чем
+пакет, который его не видел.
+
 ## Разовое отступление объявляется маркером
 
 ```html
@@ -52,9 +82,18 @@ grep -rn "<похожий приём>" libs/admin libs/site --include='*.html' |
 <input type="tel" qa-dataid="phone-input" />
 ```
 
-Маркер `native-ok` ставится в той же строке и объясняет, **чего именно нет в ките**. «Эти
-строки были здесь раньше» причиной не считается: гард вычёркивает из проверяемого текста то,
-что уже лежит в файле, поэтому отказ означает новый текст.
+Маркер `native-ok` объясняет, **чего именно нет в ките**. «Эти строки были здесь раньше»
+причиной не считается: гард вычёркивает из проверяемого текста то, что уже лежит в файле,
+поэтому отказ означает новый текст.
+
+Стоит он комментарием строкой выше кода или в самой строке — снимаются обе. В разметке годится
+только первое: форматировщик разносит тег, у которого атрибуты не влезли в предел ширины, по
+строкам, и первый атрибут всегда уезжает на строку ниже имени тега. Признак считает имя тега,
+то есть первую строку, а маркер, поставленный атрибутом, оказывается на второй и не снимает
+ничего. Короткий тег форматировщик не трогает — и маркер работает ровно до тех пор, пока к тегу
+не добавили ещё один атрибут.
+
+Дальше следующей строки маркер не достаёт: он снимает свой случай, а не блок вокруг себя.
 
 Сверка идёт без отступов — при переезде блок меняет отступ, оставаясь тем же кодом.
 

package/assets/rules/reuse-first.md

@@ -17,7 +17,7 @@ description: Правило под «Закон о единообразии пр
 | готовое                          | компоненты кита `@rt-tools/ui-kit-v2` с префиксом `rt-` — сегодня их больше семидесяти — и базовые классы без селектора, наследуемые в `@Component` экрана |
 | раскладка страниц, форм и окон   | `apps/<app>/src/styles/`, применяется директивами BEM                                                                                                      |
 | оформление части приложения      | файл `.scss` рядом с компонентом                                                                                                                           |
-| отступление, решённое владельцем | маркер `native-ok` в той же строке с объяснением                                                                                                           |
+| отступление, решённое владельцем | маркер `native-ok` с объяснением — комментарием строкой выше или в самой строке                                                                            |
 
 ## Где это лежит
 
@@ -46,9 +46,12 @@ description: Правило под «Закон о единообразии пр
   раз в общем слое приложения, а экран её только применяет теми же директивами BEM.
 - **Готовое расширяется, а не клонируется рядом.** Недостающий вариант заводится в ките или в
   базовом классе, и его видят остальные экраны.
-- **Накопленное до гарда сосчитано сплошной проверкой и в список только не растёт.** Признаки
-  у неё те же, что у гарда, а смотрит она файл целиком: гейт падает на новом месте, старое
-  остаётся числом в сводке.
+- **Накопленное до гарда сосчитано сплошной проверкой и в список только не растёт.** Признаки у
+  неё те же, что у гарда, потому что оба читают одни и те же объявленные наборы, а смотрит она
+  файл целиком: гейт падает на новом месте, старое остаётся числом в сводке.
+- **Признаки объявляются деревом, а не зашиты в проверку.** Дерево берёт из rt-tools не всё, и
+  признак о готовом из пакета, которого здесь нет, отвечает ложно ровно так же, как имя чужого
+  приложения.
 
 ## Чего из закона здесь нет
 
@@ -67,16 +70,24 @@ description: Правило под «Закон о единообразии пр
 
 ## Признаки, по которым видно, что готовое обошли
 
-- в шаблоне фичи стоит нативный `<input>`, `<button>`, `<select>`, `<table>` или `<dialog>`;
-- отказ или предупреждение собраны руками — свой `role="alert"` вместо `rt-message`;
-- в `.scss` фичи появились `position: fixed` на весь экран, свой backdrop, `z-index` от тысячи,
-  `@keyframes` вращения или мерцания;
-- в файле стилей экрана объявлена раскладка — `display: flex` с `gap` и `padding` на `:host`;
-- компонент реализует `ControlValueAccessor` сам, а не наследует `RtFormControlBase`;
-- имя файла кончается на `-button`, `-input`, `-dialog`, `-spinner` или `-table` вне
-  кита;
-- маппер переводит поля вручную, без `BaseMapper`;
-- процедура бэкенда объявлена без `@ConnectProcedure()`.
+Списком их здесь нет: признак — это данные, а не текст правила и не код проверки. Наборы лежат
+при пакете, по файлу на пакет rt-tools, и в каждом только то, что везёт он сам. Дерево называет
+нужные ему наборы ключом `reuse.bundles` в настройке проверок и дописывает свои признаки файлом,
+названным ключом `reuse.signals`; совпавший ключ замещает пакетный, новый дописывается. Гард на
+правке и сплошная проверка читают отсюда оба — разойтись им нечем.
+
+Что бывает признаком:
+
+- нативный контрол в шаблоне там, где кит везёт свой;
+- отказ, предупреждение или ожидание, собранные руками вместо готового;
+- наложение поверх страницы, объявленное своими стилями, — подложка, порядок слоёв, вращение;
+- раскладка, объявленная в файле стилей экрана, а не применённая директивами из общего слоя;
+- своя реализация того, что даёт основа кита, вместо наследования;
+- имя файла, повторяющее имя китового примитива, вне кита.
+
+Признак называет свою область: наследование основы и метка класса в точечную правку не попадают,
+и признак, судящий их по добавленному тексту, молчит всегда. Признак называет и отмену — образец,
+при котором он не срабатывает: основа уже унаследована, готовое уже позвано.
 
 ## Ловушки
 
@@ -90,3 +101,10 @@ description: Правило под «Закон о единообразии пр
   отступ, оставаясь тем же кодом.
 - Ответ, данный до чтения образца, образец отменяет: согласованная форма выборки списка
   переигрывалась вместе с контрактом через два вопроса после того, как была принята.
+- **Набор объявляется по тому, что дерево потребляет, а не по тому, что пакет везёт.** Дерево, в
+  котором кит написан, а не позван, объявив его набор, получает советы звать кит на файлах самого
+  кита: признак верен, но обращён не туда. Такое дерево объявляет только те наборы, чьё готовое
+  оно берёт со стороны.
+- **Гард, не получивший ни одного признака, неотличим от гарда, которому нечего отбивать.** Он
+  говорит об этом сам, и первая же правка в дереве без объявленных наборов это показывает.
+  Молчание проверки признаком порядка не считается — сначала смотрят, есть ли ей чем судить.

package/assets/skills/agent-kit-extend.md

@@ -0,0 +1,149 @@
+---
+name: agent-kit-extend
+description: Готовые примеры того, как дерево дописывает своё поверх пакета правил — надстройка над разложенным текстом, своя ветка карты гейта, своя функция профиля, свой признак единообразия, свой закон и правило. Брать, когда пакетный текст говорит не то, что верно здесь, гейт требует не то правило, гард судит не по тем путям, или своё поведение надо дописать, не трогая пакет. Где что настраивается и как устроена раскладка — скил agent-kit; форма нового скила — write-a-skill.
+---
+
+# Как дописать своё поверх пакета
+
+Скил `agent-kit` называет, **где** настраивается каждый род правки. Здесь — **как** выглядит
+сама правка, на готовых примерах, и чем каждая проверяется.
+
+Одно правило общее для всех пяти: разложенный файл не правится на месте. Он несёт шапку
+`rt-kit v… · <ресурс> · <сумма>`, правка в нём теряется на следующей раскладке и до тех пор
+выглядит применённой, а `sync` на такой файл отказывает вместо того, чтобы переписать молча.
+
+## Когда брать
+
+- Пакетный текст говорит не то, что верно здесь: имена, пути, приёмы этого дерева.
+- Гейт требует под файл не то правило — или молчит там, где правило есть.
+- Гард судит не по тем путям: чужие корни, свой набор проверок, своя форма ветки.
+- Заводится своё — признак единообразия, проверка, закон с правилом, — чего пакет не везёт.
+
+## Текст: надстройка сливается по разделам
+
+Файл кладётся в `overrides/<идентификатор ресурса>` — путь повторяет ресурс один в один:
+`rules/testing.md` надстраивается файлом `rules/testing.md`.
+
+```markdown
+## Ловушки этого дерева
+
+- **Снимок дерева правится тем же коммитом, что и объявление.** Иначе установка у соседа
+  ставит не то, что стоит здесь.
+```
+
+| Заголовок в надстройке | Что происходит            |
+| ---------------------- | ------------------------- |
+| есть у пакета          | раздел замещается целиком |
+| нет у пакета           | дописывается в конец      |
+| есть, но тело пустое   | раздел пакета снимается   |
+
+**Замещение — целиком, и это главная ловушка.** Свой пункт, дописанный под пакетным заголовком
+`## Ловушки`, уносит все пакетные пункты этого раздела разом, и пропажу не видно ничем: файл
+выглядит собранным. Поэтому заголовок в примере выше свой. Пакетный заголовок берут только
+тогда, когда пакетный текст здесь неверен и его правда надо снять.
+
+Проверяется раскладкой: `sync`, затем `sync --check` — и глазами по разложенному файлу, на
+месте ли пакетные разделы.
+
+От ресурса целиком отказываются не здесь, а списком `skip` в конфиге: надстройка правит текст,
+`skip` отменяет файл.
+
+## Гейт: своя ветка решает раньше умолчания
+
+Гейт спрашивает `skill_for` — она печатает имя правила или молчит. Молчание значит «правила на
+это нет», и правка проходит.
+
+```bash
+skill_for() {
+    kind="$1"; target="$2"; written="$3"
+
+    case "$kind" in
+        edit)
+            case "$target" in
+                # Частное — всегда раньше общего: файл истории не файл компонента.
+                *.stories.ts) printf '%s\n' 'showcase'; return 0 ;;
+            esac
+            ;;
+    esac
+
+    # Всё остальное разбирает умолчание пакета — иначе оно теряется целиком.
+    command -v skill_for_default >/dev/null 2>&1 && skill_for_default "$kind" "$target" "$written"
+
+    return 0
+}
+```
+
+Две вещи здесь обязательны. **Порядок веток:** первое совпадение выигрывает, и общая ветка,
+поставленная выше частной, съедает её молча. **Вызов умолчания:** объявив функцию заново и не
+позвав `_default`, дерево остаётся без всех пакетных веток сразу — а выглядит это как «гейт
+перестал требовать правила».
+
+Проверяется сценариями гейта из набора пакета: они гоняют карту, ничего не раскладывая.
+
+## Гард: профиль отвечает за имена и команды
+
+Тем же приёмом объявляются функции профиля — что гонять перед пушем, какой документ едет парой,
+чем линтуется файл, что здесь считается кодом приложения, какая форма ветки законна.
+
+```bash
+# Какой документ обязан ехать тем же коммитом. Печатает образец пути или молчит.
+rt_docs_pair_for() {
+    case "$1" in
+        *.spec.ts) return 0 ;;
+        libs/kit/src/*/*.component.ts) printf '%s' "${1%/*}/CONTEXT\.md" ;;
+    esac
+}
+```
+
+Печатается **образец**, а не путь: гард сверяет им состав коммита. Умолчание зовётся так же —
+`rt_docs_pair_for_default "$@"` — везде, где своё правило случай не закрыло.
+
+Путь приходит от корня дерева. Признак по подстроке вида `*/projects/*` совпадает и с чужим
+каталогом за пределами репозитория — так запись в домашний каталог была отбита требованием
+замысла, к ней не относящимся.
+
+## Признаки и проверки: данные, а не код
+
+Признак единообразия — данные. Дерево называет наборы пакета, чьё готовое оно берёт, и
+дописывает свои файлом; совпавший ключ замещает пакетный.
+
+```json
+{
+    "sourceRoots": ["apps", "libs"],
+    "reuse": { "bundles": ["kit"], "signals": "tools/signals/own.json" }
+}
+```
+
+Объект сливается ключ за ключом: назвав один ключ раздела, дерево не теряет соседних. **Список
+— наоборот, замещается целиком**, и это ловушка: назвав `sourceRoots`, дерево получает ровно
+названное, а не пакетные корни плюс свои. «Дописать в список» и «убрать из списка» в этой записи
+неразличимы, поэтому список всегда пишется полностью.
+
+Набор объявляется по тому, что дерево **потребляет**. Дерево, в котором кит написан, а не
+позван, объявив его набор, получит советы звать кит на файлах самого кита: признак верен, но
+обращён не туда.
+
+## Свой закон и правило
+
+Пакет везёт слой правил, но не запрещает свой. Закон дерева ложится рядом с пакетными, правило
+под него — среди скилов, и связь идёт через шапку: у правила `law:` с именем закона, у паттерна
+`rule:` с именем правила. Имя, которому ничего не отвечает, отбивает сверку связности.
+
+Утверждение правила получает строку в спутнике `implementation.md` — привязку к файлу и символу.
+Утверждение, которому места в коде не нашлось, в проверяемый раздел не ставится: ему место в
+«Ловушках» прозой.
+
+Проверяется сверкой спеков — до пуша.
+
+## Частые промахи
+
+- **Правка на месте вместо надстройки.** Разложенный файл узнаётся по шапке, а не по каталогу:
+  раскладка ложится в те же `tools/` и `.claude/`, где лежит своё.
+- **Свой пункт дописан к пакетному заголовку** — пакетные пункты этого раздела ушли молча.
+- **Функция объявлена заново без вызова `_default`** — вместе со своим случаем потеряны все
+  пакетные.
+- **Общая ветка карты стоит выше частной** — частная не выполняется никогда.
+- **Замена по шаблону в файле оболочки** — `case` теряет свою `esac`, и гард с ошибкой синтаксиса
+  отвечает ненулевым кодом, то есть «правка отбита». После правки — `bash -n`.
+- **Правка ресурса пакета без сборки.** Строка запуска читает собранное, а не исходники:
+  порядок всегда один — правка, сборка, `sync`.

package/assets/skills/agent-kit.md

@@ -19,19 +19,23 @@ description: Переносимый слой правил агента — за
 
 ## Где что настраивается
 
-| Что меняешь                                    | Куда правка                                        |
-| ---------------------------------------------- | -------------------------------------------------- |
-| какое правило гейт требует под какой файл      | `.claude/rt-kit/gate-map.sh` — своя `skill_for`    |
-| порты, адреса, линтеры, форма ветки, инвентарь | `.claude/rt-kit/project.sh` — свои `rt_*`          |
-| пути и идентификаторы, которыми живут проверки | `.claude/rt-kit/checks.json`                       |
-| раздел разложенного текста                     | `.claude/rt-kit/overrides/<идентификатор ресурса>` |
-| что брать, а от чего отказаться                | `.claude/rt-kit.json`, ключи `only` и `skip`       |
-| сам механизм — гард, проверка, текст правила   | ресурс в пакете                                    |
+| Что меняешь                                    | Куда правка                                            |
+| ---------------------------------------------- | ------------------------------------------------------ |
+| какое правило гейт требует под какой файл      | `.claude/rt-kit/gate-map.sh` — своя `skill_for`        |
+| порты, адреса, линтеры, форма ветки, инвентарь | `.claude/rt-kit/project.sh` — свои `rt_*`              |
+| пути и идентификаторы, которыми живут проверки | `.claude/rt-kit/checks.json`                           |
+| какие признаки единообразия дерево берёт       | `checks.json`, ключи `reuse.bundles` и `reuse.signals` |
+| раздел разложенного текста                     | `.claude/rt-kit/overrides/<идентификатор ресурса>`     |
+| что брать, а от чего отказаться                | `.claude/rt-kit.json`, ключи `only` и `skip`           |
+| сам механизм — гард, проверка, текст правила   | ресурс в пакете                                        |
 
 Надстройка объявляет функцию заново и вправе позвать умолчание тем же именем с суффиксом
 `_default`. Слияние текста идёт по разделам `## `: совпавший заголовок замещает, новый
 дописывается, пустой снимает раздел пакета.
 
+Готовый пример на каждую строку этой таблицы — скил `agent-kit-extend`: как выглядит сама
+правка, чем она проверяется и чем кончается, если положить её не туда.
+
 ## Порядок
 
 Правка ресурса доезжает до дерева только через сборку пакета: строка запуска читает собранное,
@@ -84,6 +88,10 @@ npx agent-kit propose       # отправить предложения, адр
 
 ## Ловушки
 
+- **Правила и паттерны при отвергнутом законе в отказе не перечисляются.** Их снимает каскад, а
+  строка на них становится выводимой: раскладка называет её лишней вместе с законом, из-за
+  которого она перестала снимать. Отказ мерит слой законов, а не число файлов в пакете.
+
 - **Линтер по следам правки судит файл целиком, а не внесённую правку.** Импорт, добавленный
   отдельным шагом, отбивается как неиспользуемый ещё до того, как появится строка, которая его
   зовёт, и работа встаёт на половине. Правка делается одним вызовом либо в порядке «сначала
@@ -103,10 +111,11 @@ npx agent-kit propose       # отправить предложения, адр
   написанная по путям, требует под него доменное правило — а оно уводит править файл на месте.
   Правка на месте теряется на следующей раскладке, и до тех пор выглядит применённой. Ветка по
   шапке ставится в карте первой и решает раньше путей.
-- **Настройки проверок сливаются на один уровень.** Верхние ключи `checks.json` ложатся поверх
-  умолчаний по одному, а вложенный объект замещается целиком: назвав один ключ борды, дерево
-  теряет остальные — и увидит это отказом «нет токена бота», то есть как неполадку машины.
-  Вложенный раздел заполняется целиком либо не заводится вовсе.
+- **Настройки проверок сливаются по ключам, а списки — замещаются.** Объект `checks.json`
+  ложится поверх умолчания ключ за ключом на любой глубине: назвав один ключ борды, дерево не
+  теряет соседних. Список приходит целиком — назвав корни исходников, дерево получает ровно
+  названное, а не умолчание вместе со своим: «дописать в список» и «убрать из списка» в этой
+  записи неразличимы.
 - **Утверждение правила переезжает вместе с кодом.** Вынесенное в надстройку перестаёт
   находиться по прежнему символу, и привязка в спутнике правила врёт молча — сверка спеков
   ловит это, но только если её позвать.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rt-tools/agent-kit",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "Переносимый слой правил для агента: законы, хуки, проверки и агенты, раскладываемые в репозиторий одной командой",
   "author": "RT Team",
   "license": "Apache-2.0",