@rt-tools/agent-kit 0.22.0 → 0.24.0

package/assets/skills/agent-kit.md

@@ -53,24 +53,21 @@ description: Переносимый слой правил агента — за
 **Подъём версии пакета и раскладка едут одним изменением.** Сверка раскладки стоит в гейте
 пуша: редакция, поднятая без раскладки, красит главную ветку и запирает дерево целиком.
 
-**Объявление хука раскладка кладёт вместе с самим хуком.** Гард зовёт не файл, а запись в
-настройке агента, и разложенный без неё он снаружи неотличим от работающего: файл лежит,
-коммитится, сверка зелёная — а вызова, ради которого написано его тело, он не видит. Раскладка
-дописывает в настройку запись на каждое событие, которого там нет, и говорит, что дописала.
-Правка только прибавляет: ни одна стоящая запись не переписывается и не снимается, снятое
-деревом не возвращается, а настройку, которую не разобрать как JSON, пакет не трогает вовсе —
-там печатается готовый кусок и запись идёт рукой, как прежде.
+**Объявление хука раскладка кладёт вместе с самим хуком.** Хук вызывается по записи в настройке
+агента, и разложенный без неё снаружи неотличим от работающего. Раскладка дописывает запись на
+каждое событие, которого в настройке нет, и сообщает об этом. Правка только добавляет: записи не
+переписываются и не снимаются, снятое деревом не возвращается, а настройку, которую не разобрать
+как JSON, пакет не трогает — печатает готовый кусок для записи рукой.
 
 **Держит это гард места правки, а не память.** Правку файла с шапкой раскладки он отбивает в
 минуту правки и называет адрес: источник, если дерево его держит, иначе надстройку. Правит копию
-не только рука: форматтер дерева, дошедший до разложенного файла, переписывает его по-своему, и
-раскладка читает это ровно как правку руками. Снятие копии гард пропускает: снятый файл
-раскладка кладёт заново, и так эту поломку и чинят.
+не только рука: форматтер дерева переписывает разложенный файл по-своему, и раскладка читает это
+ровно как правку руками. Снятие копии гард пропускает — снятый файл раскладка кладёт заново.
 
 **Надстройка правится по разделу, а не кладётся целиком.** Разделы в неё дописывают разные ветки
-и разные заходы, и положенная целиком она уносит все, которых эта правка не касалась: на их
-место молча возвращается пакетный текст. Держит это второй гард — он отбивает запись поверх непустой надстройки и называет
-размер того, что затрут: строки и число разделов. Дописывание в конец и правка по месту проходят.
+и разные заходы, и положенная целиком она уносит все, которых эта правка не касалась. Держит это
+второй гард — он отбивает запись поверх непустой надстройки и называет размер того, что затрут.
+Дописывание в конец и правка по месту проходят.
 
 ## Команды
 
@@ -85,8 +82,7 @@ npx agent-kit adopt [файлы] # отдать пакету свой файл,
 ```
 
 Отдача откладывает прежнее содержимое рядом, с пометкой `.before-rt-kit`, и освобождает путь под
-раскладку; без имён отдаются все чужие файлы разом. Названа она здесь потому, что иначе её
-находят по тексту отказа раскладки — то есть в ту минуту, когда работа уже встала.
+раскладку; без имён отдаются все чужие файлы разом.
 
 Часть команд слоя исполняет агент, а не программа: `/feedback` кладёт слово о правилах блоком в
 файл предложений, `/skill-curator` разбирает закрытую задачу, `/next-session` закрывает заход.
@@ -108,11 +104,10 @@ npx agent-kit adopt [файлы] # отдать пакету свой файл,
     cp -r node_modules/@rt-tools/agent-kit/assets /tmp/agent-kit-assets-<прежняя версия>
     ```
 
-2. **Установка и раскладка.** Обычным порядком. Раскладка кладёт ту редакцию, которая **установлена**,
-   а не ту, что объявило дерево: перепутать их легко — установленная остаётся от соседней ветки,
-   где её как раз поднимали, и ложится целиком, молча, с тем же успешным выходом. Расхождение
-   точного номера раскладка отбивает сама и называет обе редакции; починка — поставить
-   зависимости и повторить вызов.
+2. **Установка и раскладка.** Обычным порядком. Раскладка кладёт ту редакцию, которая
+   **установлена**, а не ту, что объявило дерево: установленная остаётся от соседней ветки и
+   ложится целиком, молча, с тем же успешным выходом. Расхождение точного номера раскладка
+   отбивает сама; починка — поставить зависимости и повторить вызов.
 3. **Сверка замещённых разделов по снимку.** Какие разделы замещены, называет `doctor` — строкой
    «замещено надстройками разделов» и перечнем «ресурс · заголовок». Каждый из них читается в
    снимке и в новой редакции: что пакет дописал, дописывается в надстройку руками.
@@ -123,8 +118,7 @@ npx agent-kit adopt [файлы] # отдать пакету свой файл,
 этим раздел замещён. Готовая пара команд — в холодной части рядом.
 
 Дальше решение обычное: раздел, ради которого надстройка заводилась, остаётся замещённым, а
-раздел, чья причина ушла с исправленной редакцией, снимается — о том и говорит четвёртая строка
-предложения.
+раздел, чья причина ушла с исправленной редакцией, снимается.
 
 ## Что пакет везёт, а что остаётся дереву
 
@@ -164,18 +158,16 @@ npx agent-kit adopt [файлы] # отдать пакету свой файл,
 и не загружено ни разу**: правило, которого никто не открыл, ничем себя не выдаёт.
 
 **Цена** — `agent-kit cost`. Сводка говорит, чем пользовались; цена — сколько это стоило: вес
-входа в работу, вес одного правила и вес всего слоя. Считается не файл, а то, что заход получает:
-описание приходит полем, словарь и карта хода — выводом хуков. Число сравнимо только со снятым
-той же командой.
+входа в работу, вес одного правила и вес всего слоя. Считается не файл, а то, что заход получает.
+Число сравнимо только со снятым той же командой.
 
 **Предложения** приходят двумя путями: разбор закрытой задачи — командой `/skill-curator` —
 приносит их пачкой, а слово, сказанное посреди работы, кладёт командой `/feedback` сам агент. Оба
 пишут в один файл дня и в одной форме; в сеть не ходит ни один — увозит их отправка.
 
 Каждая запись несёт четыре строки: **место** — куда правка встаёт в ресурсе, **повод** — что
-пошло не так без неё, **ближайшее** — точная цитата той строки ресурса, к которой это ближе
-всего, и чего она не покрывает, и **чем закрывается** — какие надстройки и добавки этого дерева
-снимаются, когда правка приедет редакцией пакета.
+пошло не так без неё, **ближайшее** — точная цитата строки ресурса, к которой это ближе всего, и
+**чем закрывается** — какие надстройки дерева снимаются, когда правка приедет редакцией пакета.
 
 Третья строка — единственная, которую проверяет машина: цитата ищется в ресурсе, и ненайденная
 отбивает блок. Ближайшего нет вовсе — так и пишется: «нет». Отбитый блок остаётся лежать с
@@ -185,60 +177,65 @@ npx agent-kit adopt [файлы] # отдать пакету свой файл,
 без неё она замещает уже исправленный раздел навсегда. Снимать нечего — так и пишется; пустой
 четвёртая строка не бывает.
 
-Каждому предложению ставится адрес: «пакет», «компаньон» или «дерево». Выгружаются они файлом в `.claude/rt-kit/proposals/`
-(форма — шаблон `proposal.md`), а `agent-kit propose` увозит в приём те, что адресованы
-пакету, вместе со сводкой и разборами происшествий. Адрес дерева в сводке или в тексте
-предложения отбивает отправку целиком.
+Та же связь ставится и на саму надстройку — комментарием разметки в её разделе:
+
+    <!-- rt-proposed: rules/task-flow.md · «статья целиком, как в предложении» · 2026-09-03 -->
+
+Записи предложений в день обновления никто не открывает: на них ничто не указывает. Пометка не
+видна в собранном тексте, переживает слияние по заголовкам и читается машиной: раскладка
+перечисляет разделы, чья статья в новой редакции уже есть. Снимает их человек — в раздел могли
+дописать и другое. Раздел без пометки считается постоянным.
+
+Каждому предложению ставится адрес: «пакет», «компаньон» или «дерево». Выгружаются они файлом в
+`.claude/rt-kit/proposals/` (форма — шаблон `proposal.md`), а `agent-kit propose` увозит в приём
+те, что адресованы пакету, вместе со сводкой и разборами происшествий. Адрес дерева в сводке или
+в тексте предложения отбивает отправку целиком.
 
 Приём — закрытая служба: сводка говорит о рабочих привычках команды, и в открытой очереди работ
 это выложено всему свету. Адрес приёма объявляется ключом `intake` в конфиге дерева, токен —
 ключом `token`, и лежит он вне дерева.
 
-Оба значения приходят от владельца приёма, а не придумываются потребителем: адрес он называет, а токен выдаёт
-одноразовым кодом приглашения — код заводит дерево в приёме и кладёт токен в файл ключа `token`; выданный в админке
-кладётся тем же входом и в сеть не идёт. До приглашения отправка отказывает по устройству, а не по недонастройке.
+Оба значения приходят от владельца приёма, а не придумываются потребителем: адрес он называет, а
+токен выдаёт одноразовым кодом приглашения — код заводит дерево в приёме и кладёт токен в файл
+ключа `token`. До приглашения отправка отказывает по устройству, а не по недонастройке.
 
 **Признак дерева считает отправитель, а не человек.** Он выводится из адреса репозитория, и
-запись в приёме заводится именно им: дерево, заведённое своим словом, приёмник не узнаёт и
-отвечает отказом на каждой отправке. Что уедет и под каким признаком, печатает прогон вхолостую —
-единственный способ узнать признак до заведения записи.
+запись в приёме заводится именно им: дерево, заведённое своим словом, приёмник не узнаёт. Что
+уедет и под каким признаком, печатает прогон вхолостую.
 
-**Отметка об отправке — след для человека, а не хранилище состояния: она говорит, что запись в
-приёме есть, а не что её положил этот вызов.** Чистое дерево после отправки значит, что весь
-груз в приёме уже лежал, а не что отправка не сработала.
+**Отметка об отправке — след для человека, а не хранилище состояния.** Чистое дерево после
+отправки значит, что весь груз в приёме уже лежал, а не что отправка не сработала.
 
 Разбирают их там, где лежат правимые ресурсы и видно всех потребителей сразу, — а сюда
 приезжает ответ приёма о том, сколько записей легло.
 
 **Имя файла предложения в текстах дерева не называется.** Читателю чужого дерева оно не даёт
-ничего, а там, где каталог остаётся на машине автора, ссылка ведёт в пустоту и проверка путей
-краснеет. Текст репозитория говорит, кому предложение отправлено и о чём оно; ресурс пакета
-при этом называть можно — он в истории есть.
+ничего, а ссылка на каталог с машины автора ведёт в пустоту и красит проверку путей. Текст
+репозитория говорит, кому предложение отправлено и о чём оно; ресурс пакета называть можно.
 
 Предложение работу не выправляет. Оно лежит текстом, читается глазами и в контекст сам собой не
-приходит; цитата не становится правилом от того, что её произнесли. Закрытым предложение
-считается, только войдя в ресурс пакета: до этого на него не ссылаются как на действующее
-требование и не считают дырку закрытой.
+приходит. Закрытым оно считается, только войдя в ресурс пакета: до этого на него не ссылаются как
+на действующее требование и не считают дырку закрытой.
 
 **Слово владельца о предложении — «отправь», «заведи», «напиши пропозал» и любая другая форма
-того же — исполняется отправкой в тот же ход.** Сухой прогон отправкой не является: он
-показывает, что уехало бы, ничего не заводит и следа наружу не оставляет. Отметки, которыми
-отправка пачкает дерево, ложатся вторым коммитом в ту же ветку — это их место, а не повод
-отложить. Стережёт это гард предложения на завершении хода.
+того же — исполняется отправкой в тот же ход.** Сухой прогон отправкой не считается: он
+показывает, что было бы отправлено, и следа наружу не оставляет. Отметки, которые отправка
+оставляет в дереве, ложатся вторым коммитом в ту же ветку. Это проверяет гард предложения на
+завершении хода.
 
 ## Установка туда, где уже всё своё
 
-1. `init`, затем `skip` на всё, что дерево держит само. Пустая раскладка — законное начало.
-2. Снимок того, что говорят проверки дерева, до единой правки. Он и есть мерило.
+1. `init`, затем `skip` на всё, что дерево держит само; пустая раскладка — законное начало.
+2. Снимок того, что говорят проверки дерева, до единой правки: он и есть мерило.
 3. Ресурс за ресурсом: пакетную редакцию довести до здешней, предметность вынести в
    надстройку, снять отказ, разложить, прогнать сценарии и сверить снимок.
 4. Разложенное поверх своего пакет не пишет: файл без шапки для него чужой. Отдаётся он
-   командой `adopt` — прежнее содержимое ложится рядом с пометкой `.before-rt-kit`, и снять его
-   потом решает владелец.
-5. Свои сценарии отданного файла переписываются под пакетное поведение либо снимаются. Чинить
-   пакетную редакцию на месте нельзя: правка разложенной копии живёт до следующей раскладки, а
-   её адрес — источник пакета или надстройка дерева. Сценарий, ждущий поведения снятого файла,
-   краснеет и после верной отдачи: он проверяет то, чего в дереве больше нет.
+   командой `adopt` — прежнее содержимое ложится рядом с пометкой `.before-rt-kit`.
+5. Ресурс, у которого здешняя редакция богаче пакетной по существу, в раскладку не берётся.
+   Признак — статья, которой в пакетной редакции нет и не может быть: она выводится из предмета
+   дерева. Он уходит в `skip`, а наверх едет предложение снять его из пакета.
+6. Свои сценарии отданного файла переписываются под пакетное поведение либо снимаются: чинить
+   пакетную редакцию на месте нельзя, её адрес — источник пакета или надстройка.
 
 ## Свойства дерева
 
@@ -272,27 +269,20 @@ npx agent-kit adopt [файлы] # отдать пакету свой файл,
 
 ## Ловушки раскладки
 
-- **Запись файла командой оболочки судится по всем путям, названным в её теле.** Гейт вынимает
-  пути из текста команды, а тело документа читает целиком, как только в команде встречается имя
-  интерпретатора, — и строка запуска первой строкой записываемого файла возвращает его туда сама.
-  Строка импорта разложенного модуля требует тогда правило пакетного слоя наравне с правилом
-  самого файла, а требуется за раз одно: два отказа подряд, и каждый уносит уже написанное тело.
-  Инструмент правки судится одним своим путём и переписывать тело не заставляет; перенаправление
-  оболочки остаётся для того, что файлом дерева не станет.
-- **Своё, стоящее рядом с разложенным, повторяет его механику молча.** Проверка, гард и утилита
-  дерева лежат в тех же каталогах, что и пакетные, а общий разбор списка известного, корни
-  исходников, список пропускаемых каталогов и снимок долга приезжают модулем настройки проверок.
-  Второе такое же заводится в своей проверке без единого сигнала: имена разные, форма разная, и
-  повтора не видит ни сверка раскладки — файл не разложен, — ни проверка повторов, которая ищет
-  совпадение текста. Признак один, и он читается, а не ищется: до того как в своей проверке
-  заводится разбор списка, чтение настройки или сравнение с накопленным, смотрят, что
-  экспортирует модуль настройки проверок и чем живут соседние проверки.
+- **Словарь — такой же разложенный ресурс, как правило.** Хук запуска кладёт его в контекст
+  целиком, до первой реплики, и оттого он выглядит обычным документом дерева; шапка у него есть,
+  но читается служебной строкой. Новое слово идёт в надстройку словаря, своим разделом.
+
+- **Запись файла командой оболочки проверяется по всем путям, названным в её теле.** Гейт
+  вынимает пути из текста команды и читает тело документа целиком, если в команде есть имя
+  интерпретатора; строка импорта разложенного модуля тогда требует второе правило, а требуется
+  за раз одно — два отказа подряд, и каждый теряет написанное тело. Инструмент правки
+  проверяется одним своим путём; перенаправление оболочки — для того, что файлом дерева не станет.
+- **Своё, стоящее рядом с разложенным, повторяет его механику молча.** Разбор списка известного,
+  корни исходников и снимок долга даёт модуль настройки проверок; второй такой же разбор в своей
+  проверке не видит ни сверка раскладки, ни проверка повторов. Перед тем как завести своё, смотрят,
+  что экспортирует модуль настройки проверок.
 - **Правило, загруженное инструментом, бывает показано не целиком, и обрыв ничем не помечен.**
-  Длинный файл приезжает в контекст обрезанным по строке, а снаружи это выглядит концом: показанное
-  кончается осмысленным пунктом, и число разделов с оглавлением никто не сверяет. Бьёт обрыв ровно
-  по хвосту, а хвост — то место, где дерево отменяет умолчания пакета: разделы надстройки сливаются
-  по совпавшему заголовку и новыми уходят в конец. Заход, читавший правило до конца по своему
-  ощущению, исполнил пакетный образец буквально и открыл заявку черновиком там, где дерево
-  черновиков не держит вовсе. Отсюда порядок: решение о порядке работы принимается только после
-  того, как показанные строки сверены с длиной файла — одной командой, — а расходятся они, файл
-  дочитывается чтением.
+  Длинный файл приходит в контекст обрезанным по строке, а обрыв приходится на хвост — туда, где
+  разделы надстройки дописаны в конец. Показанные строки сверяются с длиной файла одной командой;
+  расходятся — файл дочитывается чтением.

package/lib/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/commands.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAsB7C,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,2FAA2F;AAC3F,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CAC1B;AA2DD,+DAA+D;AAC/D,eAAO,MAAM,WAAW,EAAE,MAAyB,CAAC;AA0ZpD;;;;GAIG;AACH,wBAAgB,IAAI,CAChB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,SAAS,MAAM,EAAO,EAC5B,QAAQ,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,EAC/C,SAAS,GAAE,MAAW,GACvB,iBAAiB,CAgCnB;AAmKD,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG,iBAAiB,CA8DzE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,iBAAiB,CA+CpF;AAQD,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CAC1B;AA8JD;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,GAAG,iBAAiB,CA6DlF;AA0BD,wBAAgB,MAAM,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CA6E3D;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CA2DzD"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/commands.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAwB7C,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,2FAA2F;AAC3F,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CAC1B;AA2DD,+DAA+D;AAC/D,eAAO,MAAM,WAAW,EAAE,MAAyB,CAAC;AA+apD;;;;GAIG;AACH,wBAAgB,IAAI,CAChB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,SAAS,MAAM,EAAO,EAC5B,QAAQ,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,EAC/C,SAAS,GAAE,MAAW,GACvB,iBAAiB,CAgCnB;AA0LD,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG,iBAAiB,CA+DzE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,iBAAiB,CA+CpF;AAQD,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CAC1B;AAoLD;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,GAAG,iBAAiB,CA6DlF;AA0BD,wBAAgB,MAAM,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CAkF3D;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CA2DzD"}

package/lib/commands.js

@@ -14,6 +14,8 @@ import { CONFIG_PATH, DEFAULT_LAYOUT, KINDS, OVERRIDES_DIR, PROFILE_FILE, readCo
 import { hooksSection, SETTINGS_PATH } from './hooks-map.js';
 import { DEFAULT_DAYS, KEEP_DAYS, OBSERVATIONS_DIR, readObservations, summarize, } from './observations.js';
 import { isRefusal } from './plan.js';
+import { staleOverrides } from './override-marks.js';
+import { pushGateLines } from './push-gate.js';
 import { laidOutSkills, treeSnapshot } from './snapshot.js';
 import { mergedBody, pendingOf, planSync, runSync } from './sync.js';
 import { thresholdLines } from './thresholds.js';
@@ -185,6 +187,25 @@ const holes = (result) => [...result.missing].map(([asset, names]) => {
     const written = names.map(holeOf).join(', ');
     return `  ${asset}: нет значений для ${written}`;
 });
+/**
+ * Незаполненная дырка — состояние дерева, а не расхождение с пакетом.
+ *
+ * Расхождение говорит, что разложенное разошлось с редакцией; дырка без значения — что дерево
+ * ещё не описало своего: порты стенда, префикс компонентов, имя главной ветки. Один код возврата
+ * на оба состояния ставит дерево перед выбором между красным гейтом пуша и выдуманными числами в
+ * настройке, после чего подстановки теряют смысл.
+ *
+ * Раскладки это не касается: файл с дыркой на диск не кладётся, и `sync` отказывает по-прежнему —
+ * разложенное правило с `{{имя}}` посреди строки агент прочтёт как имя.
+ */
+const holeWarningLines = (result) => result.missing.size
+    ? [
+        `дерево ещё не описало своего: ресурсов с незаполненными дырками ${result.missing.size}`,
+        ...holes(result),
+        '  — это описание дерева, а не расхождение с пакетом: значения идут ключом `vars` в `.claude/rt-kit.json`',
+        '  — до них ресурс не раскладывается, и на диске его нет',
+    ]
+    : [];
 const unfilled = (result) => result.companions.filter(isUnfilled);
 /**
  * Строка про компаньон, которому нечего сказать.
@@ -386,6 +407,7 @@ const strayLines = (result) => result.strayOverrides.length
  * всплывали бы только там, где и без них уже красно.
  */
 const warnings = (result) => [
+    ...holeWarningLines(result),
     ...brokenLines(result),
     ...idleLines(result),
     ...namedCutLines(result),
@@ -395,7 +417,6 @@ const warnings = (result) => [
     ...strayLines(result),
 ];
 const describe = (result) => [
-    ...holes(result),
     ...gapLines(result),
     ...unboundLines(result),
     ...driftedLines(result),
@@ -569,6 +590,24 @@ function refusalBeforeSync(env, config) {
     }
     return null;
 }
+/**
+ * Надстройки, чья статья в новой редакции уже есть.
+ *
+ * Пометка без читателя ничего не меняет: тот, кто ставит новую версию, видит число разложенных
+ * файлов и не видит, что часть надстроек стала лишней. Раскладка их называет, снимает человек:
+ * пометка держит одну статью, а в раздел могли дописать и другое.
+ */
+function staleOverrideLines(root, assetsDir) {
+    const stale = staleOverrides(root, assetsDir);
+    if (!stale.length) {
+        return [];
+    }
+    return [
+        `надстройки, чья статья в пакете уже есть: ${stale.length}`,
+        ...stale.map((mark) => `  ${mark.file} · раздел «${mark.heading}» · отправлено ${mark.day}`),
+        '  — раздел снимается, и дерево возвращается к пакетной формулировке',
+    ];
+}
 /** Ответ `sync --check`: расхождения считаются, на диск не пишется ничего. */
 function syncCheck(config, root, version, assetsDir) {
     {
@@ -586,7 +625,10 @@ function syncCheck(config, root, version, assetsDir) {
         // Гард, подписанный не на то, что объявляет, идёт в счёт по той же причине и с большим
         // основанием: неподключённый хотя бы не притворяется — этот выглядит работающим, и ветка
         // его тела, ради которой всё писалось, не исполняется ни разу.
-        const count = result.missing.size + result.gaps.length + pending.length + empty.length + result.unbound.length + result.drifted.length;
+        // Незаполненная дырка в счёт не входит: она говорит о том, чего дерево ещё не описало о
+        // себе, а не о расхождении разложенного с редакцией. Она печатается предупреждением —
+        // и на сошедшемся дереве тоже.
+        const count = result.gaps.length + pending.length + empty.length + result.unbound.length + result.drifted.length;
         if (!count) {
             return { code: 0, lines: [`sync --check: разложенное сходится с пакетом v${version}`, ...warnings(result)] };
         }
@@ -645,6 +687,7 @@ export function sync(env, check) {
             ...boundLines(result),
             ...(result.bound?.unreadable === false ? [] : unboundLines(result)),
             ...driftedLines(result),
+            ...staleOverrideLines(root, assetsDir),
             ...debtLines(config, root, assetsDir),
             ...warnings(result),
         ],
@@ -786,6 +829,24 @@ function offFileLines(summary) {
     }
     return [`  не на правке файла: ${summary.denialsOffFile} из ${total} — ${Math.round((summary.denialsOffFile / total) * 100)}%`];
 }
+/**
+ * Исходы гейта пуша. Молчит, когда гейт не отработал ни разу за отрезок.
+ *
+ * Вынесено из сводки отдельной функцией не ради имени: та собирает строки одним выражением, и
+ * каждая новая развилка в нём растит её сложность, за которой следит линтер.
+ */
+function pushGateOutcomeLines(summary) {
+    if (!summary.pushGate.length) {
+        return [];
+    }
+    const total = summary.pushGate.reduce((found, entry) => found + entry.count, 0);
+    return [
+        '',
+        `гейт пуша прогонял набор: ${total}`,
+        ...countLines(summary.pushGate),
+        '  — green зелёный набор, red красный, no-checks проверок в дереве не нашлось',
+    ];
+}
 /** Сводка строками: загруженное, незагруженное, отбивки гейта и отказы гардов. */
 function statsLines(summary, swept, days, version, laidOut) {
     return [
@@ -833,6 +894,7 @@ function statsLines(summary, swept, days, version, laidOut) {
                 ...countLines(summary.guards),
             ]
             : []),
+        ...pushGateOutcomeLines(summary),
         ...(summary.silentGuards.length
             ? [
                 '',
@@ -968,6 +1030,11 @@ export function doctor(env) {
             return `  снят каскадом: ${one.id} — вслед за ${one.parent}${root}`;
         }),
         ...profileLines(root, assetsDir, config),
+        // Набор перед пушем — итоговый, а не пересказ умолчания: собирается он из двух файлов, и
+        // прочитать сборку было нечем. Дерево, пишущее надстройку, видит здесь умолчание и не
+        // дописывает повтор, а снятое надстройкой видно на разборе ветки, а не только тому, кто
+        // его снял.
+        ...pushGateLines(root, config.layout.defaults ?? DEFAULT_LAYOUT.defaults),
         ...localValueLines(root, assetsDir, config),
         ...replacedLines(config, assetsDir, root),
         ...thresholdLines(root),