@rt-tools/agent-kit 0.21.0 → 0.23.0

package/assets/hooks/grill-gate.sh

@@ -101,6 +101,7 @@ if command -v skill_for >/dev/null 2>&1 && [ -n "$rules_dir" ]; then
     edited="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r '
         def is_input:
             .type == "user"
+            and ((.isCompactSummary // false) | not)
             and (((.message.content // []) | if type == "array"
                     then ([.[] | select(.type == "tool_result")] | length)
                     else 0 end) == 0);
@@ -133,6 +134,7 @@ fi
 verdict="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r --arg re "$read_re" --arg tool "$tool" --arg need "$need_re" --arg rules "$rules_dir" '
     def is_input:
         .type == "user"
+        and ((.isCompactSummary // false) | not)
         and (((.message.content // []) | if type == "array"
                 then ([.[] | select(.type == "tool_result")] | length)
                 else 0 end) == 0);
@@ -163,6 +165,68 @@ verdict="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r --arg re "$read_re"
     | if ($asked_prose or $asking_now) and ($read | not) then "ask" else "pass" end
 ' 2>/dev/null)"
 
+# Второй признак того же гарда: на этот вопрос владелец уже отвечал.
+#
+# Первый признак судит, читались ли правила, и на разрешённой работе молчит. А промах бывает
+# другой: владелец дал указание прямой репликой, исполнитель нашёл факт, который меняет цену
+# указания, но не его смысл, — и вместо строки о цене задал меню, где два варианта из трёх
+# предлагали отменить решение владельца. Работа встала до ответа, разрешённая минутой раньше.
+#
+# Судится пересечение слов: вопрос, который сейчас уходит, против последней реплики владельца —
+# и только там, где в записи уже был вызов инструмента вопроса, то есть владелец на вопрос
+# отвечал. Понимания текста здесь нет и не нужно: три общих значимых слова означают тот же
+# предмет, а разбор из шести вопросов идёт по разным предметам и порога не набирает.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ: нет вопроса в вызове, нет реплики владельца, нет прошлого вопроса —
+# признак молчит.
+if [ -n "$tool" ]; then
+    asked_json="$(printf '%s' "$input" | jq -r '(.tool_input.questions // []) | tostring' 2>/dev/null)"
+    seen="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r --arg now "$asked_json" '
+        def is_input:
+            .type == "user"
+            and ((.isCompactSummary // false) | not)
+            and (((.message.content // []) | if type == "array"
+                    then ([.[] | select(.type == "tool_result")] | length)
+                    else 0 end) == 0);
+
+        def words: [splits("[^\\p{L}\\p{N}]+")] | map(select(length >= 5)) | unique;
+
+        (map(is_input) | rindex(true)) as $i
+        | if $i == null then "нет" else
+            (.[$i] | (.message.content // []) | if type == "array"
+                then ([.[] | select(.type == "text") | .text] | join(" "))
+                else (. // "") end) as $said
+            | ([.[:$i][] | select(.type == "assistant") | (.message.content // [])[]
+                 | select(.type == "tool_use") | select(.name == "AskUserQuestion")] | length) as $before
+            | if $before == 0 or ($said | length) == 0 then "нет" else
+                (($now | words) - (($now | words) - ($said | words))) as $common
+                | if ($common | length) >= 3 then "было" else "нет" end
+              end
+          end
+    ' 2>/dev/null)"
+
+    if [ "$seen" = "было" ]; then
+        reason="BLOCKED by grill-gate: на этот вопрос владелец уже отвечал в этом разговоре — продолжай работу, а не переспрашивай.
+
+Указание владельца действует до его отмены. Новый факт против действующего указания — это строка в ответе о цене, а не новый вопрос: переспрашивают только то, чего указание не покрывает. Промах здесь не в форме вопроса, а в остановке работы, которая уже разрешена.
+
+Вопрос всё-таки о другом предмете — назови в нём то, чего в прежнем ответе владельца нет: признак судит общие слова вопроса и последней реплики владельца, а не смысл."
+
+        # Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть.
+        # shellcheck disable=SC1090
+        [ -f "$rt_hooks_dir/deny-tail.sh" ] && . "$rt_hooks_dir/deny-tail.sh" 2>/dev/null
+        command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { :; }
+        deny_tail_text="$(rt_deny_tail "")"
+        [ -n "$deny_tail_text" ] && reason="${reason}
+
+${deny_tail_text}"
+
+        jq -n --arg r "$reason" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
+            || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"grill-gate: на этот вопрос уже отвечали."}}\n'
+        exit 0
+    fi
+fi
+
 [ "$verdict" = "ask" ] || exit 0
 
 if [ -n "$tool" ]; then

package/assets/hooks/hook-input.sh

@@ -95,6 +95,7 @@ rt_turn_has_text() {
         got="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r '
             def is_input:
                 .type == "user"
+                and ((.isCompactSummary // false) | not)
                 and (((.message.content // []) | if type == "array"
                         then ([.[] | select(.type == "tool_result")] | length)
                         else 0 end) == 0);

package/assets/hooks/postmortem-guard.sh

@@ -69,6 +69,7 @@ admitted_re='был неправ|был не прав|ошибс|моя ошиб
 verdict="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r --arg re "$admitted_re" '
     def is_input:
         .type == "user"
+        and ((.isCompactSummary // false) | not)
         and (((.message.content // []) | if type == "array"
                 then ([.[] | select(.type == "tool_result")] | length)
                 else 0 end) == 0);

package/assets/hooks/proposal-guard.sh

@@ -63,10 +63,18 @@ context_re='пропозал|слою правил|слоя правил|сло
 # Ход — это всё, что записано после последнего настоящего ввода владельца. Ответ инструмента
 # приходит той же ролью, поэтому строки с `tool_result` вводом не считаются.
 #
+# Сводка сжатия — тоже не ввод, хотя приходит ролью владельца и ответом инструмента не является.
+# Она пересказывает ходы, которые уже кончились, и просьба, исполненная вчера, читается в ней как
+# сказанная сейчас: ход, где о предложениях не было сказано ни слова, отбивался на пересказе
+# чужой просьбы — каталог предложений при этом был пуст, и отправлять было нечего вовсе. По
+# словам сводка от речи владельца неотличима и богаче её, потому что пересказывает всю сессию
+# разом; узнаётся она признаком записи, а не текстом.
+#
 # Хвост в 400 строк: запись хода растёт всю сессию, а судится только последний ход.
 verdict="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r --arg asked "$asked_re" --arg ctx "$context_re" '
     def is_input:
         .type == "user"
+        and ((.isCompactSummary // false) | not)
         and (((.message.content // []) | if type == "array"
                 then ([.[] | select(.type == "tool_result")] | length)
                 else 0 end) == 0);

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

@@ -197,6 +197,7 @@ started_re='task:new|task:move|board\.mjs[[:space:]]+move|git[[:space:]]+checkou
 verdict="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r --arg work "$work_re" --arg read "$read_re" --arg part "$part_re" --arg wait "$wait_re" --arg handover "$handover_re" --arg started "$started_re" '
     def is_input:
         .type == "user"
+        and ((.isCompactSummary // false) | not)
         and (((.message.content // []) | if type == "array"
                 then ([.[] | select(.type == "tool_result")] | length)
                 else 0 end) == 0);

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

@@ -102,6 +102,7 @@ verdict="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r \
     --arg read "$read_re" --arg red "$red_re" --arg ready "$ready_re" --arg vow "$vow_re" '
     def is_input:
         .type == "user"
+        and ((.isCompactSummary // false) | not)
         and (((.message.content // []) | if type == "array"
                 then ([.[] | select(.type == "tool_result")] | length)
                 else 0 end) == 0);

package/assets/hooks/work-start-guard.sh

@@ -69,6 +69,7 @@ rt_needs rt_is_app_code work-start-guard || exit 0
 asked="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r '
     def is_input:
         .type == "user"
+        and ((.isCompactSummary // false) | not)
         and (((.message.content // []) | if type == "array"
                 then ([.[] | select(.type == "tool_result")] | length)
                 else 0 end) == 0);
@@ -91,6 +92,7 @@ asked="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r '
 edited="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r '
     def is_input:
         .type == "user"
+        and ((.isCompactSummary // false) | not)
         and (((.message.content // []) | if type == "array"
                 then ([.[] | select(.type == "tool_result")] | length)
                 else 0 end) == 0);

package/assets/laws/autonomous-work.md

@@ -0,0 +1,30 @@
+# Закон об автономном заходе
+
+Заход, в котором владельца нет рядом. Он не отвечает на вопросы, не нажимает кнопок и не видит
+работы до утра: всё, что исполнитель сделал за ночь, читается им разом и уже случившимся.
+
+## Статьи
+
+- **Автономный заход объявляет владелец, и кончается он его словом либо названной границей.**
+  Сам себя заход не продлевает: работа без конца — это работа, о которой владелец не просил.
+- **Развилка закрывается умолчанием, а не ожиданием.** Вопрос, который некому задать, не
+  останавливает работу: исполнитель берёт умолчание, записывает его вместе с ценой ошибки и идёт
+  дальше. Стоящий заход не отвечает ни на один вопрос и стоит ровно столько же, сколько
+  отвеченный неверно.
+- **Задача, упирающаяся в слово владельца, откладывается целиком.** Наполовину сделанная
+  выглядит сделанной: следующий заход читает её как закрытую и не возвращается к ней.
+- **Действие, которое видно снаружи, в автономном заходе не делается.** Отправка чужой стороне,
+  публикация, слияние, письмо: их последствия отменяет человек, а его нет. Отмена стоит дороже
+  ожидания.
+- **Работа, которую нечем подтвердить, не берётся.** Признак готовности автономного захода —
+  команда с известным выводом, а не взгляд исполнителя: подтвердить его некому.
+- **Каждый шаг кончается следом на диске.** Заход обрывается без предупреждения — по окну, по
+  отказу, по сети, — и всё, что не записано, исчезает вместе с ним.
+- **Работы идут чередой, а не веером из одного основания.** Каждая следующая ветвится от
+  предыдущей: расхождение тогда всплывает у того, у кого обе правки под рукой, а не у владельца,
+  у которого нет ни одной.
+- **Заход кончается списком, а не итогом.** Владелец читает ночь целиком: по каждой работе видно,
+  что сделано, где лежит, чем подтверждено и чего она ждёт. Итог «сделано много» не говорит ни о
+  чём из четырёх.
+- **Отказ стража автономный заход не кончает.** Он называет пропущенный шаг, и шаг делается;
+  заход, вставший на отказе до утра, теряет ночь целиком.

package/assets/laws/frontend-application.md

@@ -26,6 +26,16 @@
   рабочим и молча ничего не делает.
 - **Набор записей приходит с сервера страницей, а не целиком.** Список, растущий вместе с
   данными, однажды перестаёт открываться, и заметно это становится уже у пользователя.
+- **У значения, положенного приложением в браузер, есть род: устройство либо вошедший.**
+  Хранилище браузера переживает и перезагрузку, и выход, и смену того, кто вошёл; род решает,
+  снимается ли значение при выходе. По имени ключа он не виден: язык интерфейса принадлежит
+  устройству, выбранная рабочая область — вошедшему, и по именам они неразличимы. Умолчания у
+  рода нет тоже: оставленное значение сеанса отдаёт следующему вошедшему чужой выбор, а снятая
+  настройка устройства заставляет выбирать язык при каждом входе. Значит род называет человек, и
+  называет до того, как ключ заведён.
+- **Значения сеанса снимает то же место, которое снимает вход.** Уход по истёкшему входу идёт
+  мимо кнопки выхода, и ключ, снятый своим экраном, остаётся лежать — то есть достаётся
+  следующему вошедшему на этом устройстве.
 - **Окружение, которого нет на сервере, приходит экрану извне, а не берётся у среды.**
   Взятое напрямую, оно компилируется и падает при отдаче страницы сервером — то есть у гостя,
   а не у того, кто это написал. Места, где иначе нельзя, названы поимённо.

package/assets/laws/project-documentation.md

@@ -43,6 +43,14 @@
 - **Число в тексте пересчитывается тем же изменением, которым пишется, и за этим тоже следит
   автор.** Устаревшее число выглядит так же, как свежее, а машине их не различить: дата, версия и
   номер — такие же числа, и проверка, которая знает один способ записи, на другом ошибается молча.
+- **Слово, значащее в дереве что-то определённое, записано в словаре дерева.** Слова, которого
+  там нет, у читателя нет тоже: оно вводится в словарь тем же изменением, которым впервые
+  употреблено, либо заменяется тем, что уже есть. Словарь читается до того, как текст написан, а
+  не сверяется после: сверка после находит слово, вокруг которого уже построен абзац.
+- **Документ, собираемый из нескольких источников, правится в источнике.** Правка собранного вида
+  живёт до следующей сборки и пропадает молча — а выглядит она ровно так же, как правка, которая
+  осталась. Собранный документ обязан называть свой источник в себе самом: сказанное о нём где-то
+  ещё до читателя может не доехать, а собранный вид доезжает всегда.
 - **Отказ от слова распространяется на всё, что уже прочитано снаружи, а не только на файлы.**
   Название работы, её описание и запись о правке живут вне дерева: поиск по файлам их не видит,
   проверки текстов на них не смотрят, и отказ выглядит сделанным ровно до того, как читатель

package/assets/laws/work-conduct.md

@@ -55,6 +55,9 @@
   просьбы, даже когда свой даёт тот же ответ: равноценность инструментов решает тот, кто просит.
   Одинаковый результат равноценностью не является — у названного инструмента бывает видно то,
   чего у заменителя нет вовсе.
+- **Случившаяся подмена называется в том же докладе.** Чем сделано вместо названного и почему —
+  двумя словами, рядом с ответом на просьбу. Без этой строки владелец узнаёт о подмене, повторяя
+  указание: к той минуте работа по нему уже сделана не тем, и заплачено за неё дважды.
 - **Понимание записано там, где идёт работа.** Оставленное в переписке живёт у одного участника и
   до следующего дня; работу продолжает тот, у кого этой переписки нет.
 - **Сказанное владельцем записывается его словами и задним числом не переписывается.** Пересказ

package/assets/patterns/autonomous-work-run.md

@@ -0,0 +1,105 @@
+---
+name: autonomous-work-run
+kind: pattern
+rule: autonomous-work
+description: Паттерн правила autonomous-work. Брать, когда владелец ушёл и работа идёт ночь напролёт — готовый цикл одной работы, ветвление чередой, запись умолчания вместо вопроса, список к утру, разбор отказа стража. Не брать для обычного хода работы — это паттерны task-flow-start и task-flow-resume.
+---
+
+# Ночь без владельца
+
+Паттерн правила `autonomous-work`. Что при этом должно быть верно — закон
+`docs/constitution/autonomous-work.md`.
+
+## Когда брать
+
+- Владелец сказал, что уходит, и просил работать самостоятельно.
+- За заход берётся больше одной задачи подряд, и отдать их наружу нельзя.
+- Работа упёрлась в вопрос, а спросить некого.
+
+## Череда веток
+
+Первая работа ветвится от главной, каждая следующая — от предыдущей:
+
+```bash
+git checkout -b <КЛЮЧ>-<номер-1>-<slug> main           # первая за ночь
+git checkout -b <КЛЮЧ>-<номер-2>-<slug> <КЛЮЧ>-<номер-1>-<slug>
+git checkout -b <КЛЮЧ>-<номер-3>-<slug> <КЛЮЧ>-<номер-2>-<slug>
+```
+
+Порядок вливания — снизу вверх, и он называется в списке к утру номерами. Ветка, заведённая от
+главной посреди череды, столкнётся с соседкой в общих файлах — указателях, счётчиках, журналах —
+и разбирать это будет владелец.
+
+```bash
+git log --oneline --graph --decorate main..HEAD | head -20   # чем стоит череда сейчас
+git branch --list '<КЛЮЧ>-*' --format='%(refname:short) %(upstream:short)'
+```
+
+## Цикл одной работы
+
+```bash
+npm run task:move -- <номер> in-progress                 # взята
+git checkout -b <КЛЮЧ>-<номер>-<slug> <прошлая ветка>    # череда, а не веер
+cp -r docs/tasks/_template docs/tasks/<КЛЮЧ>-<номер>-<slug>
+# разбор просьбы с умолчаниями, замысел, состояние «этап-идёт»
+git add docs/tasks/<КЛЮЧ>-<номер>-<slug> && git commit    # папка едет в историю сразу
+# работа этапами: каждый кончается коммитом и прогоном признака готовности
+# папка разбирается в описание прошлого последним коммитом
+```
+
+Наружу за ночь не уходит ничего: ни `git push`, ни `gh pr create`, ни публикация, ни отметка
+груза. Ветка остаётся местной, и утром владелец сам решает, что из неё отдавать.
+
+## Умолчание вместо вопроса
+
+Пишется в разбор просьбы, в раздел решений, — там же, где записался бы ответ владельца:
+
+```markdown
+- **<что принято>** — <довод>. Спросить было некого: заход автономный. Цена ошибки:
+  <что придётся переделать, если владелец решит иначе>.
+```
+
+Цена ошибки — не вежливость, а признак: она отделяет умолчание, которое можно переиграть за
+десять минут, от того, ради которого работу лучше отложить целиком.
+
+## Отложенная задача
+
+Задача, которой нужно слово владельца, не берётся: состояние на борде остаётся прежним, а в
+список к утру идёт строка.
+
+```markdown
+- **RT-<номер> — <заголовок>.** Отложена: <какой вопрос и почему умолчания у него нет>.
+```
+
+## Список к утру
+
+Дописывается по ходу, после каждой закрытой работы, а не собирается в конце.
+
+```markdown
+| Работа | Ветка | Чем подтверждена | Чего ждёт |
+| ------ | ----- | ---------------- | --------- |
+| RT-… — <что сделано> | `<ветка>` (на `<предыдущей>`) | `<команда>` — <вывод> | заявки и слияния |
+```
+
+Порядок строк — порядок вливания. Ниже списка — отложенные задачи с их вопросами.
+
+## Отказ стража
+
+Отказ называет пропущенный шаг: шаг делается, вызов повторяется, работа идёт дальше. Ночь
+кончается работой, а не спором со стражем.
+
+- Отказ требует того, что делать нельзя (пуш, заявка), — работа доводится до места, где
+  требование исполнимо утром, и уходит в список к утру строкой «ждёт заявки».
+- Отказ повторяется на том же месте дважды — значит пропущенный шаг понят неверно: читается
+  правило, названное в отказе, а не переписывается формулировка.
+
+## Частые промахи
+
+- **Ветка заведена от главной по привычке.** Череда рвётся молча, и цена всплывает у владельца
+  на втором вливании.
+- **Умолчание принято и не записано.** Утром оно неотличимо от знания, и владелец узнаёт о нём,
+  только когда работа сделана не так.
+- **Задача взята и отложена наполовину.** На борде она в работе, в ветке — половина правки;
+  следующий заход читает её как начатую и не начинает заново.
+- **Список к утру собран по памяти в последнюю минуту.** К этому часу окно уже сжималось, и
+  половина ночи в него не попала.

package/assets/patterns/browser-verification-stand.md

@@ -169,7 +169,7 @@ done
 
 - **Одиночная сборка проекта серверы переживают, и отказываться от неё незачем.** Замерено
   ответом до и после: все порты остались за своими процессами. Осторожность здесь стоит дороже
-  проверки — целая команда паттерна `seo-verify` осталась незапущенной ровно потому, что сборку
+  проверки — целый набор проверок разметки остался незапущенным ровно потому, что сборку
   сочли опасной, не замерив. Сборка из кэша замером не является: она не собирает вовсе, и видно
   это по её длительности.
 - Свой дев-сервер не поднимать: сайт на {{sitePort}}, админка на {{adminPort}}, API на {{apiPort}} уже подняты

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

@@ -104,6 +104,22 @@ description: Паттерн правила doc-style. Брать при напи
 его вместе со смыслом. Считается это грепом по тексту, и число само по себе отказом не бывает:
 судит его тот, кто правит следующим.
 
+## Новое слово в словаре
+
+Слово, значащее в дереве что-то определённое, живёт в словаре. Порядок — четыре шага, и первый
+из них не пропускается: словарь читается до того, как текст написан, а не сверяется после.
+
+1. **Поиск по собранному словарю целиком**, включая раздел отвергнутых слов. Слово, от которого
+   дерево отказалось, стоит там же — и вводить его заново значит отменять чужое решение молча.
+2. **Выбор своего раздела.** Раздел надстройки замещает одноимённый раздел набора целиком:
+   название берётся такое, какого в наборе нет.
+3. **Строка парой — слово и что это.** Без второй половины слово не введено: оно названо.
+4. **Раскладка тем же изменением**, и сверка при этом зелёная. Слово, введённое в надстройку и не
+   разложенное, у читателя ещё не появилось.
+
+Слово, от которого дерево отказывается, заводится там же и с заменой в той же строке: отказ без
+замены исполнить нечем — пишущий видит запрет и не видит, чем его закрыть.
+
 ## Факт проверяется, а не вспоминается
 
 Перед тем как написать, что код делает X, — открыть код и посмотреть. Пересказ по памяти

package/assets/patterns/git-workflow-pr-ready.md

@@ -0,0 +1,93 @@
+---
+name: git-workflow-pr-ready
+kind: pattern
+rule: git-workflow
+description: Паттерн правила git-workflow. Брать, когда заявки уже открыты: снятие черновика, разбор красного прогона, доведение череды до готовности, порядок «сначала довести отданное, потом брать новое». Открытие одной заявки — паттерн git-workflow-pr, порядок череды — git-workflow-stack.
+---
+
+# Доведение заявки до готовности
+
+Паттерн правила `git-workflow`. Что при этом должно быть верно — закон
+`docs/constitution/delivery.md`. Открытие заявки — паттерн `git-workflow-pr`, порядок череды —
+`git-workflow-stack`, разбор одного конфликта — `git-workflow-merge`.
+
+## Когда брать
+
+- Заявка открыта черновиком, и прогон по ней кончился.
+- Открыто несколько заявок разом, и надо решить, что делать раньше — доводить их или брать
+  следующую задачу.
+- Прогон заявки красный, а правка в ветке зелёная у себя.
+
+## Черновик — состояние работы, а не её вид
+
+Черновик говорит одно: работу нельзя вливать. Кнопка слияния у него заблокирована хостингом, и
+владелец, открывший список, видит не «сделано», а «делается». Заявка с зелёным прогоном и
+неснятым черновиком — сделанная работа, выглядящая незаконченной, и поправить это может только
+тот, кто её отдал.
+
+Отсюда порядок: **черновик снимается тем же ходом, которым прочитан зелёный прогон.** Не
+следующим, не после соседней задачи.
+
+```bash
+gh pr ready <номер>
+```
+
+Снятие черновика — последний шаг отдачи работы, а не отдельное дело. Пока он не сделан, работа
+не отдана, сколько бы коммитов ни лежало в ветке.
+
+## Сначала довести отданное, потом брать новое
+
+Открытая заявка — работа в полёте: её прогон стареет, её ветка отстаёт от главной, её тело
+описывает дерево на день написания. Всё это чинится дёшево сегодня и дорого через три задачи.
+
+Очередь поэтому такая:
+
+1. Прогоны открытых заявок прочитаны, черновики с зелёных сняты.
+2. Красные разобраны и починены.
+3. И только потом берётся следующая задача.
+
+Взять новую задачу, оставив позади десяток заявок черновиками, — значит отчитаться о работе,
+которой у владельца нет: он видит список «делается», а не список «готово».
+
+## Состояние читается разом
+
+Чем оно читается и как разбирается каждое поле — паттерн `git-workflow-freshness`; здесь
+только то, что делают с прочитанным. Пустой прогон разбирается наравне с красным: у заявки
+череды база не главная ветка, и фильтр по базе такое событие до конвейера не пропускает.
+
+## Красный прогон разбирается по шагу, а не по заявке
+
+```bash
+gh pr checks <номер>
+```
+
+Ответ называет упавший прогон и ссылку на него. Дальше у хостинга спрашивается имя упавшего
+шага — `gh api` по этому прогону, отбором `select(.conclusion=="failure")` по его шагам.
+
+Имя шага и есть диагноз. Правка идёт в ту ветку череды, где причина возникла, а не в ту, где
+прогон покраснел: у череды красным становится всё, что стоит выше причины.
+
+## Правка причины — в нижнюю ветку, оттуда волной вверх
+
+Причина, общая для всей череды, чинится один раз в самой нижней ветке. Наверх она едет
+вливанием, а не перебазированием: перебазирование переписывает историю уже отданных веток, и
+хостинг закрывает заявки верхних как слитые, хотя в главной их правок нет.
+
+Волна идёт снизу вверх, по одной ветке, и каждый шаг — три отдельных вызова: переключение на
+следующую ветку череды, вливание предыдущей в неё, отправка. Одной строкой их не пишут: гард
+поставки такую команду отбивает, и правильно — набор проверок гоняется по тому дереву, какое
+лежит на момент разбора команды, то есть по прежней ветке.
+
+Пропущенная посередине ветка оставляет свою заявку красной и ломает порядок вливания, поэтому
+волна проходит череду целиком.
+
+## Частые промахи
+
+- Черновик не снят, потому что «ещё гоняется прогон». Прогон кончился час назад; читается его
+  состояние, а не память о том, что он шёл.
+- Взята следующая задача, а десяток заявок остался черновиками. Для владельца сделанного нет.
+- Красное чинится в той ветке, где покраснело. У череды это верхняя, а причина — в нижней, и
+  починка сверху оставляет красным всё под собой.
+- Причина разослана по веткам перебазированием. Отданные ветки переписаны, заявки закрыты как
+  слитые, правок в главной нет.
+- Пустой прогон принят за зелёный. Событие до конвейера не дошло, и заявка не проверена вовсе.

package/assets/patterns/git-workflow-pr.azure.md

@@ -180,7 +180,7 @@ npm run task:move -- 86 in-review
 8. **Правка вёрстки подтверждена замером**, а не взглядом, и снята при узком экране — паттерн
    `browser-verification-measure`.
 9. **Правка разметки публичного сайта проверена на прод-сборке по всем локалям перевода** —
-   паттерн `seo-verify`.
+   правило видимости в поиске того дерева, где оно есть.
 10. **PR привязан к рабочему элементу**, ревьювер и исполнитель стоят, а тело собрано по
     образцу — разделы «Что сделано», «Чем подтверждено» и «Оставшийся шаг». Раздел оставшегося
     шага к этому моменту говорит, что шагов не осталось: черновик снимается после разбора

package/assets/patterns/git-workflow-pr.github.md

@@ -242,7 +242,7 @@ npm run task:move -- 86 in-review
 8. **Правка вёрстки подтверждена замером**, а не взглядом, и снята при узком экране — паттерн
    `browser-verification-measure`.
 9. **Правка разметки публичного сайта проверена на прод-сборке по всем локалям перевода** — паттерн
-   `seo-verify`.
+   правило видимости в поиске того дерева, где оно есть.
 10. **Тело PR собрано по образцу** — начинается строкой `Closes #<номер>`, несёт разделы «Что
     сделано», «Чем подтверждено» и «Оставшийся шаг», а метки, ревьювер и исполнитель стоят.
     Раздел оставшегося шага к этому моменту говорит, что шагов не осталось: черновик снимается

package/assets/patterns/git-workflow-pr.gitlab.md

@@ -194,7 +194,7 @@ npm run task:move -- 86 in-review
 8. **Правка вёрстки подтверждена замером**, а не взглядом, и снята при узком экране — паттерн
    `browser-verification-measure`.
 9. **Правка разметки публичного сайта проверена на прод-сборке по всем локалям перевода** —
-   паттерн `seo-verify`.
+   правило видимости в поиске того дерева, где оно есть.
 10. **Описание MR собрано по образцу** — начинается строкой `Closes #<номер>`, несёт разделы
     «Что сделано», «Чем подтверждено» и «Оставшийся шаг», а метки, ревьювер и исполнитель
     стоят. Раздел оставшегося шага к этому моменту говорит, что шагов не осталось: черновик