@rt-tools/agent-kit 0.16.1 → 0.18.0

package/assets/rules/deploy-flow.azure.md

@@ -97,6 +97,14 @@ flowchart TD
   чужую правку. Гейт и выкатка зовут одну и ту же проверку — иначе «сошлось» станет значить в
   двух местах разное.
 
+- **Проверка, стоящая в наборе гейта, отказывает, когда не сумела отработать.** «Проверять
+  негде» и «проверка сломана» — разные вещи: первое дерево называет само — нет предмета, не задан
+  адрес, служба не отвечает, — и каждый такой выход отдаёт ноль своей строкой. Второе —
+  недостающий пакет, пустое имя в настройке, непредвиденное исключение — отдаёт ненулевой код и
+  говорит, что сломалась сама проверка, а не предмет. Общий ноль на оба делает сломанную проверку
+  неотличимой от сошедшейся: сверка схемы с миграциями простояла так в наборе гейта, не сверяя
+  ничего, и прятала за своим нулём сразу три причины.
+
 ## Чего из закона здесь нет
 
 Состояние прода машине не видно: сверка очереди работ спрашивает последний прогон главной

package/assets/rules/deploy-flow.github.md

@@ -66,6 +66,16 @@ flowchart TD
   составом, действует лишь на контейнер, поднятый этим составом; ручной прогон того же образа
   идёт с пустым значением, а пусто здесь означает локалхост — со всеми отладочными
   умолчаниями, которые он разрешает. Умолчание образа задаётся в самом образе.
+- **Состав прода поднимается на своей машине до слияния, а не после.** Собранный образ говорит
+  только о том, что сборка прошла: шаг наката, вход в хранилище, порядок подъёма и то, что
+  каждому контейнеру хватает положенного внутрь, видны одним запуском состава. На своей машине
+  это стоит одной команды, а на узле стоит выкатки, которую уже не отменить, — отказ наката
+  вылезает логом контейнера на узле.
+
+- **Образ несёт все файлы, которые читают его собственные шаги запуска.** Схема хранилища,
+  настройка клиента, шаблон окружения — всё, что лежит рядом в репозитории, внутрь образа само
+  не попадает, а сборка отвечает только на вопрос, собрался ли он. Отказ приходит на первом
+  подъёме, то есть уже на выкаченном.
 - **Образы выкатываются по sha коммита, а не по метке «последний».** Метка в реестре отстаёт
   от главной ветки, и прод молча возвращается к прежней версии, продолжая отвечать.
 - **Убирает за собой и та машина, которая образы собирает.** Отбор у обеих один — своё имя
@@ -78,6 +88,15 @@ flowchart TD
   висячим не бывает никогда, и чистка висячего его не касается: за полгода они съедают диск
   сервера целиком. Три sha — это глубина отката, и меньше брать нельзя: поломка, замеченная
   через две выкатки, откатывается уже некуда.
+- **Состоявшаяся поломка прода разбирается записью, а не одной починкой.** Починка уезжает
+  веткой, задача закрывается — и причина, по которой приложение встало, остаётся знанием одного
+  исполнителя. Запись называет, что сломалось, чем это стало видно и почему починка чинит
+  причину, а не признак; лежит она среди описаний состоявшегося, каталог называет компаньон
+  правила слога.
+- **Правка самой выкатки прогоняется до слияния, а «проверю после слияния» решением исполнителя
+  не бывает.** Прогнать её иначе нечем: она исполняется только там, где выкатывает. Прогнать
+  нечем и вручную — тогда это говорится владельцу словами, вместе с тем, чего проверка стоила бы,
+  и решение отложить принимает он.
 - **Описание прода правится вместе с составом прода.** Устройство, путь запроса, гейты и
   бэкапы описаны текстами вне слоёв правил, и ни линтер, ни сборка их не читают: расхождение
   копится молча, а читают эти тексты как действующие. Пару стережёт гард документов.
@@ -105,6 +124,14 @@ flowchart TD
   чужую правку. Гейт и выкатка зовут одну и ту же проверку — иначе «сошлось» станет значить в
   двух местах разное.
 
+- **Проверка, стоящая в наборе гейта, отказывает, когда не сумела отработать.** «Проверять
+  негде» и «проверка сломана» — разные вещи: первое дерево называет само — нет предмета, не задан
+  адрес, служба не отвечает, — и каждый такой выход отдаёт ноль своей строкой. Второе —
+  недостающий пакет, пустое имя в настройке, непредвиденное исключение — отдаёт ненулевой код и
+  говорит, что сломалась сама проверка, а не предмет. Общий ноль на оба делает сломанную проверку
+  неотличимой от сошедшейся: сверка схемы с миграциями простояла так в наборе гейта, не сверяя
+  ничего, и прятала за своим нулём сразу три причины.
+
 ## Чего из закона здесь нет
 
 Состояние прода машине не видно: сверка очереди работ спрашивает последний прогон главной

package/assets/rules/deploy-flow.gitlab.md

@@ -99,6 +99,14 @@ flowchart TD
   чужую правку. Гейт и выкатка зовут одну и ту же проверку — иначе «сошлось» станет значить в
   двух местах разное.
 
+- **Проверка, стоящая в наборе гейта, отказывает, когда не сумела отработать.** «Проверять
+  негде» и «проверка сломана» — разные вещи: первое дерево называет само — нет предмета, не задан
+  адрес, служба не отвечает, — и каждый такой выход отдаёт ноль своей строкой. Второе —
+  недостающий пакет, пустое имя в настройке, непредвиденное исключение — отдаёт ненулевой код и
+  говорит, что сломалась сама проверка, а не предмет. Общий ноль на оба делает сломанную проверку
+  неотличимой от сошедшейся: сверка схемы с миграциями простояла так в наборе гейта, не сверяя
+  ничего, и прятала за своим нулём сразу три причины.
+
 ## Чего из закона здесь нет
 
 Состояние прода машине не видно: сверка очереди работ спрашивает последний прогон главной

package/assets/rules/doc-style.md

@@ -87,6 +87,20 @@ flowchart TD
   расходится снова через сутки.
   <!-- rt-when: *.md -->
 
+- **Указатель заводится каталогу, который читают по нему, а не обходом.** Каталог, где имя файла
+  собрано из номера задачи и имени ветки, ищется своим именем, и перечень отвечает на один
+  вопрос — какие записи здесь лежат, — на который отвечает обход. Цена у него при этом полная:
+  строку в конец дописывает каждая закрытая работа, и каждая ветка получает от хостинга метку
+  конфликта. Список каталогов со сверкой указателя объявляет дерево, и пустой список — законное
+  его состояние.
+
+- **Запись указателя называется именем файла в обратных кавычках.** Сверка полноты читает
+  первое такое имя в строке таблицы и другой формы не знает: строка, где запись названа одной
+  ссылкой с заголовком, для неё пуста — записи в ней нет, и о недостающих она молчит. Читателю
+  при этом видно всё, и промах держится ровно поэтому. Ссылка с заголовком законна и ставится
+  в той же строке при имени.
+  <!-- rt-when: *.md -->
+
 - **Имя, названное затем, чтобы сказать «его нет», стоит в списке исключений поимённо.**
   Отличить такое упоминание от ссылки машине нечем, а текст без него теряет смысл: правило и
   замысел предупреждают именно о снятом. Туда же — то, что появляется только после сборки,
@@ -136,6 +150,12 @@ flowchart TD
   который сослался. Живой текст называет решение словами, а не адресом записи.
   <!-- rt-when: *.md -->
 
+- **Схема правится тем же изменением, что и текст, который она изображает.** Разойдясь, схема и
+  проза остаются читаемыми обе, и первым это замечает тот, кто пошёл по схеме: она короче, её
+  читают вместо текста, и расхождение уводит работу целиком. Ни одна проверка этого не видит —
+  схема набрана словами и от текста рядом отличима только чтением.
+  <!-- rt-when: *.md -->
+
 ## Чего из закона здесь нет
 
 Ни одна из формулировочных договорённостей не проверяется: одна фраза на правило, простые

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

@@ -131,9 +131,17 @@ flowchart TD
 - **Отставшее состояние находится сверкой очереди, а не глазами.** Сверка судит состояние по
   PR в обе стороны: открытый PR при элементе не в разборе и разбор без открытого PR — оба
   расхождения. Момента, когда задачу берут в работу, ей не видно: ветки на доске нет.
+- **Ветка с открытой заявкой отстаёт от главной молча.** Гард судит основание один раз — в
+  минуту открытия; всё, что влилось в главную, пока шёл прогон, зелёный прогон не видит вовсе, и
+  влитая оттуда заявка приносит в главную ветку сочетание, которое не проверял никто. Отставание
+  находит сверка очереди работ: она спрашивает у хранилища, на сколько коммитов ветка каждой
+  открытой заявки позади главной, и называет число.
 - **Задачи, чинящиеся одной правкой, сливаются до слияния ветки.** Вторая закрывается как
-  дубликат, а недостающее из неё дописывается в первую. После слияния слить уже нельзя: ветка
-  въехала, и откатывается она целиком.
+  дубликат, а недостающее из неё дописывается в первую. Закон велит вторую стереть, и это второе
+  объявленное отступление: у рабочего элемента здесь есть родная связь «дубликат», удаление
+  уносит вместе с ним историю правок и вложения, а номер после него не переиспользуется —
+  ссылка на стёртый элемент из чужого коммита ведёт в пустоту. После слияния слить уже нельзя:
+  ветка въехала, и откатывается она целиком.
 - **Работа, которую одним заходом не закрыть, помечена в двух местах, и они сверяются.** Метка
   на доске и строка о заходах с передачей в замысле эпика говорят одно и то же двум читателям:
   исполнитель открывает карточку раньше, чем замысел эпика, а планирует по замыслу. Одна пометка без
@@ -155,6 +163,11 @@ flowchart TD
   отбивает пуш, а не печатается рядом с ним: напечатанное предупреждение исполнитель читает как
   разрешение. Дважды подряд правка, прошедшая гейт целиком, была отбита конвейером — и оба раза
   зелёный гейт был прочитан как «локально всё зелено».
+- **Причина исключения, называющая задачу, судится на живость этой задачи.** Отсрочка со сроком
+  и отсрочка без срока выглядят одинаково, пока номер никто не спросил; мёртвый номер в причине
+  делает исключение бессрочным, не сказав об этом ни строкой. Спрашивается тем же ярусом, что
+  состояние задачи у гарда поставки: есть чем спросить — спрашивает, нет сети или доступа —
+  пропускает молча.
 - **Сверка раскладки стоит в наборе гейта пуша наравне с линтом и сборкой.** Правка, положенная
   в разложенную копию мимо источника, в день, когда её делают, не ломает ничего: дерево
   работает, проверки зелёные, а расхождение видно только тому, кто позовёт сверку сам. Копится
@@ -187,6 +200,13 @@ flowchart TD
 
 ## Чего из закона здесь нет
 
+Ключа задач у этого хостинга нет, и форма имени строится из одного номера. Закон требует писать
+номер всюду одинаково — «ключ, дефис, номер», — и это отступление от него, объявленное здесь:
+номер рабочего элемента уникален на весь проект, а родная форма ссылки хостинга — `AB#<номер>` —
+ключа не несёт вовсе, и приписанный к ней он ломает связывание коммита с элементом. Настройки
+`board.taskKey` дерево на этом хостинге не заводит; проверки, которые ищут ключ в заголовке,
+судят здесь номер без него.
+
 Гард поставки стоит на командах агента, поэтому ветку, заведённую руками в редакторе, он не
 видит: имя такой ветки держится памятью. Требование от этого не слабеет — просто отдельной
 проверки под него не заводится: работа опознаётся заголовком рабочего элемента и PR, а это

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

@@ -2,7 +2,7 @@
 name: git-workflow
 kind: rule
 law: delivery
-description: Правило под «Закон о поставке» для дерева на GitHub. Брать на заведение задачи, ветки, коммит, пуш, открытие PR и мерж. Называет соответствие задачи и ветки один к одному, имена, машинную учётную запись и гарды поставки. Паттерны: git-workflow-commit, -pr, -merge. Выкатка — правило deploy-flow.
+description: Правило под «Закон о поставке» для дерева на GitHub. Брать на заведение задачи, ветки, коммит, пуш, открытие PR и мерж. Называет пару «задача и ветка» один к одному, имена, машинную запись и гарды поставки. Паттерны: git-workflow-commit, -pr, -merge, -stack. Выкатка — правило deploy-flow.
 ---
 
 # Поставка — как это устроено здесь
@@ -71,13 +71,25 @@ flowchart TD
 - **Главная ветка влита в ветку задачи до открытия PR.** Гард отбивает открытие, пока вершина
   главной не стала предком текущей, и называет расхождение числом коммитов: иначе ревьювер видит
   свою правку вперемешку с чужой, а проверено всё было от основания, которого уже нет.
-- **Несошедшиеся условия поставки называются одним отказом, а не по одному.** Гард копит их все и
-  печатает разом: круг «правь — повтори — упрись в следующее» стоит вызова за вызовом, хотя всё
-  несошедшееся известно на первом.
-- **Условие, известное в начале работы, спрашивается в начале.** Заведение ветки отбивает
-  основание без вершины главной и рабочую копию с чужой почтой в подписи. На пуше и на открытии
-  PR те же проверки остаются вторым рубежом, но стоят дороже: основание чинится вливанием с
-  конфликтом, подпись — переписыванием всей ветки.
+- **Волна веток от одной главной проверяется пробным слиянием, а не по одной:** каждая зелена
+  сама по себе, а сталкиваются они тем, чего на отдельной ветке не видно.
+- **Ветка следующей работы отводится от предыдущей, пока череда не прервалась.** `git checkout -b
+  <КЛЮЧ>-<номер>-<slug> <предыдущая ветка>` вместо `origin/main`; от главной — только первая работа
+  череды. Иначе первое же слияние делает расходящимися все остальные разом.
+- **У заявки в череде основанием стоит предыдущая ветка, а не главная.** `gh pr create --base
+  <предыдущая ветка>` — иначе разбор показывает свою правку вперемешку со всем, что под ней. Базу
+  влитой нижней хостинг переносит сам.
+- **Череда вливается снизу вверх, и порядок стоит в теле каждой заявки.** Родство веток по
+  списку не видно: строка «стоит на #<номер>» — единственное место, где владелец это прочтёт.
+- **Нижняя ветка череды историю не переписывает — ни `rebase`, ни силовой отправкой.** Хостинг
+  закрывает заявку верхней как слитую при пустой главной. Отставшая чинится вливанием главной.
+- **Расхождение внутри череды разбирается тем, кто ветвится.** У него обе правки свои; у
+  владельца, разбирающего то же при слиянии, нет ни одной.
+- **Несошедшиеся условия поставки называются одним отказом.** Гард копит их и печатает разом: всё
+  несошедшееся известно на первом вызове.
+- **Условие, известное в начале работы, спрашивается в начале.** Заведение ветки отбивает основание
+  без вершины главной и чужую почту в подписи. На пуше те же проверки стоят дороже: основание
+  чинится вливанием с конфликтом, подпись — переписыванием ветки.
 - **Судится то основание, которое названо командой, а не вершина рабочей копии.** Ветку заводят и
   от `origin/main` прямо — этой командой основание как раз и берут свежим. Основание, о котором
   дерево ничего не знает, не судится вовсе.
@@ -85,62 +97,68 @@ flowchart TD
   требовать от неё свежего основания значило бы отбивать работу, которая в главную не поедет.
 - **Ключ задач задаётся один раз, и все три формы имени выводятся из него.** По нему собирается
   заголовок задачи, из него достаётся номер ветки, по нему же сверка читает заголовок PR. Форма
-  ветки в профиле дерева пишется той же парой `<КЛЮЧ>-<номер>`: разойдясь, они не отказывают, а
-  перестают узнавать номер — проверка, искавшая работу без задачи, пропускает всё подряд.
+  ветки в профиле дерева пишется той же парой `<КЛЮЧ>-<номер>`.
 - **Незаданный ключ отбивает работу с очередью на месте.** Модуль борды отказывает при первом же
   вызове и называет, где ключ задаётся. Умолчания нет намеренно: собранный из пустого значения
   заголовок не совпадает ни с чем, и настоящее расхождение тонет среди ложных строк.
 - **Заведённая задача подтверждается ответом очереди работ, а не выводом команды заведения.**
-  Напечатанный номер значит «вызов прошёл», а не «задача видна тому, кто по ней работает»:
-  команда может завести задачу и не довести её до борды. Спрашивается очередь — по номеру, одним
-  вызовом, — и ответ читается колонкой и исполнителем.
+  Напечатанный номер значит «вызов прошёл»: задачу можно завести и не довести до борды.
+  Спрашивается очередь по номеру, и ответ читается колонкой и исполнителем.
+- **Видимость заведённого проверяется той стороной, которой оно предназначено.** Заявку читает
+  человек, задачу — очередь работ, и оба читают не тем токеном, которым заводили: ограниченная
+  запись отвечает им «не найдено», а заводившей — успехом.
+- **Отказ читается прежде, чем его обходят вторым способом.** Он бывает ранним признаком
+  ограничения записи, и обход другим вызовом уносит признак с собой: расхождение всплывает у
+  владельца. Ограничение от исчерпания отличает ответ о пределах — там ноль.
 - **Номер ветки и номер в заголовке PR сверяются на месте, а состояние задачи — по борде.**
-  Формат читается из текста команды и работает без сети; существование задачи, колонка,
-  исполнитель и разбор — только когда есть чем спросить. Нет сети или токена — второй ярус молча
-  пропускается: проверка, падающая в самолёте, перестаёт что-либо значить.
+  Формат читается из текста команды и работает без сети; задача, колонка, исполнитель и разбор —
+  только когда есть чем спросить. Нет сети или токена — второй ярус молча пропускается.
 - **Колонка задачи двигается тем же движением, что и работа.** Ветка заведена — задача во взятых
   в работу, PR открыт — в ждущих разбора; делает это команда перевода, а не вызовы GraphQL по
   памяти. Перевод идёт сразу за шагом: очередь читают между шагами, а не после них.
 - **Задача, оставшаяся в первой колонке, PR не открывает.** По очереди работ она читается как
   невзятая, хотя работа сделана и выложена. На заведении ветки колонка не спрашивается — там её
   ещё не двигали. Имя первой колонки дерево называет само; не названо — колонка не судится.
-- **На борде стоят задачи, а не PR о них.** Борда показывает, что сделано и что осталось; PR
-  отвечает на другой вопрос и связывается с карточкой сам. Карточка PR колонки не имеет, из
-  очереди не уходит и остаётся навсегда — заводится она правилом борды или рукой, и то и другое
-  выключается. Находит их сверка очереди — строкой на каждую.
-- **Отставшая колонка находится сверкой очереди, а не глазами.** Сверка судит колонку по PR в обе
-  стороны: открытый PR при задаче не в разборе и разбор без открытого PR — оба расхождения.
-  Момента, когда задачу берут в работу, ей не видно: ветки на борде нет.
+- **На борде стоят задачи, а не PR о них.** Карточка PR колонки не имеет, из очереди не уходит и
+  остаётся навсегда; заводит её правило борды или рука, и то и другое выключается. Находит такие
+  карточки сверка очереди — строкой на каждую.
+- **Отставшая колонка находится сверкой очереди, а не глазами.** Она судит колонку по PR в обе
+  стороны: открытый PR при задаче не в разборе и разбор без открытого PR. Момента, когда задачу
+  берут в работу, ей не видно: ветки на борде нет.
+- **Ветка с открытой заявкой отстаёт от главной молча.** Основание гард судит раз, в минуту
+  открытия, а влитого после не видит и прогон. Отставание считает сверка очереди работ.
+- **Связь задачи с эпиком сверка читает в обе стороны.** Односторонняя привязка выглядит целой
+  так же, как двусторонняя: читатель приходит то от замысла эпика, то от карточки. Держалась она
+  подражанием — тело с образца соседней задачи везло строку вместе с формой.
 - **Задачи, чинящиеся одной правкой, сливаются до мержа.** Вторая стирается вместе с номером, а
-  недостающее дописывается в первую. После мержа слить уже нельзя: ветка въехала целиком.
+  недостающее дописывается в первую: после мержа ветка въехала целиком.
 - **Работа, которую одним заходом не закрыть, помечена в двух местах, и они сверяются.** Метка на
-  борде и строка о заходах в замысле эпика говорят одно и то же двум читателям, и одна без другой
-  лжёт молча. Помечается только то, что законно не делится: пометка объёма правом делить не
-  становится.
+  борде и строка о заходах в замысле эпика говорят одно и то же двум читателям. Помечается только
+  то, что законно не делится.
 - **Вершина открытого PR без прогона видна сверкой очереди работ.** Страница без прогона выглядит
-  так же, как с зелёным: цвета нет ни там, ни там. Сверка спрашивает вершину, а не ветку, считает
-  сам факт прогона, а не цвет, и свежей вершине даёт время.
-- **Прогон, вытесненный из очереди конвейера, сверка называет отдельной строкой.** Следующий
-  встающий вытесняет ждущего, и тот выглядит упавшим, хотя ветку не проверял ни строчкой.
-  Отличает их число заданий — у вытесненного оно ноль.
-- **Черновик при зелёном прогоне на вершине — расхождение сверки.** У черновика кнопка слияния
-  заблокирована хостингом: зелёная страница PR владельцу ничего не разрешает, а список, в котором
-  всё серое, читается как «работа не сделана». Гард закрывает это внутри хода; между ходами —
-  ночью, в чужой сессии, после закрытого разговора — заявку находит сверка.
-- **Свои черновики судятся все разом, а не тот один, чья ветка сейчас взята.** Проверка по
-  текущей ветке меняет предмет суждения вместе с переключением и молчит там, где работа брошена:
-  прогон по оставленной заявке доходит, черновик стоит, главная уходит вперёд. Спрашиваются все
-  открытые черновики машинной записи, и каждый судится двумя признаками — зелёный прогон на его
-  вершине и разобранная папка задачи в его ветке; лежащая папка означает идущую работу. Дерево,
-  не назвавшее машинной записи, этого не получает.
-- **Открытие PR отбивается, пока ветка везёт папку своей задачи.** Уборка стоит до открытия:
-  кнопку слияния нажимает человек там, где гардов нет, и вливает он, как только видит зелёное.
-  Отказ на слиянии остаётся вторым рубежом, но первым спрашивается открытие — это последняя
-  точка, где отказ ещё виден тому, кто может его выполнить.
-- **Конфликтующий открытый PR — расхождение сверки очереди работ.** Конфликт приезжает в отданный
-  PR чужим слиянием, без единого действия автора, и по списку не виден вовсе: метку хостинг
-  показывает только внутри самого PR. Непосчитанная сливаемость расхождением не считается —
-  хостинг считает её заново после каждой правки главной.
+  так же, как с зелёным: цвета нет ни там, ни там. Сверка спрашивает вершину, считает сам факт
+  прогона, а не цвет, и свежей вершине даёт время.
+- **Прогон, вытесненный из очереди конвейера, сверка называет отдельной строкой.** Он выглядит
+  упавшим, хотя ветку не проверял; отличает их число заданий — у него ноль.
+- **Черновик при зелёном прогоне на вершине — расхождение сверки.** Зелёная страница черновика
+  владельцу ничего не разрешает: кнопка заблокирована хостингом. Внутри хода это закрывает гард,
+  между ходами — сверка.
+- **Свои черновики судятся все разом, а не тот один, чья ветка сейчас взята.** Каждый черновик
+  машинной записи судится двумя признаками — зелёный прогон на его вершине и разобранная папка
+  задачи в его ветке; лежащая папка означает идущую работу.
+- **Открытие PR отбивается, пока ветка везёт папку своей задачи.** Кнопку слияния нажимает
+  человек там, где гардов нет, и открытие — последняя точка, где отказ ещё виден тому, кто может
+  его выполнить.
+- **Свои открытые заявки перечитываются в трёх местах: перед пушем, при взятии задачи и после
+  каждого известного слияния.** Заявка устаревает без действия автора: влита соседняя работа —
+  остальные в ту же секунду отстали. Приём — `git-workflow-freshness`.
+- **Конфликтующая своя заявка чинится первым действием хода, а новая работа до этого не
+  берётся.** Пока отданное конфликтует, влить его человек не может, и каждая следующая заявка
+  прибавляет к очереди ещё одну, которую придётся догонять. Работой здесь считается заведение
+  задачи, заведение ветки, перевод колонки в работу и открытие заявки; всё, чем конфликт чинится,
+  идёт как прежде.
+- **Конфликтующий открытый PR — расхождение сверки очереди работ.** Конфликт приезжает чужим
+  слиянием и по списку не виден: метку хостинг показывает только внутри самого PR.
 - **Документ едет в том же коммите, что и правка.** Обход — строка `Docs-skip: <причина>` в теле
   коммита; пустая причина не принимается.
 - **Заголовок коммита сверяется с форматом на месте.** Разобранный по типу и области заголовок
@@ -151,22 +169,27 @@ flowchart TD
   только импортированное тестом: ошибка типов в непокрытом коде доживает до сборки образа, то
   есть до мержа.
 - **Набор гейта пуша не бывает уже набора конвейера.** Гейт — обещание, что пуш не приедет
-  красным; набор без сборки и снимков обещает то, чего не проверяет. Шаг конвейера, которому в
-  наборе гейта нет ни строки, ни объявленного исключения с причиной, отбивает пуш, а не
-  печатается рядом с ним: напечатанное предупреждение исполнитель читает как разрешение.
-- **Сверка раскладки стоит в наборе гейта пуша наравне с линтом и сборкой.** Правка мимо
-  источника в день, когда её делают, не ломает ничего и копится молча, а всплывает на чужой
-  работе: раскладка отказывает по правленому файлу целиком. Статьёй выше это не покрывается —
-  сверки нет в конвейере, значит нет и шага, который она бы закрывала.
+  красным. Шаг конвейера, которому в наборе гейта нет ни строки, ни объявленного исключения с
+  причиной, отбивает пуш, а не печатается рядом: предупреждение читается как разрешение.
+- **Набор гейта зовёт умолчание пакета, а не перечисляет его строками.** Переписанный строками, он
+  закрывает сегодняшнюю дыру и оставляет завтрашнюю: заведённая пакетом проверка до дерева не
+  доедет. Отсеивать из умолчания законно, но поимённо и с причиной.
+
+- **Причина исключения, называющая задачу, судится на живость этой задачи.** Мёртвый номер делает
+  исключение бессрочным, не сказав об этом ни строкой. Спрашивается тем же ярусом, что состояние
+  задачи у гарда: нет сети или доступа — пропускает молча.
+- **Сверка раскладки стоит в наборе гейта пуша наравне с линтом и сборкой.** Правка мимо источника
+  копится молча: раскладка отказывает по правленому файлу целиком. Статьёй выше это не покрывается —
+  сверки нет в конвейере.
 - **После вливания главной ветки набор проверок пересматривается по тому, что ветка везёт
   теперь.** Вливание меняет состав правки: проверять по тому, что правил автор, — значит
   проверять половину, а отвечает ветка целиком.
 - **Утверждение о главной ветке делается по удалённой ссылке, а не по локальной.** Локальная
-  протухает в ту минуту, когда её подтянули, и молчит об этом. Сравнение пишется от `origin/main`
-  целиком: смешав удалённую ссылку с локальной в одной команде, промах изнутри выглядит верным.
-- **Правка кода отдаётся человеку открытым PR, а не запушенной веткой.** Ветка ему не
-  показывается, во входящие не приходит и обсуждения не имеет: до открытия PR правки для человека
-  нет. Открывается он тем же ходом, которым исполнитель говорит, что работу отдаёт.
+  протухает в минуту, когда её подтянули, и молчит об этом. Сравнение пишется от `origin/main`
+  целиком: смешанные в одной команде, они дают промах, изнутри выглядящий верным.
+- **Правка кода отдаётся человеку открытым PR, а не запушенной веткой.** Ветка во входящие не
+  приходит и обсуждения не имеет: до открытия PR правки для человека нет. Открывается он тем же
+  ходом, которым исполнитель говорит, что работу отдаёт.
 - **Не готовое к слиянию открывается черновиком — `gh pr create --draft`.** Кнопка слияния у
   черновика заблокирована хостингом, поэтому «выложено на обозрение» и «можно вливать» перестают
   выглядеть одинаково. Черновиком идёт всё, что ждёт прогона, доработки или ответа на вопрос.
@@ -174,89 +197,75 @@ flowchart TD
   готовность: проверки пройдены, доработок не осталось, работа сходится с задачей. Снятие
   черновика и просьба влить — один ход, а не два разных дня.
 - **Черновик не снимается с ветки, которая не сливается.** Зелёный прогон говорит «не сломано»,
-  сливаемость — «кнопку можно нажать», и владельцу нужно второе. Спрашивается у хостинга тем же
-  вызовом, что автор и ревьювер: `mergeable` приходит в том же ответе. Выводить её из локального
-  вливания нельзя — между ним и взглядом владельца главная уходит вперёд. Дерево, чей помощник
-  очереди о сливаемости не говорит, работает как прежде: поля нет, требования нет.
+  сливаемость — «кнопку можно нажать», и владельцу нужно второе. Спрашивается у хостинга полем
+  `mergeable`; из локального вливания она не выводится.
 - **Указателю, в который ветки только дописывают строки, объявляется сложение обеих сторон.**
-  Конфликт там не спор: обе допись нужны целиком, а человека он зовёт при каждом слиянии.
-  Объявление снимает ручное разрешение, но **метку сливаемости не гасит**: хостинг считает её
-  своим приёмом и настроек слияния не читает — гаснет она, когда ветка вобрала главную и это
-  уехало на хостинг.
+  Конфликт там не спор: обе допись нужны целиком. Метку сливаемости объявление **не гасит** — она
+  гаснет, когда ветка вобрала главную и это уехало на хостинг.
 - **Правка, доведённая до коммита, доводится до хостинга тем же ходом.** Владелец видит прежнее
   состояние и читает его как «не сделано ничего», а сделанное лежит там, где его не видит никто.
   Оставшееся в дереве называется причиной — словом владельца, а не списком остатков.
 - **Черновик не снимается, пока у PR нет разбора.** Гард смотрит запрошенного ревьювера и
-  оставленный отзыв: снятый черновик читается как «можно вливать», а вливать некому. Раньше этого
-  хода спросить негде. Судится и вызов без номера — без него клиент берёт PR текущей ветки, и
-  требование снималось бы одним пробелом.
+  оставленный отзыв: снятый черновик читается как «можно вливать», а вливать некому. Судится и
+  вызов без номера — без него клиент берёт PR текущей ветки.
 - **Мерж PR нажимает человек, а не исполнитель работы.** Кнопка и вызов слияния равны: запрет на
   них один. Исполнитель сливает свой PR только тогда, когда человек сказал это прямо и про этот
   PR; сказанное об одном на следующий не переносится, а молчание разрешением не бывает.
 - **Личность вызова, открывающего заявку, стережёт гард поставки, а не память исполнителя.** Она
-  приходит окружением и из текста команды видна только явной подстановкой токена — её гард и
-  требует; дерево, не назвавшее машинной записи, требования не получает. Ответ хостинга об авторе
-  он спрашивает на снятии черновика: это последний ход, где промах исправим — влитую заявку не
-  переоткрыть, а автора у неё не сменить.
+  приходит окружением, и в тексте команды её видно только явной подстановкой токена. Ответ
+  хостинга об авторе гард спрашивает на снятии черновика: влитую заявку не переоткрыть.
 
-- **Автор PR не может быть его ревьювером.** Запрос разбора на самого себя GitHub принимает и
-  молча не создаёт — разбор при этом выглядит запрошенным. В разборе считаются только запрос и
-  отзыв не от автора.
+- **Автор PR не может быть его ревьювером.** Запрос разбора на себя GitHub принимает и молча не
+  создаёт: разбор выглядит запрошенным. Считаются только запрос и отзыв не от автора.
 - **Вызов клиента хостинга идёт из дерева, а связка команд исхода не проверяет.** Репозиторий
   клиент берёт у текущего каталога и вне дерева отказывает; следующее звено связки увозит на
   хостинг то, что осталось от отказавшего, поэтому тело читается обратно тем же ходом.
-- **Метки, исполнитель и ревьювер PR ставятся вызовами `gh api`, а не `gh pr edit`.** На
-  репозитории со старой бордой `gh pr edit` отвечает отказом про Projects (classic) и до правки
-  не доходит.
-- **Борда правится запросом GraphQL по идентификатору самой борды, а не по имени владельца.**
-- **Почта машинного коммита копируется из компаньона, а не набирается по памяти.** Служебный
-  адрес — `<число>+<логин>@users.noreply.github.com`, и сопоставляется он по числу: логин рядом с
-  ним не сверяет никто. Коммит с чужим числом уезжает подписанным посторонним, а изнутри промах
-  не виден. Ту же строку держит профиль дерева, и гард отбивает пуш при расхождении.
-- **Личность машинной записи подтверждается ответом хостинга, а не узнаванием строки.** Знакомый
-  вид строки подтверждением не бывает. Спрашивается токеном самой записи, ответом о себе: логин и
-  число приходят вместе — поиск по числу для ограниченной записи отвечает «не найдено».
-- **Сценарии гардов задают настройки git сами, а не берут их с машины.** Включённая на машине
-  подпись уводит git в агент ключей, а заблокированный агент роняет весь набор — со стороны это
-  выглядит сломанным гардом. Автор, почта и подпись передаются флагами `-c` прямо в команду.
+- **Метки, исполнитель и ревьювер PR ставятся вызовами `gh api`, а не `gh pr edit`.** На старой
+  борде `gh pr edit` отвечает отказом про Projects.
+- **Борда правится запросом GraphQL по идентификатору борды, а не по имени владельца.**
+- **Почта машинного коммита копируется из компаньона, а не набирается по памяти.** Служебный адрес
+  `<число>+<логин>@users.noreply.github.com` сопоставляется по числу: коммит с чужим числом уезжает
+  подписанным посторонним. Ту же строку держит профиль дерева, и гард отбивает пуш.
+- **Личность машинной записи подтверждается ответом хостинга, а не узнаванием строки.** Спрашивают
+  её токеном, ответом о себе: логин и число приходят вместе.
+- **Сценарии гардов задают настройки git сами, а не берут их с машины.** Подпись, включённая на
+  машине, уводит git в агент ключей, а заблокированный агент роняет весь набор: автор, почта и
+  подпись идут флагами `-c` прямо в команде.
 
 - **Каждый коммит вклада ветки подписан машинной записью, и это проверяется набором пуша.** Гард
-  поставки судит только коммит, назвавшийся ею, и подписанный человеком проходит мимо: там, где
-  человек не коммитит вовсе, это промах, а не законный случай.
+  судит только коммит, назвавшийся ею; подписанный человеком проходит мимо, а там, где человек не
+  коммитит вовсе, это промах.
 - **Состояние заявки перечитывается у хостинга сразу после публикации, а не берётся из кода
-  возврата.** Открытие заявки и постановка ревьювера отвечают нулём и тогда, когда сделали не то
-  или не сделали ничего.
+  возврата.** Открытие и постановка ревьювера отвечают нулём и тогда, когда не сделали ничего.
 - **Автор открытой заявки и наличие у неё ревьювера сверяются очередью работ.** До слияния оба
-  промаха не видны ничем: заявка, открытая человеком, ревьювера не получит никогда, и выглядит
-  это как заявка, которой его просто не поставили.
-- **Ревьюверы спрашиваются вызовом REST, а не выборкой клиента.** Её поля собираются запросом
-  GraphQL, а тот требует области чтения организации, которой у машинной записи нет: «сошлось»
-  перестаёт отличаться от «спросить было нечем».
-- **Силовая отправка ветки, стоящей под другой в стопке, закрывает её заявку как слитую.**
-  Хостинг считает заявку слитой, когда вершина её ветки достижима из базы; состояние лживое — в
-  главной ветке правки нет, а задача остаётся открытой.
+  промаха не видны: заявка, открытая человеком, ревьювера не получит никогда, и выглядит это как
+  заявка, которой его просто не поставили.
+- **Ревьюверы спрашиваются вызовом REST, а не выборкой клиента.** Её поля собирает GraphQL, а он
+  требует прав, которых у машинной записи нет: «сошлось» не отличить от «спросить было нечем».
+
+- **Рабочее дерево не опустошается ради прогона инструмента.** Сравнение с прежним состоянием
+  идёт на второй копии: прятанье уводит незакоммиченную работу туда, где её не видит ни состояние
+  дерева, ни сверка.
 
 ## Чего из закона здесь нет
 
 Гард поставки стоит на командах агента, поэтому ветку, заведённую руками в редакторе, он не
-видит: имя такой ветки держится памятью. Требование от этого не слабеет — просто отдельной
-проверки под него не заводится: работа опознаётся заголовком задачи и PR, а это сверяется
-у всех. Сверка очереди имя ветки не судит вовсе: у открытого PR его не переименовать.
+видит: имя такой ветки держится памятью. Отдельной проверки под него не заводится — работа
+опознаётся заголовком задачи и PR. Сверка очереди имя ветки не судит вовсе.
 
 Задачу в работу гард не переводит: борду он не правит — правка борды в разборе команды падала бы
-вместе со связью и отбивала бы работу вместо промаха. Перевод держится памятью и подсказкой,
-которую печатает команда заведения задачи. Задачу, оставшуюся в первой колонке, гард называет на
-открытии PR — то есть после того, как её должны были переставить; прочие расхождения колонки
-находит сверка очереди.
+вместе со связью. Перевод держится памятью и подсказкой команды заведения задачи; задачу,
+оставшуюся в первой колонке, гард называет на открытии PR, прочие расхождения колонки находит
+сверка очереди.
 
-Свежесть самой вершины главной ветки гард спрашивает вторым ярусом — тем же приёмом, что и
-состояние задачи: есть чем спросить, спрашивает; нет сети или доступа — пропускает молча.
-Первый ярус при этом остаётся, и работает он без сети: локальная ссылка отвечает на вопрос
-«отстала ли ветка от того, что уже лежит в дереве», удалённая — на вопрос «не протухла ли сама
-ссылка». Без второго яруса молчание гарда значило лишь первое, а читалось как второе.
+Свежесть вершины главной ветки гард спрашивает вторым ярусом — тем же приёмом, что и состояние
+задачи. Первый ярус работает без сети: локальная ссылка отвечает, отстала ли ветка от лежащего
+в дереве, удалённая — не протухла ли сама ссылка.
 
 ## Паттерны
 
 - `git-workflow-commit` — задача, ветка, коммит и пуш от учётной записи машинной работы.
 - `git-workflow-pr` — открытие PR, черновик и его снятие, тело, ревьювер, метки, состояние.
 - `git-workflow-merge` — главная ветка влита в ветку задачи, конфликт разобран.
+- `git-workflow-stack` — череда веток: ветвление от предыдущей, основание заявки, порядок отдачи.
+- `git-workflow-freshness` — свои открытые заявки: чтение всех разом, отставание против спора.