@rt-tools/agent-kit 0.3.0 → 0.4.0

package/assets/rules/git-workflow.gitlab.md

@@ -0,0 +1,113 @@
+---
+name: git-workflow
+kind: rule
+law: delivery
+description: Правило под «Закон о поставке» для дерева на GitLab. Брать на заведение задачи, ветки, коммит, пуш, создание MR, слияние, а также на правку схемы хранилища, её миграций и вызовы миграций. Называет задачу на борде как начало работы, колонку задачи как ход работы, соответствие задачи и ветки один к одному, имя ветки, формат коммита, учётную запись машинной работы, обязательный состав MR, гарды поставки и сверку очереди работ. Готовый код — в паттернах git-workflow-commit, git-workflow-merge, git-workflow-migration и git-workflow-restart.
+---
+
+# Поставка — как это устроено здесь
+
+Правило под закон `docs/constitution/delivery.md`. Закон говорит, что должно быть верно;
+здесь — каким приёмом это держится в дереве, лежащем на GitLab. Ключ задач, адрес борды,
+учётная запись машинной работы и области коммита — при этом дереве, в `implementation.md`
+рядом: их не угадать, и общими они не бывают.
+
+## Как это называется здесь
+
+| В законе                         | Здесь                                                                                                                                                                                                 |
+| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| главная ветка                    | `main`                                                                                                                                                                                                |
+| отдельная ветка                  | `<КЛЮЧ>-<номер задачи>-<короткий-slug>`; ключ задач — в `implementation.md`. Имя без номера (`feat/…`, `fix/…`) законно, пока ветка живёт локально: MR с неё не откроется                             |
+| задача                           | issue проекта, заголовок `[<КЛЮЧ>-<номер>] <Что не так>`, исполнитель — учётная запись машинной работы; MR прикрепляется к нему строкой `Closes #<номер>` в описании                                  |
+| очередь работ                    | доска задач проекта — Issue Board. Задача попадает на неё меткой списка, а не самим фактом заведения: доска показывает те issue, чью метку знает                                                      |
+| состояние задачи в очереди работ | список доски, за которым стоит метка: заведённая, взятая в работу, ждущая разбора. Имена меток — в `implementation.md`; закрытая задача уходит из очереди слиянием, а не переносом в последний список |
+| отчёт о задаче                   | заголовок MR `[<КЛЮЧ>-<номер>] <Что сделано>` — тот же номер, что у задачи, и её название, переведённое в сделанное; тип и область коммита сюда не идут                                               |
+| обсуждение правки                | разбор MR: ревьювер — владелец проекта, исполнитель — учётная запись машинной работы, метки — те же, что у задачи                                                                                     |
+| попадание правки в главную ветку | слияние MR; оно же запускает выкатку — `.gitlab-ci.yml`                                                                                                                                               |
+| образ того коммита               | `IMAGE_TAG=<sha>` в командах `docker compose` на сервере                                                                                                                                              |
+| изменение хранилища              | миграция в `prisma/migrations/<метка>_<имя>/`                                                                                                                                                         |
+| запись о правке                  | коммит формата `type(scope): description` — типы `feat`, `fix`, `refactor`, `docs`, `style`, `test`, `chore`, `perf`; области — в `implementation.md`                                                 |
+| автор машинной работы            | отдельная учётная запись; её имя и место токена — в `implementation.md`. Токен лежит вне репозитория                                                                                                  |
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Коммит в главную ветку отбивается гардом.** Гард ищет вызов коммита в любом месте команды
+  и смотрит текущую ветку на момент запуска, поэтому составная «создать ветку и сразу
+  коммитить» отклоняется целиком: ветки в момент разбора ещё нет.
+- **Ветка без номера задачи MR не открывает.** Гард поставки отбивает `glab mr create` с такой
+  ветки: локально она законна, но правка из неё — это выкатка, за которой в очереди работ
+  ничего не стоит. Заводится задача, и работа переносится в ветку с её номером.
+- **Номер ветки и номер в заголовке MR сверяются на месте, а состояние задачи — по доске.**
+  Формат читается из текста команды и работает без сети; существование задачи, её метка
+  списка, исполнитель и то, что она ещё открыта, — только когда есть чем спросить. Нет сети
+  или нет токена — второй ярус молча пропускается: проверка, падающая в самолёте, перестаёт
+  что-либо значить.
+- **Список задачи двигается тем же движением, что и работа.** Ветка заведена — задача
+  переставляется во взятые в работу, MR открыт — в ждущие разбора; делает это команда
+  перевода, а не набор вызовов по памяти. Перевод идёт сразу за шагом, который его вызвал:
+  очередь работ читают между шагами, а не после них.
+- **Отставший список находится сверкой очереди, а не глазами.** Сверка судит список по отчёту
+  в обе стороны: открытый MR при задаче не в разборе и разбор без открытого MR — оба
+  расхождения. Момента, когда задачу берут в работу, ей не видно: ветки на доске нет.
+- **Задачи, чинящиеся одной правкой, сливаются до слияния ветки.** Вторая стирается вместе с
+  номером, а недостающее из неё дописывается в первую. После слияния слить уже нельзя: ветка
+  въехала, и откатывается она целиком.
+- **Слияние в главную ветку выкатывает прод.** Правила `only`/`rules` конвейера покрывают
+  документы отдельно, поэтому переменные окружения, секреты и записи имён ставятся до слияния,
+  а не после.
+- **Признак режима объявлен в образе, а не только в составе прода.** Значение, заданное
+  составом, действует лишь на контейнер, поднятый этим составом; ручной прогон того же образа
+  идёт с пустым значением, а пусто здесь означает локалхост — со всеми отладочными
+  умолчаниями, которые он разрешает. Умолчание образа задаётся в самом образе.
+- **Образы выкатываются по sha коммита, а не по метке «последний».** Метка в реестре отстаёт
+  от главной ветки, и прод молча возвращается к прежней версии, продолжая отвечать.
+- **Цепочка миграций прогоняется с пустого хранилища до слияния.** Порядок применения
+  лексикографический по имени каталога, а метку времени ставит момент создания: миграция из
+  ветки, начатой раньше, встаёт перед той, от которой зависит.
+- **Документ едет в том же коммите, что и правка.** Обход — строка `Docs-skip: <причина>` в
+  теле коммита; пустая причина не принимается.
+- **Заголовок коммита сверяется с форматом на месте.** Разобранный по типу и области
+  заголовок читается списком, а свободный текст — только целиком.
+- **Перед пушем прогоняются все линтеры, а не один.** Линтер кода обычно не читает файлы
+  стилей вовсе, и правила оформления без второго прогона не проверяет ничто.
+- **Слияние по кнопке «Merge when pipeline succeeds» не заменяет проверок до пуша.** Конвейер
+  видит только то, что уже отправлено, а отправленная красная ветка занимает очередь работ и
+  выглядит готовой к разбору.
+- **Метки и исполнитель MR ставятся при создании, а не правкой после.** `glab mr create`
+  принимает их флагами; правка открытого MR второй командой обходится молча, когда токен
+  учётной записи машинной работы не видит проект целиком.
+- **Задача переводится по списку правкой её меток.** Списки доски — это метки: перевод, не
+  снявший прежнюю метку, оставляет задачу в двух списках сразу, и очередь читается неверно.
+- **Сценарии гардов задают настройки git сами, а не берут их с машины.** Коммит во временном
+  репозитории сценария наследует общий конфиг: если включена подпись, git идёт в агент ключей,
+  а заблокированный агент роняет весь набор — со стороны это выглядит сломанным гардом. Автор,
+  почта и подпись передаются флагами `-c` прямо в команду.
+- **Расхождение миграций со схемой меряется на теневом хранилище, а не на том, где работает
+  тот, кто пушит.** Оно законно несёт след любой недоделанной ветки, и сверка с ним держала бы
+  чужую правку. Гейт и выкатка зовут одну и ту же проверку — иначе «сошлось» станет значить в
+  двух местах разное.
+
+## Чего из закона здесь нет
+
+Гард поставки стоит на командах агента, поэтому ветку, заведённую руками в редакторе, он не
+видит: имя такой ветки держится памятью. Требование от этого не слабеет — просто отдельной
+проверки под него не заводится: работа опознаётся заголовком задачи и отчёта, а это сверяется
+у всех. Сверка очереди имя ветки не судит вовсе: у открытого MR его не переименовать.
+
+Взятие задачи в работу не стережёт ничто: доска ветки не видит, а гард поставки её видит, но
+доску не правит — сетевой вызов в разборе команды падал бы вместе со связью и отбивал бы
+работу вместо промаха. Держится это памятью и подсказкой, которую печатает команда заведения
+задачи. Отставший список находит сверка очереди — но уже после того, как MR открыт.
+
+## Паттерны
+
+- `git-workflow-commit` — задача, ветка, коммит, пуш и MR от учётной записи машинной работы.
+- `git-workflow-merge` — главная ветка влита в ветку задачи, конфликт разобран.
+- `git-workflow-migration` — правка схемы хранилища и её миграций.
+- `git-workflow-restart` — ручной перезапуск прода.

package/assets/rules/lib-layers.md

@@ -2,37 +2,64 @@
 name: lib-layers
 kind: rule
 law: lib-imports
-description: Правило под закон «Импорты между либами». Брать при правке манифестов проектов, алиасов, конфигов границ, любого бареля и проверок раскладки, а также когда решается, где живёт общий символ. Готовый порядок действий — в паттернах lib-layers-new и lib-layers-move. Чем это названо здесь — в implementation.md рядом.
+description: Правило под «Закон об импортах между либами». Брать при правке project.json, tsconfig.base.json, eslint/boundaries/**, любого src/index.ts и проверок раскладки, а также когда решается, где живёт общий символ. Называет семьи, слои, теги и границы этого дерева. Готовый порядок действий — в паттернах lib-layers-new и lib-layers-move.
 ---
 
-# Импорты между либами — каким приёмом
+# Импорты между либами — как это устроено здесь
 
-Правило под закон `{{lawsDir}}/lib-imports.md`. Закон говорит, кто кого видит; здесь — каким
-приёмом это держится. Как нарезаны семьи и слои в этом дереве, чем названы теги и где лежат
-конфиги границ — `implementation.md` рядом.
+Правило под закон `docs/constitution/lib-imports.md`. Закон говорит, кто кого видит; здесь —
+как это нарезано в этом дереве, чем названо и чего у нас нет.
 
-## Когда берётся
+## Как это называется здесь
 
-Правка манифеста проекта, алиасов, конфига границ, любого бареля, проверок раскладки. И раньше
-всего этого — решение, в какой либе живёт общий символ.
+| В законе                         | Здесь                                                  |
+| -------------------------------- | ------------------------------------------------------ |
+| семья либ                        | `libs/site`, `libs/admin`, `libs/api`                  |
+| слой                             | `api`, `data-access`, `feature`, `shell`, `ui`, `util` |
+| право видеть либу                | тег в `eslint/boundaries/domains/<семья>.config.mjs`   |
+| общая всем трём приложениям либа | `libs/common/util`, тег `scope:common-util`            |
+| основание семейства              | `<семья>/core`; его тег входит в `ADMIN_UNIVERSAL`     |
+| барель                           | `src/index.ts` либы и `index.ts` каталога компонента   |
 
-## Что здесь действует
+Фичевый домен фронта — шесть слоёв (`api`, `data-access`, `feature/<экран>`, `shell`, `ui`,
+`util`), общий домен — те же без `shell`. У бэкенда `ui` и `shell` нет: отдавать разметку и
+роутиться ему нечем.
 
-- **Чужой символ не реэкспортируется ни одной из двух форм.** Запрещены и прямой реэкспорт по
-  алиасу, и пара «импорт плюс экспорт того же имени»: вторая выглядит как собственное
-  объявление и глазами в разборе проходит.
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Чужой символ не реэкспортируется ни одной из двух форм.** Запрещены и
+  `export { X } from '@<область>/…'`, и пара «импорт плюс `export { X };`»: вторая
+  выглядит как собственное объявление и глазами в ревью проходила.
 - **Строка с алиасом чужой либы в бареле — тот же реэкспорт.** Относительный путь в бареле
   законен: он собирает наружу собственные файлы либы.
 - **Не хватает права — оно дописывается строкой в конфиге домена с комментарием.** Импорт,
   который «просто заработал», означает, что тег ещё не сужен.
-- **У либы, общей всем приложениям, список зависимостей пуст, и каркас фронта туда не
-  попадает.** Её импортирует и серверная сторона, и каркас уехал бы в её сборку; общий двум
-  фронтовым семьям токен внедрения живёт отдельной либой.
-- **Основание семейства видит только слой утилит.** Его зовут все домены семьи, и любая его
+- **У `libs/common/util` список зависимостей пуст, и Angular туда не попадает.** Либу
+  импортирует бэкенд, и фреймворк уехал бы в его бандл; токен DI, общий двум фронтовым
+  семьям, живёт в `common/platform`.
+- **Основание семейства видит только `util`.** Его зовут все домены семьи, и любая его
   зависимость становится общей для всех сразу.
-- **Домен заводится под предмет, а не под механику.** Механика, общая нескольким доменам, едет
-  в либу, которой она уже видна: у фронта это основание семейства, у серверной стороны — слой
-  утилит, перечисленный у каждого домена.
+- **Домен заводится под предмет, а не под механику.** Механика, общая нескольким доменам,
+  едет в либу, которой она уже видна: у фронта это основание семейства, у бэкенда — слой
+  `util`, перечисленный у каждого домена.
+- **Домен, у которого непуст один слой, значится строкой с причиной.** Иначе он неотличим от
+  слота: пустые слои есть и у того, и у другого, а барель лежит в обоих.
+
+## Чего из закона здесь нет
+
+Отклонение основания семейства от лесенки сегодня одно и названо в `CORE_EXCEPTIONS`
+проверки: `common/proto` и `common/connect` у `admin/core` ради транспорта Connect.
+
+Полный набор слоёв требуется у всех, и пустой слой дефектом не считается: `api` пуст у
+домена, который ни с кем чужим не говорит. Судится только крайний случай — непуст ровно один
+слой; такой домен обычно один, и он стоит в списке исключений с
+причиной.
 
 ## Паттерны
 
@@ -41,14 +68,13 @@ description: Правило под закон «Импорты между либ
 
 ## Ловушки
 
-- **Либа, которую никто не импортирует, не проверена ничем.** Линтер и тесты проверяют её саму,
-  а не договор с потребителем: потерянное поле в модели ошибкой не считается, пока нет
-  вызывающего кода. Первый импортёр и есть первая проверка — слой моделей принимается после
-  сборки и живого прогона сценария, а не по зелёному линтеру с тестами.
-- **Проверка раскладки принимается на нарушении, а не на зелёном прогоне.** Нарушение вносится
-  руками, прогон краснеет, правка снимается. У самих проверок тестов обычно нет, и это
-  единственная их приёмка.
-- **Удаление каталога средствами гита оставляет то, что гит не отслеживал.** Кэш сборщика
-  внутри удалённой либы остаётся на диске, и проверка продолжает видеть её как домен без слоёв.
-- **Пустой слой механики неотличим от слота под будущую задачу.** Проверка требует полного
-  набора слоёв у всех, и оба случая выглядят одинаково.
+- **Либа, которую никто не импортирует, не проверена ничем.** `nx lint` и `nx test` проверяют
+  её саму, а не договор с потребителем: потерянное поле в `*.State` ошибкой не считается, пока
+  нет вызывающего кода. Первый импортёр и есть первая проверка — слой моделей принимается
+  после `nx build` и живого прогона сценария, а не по зелёному `lint test`.
+- **Проверка принимается на нарушении, а не на зелёном прогоне.** Нарушение вносится руками,
+  прогон краснеет, правка снимается. У проверок в `tools/` тестов нет, и это единственная
+  приёмка.
+- `git rm -r` оставляет `node_modules/.vite` внутри удалённого каталога, и проверка продолжает
+  видеть его как домен без слоёв. Добивать `rm -rf`.
+- Образец, написанный второй раз, ловит `npm run check:dupes` — правило `shared-code`.

package/assets/rules/lists.md

@@ -0,0 +1,73 @@
+---
+name: lists
+kind: rule
+law: lists
+description: Правило под «Закон о списке записей». Брать при правке списочного экрана (libs/admin/*/feature/list), таблицы и пагинации кита. Называет порядок блоков, чем собирается список, где живёт выборка и что уже есть в ките. Готовый код экрана — в паттерне admin-lists-screen.
+---
+
+# Списочный экран — как это устроено здесь
+
+Правило под закон `docs/constitution/lists.md`. Закон говорит, что пользователь видит и
+делает; здесь — из чего этот экран собирается в этом дереве и как он выглядит. Про вид
+говорит правило: закон о нём молчит намеренно.
+
+## Как это называется здесь
+
+| В законе                  | Здесь                                                                     |
+| ------------------------- | ------------------------------------------------------------------------- |
+| таблица записей           | `rt-table` из `@rt-tools/ui-kit-v2`, вход `[dataSource]`                  |
+| состав и порядок столбцов | `[columnsConfig]`, хранятся по ключу `tableId`                            |
+| карточка на узком экране  | ветка `<префикс>-table`, а не своя разметка                               |
+| тулбар                    | `<префикс>-toolbar` со слотами `vmToolbarLeft` и `vmToolbarRight`         |
+| выборка                   | `IList.Query.State` — страница, сортировка, условия отбора, строка поиска |
+| панель настройки столбцов | асайд по маршруту `path: 'table-settings'`                                |
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Список собирается `<префикс>-table`, а не своей разметкой.** Скелетоны, пустое состояние,
+  карточки на узком экране и настройка столбцов — входы таблицы; свой
+  `@if (rows().length === 0)` означает, что экран собран мимо неё.
+- **Строки объявляются на `rowsTable.displayedColumns()`, а не на своём списке.** Столбец с
+  меню таблица добавляет сама.
+- **Клик по строке открывает запись, а меню — для действий над ней.** Вид нажимаемой строки
+  даёт `clickable`, активацию мышью и с клавиатуры — `vmTableRow`; клик по кнопке внутри строки
+  активацией не считается.
+- **Доступность действия лежит полем строки, а не вызовом метода компонента.** Метод из шаблона
+  пересчитывался бы на каждой проверке.
+- **Недоступное сейчас действие в меню строки не рисуется вовсе.** Пункт заводится под `@if` по
+  полю строки, а не выключенным: выключенный пункт перечисляет владельцу запреты вместо того,
+  что он может сделать, и набор их меняется от строки к строке.
+- **Кнопка меню не показывается, если у строки не осталось доступных действий.** За это
+  отвечает вход `[rowHasActions]` — предикат по строке; считать по содержимому меню нельзя,
+  спроецированный шаблон известен только после отрисовки.
+- **Отказ загрузки подаётся тостом, а не строкой над таблицей.** Ключ отказа читается сразу
+  после запроса, а не подпиской на сигнал стора: стор делят список и панель правки.
+- **Экран берёт сортировку и условия отбора из ответа, а не из своего запроса.** Сервер мог
+  применить умолчание домена или отбросить условие.
+- **Строка списка получает короткую модель сущности, а не полную.**
+
+## Чего из закона здесь нет
+
+Страницу отдаёт только та процедура, в чьём ответе есть `page_model`; заявки и объекты
+приходят целиком — долги `Q-L-5`, `Q-L-7` и `Q-M-2`. Выборка живёт в адресе не у каждого
+списка — долг `Q-L-4`.
+
+## Паттерны
+
+- `admin-lists-screen` — собрать экран: порядок блоков, таблица, меню строки, сортируемый
+  заголовок, тулбар.
+
+## Ловушки
+
+- Без `[vmTableRowActionsRowType]` тип `let-row` выводится как `unknown`, и падает только
+  продовая сборка — юниты и дев-сервер проходят.
+- Прокрутке нужны оба правила вместе: контейнер с `overflow-x`, таблица с
+  `min-width: max-content`. С одним столбцы сжимаются вместо сдвига.
+- Тулбар и пагинация своих классов не носят: промежуток задаёт `<префикс>-page`.
+- Заголовок стоит в своём `<header>`, а не внутри тулбара.

package/assets/rules/navigation.md

@@ -0,0 +1,78 @@
+---
+name: navigation
+kind: rule
+law: navigation
+description: Правило под «Закон о навигации по разделам». Брать при правке декларации меню, libs/admin/common/container/**, apps/admin/src/app/app.routes.ts и любого libs/admin/**/*.routes.ts. Называет декларацию меню, колонки и группы панели, гейтинг и вложение адресов. Готовый код — в паттерне admin-nav-item.
+---
+
+# Навигация админки — как это устроено здесь
+
+Правило под закон `docs/constitution/navigation.md`. Закон говорит, как пользователь
+находит раздел и попадает в него; здесь — из чего меню собрано в этом дереве и как
+выглядит. Про вид говорит правило: закон о нём молчит намеренно.
+
+## Как это называется здесь
+
+| В законе                 | Здесь                                                                   |
+| ------------------------ | ----------------------------------------------------------------------- |
+| пункт меню               | запись в декларации `admin-nav.items.ts`                                |
+| раздел с панелью         | пункт с колонками; своего адреса не имеет                               |
+| панель второго уровня    | попап `rt-page-header` из пакета кита, разложенный колонками и группами |
+| признак непросмотренного | точка, приходит предикатом по идентификатору пункта                     |
+| флаг «экрана ещё нет»    | `disabled` в декларации                                                 |
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Пункт объявляется один раз и служит источником и меню, и гейтинга маршрутов.** Второе
+  объявление рядом с маршрутами разошлось бы с первым, и получилось бы «пункта не видно, а
+  страница открывается».
+- **Декларация не импортирует ни один `shell`.** Иначе граф `shell → container/feature → shell`
+  замкнётся и проверка раскладки встанет.
+- **Гейтинг двухслойный: право пользователя и флаг раздела.** Пункт с флагом объявляется без
+  прав и без адреса — право открывает экран, а экрана нет; виден он при этом всем.
+- **Данные домена приходят в шапку токеном, а не импортом.** Интерфейс и `InjectionToken` живут
+  в `container/util`, связывает их с реализацией композиционный корень.
+
+## Чего из закона здесь нет
+
+В меню стоят семнадцать пунктов второго уровня и раздел «Финансы», у которых экрана пока нет:
+они выкачены недоступными, потому что исчезнувший пункт неотличим от того, которого никогда
+не было.
+
+Отрисовка самой шапки живёт в `rt-page-header` из `@rt-tools/ui-kit-v2`. Проект её не пишет и
+не может нарушить: он объявляет пункты, а рисует их кит. Китом заданы:
+
+- подсказка у недоступного пункта и `aria-disabled` вместо нативного `disabled`;
+- подсветка раздела по префиксу адреса;
+- открытие панели второго уровня наведением, а на касании — нажатием;
+- раскладка панели колонками, внутри колонки — группами с подписью; если первая группа в
+  колонке без заголовка, её пункты начинаются от верха панели;
+- ширина панели по числу колонок, а не по длине подписей, и её помещаемость от своего
+  раздела до правого края экрана;
+- указатель раскрытия у раздела с панелью и его отсутствие у раздела без неё;
+- отдельная мобильная раскладка: меню сворачивается в кнопку, раскрывается теми же разделами
+  и группами и прокручивается, когда пункты не помещаются по высоте.
+
+Ничего из этого правило к коду проекта не привязывает: привязывать нечего.
+
+## Паттерны
+
+- `admin-nav-item` — завести пункт меню и его маршрут: декларация, права, флаг, вложение
+  адреса, подпись во всех локалях.
+
+## Ловушки
+
+- Обработчика нажатия у недоступного пункта нет вовсе: `aria-disabled` нажатие не отбивает.
+- Ветка, куда забыли подмешать константу ro-маршрута, отличается только тем, что кнопка в
+  шапке на ней ничего не открывает.
+- Группы внутри раскрытого раздела на узком экране отдельно не сворачиваются, поэтому в
+  множестве раскрытых лежат только идентификаторы разделов.
+- Ширина панели считается числом колонок, а не содержимым; числа задаются токенами `--rt-*`,
+  сырые значения запрещены правилом стилей.
+- Переезд адреса трогает ссылки и спеки e2e — они ходят по адресам.

package/assets/rules/ownership-scope.md

@@ -0,0 +1,63 @@
+---
+name: ownership-scope
+kind: rule
+law: ownership
+description: Правило под «Закон о владеющей сущности». Брать, когда процедура или экран работает с записью, принадлежащей владеющей сущности — разрешение идентификатора, умолчание при единственной действующей, сводки по всем. Называет обе формы разрешения и коды отказа. Готовый код — в паттерне ownership-scope-resolve. Чем это названо здесь — в implementation.md рядом.
+---
+
+# Владеющая сущность — как это устроено здесь
+
+Правило под закон `docs/constitution/application/ownership.md`. Закон говорит, что должно быть
+верно; здесь — каким приёмом это держится. Как владеющая сущность названа в этом дереве и какие
+экраны считаются сводками — в `implementation.md` рядом.
+
+## Как это называется здесь
+
+| В законе                           | Здесь                                                                           |
+| ---------------------------------- | ------------------------------------------------------------------------------- |
+| владеющая сущность                 | запись своего домена; в запросах — поле `<сущность>_id`                         |
+| пустой идентификатор               | пустая строка, а не отсутствующее поле: необязательных скаляров в контракте нет |
+| сводка                             | списки и статистика, отвечающие сразу по всем действующим                       |
+| отказ при двух и более действующих | `Code.InvalidArgument`                                                          |
+| отказ, когда действующих нет вовсе | `Code.FailedPrecondition`                                                       |
+| ненайденный явный идентификатор    | `Code.NotFound`                                                                 |
+
+У списков, переведённых на общую выборку, идентификатор отдельным полем запроса не приходит
+вовсе: это условие отбора в модели фильтра, а прежний номер поля помечен `reserved`.
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Запись принадлежит владеющей сущности, а не системе.** Общих настроек, действующих сразу
+  на все, нет: заведение второй не меняет поведение первой.
+- **Пустой идентификатор означает единственную действующую.** Пока она одна, клиент вправе её
+  не называть.
+- **При двух и более действующих запрос обязан назвать сущность.** Умолчание перестаёт быть
+  однозначным, и запрос отбивается как неверный.
+- **Названная явно находится, даже если она скрыта.** У скрытой остаются записи, деньги и
+  переписка.
+- **Там, где показана сводка, пустой идентификатор означает все действующие.** Списки и
+  статистика отвечают по всему набору, а не требуют сперва выбрать одну.
+- **Когда действующих нет вовсе, запрос отбивается.** Скрытая вместо отсутствующей действующей
+  не подставляется.
+
+## Паттерны
+
+- `ownership-scope-resolve` — разрешение сущности в процедуре и обе формы умолчания.
+
+## Ловушки
+
+- **Разрешение разложено на две части намеренно:** чистая функция разбирает случай, обёртка
+  ходит в хранилище и переводит случай в отказ. Вторая реализация того же правила однажды уже
+  жила у обработчика статистики соседнего домена и успела разойтись порядком выборки.
+- **Отсутствие действующей сущности и ненайденный явный идентификатор — разные случаи для
+  вызывающего:** первое отвечает `FailedPrecondition`, второе — `NotFound`.
+- Таблица владеющих сущностей читается целиком одним запросом — она маленькая, и выборки ей не
+  нужно.
+- Выбор сущности стоит в шапке и действует на разделы, которые говорят об одной. Снаружи выбора
+  нет: пользователь приходит на страницу конкретной.

package/assets/rules/permissions.md

@@ -2,51 +2,69 @@
 name: permissions
 kind: rule
 law: access
-description: Правило под закон «Доступ». Брать при заведении или правке обработчика серверной стороны, перехватчика входа, стража маршрута и декларации меню. Четыре вида доступа, объявление ровно одно, пресет плюс точечные правки, закрытие раздела и его адреса одной декларацией. Готовый код — в паттерне permissions-procedure. Чем это названо здесь — в implementation.md рядом.
+description: Правило под «Закон о доступе». Брать при заведении или правке процедуры Connect, перехватчика входа, гварда маршрута админки и декларации меню. Называет четыре вида доступа, декораторы, сложение пресета с оверрайдами и гейтинг разделов админки. Готовый код — в паттерне permissions-procedure.
 ---
 
-# Доступ — каким приёмом
+# Доступ — как это устроено здесь
 
-Правило под закон `{{lawsDir}}/access.md`. Закон говорит, что должно быть верно; здесь — каким
-приёмом это держится. Как названы права, метки объявления и где лежат перехватчик и сложение
-прав — `implementation.md` рядом.
+Правило под закон `docs/constitution/application/access.md`. Закон говорит, что должно быть верно;
+здесь — чем это названо в этом дереве и где лежит. Устройство самих разделов админки —
+`navigation`.
 
-## Когда берётся
+## Как это называется здесь
 
-Заведение или правка обработчика серверной стороны, перехватчика входа, стража маршрута,
-декларации пункта меню.
+| В законе           | Здесь                                                                                                                                                                   |
+| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| право              | пара «ресурс и действие» строкой: `bookings:manage`, `chat:manage`                                                                                                      |
+| объявление доступа | декоратор на классе процедуры: `@RequiresPermission('bookings:manage')`, `@RequiresAuth('причина')`, `@PublicProcedure('причина')`, `@OptionalAuthProcedure('причина')` |
+| пресет             | именованный набор прав, выдаваемый пользователю целиком                                                                                                                 |
+| оверрайд           | точечная правка права поверх пресета для одного пользователя                                                                                                            |
+| отбивка без входа  | `Code.Unauthenticated`                                                                                                                                                  |
+| отбивка без права  | `Code.PermissionDenied`                                                                                                                                                 |
 
-## Что здесь действует
+## Где это лежит
 
-- **Каждый обработчик объявляет свой доступ меткой, и объявление ровно одно.** Обработчик без
-  объявления или с двумя не даёт приложению подняться: молчание здесь опаснее отказа.
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Как закон применяется здесь
+
+- **Каждая процедура объявляет свой доступ декоратором, и объявление ровно одно.**
+  Процедура без объявления или с двумя объявлениями не даёт приложению подняться.
 - **Видов доступа четыре: по праву, любому вошедшему, публично и публично с чтением входа.**
-  Последний отдаёт вошедшему больше, чем гостю, — так владелец видит скрытые записи в общем
+  Последний отдаёт вошедшему больше, чем гостю, — так владелец видит скрытые объекты в общем
   списке.
-- **Права пользователя — это права пресета, поверх которых применены его точечные правки.**
+- **Права пользователя — это права пресета, поверх которых применены его оверрайды.**
 - **Запрос без входа отбивается как неаутентифицированный, а вход без права — как отказ в
   доступе.** Это разные ответы: первый лечится входом, второй — нет.
-- **Право проверяется перехватчиком до тела обработчика.** Обработчик не решает, пускать ли
+- **Право проверяется перехватчиком до тела процедуры.** Обработчик не решает, пускать ли
   вызывающего.
-- **Публичность объявляется с причиной.** Причина — аргумент метки, записанный для читателя
-  кода; ни в ответ, ни в журнал она не уходит.
+- **Публичность объявляется с причиной.** Причина — аргумент декоратора, записанный для
+  читателя кода; ни в ответ, ни в лог она не уходит.
 - **Пункт меню и адрес раздела закрыты по одной декларации.** Иначе скрытый пункт закрывает
   раздел лишь на вид: адрес открывается по прямой ссылке.
-- **Пока права не получены, интерфейс ничего не прячет.** Пустая шапка после сетевого сбоя
-  выглядит как сломанное приложение и не оставляет выхода.
+- **Пока права не получены, админка ничего не прячет.** Пустая шапка после сетевого сбоя
+  выглядит как сломанная админка и не оставляет выхода.
+
+## Чего из закона здесь нет
+
+Право, отобранное посреди сессии, до перевхода не действует: токен живёт со своими правами до
+истечения — это `Q-A-1` в законе. Смены пароля из интерфейса нет вовсе: ни экрана, ни
+процедуры, ни восстановления забытого — `Q-A-2`.
 
 ## Паттерны
 
-- `permissions-procedure` — объявление доступа у обработчика и закрытие раздела интерфейса.
+- `permissions-procedure` — объявление доступа у процедуры и гейтинг раздела админки.
 
 ## Ловушки
 
-- **Обработчик, о котором перехватчик ничего не знает, отбивается как отказ в доступе, а не
+- **Процедура, о которой перехватчик ничего не знает, отбивается как отказ в доступе, а не
   пропускается.**
-- **Страж стоит на дочерних маршрутах защищённой группы, а не на самой группе.** Страж группы
+- **Гвард стоит на дочерних маршрутах защищённой группы, а не на самой группе:** гвард группы
   отрабатывает один раз за загрузку страницы и переходов между разделами не видит.
-- **Права приходят ответом профиля уже внутри защищённой группы**, поэтому страж дожидается
-  запуска приложения. Отказ запроса ожидание не роняет: с неизвестными правами не закрывается
+- **Права приходят ответом профиля уже внутри защищённой группы**, поэтому гвард дожидается
+  запуска админки. Отказ запроса ожидание не роняет: с неизвестными правами не закрывается
   ничего.
-- **Метки объявления живут в утилитах домена входа, а не рядом с перехватчиком.** Их ставит
-  каждый домен с обработчиками, и ребро к объявлениям дешевле ребра к секрету и хранилищу.
+- Декораторы живут в `util` домена аутентификации, а не рядом с перехватчиком: их ставит
+  каждый домен с процедурами, и ребро к объявлениям дешевле ребра к секрету и базе.