@rt-tools/agent-kit 0.2.0 → 0.4.0

package/assets/rules/api-layer.md

@@ -0,0 +1,71 @@
+---
+name: api-layer
+kind: rule
+law: frontend-application
+description: Правило под «Закон о фронтовом приложении». Брать при правке слоя api фронтового домена — *-api.facade.ts, *-api.service.ts и мапперов в его mappers/ под libs/admin и libs/site. Называет пару «фасад и сервис», один вход выборки у списка и общий конвертер страницы. Готовый код — в паттерне api-layer-pair.
+---
+
+# Обращение к серверу — как это устроено здесь
+
+Правило под закон `docs/constitution/frontend-application.md`. Закон говорит, что должно быть
+верно; здесь — из чего сложен слой обращения к серверу. Состояние — `angular-patterns`, файл
+компонента — `component-structure`, стили — `styling-bem`, окружение браузера —
+`platform-access`. Все пять под одним законом.
+
+Правило про обе фронтовые семьи: `libs/admin/*/api/**` и `libs/site/*/api/**`. На бэкенде слово
+`api` означает выход к чужому сервису и устроено иначе — там `typescript-conventions`.
+
+## Как это называется здесь
+
+| В законе         | Здесь                                                                          |
+| ---------------- | ------------------------------------------------------------------------------ |
+| страница записей | `IPageModel` — `pageNumber`, `pageSize`, `totalCount`                          |
+| выборка списка   | `IList.Query.State` — страница, порядок, условия отбора, строка поиска         |
+| ответ списка     | `data`, `pageModel`, `sortModel`, `filterModel`, `searchTerm`                  |
+| путь запроса     | экран → стор → `<Сущность>ApiService` → `<Сущность>ApiFacade` → клиент Connect |
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Домен ходит за данными парой классов: фасад зовёт процедуру, сервис переводит модели.**
+  Один класс на оба дела означал бы, что подмена источника тянет за собой перевод.
+- **Фасад знает только контракт, сервис отдаёт только `State`.** Тип из контракта до стора и
+  шаблона не доходит.
+- **У списка один вход — выборка.** Объект, к которому привязан список, тип фида, состояние
+  подписки — такие же условия отбора, и лежат они в `filterModel`.
+- **Ответ списка ложится в общий конвертер целиком.** Контракт отдаёт страницу в той же форме,
+  что и модель, и промежуточного объекта в сервисе не остаётся.
+- **Поля порядка и отбора — перечисления домена, а не голая строка.** Голая строка означает,
+  что имя, по которому сервер не сортирует, компилируется и падает запросом.
+- **Пара отдаёт поток, а не ожидание.** Основа списочного стора работает потоками, и промисный
+  сервис в неё не ложится.
+
+## Чего из закона здесь нет
+
+Общей выборкой ходят только те списки, которым сервер отдаёт страницу — признак `page_model` в
+ответе процедуры. Заявки и объекты приходят целиком: процедуры со страницей у них пока нет, и
+это долги `Q-L-5` и `Q-L-7`, а не другая форма слоя.
+
+Сторы, которые ещё держат прежнюю сигнатуру, зовут поток через `firstValueFrom` и несут над
+классом комментарий с тем, когда мост уйдёт. Новый стор моста не заводит.
+
+## Паттерны
+
+- `api-layer-pair` — готовые фасад, сервис и перевод выборки.
+
+## Ловушки
+
+- **Выборка в ответе — применённая, а не запрошенная.** Порядок по умолчанию и отброшенное
+  сервером условие экран иначе не увидит.
+- **Одна пара — одна сущность.** У объекта, его прежних адресов и подписок на календари свои
+  пары, хотя процедуры лежат в одном proto-сервисе.
+- **Метод, которого у домена нет, не объявляется.** Список читают все, правят не все.
+- **Серверный стрим — исключение из правила про поток:** живой срез аналитики и лента тредов
+  приходят асинхронным итератором, и заворачивать его некуда.
+- Своей копии общих мапперов страницы, порядка и отбора домен не заводит — второй экземпляр
+  ловит `npm run check:dupes`.

package/assets/rules/browser-verification.md

@@ -0,0 +1,87 @@
+---
+name: browser-verification
+kind: rule
+law: verifiability
+description: Правило под «Закон о проверяемости». Брать при любой проверке через браузер и при запросах curl или wget к дев-серверу. Называет порты сайта, админки и API, чему на дев-сервере верить нельзя и чем измерять вместо взгляда. Готовый код — в паттернах browser-verification-stand и browser-verification-measure.
+---
+
+# Проверка работающего приложения — как это устроено здесь
+
+Правило под закон `docs/constitution/verifiability.md`. Закон говорит, что считается
+подтверждением; здесь — где живут приложения, чему на них можно верить и чем измерять. Тесты
+под тем же законом — правило `testing`.
+
+## Как это называется здесь
+
+| В законе                          | Здесь                                                                                           |
+| --------------------------------- | ----------------------------------------------------------------------------------------------- |
+| работающее приложение             | сайт на 4900, админка на 4901, API на 3333 — всё поднято владельцем                             |
+| место, где его видит пользователь | прод-сборка за настоящим `deploy/nginx.conf`, а не дев-сервер                                   |
+| замер                             | `getComputedStyle`, `getBoundingClientRect`, контраст, совпадение центров, попадание во вьюпорт |
+| драйвер браузера                  | `claude-in-chrome` на закреплённом профиле этого дерева                                         |
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Свой дев-сервер не поднимается.** Приложения уже подняты владельцем, и попытка поднять
+  второй экземпляр отбивается гардом.
+- **Браузер водится одним драйвером на закреплённом профиле.** Остальные двери — второй
+  драйвер, `open`, `osascript`, запуск бинарника — закреплённый профиль не спрашивают вовсе.
+- **Выбор браузера протухает и требует повторного вызова.** Выбор, сделанный в начале
+  сессии, не держится: после паузы следующий вызов открывает вкладку в другом профиле молча.
+- **Профиль не выбирается из списка и не спрашивается у владельца.** Список отдаёт неустойчивые
+  имена, которые не опознают ничего, а выбор из него ведёт на профиль без входа.
+- **Прод-конфигурация проверяется только за настоящим прокси.** Голый сервер отдачи страниц
+  про кэш, перенаправления и заголовки не знает ничего.
+
+Вывод о вёрстке подкрепляется числом: «выглядит нормально» результатом проверки не является.
+Этого не стережёт ничто — как измерять, разобрано в паттерне `browser-verification-measure`.
+
+## Чего из закона здесь нет
+
+Проверки на прямое обращение к окружению браузера нет — это `Q-FA-1` в законе о фронтовом
+приложении: такое обращение компилируется и падает только при отдаче страницы сервером.
+
+## Паттерны
+
+- `browser-verification-stand` — честный стенд из прод-сборки, вход в админку, разбор порта.
+- `browser-verification-measure` — замер вместо взгляда, ловушки инструмента `computer`.
+
+## Ловушки
+
+- **Сначала выяснить, что отвечает на порту:** `lsof -nP -iTCP:<порт> -sTCP:LISTEN` до первого
+  запроса. На 3333 регулярно висит собранный артефакт из прошлой сессии — он отвечает 200
+  старым кодом, а заведённой в ветке процедуры у него нет вовсе, и 404 читается как дефект
+  регистрации. Таких процессов бывает несколько; `pkill` по `nx serve api` не попадает ни в
+  один — убивать по PID из `lsof`, каждый.
+- Инкрементальная сборка протухает поштучно: разметка на 4900 бывает уже новая, а клиентский
+  чанк — от компиляции до правки. Признак дев-сборки — имена бандла без хеша (`main.js`).
+  Расхождение между `curl` и страницей после гидратации — повод пересобрать, а не искать
+  дефект в коде. Отсюда же нельзя делать вывод «такого маршрута нет»: сверяться с
+  `app.routes.ts`.
+- **Кэш объясняет расхождение, но не подтверждает его.** В `.angular/cache/…/vite/deps` лежат
+  только пакеты из `node_modules`, кода репозитория там нет вовсе. Вывод «дефекта нет, это
+  кэш» закрывает разбор, поэтому принимается только после проверки на чистой сборке — три
+  круга ушло на застрявшую панель ленты событий, пока дефект лежал в снятии аутлета.
+- Сообщение `Angular debugging APIs are not available` в консоли принадлежит расширению
+  Chrome, а не приложению: прод-сборка не публикует `window.ng`. Лечить правкой кода не надо —
+  `window.ng` в проде это карта внутренностей в руках любого, кто откроет консоль.
+- Поведение роутера воспроизводится нажатиями: подстановка адреса и заход по прямой ссылке
+  поднимают приложение заново, и накопленного состояния у него нет.
+- Замер отвечает только на заданный вопрос. Строки попапа профиля сошлись с образцом по
+  отступам, кеглю и скруглению, а фон на наведении образец в этом месте не красит вовсе —
+  полноширинная подсветка держалась два круга при верных числах.
+- **Если сменилась версия пакета, который рисует вёрстку, экраны обходят руками.** Тесты
+  нажимают по `qa-dataid` и остаются зелёными, даже когда отступ съехал, размер пропал, а
+  строка стала другой высоты: они проверяют переходы, а не вид. Пары скриншотов тут тоже мало
+  — смотрят по очереди все экраны, которые этот пакет рисует.
+- **Путей запуска здесь три, и проверять их надо порознь:** локальная команда, образ
+  `deploy/api.Dockerfile` и состав `docker-compose.prod.yml`. Переменная, заданная в команде
+  проверки, не говорит про образ ничего: в составе прода она есть, а ручной прогон того же
+  образа идёт без неё. Пути перечисляются до проверки, а не после того, как один из них
+  сошёлся.

package/assets/rules/component-structure.md

@@ -0,0 +1,64 @@
+---
+name: component-structure
+kind: rule
+law: frontend-application
+description: Правило под «Закон о фронтовом приложении». Брать при правке любого *.component.ts и его шаблона. Называет порядок свойств декоратора, группировку импортов, договорённости шаблона и обязательный qa-dataid. Готовый код — в паттерне component-structure-new.
+---
+
+# Файл компонента — как это устроено здесь
+
+Правило под закон `docs/constitution/frontend-application.md`. Закон говорит, что должно быть
+верно; здесь — как устроен сам файл компонента и его шаблон. Состояние и потоки —
+`angular-patterns`, стили — `styling-bem`, окружение браузера — `platform-access`, слой
+обращения к серверу — `api-layer`. Все пять под одним законом.
+
+## Как это называется здесь
+
+| В законе                           | Здесь                                                                        |
+| ---------------------------------- | ---------------------------------------------------------------------------- |
+| компонент                          | `vm-<имя>` — префикс один на сайт и админку                                  |
+| готовое, а не вычисление в шаблоне | `computed()`; там, где значение приходит из контекста шаблона, — чистый пайп |
+| якорь для проверки                 | атрибут `qa-dataid` в kebab-case по смыслу элемента                          |
+| корень разметки                    | `:host` с классом блока от `host: { class: 'vm-<имя>' }`                     |
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Шаблон не зовёт методов.** Правило линтера банит `{{ getTotal() }}` и `@if
+(computeFlag())`, чтения сигналов не трогает.
+- **Каждый интерактивный элемент несёт `qa-dataid`.** Это единственный якорь спек: классы BEM
+  меняются вместе с вёрсткой, а поиск по роли и тексту ломается на локалях перевода.
+- **Класс блока висит на хосте, а не на обёртке внутри шаблона.** Лишняя обёртка вокруг всех
+  детей — это раскладка, и ей место на `:host`.
+
+## Чего из закона здесь нет
+
+Порядок свойств декоратора, группировку импортов и самозакрывающиеся теги не проверяет ничто —
+они держатся чтением соседнего файла. Проверки на прямое обращение к окружению браузера тоже
+нет — это `Q-FA-1` в законе.
+
+## Паттерны
+
+- `component-structure-new` — готовый файл компонента и договорённости шаблона.
+
+## Ловушки
+
+- **`href="#id"` в разметке не работает.** Сборка одна на все локали, в разметке стоит
+  `<base href="/">`, и браузер разрешает фрагмент относительно базы: вместо прокрутки
+  получается полная навигация с перезагрузкой. Прокрутка — через роутер:
+  `<a [routerLink]="[]" fragment="booking">`.
+- **Один и тот же компонент в обеих ветках `@if` — это условная привязка.** Две ветки с
+  разными входами пересоздают компонент и теряют его состояние.
+- **Кит, который рисуется в оверлее, из хоста вызывающего не адресуется:** его разметка лежит
+  вне хоста, и `[qa-dataid="x"] button` до кнопок не дотянется. Такие кнопки носят собственные
+  якоря прямо в шаблоне кита, а гард каталог зависимостей не проверяет.
+- **`qa-dataid` не заменяет `aria-label` и роли:** доступность отдельно, якорь отдельно. И не
+  снимается при правке вёрстки — на него завязаны спеки.
+- Готовое из кита не пишется заново: своя разметка с `role="alert"`, `<table>`,
+  `role="dialog"`, `role="tablist"` или `role="tooltip"` означает, что мимо `<префикс>-message`,
+  `<префикс>-table`, `<префикс>-dialog`, `<префикс>-tabs` или `<префикс>-tooltip` прошли. Правило целиком — `reuse-first`.

package/assets/rules/dependencies.md

@@ -0,0 +1,66 @@
+---
+name: dependencies
+kind: rule
+law: delivery
+description: Правило под «Закон о поставке». Брать при правке package.json, pnpm-lock.yaml и pnpm-workspace.yaml и при обновлении любого пакета. Называет точный номер версии вместо диапазона, снимок дерева, подмену чужих версий, выдержку новой версии и границу переформатирования после обновления форматтера. Готовый порядок — в паттерне dependencies-upgrade.
+---
+
+# Зависимости — как это устроено здесь
+
+Правило под закон `docs/constitution/delivery.md`. Закон говорит, что должно быть верно;
+здесь — чем это названо в этом дереве, где лежит и что из закона у нас не применяется. Ветка,
+коммит и выкатка под тем же законом — правило `git-workflow`.
+
+## Как это называется здесь
+
+| В законе                     | Здесь                                                                                              |
+| ---------------------------- | -------------------------------------------------------------------------------------------------- |
+| объявление зависимости       | точный номер в `package.json` — `"prettier": "3.9.6"`; `^` и `~` в файле не встречаются ни разу    |
+| снимок установленного дерева | `pnpm-lock.yaml`; едет тем же коммитом, что и объявление                                           |
+| подмена чужой версии         | `overrides` в `pnpm-workspace.yaml` — там лежат подменённые транзитивные зависимости               |
+| выдержка новой версии        | `minimumReleaseAge`; пакет, нужный раньше срока, выписывается номером в `minimumReleaseAgeExclude` |
+| менеджер пакетов             | pnpm: `npm run` зовёт скрипты, установку делает `pnpm install`                                     |
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Версия пакета записана точным номером.** Из диапазона сегодня и через неделю поставится
+  разное, и откат правки это не исправит.
+- **Подменённые версии чужих зависимостей собраны в один список, и его пересматривают при
+  каждом обновлении.** Подмена, оставшаяся в списке после того, как основной пакет подняли,
+  незаметно откатывает его зависимость назад.
+- **Свежая версия сначала выдерживается, а нужная раньше срока выписывается отдельно.** Иначе
+  выпуск, который автор успел отозвать, попадёт в снимок.
+- **Переформатируется только то, чьё форматирование проверяет линтер.** Обновлённый форматтер
+  меняет все файлы, до которых дотянется, а `.md` и `.json` здесь не проверяет никто: правка в
+  них — просто шум, который придётся читать глазами.
+
+## Чего из закона здесь нет
+
+Никто не сверяет, что объявленные версии совпадают со снимком: `--frozen-lockfile` стоит
+только в выкатке, а она идёт от пуша в главную ветку, то есть уже после мержа. Диапазоны тоже
+не проверяются: один `^` в `package.json` пройдёт все проверки дерева.
+
+## Паттерны
+
+- `dependencies-upgrade` — подъём версий, выбор верхней границы, разбор последствий обновления.
+
+## Ловушки
+
+- **Диапазон пропускает версию, которой в реестре нет.** В объявление кита записали `^0.2.0`,
+  а снимок остался на прежней версии: объявление выглядело верным, но всё собиралось на 0.1.0,
+  где нужного размера у компонента нет вовсе, и главная ветка перестала собираться. Нашли это
+  через две недели — когда понадобилось дерево для сравнения, а сравнивать оказалось не с чем.
+- **Верхнюю границу задают peer-диапазоны, а не последний номер в реестре.** TypeScript
+  остался на 6.0.3 при вышедшей седьмой версии, потому что Angular объявляет `>=6.0 <6.1`.
+  `pnpm install` такую ошибку не ловит: `autoInstallPeers` молча доставляет недостающее.
+- **После обновления плагина линтера появляются правила, которых вчера не было.** eslint 10
+  добавил `no-useless-assignment`, `eslint-plugin-playwright` 2 — сразу три правила. Замечания
+  приходят на файлы, которых правка не касалась, и выглядят её последствиями.
+- Прогон тестов после обновления — правило `testing`: после смены версии Playwright браузер
+  надо поставить заново, и это не регрессия.

package/assets/rules/doc-style.md

@@ -0,0 +1,103 @@
+---
+name: doc-style
+kind: rule
+law: project-documentation
+description: Правило под «Закон о документации проекта». Брать при правке любого .md, включая спеки, а также комментариев в коде, тел коммитов и описаний PR. Называет проверку путей, пары «правка и её документ» и то, что в этом дереве не проверяет ничто. Готовые формулировки — в паттерне doc-style-write.
+---
+
+# Тексты проекта — как это устроено здесь
+
+Правило под закон `docs/constitution/project-documentation.md`. Закон говорит, что должно
+быть верно про тексты; здесь — чем это проверяется в этом дереве и что остаётся за автором.
+Устройство спеков и слоёв документации — правило `spec-driven` под тем же законом; здесь
+только формулировки.
+
+## Как это называется здесь
+
+| В законе                           | Здесь                                                                                                              |
+| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
+| документ                           | любой `.md` вне `docs/archive/`, плюс комментарии в коде, тела коммитов и описания PR                              |
+| путь, названный в документе        | строка с расширением в обратных кавычках — её и ищет проверка                                                      |
+| правка, которую документ описывает | пара из `docs-guard`: правило и его зеркало, `.proto` и спек, хук и его сценарии, переезд файла и README обеих либ |
+| описание прошлого                  | `docs/archive/` — из проверки путей выведено целиком                                                               |
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Путь, названный в документе, существует.** Ссылка на переехавший файл читается как
+  действующее указание, и следующий читатель заводит снятое заново. Судятся документы,
+  которые едут в репозиторий: личный черновик, закрытый `.gitignore` или
+  `.git/info/exclude`, проверка не читает — мёртвая ссылка в нём держала гейт пуша, хотя ни
+  в одну ветку этот файл не попадёт.
+- **Описание прошлого из проверки путей выведено целиком.** Архив по устройству называет
+  файлы, которых уже нет, и правкой это не лечится.
+- **Документ едет в том же коммите, что и правка, которую он описывает.** Обход — строка
+  `Docs-skip: <причина>` в теле коммита; пустая причина не принимается.
+
+## Чего из закона здесь нет
+
+Ни одна из формулировочных договорённостей не проверяется: одна фраза на правило, простые
+слова, отсутствие утверждений о будущем, свежесть числа в тексте. Две последние закон прямо
+оставляет автору: открытый вопрос пишется теми же словами, что и обещание, а дата и номер —
+такие же числа, как то, что пересчитывают.
+
+На комментарии в коде правило распространяется, но гейтом не требуется: он зовёт его только
+на `.md`. Расширять требование на каждый `.ts` значило бы шуметь на каждой правке, поэтому
+здесь оно держится памятью автора — и цена этого видна: слова из левой колонки словаря живут
+в комментариях хуков и `tools/*.mjs` десятками строк, включая текст отказа, который гард
+печатает агенту.
+
+## Паттерны
+
+- `doc-style-write` — как формулировать: примеры «так» и «не так», правила для комментариев.
+- `doc-style-sweep` — разбор документа, накопившего список работ, на действующее и закрытое.
+
+## Ловушки
+
+- **Оставшаяся работа не записывается в документ, а заводится задачей.** `docs/BACKLOG.md`
+  держит только то, что задачей не бывает: договорённости и решения, которые решено не
+  править. Признак — утверждение остаётся, если править его никто не собирается. «Сделать
+  потом» в плане, README или спеке — второй список работ: он расходится с бордой молча, а
+  разбирать его потом дороже, чем завести задачу сразу. Из 1411 строк документа действующими
+  оказались 71, и на разбор остальных ушла отдельная задача. Как разбирать накопившееся —
+  паттерн `doc-style-sweep`.
+- **Словарь действует и на разговор с владельцем, не только на файлы.** Он приходит в контекст
+  на запуске сессии, поэтому «не читал» основанием не бывает. Слово из левой колонки «Так не
+  пишем» всплывало именно в ответах: в дереве его уже вычистили, а в отчёте о сделанном оно
+  оставалось, и владелец читал ровно то слово, от которого отказались.
+- **Термин берётся из `docs/GLOSSARY.md`, а не придумывается на месте.** Слова, которого там
+  нет, у читателя нет тоже: «журнал приложения» простоял в спеке почты, пока владелец не
+  спросил, что это, — оказалось, логи бэкенда, а слово «журнал» здесь уже занято журналом
+  событий. Новое слово либо заводится в словаре вместе с правкой, либо заменяется тем, что
+  уже есть.
+- **Проход по словарю глазами слово не находит.** «Формулировки приведены к словарю» означает
+  ровно те строки, которые в тот момент читали: «спека» пережила такой проход и осталась в
+  соседней строке того же файла. Слово из левой колонки таблицы «Так не пишем» вычищается
+  грепом по всему дереву, а не вычиткой. Форма задаётся точно: «спек» — документ — склоняется
+  в «спека» и «спеки» тоже, и совпадений по корню законных больше, чем нарушений; ищутся
+  сочетания («спеки на … нет», «спека проверяет»), а не корень.
+- **Снятое имя вычищается одним грепом по всему дереву:** правила, их зеркала в скилах,
+  документы и комментарии. Описание того, чего в коде уже нет, читается как действующее
+  указание.
+- **Число в тексте пересчитывается командой в том же коммите, где пишется.** Оно стареет
+  внутри одной ветки: «шестнадцать пар» стало неправдой через два коммита после того, как
+  было написано, и нашёл это владелец, а не проверка. Число, которое придётся пересчитывать
+  при каждой правке, лучше не писать вовсе. Число, полученное разбором текста, сверяется на
+  выборке руками до того, как его называют: разбор, не знающий второй формы записи, ошибается
+  молча — «51 пункт без задачи» оказался шестью, потому что номер стоял и отдельной строкой, и
+  в заголовке подраздела.
+- **Сделанность читается по дереву, а не по тексту, который о ней написан.** Это верно в обе
+  стороны: строка про README обеих либ была вычеркнута как сделанная, а README остался с
+  прежним числом импортёров; задача, названная владельцу несделанной, оказалась наполовину
+  закрытой и покрытой сценариями хука. Пункт плана и тело задачи описывают день, когда их
+  написали, и с тех пор не менялись.
+- **Комментарий в файле — такое же утверждение, как строка в документе.** Обоснование «строки
+  идут во всю ширину панели, иначе подсветка обрывается» было выдумано, прожило три сессии и
+  каждый раз читалось как основание вёрстку не трогать.
+- **Чужие проекты не упоминаются нигде** — ни имени репозитория, ни «портировано из», ни
+  ссылок на его файлы. Описывается то, что код делает здесь, в терминах этого проекта.

package/assets/rules/entity-conventions.md

@@ -0,0 +1,78 @@
+---
+name: entity-conventions
+kind: rule
+law: entity-editing
+description: Правило под «Закон о правке сущности». Брать при правке любого стора админки (*.store.ts) и любой панели создания или правки записи. Называет общую основу асайда, общую основу списочного стора, устройство панели и то, что асайд открывается маршрутом в аутлете ro. Готовый код — в паттернах entity-aside и entity-store.
+---
+
+# Правка сущности — как это устроено здесь
+
+Правило под закон `docs/constitution/entity-editing.md`. Закон говорит, как ведёт себя
+приложение при создании и правке записи; здесь — из чего это собрано в этом дереве и как
+выглядит. Про вид говорит правило: закон о нём молчит намеренно.
+
+## Как это называется здесь
+
+| В законе                      | Здесь                                                                    |
+| ----------------------------- | ------------------------------------------------------------------------ |
+| панель правки записи          | асайд; открывается маршрутом с `outlet: 'ro'`                            |
+| общая основа асайда           | `RtRouteAsideComponent<T>` — директива без селектора                     |
+| общая основа списочного стора | `BaseListStoreService`                                                   |
+| запись                        | `entity`, `entityId`, `isCreateMode` — имена от сущности, а не от домена |
+| обвязка записи                | `runMutation` в панели, `mutate` в сторе                                 |
+| нетронутость формы            | `pristineSignal(control)`                                                |
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Асайд открывается маршрутом в аутлете `ro`, а не вызовом сервиса.** Программного открытия
+  через `RtAsideService.open()` в админке нет: так панель переживает перезагрузку, передаётся
+  ссылкой и попадает в историю браузера.
+- **Запись идёт через `runMutation`, и панель отдаёт основе поток мутации и ключи.** Занятость,
+  гашение прежней ошибки, тост об успехе и закрытие держит основа.
+- **Поток мутации обязан отдать значение или ошибку.** Пустой поток гасит панель навсегда:
+  она ждёт того или другого, а закрыть её владелец не может, пока идёт запись.
+- **Мутация завершается перечитанным списком, а не отправленным запросом.** Список,
+  перечитанный после закрытия, показал бы прежнее значение.
+- **Стор отвечает потоком: успех — значение, отказ — ошибка потока.** Булева ответа у сторов
+  админки не осталось: он терял и записанную запись, и причину отказа.
+- **Имена берутся от сущности, а не от домена.** `save`, `remove`, `load` — не
+  `createBooking`, `loadBookings`: имя домена уже в имени стора.
+- **Гард несохранённых правок ставит сама панель и на все четыре пути закрытия.** Проверять
+  один путь бессмысленно — Esc обойдёт то, что ловит кнопка. Четыре пути — кнопка в шапке,
+  кнопка в футере, нажатие мимо панели и Esc.
+- **Уход из панели идёт через `openRelated`, а не своим `router.navigate`.** Абсолютные
+  команды меняют только первичную ветку, аутлет `ro` остаётся в адресе, и роутер отклоняет
+  навигацию молча.
+- **Запись читается по идентификатору из адреса полной моделью, а не берётся из списка.**
+  Список отдаёт короткую.
+
+## Чего из закона здесь нет
+
+Чтение записи отдельной процедурой заведено не везде — долг `Q-M-3`. Файл стора называется
+`<сущность>.store.ts`; имя `<сущность>-store.service.ts` выводит его и из правила линтера, и
+из гейта скилов, и общие сторы заявок и объектов правятся без правил сущностей вовсе.
+
+## Паттерны
+
+- `entity-aside` — собрать панель правки: маршрут, основа, `runMutation`, шапка и футер, гард.
+- `entity-store` — собрать стор сущности: наследник общей основы, `mutate`, ключи отказа.
+
+## Ловушки
+
+- Действие со своей занятостью через основу не идёт: опрос подписки держит свой `pollingId`,
+  потому что панель на минуту опроса не гасится.
+- Хвост с `EMPTY`, приклеенный к мутации, гасится `defaultIfEmpty`: иначе отказ приклеенного
+  потока превращает удачную запись в вечный спиннер.
+- `routerLink` в панели не годится: директива навигирует сама, `preventDefault` её не
+  останавливает, и вопрос о несохранённых правках она обходит.
+- `viewChild` на поле с `#` Angular не принимает — поле объявляется `protected`.
+- Скелетоны полей идут по `resolving()`, не по `busy()`: `busy` включает и запись, и чтение.
+- Панель, которая после успеха остаётся открытой, сбрасывает нетронутость сама.
+- Ветка, куда забыли подмешать константу ro-маршрута, отличается только тем, что кнопка в
+  шапке на ней ничего не открывает: сборка, линт и маршруты остальных веток при этом целы.

package/assets/rules/entity-models.md

@@ -0,0 +1,70 @@
+---
+name: entity-models
+kind: rule
+law: entity-models
+description: Правило под «Закон о моделях сущностей». Брать при объявлении или правке модели записи и её маппера в админке, при правке моделей и мапперов в libs/common/util и при правке .proto. Называет неймспейс I<Сущность>, уровни модели и что берётся из @rt-tools/utils. Готовый код — в паттерне entity-models-new.
+---
+
+# Модели сущностей — как это устроено здесь
+
+Правило под закон `docs/constitution/entity-models.md`. Закон говорит, сколько данных
+приложение запрашивает на каждом экране; здесь — как эта модель объявляется в этом дереве.
+
+## Как это называется здесь
+
+| В законе                 | Здесь                                                                |
+| ------------------------ | -------------------------------------------------------------------- |
+| сторона контракта        | `Api` — псевдоним сгенерированного типа из `@<область>/common/proto` |
+| то, чем пользуется экран | `State`, все поля `readonly`                                         |
+| то, что уходит на запись | `Draft`                                                              |
+| короткий уровень         | вложенный неймспейс `Short` с собственными `Api` и `State`           |
+| перевод                  | маппер-наследник `BaseMapper`, свой на каждый уровень                |
+
+Все три стороны лежат в одном неймспейсе `I<Сущность>` и спутать их в импортах нечем.
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **У сущности две стороны, и обе лежат в неймспейсе `I<Сущность>`.** `Api` повторяет
+  контракт, `State` нормализован и от смены контракта не зависит.
+- **Сторона контракта руками не пишется — она объявляется псевдонимом.** Своя копия разойдётся
+  с контрактом молча, а компилируется из них только одна.
+- **Между сторонами стоит маппер-наследник `BaseMapper`, и экраны читают только `State`.** Тип
+  из контракта в шаблон не попадает.
+- **Пустое выражается пустой строкой или нулём, а не отсутствием поля.** Необязательных
+  скаляров в контракте нет, поэтому `null` и `undefined` в `State` не заводятся; смысл нуля
+  объясняется комментарием рядом с полем.
+- **Приведение идёт через `this.typeCast`, а не через `??`.** Контракт отдаёт значения по
+  умолчанию, а не пустоту, и проверка на `undefined` здесь не ловит ничего.
+- **Типы страницы, порядка и отбора берутся из `@rt-tools/utils`.** Второго набора этих типов
+  в дереве нет: `rt-pagination` принимает `IPageModel` оттуда же.
+
+## Чего из закона здесь нет
+
+Уровней нет ни у одной сущности, и контракт короткого сообщения не отдаёт — долги `Q-M-1` и
+`Q-M-2`. Новая сущность заводится сразу с уровнями.
+
+Правка `.proto` не проверяется ничем: `buf lint` и `buf breaking` настроены, но не входят ни в
+`check:all`, ни в CI.
+
+## Паттерны
+
+- `entity-models-new` — объявить модель и маппер: неймспейс, уровни, `typeCast`, перегенерация
+  контракта.
+
+## Ловушки
+
+- `getAsType` умолчания не принимает: значение вне набора он пишет в консоль и возвращает
+  строкой `'unknown'`. Строковое поле с конечным набором значений сверяется с набором явно.
+- `as Type` в маппере запрещено — правило `typescript-conventions`.
+- Поле-сообщение необязательно всегда; обязательное поле модели им не заполнить без запасного
+  значения. Обратно, в запрос, `readonly`-массив не проходит: init-тип требует изменяемый.
+- Модель админки и модель сайта — разные. Общий тип на два приложения означал бы, что сайт
+  тянет поля админки.
+- Снятое поле контракта помечается `reserved` с номером и именем: номер, отданный новому полю,
+  ломает уже выкаченного клиента молча.