@rt-tools/agent-kit 0.23.0 → 0.24.0

package/assets/rules/testing.md

@@ -120,6 +120,14 @@ flowchart TD
   каталог, любая своя ошибка — гард выходит нулём и пропускает: сломанная проверка не имеет права
   заклинить работу. Объявляется это строкой `FAIL-OPEN` в шапке самого гарда, рядом с
   перечислением случаев, и туда же дописывается новый случай, когда он находится.
+- **Гард, не узнавший вызов, молчит так же, как исправный.** Нулевой выход бывает двух родов: гард
+  сломался и отпустил намеренно — это объявлено в его шапке, — либо он не признал в команде своего
+  дела и до проверки не дошёл вовсе. Снаружи они неотличимы, а второй не объявлен нигде и не
+  оставляет следа. Отсюда два следствия. Признак вызова обязан ошибаться в сторону лишнего
+  срабатывания: сработавший на лишнем виден сразу и правится, не узнавший — не виден никогда. И
+  принятый в дереве способ звать команду — полным путём, через обёртку, с подстановкой переменных —
+  входит в признак наравне с голым именем: обход, которым команду зовут каждый день, ровно там гард
+  и слепнет.
 - **Список известного у проверки именной и объясняет себя сам.** Первым полем перечня стоит имя
   проверки и слово о том, что перечисленное отказом не считается. Дальше либо два ключа — принятое
   остаётся навсегда, долг накоплен к заведению проверки и только сокращается, — либо столько
@@ -186,6 +194,19 @@ flowchart TD
   по-прежнему, и плывущее значение внутри него двигает соседей мимо маски. Там, где размер узла
   считается по содержимому — ячейка таблицы, надпись, растягивающая кнопку, — плывущее лечится в
   данных стенда постоянным значением, и тогда маска не нужна вовсе.
+- **Постоянным делается не только время, но и всё, что приложение из него вывело.** Приложение
+  считает от своих часов и производное — ключ месяца, срок, признак свежести, — и считает его в
+  минуту записи. Правка времён, идущая после записи, производного не двигает: оно посчитано раньше
+  и лежит в соседней колонке. Расхождения при этом не наступает месяцами, а потом набор краснеет в
+  день, когда в дерево не внесли ни строки. Признак у промаха свой и виден сравнением двух колонок:
+  производное перестало сходиться с тем, из чего его обязаны были вывести.
+- **Засев проверяет себя сам, а не полагается на кадр.** Кадр говорит «стало другим» и молчит о
+  том, почему; отказ засева называет причину словами и приходит до того, как снят хоть один кадр.
+  Признак берётся верный в любой день прогона: данные стенда — прошлое, поэтому значение времени,
+  попавшее на день прогона или позже, посчитано часами машины, а засевом не закреплено. Нарочно
+  будущее отделяется границей и называется отдельно. Судятся при этом временные колонки всех
+  таблиц, которые читают экраны, а не только показанные сегодня: столбец выводят на экран одной
+  строкой разметки, и вспомнить при этом про засев некому.
 
 ## Чего из закона здесь нет
 

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,46 +177,51 @@ 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`. До приглашения отправка отказывает по устройству, а не по недонастройке.
 
 **Признак дерева считает отправитель, а не человек.** Он выводится из адреса репозитория, и
-запись в приёме заводится именно им: дерево, заведённое своим словом, приёмник не узнаёт и
-отвечает отказом на каждой отправке. Что уедет и под каким признаком, печатает прогон вхолостую —
-единственный способ узнать признак до заведения записи.
+запись в приёме заводится именно им: дерево, заведённое своим словом, приёмник не узнаёт. Что
+уедет и под каким признаком, печатает прогон вхолостую.
 
-**Отметка об отправке — след для человека, а не хранилище состояния: она говорит, что запись в
-приёме есть, а не что её положил этот вызов.** Чистое дерево после отправки значит, что весь
-груз в приёме уже лежал, а не что отправка не сработала.
+**Отметка об отправке — след для человека, а не хранилище состояния.** Чистое дерево после
+отправки значит, что весь груз в приёме уже лежал, а не что отправка не сработала.
 
 Разбирают их там, где лежат правимые ресурсы и видно всех потребителей сразу, — а сюда
 приезжает ответ приёма о том, сколько записей легло.
 
 **Имя файла предложения в текстах дерева не называется.** Читателю чужого дерева оно не даёт
-ничего, а там, где каталог остаётся на машине автора, ссылка ведёт в пустоту и проверка путей
-краснеет. Текст репозитория говорит, кому предложение отправлено и о чём оно; ресурс пакета
-при этом называть можно — он в истории есть.
+ничего, а ссылка на каталог с машины автора ведёт в пустоту и красит проверку путей. Текст
+репозитория говорит, кому предложение отправлено и о чём оно; ресурс пакета называть можно.
 
 Предложение работу не выправляет. Оно лежит текстом, читается глазами и в контекст сам собой не
-приходит; цитата не становится правилом от того, что её произнесли. Закрытым предложение
-считается, только войдя в ресурс пакета: до этого на него не ссылаются как на действующее
-требование и не считают дырку закрытой.
+приходит. Закрытым оно считается, только войдя в ресурс пакета: до этого на него не ссылаются как
+на действующее требование и не считают дырку закрытой.
 
 **Слово владельца о предложении — «отправь», «заведи», «напиши пропозал» и любая другая форма
-того же — исполняется отправкой в тот же ход.** Сухой прогон отправкой не является: он
-показывает, что уехало бы, ничего не заводит и следа наружу не оставляет. Отметки, которыми
-отправка пачкает дерево, ложатся вторым коммитом в ту же ветку — это их место, а не повод
-отложить. Стережёт это гард предложения на завершении хода.
+того же — исполняется отправкой в тот же ход.** Сухой прогон отправкой не считается: он
+показывает, что было бы отправлено, и следа наружу не оставляет. Отметки, которые отправка
+оставляет в дереве, ложатся вторым коммитом в ту же ветку. Это проверяет гард предложения на
+завершении хода.
 
 ## Установка туда, где уже всё своё
 
@@ -276,23 +273,16 @@ 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;AAuB7C,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,CAkF3D;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,7 @@ 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';
@@ -186,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);
 /**
  * Строка про компаньон, которому нечего сказать.
@@ -387,6 +407,7 @@ const strayLines = (result) => result.strayOverrides.length
  * всплывали бы только там, где и без них уже красно.
  */
 const warnings = (result) => [
+    ...holeWarningLines(result),
     ...brokenLines(result),
     ...idleLines(result),
     ...namedCutLines(result),
@@ -396,7 +417,6 @@ const warnings = (result) => [
     ...strayLines(result),
 ];
 const describe = (result) => [
-    ...holes(result),
     ...gapLines(result),
     ...unboundLines(result),
     ...driftedLines(result),
@@ -570,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) {
     {
@@ -587,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)] };
         }
@@ -646,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),
         ],
@@ -787,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 [
@@ -834,6 +894,7 @@ function statsLines(summary, swept, days, version, laidOut) {
                 ...countLines(summary.guards),
             ]
             : []),
+        ...pushGateOutcomeLines(summary),
         ...(summary.silentGuards.length
             ? [
                 '',