@rt-tools/agent-kit 0.2.0 → 0.4.0

package/assets/patterns/doc-style-sweep.md

@@ -0,0 +1,137 @@
+---
+name: doc-style-sweep
+kind: pattern
+rule: doc-style
+description: Паттерн правила doc-style. Брать, когда документ накопил список работ и его надо разобрать на действующее и закрытое — признак отбора, обход по утверждениям, сверка с очередью работ, измерение потерь, куда девать доводы за отсрочку и судьба самого файла. Не брать для написания нового текста — это паттерн doc-style-write.
+---
+
+# Разбор документа, накопившего список работ
+
+Паттерн правила `doc-style`. Что при этом должно быть верно — закон
+`docs/constitution/project-documentation.md`, статья о том, что предстоящая работа
+перечислена в одном месте.
+
+## Когда брать
+
+- Документ перечисляет, что осталось сделать, а очередь работ перечисляет то же самое.
+- Файл вырос настолько, что его перестали читать целиком.
+- Планы лежат вперемешку: часть исполнена, часть нет, и по тексту это не различить.
+
+## Признак отбора — один, и он решается до первой правки
+
+**Утверждение остаётся в документе, если править его никто не собирается.** Всё остальное —
+работа, и её место в очереди работ.
+
+| Что нашлось                                             | Куда                                                            |
+| ------------------------------------------------------- | --------------------------------------------------------------- |
+| дыра, которую будут чинить                              | задача; строка из документа уходит                              |
+| дыра, которую решено не чинить                          | остаётся, вместе с причиной                                     |
+| условный отказ («заведём, если случай окажется частым») | остаётся                                                        |
+| вывод разбора, не ставший правилом                      | остаётся                                                        |
+| описание сделанного                                     | удаляется без переноса: о нём говорят закрытые задачи и история |
+| утверждение, разошедшееся с деревом                     | удаляется как протухшее, а не переносится в задачу              |
+
+Спрашивать владельца об этом наборе не нужно — он записан здесь. Спрашивать стоит одно:
+судьбу самого файла, когда в нём не осталось ничего.
+
+## Обход идёт по утверждениям, а не по пунктам
+
+Работа лежит и в прозе. Раздел «Экран заявок» перечислял недостающие якоря сплошным текстом,
+без единого маркера, и обход по `- ` его не увидел бы.
+
+```bash
+# сколько чего в файле: пункты, абзацы, разделы
+grep -c '^- ' docs/BACKLOG.md
+grep -c '^## ' docs/BACKLOG.md
+```
+
+Абзац судится тем же признаком, что и пункт.
+
+## Номер задачи стоит в трёх местах
+
+Прежде чем считать «пункты без задачи», надо знать все формы записи. В этом дереве их три:
+
+```markdown
+## Раздел — #149 ← в заголовке
+
+**Тикеты:** #163, #164 ← отдельной строкой у раздела или подраздела
+
+- Пункт про дефект. #101 ← в конце пункта
+```
+
+Разбор, знающий одну форму, ошибается молча: «51 пункт без задачи» оказался шестью. **Число,
+полученное разбором текста, сверяется на выборке руками до того, как его называют.**
+
+## Сверка с очередью работ
+
+У пункта есть задача — это ещё не значит, что задача несёт его содержание. Перед удалением
+меряется покрытие: сколько значимых слов пункта встречается в теле его задачи.
+
+```bash
+/opt/homebrew/bin/gh issue list --state all --limit 400 --json number,title,body,state > /tmp/issues.json
+```
+
+Пункт, покрытый телом наполовину и меньше, читается глазами и разводится на три исхода:
+
+- живое уточнение, которого в задаче нет, — дописать в тело;
+- другой дефект — завести своей задачей;
+- протухшее — удалить, **не** перенося. Иначе разбор занесёт в задачу ложь: «гард не проверяет
+  каталог кита» переносить было некуда, каталога уже не существовало.
+
+**Наследование номера от заголовка — предположение, а не факт.** Пункт под заголовком с
+четырьмя номерами не принадлежит ни одному из них: привязка проверяется чтением.
+
+## Сделанность читается по дереву
+
+Утверждение о том, что задача не сделана, стареет так же, как любое другое. Дважды за один
+разбор устаревшее было названо действующим: маркер непросмотренного уже вёз кит, а половина
+задачи про гейт скилов была сделана и покрыта сценариями.
+
+```bash
+# проверять то, о чём собираешься сказать «не сделано»
+grep -rn '<символ>' libs apps .claude/hooks
+grep -n '<имя>' node_modules/<пакет>/types/*.d.ts
+```
+
+## Доводы за отсрочку — это «чего это стоит»
+
+Раздел «что стоит отложить» переезжает не в архив, а **в тела тех задач, которых он
+касается**: там он и есть оценка цены. В файле он остаётся, только если отсрочка — решение
+владельца, а не предложение разбора. Признак — записанный ответ владельца с датой; нет
+его — значит, предложение.
+
+## Ссылки на снятые разделы
+
+Задача, чьё тело говорит `**Источник:** <документ>, раздел «…»`, после разбора ведёт в
+пустоту, и проверка путей этого не видит: она читает файлы репозитория, а не тела задач.
+Строка снимается тем же заходом.
+
+## Судьба файла
+
+- Осталось незадачное — файл живёт, и его преамбула объявляет новый признак отбора.
+- Не осталось ничего, а документ описывал состоявшуюся работу — уезжает в `docs/archive/`.
+- Не осталось ничего, и это был список работ — удаляется.
+
+Разбор целиком — одна задача и одна ветка: делится то, что придётся откатывать порознь, а
+здесь откат общий. Правка кода, найденная по дороге, в эту ветку не идёт — иначе откат разбора
+унесёт починку.
+
+## Что чинится в дереве следом
+
+Документ — не единственное место, обещающее, что работа живёт в нём. Снятое имя вычищается
+одним грепом, включая описания агентов, скилы, README и комментарии в коде:
+
+```bash
+grep -rn 'BACKLOG' --exclude-dir=node_modules --exclude-dir=.git --exclude-dir=archive .
+```
+
+## Частые промахи
+
+- Обход по маркированным пунктам: половина работы лежит прозой и переживает разбор.
+- «На это есть задача» без чтения её тела: пункт удалён, содержание потеряно.
+- Число пунктов названо владельцу до сверки на выборке.
+- Протухшее утверждение перенесено в задачу и стало действующим указанием.
+- Доводы за отсрочку оставлены в документе: он снова становится вторым списком работ.
+- Разбор поделён на несколько задач «по объёму» — признак деления не объём, а раздельный
+  откат.
+- Архив тронут: он описывает состояние на момент написания и под новые термины не правится.

package/assets/patterns/doc-style-write.md

@@ -0,0 +1,109 @@
+---
+name: doc-style-write
+kind: pattern
+rule: doc-style
+description: Паттерн правила doc-style. Брать при написании любой прозы проекта — правил, спеков, README, комментариев в коде, тел коммитов, описаний PR. Примеры «так» и «не так» на каждую договорённость о формулировке. Не брать для устройства спека — это правило spec-driven.
+---
+
+# Как формулировать
+
+Паттерн правила `doc-style`. Что при этом должно быть верно — закон
+`docs/constitution/project-documentation.md`.
+
+## Когда брать
+
+- Пишется правило, статья закона, пункт спека или README.
+- Пишется комментарий в коде, тело коммита, описание PR.
+
+## Правило — одна фраза
+
+Само правило укладывается в одно предложение. Следом — не больше двух предложений о том, что
+сломается иначе, и только если из самой фразы это не видно. Обоснование, у которого была
+альтернатива, идёт в «Ловушки» правила, а не в сам закон: разросшийся буллет читают по
+диагонали, а закон говорит, что верно, — не почему когда-то выбрали так.
+
+```
+✗ **Взрослых в брони хотя бы один — на любом пути записи, без исключений.** Нижнюю
+  границу держит база: путей записи три, и проверка в одном из них закрывает не все.
+  Верхнюю (вместимость объекта) ограничением базы не выразить — она лежит в строке
+  объекта и меняется владельцем.
+
+✓ **Взрослых в брони хотя бы один.** Исключений нет: заезда без взрослых не бывает.
+✓ **Взрослые и дети не превышают вместимость объекта.**
+```
+
+## Что верно, а не где это держится
+
+«Держит база, а не сервис», «проверяется в транзакции», «умолчание колонки», «на трёх путях
+записи из четырёх», имена функций и колонок внутри фразы — это устройство кода. Читателю нужно
+знать, **что** верно.
+
+Место исполнения меняется при первом же рефакторинге, и документ, который его называет,
+устаревает молча. Для него заведён отдельный файл — `implementation.md` рядом.
+
+Исключение — «Ловушки» правила: там устройство кода называется прямо, потому что ловушка и
+есть место, где на него наступают.
+
+## Без утверждений о будущем
+
+«Не планируется», «не будет», «отдельная фича по запросу» — это намерение владельца, а не
+свойство системы. Что не сделано — да, почему не сделано — да, что не будет сделано никогда —
+нет. Вместо приговора — открытый вопрос `Q-N` с тем, что решение изменит.
+
+Ошибка беззвучная: сверять утверждение о будущем не с чем, оно проходит любую проверку. Так в
+первый живой спек попало «онлайн-оплаты нет и не планируется», хотя оплата в планах.
+
+Отсюда же: того, чего нет в `docs/PRD.md`, документ о продукте не утверждает. Домысел при
+пересказе звучит убедительнее исходника — он короче и категоричнее.
+
+## Простыми словами
+
+Афоризмы, метафоры и инверсии затрудняют чтение и ничего не добавляют.
+
+```
+✗ запись о прошлом не должна упираться в правило, появившееся позже
+✗ свою запись владельца стирать по молчанию площадки нельзя
+✗ пустой список без текста и отказ без кнопки выглядят одинаково — как сломанная страница
+
+✓ бронь, которую владелец внёс сам, пропажа события из фида не снимает
+✓ у пустого списка должен быть текст, у отказа — кнопка повтора
+```
+
+Проверка: прочитать фразу вслух. Если так не говорят — переписать.
+
+## Факт проверяется, а не вспоминается
+
+Перед тем как написать, что код делает X, — открыть код и посмотреть. Пересказ по памяти
+выглядит так же уверенно, как проверенное утверждение, и отличить их потом нечем.
+
+Особенно это касается отказов: «вернётся `value out of range`» продержалось в двух документах,
+хотя такой отказ недостижим — в контракте и в колонке одна ширина.
+
+## Не пересказывать то, у чего есть источник
+
+- типы и поля контракта — `libs/common/proto/proto/<область>/v1/`, ссылкой;
+- колонки и индексы — `prisma/schema.prisma`;
+- числа, которые правит владелец (базовая цена, min-nights, вместимость) — только как они
+  применяются;
+- слои и имена классов — правило `lib-layers` и сам код.
+
+## Комментарии в коде
+
+Те же правила. Комментарий отвечает на вопрос «почему так, а не иначе» — если ответ
+неочевиден. Что делает строка, видно из строки.
+
+Многострочный комментарий над каждой функцией — признак того, что объяснение подменило имя.
+Сначала переименовать, потом писать комментарий.
+
+Комментарий, оправдывающий отклонение от правила, держит это отклонение на себе: пока
+объяснение выглядит убедительно, отклонение не трогают. Факт в нём проверяется, когда
+комментарий пишут, и перепроверяется, когда отклонение снимают.
+
+## Частые промахи
+
+- Чужой проект назван в коммите, PR, комментарии или документе. Ни имени репозитория, ни
+  «портировано из», ни ссылок на его файлы — нигде.
+- Число написано по памяти, а не пересчитано командой в том же коммите.
+- Пункт плана вычеркнут по памяти о работе, а не по дереву.
+- Формулировка звучит как заголовок, а не как правило: «работа со скидками» нарушить нельзя,
+  «применяется одна максимальная скидка» — можно.

package/assets/patterns/entity-aside.md

@@ -0,0 +1,136 @@
+---
+name: entity-aside
+kind: pattern
+rule: entity-conventions
+description: Паттерн правила entity-conventions. Брать при сборке или правке панели создания и правки записи — готовый маршрут в аутлете ro, наследование общей основы, runMutation, гард несохранённых правок, шапка и футер, уход на связанную запись. Не брать для стора — это паттерн entity-store.
+---
+
+# Панель правки записи
+
+Паттерн правила `entity-conventions`. Что при этом должно быть верно — закон
+`docs/constitution/entity-editing.md`.
+
+## Когда брать
+
+- Заводится или правится панель создания и правки записи.
+- Появляется панель без записи — настройки таблицы, лента событий.
+
+## Панель объявляется маршрутом в аутлете `ro`
+
+```typescript
+{
+    path: 'booking/:id',
+    outlet: 'ro',
+    component: BookingDetailAsideComponent,
+}
+```
+
+Так панель переживает перезагрузку, передаётся ссылкой и попадает в историю браузера.
+Программного открытия через сервис в админке нет.
+
+Панель, которую открывают из шапки, объявляется константой и подмешивается в `children` каждой
+доменной ветки — аутлет стоит в шаблоне хрома, а хром надевает `shell` каждого домена:
+
+```typescript
+export const ACTIVITY_ASIDE_ROUTES: Route[] = [{ path: 'activity', outlet: 'ro', component: ActivityFeedAsideComponent }];
+```
+
+## Экран наследует общую основу
+
+`RtRouteAsideComponent<T>` держит `entity`, `entityId`, `isCreateMode`, `submitting`,
+`resolving`, `submitError`, открытие панели по маршруту, уход с адреса и всю механику записи.
+Имена из основы не переименовываются: `booking`, `feed`, `slug` вместо `entity` ломают то самое
+единообразие, ради которого основа заведена.
+
+## Запись идёт через `runMutation`
+
+```typescript
+protected save(): void {
+    if (!this.canSave()) {
+        return;
+    }
+
+    this.runMutation(this.#store.save(this.#draft()), {
+        successKey: 'promoCodeSaved',
+        errorText: (): string => this.#store.errorKey() ?? 'promoCodeSaveFailed',
+        closeOnSuccess: true,
+    });
+}
+```
+
+Занятость, гашение прежней ошибки, тост об успехе и закрытие панели держит основа. `errorText`
+— функция: причина отказа известна только после него. Поток мутации обязан отдать значение или
+ошибку — пустой поток гасит панель навсегда.
+
+## Гард несохранённых правок
+
+Ставит сама панель, и он встаёт на все четыре пути закрытия: кнопку в шапке, кнопку в футере,
+нажатие мимо панели и Esc.
+
+```typescript
+protected readonly panelForm: Signal<NgForm | undefined> = viewChild(NgForm);
+protected readonly formPristine: Signal<boolean> = this.pristineSignal(
+    computed((): AbstractControl | undefined => this.panelForm()?.control)
+);
+
+constructor() {
+    super();
+    this.guardUnsavedChanges({ pristine: this.formPristine, save: (): void => this.save() });
+}
+```
+
+`viewChild` на поле с `#` Angular не принимает — поле объявляется `protected`.
+
+## Шапка и футер
+
+```html
+<<префикс>-aside-header [title]="title()" [overline]="overline()" [loading]="resolving()" (dismiss)="onClose()">
+    <ng-container asideActions>
+        <!-- доменные действия иконками; больше двух — под одну кнопку меню -->
+    </ng-container>
+</<префикс>-aside-header>
+```
+
+Заголовок называет действие, имя записи идёт надстрочником. В футере две зоны и не больше двух
+кнопок: `asideDismiss` — закрытие, `asidePrimary` — запись. Доменные глаголы в футер не
+ставятся: подтверждение, отказ, снятие с публикации — иконки в шапке.
+
+Подписи кнопок закреплены, панель их не выбирает:
+
+| Кнопка                               | Подпись                                           |
+| ------------------------------------ | ------------------------------------------------- |
+| запись при создании                  | «Создать»                                         |
+| запись при правке                    | «Сохранить»                                       |
+| закрытие панели, которая записывает  | «Закрыть и не сохранять» (`uiCloseWithoutSaving`) |
+| закрытие панели только для просмотра | «Закрыть»                                         |
+
+Кнопка записи стоит у противоположного края от кнопки закрытия, а пока идёт запрос —
+показывает спиннер и не нажимается: занятость берётся из `submitting()` основы, своего флага
+панель не заводит. Шапка и футер при прокрутке остаются на месте — прокручивается только зона
+содержимого.
+
+## Уход на связанную запись
+
+```html
+<a rtElem="related" qa-dataid="promo-code-property-link" [href]="propertyHref()" (click)="openProperty($event)">
+    {{ 'propertyOpenLink' | transloco }} <<префикс>-icon name="arrow-right" size="sm" />
+</a>
+```
+
+Адрес даёт `relatedUrl(commands)`, уход — `openRelated(commands)`. `routerLink` здесь не
+годится: директива навигирует сама, `preventDefault` её не останавливает, и вопрос о
+несохранённых правках она обходит.
+
+## Частые промахи
+
+- Свой `router.navigate` в панели: абсолютные команды меняют только первичную ветку, аутлет
+  остаётся в адресе, и роутер отклоняет навигацию молча.
+- Скелетоны по `busy()`, а не по `resolving()`: `busy` включает и запись, и на сохранении поля
+  превратились бы в скелетоны.
+- Своё «не найдено» на панели: ненайденная запись уводит с адреса силами основы.
+- Свои отступы поверх общей основы: они дают разную ширину полей на разных панелях и срезают
+  обводку фокуса у края прокрутки.
+- Панель, остающаяся открытой после успеха, не сбросила нетронутость (`markAsPristine`) —
+  вопрос о правках задаётся сразу после записи.
+- Отключённые поля ввода вместо данных: запись, которую только смотрят, показывается через
+  `<dl>`, `<префикс>-detail-list`, `<префикс>-info-item`.

package/assets/patterns/entity-models-new.md

@@ -0,0 +1,124 @@
+---
+name: entity-models-new
+kind: pattern
+rule: entity-models
+description: Паттерн правила entity-models. Брать при объявлении новой модели сущности и её маппера — готовый неймспейс I<Сущность> с Api, State и Draft, короткий и полный уровни, наследник BaseMapper с typeCast, что делать после правки .proto.
+---
+
+# Объявить модель сущности и её перевод
+
+Паттерн правила `entity-models`. Что при этом должно быть верно — закон
+`docs/constitution/entity-models.md`.
+
+## Когда брать
+
+- Заводится новая сущность админки.
+- У существующей появляется короткий уровень.
+- Правится маппер или контракт этой сущности.
+
+## Модель — неймспейс в `util` домена
+
+Файл `libs/<семья>/<домен>/util/src/lib/models/<сущность>.model.ts`:
+
+```typescript
+export namespace IPromoCode {
+    export namespace Short {
+        export type Api = PromoCodeListItem;
+
+        export interface State {
+            readonly id: string;
+            readonly code: string;
+        }
+    }
+
+    export type Api = PromoCodeInfo;
+
+    export interface State extends Short.State {
+        readonly usageCount: number;
+        /** Пусто = код действует на любой объект владельца */
+        readonly propertyId: string;
+        /** 0 = без предела */
+        readonly usageLimit: number;
+    }
+
+    /** Что уходит на сервер при сохранении: id пуст — код новый */
+    export interface Draft {
+        readonly id: string;
+        readonly code: string;
+    }
+}
+
+export enum EPromoDiscountKind {
+    Percent = 'percent',
+    Amount = 'amount',
+}
+```
+
+Перечисления домена лежат в том же файле, но **вне** неймспейса. Глубже двух уровней
+вложенности не заводить: `IPromoCode.Short.State` читается, третий уровень уже нет.
+
+Псевдонимы выборки объявляются там же:
+
+```typescript
+export type Query = IList.Query.State<EPromoCodeSortProperty, EPromoCodeFilterProperty>;
+export type ListResult = IList.Result.State<IPromoCode.State, EPromoCodeSortProperty, EPromoCodeFilterProperty>;
+```
+
+## Маппер — в `api` домена, свой на каждый уровень
+
+Файл `libs/<семья>/<домен>/api/src/lib/mappers/<сущность>-model.mapper.ts`:
+
+```typescript
+export class PromoCodeModelMapper extends BaseMapper<IPromoCode.State> {
+    public override mapFrom(raw: IPromoCode.Api): IPromoCode.State {
+        return {
+            id: this.typeCast.getAsString(raw?.id),
+            code: this.typeCast.getAsString(raw?.code),
+            usageCount: this.typeCast.getAsNumber(raw?.usageCount),
+            usageLimit: this.typeCast.getAsNumber(raw?.usageLimit),
+        };
+    }
+}
+```
+
+Маппер без состояния и без DI:
+
+```typescript
+readonly #mapper: PromoCodeModelMapper = new PromoCodeModelMapper();
+```
+
+На каждый уровень — свой класс: `PromoCodeShortModelMapper` и `PromoCodeModelMapper`.
+
+## Строковое поле с конечным набором сверяется явно
+
+`getAsType` умолчания не принимает: значение вне набора он пишет в консоль и возвращает
+строкой `'unknown'`.
+
+```typescript
+kind: promoDiscountKindOf(raw?.kind) ?? EPromoDiscountKind.Percent,
+```
+
+## После правки контракта
+
+```bash
+cd libs/common/proto && npx buf lint
+npm run proto:generate
+```
+
+Ни `buf lint`, ни `buf breaking` не входят в `check:all` и в CI — гоняются руками.
+Сгенерированные типы лежат в репозитории, и без перегенерации расхождение вылезет сборкой
+чужого приложения.
+
+Снятое поле помечается `reserved` с его номером и именем.
+
+## Частые промахи
+
+- `Api` переписан руками вместо псевдонима — разойдётся с контрактом молча.
+- `??` вместо `typeCast` — контракт отдаёт значения по умолчанию, и проверка на `undefined`
+  не ловит ничего.
+- `as Type` в маппере — запрещено правилом `typescript-conventions`.
+- `null` или `undefined` в `State` — пустое выражается пустой строкой или нулём, а смысл нуля
+  объясняется комментарием рядом с полем.
+- `readonly`-массив отдан в запрос: init-тип сообщения требует изменяемый, модель отдаётся
+  копией.
+- Общий тип на админку и сайт — у гостя своя короткая форма записи.

package/assets/patterns/entity-store.md

@@ -0,0 +1,91 @@
+---
+name: entity-store
+kind: pattern
+rule: entity-conventions
+description: Паттерн правила entity-conventions. Брать при заведении или правке стора админки — готовый наследник общей основы списочного стора, обвязка mutate, имена методов от действия, действие со своей занятостью. Не брать для панели — это паттерн entity-aside.
+---
+
+# Стор сущности
+
+Паттерн правила `entity-conventions`. Что при этом должно быть верно — закон
+`docs/constitution/entity-editing.md`.
+
+## Когда брать
+
+- Заводится `<сущность>.store.ts`.
+- Правится метод загрузки или записи существующего стора.
+
+## Наследник объявляет своё в четырёх строках
+
+```typescript
+@Injectable()
+export class PromoCodesStore extends BaseListStoreService<
+    IPromoCodesState,
+    string,
+    IPromoCode.State,
+    EPromoCodeSortProperty,
+    EPromoCodeFilterProperty,
+    IPromoCode.Draft
+> {
+    protected override readonly apiService: PromoCodeApiService = inject(PromoCodeApiService);
+    protected override readonly listErrorKey: string = 'promoCodesLoadFailed';
+
+    constructor() {
+        super({ ...INITIAL_STATE.LIST }, { name: 'PromoCodesStore' });
+
+        this.setConfig({ usePagination: true, useSorting: true, useFiltering: true, useSearch: true });
+    }
+
+    protected override mutationErrorKeyOf(error: unknown): string {
+        return promoRejectionKey(error);
+    }
+}
+```
+
+Конфиг решает, что уходит в выборку. Выключено всё — выборки нет вовсе, и сервер отдаёт список
+целиком. Из основы работают загрузка и перезапрос, смена страницы, порядка, условий отбора и
+строки поиска, догрузка следующей страницы, правка одной записи в списке и сброс выборки.
+
+Файл называется `<сущность>.store.ts`: имя `<сущность>-store.service.ts` выводит его и из
+правила линтера, и из гейта скилов.
+
+## Метод правки отдаёт поток
+
+```typescript
+public save(draft: IPromoCode.Draft): Observable<IPromoCode.State | null> {
+    return this.mutate(this.apiService.save(draft));
+}
+```
+
+`mutate` держит занятость, гашение прежней ошибки, перечитывание списка после успеха и ключ
+отказа. Мутация завершается **перечитанным списком**, а не отправленным запросом: панель
+закрывается по значению потока, и список, перечитанный после закрытия, показал бы прежнее
+значение.
+
+## Имена — от действия, а не от домена
+
+| ✗                                    | ✓          |
+| ------------------------------------ | ---------- |
+| `createBooking()`, `updateBooking()` | `save()`   |
+| `deleteBooking()`, `removeFeed()`    | `remove()` |
+| `loadBookings()`, `fetchFeeds()`     | `load()`   |
+
+Имя домена уже в имени стора и в его алиасе.
+
+## Действие со своей занятостью
+
+Идёт мимо `mutate`: опрос подписки на календарь держит `pollingId`, потому что панель на минуту
+опроса не гасится, а ключ отказа кладёт `setErrorKey`.
+
+## Частые промахи
+
+- Булев ответ у метода правки: он теряет и записанную запись, и причину отказа — панель узнаёт
+  только «не вышло».
+- Своя обвязка занятости и ошибки вокруг вызова сервиса: всё это в `mutate`.
+- Свои сигналы записей, занятости и отказа: они в общей основе.
+- Подписка на сигнал отказа загрузки: сигнал делят список и панель, и один отказ показался бы
+  дважды. Отказ загрузки идёт отдельным потоком.
+- Второе поле сортировки: порядок в выборке один — его не принимают ни таблица, ни контракт,
+  ни разбор на сервере.
+- Хвост с `EMPTY`, приклеенный к мутации: он гасится `defaultIfEmpty`, иначе отказ приклеенного
+  потока превращает удачную запись в вечный спиннер.