@rt-tools/agent-kit 0.6.0 → 0.8.0

package/README.md

@@ -185,6 +185,19 @@ npx agent-kit init --laws access,delivery,verifiability
 трогает. Имена законов — из `agent-kit list`, там же видно, что взято, что не выбрано и что
 пропущено.
 
+**Отказ от закона снимает его правила и паттерны сам.** Связь читается из вступления ресурсов —
+у правила стоит `law`, у паттерна `rule`, — и перечислять потомков в `skip` не надо: строка,
+которая после этого ничего не снимает, называется вслух предупреждением, а раскладка идёт
+дальше. Каскад идёт только сверху вниз: отказ от паттерна ни правила, ни закона не трогает.
+
+Правило, названное в `only` при невыбранном законе, тоже называется вслух: раскладка говорит,
+что оно не приедет и по какому родителю. Файл такого правила, разложенный прежней настройкой,
+перечисляется отдельно от брошенного — дерево от него не отказывалось.
+
+Ресурс, ушедший из набора совсем, пакет помнит по имени: файл, положенный им в дерево прежней
+редакцией, назван при раскладке вместе с причиной снятия. Убирает его дерево — в чужие файлы
+пакет не пишет.
+
 ## Конфиг
 
 `.claude/rt-kit.json` коммитится: раскладка обязана повторяться на чужой машине без вопросов.
@@ -212,7 +225,8 @@ npx agent-kit init --laws access,delivery,verifiability
   называет: перечислив законы, проект говорит о законах, а не обо всём, что пакет везёт, —
   шаблоны при нём остаются.
 - **`skip`** — ресурсы, от которых проект отказался, теми же идентификаторами. Вычитает из
-  выбранного, поэтому отказ от одного закона не требует переписывать весь список.
+  выбранного, поэтому отказ от одного закона не требует переписывать весь список. Правила при
+  отвергнутом законе и паттерны при них перечислять не надо: их снимает каскад.
 
 ## Надстройки
 

package/assets/checks/check-push-gate.mjs

@@ -0,0 +1,139 @@
+#!/usr/bin/env node
+/**
+ * Проверка того, что набор гейта пуша не уже набора конвейера.
+ *
+ * Гейт пуша — обещание, что пуш не приедет красным. Пока его набор уже набора
+ * конвейера, обещание шире того, что гейт проверяет, и неверно оно молча: ни
+ * гейт, ни его вывод не говорят, чего в нём нет. Дважды подряд правка, прошедшая
+ * гейт целиком, была отбита конвейером — и оба раза зелёный гейт был прочитан
+ * как «локально всё зелено».
+ *
+ * Файл конвейера машиной не толкуется: команды там произвольны, а часть шагов
+ * локально неисполнима вовсе — кэш, выгрузка следов, вход в реестр. Отсюда
+ * берутся только ИМЕНА шагов, а чем каждое из них закрывается в гейте,
+ * объявляет дерево. Необъявленное имя краснеет: дыра видна на месте, а не
+ * выводится сверкой двух списков глазами.
+ *
+ * Объявление бывает двух родов. Строка — та самая команда, которую печатает
+ * `rt_push_checks` профиля; она сверяется с его выводом, потому что объявление
+ * без исполнения — та же дыра. Исключение — причина, по которой шага в гейте
+ * нет; пустая причина исключением не считается: она единственное, чем
+ * постоянная дыра отличается от забытой строки.
+ *
+ * Дерево без файла конвейера сверки не получает: проверка, падающая там, где
+ * конвейера нет, отбивала бы работу вместо промаха.
+ *
+ * Ненулевой код возврата и перечень расхождений.
+ */
+import { execFileSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+import { CONFIG, ROOT } from './rt-kit-checks.config.mjs';
+
+const GATE = CONFIG.pushGate ?? {};
+const PIPELINE = GATE.pipelineFile ?? '';
+const DECLARED = GATE.steps ?? {};
+
+/**
+ * Профиль дерева ищется той же цепочкой, что и у гарда пуша: умолчание пакета, поверх него
+ * надстройка проекта. Разойдись они — проверка судила бы не тот набор, который гоняет гард.
+ */
+const PROFILES = ['.claude/rt-kit/defaults/project.sh', '.claude/rt-kit/project.sh'];
+
+if (!PIPELINE || !existsSync(join(ROOT, PIPELINE))) {
+    console.log('check-push-gate: пропущено — файла конвейера в дереве нет');
+    process.exit(0);
+}
+
+/**
+ * Имена шагов конвейера. Образец задаёт дерево: у каждого хостинга своя форма записи, и
+ * угадывать её за все три пакет не берётся. Умолчание — форма GitHub Actions.
+ */
+const stepPattern = new RegExp(GATE.stepPattern ?? '^\\s*-\\s*name:\\s*(.+?)\\s*$');
+
+function pipelineSteps() {
+    return readFileSync(join(ROOT, PIPELINE), 'utf8')
+        .split('\n')
+        .map((line) => line.match(stepPattern)?.[1])
+        .filter(Boolean)
+        .map((name) => name.replace(/^['"]|['"]$/g, ''));
+}
+
+/**
+ * Набор гейта берётся у профиля его же оболочкой, а не переписывается сюда: два списка одного
+ * набора расходятся молча, и расходиться начинают в тот день, когда правят один из них.
+ *
+ * Профиля нет, функции в нём нет или оболочка отказала — набор неизвестен, и тогда проверка
+ * судит только полноту объявлений: сверять строки не с чем.
+ */
+function gateChecks() {
+    const present = PROFILES.filter((path) => existsSync(join(ROOT, path)));
+    if (present.length === 0) {
+        return null;
+    }
+    const script = `${present.map((path) => `. "${path}"`).join('\n')}
+command -v rt_push_checks >/dev/null 2>&1 || exit 42
+rt_push_checks ""`;
+    try {
+        return execFileSync('bash', ['-c', script], { cwd: ROOT, encoding: 'utf8' })
+            .split('\n')
+            .map((line) => line.trim())
+            .filter(Boolean);
+    } catch {
+        return null;
+    }
+}
+
+const steps = pipelineSteps();
+const checks = gateChecks();
+const problems = [];
+
+for (const step of steps) {
+    const declaration = DECLARED[step];
+
+    if (declaration === undefined) {
+        problems.push(
+            `шаг конвейера «${step}» не объявлен: закрой его строкой набора в pushGate.steps ` + 'либо объяви исключением с причиной'
+        );
+        continue;
+    }
+
+    if (typeof declaration === 'object' && declaration !== null) {
+        const reason = String(declaration.skip ?? '').trim();
+        if (!reason) {
+            problems.push(`шаг конвейера «${step}» объявлен исключением без причины — пустая причина не считается`);
+        }
+        continue;
+    }
+
+    const line = String(declaration).trim();
+    if (!line) {
+        problems.push(`шаг конвейера «${step}» объявлен пустой строкой — назови команду либо объяви исключение`);
+        continue;
+    }
+
+    if (checks && !checks.some((check) => check.includes(line))) {
+        problems.push(`шаг конвейера «${step}» объявлен строкой «${line}», а набор гейта её не печатает`);
+    }
+}
+
+/** Строка о шаге, которого в конвейере нет, — устаревшая: иначе объявления копят мёртвое. */
+const known = new Set(steps);
+for (const step of Object.keys(DECLARED)) {
+    if (!known.has(step)) {
+        problems.push(`объявление «${step}» устарело — такого шага в ${PIPELINE} нет`);
+    }
+}
+
+if (problems.length > 0) {
+    console.error(`check-push-gate: расхождений ${problems.length}\n`);
+    problems.forEach((problem) => console.error(`  ${problem}`));
+    console.error('\nНабор гейта пуша не бывает уже набора конвейера — правило поставки.');
+    process.exit(1);
+}
+
+const skipped = Object.values(DECLARED).filter((value) => typeof value === 'object' && value !== null).length;
+console.log(
+    `check-push-gate: шагов конвейера ${steps.length}, закрыто набором ${steps.length - skipped}, ` + `объявлено исключениями ${skipped}`
+);

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',
@@ -84,6 +92,17 @@ const DEFAULTS = {
      * не считается никогда.
      */
     productionMarks: [],
+    /**
+     * Гейт пуша против конвейера. `pipelineFile` — файл, из которого берутся имена шагов;
+     * пусто или файла нет — сверки нет вовсе. `stepPattern` — чем имя шага оттуда достаётся;
+     * умолчание записано под GitHub Actions. `steps` — чем каждое имя закрыто: строка набора
+     * либо `{ "skip": "<причина>" }`. Необъявленный шаг отбивает пуш.
+     */
+    pushGate: {
+        pipelineFile: '',
+        stepPattern: '^\\s*-\\s*name:\\s*(.+?)\\s*$',
+        steps: {},
+    },
     /** Очередь работ: владелец, репозиторий, борда и учётная запись машинной работы. */
     board: {
         owner: '',

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

@@ -58,7 +58,7 @@ rt_push_checks_default() {
     [ -x "$root/$RT_HOOKS_TESTS" ] && printf '%s\n' "bash $RT_HOOKS_TESTS"
 
     for check in check-doc-paths check-specs check-file-size check-dupes check-styles \
-        check-lib-layers check-reuse check-schema-drift; do
+        check-lib-layers check-reuse check-schema-drift check-push-gate; do
         [ -f "$root/$RT_CHECKS_DIR/$check.mjs" ] && printf '%s\n' "node $RT_CHECKS_DIR/$check.mjs"
     done
 
@@ -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\$}"