@rt-tools/agent-kit 0.2.0 → 0.3.0

package/assets/patterns/lib-layers-move.md

@@ -0,0 +1,77 @@
+---
+name: lib-layers-move
+kind: pattern
+rule: lib-layers
+description: Паттерн правила lib-layers. Брать при переносе кода или символа между либами — с чего начинать, в каком порядке двигать домены, куда кладётся общее, что делать с границами, импортами и README обеих либ, чем проверять. Заведение и удаление самой либы — паттерн lib-layers-new.
+---
+
+# Перенести код между либами
+
+Паттерн правила `lib-layers`. Что при этом должно быть верно — закон `{{lawsDir}}/lib-imports.md`.
+
+## Когда брать
+
+- Символ переезжает из одной либы в другую.
+- Домен переносится в новую раскладку.
+- Общий код собирается из копий в одно место.
+
+## Начинать с планов
+
+Решение о том, куда переезжает код, часто уже принято и записано, а принятое заново с ним
+расходится — и откатывать приходится целиком. Поиск по документам делается до первой правки:
+
+```bash
+grep -rn "<имя либы>" <каталог планов>/
+```
+
+## Порядок задаёт граф зависимостей, а не список в плане
+
+Домен переносится после всех, от кого он зависит. Списки доменов в планах отсортированы по
+важности, и следование им в лоб заставляет временно расширять границы — а каждая временная
+строка в границах и есть та механическая проверка, ради которой нарезка затевалась.
+
+```bash
+grep -rn "<алиас домена>" <каталоги кода> | sed 's/:.*//' | sort -u
+```
+
+Рёбра выписываются поиском по алиасам домена и сортируются топологически.
+
+## Куда именно кладётся общее
+
+Своя либа заводится тогда, когда ни одна существующая код не видит.
+
+| Кому нужно                                     | Куда                                                          |
+| ---------------------------------------------- | ------------------------------------------------------------- |
+| серверной стороне и фронту, без каркаса фронта | общая либа утилит                                             |
+| только фронтам, тянет каркас                   | либа платформы — служба и токен, либа общих компонентов — вид |
+| предмету, у которого уже есть либа             | в неё                                                         |
+| всем доменам одной семьи                       | основание семейства                                           |
+| всей серверной стороне                         | тот слой утилит, что уже перечислен у каждого домена          |
+
+Новых строк в границах при таком переезде не появляется — кроме права видеть контракт, если код
+его читает.
+
+## После переезда
+
+1. **README обеих либ.** У той, откуда файл ушёл, и у той, куда пришёл: README перечисляет, что
+   в либе лежит и кто её зовёт. Ни одна проверка эти тексты не читает.
+2. **Порядок импортов.** Переезд алиаса его ломает, и приходит это ошибкой линтера, а не
+   сборки. Автоправка есть только у линтера — в общий прогон с тестами и сборкой её флаг
+   передавать нельзя, падает весь вызов.
+3. **Линтер по всем затронутым проектам, а не по одному приложению.** Скрипт ошибается молча и
+   не так, как человек: строка импорта не переписывается, а исчезает целиком. Сборка одного
+   приложения до таких файлов не доходит — их находит только прогон по списку проектов.
+
+## Проверить
+
+Проверка раскладки — и обязательно проверка повторов: перенос и есть тот момент, когда копия
+остаётся на старом месте.
+
+## Частые промахи
+
+- Новый адрес выбран без чтения планов — расходится с уже принятым решением.
+- Порядок переноса взят из списка в плане — приходится временно расширять границы.
+- README поправлен только у одной либы.
+- Линтер прогнан по приложению, а не по списку затронутых проектов — пропавшие импорты не
+  видно.
+- Копия осталась на старом месте, а проверка повторов не гонялась.

package/assets/patterns/lib-layers-new.md

@@ -0,0 +1,70 @@
+---
+name: lib-layers-new
+kind: pattern
+rule: lib-layers
+description: Паттерн правила lib-layers. Брать при заведении, переименовании или удалении либы — нужна ли либа вообще, генератор вместо голого вызова каркаса, тег, алиас, барель, README, чем добивать удаление. Перенос кода между уже существующими либами — паттерн lib-layers-move.
+---
+
+# Завести или удалить либу
+
+Паттерн правила `lib-layers`. Что при этом должно быть верно — закон `{{lawsDir}}/lib-imports.md`.
+
+## Когда брать
+
+- Заводится новый домен или новый слой существующего домена.
+- Либа переименовывается.
+- Либа удаляется.
+
+## Сначала — нужна ли либа вообще
+
+У домена есть экраны, состояние и запросы. Механика, общая нескольким доменам, доменом не
+заводится: слои под неё останутся пустыми навсегда.
+
+Признак: если ни слой экранов, ни слой состояния, ни слой обращения к серверу наполнить не из
+чего — это утилиты, и им место в либе, которой они уже видны. У фронта такая либа есть всегда —
+основание семейства; у серверной стороны — тот слой утилит, что уже перечислен у каждого
+домена.
+
+Домен, заведённый под механику, живёт девятью либами на три файла кода: семь из них пустые, и у
+каждой свой манифест, свой конфиг прогонщика, барель, тег и алиас.
+
+## Заводится генератором, а не голым вызовом каркаса
+
+Генератор кладёт манифест, конфиг типов, конфиг прогонщика и барель разом. Голый вызов каркаса
+даёт конфиг прогонщика без настройки «успех при отсутствии тестов», и либа, у которой спек ещё
+нет, роняет общий прогон строкой «файлов тестов не найдено». Проверка раскладки смотрит на
+наличие файла, а не на его содержимое, поэтому такую либу она пропустит.
+
+## Что дописывается руками
+
+1. Тег в конфиге границ домена — один на либу, равный имени и пути.
+2. Алиас в конфиге путей.
+3. README либы: что в ней лежит и кто её зовёт.
+
+Права на чужие либы выписываются строками с комментарием, зачем. Импорт, который «просто
+заработал», означает, что тег ещё не сужен.
+
+## Удаление
+
+Удаление средствами гита оставляет за собой то, что гит не отслеживал, — кэш сборщика внутри
+удаляемого каталога, — и проверка раскладки продолжает видеть его как домен без слоёв.
+Добивается обычным удалением каталога.
+
+Следом снимаются тег, алиас и строки прав у тех, кто либу видел.
+
+## Проверить
+
+Проверка раскладки смотрит слои, единственный тег, равный имени и пути, алиас, наличие
+манифеста, конфига прогонщика и бареля, пустой список зависимостей у общей либы, границы
+основания семейства и реэкспорты. Она стоит секунды — гоняется после любого создания,
+переименования или удаления.
+
+## Частые промахи
+
+- **Либа заведена под механику:** слои пустые и заполнять их нечем.
+- **Голый вызов каркаса** — конфиг прогонщика без настройки «успех при отсутствии тестов», и
+  общий прогон краснеет.
+- **Удаление без добивания каталога** — проверка видит призрак домена без слоёв.
+- **Либа, которую никто не импортирует, не проверена ничем.** Линтер и тесты проверяют её саму,
+  а не договор с потребителем. Первый импортёр и есть первая проверка: слой моделей принимается
+  после сборки и живого прогона сценария, а не по зелёному линтеру с тестами.

package/assets/patterns/permissions-procedure.md

@@ -0,0 +1,69 @@
+---
+name: permissions-procedure
+kind: pattern
+rule: permissions
+description: Паттерн правила permissions. Брать при заведении обработчика серверной стороны и при закрытии раздела интерфейса — метки доступа, отбивка без входа и без права, декларация пункта меню с правом и признаком незавершённости.
+---
+
+# Объявление доступа
+
+Паттерн правила `permissions`. Что при этом должно быть верно — закон `{{lawsDir}}/access.md`.
+
+## Когда брать
+
+- Заводится обработчик серверной стороны.
+- Раздел интерфейса закрывается правом.
+- Обработчик должен отвечать гостю.
+
+## Метка на классе обработчика
+
+Объявление ровно одно; без него приложение не поднимается:
+
+```typescript
+@Injectable()
+@ConnectProcedure()
+@RequiresPermission('<ресурс>:<действие>')
+export class LinkEntityProcedure implements IConnectProcedure<typeof DomainService.method.linkEntity> {
+    public readonly method: typeof DomainService.method.linkEntity = DomainService.method.linkEntity;
+}
+```
+
+| Метка                            | Кому доступно                                     |
+| -------------------------------- | ------------------------------------------------- |
+| требование права                 | вошедшему с этим правом                           |
+| требование входа                 | любому вошедшему; так живут профиль и выбор языка |
+| публичный доступ                 | гостю без входа                                   |
+| публичный доступ с чтением входа | гостю, но токен читается, если он есть            |
+
+Аргумент — причина для читателя кода. Ни в ответ, ни в журнал она не уходит.
+
+## Отбивка
+
+Перехватчик отвечает до тела обработчика:
+
+- нет входа там, где вход нужен, — неаутентифицирован;
+- вход есть, права нет — отказ в доступе;
+- обработчик, о котором перехватчик ничего не знает, — тоже отказ, а не пропуск.
+
+Сам обработчик решения о допуске не принимает.
+
+## Раздел интерфейса
+
+Пункт меню и адрес закрываются одной декларацией: шапка берёт из неё подписи и адреса, страж —
+права. Второго объявления этой связи не заводится.
+
+Закрытие двухслойное: право пользователя и признак незавершённости раздела. Пункт с признаком
+объявляется без прав и без адреса — право открывает экран, а экрана нет. Появится экран —
+признак снимается, права добавляются.
+
+## Частые промахи
+
+- **Два объявления доступа на одном обработчике:** приложение не поднимется, и увидено это
+  будет только при запуске.
+- **Проверка права внутри тела:** право проверяется до тела.
+- **Своё объявление прав рядом с маршрутами:** оно разойдётся с декларацией меню, и получится
+  «пункта не видно, а страница открывается».
+- **Страж, повешенный на защищённую группу целиком:** он отрабатывает один раз за загрузку
+  страницы и переходов между разделами не видит.
+- **Ожидание прав, которое роняется на отказе запроса:** с неизвестными правами не закрывается
+  ничего, и пустая шапка выхода владельцу не оставляет.

package/assets/patterns/platform-access-di.md

@@ -0,0 +1,70 @@
+---
+name: platform-access-di
+kind: pattern
+rule: platform-access
+description: Паттерн правила platform-access. Брать, когда в код заходит окно, документ или проверка среды — внедрение токенов, приведение к глобальной области, окно параметром в чистой функции, работа с разметкой после первой отрисовки. Не брать на серверной стороне.
+---
+
+# Окно, документ и проверка среды
+
+Паттерн правила `platform-access`. Что при этом должно быть верно — закон
+`{{lawsDir}}/frontend-application.md`.
+
+## Когда брать
+
+- В компонент, службу или директиву заходит окно, документ или проверка среды.
+- Появляется работа с разметкой, которой нельзя случиться до первой отрисовки.
+- Чистой функции нужен доступ к окну.
+
+## Внедрение
+
+```typescript
+@Injectable({ providedIn: 'root' })
+export class SomeService {
+    readonly #document: Document = inject(DOCUMENT);
+    readonly #platform: PlatformService = inject(PlatformService);
+    readonly #window: Window = inject(WINDOW);
+}
+```
+
+## Когда нужен тип глобальной области
+
+Интерфейс окна не описывает глобальные конструкторы и пространства имён — наблюдателей
+пересечения и размера, объекты внешних карт. Токен отдаёт тот же самый объект, поэтому тип
+уточняется приведением, и рядом ставится комментарий с причиной:
+
+```typescript
+// Конструкторы наблюдателей объявлены на глобальной области, а не на интерфейсе окна —
+// токен отдаёт тот же объект, тип лишь уточняется.
+readonly #window: Window & typeof globalThis = inject(WINDOW) as Window & typeof globalThis;
+```
+
+## Чистая функция принимает окно параметром
+
+В файлах чистой логики внедрения нет, и глобал внутрь не тянется:
+
+```typescript
+export function mapsReady(windowRef: Window & typeof globalThis): boolean {
+    return typeof windowRef.maps?.importLibrary === 'function';
+}
+```
+
+Внедряет его вызывающий компонент.
+
+## Проверка среды и первая отрисовка
+
+Среда спрашивается у службы платформы, а работа с разметкой уходит в крючок первой отрисовки.
+Проверка «глобал определён» не годится: она верна случайно и ломается на первой же среде, где
+глобал подставлен.
+
+## Частые промахи
+
+- **Проверка среды прямым обращением к признаку платформы** вместо службы.
+- **Проверка среды вокруг чтения и записи в хранилище:** служба хранилища и так уходит в память
+  вне браузера, и такое условие — мёртвый код.
+- **Окно полем класса в службе, обязанной работать без разметки вовсе:** там оно берётся внутри
+  метода под проверкой среды.
+- **Правка добавила окно в службу, создающуюся на подъёме, а проверили одной сборкой:** падение
+  видно только на поднятом сервере отдачи страниц.
+- **Приведение без комментария:** в переводчиках моделей приведение запрещено, и строка
+  читается как нарушение.

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

@@ -0,0 +1,73 @@
+---
+name: reuse-first-extend
+kind: pattern
+rule: reuse-first
+description: Паттерн правила reuse-first. Брать, когда готового в источнике вида или в базовом классе не хватило — что проверить перед тем, как писать своё, как расширить готовое, как объявить разовое отступление маркером и когда его снимать.
+---
+
+# Готового не хватило
+
+Паттерн правила `reuse-first`. Что при этом должно быть верно — закон `{{lawsDir}}/reuse-first.md`.
+
+## Когда брать
+
+Готовый компонент или базовый класс не покрывает случай, и рука тянется написать своё рядом.
+
+## Сначала — проверить, что действительно не хватает
+
+```bash
+grep -c "export" <барель источника вида>
+grep -rn "<похожий приём>" <каталоги кода> --include='*.html' | head
+```
+
+Источник вида большой, и большинства его компонентов нет ни в одной таблице. Соседний домен
+читается целиком: приём, который кажется новым, обычно уже написан — и переименованный при
+переносе он перестаёт узнаваться.
+
+Частые подмены, которые находятся при чтении: готовый мерцающий заполнитель вместо своего,
+готовый диалог вместо своей вуали, готовое сообщение вместо своей области оповещения.
+
+## Расширять, а не клонировать
+
+Недостающий вариант заводится **в источнике вида или в базовом классе**, и его видят остальные
+экраны.
+
+```
+✗ <домен>/ui/my-dialog/          клон «почти как готовый»
+✓ <источник вида>/dialog/        новый вариант у готового
+```
+
+Клон, написанный рядом, забирает правки на себя и расходится с оригиналом с первой же.
+Переименованный файл и «похожий, но свой» компонент — то же отступление, только необъявленное.
+
+## Свой примитив — только с одобрения владельца
+
+Спрашивается до того, как написан первый файл. То же относится к своей основе и к своему
+оформлению на месте.
+
+## Разовое отступление объявляется маркером
+
+```html
+<!-- <маркер>: в источнике вида нет поля с маской телефона, заведено задачей -->
+<input type="tel" qa-dataid="phone-input" />
+```
+
+Маркер ставится в той же строке и объясняет, **чего именно нет в готовом**. «Эти строки были
+здесь раньше» причиной не считается: гард вычёркивает из проверяемого текста то, что уже лежит
+в файле, поэтому отказ означает новый текст.
+
+Сверка идёт без отступов — при переезде блок меняет отступ, оставаясь тем же кодом.
+
+## Снятие отступления
+
+Когда недостающее появилось в готовом, маркер снимается вместе с обходом. Комментарий,
+оправдывающий отклонение, держит это отклонение на себе: пока объяснение выглядит убедительно,
+его не трогают.
+
+## Частые промахи
+
+- Своё написано до чтения источника вида и соседнего домена.
+- Клон рядом вместо нового варианта у готового.
+- Маркер поставлен без объяснения, чего не хватает.
+- Маркер оставлен после того, как готовое появилось.
+- Своя основа спроектирована заново вместо переноса образца владельца дословно.

package/assets/patterns/seo-page.md

@@ -0,0 +1,92 @@
+---
+name: seo-page
+kind: pattern
+rule: seo
+description: Паттерн правила seo. Брать, когда правится разметка публичной страницы, заводится новый маршрут или новая страница должна попасть в карту сайта — вызов общей службы тегов, ветки локалей в маршрутах, запись в карте сайта. Не брать для проверки отданной разметки — это паттерн seo-verify.
+---
+
+# Разметка публичной страницы
+
+Паттерн правила `seo`. Что при этом должно быть верно — закон `{{lawsDir}}/search-visibility.md`.
+
+## Когда брать
+
+- Правится шаблон публичной страницы, её заголовок, описание или картинка для соцсетей.
+- Заводится новый публичный маршрут.
+- Появилась страница, которая должна попасть в карту сайта.
+
+## Разметку ставит служба, а не шаблон
+
+Страница собирает данные и одним вызовом отдаёт их общей службе тегов. Своих тегов в шаблоне не
+заводить: они не помечены и потому не переписываются при переходе — тег от прошлой страницы
+переживёт следующую.
+
+```typescript
+readonly #seo: PageSeoService = inject(PageSeoService);
+
+constructor() {
+    effect((): void => this.#applySeo());
+}
+
+#applySeo(): void {
+    const entity: IEntity.State | null = this.entity();
+    if (!entity) {
+        return;
+    }
+
+    this.#seo.apply({
+        entity,
+        pageTitle: this.title(),
+        description: entity.shortDescription || this.#descriptionFallback(),
+        ogImageUrl: this.cover() ? ogUrl(this.cover()) : this.#brandImage(),
+        locale: this.#localeId,
+    });
+}
+```
+
+Вызов идёт из эффекта, а не из конструктора напрямую: запись приходит реактивным значением, и
+на первом кадре её ещё нет. Ранний выход по пустой записи обязателен — без него разметка встала
+бы на пустых значениях и второй раз уже не переписалась бы.
+
+У картинки есть запасной вариант: запись без обложки отдаёт брендовый кадр того же формата,
+иначе превью в соцсети пустует.
+
+## Новый маршрут заводится веткой на каждую локаль
+
+Ветки собираются из списка локалей; локаль по умолчанию своей ветки не имеет — она отдаётся из
+корня.
+
+```typescript
+export const appRoutes: Route[] = [
+    ...LOCALE_CODES.filter((code: ELocale): boolean => code !== DEFAULT_LOCALE).map((code: ELocale): Route => ({
+        path: code,
+        children: publicRoutes,
+    })),
+    ...publicRoutes,
+];
+```
+
+Новый путь дописывается в общий набор — тогда он появляется во всех ветках сразу. Ветки
+перечислены явными кодами, а не параметром: иначе первый же сегмент адреса был бы принят за
+язык.
+
+## Страница попадает в карту сайта явно
+
+Карта строится из записей, а не из маршрутов, и новая страница сама туда не попадёт. Правка
+идёт вместе со спекой на сборщик карты.
+
+## Тексты идут из словарей
+
+Заголовок и описание собираются из переведённых значений и заводятся во всех локалях. Без
+перевода они уезжают в выдачу на одном языке, и заметно это только в чужой локали.
+
+## Частые промахи
+
+- **Тег в шаблоне вместо вызова службы** — он не помечен и переживёт переход.
+- **Вызов без раннего выхода по пустой записи** — разметка встаёт на пустых значениях.
+- **Новый путь дописан мимо общего набора** — работает только в локали по умолчанию, остальные
+  адреса отдают отказ.
+- **Свой разбор адреса вместо общего** — теряется всё после второго знака вопроса, и источник
+  обращения считается неверно.
+- **Правка разметки без проверки на прод-сборке:** на сервере разработки теги ставит другой
+  путь. Проверка описана паттерном `seo-verify`.

package/assets/patterns/seo-verify.md

@@ -0,0 +1,64 @@
+---
+name: seo-verify
+kind: pattern
+rule: seo
+description: Паттерн правила seo. Брать после любой правки, задевающей публичную разметку, теги головы документа или маршруты — сборка, поднятие сервера отдачи страниц, проверка отданной разметки по всем локалям, карта сайта, кэшируемость перенаправления. Не брать для самой правки разметки — это паттерн seo-page.
+---
+
+# Проверка разметки на прод-сборке
+
+Паттерн правила `seo`. Что при этом должно быть верно — закон `{{lawsDir}}/search-visibility.md`.
+
+## Когда брать
+
+После любой правки, задевающей публичную разметку, теги головы документа, маршруты, серверную
+точку входа, правила обхода или конфиг прокси.
+
+## Сервер разработки здесь не показатель
+
+Теги ставятся при отдаче страницы сервером. В режиме разработки этот путь другой, поэтому
+проверка идёт на собранном приложении с поднятым сервером отдачи страниц.
+
+Сервер отдачи страниц отвечает отказом на чужое имя хоста — запросы идут с явным заголовком
+хоста.
+
+## Что смотреть в отданной разметке
+
+```bash
+for locale in "" <остальные локали>; do
+    printf '%-10s ' "${locale:-<по умолчанию>}"
+    curl -s -H "Host: localhost" "http://localhost:<порт>/${locale}<путь>" \
+        | grep -c -E '<title>|name="description"|property="og:|rel="canonical"|hreflang=|application/ld\+json'
+done
+```
+
+В ответе каждой локали должны быть заголовок, описание, набор тегов соцсетей, канонический
+адрес, полный набор языковых ссылок вместе со ссылкой по умолчанию и блок структурированных
+данных.
+
+Отдельно проверяется, что канонический адрес ведёт на **свой** язык, а не на локаль по
+умолчанию.
+
+## Карта сайта
+
+Карта строится из живых данных, а не из файла. Пустой ответ означает, что не поднялся запрос за
+записями, — это отказ, а не «записей нет».
+
+## Кэшируемость перенаправления
+
+Проверяется только на стенде с настоящим конфигом прокси: голый сервер отдачи страниц отдаёт
+заголовки, но не показывает, попадёт ли ответ в кэш.
+
+```bash
+curl -sI http://<стенд>/<прежний адрес> | grep -i -E 'HTTP/|location|cache-control|x-cache'
+```
+
+Ответ обязан быть постоянным перенаправлением, нести срок жизни и попадать в кэш.
+
+## Частые промахи
+
+- **Проверка на сервере разработки:** теги ставит другой путь, и результат ничего не говорит о
+  проде.
+- **Проверена одна локаль:** ветка маршрутов, забытая для остальных, отдаёт отказ и поисковику,
+  и читателю.
+- **Заголовки смотрели на голом сервере:** кэш и перенаправления живут в прокси.

package/assets/patterns/shared-code-new.md

@@ -0,0 +1,80 @@
+---
+name: shared-code-new
+kind: pattern
+rule: shared-code
+description: Паттерн правила shared-code. Брать, когда заводится новое число-настройка, общая функция или общий тип, который должны одинаково понимать все приложения — куда класть, как объявить, как сверить строку с набором и как убедиться, что копия не осталась на старом месте.
+---
+
+# Новое общее заводится так
+
+Паттерн правила `shared-code`. Что при этом должно быть верно — закон `{{lawsDir}}/shared-code.md`.
+
+## Когда брать
+
+- Появилось число-настройка: предел, размер, длительность.
+- Появилась функция без каркаса, нужная обеим сторонам.
+- Значение приходит строкой и должно быть сверено с конечным набором.
+
+## Куда класть
+
+| Что                                          | Куда                                        |
+| -------------------------------------------- | ------------------------------------------- |
+| число или функция без каркаса                | общая либа утилит, файл по предмету         |
+| готовый тип или набор значений               | берётся из общего пакета, не переписывается |
+| токен внедрения, общий двум фронтовым семьям | либа платформы                              |
+
+Файл выбирается по предмету, а не по роду («константы», «функции»): предметный файл читается
+целиком, свалка по роду — никогда. Дальше — строка в барель.
+
+## Число объявляется один раз и без довода
+
+```typescript
+export const DEFAULT_PAGE_SIZE: number = 20;
+```
+
+```typescript
+✗ export function listPageOf(query: IListQuery | undefined, defaultPageSize: number): IListPage
+✓ export function listPageOf(query: IListQuery | undefined): IListPage
+```
+
+Пока умолчание передаётся доводом, домен вправе назвать своё число — и называет, расходясь с
+соседним на единицу, которую никто не заметит.
+
+## Строка сверяется с набором, а не приводится к типу
+
+Приведение принимает любую строку. Сверку делает общая функция, а что делать с промахом, решает
+вызывающий:
+
+```typescript
+const operator: TFilterOperator | null = listFilterOperatorOf(filter.operatorType);
+if (!operator) {
+    throw new RequestError(`filter operator is required: ${filter.propertyName}`);
+}
+```
+
+```typescript
+const direction: TListSortOrder = listSortOrderOf(rawDirection) ?? LIST_SORT_ORDER_ENUM.ASC;
+```
+
+Сервер отбивает запрос, экран берёт умолчание. Общий переводчик здесь не годится: он подал бы
+промах умолчанием, и клиент получил бы отбор, которого не просил.
+
+Помощник приведения типов для этого тоже не годится — значение вне набора он пишет в журнал и
+возвращает строкой.
+
+## Проверить, что копия не осталась
+
+Проверка повторов падает на четырёх признаках: одно имя из двух либ, два перечисления с
+одинаковым набором членов, число-настройка под одним именем в двух либах, перечисление,
+повторяющее набор из общего пакета.
+
+Накопленное лежит в списке исключений и отказом не считается. Список только сокращается: новая
+строка в нём означает, что повтор завели уже после проверки.
+
+## Частые промахи
+
+- Своё перечисление с теми же членами, что уже есть в общем пакете, — копия, даже если имена
+  разошлись.
+- Умолчание, переданное доводом, — домен назовёт своё число, и разъезд будет молчаливым.
+- Ту же логику, написанную заново под другим именем, проверка не ловит.
+- Строковая настройка и таблица соответствий не учитываются вовсе.