@rt-tools/agent-kit 0.13.0 → 0.15.0

package/assets/rules/testing.md

@@ -2,7 +2,7 @@
 name: testing
 kind: rule
 law: verifiability
-description: Правило под «Закон о проверяемости». Брать при правке любого *.spec.ts и всего, что лежит в сквозных наборах дерева. Называет Vitest и Playwright, идентификатор сценария в заголовке, вынос решения в чистую функцию и то, что закрывается сквозной спекой. Готовый код — в паттернах testing-unit и testing-e2e.
+description: Правило под «Закон о проверяемости». Брать при правке любой спеки и всего, что лежит в сквозных наборах дерева. Называет идентификатор сценария в заголовке, вынос решения в чистую функцию и то, что закрывается сквозной спекой. Паттерны: testing-unit, testing-e2e.
 ---
 
 # Проверяемость — как это устроено здесь
@@ -63,99 +63,100 @@ flowchart TD
 ```
 
 ## Как закон применяется здесь
-
-- **Идентификатор сценария стоит в начале заголовка теста, через тире.** Один сценарий
-  проверяется несколькими тестами, один тест закрывает несколько сценариев.
-- **Сценарий без теста несёт отметку с причиной.** Пустая отметка не принимается, а отметка
-  при существующем тесте — отказ: она означает, что долг закрыли, а отметку не сняли.
-- **Тест, идущий не тем путём, что пользователь, помечается частичным покрытием.** В сводку
-  он попадает долгом, а не покрытием.
+- **Идентификатор сценария стоит в начале заголовка теста, через тире.** Один сценарий проверяется
+  несколькими тестами, один тест закрывает несколько сценариев.
+- **Сценарий без теста несёт отметку с причиной.** Пустая отметка не принимается, а отметка при
+  существующем тесте — отказ: она означает, что долг закрыли, а отметку не сняли.
+- **Тест, идущий не тем путём, что пользователь, помечается частичным покрытием.** В сводку он
+  попадает долгом, а не покрытием.
 - **Сценарий, чьё «Тогда» называет человека и то, что он видит, закрывается сквозным тестом.**
-  Юнит на тот же расчёт остаётся долгом: между верным решением и тем, что человек его видит,
-  лежит всё, чего юнит не касался.
+  Юнит на тот же расчёт остаётся долгом: между верным решением и тем, что человек его видит, лежит
+  всё, чего юнит не касался.
 - **Сквозной тест, погашенный переменной окружения, покрытием не считается.** Выключатель по
   состоянию стенда — пропуск случая, выключатель по переменной — невыполненный тест.
 - **Упоминание в тесте сценария, которого в спеках нет, роняет проверку.** Так ловится
   переименованный или выкинутый сценарий: тесты при этом остаются зелёными.
-- **Решение выносится в чистую функцию и проверяется вызовом.** Компонент и сервис остаются
-  тонкой обёрткой и отдельно не проверяются, пока своего ветвления у них нет.
+- **Решение выносится в чистую функцию и проверяется вызовом.** Компонент и сервис остаются тонкой
+  обёрткой и отдельно не проверяются, пока своего ветвления у них нет.
 - **Решение, зависящее от текущего момента, принимает момент параметром.** Часы машины оно не
-  читает: правило проверяется вызовом, а не подкруткой времени вокруг теста. Умолчание
-  `= new Date()` ставится на границе — там, где решение зовёт процедура или служба.
-- **Процедура Connect проверяется вызовом своего метода с рукописным двойником базы.**
-  Контейнер и роутер поднимать не надо: спека проверяет решение, а не раскладку полей.
+  читает: правило проверяется вызовом, а не подкруткой времени вокруг теста. Умолчание `= new
+  Date()` ставится на границе — там, где решение зовёт процедура или служба.
+- **Жёсткая дата в образце — это срок годности самой спеки.** Момент образца и момент, которым
+  зовут проверяемый код, берутся либо оба жёсткими, либо оба от часов: смешение двух видов даёт
+  спеку, зелёную в день, когда её пишут, и красную через сутки или неделю — на чужой правке, у
+  того, кто её не трогал. Ни линтер, ни сборка, ни сверка спеков времени не знают.
+- **Процедура Connect проверяется вызовом своего метода с рукописным двойником базы.** Контейнер и
+  роутер поднимать не надо: спека проверяет решение, а не раскладку полей.
 - **Сид заводит то, без чего экран не открыть, и ничего, что гость примет за настоящее.**
-  Содержимое, у которого есть автор, — отзывы, вопросы, обсуждения — гость читает как
-  написанное людьми, а стенд собирается из той же базы, что и проверка глазами: три выдуманные
-  цитаты дожили до отдельной задачи и всё это время выглядели отзывами. Настройки владельца —
+  Содержимое, у которого есть автор, — отзывы, вопросы, обсуждения — гость читает как написанное
+  людьми, а стенд собирается из той же базы, что и проверка глазами. Настройки владельца —
   контакты, адрес отправителя, ключи внешних служб — сид не заводит тоже: их вписывают в
   приложении. То, что нужно редко, включается признаком в окружении, а не сеется всем.
-- **Заведённая проверка встаёт в гейт пуша или в конвейер, а не только в сводную цель.**
-  Сводная цель запускается руками, и проверка, которая живёт только в ней, отвечает тому, кто
-  её вспомнил: молчание такой проверки читается как её зелёный ответ. Три проверки простояли
-  вне гейта, объявляя в собственных списках известного, что падают на новом.
+- **Заведённая проверка встаёт в гейт пуша или в конвейер, а не только в сводную цель.** Сводная
+  цель запускается руками, и проверка, которая живёт только в ней, отвечает тому, кто её вспомнил:
+  молчание такой проверки читается как её зелёный ответ. Три проверки простояли вне гейта,
+  объявляя в собственных списках известного, что падают на новом.
 - **Проверка, приехавшая раскладкой, приезжает и со своим местом.** Место — это имя команды,
   которой её зовут, и строка набора, в котором она стоит. Проверка без места узнаётся только по
   тому, что раскладка положила новый файл, и статья выше на неё не действует: вставать ей некуда.
   Так приехала проверка длины — той же редакцией, что и статья о её обязательном месте.
-- **Спека, необратимо меняющая данные стенда, выключена по умолчанию.** `BASE_URL` уводит
-  прогон одной переменной, и без выключателя такая спека правила бы данные чужого стенда.
-- **Спеки, которым нужен nginx перед приложением, просыпаются вместе с `BASE_URL`.** Голый
-  сервер отдачи страниц их не проходит: перенаправления живут в конфиге прокси.
-- **Правило линтера, которое запрещает принятый здесь приём, выключают в конфиге, а не
-  обходят в каждом тесте.** Выключатель теста — приём этого дерева, а
-  `playwright/no-skipped-test` запретил бы его сразу в шестидесяти пяти местах. Рядом со
-  строкой отключения пишут причину, а точечный `eslint-disable` остаётся для того, что
-  запрещено по делу.
+- **Спека, необратимо меняющая данные стенда, выключена по умолчанию.** `BASE_URL` уводит прогон
+  одной переменной, и без выключателя такая спека правила бы данные чужого стенда.
+- **Спеки, которым нужен nginx перед приложением, просыпаются вместе с `BASE_URL`.** Голый сервер
+  отдачи страниц их не проходит: перенаправления живут в конфиге прокси.
+- **Правило линтера, которое запрещает принятый здесь приём, выключают в конфиге, а не обходят в
+  каждом тесте.** Выключатель теста — приём этого дерева, а `playwright/no-skipped-test` запретил
+  бы его сразу в шестидесяти пяти местах. Рядом со строкой отключения пишут причину, а точечный
+  `eslint-disable` остаётся для того, что запрещено по делу.
 - **Гард отпускает действие, когда сам сломался.** Нет разборщика входа, пустой ввод, не тот
-  каталог, любая своя ошибка — гард выходит нулём и пропускает: сломанная проверка не имеет
-  права заклинить работу. Объявляется это строкой `FAIL-OPEN` в шапке самого гарда, рядом с
+  каталог, любая своя ошибка — гард выходит нулём и пропускает: сломанная проверка не имеет права
+  заклинить работу. Объявляется это строкой `FAIL-OPEN` в шапке самого гарда, рядом с
   перечислением случаев, и туда же дописывается новый случай, когда он находится.
 - **Список известного у проверки именной и объясняет себя сам.** Первым полем перечня стоит имя
-  проверки и слово о том, что перечисленное отказом не считается. Дальше либо два ключа —
-  принятое остаётся навсегда, долг накоплен к заведению проверки и только сокращается, — либо
-  столько ключей, сколько у записей родов. Причина обязательна: снятая проверка без причины
-  через месяц неотличима от недосмотра.
+  проверки и слово о том, что перечисленное отказом не считается. Дальше либо два ключа — принятое
+  остаётся навсегда, долг накоплен к заведению проверки и только сокращается, — либо столько
+  ключей, сколько у записей родов. Причина обязательна: снятая проверка без причины через месяц
+  неотличима от недосмотра.
 - **Запись принятого отличается от долга тем, заведена ли на неё работа.** Принятое — то, что
   дерево делить не собирается; долг — то, на что заведена задача, и он только сокращается. Один
   список на оба означал бы, что разбирать нечего: запись без задачи через месяц читается как
   вечная, а запись с задачей — как недосмотр.
 - **У каждой записи стоят своя причина и номер задачи, которой она внесена.** Причина прозой на
   весь список объясняет любую его строку и потому не объясняет ни одной, а запись без номера не
-  спросишь ни у кого: тот, кто её внёс, к этому дню не помнит ни повода, ни своего решения.
-  Запись без причины или без номера отбивает проверку — и заводится она словом владельца, а не
-  решением исполнителя, которому она в эту минуту мешает.
+  спросишь ни у кого: тот, кто её внёс, к этому дню не помнит ни повода, ни своего решения. Запись
+  без причины или без номера отбивает проверку — и заводится она словом владельца, а не решением
+  исполнителя, которому она в эту минуту мешает.
+- **Запись списка, которую больше ничто не вызывает, снимается вместе с тем, что её вызывало.**
+  Такая строка молча разрешает то, чего в дереве нет, и следующий читатель принимает её за
+  действующее объяснение. Проверка на мёртвую запись бывает не у всякого списка, поэтому
+  снимается она тем же изменением, которым уходит вызвавшее её место.
 - **У красного есть назначенное действие, и второй перезапуск в него не входит.** Красное бывает
   двух родов, и в списке прогонов они выглядят одинаково: отказ хостинга на шаге подготовки
   лечится перезапуском, дефект ветки — не лечится им вовсе. Назначенное действие одно: сперва
   журнал этого задания, потом решение. Перезапуск, повторённый до чтения журнала, чинит не
   причину, а её проявление, и в истории выглядит работой.
-- **Строка в список известного не заводится под красную проверку.** Список набран к дню
-  заведения проверки и с тех пор только сокращается: дописанная строка гасит сигнал, а не
-  причину, и в истории выглядит так же, как починка. Место, где проверка права по букве и не
-  права по существу, разбирает владелец, а до его ответа верна проверка.
-- **Тест, утверждающий отсутствие, зелен и тогда, когда ищет не то.** Совпадения нет ни у
-  верного текста, ни у опечатки в образце, ни у переименованного ключа — отличить их по цвету
-  прогона нечем. Отрицательное утверждение поэтому идёт в паре с положительным: сначала
-  проверяется, что искомое место вообще найдено, и только потом — что в нём нет того, чего быть
-  не должно.
-- **Заголовок теста обещает больше, чем тело проверяет, и сверка этого не видит.** Номер
-  сценария в заголовке стоит — сценарий числится покрытым, а что именно утверждается, не
-  спрашивает никто. Тело читается вместе с заголовком: обещание в заголовке и утверждение в
-  теле — два разных текста, и расходятся они молча.
-- **Растр браузера называется явно, иначе кадр не сходится сам с собой.** Профиль цвета, взятый
-  у дисплея машины, ускоритель, считающий растр, и дорисовка кусками — каждый из трёх двигает
-  цвет на единицу-другую по каналу, и видно это только там, где смешение стоит на границе
-  округления: на сглаженных уголках тёмной темы. Ожидание вставшего кадра тут не помогает —
-  страница нарисована, а нарисована она каждый раз чуть иначе; расхождение гуляет по кадру,
-  приходит примерно раз в четыре прогона и на светлых экранах не показывается вовсе, поэтому
-  читается случайным. Все три называются доводами браузеру при запуске и становятся частью
-  эталона.
+- **Строка в список известного не заводится под красную проверку.** Список набран к дню заведения
+  проверки и с тех пор только сокращается: дописанная строка гасит сигнал, а не причину, и в
+  истории выглядит так же, как починка. Место, где проверка права по букве и не права по существу,
+  разбирает владелец, а до его ответа верна проверка.
+- **Тест, утверждающий отсутствие, зелен и тогда, когда ищет не то.** Совпадения нет ни у верного
+  текста, ни у опечатки в образце, ни у переименованного ключа — отличить их по цвету прогона
+  нечем. Отрицательное утверждение поэтому идёт в паре с положительным: сначала проверяется, что
+  искомое место вообще найдено, и только потом — что в нём нет того, чего быть не должно.
+- **Заголовок теста обещает больше, чем тело проверяет, и сверка этого не видит.** Номер сценария
+  в заголовке стоит — сценарий числится покрытым, а что именно утверждается, не спрашивает никто.
+  Тело читается вместе с заголовком: обещание в заголовке и утверждение в теле — два разных
+  текста, и расходятся они молча.
+- **Растр браузера называется явно, иначе кадр не сходится сам с собой.** Профиль цвета, взятый у
+  дисплея машины, ускоритель, считающий растр, и дорисовка кусками — каждый из трёх двигает цвет
+  на единицу-другую по каналу, и видно это только там, где смешение стоит на границе округления:
+  на сглаженных уголках тёмной темы. Ожидание вставшего кадра тут не помогает — страница
+  нарисована, а нарисована она каждый раз чуть иначе; Все три называются доводами браузеру при
+  запуске и становятся частью эталона.
 - **Маска закрывает содержимое, но не ширину.** Узел под маской занимает своё место в раскладке
-  по-прежнему, и плывущее значение внутри него двигает соседей мимо маски: кадр списка уезжал на
-  пиксель целиком, включая столбцы, где не менялось ничего. Там, где размер узла считается по
-  содержимому — ячейка таблицы, надпись, растягивающая кнопку, — плывущее лечится в данных
-  стенда постоянным значением, и тогда маска не нужна вовсе.
+  по-прежнему, и плывущее значение внутри него двигает соседей мимо маски. Там, где размер узла
+  считается по содержимому — ячейка таблицы, надпись, растягивающая кнопку, — плывущее лечится в
+  данных стенда постоянным значением, и тогда маска не нужна вовсе.
 
 ## Чего из закона здесь нет
 

package/assets/rules/turn-conduct.md

@@ -2,7 +2,7 @@
 name: turn-conduct
 kind: rule
 law: work-conduct
-description: Правило под «Закон о ведении работы» — та его часть, что про один ход. Брать, когда ход заканчивают: чем он кончается и что его концом не бывает, что говорится владельцу о чужом шаге, чем подтверждается утверждение о дереве, что делает страж выходов хода, гард ожидания, гард разговора и гард происшествия, как закрывается заход по заполнению окна. Готовый порядок — в паттерне task-flow-handoff. Ход работы от просьбы владельца до слияния — правило task-flow.
+description: Правило под «Закон о ведении работы» — про один ход. Брать, когда ход заканчивают: чем он кончается, что говорится владельцу о чужом шаге, чем подтверждается утверждение о дереве, что стерегут стражи. Паттерн task-flow-handoff. Ход работы целиком — правило task-flow.
 ---
 
 # Ход захода — как это устроено здесь
@@ -12,6 +12,9 @@ description: Правило под «Закон о ведении работы»
 от просьбы владельца до слияния, состояния работы и папка задачи — правило `task-flow`
 под тем же законом.
 
+**Холодная часть:** `pitfalls.md` рядом — случаи и числа по разборам происшествий. Грузится по
+требованию, а не вместе с правилом.
+
 ## Как это называется здесь
 
 | В законе                         | Здесь                                                                                          |
@@ -74,72 +77,120 @@ flowchart TD
 ## Как закон применяется здесь
 
 - **Сводка о чужом шаге.** Прогон, разбор владельцем и слияние идут без исполнителя и от взгляда
-  быстрее не становятся. Ход, кончившийся такой сводкой, владелец читает как работу: она полна,
-  в ней названы номера и состояния, и пустоты за ней не видно. О чужом шаге говорят вместе с
-  начатым своим, а не вместо него. За один заход это было нарушено четырежды, и готовая работа
-  простояла в невлитом PR почти три часа.
+  быстрее не становятся. Ход, кончившийся такой сводкой, владелец читает как работу: она полна, в
+  ней названы номера и состояния, и пустоты за ней не видно. О чужом шаге говорят вместе с начатым
+  своим, а не вместо него.
+- **Свой незакрытый шаг владельцу не передаётся.** Список остатков, названный аккуратно, читается
+  как рассказ о работе — тем полнее, чем он аккуратнее, — и владелец разбирает то, что мог
+  доделать сам исполнитель. Чужой шаг сводкой называют, свой — делают: незапушенная ветка,
+  неотмеченная запись груза и незакрытая колонка чужими шагами не бывают.
 - **Меню при назначенном порядке.** Выбор, предложенный владельцу, пока эпик не кончился, — это
-  просьба назначить порядок заново. Работы в эпике не осталось — так и говорится: эпик
-  кончился, — а не «чем займёмся».
-- **Объявление намерения.** «Беру следующую задачу» — не то же самое, что взять её: фраза живёт
-  до конца хода, а работа не двигается. Названо может быть только сделанное: номер заведённой
-  задачи, имя заведённой ветки, переведённая колонка.
+  просьба назначить порядок заново. Работы в эпике не осталось — так и говорится: эпик кончился, —
+  а не «чем займёмся».
+- **Объявление намерения.** «Беру следующую задачу» — не то же самое, что взять её: фраза живёт до
+  конца хода, а работа не двигается. Названо может быть только сделанное: номер заведённой задачи,
+  имя заведённой ветки, переведённая колонка.
 - **Названная командой работа запускается в том же ходе, где названа.** Строка «сейчас запущу»
-  ходом не кончается: либо запуск уже был, либо ход не кончен. Названная поимённо команда
-  выглядит начатой работой лучше всякого другого обещания — она точна, её видно, и по ней не
-  отличить сделанного от собранного. Ответ владельцу пишется после вызова, а не вместо него:
-  реплика посреди хода отвечается вместе с начатым действием. Дважды за сутки ход кончился
-  ровно такой строкой, и оба раза владелец возвращал работу сам.
-
+  ходом не кончается: либо запуск уже был, либо ход не кончен. Названная поимённо команда выглядит
+  начатой работой лучше всякого другого обещания — она точна, её видно, и по ней не отличить
+  сделанного от собранного. Ответ владельцу пишется после вызова, а не вместо него: реплика
+  посреди хода отвечается вместе с начатым действием.
+- **Вариант, поданный владельцу, назван ценой для человека.** Сколько шагов, где человек окажется
+  и что ему для этого нужно — без этого варианты выглядят равными, и выбор идёт по доводам со
+  стороны кода: «меньше путей», «строку запуска не трогаем». Знание, которое делает вариант
+  негодным, пишется в сам вариант, а не остаётся у того, кто его составил.
+- **Пересказ действующего порядка без оценки читается как одобрение.** На прямой вопрос владельца
+  «как это работает» ответ фактами верен и недостаточен: устройство, названное спокойно, звучит
+  принятым. Годность порядка для того, кто им пользуется, называется вместе с ним.
 - **Прерывание работы владельцем называется вслух.** Пришло задание, останавливающее начатое, —
-  исполнитель говорит, что стоит, на чём остановлено и что будет с прежней работой, и только
-  потом берётся за новое. Молчание об этом владелец читает как «прежнее кончилось».
-- **Остановка называется отдельной репликой.** Не строкой в конце отчёта: там она тонет —
-  владелец читает отчёт как рассказ о сделанном. Называются три вещи: что стоит, чего оно ждёт
-  и что владелец может решить.
-- **Выходы хода стережёт страж, а не память исполнителя.** Он читает объявленное состояние
-  работы и то, что за ход по ней сделано: правку файла или команду, меняющую дерево. Ход, в
-  котором не было ни того ни другого, возвращается исполнителю вместе со следующим шагом из
-  хода работы. Отданную и влитую работу страж не судит: она уже дождалась чужого шага.
-- **Отданную работу страж узнаёт по истории ветки, когда объявить её на диске уже нечем.** Ход
-  работы уезжает вместе с папкой задачи, а папка разбирается до открытия заявки: с этой минуты
-  и до слияния строки состояния нет вовсе. Судимый вторым признаком, такой ход отбивался бы за
-  ожидание чужого прогона — за то самое, что работой не является и правильно им не считается.
-- **Работа без ветки и без папки задачи судится тем же стражем по второму признаку.** Состояния
-  у неё нет, и первый признак взять неоткуда, — но ход, в котором не было ни одной правки
-  дерева, не кончается и здесь. Раньше страж отпускал такую работу молча, и защищена она была
-  меньше всего: просьба владельца «разложи», «обнови», «посмотри» идёт без задачи и без ветки,
-  и именно она чаще всего кончалась объявлением намерения.
+  исполнитель говорит, что стоит, на чём остановлено и что будет с прежней работой, и только потом
+  берётся за новое. Молчание об этом владелец читает как «прежнее кончилось».
+- **Остановка называется отдельной репликой.** Не строкой в конце отчёта: там она тонет — владелец
+  читает отчёт как рассказ о сделанном. Называются три вещи: что стоит, чего оно ждёт и что
+  владелец может решить.
+- **Выходы хода стережёт страж, а не память исполнителя.** Он читает объявленное состояние работы
+  и то, что за ход по ней сделано: правку файла или команду, меняющую дерево. Ход, в котором не
+  было ни того ни другого, возвращается исполнителю вместе со следующим шагом из хода работы.
+  Отданную и влитую работу страж не судит: она уже дождалась чужого шага.
+- **Снятая папка задачи снимает требование состояния, а ход не кончает.** Ход работы уезжает
+  вместе с папкой, а папка разбирается до открытия заявки: с этой минуты и до слияния строки
+  состояния нет вовсе, и первый признак стражу взять неоткуда. Отпускать по этому признаку ход
+  нельзя — снятая папка означает середину отдачи, а не её конец: между уборкой и заявкой работу не
+  видит никто, кроме того, кто её сделал. Дальше ход судится вторым признаком, как всякий другой;
+  ход, в котором заявку открыли или прочитали, второй признак пропускает сам.
+- **Работа без ветки и без папки задачи судится тем же стражем по второму признаку.** Состояния у
+  неё нет, и первый признак взять неоткуда, — но ход, в котором не было ни одной правки дерева, не
+  кончается и здесь.
+- **Взятая задача — ещё не начатая работа, и ход на ней не кончается.** Ветка по номеру заведена,
+  колонка сдвинута, номер назван владельцу — а каталога задачи при ветке нет: обязательное
+  действие состояния «задача-взята» не сделано ни строкой. Второй признак такой ход отпускает
+  целиком, потому что работы в нём много — заведение ветки, перевод колонки, уборка соседних
+  веток, — и «была ли за ход работа» отвечает не на тот вопрос, что «доведена ли работа до конца
+  объявленного состояния». Отчёт при этом встаёт ровно на место следующего действия и выглядит
+  завершённым куском лучше всякой другой вехи. Судит это страж отдельным ярусом; ветка без номера
+  задачи под него не подпадает, а собранный шаблон папки его снимает — заполненность замысла
+  машине не видна.
+- **Разведка ходом не кончается, сколько бы её ни было.** Переключение ветки, подтягивание,
+  просмотр истории и чтение заявок — не работа, а подготовка к ней; ход, собранный из них одних,
+  оставляет работу там же, где она стояла. Признак работы у стража этого прежде не различал: он
+  знает первое слово команды, и читающая подкоманда совпадала с ним наравне с коммитом. Разведка
+  при этом выглядит работой лучше всего остального — в ней команды, точные числа и проверяемые
+  ответы, — поэтому ход, набитый ею, читается полным и заходом, и владельцем. Судятся части
+  составной команды по одной: чтение, соединённое с правкой, работой остаётся.
+- **Ответ владельцу действием не работает и последним в ходе не стоит.** Порядок внутри хода
+  один: работа, потом первый шаг следующей, и только потом текст. Обратный порядок — работа,
+  отчёт, конец — стоит за каждой остановкой, которую разбирали: отчёт есть форма завершённости, и
+  дописанная сводка читается как конец хода тем убедительнее, чем больше сделано. Сказать о
+  сделанном можно всегда; место у этих слов — после следующего действия, а не вместо него.
+- **Последним действием хода бывает только работа.** Признак один на все виды остановки: правка
+  файла или меняющая команда — последним из того, что за ход сделано. Частные ярусы стража —
+  разведка, ожидание, отдача без начала следующей — из него только выводят понятный отказ;
+  заводить новый ярус на каждый вид бессмысленно, потому что видов столько, сколько бывает
+  поводов заговорить.
+- **Последним действием хода ожидание чужого шага не бывает.** Прогон, разбор владельцем и
+  слияние идут без исполнителя, и работа на время ожидания остаётся ровно там, где стояла. Такой
+  ход обманчив именно полнотой: в нём была работа, и много, — а признак «была ли за ход работа»
+  отпускает его целиком. Судится поэтому последнее действие: ожидание в середине законно, запуск
+  работы в фоне работой остаётся, а ход, кончившийся циклом до готовности прогона или слежением
+  за ним, страж не выпускает.
 - **Передача пишется и там, где имени у ветки нет.** Всё, что в неё едет, лежит в дереве и на
-  отсоединённой голове доступно целиком; имя нужно одному файлу, и он называется коротким
-  снимком головы. Молчание хука здесь стоит дороже прочего: сжатие приходит без передачи, и
-  следующий заход начинает с пустого места.
-- **Этап замысла объявляется закрытым только после того, как его команда проверки прошла.**
-  Строка «Чем проверяется» несёт команду обратными кавычками и то, что в её выводе означает
-  «сошлось». Страж читает прежний номер этапа из истории ветки и не выпускает ход, в котором
-  номер вырос, а команда не запускалась: через заход отмеченное по памяти неотличимо от
-  проверенного.
-- **Слово об остановке страж читает у владельца, а не у исполнителя.** Иначе остановку
-  объявляет тот, кому она в эту минуту удобна, и запрет держится ровно до первого неудобства.
-- **Утверждение о состоянии дерева стережёт гард утверждения, а не память исполнителя.** Всё,
-  что ответ владельцу говорит о дереве, несёт команду и её вывод: сказанное без команды
-  утверждением не считается — ни «проверено», ни «снято», ни «готово». Гард читает текст,
-  сказанный владельцу за ход, и ищет команду того же хода; у каждого слова назван свой род
-  команды, потому что общий признак «команда была» подтверждал бы одно другим. Прошлый ход не
-  годится: состояние дерева меняется, и вчерашний вывод о нынешнем молчит. Восемь разборов
-  подряд пришлись на этот промах, и каждый раз в правило дописывалась ещё одна статья —
-  держит его теперь машина.
-- **Слово-утверждение гард ловит, неверный вывод — нет.** Об образце, судимом по одному его
-  файлу, и о пути, которым человек не пойдёт, судить нечем: там нет ни слова, ни команды, с
-  которой сверять. Это известная граница гарда, и держат её статьи ниже, а не он.
+  отсоединённой голове доступно целиком; имя нужно одному файлу, и он называется коротким снимком
+  головы. Молчание хука здесь стоит дороже прочего: сжатие приходит без передачи, и следующий
+  заход начинает с пустого места.
+- **Этап замысла объявляется закрытым только после того, как его команда проверки прошла.** Строка
+  «Чем проверяется» несёт команду обратными кавычками и то, что в её выводе означает «сошлось».
+  Страж читает прежний номер этапа из истории ветки и не выпускает ход, в котором номер вырос, а
+  команда не запускалась: через заход отмеченное по памяти неотличимо от проверенного.
+- **Слово об остановке страж читает у владельца, а не у исполнителя.** Иначе остановку объявляет
+  тот, кому она в эту минуту удобна, и запрет держится ровно до первого неудобства.
+- **Утверждение о состоянии дерева стережёт гард утверждения, а не память исполнителя.** Всё, что
+  ответ владельцу говорит о дереве, несёт команду и её вывод: сказанное без команды утверждением
+  не считается — ни «проверено», ни «снято», ни «готово». Гард читает текст, сказанный владельцу
+  за ход, и ищет команду того же хода; у каждого слова назван свой род команды, потому что общий
+  признак «команда была» подтверждал бы одно другим. Прошлый ход не годится: состояние дерева
+  меняется, и вчерашний вывод о нынешнем молчит.
+- **Гард утверждения ждёт текст ответа, а не судит запись, какой застал.** Текст ложится в запись
+  хода не раньше, чем хост зовёт хук, и гард, прочитавший файл первым, видит ход, в котором
+  владельцу не сказано ничего. Не дождавшись текста, гард возвращает ход: пустая запись означает
+  не «сказать было нечего», а «прочитать нечего».
+- **Слово-утверждение гард ловит, неверный вывод — нет.** Об образце, судимом по одному его файлу,
+  и о пути, которым человек не пойдёт, судить нечем: там нет ни слова, ни команды, с которой
+  сверять. Это известная граница гарда, и держат её статьи ниже, а не он.
 - **Ход о чужом шаге стережёт гард ожидания, а не память исполнителя.** Он отбивает завершение
-  хода, в котором о чужом шаге сказано, а по следующей задаче не сделано ни одного действия —
-  ни заведения задачи, ни ветки, ни папки, ни перевода колонки. Чужой шаг он узнаёт по двум
-  признакам: в ходе открыт PR либо в ходе прочитан красный прогон. Оба берутся из самого хода:
-  спросить хостинг было бы точнее, но сетевой вызов на завершении хода падает вместе со связью
-  и отбивал бы работу вместо промаха, а вывод команды о прогоне в записи хода уже лежит. Слова
-  «беру следующую задачу» гард действием не считает — ровно потому, что их и произносят вместо
-  неё.
+  хода, в котором о чужом шаге сказано, а по следующей задаче не сделано ни одного действия — ни
+  заведения задачи, ни ветки, ни папки, ни перевода колонки. Чужой шаг он узнаёт по двум
+  признакам: в ходе открыт PR либо в ходе прочитан красный прогон. Слова «беру следующую задачу»
+  гард действием не считает — ровно потому, что их и произносят вместо неё.
+- **Ход, отдавший работу, доводит её до снятого черновика.** Черновик читается владельцем как
+  «работа не кончена»: кнопка слияния у него заблокирована самим хостингом, а по списку заявок
+  готовое от недоделанного не отличить — серое и там и там. Следующая задача берётся сверх этого,
+  а не вместо: требование взять её исполняется буквально и оставляет отданное невидимым. Стережёт
+  это гард ожидания: ход, открывший заявку, не кончается, пока состояние отданной работы не
+  спрошено командой того же хода.
+- **«Жду прогона» — утверждение о чужом шаге, а не состояние работы.** Прогон бывает зелёным час,
+  а бывает не встав вовсе — и второе само не чинится. Слово это требует команды того же хода,
+  которая прогон показывает, и без неё не говорится: сказанное без команды владелец читает как
+  «работа ещё идёт» и ждёт напрасно. Держит это гард утверждения, а не память исполнителя.
 - **Конец прогона узнаётся возвратом фоновой команды, а не взглядом на страницу.** Ожидание,
   запущенное в фоне отдельным ходом, возвращает исполнителя к PR само; до тех пор ход занят
   следующей задачей. Взгляд на страницу этого не даёт: он либо повторяется вхолостую, либо не
@@ -150,43 +201,62 @@ flowchart TD
   результат. Обход стоит дороже отказа: гард отбивает один файл, а обойдённый гард снимает
   требование со всего дерева и молчит об этом. Держится это не только памятью — гарды судят и
   команду оболочки, которая пишет файл.
+- **Отбитая гейтом команда повторяется целиком, а не хвостом.** Гейт отбивает вызов до исполнения,
+  поэтому не сработало ни одно её звено — включая те, что стояли до отбитого. Повторённый хвост
+  делает работу в том месте, где её не ждали:
+- **Пишущий вызов в строку разведки не дописывается.** Строка, собранная из вопросов, читается как
+  вопрос целиком — и своим автором тоже; правка идёт отдельным вызовом, где её видно. У вызова, у
+  которого есть читающий двойник, род выбирается по действию, а не по имени команды.
 - **Ход, в котором владельцу задан вопрос, не заканчивается, пока за этот же ход не читались
   законы и правила.** Чтением считается любой из трёх путей: загрузка правила, чтение файла
   законов или правил, поиск по ним. Отбивает гард разговора — на завершении хода, а не на
   инструменте вопроса: спрашивают чаще прозой, чем меню. Найденное ложится в раздел «Что уже
   сказано в правилах» разбора.
+- **Ответ владельца ищется в его же репликах прежде, чем в правилах.** Закон говорит: вопрос с уже
+  записанным ответом владельцу не задаётся, — и самая доступная запись лежит не в дереве, а в
+  самом разговоре: первая реплика владельца и его ответы на прошлые круги вопросов. Гард разговора
+  этого не видит: чтением он считает загрузку правила и поиск по нему, а реплика следа не
+  оставляет. Вопрос, отвечающий сам себе словами владельца, обесценивает и заданные рядом.
+- **Объём работы поводом урезать её границы не бывает.** Владелец, назвавший результат, объёма не
+  оспаривал: предложение выбросить часть — это просьба переназначить цель, поданная как уточнение.
+  Дорогое делают дорого либо говорят прямо, что оно дорого, и называют цену.
 - **Действия, которые исполнитель не делает без слова владельца, перечислены в компаньоне
   правила.** Список у каждого дерева свой — пакет знает только требование, чтобы список был
   назван. Не названный, он выводится из общих слов, и «делай, что нужно по плану» становится
-  разрешением на пуш и правку общих документов заодно с коммитом. Оценка «это безопасно» списка
-  не заменяет: её назначает тот, кому она в эту минуту удобна, и она плывёт. За один заход одна
-  и та же команда была сначала слишком опасной, чтобы её позвать, а через два хода —
-  достаточно безопасной, чтобы позвать без спроса.
-- **У отказа от необратимого действия есть безопасная часть, и она делается.** Требование
-  спросить владельца относится к действию, а не к ходу: работа, у которой отделима часть без
-  последствий, делится, а не откладывается целиком. Список вариантов, поданный вместо работы,
-  читается как работа — тем полнее, чем аккуратнее он составлен: он пронумерован, в нём названы
-  цифры, и именно поэтому пустота хода за ним не видна. Владельцу называется, что уже сделано и
-  что осталось за его словом, — а не выбор из вариантов вместо и того и другого.
-- **Ход, в котором исполнитель признал промах, не заканчивается, пока записи о происшествии
-  нет.** Отбивает гард происшествия — на завершении хода: к моменту признания промах уже
-  случился, и ловить раньше нечего. Признание ловится набором образцов, а не пониманием смысла;
-  промах, признанный словами вне набора, гард пропускает, и это его известная граница, а не
-  обещание.
+  разрешением на пуш и правку общих документов заодно с коммитом. Оценка «это безопасно» списка не
+  заменяет: её назначает тот, кому она в эту минуту удобна, и она плывёт.
+- **У отказа от необратимого действия есть безопасная часть, и она делается.** Требование спросить
+  владельца относится к действию, а не к ходу: работа, у которой отделима часть без последствий,
+  делится, а не откладывается целиком. Список вариантов, поданный вместо работы, читается как
+  работа — тем полнее, чем аккуратнее он составлен: он пронумерован, в нём названы цифры, и именно
+  поэтому пустота хода за ним не видна. Владельцу называется, что уже сделано и что осталось за
+  его словом, — а не выбор из вариантов вместо и того и другого.
+- **Признак необратимости берётся из списка, а не выводится доводом.** Список составлен тем, кто
+  обратимость уже взвесил: необратимое в нём осталось, обратимое из него снято. Довод «действие
+  уходит наружу и не откатывается» приходит в контекст всегда, а список — только когда его
+  прочитали, и применённый поверх списка довод отменяет список целиком. Отменяет молча: со стороны
+  это выглядит осторожностью, а не пропуском шага. Действия, которого в списке нет, исполнитель на
+  слово владельца не гейтит, даже если оно уходит наружу. Шаг, снятый из списка разбором прошлого
+  промаха, тем более: довод, которым его туда возвращают, уже разобран и отклонён — и дважды
+  подряд готовая работа вставала перед снятым шагом.
+- **Ход, в котором исполнитель признал промах, не заканчивается, пока записи о происшествии нет.**
+  Отбивает гард происшествия — на завершении хода: к моменту признания промах уже случился, и
+  ловить раньше нечего. Признание ловится набором образцов, а не пониманием смысла; промах,
+  признанный словами вне набора, гард пропускает, и это его известная граница, а не обещание.
 - **Заход, начатый с передачи, входит в работу тем же правилом, что и всякий другой.** Передача
   лежит вне дерева, её не читает ни одна проверка, и написана она вчера: всё, что в ней стоит,
-  проверяется деревом. Порядок входа — четыре шага в паттерне возвращения; стережёт его гард, а
-  не память: порядок, записанный только словами, исполняется, пока о нём помнят.
-- **Состояние незаконченной работы приходит в контекст на запуске сессии.** Замысел и ход
-  работы отдаются целиком, разбор просьбы — путём. Ветка вида `<КЛЮЧ>-*` без папки даёт
-  предупреждение с готовой командой, но сессию не рвёт.
+  проверяется деревом. Порядок входа — четыре шага в паттерне возвращения; стережёт его гард, а не
+  память: порядок, записанный только словами, исполняется, пока о нём помнят.
+- **Состояние незаконченной работы приходит в контекст на запуске сессии.** Замысел и ход работы
+  отдаются целиком, разбор просьбы — путём. Ветка вида `<КЛЮЧ>-*` без папки даёт предупреждение с
+  готовой командой, но сессию не рвёт.
 - **Заполненное окно кончает ход только там, где сжатия нет.** Где оно объявлено, окно —
   продолжение хода: заход сжимается и работает дальше, а порог остановки срабатывает лишь тогда,
   когда сжатие не пришло.
 - **Заполнение окна захода стережёт гард, а не память исполнителя.** На первом пороге он
-  напоминает выбирать точку остановки, на втором отбивает всё, кроме записи хода работы,
-  передачи и команд поставки. Размер окна и оба порога дерево задаёт само; не задавшее размера
-  стража не получает.
+  напоминает выбирать точку остановки, на втором отбивает всё, кроме записи хода работы, передачи
+  и команд поставки. Размер окна и оба порога дерево задаёт само; не задавшее размера стража не
+  получает.
 - **Порог сжатия контекста дерево задаёт само, и стоит он НИЖЕ порога остановки.** Совпавшие
   пороги согласием не бывают: это гонка, и выигрывает её страж — он стоит на вызове, а сжатие
   приходит между ходами. Расстояние объявляется числом, а не выводится разницей; сведены пороги

package/assets/rules/turn-entry.md

@@ -2,7 +2,7 @@
 name: turn-entry
 kind: rule
 law: work-conduct
-description: Правило под «Закон о ведении работы». Брать при правке хука входа в заход, текста карты хода и проверки над ней, а также когда решается, что заход получает в контекст до первой реплики. Называет передачу прошлого захода, карту хода, четыре запуска и отказ в пользу работы. Не брать для самого хода работы — это правило task-flow.
+description: Правило под «Закон о ведении работы». Брать при правке хука входа в заход, карты хода и проверки над ней, а также когда решается, что заход получает в контекст до первой реплики. Сам ход работы — правило task-flow.
 ---
 
 # Вход в заход — как это устроено здесь
@@ -59,6 +59,12 @@ flowchart TD
 - **Карта короче правила, и предел ей назначает проверка дерева.** Этим она и полезна:
   выросшая до правила, она съедает то самое окно, ради которого её кладут в контекст, — и
   заметить это нечем, потому что она продолжает приходить и продолжает быть верной.
+- **Текст, едущий в контекст, пишется списком, а не таблицей.** Форматтер добивает столбцы
+  таблицы пробелами до общей ширины, и эти пробелы уезжают в каждый заход, не значая ничего:
+  в словаре они составляли треть файла, а со строками-разделителями — сорок процентов. Перевод
+  тех же записей в список «- **термин** — что это» срезал вход на девять тысяч знаков, не тронув
+  ни одного слова. Таблица остаётся законной там, где столбцов больше двух и их сравнивают
+  глазами; проверки, читающие такой текст, знают обе формы.
 - **Состояние, объявленное правилом и забытое в карте, — расхождение.** Заход получает карту,
   не находит в ней своего состояния и идёт читать правило: карта работает ровно до первого
   нового состояния.

package/assets/rules/typescript-conventions.md

@@ -2,7 +2,7 @@
 name: typescript-conventions
 kind: rule
 law: code-structure
-description: Правило под «Закон об устройстве кода». Брать при правке любого .ts, кроме компонента, сервиса, директивы, пайпа, гарда и интерцептора — строгая типизация, модификаторы доступа, приватные поля, имена файлов, префиксы, перечисления, запрет приведения в маппере, процедуры Connect на бэкенде. Готовый код процедуры — в паттерне ts-procedure.
+description: Правило под «Закон об устройстве кода». Брать при правке любого .ts, кроме компонента, сервиса, директивы, пайпа, гарда и интерцептора: строгая типизация, модификаторы доступа, имена файлов, префиксы, запрет приведения в маппере. Паттерн ts-procedure.
 ---
 
 # Устройство кода — как это устроено здесь