@rt-tools/agent-kit 0.7.0 → 0.8.0

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;
     }
-    const stretched =
-        /inset: *0/.test(text) ||
-        (/(^|[^-])top: *0/.test(text) && /left: *0/.test(text) && /right: *0/.test(text) && /bottom: *0/.test(text));
+    if (signal.all?.some((one) => !new RegExp(one).test(body))) {
+        return 0;
+    }
+    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) {
@@ -171,12 +104,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

package/assets/rules/reuse-first.md

@@ -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.md

@@ -19,14 +19,15 @@ 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`. Слияние текста идёт по разделам `## `: совпавший заголовок замещает, новый
@@ -84,6 +85,10 @@ npx agent-kit propose       # отправить предложения, адр
 
 ## Ловушки
 
+- **Правила и паттерны при отвергнутом законе в отказе не перечисляются.** Их снимает каскад, а
+  строка на них становится выводимой: раскладка называет её лишней вместе с законом, из-за
+  которого она перестала снимать. Отказ мерит слой законов, а не число файлов в пакете.
+
 - **Линтер по следам правки судит файл целиком, а не внесённую правку.** Импорт, добавленный
   отдельным шагом, отбивается как неиспользуемый ещё до того, как появится строка, которая его
   зовёт, и работа встаёт на половине. Правка делается одним вызовом либо в порядке «сначала

package/package.json

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