@rt-tools/agent-kit 0.3.0 → 0.5.0

package/assets/rules/platform-access.md

@@ -2,48 +2,76 @@
 name: platform-access
 kind: rule
 law: frontend-application
-description: Правило под закон «Фронтовое приложение». Брать, когда правка задевает глобальный объект или среду исполнения — окно, глобальную область, признак браузера, хранилище, наблюдатели. Глобальное приходит внедрением, среда проверяется службой, а не наличием глобала. Не действует на серверной стороне. Готовый код — в паттерне platform-access-di. Чем это названо здесь — в implementation.md рядом.
+description: Правило под «Закон о фронтовом приложении». Брать, когда правка задевает глобальный объект или среду исполнения — window, globalThis, PLATFORM_ID, isPlatformBrowser, document.defaultView, localStorage, IntersectionObserver. Называет токены DI, приведение типа и подводные камни отдачи страницы сервером. Не действует под libs/api и apps/api. Готовый код — в паттерне platform-access-di.
 ---
 
-# Окружение браузера — каким приёмом
+# Окружение браузера — как это устроено здесь
 
-Правило под закон `{{lawsDir}}/frontend-application.md`. Закон говорит, что должно быть верно;
-здесь — каким приёмом прямое обращение к глобальному объекту заменяется. Какими токенами и
-службами это названо и откуда они приходят — `implementation.md` рядом. Состояние —
-`angular-patterns`, файл компонента — `component-structure`, оформление — `styling-bem`, слой
+Правило под закон `docs/constitution/frontend-application.md`. Закон говорит, что должно быть
+верно; здесь — чем в этом дереве заменяется прямое обращение к глобальному объекту. Состояние
+— `angular-patterns`, файл компонента — `component-structure`, стили — `styling-bem`, слой
 обращения к серверу — `api-layer`. Все пять под одним законом.
 
-Правило про фронт: на серверной стороне своя среда, и ничего из перечисленного к ней не
-относится.
+Правило про фронт: `libs/api/**` и `apps/api/**` — это NestJS, там своя среда, и ничего из
+перечисленного не применяется.
 
-## Когда берётся
+## Как это называется здесь
 
-Правка задевает глобальный объект, признак среды, хранилище браузера или наблюдателя за
-разметкой.
+| Прямое обращение                         | Здесь                                              |
+| ---------------------------------------- | -------------------------------------------------- |
+| `globalThis.open(...)`, `window.open()`  | `inject(WINDOW).open(...)`                         |
+| `globalThis.crypto.randomUUID()`         | `inject(WINDOW).crypto.randomUUID()`               |
+| `isPlatformBrowser(inject(PLATFORM_ID))` | `inject(PlatformService).isPlatformBrowser`        |
+| `document.defaultView`                   | `inject(WINDOW)`                                   |
+| прямой `document`                        | `inject(DOCUMENT)` из `@angular/common` — как было |
+| инициализация DOM после отрисовки        | `afterNextRender()`                                |
 
-## Что здесь действует
+`WINDOW`, `PlatformService` и `StorageService` приходят из `@rt-tools/core`.
 
-- **Глобальный объект приходит внедрением, а не берётся напрямую.** Тип уточняется приведением
-  к глобальной области: конструкторы наблюдателей объявлены на ней, а не на интерфейсе окна.
-- **Среда проверяется службой, а не наличием глобала.** Проверка по наличию верна случайно и
-  ломается на первой же среде, где глобал подставлен.
-- **Место прямого доступа заводится только с согласия владельца.** Их немного, и каждое
-  осознанно: скрипт, работающий до подъёма приложения, обработчик отказа подъёма и код,
-  исполняемый внутри страницы в сквозной спеке. Новое в этот список не добавляется молча.
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Глобальный объект приходит токеном `WINDOW`, а не берётся напрямую.** Тип уточняется
+  приведением к `Window & typeof globalThis`: конструкторы вроде `IntersectionObserver`
+  объявлены на глобальном объекте, а не на интерфейсе `Window`.
+- **Среда проверяется через `PlatformService`, а не через `typeof window`.** Проверка по
+  наличию глобала верна случайно и ломается на первой же среде, где глобал подставлен.
+- **Прямое обращение к глобальному объекту отбивает линтер.** Шестнадцать имён окружения
+  браузера запрещены на фронтовых деревьях; три места, где прямой доступ осознан, выведены
+  из-под запрета списком в конфиге, а не отключением в строке.
+
+## Чего из закона здесь нет
+
+Запрет действует на имена, а не на пути к ним: `this.#document.defaultView` линтер пропускает,
+потому что глобального имени в такой строке нет. Такое обращение законно — окно там уже пришло
+внедрением, — но и настоящий обход выглядел бы так же, и увидеть его можно только чтением.
+
+Прямой доступ остаётся в трёх местах, и это осознанно: встроенный скрипт против мелькания темы
+в `apps/site/src/index.html` (работает до подъёма приложения), обработчик отказа подъёма в
+`apps/*/src/main.ts`, и код внутри `page.evaluate` в сквозных спеках — он исполняется в
+странице, вне DI. Новое место в этот список не добавляется без явного согласования владельца.
 
 ## Паттерны
 
-- `platform-access-di` — готовые внедрения, приведение типа, чистые функции, проверка среды.
+- `platform-access-di` — готовые инжекты, приведение типа, чистые функции, проверка среды.
 
 ## Ловушки
 
-- **Фабрика токена окна бросает отказ, когда у документа нет представления.** Под отдачей
-  страницы сервером представление есть, и внедрение полем класса безопасно, но служба,
-  обязанная работать без разметки вовсе, берёт окно внутри метода под проверкой среды.
-- **После правки, добавляющей окно в службу, которая создаётся на подъёме, нужна не только
-  сборка, но и поднятый сервер отдачи страниц.** Падение видно только там.
-- **Вокруг хранилища проверка среды не нужна.** Служба хранилища и так уходит в память вне
-  браузера, и лишняя проверка вокруг чтения и записи — мёртвый код.
-- **В чистых функциях внедрения нет** — окно принимается параметром, а внедряет его вызывающий.
-- **Подготавливать состояние сквозной спеки записью в хранилище нельзя** — спека проходит те же
+- **Фабрика токена бросает `Window is not available`, если у документа нет `defaultView`.**
+  Под отдачей страницы сервером `defaultView` есть, и инжект полем класса в root-сервисе
+  безопасен, но сервис, обязанный работать без DOM вообще, берёт окно внутри метода под
+  проверкой среды.
+- **После правки, добавляющей `WINDOW` в сервис, который создаётся на подъёме, нужна не только
+  сборка, но и поднятый сервер отдачи страниц.** Сайт — настоящий SSR, и падение видно только
+  там.
+- **Вокруг хранилища проверка среды не нужна:** `StorageService` и так уходит в память вне
+  браузера, и лишний `if (!isBrowser)` вокруг чтения и записи — мёртвый код.
+- **В `*.logic.ts` и `*.util.ts` нет DI:** окно принимается параметром, а инжектит его
+  вызывающий компонент.
+- **Подготавливать состояние сквозной спеки записью в хранилище нельзя:** спека проходит те же
   шаги, что и пользователь.

package/assets/rules/pricing.md

@@ -0,0 +1,64 @@
+---
+name: pricing
+kind: rule
+law: money
+description: Правило под «Закон о деньгах». Брать при правке расчёта цены, скидок, курсов валют, сумм в заказах, письмах и сводках. Называет хранение в целых единицах валюты хранения, единственное округление, выбор одной наибольшей скидки и справочный пересчёт. Готовый код — в паттерне pricing-quote. Чем это названо здесь — в implementation.md рядом.
+---
+
+# Суммы — как это устроено здесь
+
+Правило под закон `docs/constitution/application/money.md`. Закон говорит, что должно быть
+верно; здесь — каким приёмом это держится. Валюта хранения, набор справочных валют и имена
+колонок — при этом дереве, в `implementation.md` рядом.
+
+## Как это называется здесь
+
+| В законе      | Здесь                                                                                          |
+| ------------- | ---------------------------------------------------------------------------------------------- |
+| сумма         | целое число единиц валюты хранения; код валюты стоит в имени поля — `total<Код>`, `price<Код>` |
+| валюта показа | поле заказа с кодом валюты, в которой пользователь смотрел цену                                |
+| расчёт цены   | одна чистая функция: на входе — что заказано, на выходе — подытог, скидка и итог               |
+| скидка        | механики перечислены в `implementation.md`; правило про выбор одно на все                      |
+| курс          | кэш в хранилище, обновляется по расписанию                                                     |
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Сумма хранится в целых единицах валюты хранения.** Дробная часть даёт расхождение между
+  подытогом и итогом: показанное построчно перестаёт складываться в показанное внизу. Если
+  дробная часть в предметной области значима, единицей хранения становится она сама.
+- **Код валюты стоит в имени поля, а не подразумевается.** Поле `total` без кода читается как
+  «сумма вообще», и первый же пересчёт кладёт в него чужую валюту.
+- **Округление происходит один раз — при расчёте цены.** Сумма на экране, сумма в письме и
+  сумма в хранилище — одно и то же число, а не три результата одного пересчёта.
+- **Из подходящих скидок применяется одна — наибольшая.** Сравниваются они в валюте хранения:
+  доля и сумма иначе несравнимы.
+- **При равной выгоде побеждает та скидка, которую пользователь ввёл руками.** Он ждёт
+  подтверждения своему действию, а «код не сработал» при той же итоговой цене читается как
+  поломка.
+- **Скидка суммой ограничена подытогом.** Иначе она увела бы цену ниже нуля.
+- **Пересчёт в чужую валюту не хранится.** В заказе лежат сумма в валюте хранения и код валюты
+  показа; само число вычисляется на показ.
+- **Оплата идёт в валюте хранения, остальные валюты — справка.** Ни подтверждение, ни документ
+  не называют справочное число суммой к оплате.
+- **Валюта показа следует за пользователем.** Он выбрал её на экране — в письме сумма
+  пересчитана в неё же.
+- **Курс недоступен — сумма показывается в валюте хранения без пересчёта.** Пересчёт по
+  неизвестно какому курсу хуже отсутствующего: отсутствие видно, а неверный курс — нет.
+
+## Паттерны
+
+- `pricing-quote` — расчёт цены, выбор скидки, работа с курсом.
+
+## Ловушки
+
+- **Курс тянется по расписанию и кэшируется.** Само число в чужой валюте нигде не сохраняется.
+- **Дробная сумма в контракте — признак того, что округление уехало на показ.** Округление
+  одно, и живёт оно в расчёте.
+- **Справочная сумма рядом с суммой к оплате читается как цена.** В письме и в документе
+  справочное число подписывается как справка.

package/assets/rules/reuse-first.md

@@ -2,68 +2,82 @@
 name: reuse-first
 kind: rule
 law: reuse-first
-description: Правило под закон «Единообразие приложения». Брать перед заведением любого нового экрана, компонента, поля, стора, сервиса, переводчика моделей или обработчика — на что опираться, по каким признакам видно, что готовое обошли. Что делать, когда готового не хватило, — в паттерне reuse-first-extend. Чем это названо здесь — в implementation.md рядом.
+description: Правило под «Закон о единообразии приложения». Брать перед заведением любого нового экрана, компонента, поля, стора, сервиса, маппера или процедуры — на что опираться, что уже готово в ките и базовых классах, по каким признакам видно, что готовое обошли. Что делать, когда готового не хватило, — в паттерне reuse-first-extend.
 ---
 
-# Единообразие — каким приёмом
+# Единообразие — как это устроено здесь
 
-Правило под закон `{{lawsDir}}/reuse-first.md`. Закон говорит, что одинаковые вещи ведут себя
-одинаково; здесь — каким приёмом это держится. На какие именно источники вида и основы это
-дерево опирается — `implementation.md` рядом.
+Правило под закон `docs/constitution/reuse-first.md`. Закон говорит, что одинаковые вещи ведут
+себя одинаково; здесь — на чём это стоит в этом дереве и чем названо.
 
-## Когда берётся
+## Как это называется здесь
 
-Заведение нового файла: экрана, компонента, поля, стора, сервиса, переводчика моделей,
-обработчика серверной стороны. Правило берётся **до** первой строки, а не после.
+| В законе                         | Здесь                                                                                                                                                      |
+| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| готовое                          | компоненты кита `@rt-tools/ui-kit-v2` с префиксом `rt-` — сегодня их больше семидесяти — и базовые классы без селектора, наследуемые в `@Component` экрана |
+| раскладка страниц, форм и окон   | `apps/<app>/src/styles/`, применяется директивами BEM                                                                                                      |
+| оформление части приложения      | файл `.scss` рядом с компонентом                                                                                                                           |
+| отступление, решённое владельцем | маркер `native-ok` в той же строке с объяснением                                                                                                           |
 
-## Что здесь действует
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
 
-- **Источник вида выбирается по приложению, а не по привычке.** У дерева может быть больше
-  одного источника — свой у каждого приложения; перепутанный приносит на экран форму, которой в
-  этом приложении больше нигде нет.
 - **Работа начинается с чтения готового, а не с чистого файла.** Сначала находится опора —
-  готовый компонент, базовый класс, образец в соседнем домене, — потом пишется своё поверх неё.
-  Соседний домен читается целиком: приём, который кажется новым, обычно уже написан, а
-  переименованный при переносе он перестаёт узнаваться.
+  компонент кита, базовый класс, образец в соседнем домене, — потом пишется своё поверх неё.
 - **Свой примитив и своя основа заводятся только с явного одобрения владельца.** Спрашивается
-  это до того, как написан первый файл, а не после.
+  это до того, как написан первый файл.
 - **Панель правки записи наследует общую основу, а не собирается своей разметкой.** Тогда она
   открывается, закрывается и спрашивает про несохранённое одинаково во всех разделах.
 - **Об удаче и об отказе сообщает общая шина, а не своя разметка на экране.** Своё сообщение
   расходится с соседним видом, местом и временем показа.
-- **Компонент объявляется отдельными файлами разметки и стилей.** Шаблон и стили внутри
-  декоратора, атрибут стиля в разметке и правка размеров привязкой к стилю — это оформление, до
-  которого не дотянется ни источник вида, ни линтер стилей.
-- **У компонента экрана файл стилей по умолчанию пустой.** Раскладка объявлена один раз в общем
-  слое приложения, а экран её только применяет.
-- **Готовое расширяется, а не клонируется рядом.** Недостающий вариант заводится в источнике
-  вида или в базовом классе, и его видят остальные экраны. Клон, написанный рядом, забирает
-  правки на себя и расходится с оригиналом с первой же.
+- **Компонент объявляется тремя файлами: `.ts`, `.html`, `.scss`.** `template:` и `styles:` в
+  декораторе, атрибут `style=` и правка размеров через `[ngStyle]` — это стили, до которых не
+  дотянется ни кит, ни `stylelint`.
+- **У компонента экрана вне кита файл стилей по умолчанию пустой.** Раскладка объявлена один
+  раз в общем слое приложения, а экран её только применяет теми же директивами BEM.
+- **Готовое расширяется, а не клонируется рядом.** Недостающий вариант заводится в ките или в
+  базовом классе, и его видят остальные экраны.
+- **Накопленное до гарда сосчитано сплошной проверкой и в список только не растёт.** Признаки
+  у неё те же, что у гарда, а смотрит она файл целиком: гейт падает на новом месте, старое
+  остаётся числом в сводке.
+
+## Чего из закона здесь нет
+
+Одинаковый ответ поля ввода на ошибку держит кит: `RtFormControlBase` в этом дереве не
+наследует никто, потому что поля берутся его готовыми компонентами. Привязать эту статью
+закона здесь не к чему.
+
+Инлайновый шаблон стоит у одного компонента, и у него же единственный `styles:` — это шапка
+админки. `role="alert"` написан руками в шестнадцати шаблонах, а `rt-message` зовёт один
+потребитель. Это долг, а не разрешённое отступление.
 
 ## Паттерны
 
-- `reuse-first-extend` — что делать, когда готового не хватило: расширить готовое, объявить
-  разовое отступление маркером, снять его.
+- `reuse-first-extend` — что делать, когда готового не хватило: расширить кит, объявить
+  отступление маркером, снять его.
 
 ## Признаки, по которым видно, что готовое обошли
 
-- в шаблоне фичи стоит нативный элемент ввода, кнопки, выбора, таблицы или диалога;
-- отказ или предупреждение собраны руками — своя область оповещения вместо готового сообщения;
-- в стилях фичи появились перекрытие всего экрана, своя вуаль, слой поверх всего, свои кадры
-  вращения или мерцания;
-- в файле стилей экрана объявлена раскладка, а не только его собственные отличия;
-- компонент сам реализует договор поля формы, вместо того чтобы наследовать основу;
-- имя файла кончается на род готового компонента — кнопку, поле, диалог, таблицу — и лежит вне
-  источника вида;
-- переводчик моделей переводит поля вручную, минуя общую основу;
-- обработчик серверной стороны объявлен без общей метки.
+- в шаблоне фичи стоит нативный `<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()`.
 
 ## Ловушки
 
-- **Перенос переизобретением не считается.** Строка, которая уже лежала в дереве, при переезде
-  меняет отступ, оставаясь тем же кодом; сверка идёт без отступов, иначе каждый переезд читался
-  бы как новый код.
-- **Ответ, данный до чтения образца, образец отменяет.** Согласованная форма переигрывается,
-  как только находится готовая: договорённость слабее того, что уже написано и работает.
-- **Подсказка, зовущая за ненаписанным, останавливает работу.** Пока свой вариант не написан,
-  правило зовёт за готовым — а не за тем, что «должно появиться».
+- Перенос переизобретением не считается: строку, которая уже лежит в файле, гард из
+  проверяемого текста вычёркивает, а сверка идёт без отступов — при переезде блок меняет
+  отступ, оставаясь тем же кодом.
+- Ответ, данный до чтения образца, образец отменяет: согласованная форма выборки списка
+  переигрывалась вместе с контрактом через два вопроса после того, как была принята.

package/assets/rules/seo.md

@@ -2,49 +2,70 @@
 name: seo
 kind: rule
 law: search-visibility
-description: Правило под закон «Видимость в поиске». Брать при любой правке, доходящей до разметки публичной части — шаблоны страниц, заголовок и описание, структурированные данные, канонический адрес, языковые ссылки, маршруты, карта сайта, правила обхода, конфиг прокси. Готовый код — в паттернах seo-page и seo-verify. Чем это названо здесь — в implementation.md рядом.
+description: Правило под «Закон о видимости в поиске». Брать при любой правке, доходящей до разметки публичного сайта — шаблоны страниц, meta/title/description, JSON-LD, canonical, hreflang, маршруты сайта, sitemap, robots, nginx. Называет восемь локалей, где что лежит и чего у нас нет. Готовый код — в паттернах seo-page и seo-verify.
 ---
 
-# Видимость в поиске — каким приёмом
+# Видимость в поиске — как это устроено здесь
 
-Правило под закон `{{lawsDir}}/search-visibility.md`. Закон говорит, что должно быть верно;
-здесь — каким приёмом это держится. Какие локали набраны, где лежит служба тегов и чем зовётся
-канонический путь — `implementation.md` рядом.
+Правило под закон `docs/constitution/application/search-visibility.md`. Закон говорит, что должно быть
+верно; здесь — чем это названо в этом коде, где лежит и что из закона у нас не применяется.
 
-## Когда берётся
+## Как это называется здесь
 
-Любая правка, доходящая до разметки публичной части: шаблон страницы, теги в голове документа,
-структурированные данные, маршруты, карта сайта, правила обхода, конфиг прокси.
+| В законе                     | Здесь                                                                        |
+| ---------------------------- | ---------------------------------------------------------------------------- |
+| язык страницы                | локаль; их восемь — `en`, `ru`, `de`, `zh-Hans`, `zh-Hant`, `ko`, `th`, `hi` |
+| язык по умолчанию            | `DEFAULT_LOCALE`, то есть `en`; отдаётся из корня, без префикса в адресе     |
+| язык, перевод которого готов | `readyLocales` — поле объекта, а не список локалей сайта                     |
+| канонический адрес           | `${SITE_ORIGIN}${propertyPath(slug, locale)}`                                |
+| структурированные данные     | JSON-LD типа `LodgingBusiness`                                               |
+| прежний адрес страницы       | прежний slug объекта                                                         |
 
-## Что здесь действует
+Локаль по умолчанию отдаётся из корня, остальные — с префиксом `/<код>/`. Префикс — часть
+маршрута, а не часть сборки: `<base href>` в разметке всегда `/`.
 
-- **Свои теги помечены собственным атрибутом и при повторном применении переписываются.** Чужое
-  в голове документа не трогается: после оживления там остаются теги от отдачи сервером.
-- **Канонический адрес ведёт на локализованный путь**, а не на корень и не на адрес локали по
-  умолчанию.
-- **Языковые ссылки строятся по локалям, перевод которых готов**, плюс ссылка на локаль по
-  умолчанию. Полный список локалей для этого не годится: переводы содержимого заполняются
-  отдельно и готовы не всегда.
-- **Список альтернативных локалей не включает локаль самой страницы** — иначе она объявлена и
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Свои теги помечены атрибутом `data-<префикс>-seo`** и при повторном применении переписываются.
+  Чужое в `<head>` не трогается: после гидратации там остаются теги от отдачи сервером.
+- **`canonical` ведёт на локализованный путь** `${SITE_ORIGIN}${propertyPath(slug, locale)}`,
+  а не на корень и не на адрес локали по умолчанию.
+- **`hreflang` строится по `readyLocales`**, плюс `x-default` на локаль по умолчанию. Список
+  локалей сайта для этого не годится: переводы контента заполняет бэк, и готовы они не всегда.
+- **`og:locale:alternate` не включает локаль самой страницы** — иначе она объявлена и
   основной, и альтернативной сразу.
-- **Адрес в структурированных данных — канонический адрес самой страницы**, не корень.
-- **Перенаправление с прежнего адреса отдаётся с временем жизни и кэшируется прокси.** Ключ
-  кэша строится без строки запроса, поэтому запросы с ней идут мимо кэша.
+- **`url` в JSON-LD — канонический адрес страницы объекта**, не корень сайта.
+- **Корень локали отдаёт страницу единственного объекта** с каноническим адресом на `/{slug}`;
+  посетителя уводит туда nginx ответом 302.
+- **Перенаправление с прежнего адреса отдаётся с `Cache-Control: max-age`** и покрыто
+  `proxy_cache_valid 200 301`. Ключ кэша строится без `$args`, поэтому запросы со строкой
+  запроса идут мимо кэша (`proxy_cache_bypass` / `proxy_no_cache $is_args`).
+
+## Чего из закона здесь нет
+
+Листинга объектов нет — корень локали отдаёт единственный объект. Появится листинг —
+канонический адрес корня пересматривается; это `Q-SV-1` в законе.
 
 ## Паттерны
 
-- `seo-page` — правка разметки страницы: теги, структурированные данные, новый маршрут, новая
-  страница в карте сайта.
+- `seo-page` — правка разметки страницы: теги, JSON-LD, новый маршрут, новая страница в карте.
 - `seo-verify` — проверка отданной разметки на прод-сборке.
 
 ## Ловушки
 
-- **Тег, добавленный мимо общей службы, не помечен и потому не переписывается.** Он переживёт
-  переход между страницами и останется от чужой страницы.
-- **Новый маршрут без ветки под каждую локаль существует только в локали по умолчанию.**
-  Остальные адреса отдадут отказ и поисковику, и читателю.
-- **Новая страница не попадает в карту сайта сама** — карта строится из записей, а не из
+- Тег, добавленный мимо `PropertySeoService`, не помечен `data-<префикс>-seo` — он не будет ни
+  переписан, ни удалён при следующем применении и переживёт переход между страницами.
+- Новый маршрут сайта без ветки в `app.routes.ts` под каждую локаль существует только в
+  локали по умолчанию: `/de/<путь>` отдаст 404 и поисковику, и гостю.
+- Новая страница не попадает в `sitemap.xml` сама — карта строится из объектов, а не из
   маршрутов.
-- **Адрес режется по первому знаку вопроса и только им.** Простой разрез по всем вхождениям
-  теряет всё после второго, и перенаправление приходит на страницу без разметки источника —
-  источник обращения считается неверно.
+- Адрес режется по **первому** `?` и только им: `req.url.split('?')` теряет всё после второго
+  знака, и перенаправление приходит на страницу без UTM-хвоста — источник заявки считается
+  неверно. Разрез живёт в `splitRequestUrl`
+  (слой `util` домена страницы объекта) и покрыт спеками; свой не заводить.

package/assets/rules/shared-code.md

@@ -2,34 +2,58 @@
 name: shared-code
 kind: rule
 law: shared-code
-description: Правило под закон «Общий код приложений». Брать, когда значение должно одинаково пониматься всеми приложениями — предел выборки, набор операторов условия, направление порядка, длина поля, форма запроса и ответа списка. Откуда берётся общее, что считается копией и что ловит проверка повторов. Готовый код — в паттерне shared-code-new. Чем это названо здесь — в implementation.md рядом.
+description: Правило под «Закон об общем коде приложений». Брать, когда значение должно одинаково пониматься сайтом, админкой и бэкендом — предел выборки, набор операторов условия, направление порядка, длина поля, форма запроса и ответа списка. Называет, что берётся из @rt-tools/utils, что из @<область>/common/util и что ловит check:dupes. Готовый код — в паттерне shared-code-new.
 ---
 
-# Общий код — каким приёмом
+# Общий код — как это устроено здесь
 
-Правило под закон `{{lawsDir}}/shared-code.md`. Закон говорит, что общим быть обязано; здесь —
-каким приёмом это держится. Из какого пакета и какой либы что берётся — `implementation.md`
-рядом.
+Правило под закон `docs/constitution/shared-code.md`. Закон говорит, что общим быть обязано;
+здесь — откуда это берётся в этом дереве, чем названо и чего у нас нет.
 
-## Когда берётся
+## Как это называется здесь
 
-Значение, которое должны одинаково понимать разные приложения: число-настройка, набор значений,
-форма запроса и ответа списка, длина поля.
+| В законе                  | Здесь                                                                                         |
+| ------------------------- | --------------------------------------------------------------------------------------------- |
+| общий пакет               | `@rt-tools/utils` — собран без фреймворка, зависит от одного `tslib`, грузится под голым Node |
+| общая либа проекта        | `@<область>/common/util`; её тег входит в набор `UNIVERSAL` и виден всем трём приложениям     |
+| число-настройка           | `DEFAULT_PAGE_SIZE`, `MAX_PAGE_SIZE`                                                          |
+| набор значений            | `FILTER_OPERATOR_TYPE_ENUM`, `LIST_SORT_ORDER_ENUM`                                           |
+| сверка значения с набором | `listSortOrderOf`, `listFilterOperatorOf`                                                     |
+| выборка списка            | `IPageModel`, `ISortModel`, `IFilterModel`, `IListState`                                      |
 
-## Что здесь действует
+## Где это лежит
 
-- **Число-настройка лежит в общей либе и оттуда берётся всеми сторонами.** Умолчание доводом не
-  передаётся: пока довод есть, домен вправе назвать своё число — и называет, расходясь с
-  соседним на единицу, которую никто не заметит.
-- **Набор значений из общего пакета заново не объявляется.** Своё перечисление с теми же
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Число-настройка лежит в `libs/common/util` и оттуда берётся обеими сторонами.** Умолчание
+  доводом не передаётся: пока довод есть, домен вправе назвать своё число, и у промокодов так
+  появилось `25` против `20` у остальных.
+- **Набор значений из `@rt-tools/utils` заново не объявляется.** Своё перечисление с теми же
   членами считается копией, даже если имена разошлись.
-- **Значение из набора сверяется общей функцией, а промах разбирает вызывающий.** Сервер
-  отбивает запрос отказом, экран берёт умолчание: политика на непонятное значение у сторон
-  разная, и общей может быть только сверка.
-- **Общим делается лишь то, где политика одна.** Переводчик, у которого стороны читают
-  непонятное значение по-разному, общим не становится — он расходится молча.
-- **Перечисления полей порядка и отбора домена копией не считаются.** Они повторяют имена, по
-  которым сортирует сервер именно этого домена, и совпадение здесь случайное.
+- **Значение из набора сверяется парой общих функций, а промах разбирает вызывающий.** Сервер
+  отбивает запрос `InvalidArgument`, экран берёт умолчание.
+- **Общим стал только маппер страницы.** У сторон разная политика на непонятное значение, и
+  общим может быть лишь то, где она одна: номер меньше единицы обе стороны читают как первую
+  страницу.
+- **Перечисления полей порядка и отбора домена копией не считаются.** `EActivitySortProperty`
+  и подобные повторяют имена, по которым сортирует сервер именно этого домена.
+- **Строковая настройка и таблица соответствий сверяются по значению, а не по имени.** Имя
+  здесь не ключ: `BEM_BLOCK` и `LOG_CONTEXT` объявлены десятками, и значения у них свои, а
+  один и тот же перевод статуса живёт под тремя разными именами.
+
+## Чего из закона здесь нет
+
+Перевод сущности устроен по-разному: фронт переводит наследником `BaseMapper`, бэкенд —
+свободными функциями `xxxToProto` без общей основы. Это долг `Q-S-1`, а не выбор: новый код на
+бэкенде общей основы не заводит, но и своей второй не пишет.
+
+Найденные совпадения строк и таблиц приняты долгом целиком: перевод статуса брони в контракт
+лежит тремя копиями, набор принимаемых вложений — двумя, имя события правки — тремя.
+Сокращать это — работа по доменам, и она заведена вопросом `Q-S-3`.
 
 ## Паттерны
 
@@ -37,9 +61,10 @@ description: Правило под закон «Общий код приложе
 
 ## Ловушки
 
-- **Помощник приведения типов для сверки с набором не годится.** Значение вне набора он пишет в
-  журнал и возвращает строкой, то есть глотает ровно тот случай, ради которого сверку и завели.
-- **Накопленные повторы лежат в списке исключений и отказом не считаются.** Гейт падает только
-  на новом; список исключений только сокращается.
-- **Проверка не ловит ту же логику, написанную заново под другим именем.** Совпадение она ищет
-  по тексту, а не по смыслу.
+- `typeCast.getAsType` для сверки с набором не годится: значение вне набора он пишет в консоль
+  и возвращает строкой `'unknown'`.
+- Накопленные повторы лежат в `tools/dupes-allowlist.json` под ключом `debt` и отказом не
+  считаются — гейт падает только на новом. Список только сокращается.
+- Ту же логику, написанную заново под другим именем, проверка не ловит, и такой проверки не
+  будет: две одинаковые по форме проверки из разных доменов копией не считаются. Заметить это
+  может только тот, кто читает правку, — так сказано и в законе.