@rt-tools/agent-kit 0.5.3 → 0.6.0

package/assets/rules/ownership-session.md

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

package/assets/rules/permissions.md

@@ -36,6 +36,29 @@ description: Правило под «Закон о доступе». Брать
   Последний отдаёт вошедшему больше, чем гостю, — так владелец видит скрытые объекты в общем
   списке.
 - **Права пользователя — это права пресета, поверх которых применены его оверрайды.**
+- **У человека одна роль во владении, и держит это хранилище.** Две принадлежности в одном
+  владении пришлось бы складывать, а результат сложения запретов и разрешений по двум строкам
+  не прочитать. Права разных владений не складываются вовсе: они записаны у принадлежности, а
+  не у учётной записи.
+- **Право, о котором роль ничего не говорит, считается неданным.** Значение, которое не булево,
+  отбрасывается при сложении: отсутствующее право и прямо отобранное означают одно и то же, и
+  «непусто» правом не считается.
+- **Права вошедшего читаются при каждом вызове, а не берутся из выданного входа.** Выданный
+  вход говорит только о том, кто пришёл: подписанное однажды живёт часами и правку прав не
+  переживает, поэтому отобранное право открывало бы раздел до конца дня.
+- **Учётная запись, которой больше нет, вызовов, требующих входа, не открывает.** Тем же
+  чтением отбивается и человек, потерявший принадлежность в своём владении: работать ему не в
+  чем.
+- **Счётчик и рекламные сигналы включает ответ гостя, а не наличие ключа в настройках.**
+  Решений два, и хранятся они парой: «разрешил счёт посещений, но не рекламу» — законное
+  состояние, а третьим значением перечисления его пришлось бы заводить заново на каждое новое
+  разрешение. Всё, что не пара булевых значений, читается как неотвеченный вопрос, то есть как
+  отказ: хранилище принимает что угодно, а решать по испорченной записи нельзя. Своя
+  статистика к согласию не привязана — она не уходит наружу.
+- **Публичная процедура, заводящая запись, закрыта ещё и ограничителем частоты.** Право её не
+  сторожит, и без предела скорость роста таблицы задаёт отправитель, а не владелец. Считается
+  по ключу клиента, и ключ у всех таких процедур общий: второй ответ на вопрос «кто это»
+  разошёлся бы с первым. Публичная процедура, которая только читает, ограничителя не требует.
 - **Запрос без входа отбивается как неаутентифицированный, а вход без права — как отказ в
   доступе.** Это разные ответы: первый лечится входом, второй — нет.
 - **Право проверяется перехватчиком до тела процедуры.** Обработчик не решает, пускать ли

package/assets/rules/pricing.md

@@ -62,3 +62,7 @@ description: Правило под «Закон о деньгах». Брать
   одно, и живёт оно в расчёте.
 - **Справочная сумма рядом с суммой к оплате читается как цена.** В письме и в документе
   справочное число подписывается как справка.
+- **Набор валют переключателя бывает шире набора курсов.** Набор переключателя собирается из
+  начальных валют локалей, и валюты, курса для которых никто не тянет, попадают в него сами:
+  гость такой локали получает отказ курса, ничего не выбирая. Два набора сверяются между собой,
+  а расхождение чинится задачей — правкой текста оно не лечится.

package/assets/rules/reuse-first.md

@@ -27,6 +27,10 @@ description: Правило под «Закон о единообразии пр
 
 ## Как закон применяется здесь
 
+- **Источник вида выбирается по приложению, а не по привычке.** У каждого приложения дерева
+  своя опора: у публичного сайта — его дизайн-система, у остальных — кит. Перепутанный источник
+  приносит на экран форму, которой в этом приложении больше нигде нет. Какое приложение на что
+  опирается, названо в именах дерева.
 - **Работа начинается с чтения готового, а не с чистого файла.** Сначала находится опора —
   компонент кита, базовый класс, образец в соседнем домене, — потом пишется своё поверх неё.
 - **Свой примитив и своя основа заводятся только с явного одобрения владельца.** Спрашивается
@@ -76,6 +80,11 @@ description: Правило под «Закон о единообразии пр
 
 ## Ловушки
 
+- **Образец ищется по именам кита, а не по тому, на чём кит написан.** Поиск по именам
+  библиотеки, поверх которой кит собран, не находит ни одного файла: наложение, портал и окно
+  закрыты китом и зовутся его именами. Обратное тоже бывает: библиотека стоит прямой
+  зависимостью, и то, чего кит не закрывает, зовётся в дереве её собственным именем. Прежде чем
+  решать, что имени в дереве нет, его ищут — переделок из-за этого выходит по две на приём.
 - Перенос переизобретением не считается: строку, которая уже лежит в файле, гард из
   проверяемого текста вычёркивает, а сверка идёт без отступов — при переезде блок меняет
   отступ, оставаясь тем же кодом.

package/assets/rules/seo.md

@@ -2,7 +2,7 @@
 name: seo
 kind: rule
 law: search-visibility
-description: Правило под «Закон о видимости в поиске». Брать при любой правке, доходящей до разметки публичного сайта — шаблоны страниц, meta/title/description, JSON-LD, canonical, hreflang, маршруты сайта, sitemap, robots, nginx. Называет восемь локалей, где что лежит и чего у нас нет. Готовый код — в паттернах seo-page и seo-verify.
+description: Правило под «Закон о видимости в поиске». Брать при любой правке, доходящей до разметки публичного сайта — шаблоны страниц, meta/title/description, JSON-LD, canonical, hreflang, маршруты сайта, sitemap, robots, nginx. Называет локали перевода, где что лежит и чего у нас нет. Готовый код — в паттернах seo-page и seo-verify.
 ---
 
 # Видимость в поиске — как это устроено здесь
@@ -12,14 +12,14 @@ description: Правило под «Закон о видимости в пои
 
 ## Как это называется здесь
 
-| В законе                     | Здесь                                                                        |
-| ---------------------------- | ---------------------------------------------------------------------------- |
-| язык страницы                | локаль; их восемь — `en`, `ru`, `de`, `zh-Hans`, `zh-Hant`, `ko`, `th`, `hi` |
-| язык по умолчанию            | `DEFAULT_LOCALE`, то есть `en`; отдаётся из корня, без префикса в адресе     |
-| язык, перевод которого готов | `readyLocales` — поле объекта, а не список локалей сайта                     |
-| канонический адрес           | `${SITE_ORIGIN}${propertyPath(slug, locale)}`                                |
-| структурированные данные     | JSON-LD типа `LodgingBusiness`                                               |
-| прежний адрес страницы       | прежний slug объекта                                                         |
+| В законе                     | Здесь                                                                    |
+| ---------------------------- | ------------------------------------------------------------------------ |
+| язык страницы                | локаль перевода; их набор — в `implementation.md` рядом                  |
+| язык по умолчанию            | `DEFAULT_LOCALE`, то есть `en`; отдаётся из корня, без префикса в адресе |
+| язык, перевод которого готов | `readyLocales` — поле объекта, а не список локалей сайта                 |
+| канонический адрес           | `${SITE_ORIGIN}${propertyPath(slug, locale)}`                            |
+| структурированные данные     | JSON-LD типа `LodgingBusiness`                                           |
+| прежний адрес страницы       | прежний slug объекта                                                     |
 
 Локаль по умолчанию отдаётся из корня, остальные — с префиксом `/<код>/`. Префикс — часть
 маршрута, а не часть сборки: `<base href>` в разметке всегда `/`.
@@ -46,6 +46,54 @@ description: Правило под «Закон о видимости в пои
 - **Перенаправление с прежнего адреса отдаётся с `Cache-Control: max-age`** и покрыто
   `proxy_cache_valid 200 301`. Ключ кэша строится без `$args`, поэтому запросы со строкой
   запроса идут мимо кэша (`proxy_cache_bypass` / `proxy_no_cache $is_args`).
+- **Страница отдаёт блоки JSON-LD каждый своим тегом**, а не одним графом: отказ одного не
+  уносит остальные, и в отданной разметке видно, какой из них собрался.
+- **Цена уходит и предложением, и диапазоном** — суммой в валюте хранения и с единицей своего
+  периода. Цена по датам, скидки и пересчёт в валюту гостя в разметку не идут.
+- **Сводная оценка появляется от первого отзыва** и считается из оценок самих отзывов. Ноль
+  отзывов — поля нет вовсе: ни нуля, ни пустой строки.
+- **Блок вопросов собирается из вопросов записи**, а ноль вопросов блока не даёт.
+- **Крошки ведут от корня локали к странице записи** адресами той же локали, что и открытая
+  страница. Без названия сайта крошки не выпускаются вовсе.
+- **Сохранение записи уведомляет поисковика об изменении её адресов.** В уведомление уходят
+  страницы записи на готовых локалях по нынешнему и прежним адресам; корни локалей и карта
+  сайта — нет. Отказ приёмника сохранение не отменяет и возвращается владельцу исходом.
+- **Приёмников несколько, и каждый получает свой запрос.** Опрашиваются они одновременно, а
+  потолок ожидания считается на приёмник: последовательный обход сложил бы все потолки в одно
+  ожидание владельца. Переменная окружения перекрывает адреса всех приёмников разом — этим
+  отправку и проверяют локальным приёмником.
+- **Исход возвращается перечислением по приёмнику, а владельцу показывается списком.** Приёмник
+  в нём назван словом, а не адресом. Строка отвечает за приём запроса, а не за осведомлённость
+  поисковика: раздаёт полученное любой приёмник, поэтому отказ одного адреса не значит, что его
+  поисковик не узнал. Подписью объявляется только полный отказ.
+- **Удаление записи уведомляет поисковика теми же адресами.** Отдельного «страница исчезла»
+  протокол не знает: площадка приходит по адресу и видит ответ сайта сама. Адреса собираются до
+  удаления строки — каскад унесёт прежние вместе с записью, — а исход наружу не выходит:
+  страницы уже нет, и читать подпись некому. Снятие с публикации идёт через сохранение и
+  уведомляет тем же путём.
+- **Переименование адреса и снятие прежнего адреса тоже уведомляют поисковика.**
+  Переименование — всеми адресами записи, снятие — одним снятым; готовые локали у снятого
+  считаются по текстам записи, которой он принадлежал, и ради них выборка снятия отдаёт не
+  только адрес. Исход наружу не выходит ни там, ни там: владелец на странице адресов
+  спрашивает про адрес, а не про уведомление.
+- **Правка настроек владельца уведомляет поисковика адресами всех действующих записей.**
+  Видимой гостю считается та же правка, которой сбрасывается кэш, — а правка невидимого поля
+  уведомления не шлёт. Уходят живые адреса, без прежних, и готовые локали считаются по каждой
+  записи отдельно; отправка идёт на владеющую сущность — записи разных сущностей в одну не
+  попадают. Работа идёт в фоне за сохранением настроек, поэтому исход остаётся в логах:
+  показать его владельцу негде.
+- **Каждая отправка оставляет запись, и заводится она до обращения к приёмникам.** Повод,
+  записи, объявленные адреса и исход по каждому приёмнику ложатся рядом; пустой исход означает
+  «отправка идёт», а спустя несколько минут — что процесс упал посреди опроса. Пишут её все
+  места, откуда уведомление уходит. Отказ записи отправку не отменяет.
+- **Непрошедшие запросы владелец повторяет нажатием, и повтор заводит новую запись.**
+  Повторяется последняя отправка записи — у ранней адреса могли устареть, — и запрос уходит
+  только тем приёмникам, чей исход не «принял»; у оборванной записи это все её приёмники. Повод
+  у новой записи свой, а право строже, чем у чтения: повтор объявляет адреса поисковику.
+  Автоповтора по расписанию нет.
+- **Записи отправок держит ночная чистка: сперва предел, потом срок.** Тот же порядок, что у
+  ленты происшествий: срок, снятый первым, оставил бы предел меряться по уже почищенной
+  таблице.
 
 ## Чего из закона здесь нет
 

package/assets/rules/shared-code.md

@@ -39,6 +39,12 @@ description: Правило под «Закон об общем коде при
 - **Общим стал только маппер страницы.** У сторон разная политика на непонятное значение, и
   общим может быть лишь то, где она одна: номер меньше единицы обе стороны читают как первую
   страницу.
+- **Общая выборка держит форму запроса, а не набор условий.** Имена полей отбора объявляет сам
+  домен списком разрешённых, а в запрос к хранилищу их переводит его же выборка. Поэтому
+  условие вправе лечь на связанные строки, а не только на колонки самой записи, и отбор по
+  набору идентификаторов ей не запрещён: признак связанной записи — такое же поле набора, как
+  повод и объект. Общими здесь остаются разбор страницы, порядка и поиска, а не сам список
+  полей.
 - **Перечисления полей порядка и отбора домена копией не считаются.** `EActivitySortProperty`
   и подобные повторяют имена, по которым сортирует сервер именно этого домена.
 - **Строковая настройка и таблица соответствий сверяются по значению, а не по имени.** Имя

package/assets/rules/spec-driven.md

@@ -109,6 +109,15 @@ description: Правило под «Закон о документации пр
   про дерево, где того гарда не разложили; поправить это дерево не может ничем, если у ресурса
   нет надстройки. Требование ресурса к ресурсу при этом объявляется строкой в шапке, а не
   выводится из такой фразы.
+- **Паттерн находится по полю `rule:`, а не по приставке имени.** Приставку имени несут не все
+  паттерны, и поиск по имени правила таких не видит: сверка ищет их полем, человек — разделом
+  «Паттерны» самого правила. Счёт паттернов, собранный приставками, выходит меньше настоящего, а
+  число потом уезжает в деление работы.
+- **Якорь сверяется по сырому тексту файла, и комментарий засчитывается наравне с кодом.**
+  Существование символа проверка ищет словом по всему файлу, не вычищая комментарии, а живость
+  считает только у объявленного в коде. Имя, стоящее в одном лишь пояснении, проходит мимо обеих
+  сторон: якорем утверждения оказывается слово из комментария, тогда как объявление рядом
+  называется иначе.
 
 ## Чего из закона здесь нет
 

package/assets/rules/styling-bem.md

@@ -16,7 +16,7 @@ description: Правило под «Закон о фронтовом прило
 
 | В законе                        | Здесь                                                                                                                                        |
 | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
-| общий набор значений оформления | шкалы кита `--rt-*`; своё поверх них — `--vm-*` в `styles.scss` приложения                                                                   |
+| общий набор значений оформления | шкалы кита `--rt-*`; своё поверх них — `--<префикс>-*` в `styles.scss` приложения                                                            |
 | класс в разметке                | директивы `rtBlock` и `rtElem` из `@rt-tools`, а не строка в атрибуте                                                                        |
 | правило стилей                  | объявление `&__<элемент>` в `.scss` — своём или в общем слое приложения                                                                      |
 | общий слой раскладки            | `apps/<app>/src/styles/`: `<префикс>-page`, `<префикс>-form`, `<префикс>-panel`, `<префикс>-window` у админки, `<префикс>-site-page` у сайта |
@@ -38,6 +38,19 @@ description: Правило под «Закон о фронтовом прило
   инъекцией от ближайшего предка с `rtBlock`, и повторить этот разбор по тексту шаблона нечем.
 - **Раскладка объявлена в общем слое приложения, а не в стилях экрана.** У компонента экрана
   вне кита файл стилей по умолчанию пустой.
+- **Шторку и окно открывает служба кита, а не номер слоя.** Числа шкалы сравниваются только
+  между соседями по разметке; служба выносит разметку наружу, к `<body>`, и сравнивать её
+  становится не с чем.
+- **Номер слоя берётся из шкалы, а не пишется числом в файле компонента.** Шкала — единственное
+  место, где слои видно рядом: написанное на месте число в неё не попадает, и следующий узел
+  занимает тот же номер, ничего об этом не узнав.
+- **Размер элемента управления выбирается по признаку указателя, а не по ширине экрана.**
+  Планшет в ландшафте шире порога узкого вьюпорта, а нажимают по нему пальцем: `pointer: coarse`
+  отвечает про способ нажатия, ширина — про место под раскладку. Ступени берутся у кита, а не
+  назначаются пикселями.
+- **Файл стилей не длиннее 500 строк.** Предел общий с кодом и текстами, но stylelint длину не
+  судит вовсе — держит его проверка дерева. Выросший файл экрана делится по блокам, а общая
+  раскладка уходит в свой слой.
 - **Предупреждение stylelint роняет прогон наравне с ошибкой.** `!important` объявлен
   предупреждением, а прогон идёт с `--max-warnings 0`: иначе запрет читается как пожелание —
   два таких предупреждения лежали в дереве, а `npm run stylelint` возвращал ноль и гейтом не был.
@@ -52,10 +65,30 @@ description: Правило под «Закон о фронтовом прило
 
 - `styling-bem-layout` — экран на общем слое раскладки, блоки приложения.
 - `styling-bem-component` — стили компонента кита, `:host`, модификаторы, язык оформления сайта.
+- `styling-bem-sheet` — шторка и окно поверх страницы: чем открываются, подложка, замер.
 
 ## Ловушки
 
 - **`rtElem` без предка с `rtBlock` роняет отрисовку в рантайме** — сборка и линт молчат.
+- **Спроецированный узел блока-предка не имеет.** `rtElem` берёт имя блока инъекцией от
+  ближайшего предка **по месту объявления шаблона**, а не по месту вставки: элемент, который
+  экран объявляет у себя и отдаёт в проекцию чужого компонента, ищет `rtBlock` в своём шаблоне
+  и не находит. Отрисовка падает в рантайме, сборка и линт зелёные. Класс на такой узел
+  вешается правилом по селектору кита в общем слое раскладки, а не директивой.
+- **Элемент с `backdrop-filter` или своим `z-index` замыкает потомков в свой слой.** Липкая
+  шапка с размытием — самый частый случай: номер слоя у того, что лежит внутри неё,
+  сравнивается не с соседями по странице, а только с соседями внутри шапки, и нижняя панель
+  накрывает открытую шторку вместе с её кнопкой. Проверяется это `elementFromPoint` в центре
+  кнопки: сборка, линт и скриншот показывают тут целую страницу.
+- **До узла, вынесенного к `<body>`, стили компонента не достают.** Превью и заглушку переноса
+  кладёт туда библиотека, а правила компонента заскоуплены атрибутом: файл выглядит рабочим и
+  не красит ничего. Такие правила объявляются в общем слое приложения. Ни сборка, ни линт, ни
+  проверка «класс без правила» этого не видят: класса такого в шаблоне нет вовсе, и пролежать
+  это может несколько задач подряд.
+- **Имя токена не сверяется ничем.** Ссылка на несуществующий токен собирается, проходит
+  stylelint и проверку класса без правила, а свойство молча берёт наследованное значение:
+  правило выглядит написанным и не красит ничего. Ловится это только замером в браузере, а
+  имена берутся из объявлений кита, а не по догадке о том, как токен должен был бы называться.
 - **`rtBlock` на `<ng-container>` класса не ставит вовсе:** узел это комментарий, и имя блока
   он только объявляет потомкам. Класс блока экрана вешает хост через `host: { class: … }`.
 - **`justify-content: center` во flex-контейнере с `overflow-x` уводит первые элементы за

package/assets/rules/task-flow.md

@@ -73,6 +73,11 @@ description: Правило под «Закон о ведении работы»
   — признак; правила, тексты, обвязка и зависимости под него не подпадают. Обход — строка
   `**Поведение:** не меняется — <причина владельца>` в замысле; пустая причина не
   принимается.
+- **Гард замысла — нижняя граница, а не признак папки задачи.** Он требует её только под правку
+  кода приложения; нужна ли папка работе, которая туда не доходит, решает число заходов, а не
+  путь. Работа в один заход и один коммит целиком помещается в тело отчёта — так закрывается
+  разбор чужой папки. Работа с этапами и передачей папку заводит: между заходами её состояние
+  не держит ничто, кроме хода работы.
 - **Ход, в котором владельцу задан вопрос, не заканчивается, пока за этот же ход не читались
   законы и правила.** Чтением считается любой из трёх путей: загрузка правила, чтение файла
   законов или правил, поиск по ним. Отбивает гард разговора — на завершении хода, а не на

package/assets/rules/testing.md

@@ -2,7 +2,7 @@
 name: testing
 kind: rule
 law: verifiability
-description: Правило под «Закон о проверяемости». Брать при правке любого *.spec.ts и всего, что лежит в apps/site-e2e и apps/admin-e2e. Называет Vitest и Playwright, идентификатор сценария в заголовке, вынос решения в чистую функцию и то, что закрывается сквозной спекой. Готовый код — в паттернах testing-unit и testing-e2e.
+description: Правило под «Закон о проверяемости». Брать при правке любого *.spec.ts и всего, что лежит в сквозных наборах дерева. Называет Vitest и Playwright, идентификатор сценария в заголовке, вынос решения в чистую функцию и то, что закрывается сквозной спекой. Готовый код — в паттернах testing-unit и testing-e2e.
 ---
 
 # Проверяемость — как это устроено здесь
@@ -45,8 +45,21 @@ description: Правило под «Закон о проверяемости».
   переименованный или выкинутый сценарий: тесты при этом остаются зелёными.
 - **Решение выносится в чистую функцию и проверяется вызовом.** Компонент и сервис остаются
   тонкой обёрткой и отдельно не проверяются, пока своего ветвления у них нет.
+- **Решение, зависящее от текущего момента, принимает момент параметром.** Часы машины оно не
+  читает: правило проверяется вызовом, а не подкруткой времени вокруг теста. Умолчание
+  `= new Date()` ставится на границе — там, где решение зовёт процедура или служба.
 - **Процедура Connect проверяется вызовом своего метода с рукописным двойником базы.**
   Контейнер и роутер поднимать не надо: спека проверяет решение, а не раскладку полей.
+- **Сид заводит то, без чего экран не открыть, и ничего, что гость примет за настоящее.**
+  Содержимое, у которого есть автор, — отзывы, вопросы, обсуждения — гость читает как
+  написанное людьми, а стенд собирается из той же базы, что и проверка глазами: три выдуманные
+  цитаты дожили до отдельной задачи и всё это время выглядели отзывами. Настройки владельца —
+  контакты, адрес отправителя, ключи внешних служб — сид не заводит тоже: их вписывают в
+  приложении. То, что нужно редко, включается признаком в окружении, а не сеется всем.
+- **Заведённая проверка встаёт в гейт пуша или в конвейер, а не только в сводную цель.**
+  Сводная цель запускается руками, и проверка, которая живёт только в ней, отвечает тому, кто
+  её вспомнил: молчание такой проверки читается как её зелёный ответ. Три проверки простояли
+  вне гейта, объявляя в собственных списках известного, что падают на новом.
 - **Спека, необратимо меняющая данные стенда, выключена по умолчанию.** `BASE_URL` уводит
   прогон одной переменной, и без выключателя такая спека правила бы данные чужого стенда.
 - **Спеки, которым нужен nginx перед приложением, просыпаются вместе с `BASE_URL`.** Голый
@@ -56,6 +69,24 @@ description: Правило под «Закон о проверяемости».
   `playwright/no-skipped-test` запретил бы его сразу в шестидесяти пяти местах. Рядом со
   строкой отключения пишут причину, а точечный `eslint-disable` остаётся для того, что
   запрещено по делу.
+- **Гард отпускает действие, когда сам сломался.** Нет разборщика входа, пустой ввод, не тот
+  каталог, любая своя ошибка — гард выходит нулём и пропускает: сломанная проверка не имеет
+  права заклинить работу. Объявляется это строкой `FAIL-OPEN` в шапке самого гарда, рядом с
+  перечислением случаев, и туда же дописывается новый случай, когда он находится.
+- **Список известного у проверки именной и объясняет себя сам.** Первым полем перечня стоит имя
+  проверки и слово о том, что перечисленное отказом не считается. Дальше либо два ключа —
+  принятое остаётся навсегда, долг накоплен к заведению проверки и только сокращается, — либо
+  столько ключей, сколько у записей родов. Причина обязательна: снятая проверка без причины
+  через месяц неотличима от недосмотра.
+- **Тест, утверждающий отсутствие, зелен и тогда, когда ищет не то.** Совпадения нет ни у
+  верного текста, ни у опечатки в образце, ни у переименованного ключа — отличить их по цвету
+  прогона нечем. Отрицательное утверждение поэтому идёт в паре с положительным: сначала
+  проверяется, что искомое место вообще найдено, и только потом — что в нём нет того, чего быть
+  не должно.
+- **Заголовок теста обещает больше, чем тело проверяет, и сверка этого не видит.** Номер
+  сценария в заголовке стоит — сценарий числится покрытым, а что именно утверждается, не
+  спрашивает никто. Тело читается вместе с заголовком: обещание в заголовке и утверждение в
+  теле — два разных текста, и расходятся они молча.
 
 ## Чего из закона здесь нет
 
@@ -76,23 +107,30 @@ description: Правило под «Закон о проверяемости».
 - **Зелёный `nx test <проект>` не значит, что хоть один файл исполнялся.** Либа без своего
   `vitest.config.mts` не запускает ничего — так тесты домена броней не запускались ни разу.
   Либа с конфигом, но без единого `*.spec.ts`, проходит зелёной из-за `passWithNoTests: true`,
-  который стоит во всех 203 конфигах дерева, и на глаз эти два случая неотличимы: в обоих
-  прогон успешен. Без единого теста живут 131 либа из 203 — почти две трети. Перед правкой в
+  который обычно стоит в каждом конфиге дерева, и на глаз эти два случая неотличимы: в обоих
+  прогон успешен. Доля либ без единого теста меряется пересчётом ниже — в дереве, где его
+  завели впервые, она вышла почти в две трети. Перед правкой в
   незнакомой либе проверяется, есть ли в ней хоть один `*.spec.ts`; если нет — первый
   заводится этой же правкой, а не откладывается: откладывать здесь не с чего, долг уже
   накоплен. Пересчёт: `for d in $(find libs -name vitest.config.mts -exec dirname {} \;); do
 [ -z "$(find "$d" -name '*.spec.ts')" ] && echo "$d"; done | wc -l`.
+- **Зелёная сводка покрытия не значит, что тесты проходят.** Сверка читает заголовки тестов и
+  сопоставляет их со сценариями спека; исполняется ли тест и чем он кончается — она не знает
+  вовсе, и падающий тест значится в ней покрытием. Три сценария одной панели падали и до правки
+  экрана, а нашлось это только прогоном. Перед правкой экрана его сквозные тесты гоняются один
+  раз до первой строки кода: иначе чужое падение читается как своя регрессия, а своё — как
+  чужое.
 - **«Executable doesn't exist» — состояние машины, а не дефект правки.** Установлен только
   chromium, `firefox` и `webkit` падают всегда: гонять `--project=chromium`, узкий экран —
   `--project=mobile-chrome`. Та же ошибка приходит после смены версии Playwright: браузер
   ставится под конкретную версию, и после подъёма нужен повторный
   `npx playwright install chromium`. Девять тестов так и упали, и это выглядело регрессией
   обновления.
-- **Первому прогону сразу после установки браузера верить нельзя.** Два падения `admin-e2e`
-  не повторились ни при отдельном прогоне тех же тестов, ни при втором полном. Такой прогон
-  повторяют, а выводы делают по второму.
-- Сквозные тесты админки без `E2E_ADMIN_EMAIL` и `E2E_ADMIN_PASSWORD` пропускаются молча — в
-  отчёте они значатся `skipped`, и прогон выглядит успешным.
+- **Первому прогону сразу после установки браузера верить нельзя.** Два падения сквозного
+  набора не повторились ни при отдельном прогоне тех же тестов, ни при втором полном. Такой
+  прогон повторяют, а выводы делают по второму.
+- Сквозная спека, которой нужен вход, без учётных данных в окружении пропускается молча — в
+  отчёте она значится `skipped`, и прогон выглядит успешным. Имена переменных — при дереве.
 - **Справочник флоу вторых сценариев не заводит.** В `docs/E2E_<ДОМЕН>_FLOWS.md` кладут то,
   чего в спеке домена нет и быть не должно: `qa-dataid` элементов, состояния разметки, ловушки
   стенда. Обещанное поведение остаётся сценарием в `scenarios.md`: если списать его во второе

package/assets/rules/translations.md

@@ -2,7 +2,7 @@
 name: translations
 kind: rule
 law: locales
-description: Правило под «Закон о локалях и переводах». Брать при заведении любого видимого текста, правке словарей libs/common/i18n, префиксов локалей сайта и перевода контента объекта. Называет восемь локалей, Transloco, производные переводы и начальную валюту локали. Готовый код — в паттерне translations-key.
+description: Правило под «Закон о локалях и переводах». Брать при заведении любого видимого текста, правке словарей libs/common/i18n, префиксов локалей сайта и перевода контента объекта. Называет локали перевода, словари, производные переводы и начальную валюту локали. Готовый код — в паттерне translations-key.
 ---
 
 # Локали и переводы — как это устроено здесь
@@ -15,7 +15,7 @@ description: Правило под «Закон о локалях и перев
 
 | В законе             | Здесь                                                                                               |
 | -------------------- | --------------------------------------------------------------------------------------------------- |
-| локаль сайта         | одна из восьми: `en`, `ru`, `de`, `zh-Hans`, `zh-Hant`, `ko`, `th`, `hi`                            |
+| локаль сайта         | одна из локалей перевода; их набор — в `implementation.md` рядом                                    |
 | локаль по умолчанию  | `en` — отдаётся из корня, без префикса в адресе                                                     |
 | локаль ввода         | `source_locale` в запросе сохранения объекта; берётся из языка админки                              |
 | словарь              | JSON-словари Transloco в `libs/common/i18n/src/lib/dictionaries/<локаль>/`, разложенные по разделам |
@@ -54,6 +54,8 @@ description: Правило под «Закон о локалях и перев
 ## Паттерны
 
 - `translations-key` — заведение ключа во всех локалях перевода и подстановка в разметку.
+- `translations-content` — перевод содержимого записи: производный перевод, запись локали
+  руками, отказ провайдера, сброс кэша отданных страниц.
 
 ## Ловушки
 
@@ -63,7 +65,11 @@ description: Правило под «Закон о локалях и перев
   на общий, сайт, письма и админку.
 - **Перевод контента идёт до транзакции сохранения:** страница объекта не должна оказаться
   наполовину переведённой. Кэш сбрасывается после записи и один раз.
-- **Без ключа `ANTHROPIC_API_KEY` сохранение проходит,** но переводы остаются прежними, и
-  владелец видит предупреждение `propertySaveTranslationFailed`.
+- **Без ключа переводов сохранение проходит,** но переводы остаются прежними, и владелец видит
+  предупреждение об этом на своём экране. Ключ лежит секретом владения в хранилище, а не
+  переменной окружения, и заводит его владелец экраном интеграций: одноимённая переменная в
+  составе прода приложением не читается. Состояния ключа — паттерн `git-workflow-secrets`.
+- **Ветки локалей надеты не на все маршруты сайта, и новый раздел в них не попадает** —
+  раскладка, её ловушка и готовый код лежат в правиле `seo` и паттерне `seo-page`.
 - Новый маршрут сайта без ветки под каждую локаль существует только в локали по умолчанию:
-  `/de/<путь>` отдаст 404 и поисковику, и гостю.
+  путь под префиксом другой локали отдаст 404 и поисковику, и гостю.

package/assets/rules/typescript-conventions.md

@@ -33,6 +33,11 @@ description: Правило под «Закон об устройстве код
   различаются в месте использования, а не переходом к объявлению.
 - **Суффикс имени файла находит в нём обещанное объявление.** Список суффиксов закрыт: слово,
   которого в нём нет, суффиксом не считается, и такой файл правило не судит.
+- **Файл не длиннее 500 строк, и считаются все строки — пустые и комментарии тоже.** Файл,
+  который не влезает на экран целиком, читают по частям, и правку в нём делают, не увидев
+  остального. Для `.ts` это держит правило линтера; файлы обвязки — сценарии и скрипты — до
+  него не доходят и судятся отдельной проверкой дерева. Накопленное к дню включения
+  перечислено поимённо, и строка оттуда снимается вместе с делением своего файла.
 - **Тип берётся из того пакета, где объявлен.** Своя копия чужого типа расходится с оригиналом
   молча, а компилируется из них только одна.
 - **Двухступенчатое приведение `as unknown as` запрещено правилом линтера.** Вместо него —

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rt-tools/agent-kit",
-  "version": "0.5.3",
+  "version": "0.6.0",
   "description": "Переносимый слой правил для агента: законы, хуки, проверки и агенты, раскладываемые в репозиторий одной командой",
   "author": "RT Team",
   "license": "Apache-2.0",