@rt-tools/agent-kit 0.8.3 → 0.9.0

package/assets/hooks/waiting-turn-guard.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 # rt-hook: Stop
-# Гард ожидания: ход, в котором открыт PR, не заканчивается, пока в нём не было ни одного
-# действия по следующей задаче. Stop.
+# Гард ожидания: ход, сообщающий владельцу о чужом шаге, не заканчивается, пока в нём не было ни
+# одного действия по следующей задаче. Stop.
 #
 # Зачем именно так. Статья «ожидание прогона работой не занимают» держится памятью исполнителя, и
 # держится плохо: образец сообщения владельцу кончается фразой о следующей задаче, а фраза
@@ -9,17 +9,22 @@
 # ничем себя не выдаёт: ни правкой файла, ни командой, — и промах виден только владельцу, только
 # по тому, что работа не двигается, и только когда он спросит прямо.
 #
-# Признак берётся из хода, а не из сети. Спросить хостинг об открытых PR было бы точнее, но
-# сетевой вызов на завершении хода падает вместе со связью и отбивал бы работу вместо промаха.
-# Поэтому судится пара: в ходе был вызов открытия PR — и в том же ходе было действие по
-# следующей задаче.
+# Чужой шаг узнаётся по двум признакам, и оба берутся из хода, а не из сети. Первый — открытие
+# PR: работа отдана, и дальше её двигает владелец. Второй — прочитанный красный прогон: чинить
+# его надо, но ход, в котором его прочитали и не сделали ничего, — та же пустота. Само чтение
+# прогона признаком не является: конец прогона читают и затем, чтобы пойти чинить; значит
+# красный ответ, а он лежит в выводе команды — там же, в записи хода.
+#
+# Спросить хостинг было бы точнее, но сетевой вызов на завершении хода падает вместе со связью и
+# отбивал бы работу вместо промаха.
 #
 # Что считается действием: заведение задачи, заведение ветки, перевод колонки очереди работ,
 # заведение папки задачи. Набор открыт и пополняется правкой — полнота его открытый вопрос, а не
 # обещание.
 #
-# Чего гард не судит. Ход, в котором PR не открывали, — здесь он молчит: пустой ход неотличим
-# от хода, которому нечего было делать. Это известная его граница.
+# Чего гард не судит. Ход, в котором о чужом шаге не сказано ничего, — здесь он молчит: пустой
+# ход неотличим от хода, которому нечего было делать. Это известная его граница. Зелёный прогон
+# он тоже не судит: за ним идёт своя работа — уборка и снятие черновика, — а не чужой шаг.
 #
 # ОТКАЗ В ПОЛЬЗУ РАБОТЫ: при любой ошибке, нехватке `jq`, отсутствии записи хода и повторном
 # заходе ход РАЗРЕШАЕТСЯ (exit 0). Сломанный гард не имеет права заклинить разговор.
@@ -42,15 +47,23 @@ transcript="$(printf '%s' "$input" | jq -r '.transcript_path // empty' 2>/dev/nu
 # ничего.
 opened_re='gh[^|;&]*pr[[:space:]]+create|api[^|;&]*-X[[:space:]]+POST[^|;&]*/pulls|glab[^|;&]*mr[[:space:]]+create|az[[:space:]]+repos[[:space:]]+pr[[:space:]]+create'
 
+# Чтение прогона — второй случай чужого шага. Сам по себе он ничего не значит: конец прогона
+# читают и затем, чтобы пойти чинить. Значит красный ответ, а он лежит не в команде, а в её
+# выводе — там же, в записи хода, и сети для этого не нужно.
+read_re='run[[:space:]]+(list|view|watch)|pipelines[[:space:]]+runs'
+red_re='completed[[:space:]]+failure|"conclusion"[[:space:]]*:[[:space:]]*"failure"|conclusion:[[:space:]]*failure|completed with .failure.|run[[:space:]]+failed'
+
 # Первое действие по следующей задаче. Заведение папки стоит здесь наравне с командами: работа
-# по уже заведённому номеру начинается именно с неё.
+# по уже заведённому номеру начинается именно с неё. Правка кода в ветке того же PR действием
+# по следующей задаче не считается — она чинит прежнюю, а не двигает работу дальше.
 moved_re='task:new|task:move|checkout[[:space:]]+-b|docs/tasks/'
 
 # Ход — это всё, что записано после последнего настоящего ввода владельца. Ответ инструмента
 # приходит той же ролью, поэтому строки с `tool_result` вводом не считаются.
 #
 # Хвост в 400 строк: запись хода растёт всю сессию, а судится только последний ход.
-verdict="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r --arg opened "$opened_re" --arg moved "$moved_re" '
+verdict="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r \
+    --arg opened "$opened_re" --arg moved "$moved_re" --arg read "$read_re" --arg red "$red_re" '
     def is_input:
         .type == "user"
         and (((.message.content // []) | if type == "array"
@@ -61,14 +74,30 @@ verdict="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r --arg opened "$opene
     | (if $i == null then [] else .[$i:] end) as $turn
     | [$turn[] | select(.type == "assistant") | (.message.content // [])[] | select(.type == "tool_use")] as $uses
     | ($uses | map((.input.command // "")) | join("\n")) as $ran
+    # Ответ инструмента берётся текстом, а не в записи JSON: у той таб и кавычка уезжают
+    # экранированными, и образец по ним не попадает вовсе. Приходит он и строкой, и списком
+    # блоков — обе формы сводятся к одному тексту.
+    | ([$turn[] | select(.type == "user") | .message.content // [] | select(type == "array") | .[]
+          | select(.type == "tool_result") | .content
+          | if type == "string" then .
+            elif type == "array" then (map(if type == "object" then (.text // "") else tostring end) | join("\n"))
+            else tostring end] | join("\n")) as $out
     | ($ran | test($opened; "i")) as $opened_pr
+    | (($ran | test($read; "i")) and ($out | test($red; "i"))) as $red_run
     | ($ran | test($moved; "i")) as $went_on
-    | if $opened_pr and ($went_on | not) then "owe" else "pass" end
+    | if $went_on then "pass"
+      elif $opened_pr then "owe:pr"
+      elif $red_run then "owe:run"
+      else "pass" end
 ' 2>/dev/null)"
 
-[ "$verdict" = "owe" ] || exit 0
+case "$verdict" in
+    owe:pr) said="в этом ходе открыт PR" ;;
+    owe:run) said="в этом ходе прочитан красный прогон" ;;
+    *) exit 0 ;;
+esac
 
-reason="BLOCKED by waiting-turn-guard: в этом ходе открыт PR, а действия по следующей задаче в нём нет ни одного. Ожидание чужого шага заходом не занимают: прогон идёт на стороне и быстрее от взгляда на него не становится.
+reason="BLOCKED by waiting-turn-guard: ${said}, а действия по следующей задаче в нём нет ни одного. Ожидание чужого шага заходом не занимают: прогон, разбор и слияние идут на стороне и быстрее от взгляда не становятся.
 
 Сказать «беру следующую задачу» — не то же самое, что взять её: фраза живёт до конца хода, а работа не двигается, и заметить это может только владелец.
 

package/assets/laws/delivery.md

@@ -109,6 +109,13 @@
   человека и только про названный PR; молчание разрешением не бывает, а слово, сказанное об
   одном PR, на следующий не переносится. Иначе разбор проходит тот, кого разбирают, и
   очередь PR выглядит разобранной, не будучи ею.
+- **Требование, стоящее перед необратимым шагом, стоит там, где этот шаг совершают.** Гард на
+  машине исполнителя судит его команды и молчит о том же действии, совершённом кнопкой у
+  хостинга: обход выходит не намеренным, а незамеченным — нажавший не знает, что чего-то не
+  хватало. Требование либо переносится туда, где нажимают, либо объявляется тому, кто нажимает,
+  до нажатия. Иначе оно держится не собой, а тем, что необратимый шаг каждый раз делает тот же
+  человек: папка закрытой задачи так и уехала в главную ветку вместе со своей договорённостью, и
+  вынимать её пришлось отдельной задачей.
 - **Слияние в главную ветку ещё не означает, что правка доехала.** Отказ выкатки не трогает ни
   задачу, ни очередь работ, поэтому расхождение главной ветки с тем, что работает, обязано быть
   видно там, где очередь читают. Иначе следующие работы вливаются поверх поломки, которую не

package/assets/laws/work-conduct.md

@@ -13,6 +13,15 @@
 - **Пробел закрывается вопросом владельцу, а не догадкой.** Догадка неотличима от знания:
   она попадает в работу молча и обнаруживается только при приёмке, когда переделывать дороже
   всего.
+- **Работа, объявленная сборкой по образцу, начинается с чтения самого образца.** Пересказ
+  образца образцом не является: по нему собирается понимание того, кто пересказывал, и
+  расхождение всплывает на приёмке целой работой, а не строкой. Читается та часть образца,
+  которую работа повторяет, и читается целиком — об устройстве чужого дерева по одному его
+  файлу не судят.
+- **Образец, названный однажды, доступен каждому заходу работы.** Где он лежит, записано
+  там, где заход найдёт это без владельца. Иначе второй заход собирает по памяти первого,
+  третий — по пересказу второго, и к четвёртому от образца не остаётся ничего, кроме слова
+  «образец».
 - **Вопрос, у которого есть очевидный ответ, работу не останавливает.** Исполнитель называет
   допущение, идёт дальше и записывает его туда же, где идёт работа. Останавливает только тот
   пробел, при котором любая догадка делает работу опасной или бесполезной. Вопрос, заданный

package/assets/patterns/admin-lists-screen.md

@@ -2,7 +2,7 @@
 name: admin-lists-screen
 kind: pattern
 rule: lists
-description: Паттерн правила lists. Брать при сборке или правке списочного экрана админки — готовый порядок блоков, разметка <префикс>-table, клик по строке, меню строки с vmTableRowActionsRowType, сортируемый заголовок, слоты тулбара, тост отказа.
+description: Паттерн правила lists. Брать при сборке или правке списочного экрана админки — готовый порядок блоков, разметка <префикс>-table, клик по строке, меню строки с колонкой действий и предикатом строки, сортируемый заголовок, слоты тулбара, тост отказа.
 ---
 
 # Собрать списочный экран
@@ -25,7 +25,7 @@ description: Паттерн правила lists. Брать при сборке
     <header rtElem="header">
         <!-- div rtElem="header-main" c h1 rtElem="title" + p rtElem="hint" -->
         <<префикс>-toolbar>
-        <!-- vmToolbarLeft / vmToolbarRight -->
+        <!-- <префикс>ToolbarLeft / <префикс>ToolbarRight -->
         <div rtElem="scroll">
             <!-- overflow-x: auto -->
             <<префикс>-table rtElem="table">
@@ -42,9 +42,9 @@ description: Паттерн правила lists. Брать при сборке
 ## Таблица
 
 ```html
-<<префикс>-table #rowsTable="vmTable" rtElem="table" clickable [ariaLabel]="'bookingsTableAria' | transloco" [emptyMessage]="'bookingsEmpty'
-| transloco" [tableId]="tableId" [dataSource]="rows()" [columnsConfig]="columnsConfig()" [rowHasActions]="hasRowActions"
-[loading]="loading()">
+<<префикс>-table #rowsTable="<префикс>Table" rtElem="table" clickable [ariaLabel]="'recordsTableAria' | transloco"
+[emptyMessage]="'recordsEmpty' | transloco" [tableId]="tableId" [dataSource]="rows()" [columnsConfig]="columnsConfig()"
+[rowHasActions]="hasRowActions" [loading]="loading()">
 ```
 
 - `tableId` — ключ, под которым хранится выбор столбцов; он же уходит в асайд настроек.
@@ -57,8 +57,8 @@ description: Паттерн правила lists. Брать при сборке
 <tr
     *cdkRowDef="let row; columns: rowsTable.displayedColumns()"
     cdk-row
-    qa-dataid="bookings-row"
-    vmTableRow
+    qa-dataid="records-row"
+    <префикс>TableRow
     (activated)="openAside(row)"></tr>
 ```
 
@@ -67,13 +67,24 @@ description: Паттерн правила lists. Брать при сборке
 ## Меню строки
 
 ```html
-<ng-template vmTableRowActions let-row [vmTableRowActionsRowType]="rows()"></ng-template>
+<<префикс>-table … [showRowActions]="true" [rowHasActions]="hasRowActions" [loading]="loading()">
+    <ng-template <префикс>TableRowActions let-row [<префикс>TableRowActionsRowType]="rows()"></ng-template>
 ```
 
 ```typescript
-protected readonly hasRowActions = (row: IBooking.State): boolean => row.canConfirm || row.canReject;
+protected readonly hasRowActions: I<Префикс>Table.RowActionsPredicate<IRecord.Row> = recordRowHasActions;
 ```
 
+Входа два, и они не заменяют друг друга. `showRowActions` заводит саму колонку действий — по
+умолчанию он опущен, и без него таблица рисует одни объявленные столбцы: ни шаблон действий, ни
+предикат колонки не добавляют. `rowHasActions` решает, показывать ли кнопку у конкретной
+строки, и колонки не заводит вовсе. Экран ролей так и вышел с четырьмя столбцами и
+недостижимыми действиями: сборка, линт и юниты на правилах строки при этом зелёные, а нашёл
+это прогон сквозной спеки.
+
+Ячейка действий скрыта, пока указатель не на строке, — сквозная спека наводит на строку до
+нажатия.
+
 Доступность действия лежит полем строки (`canConfirm`, `canReject`), а не вызовом метода
 компонента. Действие, которого записи нельзя сделать, из меню убирается целиком. Необратимое
 несёт `danger`, `confirmTitle` и `confirmMessage` с последствием — не «Вы уверены?», а что
@@ -82,7 +93,7 @@ protected readonly hasRowActions = (row: IBooking.State): boolean => row.canConf
 ## Сортируемый заголовок
 
 ```html
-<th *cdkHeaderCellDef cdk-header-cell vmSortHeader="checkIn">{{ 'bookingsCheckIn' | transloco }}</th>
+<th *cdkHeaderCellDef cdk-header-cell <префикс>SortHeader="createdAt">{{ 'recordsCreatedAt' | transloco }}</th>
 ```
 
 Колонка помечается `sortable: true` в `columnsConfig`. Заголовок переключает сортировку по
@@ -95,8 +106,8 @@ protected readonly hasRowActions = (row: IBooking.State): boolean => row.canConf
 
 ## Тулбар
 
-Тулбар поделён на две части слотами: `vmToolbarLeft` — то, что меняет выборку,
-`vmToolbarRight` — действия над списком. Своей раскладки внутри тулбара экран не заводит.
+Тулбар поделён на две части слотами: `<префикс>ToolbarLeft` — то, что меняет выборку,
+`<префикс>ToolbarRight` — действия над списком. Своей раскладки внутри тулбара экран не заводит.
 
 Левый слот — фильтры и поиск. Правый — иконки `<префикс>-icon-button variant="primary"` с парой
 `tooltip` + `ariaLabel` одного текста: обновление (`sync`), настройки столбцов (`sliders-v`),
@@ -105,7 +116,7 @@ protected readonly hasRowActions = (row: IBooking.State): boolean => row.canConf
 ## Отказ загрузки
 
 ```typescript
-this.#notifications.error(this.#transloco.translate(this.#store.errorKey() ?? 'bookingsLoadFailed'));
+this.#notifications.error(this.#transloco.translate(this.#store.errorKey() ?? 'recordsLoadFailed'));
 ```
 
 Ключ читается сразу после запроса, а не подпиской на сигнал стора: стор делят список и панель
@@ -118,7 +129,7 @@ this.#notifications.error(this.#transloco.translate(this.#store.errorKey() ?? 'b
 npx nx build admin
 ```
 
-Продовая сборка обязательна: без `[vmTableRowActionsRowType]` тип `let-row` выводится как
+Продовая сборка обязательна: без `[<префикс>TableRowActionsRowType]` тип `let-row` выводится как
 `unknown`, и падает только она — юниты и дев-сервер проходят.
 
 ## Частые промахи

package/assets/patterns/admin-nav-item.md

@@ -65,7 +65,7 @@ description: Паттерн правила navigation. Брать при зав
 - Обход одного верхнего ряда при поиске владельца адреса: разделы обходятся вместе с пунктами
   их панелей, иначе вложенный экран остаётся без гейтинга.
 - Подсказка у доступного пункта: она дословно повторяет подпись рядом и не добавляет ничего.
-- `vmPopoverTrigger` не поставлен явно: директива попапа по умолчанию открывается нажатием, и
+- `<префикс>PopoverTrigger` не поставлен явно: директива попапа по умолчанию открывается нажатием, и
   два соседних элемента одного ряда ведут себя по-разному.
 - Переезд адреса без правки сквозных спек: они ходят по адресам, и прогон станет красным.
 - Иконка, подобранная «похожая»: отсутствующая добавляется в спрайт и в `<префикс>-icon-names.ts`.

package/assets/patterns/component-structure-new.md

@@ -77,7 +77,7 @@ export class ComponentNameComponent {
 ## `qa-dataid` — на каждый интерактивный элемент
 
 ```html
-<button vmButton qa-dataid="calendar-retry-prices" type="button" (click)="retryPrices.emit()">Повторить</button>
+<button <префикс>Button qa-dataid="calendar-retry-prices" type="button" (click)="retryPrices.emit()">Повторить</button>
 <div rtElem="grid" qa-dataid="admin-calendar-grid"></div>
 ```
 

package/assets/patterns/entity-aside.md

@@ -132,5 +132,7 @@ constructor() {
   обводку фокуса у края прокрутки.
 - Панель, остающаяся открытой после успеха, не сбросила нетронутость (`markAsPristine`) —
   вопрос о правках задаётся сразу после записи.
-- Отключённые поля ввода вместо данных: запись, которую только смотрят, показывается через
-  `<dl>`, `<префикс>-detail-list`, `<префикс>-info-item`.
+- Отключённые поля ввода вместо данных: запись, которую только смотрят, показывается готовым
+  списком свойств кита — `<префикс>-detail-list`, `<префикс>-info-item`. Своя разметка на `<dl>`
+  идёт последней и только как разовое отступление: она и есть отход от общего вида, а решает
+  его владелец, — перечень, ставящий её первой, учит обходить готовое раньше, чем спросить.

package/assets/patterns/observability-record.md

@@ -112,3 +112,12 @@ const response: Response = await fetch(RATES_URL, { signal: AbortSignal.timeout(
   приложение при этом работает.
 - **Ошибка положена в поле как есть, без разбора причины.** Объект ошибки сериализуется в
   пустой `{}`, и в логе не останется ни текста, ни класса.
+- **Незаполненная часть ключа группы стоит пропуском, а не пустой строкой.** Два отказа без
+  процедуры и без предмета работы обязаны сойтись в одну группу; с пропуском в ключе каждый
+  заводит свою, и лента наполняется одиночными строками об одном и том же.
+- **Одинаковые отказы, пришедшие разом, дают две группы.** Между «такой группы ещё нет» и
+  вставкой успевает пройти второй, поэтому случай разбирается не проверкой перед вставкой, а
+  после того, как вставка не прошла.
+- **Имя строки лога длиннее предела ключа не записывается вовсе.** Оно собирается подстановкой
+  и ничем не ограничено, а у ключа предел есть: без обрезки отказ с длинным именем теряется
+  молча — ни строки в ленте, ни отказа в логах.

package/assets/patterns/shared-code-new.md

@@ -47,14 +47,14 @@ export const DEFAULT_PAGE_SIZE: number = 20;
 решает вызывающий.
 
 ```typescript
-const operator: FilterOperatorType | null = listFilterOperatorOf(filter.operatorType);
+const operator: TFilterOperatorType | null = listFilterOperatorOf(filter.operatorType);
 if (!operator) {
     throw new ConnectError(`filter operator is required: ${filter.propertyName}`, Code.InvalidArgument);
 }
 ```
 
 ```typescript
-const direction: ListSortOrderType = listSortOrderOf(rawDirection) ?? LIST_SORT_ORDER_ENUM.ASC;
+const direction: TListSortOrderType = listSortOrderOf(rawDirection) ?? EListSortOrder.ASC;
 ```
 
 Сервер отбивает запрос, экран берёт умолчание. Общий маппер здесь не годится: он подал бы

package/assets/patterns/task-flow-close.md

@@ -41,9 +41,15 @@ PR открыт черновиком — и с этой минуты работ
 ```
 PR #<номер> открыт черновиком. Жду прогона: пока он идёт, о работе известно только то, что
 она запушена. Как закончится — разберу папку задачи последним коммитом, сниму черновик и
-попрошу тебя влить. Пока жду, беру задачу #<номер следующей>.
+попрошу тебя влить. Следующая задача уже взята: #<номер>, ветка <имя ветки>.
 ```
 
+Последняя строка называет взятое, а не намерение взять, и это не оборот речи. Образец, который
+кончается обещанием, исполняется как обещание: заход произносит последнюю строку и на этом
+кончает ход — сообщение при этом выглядит полным, и пустоты за ним не видно ни владельцу, ни
+самому заходу. Образец, который кончается номером заведённой ветки, так исполнить нельзя: пока
+ветки нет, строку писать нечем. Разбор — `2026-08-16-next-task-said-not-taken.md`.
+
 Прогон зелёный, папка разобрана и запушена, черновик снят:
 
 ```

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

@@ -168,6 +168,13 @@ flowchart TD
   отбивает пуш, а не печатается рядом с ним: напечатанное предупреждение исполнитель читает как
   разрешение. Дважды подряд правка, прошедшая гейт целиком, была отбита конвейером — и оба раза
   зелёный гейт был прочитан как «локально всё зелено».
+- **Сверка раскладки стоит в наборе гейта пуша наравне с линтом и сборкой.** Правка, положенная
+  в разложенную копию мимо источника, в день, когда её делают, не ломает ничего: дерево
+  работает, проверки зелёные, а расхождение видно только тому, кто позовёт сверку сам. Копится
+  оно молча и всплывает на чужой работе — раскладка отказывает по правленому файлу целиком и не
+  кладёт ни одного другого, так что цену платит тот, кто правил соседний ресурс. Статьёй выше
+  эта строка не покрывается: сверки нет в конвейере, а значит нет и шага, который она бы
+  закрывала, — в набор она ставится прямо, а не выводится из его полноты.
 - **После вливания главной ветки набор проверок пересматривается по тому, что ветка везёт
   теперь.** Вливание меняет состав правки: проверять по тому, что правил автор, — значит
   проверять половину, а отвечает ветка целиком. Ветка, не тронувшая ни строки показа, прогоняет

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

@@ -126,6 +126,12 @@ flowchart TD
   умолчаниями, которые он разрешает. Умолчание образа задаётся в самом образе.
 - **Образы выкатываются по sha коммита, а не по метке «последний».** Метка в реестре отстаёт
   от главной ветки, и прод молча возвращается к прежней версии, продолжая отвечать.
+- **Убирает за собой и та машина, которая образы собирает.** Отбор у обеих один — своё имя
+  реестра, три последних sha, поднятые контейнеры остаются, — и зовётся он одним сценарием:
+  разойдясь, две чистки начали бы оставлять разное, а заметить это нечем. Отличаются они
+  хвостом: сервер снимает следом висячие слои и кэш сборки, машина сборки оставляет их себе,
+  иначе каждая сборка идёт как первая. Чистка на сборке не ждёт мержа: образ ветки занимает
+  столько же места, в реестр не уезжает вовсе и точкой отката не бывает.
 - **Выкатка убирает за собой старые образы, оставляя три последних sha.** Помеченный sha образ
   висячим не бывает никогда, и чистка висячего его не касается: за полгода они съедают диск
   сервера целиком. Три sha — это глубина отката, и меньше брать нельзя: поломка, замеченная
@@ -142,6 +148,15 @@ flowchart TD
 - **PR проверяется до мержа тем же конвейером, что и главная ветка.** Проверки и сборки
   образов идут на событии `pull_request`, выкатка — нет: её держит условие по главной ветке у
   своего задания, а образ PR в реестр не уезжает.
+- **Вершина открытого PR без прогона видна сверкой очереди работ.** Страница PR без прогона
+  выглядит так же, как страница с зелёным: цвета у неё нет ни там, ни там, — и вершину, за
+  которой прогон не встал, замечали только тем, что открывали список прогонов руками. Сверка
+  спрашивает вершину, а не ветку, считает сам факт прогона, а не его цвет, и свежей вершине
+  даёт время: между пушем и прогоном проходят минуты.
+- **Черновик при зелёном прогоне на вершине — расхождение сверки.** У черновика кнопка слияния
+  заблокирована самим хостингом: зелёная страница PR владельцу ничего не разрешает, а список, в
+  котором всё серое, читается как «работа не сделана». Гард снятия черновика сюда не достаёт —
+  он судит один ход и молчит, пока ветка везёт папку своей задачи.
 - **Расхождение прода с главной веткой видно сверкой очереди работ.** Задача уходит из очереди
   мержем, но мерж — ещё не прод: отказавшая выкатка не трогает ни задачу, ни её колонку, и
   заметить её неоткуда. Сверка спрашивает последний прогон главной ветки и судит только
@@ -164,6 +179,13 @@ flowchart TD
   отбивает пуш, а не печатается рядом с ним: напечатанное предупреждение исполнитель читает как
   разрешение. Дважды подряд правка, прошедшая гейт целиком, была отбита конвейером — и оба раза
   зелёный гейт был прочитан как «локально всё зелено».
+- **Сверка раскладки стоит в наборе гейта пуша наравне с линтом и сборкой.** Правка, положенная
+  в разложенную копию мимо источника, в день, когда её делают, не ломает ничего: дерево
+  работает, проверки зелёные, а расхождение видно только тому, кто позовёт сверку сам. Копится
+  оно молча и всплывает на чужой работе — раскладка отказывает по правленому файлу целиком и не
+  кладёт ни одного другого, так что цену платит тот, кто правил соседний ресурс. Статьёй выше
+  эта строка не покрывается: сверки нет в конвейере, а значит нет и шага, который она бы
+  закрывала, — в набор она ставится прямо, а не выводится из его полноты.
 - **После вливания главной ветки набор проверок пересматривается по тому, что ветка везёт
   теперь.** Вливание меняет состав правки: проверять по тому, что правил автор, — значит
   проверять половину, а отвечает ветка целиком. Ветка, не тронувшая ни строки показа, прогоняет
@@ -269,6 +291,16 @@ flowchart TD
   список прогонов ветки смотрится тем же движением, что и пуш — `gh run list --branch <ветка>`.
   Один такой отказ простоял в списке до мержа, и на него никто не посмотрел: выкатка после
   мержа отказала ровно тем же.
+- **Прогон, не вставший на пуш, возвращается повтором события, а не разбором ветки.** Замером
+  проверены обе законные дороги: и открытие PR, и пуш в уже открытый PR прогон заводят —
+  текстовый коммит и учётная запись, которой пушат, тут ни при чём. Пропавшие события пришлись
+  на час, когда хостинг отвечал `429` на загрузке действия и `503` на API, а списком прогонов
+  «не завёлся» от «не создан» не отличить. Поэтому вершину без прогона называет сверка очереди
+  работ, а событие возвращается новым коммитом либо перезакрытием PR.
+- **Красное на шаге подготовки задания — отказ хостинга, а не дефект ветки.** Раннер не смог
+  скачать действие чекаута и получил `429 Too Many Requests`; до кода прогон при этом не дошёл
+  вовсе. Лечится перезапуском прогона, и от красного по существу отличается тем, на каком шаге
+  оно встало: три прогона одного дня упали именно так.
 - **Контекст `runner` в `env` задания отбивает весь файл конвейера.** Там доступны только
   `github`, `needs`, `strategy`, `matrix`, `vars`, `secrets` и `inputs`; `runner` появляется на
   уровне шага, где то же значение приходит переменной окружения. Такой файл не принимается
@@ -279,6 +311,15 @@ flowchart TD
   пересечения нет, раннер стоит `online` и не берёт ничего, а задания уходят в облако — по
   состоянию это выглядит настроенным. Владельцу называют выполненное задание с его номером, а
   не строку состояния.
+- **Раннер на своей машине делает прогон общим ресурсом, и стенд у прогонов один.** Порт,
+  имя базы и каталог сборки зашиты в дереве одним значением на всех: два прогона разом
+  поднимают два стенда на один порт, и второй падает целиком. Дороже всего не падение, а его
+  вид — в отчёте оно выглядит десятком красных спек про экраны, то есть дефектом правки,
+  которого нет; три прогона подряд так и упали на трёх ветках, не тронувших кода. Лечится с
+  двух сторон сразу: конвейеру объявляется группа очереди на всё дерево, а имена стенда
+  читаются из окружения с нынешними значениями в умолчании — иначе прогон и гейт пуша, зовущий
+  ту же команду, столкнутся и при очереди. Одной очереди мало, одних имён — тоже: прогоны делят
+  ещё диск, кэш сборщика и демон образов.
 - **Вход в реестр образов из раннера, запущенного службой, отказывает молча.** Служба идёт без
   сеанса пользователя, а клиент реестра уходит в системный помощник хранения ключей и получает
   отказ во взаимодействии — задание падает до сборки. Свой каталог настроек с пустым помощником

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

@@ -167,6 +167,13 @@ flowchart TD
   отбивает пуш, а не печатается рядом с ним: напечатанное предупреждение исполнитель читает как
   разрешение. Дважды подряд правка, прошедшая гейт целиком, была отбита конвейером — и оба раза
   зелёный гейт был прочитан как «локально всё зелено».
+- **Сверка раскладки стоит в наборе гейта пуша наравне с линтом и сборкой.** Правка, положенная
+  в разложенную копию мимо источника, в день, когда её делают, не ломает ничего: дерево
+  работает, проверки зелёные, а расхождение видно только тому, кто позовёт сверку сам. Копится
+  оно молча и всплывает на чужой работе — раскладка отказывает по правленому файлу целиком и не
+  кладёт ни одного другого, так что цену платит тот, кто правил соседний ресурс. Статьёй выше
+  эта строка не покрывается: сверки нет в конвейере, а значит нет и шага, который она бы
+  закрывала, — в набор она ставится прямо, а не выводится из его полноты.
 - **После вливания главной ветки набор проверок пересматривается по тому, что ветка везёт
   теперь.** Вливание меняет состав правки: проверять по тому, что правил автор, — значит
   проверять половину, а отвечает ветка целиком. Ветка, не тронувшая ни строки показа, прогоняет

package/assets/rules/lib-layers.md

@@ -70,6 +70,10 @@ flowchart TD
   семьям, живёт в `common/platform`.
 - **Основание семейства видит только `util`.** Его зовут все домены семьи, и любая его
   зависимость становится общей для всех сразу.
+- **Поведение, которого основанию семейства не видно, приходит к нему токеном.** Токен
+  объявляется в `util` общего домена, а `data-access` подставляет туда свою реализацию: так
+  основание зовёт её, не видя её либы. Расширение границ основания ради одного вызова
+  открывает эту либу всем доменам семьи сразу и обратно уже не сужается.
 - **Домен заводится под предмет, а не под механику.** Механика, общая нескольким доменам,
   едет в либу, которой она уже видна: у фронта это основание семейства, у бэкенда — слой
   `util`, перечисленный у каждого домена.

package/assets/rules/lists.md

@@ -13,14 +13,14 @@ description: Правило под «Закон о списке записей»
 
 ## Как это называется здесь
 
-| В законе                  | Здесь                                                                     |
-| ------------------------- | ------------------------------------------------------------------------- |
-| таблица записей           | `rt-table` из `@rt-tools/ui-kit-v2`, вход `[dataSource]`                  |
-| состав и порядок столбцов | `[columnsConfig]`, хранятся по ключу `tableId`                            |
-| карточка на узком экране  | ветка `<префикс>-table`, а не своя разметка                               |
-| тулбар                    | `<префикс>-toolbar` со слотами `vmToolbarLeft` и `vmToolbarRight`         |
-| выборка                   | `IList.Query.State` — страница, сортировка, условия отбора, строка поиска |
-| панель настройки столбцов | асайд по маршруту `path: 'table-settings'`                                |
+| В законе                  | Здесь                                                                           |
+| ------------------------- | ------------------------------------------------------------------------------- |
+| таблица записей           | `rt-table` из `@rt-tools/ui-kit-v2`, вход `[dataSource]`                        |
+| состав и порядок столбцов | `[columnsConfig]`, хранятся по ключу `tableId`                                  |
+| карточка на узком экране  | ветка `<префикс>-table`, а не своя разметка                                     |
+| тулбар                    | `<префикс>-toolbar` со слотами `<префикс>ToolbarLeft` и `<префикс>ToolbarRight` |
+| выборка                   | `IList.Query.State` — страница, сортировка, условия отбора, строка поиска       |
+| панель настройки столбцов | асайд по маршруту `path: 'table-settings'`                                      |
 
 ## Где это лежит
 
@@ -76,7 +76,7 @@ flowchart TD
 - **Сортируема та колонка, у чьей ячейки шапки стоит заголовок сортировки.** Отдельного
   признака рядом со списком столбцов нет, и расходиться нечему.
 - **Клик по строке открывает запись, а меню — для действий над ней.** Вид нажимаемой строки
-  даёт `clickable`, активацию мышью и с клавиатуры — `vmTableRow`; клик по кнопке внутри строки
+  даёт `clickable`, активацию мышью и с клавиатуры — `<префикс>TableRow`; клик по кнопке внутри строки
   активацией не считается.
 - **Доступность действия лежит полем строки, а не вызовом метода компонента.** Метод из шаблона
   пересчитывался бы на каждой проверке.
@@ -105,7 +105,7 @@ flowchart TD
 
 ## Ловушки
 
-- Без `[vmTableRowActionsRowType]` тип `let-row` выводится как `unknown`, и падает только
+- Без `[<префикс>TableRowActionsRowType]` тип `let-row` выводится как `unknown`, и падает только
   продовая сборка — юниты и дев-сервер проходят.
 - Прокрутке нужны оба правила вместе: контейнер с `overflow-x`, таблица с
   `min-width: max-content`. С одним столбцы сжимаются вместо сдвига.

package/assets/rules/shared-code.md

@@ -17,7 +17,7 @@ description: Правило под «Закон об общем коде при
 | общий пакет               | `@rt-tools/utils` — собран без фреймворка, зависит от одного `tslib`, грузится под голым Node |
 | общая либа проекта        | `@<область>/common/util`; её тег входит в набор `UNIVERSAL` и виден всем трём приложениям     |
 | число-настройка           | `DEFAULT_PAGE_SIZE`, `MAX_PAGE_SIZE`                                                          |
-| набор значений            | `FILTER_OPERATOR_TYPE_ENUM`, `LIST_SORT_ORDER_ENUM`                                           |
+| набор значений            | `EFilterOperatorType`, `EListSortOrder`                                                       |
 | сверка значения с набором | `listSortOrderOf`, `listFilterOperatorOf`                                                     |
 | выборка списка            | `IPageModel`, `ISortModel`, `IFilterModel`, `IListState`                                      |