@rt-tools/agent-kit 0.10.0 → 0.12.0

package/assets/rules/turn-conduct.md

@@ -0,0 +1,206 @@
+---
+name: turn-conduct
+kind: rule
+law: work-conduct
+description: Правило под «Закон о ведении работы» — та его часть, что про один ход. Брать, когда ход заканчивают: чем он кончается и что его концом не бывает, что говорится владельцу о чужом шаге, чем подтверждается утверждение о дереве, что делает страж выходов хода, гард ожидания, гард разговора и гард происшествия, как закрывается заход по заполнению окна. Готовый порядок — в паттерне task-flow-handoff. Ход работы от просьбы владельца до слияния — правило task-flow.
+---
+
+# Ход захода — как это устроено здесь
+
+Правило под закон `docs/constitution/work-conduct.md` — та его часть, что про один ход.
+Закон говорит, что должно быть верно; здесь — чем это стережётся в этом дереве. Ход работы
+от просьбы владельца до слияния, состояния работы и папка задачи — правило `task-flow`
+под тем же законом.
+
+## Как это называется здесь
+
+| В законе                         | Здесь                                                                                          |
+| -------------------------------- | ----------------------------------------------------------------------------------------------- |
+| ход                              | один заход агента: от реплики владельца до ответа ему                                          |
+| выход хода                       | один из четырёх способов кончить ход; чем подтверждается каждый — карта хода                   |
+| страж выходов хода               | гард на завершении хода: читает объявленное состояние работы и то, что за ход сделано в дереве |
+| утверждение о состоянии дерева   | слово ответа владельцу, за которым обязана стоять команда того же хода и её вывод              |
+| передача захода                  | запись вне дерева: она пересказывает ход работы для вставки в новый заход                      |
+| порог сжатия и порог остановки   | два числа заполнения окна; дерево задаёт их само, и первый стоит ниже второго                  |
+
+## Выходы хода
+
+Ход кончается четырьмя способами, и других нет: вопрос владельцу, ответа на который в правилах
+нет; отказ гарда; заполненное окно там, где сжатия нет; отданная работа, за которой начата
+следующая. Чем подтверждается каждый из четырёх, перечисляет карта хода — там, где дерево её
+разложило.
+
+Всё остальное — продолжение хода, а не его конец. Веха ходом не кончается: ни коммит, ни
+прочитанная договорённость, ни граница «прочитал — сейчас правлю», ни зелёная проверка.
+Переход из состояния в состояние — тем более: обязательное действие сделано, и следующее
+делается тем же ходом, а граница состояния выглядит законченным куском лучше всякой другой вехи,
+и отчёт встаёт ровно туда, где должно было стоять следующее действие.
+
+Четыре способа кончить ход выглядят работой и ею не являются: сводка о чужом шаге, меню при
+назначенном порядке, объявление намерения и названная, но не запущенная команда. Что при этом
+должно быть верно — ниже, в статьях о применении закона.
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Ход
+
+Ход одного захода: чем он кончается, что проверяется до его конца и что при этом говорится
+владельцу.
+
+```mermaid
+flowchart TD
+    A[Ход идёт] --> B{Что случилось}
+    B -->|Владельцу задан вопрос| C[За тот же ход читались законы и правила]
+    B -->|Гард отбил правку| D[Отказ назван владельцу, обход не искался]
+    B -->|Окно захода заполнено| E{Дерево объявило сжатие}
+    B -->|Работа отдана заявкой| F[По следующей задаче сделано действие, а не сказано]
+    B -->|Ничего из этого| G[Ход продолжается: веха его концом не бывает]
+    E -->|Да| G
+    E -->|Нет| H[Ход работы дописан, передача написана]
+    C --> I{Ответ владельцу говорит о дереве}
+    D --> I
+    F --> I
+    H --> I
+    I -->|Да| J[Каждое слово несёт команду того же хода и её вывод]
+    I -->|Нет| K[Ход кончен]
+    J --> K
+    G --> A
+```
+
+## Как закон применяется здесь
+
+- **Сводка о чужом шаге.** Прогон, разбор владельцем и слияние идут без исполнителя и от взгляда
+  быстрее не становятся. Ход, кончившийся такой сводкой, владелец читает как работу: она полна,
+  в ней названы номера и состояния, и пустоты за ней не видно. О чужом шаге говорят вместе с
+  начатым своим, а не вместо него. За один заход это было нарушено четырежды, и готовая работа
+  простояла в невлитом PR почти три часа.
+- **Меню при назначенном порядке.** Выбор, предложенный владельцу, пока эпик не кончился, — это
+  просьба назначить порядок заново. Работы в эпике не осталось — так и говорится: эпик
+  кончился, — а не «чем займёмся».
+- **Объявление намерения.** «Беру следующую задачу» — не то же самое, что взять её: фраза живёт
+  до конца хода, а работа не двигается. Названо может быть только сделанное: номер заведённой
+  задачи, имя заведённой ветки, переведённая колонка.
+- **Названная командой работа запускается в том же ходе, где названа.** Строка «сейчас запущу»
+  ходом не кончается: либо запуск уже был, либо ход не кончен. Названная поимённо команда
+  выглядит начатой работой лучше всякого другого обещания — она точна, её видно, и по ней не
+  отличить сделанного от собранного. Ответ владельцу пишется после вызова, а не вместо него:
+  реплика посреди хода отвечается вместе с начатым действием. Дважды за сутки ход кончился
+  ровно такой строкой, и оба раза владелец возвращал работу сам.
+
+- **Прерывание работы владельцем называется вслух.** Пришло задание, останавливающее начатое, —
+  исполнитель говорит, что стоит, на чём остановлено и что будет с прежней работой, и только
+  потом берётся за новое. Молчание об этом владелец читает как «прежнее кончилось».
+- **Остановка называется отдельной репликой.** Не строкой в конце отчёта: там она тонет —
+  владелец читает отчёт как рассказ о сделанном. Называются три вещи: что стоит, чего оно ждёт
+  и что владелец может решить.
+- **Выходы хода стережёт страж, а не память исполнителя.** Он читает объявленное состояние
+  работы и то, что за ход по ней сделано: правку файла или команду, меняющую дерево. Ход, в
+  котором не было ни того ни другого, возвращается исполнителю вместе со следующим шагом из
+  хода работы. Отданную и влитую работу страж не судит: она уже дождалась чужого шага.
+- **Работа без ветки и без папки задачи судится тем же стражем по второму признаку.** Состояния
+  у неё нет, и первый признак взять неоткуда, — но ход, в котором не было ни одной правки
+  дерева, не кончается и здесь. Раньше страж отпускал такую работу молча, и защищена она была
+  меньше всего: просьба владельца «разложи», «обнови», «посмотри» идёт без задачи и без ветки,
+  и именно она чаще всего кончалась объявлением намерения.
+- **Передача пишется и там, где имени у ветки нет.** Всё, что в неё едет, лежит в дереве и на
+  отсоединённой голове доступно целиком; имя нужно одному файлу, и он называется коротким
+  снимком головы. Молчание хука здесь стоит дороже прочего: сжатие приходит без передачи, и
+  следующий заход начинает с пустого места.
+- **Этап замысла объявляется закрытым только после того, как его команда проверки прошла.**
+  Строка «Чем проверяется» несёт команду обратными кавычками и то, что в её выводе означает
+  «сошлось». Страж читает прежний номер этапа из истории ветки и не выпускает ход, в котором
+  номер вырос, а команда не запускалась: через заход отмеченное по памяти неотличимо от
+  проверенного.
+- **Слово об остановке страж читает у владельца, а не у исполнителя.** Иначе остановку
+  объявляет тот, кому она в эту минуту удобна, и запрет держится ровно до первого неудобства.
+- **Утверждение о состоянии дерева стережёт гард утверждения, а не память исполнителя.** Всё,
+  что ответ владельцу говорит о дереве, несёт команду и её вывод: сказанное без команды
+  утверждением не считается — ни «проверено», ни «снято», ни «готово». Гард читает текст,
+  сказанный владельцу за ход, и ищет команду того же хода; у каждого слова назван свой род
+  команды, потому что общий признак «команда была» подтверждал бы одно другим. Прошлый ход не
+  годится: состояние дерева меняется, и вчерашний вывод о нынешнем молчит. Восемь разборов
+  подряд пришлись на этот промах, и каждый раз в правило дописывалась ещё одна статья —
+  держит его теперь машина.
+- **Слово-утверждение гард ловит, неверный вывод — нет.** Об образце, судимом по одному его
+  файлу, и о пути, которым человек не пойдёт, судить нечем: там нет ни слова, ни команды, с
+  которой сверять. Это известная граница гарда, и держат её статьи ниже, а не он.
+- **Ход о чужом шаге стережёт гард ожидания, а не память исполнителя.** Он отбивает завершение
+  хода, в котором о чужом шаге сказано, а по следующей задаче не сделано ни одного действия —
+  ни заведения задачи, ни ветки, ни папки, ни перевода колонки. Чужой шаг он узнаёт по двум
+  признакам: в ходе открыт PR либо в ходе прочитан красный прогон. Оба берутся из самого хода:
+  спросить хостинг было бы точнее, но сетевой вызов на завершении хода падает вместе со связью
+  и отбивал бы работу вместо промаха, а вывод команды о прогоне в записи хода уже лежит. Слова
+  «беру следующую задачу» гард действием не считает — ровно потому, что их и произносят вместо
+  неё.
+- **Конец прогона узнаётся возвратом фоновой команды, а не взглядом на страницу.** Ожидание,
+  запущенное в фоне отдельным ходом, возвращает исполнителя к PR само; до тех пор ход занят
+  следующей задачей. Взгляд на страницу этого не даёт: он либо повторяется вхолостую, либо не
+  повторяется вовсе, и оба исхода со стороны выглядят одинаково — работа не двигается.
+- **Отказ гарда кончает ход.** Другого пути к отбитой правке не ищут: ни командой оболочки, ни
+  соседним инструментом, ни правкой самого гарда. Отбитая правка либо делается после того, как
+  условие отказа выполнено, либо не делается вовсе — и тогда владельцу называется отказ, а не
+  результат. Обход стоит дороже отказа: гард отбивает один файл, а обойдённый гард снимает
+  требование со всего дерева и молчит об этом. Держится это не только памятью — гарды судят и
+  команду оболочки, которая пишет файл.
+- **Ход, в котором владельцу задан вопрос, не заканчивается, пока за этот же ход не читались
+  законы и правила.** Чтением считается любой из трёх путей: загрузка правила, чтение файла
+  законов или правил, поиск по ним. Отбивает гард разговора — на завершении хода, а не на
+  инструменте вопроса: спрашивают чаще прозой, чем меню. Найденное ложится в раздел «Что уже
+  сказано в правилах» разбора.
+- **Действия, которые исполнитель не делает без слова владельца, перечислены в компаньоне
+  правила.** Список у каждого дерева свой — пакет знает только требование, чтобы список был
+  назван. Не названный, он выводится из общих слов, и «делай, что нужно по плану» становится
+  разрешением на пуш и правку общих документов заодно с коммитом. Оценка «это безопасно» списка
+  не заменяет: её назначает тот, кому она в эту минуту удобна, и она плывёт. За один заход одна
+  и та же команда была сначала слишком опасной, чтобы её позвать, а через два хода —
+  достаточно безопасной, чтобы позвать без спроса.
+- **У отказа от необратимого действия есть безопасная часть, и она делается.** Требование
+  спросить владельца относится к действию, а не к ходу: работа, у которой отделима часть без
+  последствий, делится, а не откладывается целиком. Список вариантов, поданный вместо работы,
+  читается как работа — тем полнее, чем аккуратнее он составлен: он пронумерован, в нём названы
+  цифры, и именно поэтому пустота хода за ним не видна. Владельцу называется, что уже сделано и
+  что осталось за его словом, — а не выбор из вариантов вместо и того и другого.
+- **Ход, в котором исполнитель признал промах, не заканчивается, пока записи о происшествии
+  нет.** Отбивает гард происшествия — на завершении хода: к моменту признания промах уже
+  случился, и ловить раньше нечего. Признание ловится набором образцов, а не пониманием смысла;
+  промах, признанный словами вне набора, гард пропускает, и это его известная граница, а не
+  обещание.
+- **Заход, начатый с передачи, входит в работу тем же правилом, что и всякий другой.** Передача
+  лежит вне дерева, её не читает ни одна проверка, и написана она вчера: всё, что в ней стоит,
+  проверяется деревом. Порядок входа — четыре шага в паттерне возвращения; стережёт его гард, а
+  не память: порядок, записанный только словами, исполняется, пока о нём помнят.
+- **Состояние незаконченной работы приходит в контекст на запуске сессии.** Замысел и ход
+  работы отдаются целиком, разбор просьбы — путём. Ветка вида `<КЛЮЧ>-*` без папки даёт
+  предупреждение с готовой командой, но сессию не рвёт.
+- **Заполненное окно кончает ход только там, где сжатия нет.** Где оно объявлено, окно —
+  продолжение хода: заход сжимается и работает дальше, а порог остановки срабатывает лишь тогда,
+  когда сжатие не пришло.
+- **Заполнение окна захода стережёт гард, а не память исполнителя.** На первом пороге он
+  напоминает выбирать точку остановки, на втором отбивает всё, кроме записи хода работы,
+  передачи и команд поставки. Размер окна и оба порога дерево задаёт само; не задавшее размера
+  стража не получает.
+- **Порог сжатия контекста дерево задаёт само, и стоит он НИЖЕ порога остановки.** Совпавшие
+  пороги согласием не бывают: это гонка, и выигрывает её страж — он стоит на вызове, а сжатие
+  приходит между ходами. Расстояние объявляется числом, а не выводится разницей; сведены пороги
+  или нет, говорит разбор состояния раскладки.
+- **Заход закрывается передачей, которая лежит вне дерева.** Состояние работы коммитится ходом
+  работы, а передача его пересказывает для вставки в новый заход: рабочее дерево, ветка,
+  сделанное, следующий шаг и особенности захода. В историю она не едет — иначе рядом с ходом
+  работы заводится вторая запись об одном и том же.
+
+## Чего из закона здесь нет
+
+Полноту сказанного владельцу не проверяет ничто: гард утверждения ловит слово-утверждение и
+ищет команду того же хода, а неверный вывод из верной команды не судит ничем — об образце,
+судимом по одному его файлу, и о пути, которым человек не пойдёт, сверять нечего.
+
+Признание промаха ловится набором образцов, а не пониманием смысла: промах, признанный
+словами вне набора, гард происшествия пропускает. Это его известная граница, а не обещание.
+
+## Паттерны
+
+- `task-flow-handoff` — закрытие захода по заполнению окна: точка остановки и передача.

package/assets/rules/turn-entry.md

@@ -0,0 +1,93 @@
+---
+name: turn-entry
+kind: rule
+law: work-conduct
+description: Правило под «Закон о ведении работы». Брать при правке хука входа в заход, текста карты хода и проверки над ней, а также когда решается, что заход получает в контекст до первой реплики. Называет передачу прошлого захода, карту хода, четыре запуска и отказ в пользу работы. Не брать для самого хода работы — это правило task-flow.
+---
+
+# Вход в заход — как это устроено здесь
+
+Правило под закон `docs/constitution/work-conduct.md`. Закон говорит, что переданное прошлым
+заходом приходит в новый заход само и что порядок ведения работы приходит вместе с работой;
+здесь — чем это сделано в этом дереве. Сам ход работы — правило `task-flow` под тем же законом:
+там про состояния и их обязательные действия, здесь — про то, как они попадают в заход.
+
+## Как это называется здесь
+
+| В законе                   | Здесь                                                                         |
+| -------------------------- | ----------------------------------------------------------------------------- |
+| вход в заход               | то, что хук старта кладёт в контекст до первой реплики                        |
+| переданное прошлым заходом | файл по имени ветки в каталоге передач; пишет его хук перед сжатием контекста |
+| порядок ведения работы     | карта хода — состояния с обязательными действиями и четыре выхода хода        |
+| запуск                     | первый запуск, возобновление, сжатие контекста, очистка                       |
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет.
+
+## Ход
+
+Ход подачи: что кладётся в контекст, в каком порядке и что делается с недостающим.
+
+```mermaid
+flowchart TD
+    A[Запуск захода] --> B{Есть передача по имени текущей ветки}
+    B -->|Да| C[Передача кладётся в контекст целиком]
+    B -->|Нет| D[О передаче не говорится ничего]
+    C --> E{Разложен ресурс карты хода}
+    D --> E
+    E -->|Да| F[Карта кладётся следом: состояния, действия, четыре выхода]
+    E -->|Нет| G[О карте не говорится ничего]
+    F --> H[Хук выходит нулём: запуск не отбивается ни при каком исходе]
+    G --> H
+```
+
+## Как закон применяется здесь
+
+- **Передача прошлого захода приходит в контекст тем же запуском, что и состояние работы.**
+  Написанная и не прочитанная, она равна ненаписанной: следующий заход о ней не знает и
+  начинает с пустого места — с того самого, ради чего её и писали.
+- **Передача берётся по имени текущей ветки.** Передач в каталоге столько, сколько было веток;
+  чужая, поданная как своя, описывает работу, которой в этом дереве нет.
+- **Передачи нет — вход об этом молчит.** Ветка, по которой заход ещё не закрывался, это
+  обычное начало работы, а не поломка: отказ на ней превращал бы каждый первый заход в разбор
+  хука.
+- **Карта хода приходит тем же запуском и лежит своим файлом, а не вынимается из правила.**
+  Разобранная на месте из таблицы правила, она ломается молча при первой правке разметки;
+  зашитая в хук — расходится с правилом без единой правки.
+- **Карта короче правила, и предел ей назначает проверка дерева.** Этим она и полезна:
+  выросшая до правила, она съедает то самое окно, ради которого её кладут в контекст, — и
+  заметить это нечем, потому что она продолжает приходить и продолжает быть верной.
+- **Состояние, объявленное правилом и забытое в карте, — расхождение.** Заход получает карту,
+  не находит в ней своего состояния и идёт читать правило: карта работает ровно до первого
+  нового состояния.
+- **Вход подаётся на всех четырёх запусках, а не только после сжатия.** Заход после обрыва и
+  заход после очистки начинают с того же пустого места, и разница между ними исполнителю не
+  видна вовсе.
+- **Хук входа запуск не отбивает.** Отказ любой его части — нечитаемый файл, отсутствующий
+  ресурс, чужие права — оставляет заход без части входа, но не без захода.
+
+## Чего из закона здесь нет
+
+Полноту самой передачи не проверяет ничто: хук подаёт то, что лежит, и о том, дописал ли
+исполнитель к черновику своё, судить машине нечем. Держится это паттерном закрытия захода.
+
+Не проверяется и то, прочитал ли заход поданное. Вход кладётся в контекст, а что с ним делают
+дальше — свойство хода, а не файла.
+
+## Паттерны
+
+- `turn-entry-map` — что входит в карту, порядок подачи и живая проба хука.
+- `task-flow-handoff` — закрытие захода: точка остановки и форма передачи; паттерн соседнего
+  правила, но читается в паре с этим.
+
+## Ловушки
+
+- **Хук, подающий пустоту, неотличим от работающего.** Вход, у которого нет ни передачи, ни
+  карты, печатает ноль байт и возвращает ноль — ровно так же выглядит хук, который не запустился
+  вовсе. Проверяется это не глазами по контексту, а вызовом хука руками на дереве, где обе части
+  лежат.
+- **Передача пишется для машины, а не для владельца.** Обращение в ней — «спроси у него, чем
+  кончилась проба» — уходит в пустоту: к минуте, когда передачу читают, владельца в разговоре
+  ещё нет.

package/assets/rules/typescript-conventions.md

@@ -50,15 +50,23 @@ flowchart TD
 
 - **Род объявления виден по префиксу имени, и это держат три правила линтера.** У интерфейса,
   у типа и у перечисления свои; все три подняты для всех `.ts`.
+      <!-- rt-when: *.ts -->
+
 - **Источник, за которым следят, назван суффиксом.** Субъект и наблюдаемое, поднятое из него,
   различаются в месте использования, а не переходом к объявлению.
+      <!-- rt-when: *.ts -->
+
 - **Суффикс имени файла находит в нём обещанное объявление.** Список суффиксов закрыт: слово,
   которого в нём нет, суффиксом не считается, и такой файл правило не судит.
+      <!-- rt-when: *.ts -->
+
 - **Файл не длиннее 500 строк, и считаются все строки — пустые и комментарии тоже.** Файл,
   который не влезает на экран целиком, читают по частям, и правку в нём делают, не увидев
   остального. Для `.ts` это держит правило линтера; файлы обвязки — сценарии и скрипты — до
   него не доходят и судятся отдельной проверкой дерева. Накопленное к дню включения
   перечислено поимённо, и строка оттуда снимается вместе с делением своего файла.
+      <!-- rt-when: *.ts -->
+
 - **Значение из закрытого набора приходит перечислением `E<Имя>`, а не строкой или числом в
   месте использования.** Ключ переводимого поля, имя вкладки, слот обложки, вид записи — всё
   это наборы: их называют форма, стор, разметка и сравнение черновиков, и написанное на месте
@@ -66,14 +74,21 @@ flowchart TD
   домена, чей это набор, а общее нескольким приложениям — в общей либе. Одиночный адрес,
   разделитель и знак-подпись перечислением не становятся: закрытого набора у них нет, и они
   объявляются константой файла с говорящим именем.
+      <!-- rt-when: *.ts -->
+
 - **Тип берётся из того пакета, где объявлен.** Своя копия чужого типа расходится с оригиналом
   молча, а компилируется из них только одна.
+      <!-- rt-when: *.ts -->
+
 - **Двухступенчатое приведение `as unknown as` запрещено правилом линтера.** Вместо него —
   честный тип, сужение проверкой или чтение поля формой (`Reflect.get`); место, где иначе
   нельзя, помечается точечным отключением с причиной в той же строке.
+      <!-- rt-when: *.ts -->
+
 - **Отметка об устаревании ставится вместе с обходом потребителей.** Все правила
   `eslint-plugin-sonarjs` подняты до отказа разом, и пометка на типе красит каждое место, где
   его ещё зовут: один `@deprecated` на файл дал семнадцать замечаний в чужих доменах.
+      <!-- rt-when: *.ts -->
 
 ## Чего из закона здесь нет
 

package/assets/skills/agent-kit.md

@@ -40,9 +40,9 @@ description: Переносимый слой правил агента — за
 
 ## Порядок
 
-Правка ресурса доезжает до дерева только через сборку пакета: строка запуска читает собранное,
-а не исходники ресурсов. Порядок один и тот же всегда — правка, сборка, `sync`. Отказ хотя бы
-по одному файлу не пишет ничего: половина разложенного хуже целого.
+Раскладка кладёт всё или ничего: отказ хотя бы по одному файлу не пишет ничего — половина
+разложенного хуже целого. Правится либо надстройка здесь, либо сам ресурс — а это работа того
+дерева, где пакет живёт исходниками, и здесь о ней не сказано ничего.
 
 ## Команды
 
@@ -56,13 +56,36 @@ npx agent-kit propose       # отправить груз в приём: сво
 
 Строкой запуска слой правил не исчерпывается: часть его команд исполняет агент, а не программа.
 `/feedback` кладёт слово о правилах блоком в файл предложений, `/skill-curator` разбирает
-закрытую задачу, `/next-session` закрывает заход, `/agent-kit-digest` сводит накопленное в правки
-ресурсов, а `/rules-review` читает семью текстов — закон, его правила и паттерны при них — и ищет
-то, чего не считает ни одна проверка: два текста, говорящих об одном разное, и случай, которого
-не назвал ни один. Две последние зовутся в репозитории самого пакета: они правят его ресурсы и
-судят их исходные тексты.
-Считаемое ловит набор полноты текстов, и он же стоит перед пушем; ответ роли не повторяется от
-запуска к запуску и ветку не отбивает.
+закрытую задачу, `/next-session` закрывает заход.
+
+Команд, которыми правят сам пакет, здесь нет: они зовутся там, где лежат его ресурсы, и вместе
+с ними не едут.
+
+## Что пакет везёт, а что остаётся дереву
+
+Пакет ставят чужие деревья, и везёт он им только то, что они исполняют. Ресурс, у которого в
+чужом дереве нет предмета или некому его позвать, ресурсом пакета не бывает — он живёт своим
+ресурсом того дерева, где предмет есть.
+
+Признак — не оценка, а два вопроса к ресурсу:
+
+| Вопрос                                          | «Нет» означает                                 |
+| ----------------------------------------------- | ---------------------------------------------- |
+| Есть ли у потребителя то, о чём ресурс говорит? | предмета нет: заполнить компаньон нечем        |
+| Есть ли у потребителя кому его позвать?         | исполнителя нет: команда у него не запускается |
+
+Ответ «нет» хотя бы на один — ресурс остаётся дереву, которое пакет пишет.
+
+**Перечень отменяемого границу не закрывает.** Строка в `skip` говорит «мне этого не надо» и
+снимает раскладку у себя; ресурс при этом остаётся в пакете и продолжает ехать всем остальным.
+Убирается он из самого пакета, а не из своей раскладки.
+
+**Своё правило дерева объявляется наравне с пакетным:** та же форма, тот же закон сверху,
+компаньон рядом и своя ветка в карте гейта. Читателю не должно быть видно, чем оно младше.
+
+Что при этом должно быть верно, записано договорённостью в том дереве, которое пакет пишет:
+там же живёт и проверка, которая границу держит. Чужому дереву судить ресурсы пакета нечего,
+поэтому проверка сюда не едет.
 
 ## Обратная связь наверх
 
@@ -104,8 +127,8 @@ npx agent-kit propose       # отправить груз в приём: сво
 сколько записей легло и сколько уже лежало. Строка «принято 0, уже лежало 3» означает, что
 нового не уехало ничего.
 
-Разбираются предложения в репозитории самого пакета — командой `/agent-kit-digest`, там же, где
-лежат правимые ресурсы и видно всех потребителей сразу.
+Разбирают их там, где лежат правимые ресурсы и видно всех потребителей сразу, — а сюда
+приезжает ответ приёма о том, сколько записей легло.
 
 **Имя файла предложения в текстах дерева не называется.** Каталог предложений в историю не едет:
 файл лежит на той машине, где его написали, и адрес на него ведёт в пустоту у всех остальных —

package/assets/templates/pitfalls.md

@@ -0,0 +1,10 @@
+# <О чём правило> — холодная часть
+
+Ловушки: грабли, на которые уже наступали. Грузится не вместе с правилом, а по требованию —
+при обычном решении она не нужна, она нужна тому, кто уже наступил.
+
+Правило — `<имя-правила>`; статьи, которыми держится закон, стоят там.
+
+## Ловушки
+
+- **<Грабли, на которые уже наступали.>** <Чем это кончилось.>

package/assets/templates/rule.md

@@ -11,6 +11,9 @@ description: Правило под закон «<Название закона>
 приёмом это делается. Чем это названо в этом дереве и где лежит — `implementation.md` рядом:
 правило переносится между репозиториями, имена — нет.
 
+**Холодная часть:** `pitfalls.md` рядом — <ловушки и поведение по разборам, если они у правила
+есть>. Строка стоит только у правила, которое такой файл завело: у остального её нет вовсе.
+
 ## Как это называется здесь
 
 <Таблица «в законе — здесь»: закон говорит без имён, дерево называет свои. Правка, по которой
@@ -56,6 +59,5 @@ flowchart TD
 
 - `<имя-правила>-<что>` — <когда брать>.
 
-## Ловушки
-
-- **<Грабли, на которые уже наступали.>** <Чем это кончилось.>
+Ловушек здесь нет: они живут в холодной части — `pitfalls.md` рядом, по образцу холодной
+части. Правило кончается паттернами.

package/lib/assets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/assets.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,eAAe,EAAe,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,OAAO,EAA2B,KAAK,EAAE,MAAM,aAAa,CAAC;AAEtE,MAAM,WAAW,MAAM;IACnB,kGAAkG;IAClG,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,8FAA8F;IAC9F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAChC;AAUD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAI9H;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CASnF"}
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/assets.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,eAAe,EAAe,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,OAAO,EAA0C,KAAK,EAAE,MAAM,aAAa,CAAC;AAErF,MAAM,WAAW,MAAM;IACnB,kGAAkG;IAClG,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,8FAA8F;IAC9F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAChC;AAUD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAU9H;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CASnF"}

package/lib/assets.js

@@ -8,7 +8,7 @@
 import { join } from 'node:path';
 import { chosenEntries } from './cascade.js';
 import { readCatalog } from './catalog.js';
-import { SKILL_FILE, SKILL_KINDS } from './config.js';
+import { PITFALLS_FILE, SKILL_FILE, SKILL_KINDS } from './config.js';
 /** Расширение ресурса вместе с точкой; у файла без расширения — пустая строка. */
 const extensionOf = (id) => {
     const dot = id.lastIndexOf('.');
@@ -23,6 +23,11 @@ const extensionOf = (id) => {
  * дереве нет, а агенту, который правило читает, различать их незачем.
  */
 export function targetOf(entry, layout) {
+    // Холодная часть ложится в каталог своего правила и под своим именем: правило читается как
+    // `<имя>/SKILL.md`, а её читают отдельно и по требованию — `<имя>/pitfalls.md`.
+    if (entry.kind === 'pitfalls') {
+        return join(layout[entry.kind], entry.name, PITFALLS_FILE);
+    }
     return SKILL_KINDS.includes(entry.kind)
         ? join(layout[entry.kind], entry.name, SKILL_FILE)
         : join(layout[entry.kind], `${entry.name}${extensionOf(entry.id)}`);

package/lib/assets.js.map

@@ -1 +1 @@
-{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/assets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAmB,WAAW,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAW,UAAU,EAAE,WAAW,EAAS,MAAM,aAAa,CAAC;AAetE,kFAAkF;AAClF,MAAM,WAAW,GAA2B,CAAC,EAAU,EAAU,EAAE;IAC/D,MAAM,GAAG,GAAW,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,KAAK,GAAW,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAE1C,OAAO,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5C,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAoD,EAAE,MAAuC;IAClH,OAAO,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;QACnC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC;QAClD,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAe,EAAE,SAAiB;IAC5D,OAAO,aAAa,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAsB,EAAU,EAAE,CAAC,CAAC;QAC1F,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;QACtC,UAAU,EAAE,KAAK,CAAC,UAAU;KAC/B,CAAC,CAAC,CAAC;AACR,CAAC","sourcesContent":["/**\n * Что из везомого пакетом взял этот проект и куда оно ложится.\n *\n * Полный набор читает `catalog.ts`, здесь из него остаётся выбранное. Разделено потому, что\n * выбирать приходится раньше, чем раскладывать: `init` спрашивает, какие законы взять, а `list`\n * показывает и то, от чего проект отказался, — обоим нужен набор до отбора.\n */\nimport { join } from 'node:path';\n\nimport { chosenEntries } from './cascade.js';\nimport { IEntryOfCatalog, readCatalog } from './catalog.js';\nimport { IConfig, SKILL_FILE, SKILL_KINDS, TKind } from './config.js';\n\nexport interface IAsset {\n    /** Идентификатор: `laws/application/money.md`. Он же путь надстройки и ключ в `only` и `skip`. */\n    readonly id: string;\n    readonly kind: TKind;\n    /** Имя без рода, вида и расширения: `delivery`. У скила — имя каталога, которым его зовут. */\n    readonly name: string;\n    readonly text: string;\n    /** Путь в дереве проекта, куда ресурс ложится. */\n    readonly target: string;\n    /** Запускается ли файл сам по себе: гарда без права на запуск не существует. */\n    readonly executable: boolean;\n}\n\n/** Расширение ресурса вместе с точкой; у файла без расширения — пустая строка. */\nconst extensionOf: (id: string) => string = (id: string): string => {\n    const dot: number = id.lastIndexOf('.');\n    const slash: number = id.lastIndexOf('/');\n\n    return dot > slash ? id.slice(dot) : '';\n};\n\n/**\n * Куда ложится ресурс. Скил читается агентом как `<имя>/SKILL.md`, и другого имени у него быть\n * не может: файл, названный по ресурсу, агент не найдёт вовсе. Остальные роды ложатся файлом —\n * по имени, а не по идентификатору: слой законов из идентификатора в путь переезжает, а вид\n * ресурса нет. У разложенного `git-workflow` хостинга в имени не остаётся: второго вида в этом\n * дереве нет, а агенту, который правило читает, различать их незачем.\n */\nexport function targetOf(entry: Pick<IEntryOfCatalog, 'id' | 'kind' | 'name'>, layout: Readonly<Record<TKind, string>>): string {\n    return SKILL_KINDS.includes(entry.kind)\n        ? join(layout[entry.kind], entry.name, SKILL_FILE)\n        : join(layout[entry.kind], `${entry.name}${extensionOf(entry.id)}`);\n}\n\nexport function collectAssets(config: IConfig, assetsDir: string): readonly IAsset[] {\n    return chosenEntries(readCatalog(assetsDir), config).map((entry: IEntryOfCatalog): IAsset => ({\n        id: entry.id,\n        kind: entry.kind,\n        name: entry.name,\n        text: entry.text,\n        target: targetOf(entry, config.layout),\n        executable: entry.executable,\n    }));\n}\n"]}
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/assets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAmB,WAAW,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAW,aAAa,EAAE,UAAU,EAAE,WAAW,EAAS,MAAM,aAAa,CAAC;AAerF,kFAAkF;AAClF,MAAM,WAAW,GAA2B,CAAC,EAAU,EAAU,EAAE;IAC/D,MAAM,GAAG,GAAW,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,KAAK,GAAW,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAE1C,OAAO,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5C,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAoD,EAAE,MAAuC;IAClH,2FAA2F;IAC3F,gFAAgF;IAChF,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;QACnC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC;QAClD,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAe,EAAE,SAAiB;IAC5D,OAAO,aAAa,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAsB,EAAU,EAAE,CAAC,CAAC;QAC1F,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;QACtC,UAAU,EAAE,KAAK,CAAC,UAAU;KAC/B,CAAC,CAAC,CAAC;AACR,CAAC","sourcesContent":["/**\n * Что из везомого пакетом взял этот проект и куда оно ложится.\n *\n * Полный набор читает `catalog.ts`, здесь из него остаётся выбранное. Разделено потому, что\n * выбирать приходится раньше, чем раскладывать: `init` спрашивает, какие законы взять, а `list`\n * показывает и то, от чего проект отказался, — обоим нужен набор до отбора.\n */\nimport { join } from 'node:path';\n\nimport { chosenEntries } from './cascade.js';\nimport { IEntryOfCatalog, readCatalog } from './catalog.js';\nimport { IConfig, PITFALLS_FILE, SKILL_FILE, SKILL_KINDS, TKind } from './config.js';\n\nexport interface IAsset {\n    /** Идентификатор: `laws/application/money.md`. Он же путь надстройки и ключ в `only` и `skip`. */\n    readonly id: string;\n    readonly kind: TKind;\n    /** Имя без рода, вида и расширения: `delivery`. У скила — имя каталога, которым его зовут. */\n    readonly name: string;\n    readonly text: string;\n    /** Путь в дереве проекта, куда ресурс ложится. */\n    readonly target: string;\n    /** Запускается ли файл сам по себе: гарда без права на запуск не существует. */\n    readonly executable: boolean;\n}\n\n/** Расширение ресурса вместе с точкой; у файла без расширения — пустая строка. */\nconst extensionOf: (id: string) => string = (id: string): string => {\n    const dot: number = id.lastIndexOf('.');\n    const slash: number = id.lastIndexOf('/');\n\n    return dot > slash ? id.slice(dot) : '';\n};\n\n/**\n * Куда ложится ресурс. Скил читается агентом как `<имя>/SKILL.md`, и другого имени у него быть\n * не может: файл, названный по ресурсу, агент не найдёт вовсе. Остальные роды ложатся файлом —\n * по имени, а не по идентификатору: слой законов из идентификатора в путь переезжает, а вид\n * ресурса нет. У разложенного `git-workflow` хостинга в имени не остаётся: второго вида в этом\n * дереве нет, а агенту, который правило читает, различать их незачем.\n */\nexport function targetOf(entry: Pick<IEntryOfCatalog, 'id' | 'kind' | 'name'>, layout: Readonly<Record<TKind, string>>): string {\n    // Холодная часть ложится в каталог своего правила и под своим именем: правило читается как\n    // `<имя>/SKILL.md`, а её читают отдельно и по требованию — `<имя>/pitfalls.md`.\n    if (entry.kind === 'pitfalls') {\n        return join(layout[entry.kind], entry.name, PITFALLS_FILE);\n    }\n\n    return SKILL_KINDS.includes(entry.kind)\n        ? join(layout[entry.kind], entry.name, SKILL_FILE)\n        : join(layout[entry.kind], `${entry.name}${extensionOf(entry.id)}`);\n}\n\nexport function collectAssets(config: IConfig, assetsDir: string): readonly IAsset[] {\n    return chosenEntries(readCatalog(assetsDir), config).map((entry: IEntryOfCatalog): IAsset => ({\n        id: entry.id,\n        kind: entry.kind,\n        name: entry.name,\n        text: entry.text,\n        target: targetOf(entry, config.layout),\n        executable: entry.executable,\n    }));\n}\n"]}

package/lib/cargo.d.ts

@@ -105,4 +105,46 @@ export interface IIntakeAccepted {
     readonly added?: number;
     readonly known?: number;
 }
+/** Род записи груза, у которой есть состояние. Набор закрыт: сводка месяца состояния не несёт. */
+export type TCargoStateKind = 'postmortem' | 'proposal';
+/** Состояния записи груза по порядку: шаг идёт вперёд на соседнее, назад — только из «в работе». */
+export declare const CARGO_STATES: readonly string[];
+/** Одна строка правки состояния: род записи, ключ и состояние, в которое её переводят. */
+export interface ICargoStateItem {
+    readonly kind: TCargoStateKind;
+    /** Ключ записи: имя файла у разбора происшествия, признак текста у предложения. */
+    readonly key: string;
+    readonly state: string;
+    /**
+     * Чем недочёт исправлен. Едет только при переходе в «починено и не выпущено» — с другим
+     * переходом приём отбивает строку, а без него отбивает переход в починку.
+     */
+    readonly fixNote?: string;
+    /**
+     * В какой версии искать фикс. Едет только при переходе в «выпущено» — с другим переходом
+     * приём отбивает строку, а без него отбивает переход в выпуск.
+     */
+    readonly releaseVersion?: string;
+}
+/** Пакет правки состояния: то же общее, что у всякого груза, плюс строки правки. */
+export interface ICargoStateBody extends ICargoHead {
+    readonly items: readonly ICargoStateItem[];
+}
+/** Строка, которую приём не исполнил: место в пакете, род записи, ключ и причина. */
+export interface ICargoStateDenied {
+    readonly at: number;
+    readonly kind: TCargoStateKind;
+    readonly key: string;
+    /** Почему не исполнена: записи у дерева нет либо переход не разрешён. */
+    readonly denial: string;
+}
+/** Ответ приёма на правку состояния: признак дерева, два числа и отбитые строки. */
+export interface ICargoStateAccepted {
+    readonly tree: string;
+    /** Сколько записей переведено. */
+    readonly changed: number;
+    /** Сколько уже стояло в названном состоянии: переходом это не считается. */
+    readonly same: number;
+    readonly denied: readonly ICargoStateDenied[];
+}
 //# sourceMappingURL=cargo.d.ts.map

package/lib/cargo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cargo.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/cargo.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cargo.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/cargo.ts"],"names":[],"mappings":"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"}

package/lib/cargo.js

@@ -13,4 +13,6 @@
 export const CARGO_SCHEMA_VERSION = '1';
 /** Заголовок, которым дерево представляется приёму. */
 export const TREE_TOKEN_HEADER = 'x-tree-token';
+/** Состояния записи груза по порядку: шаг идёт вперёд на соседнее, назад — только из «в работе». */
+export const CARGO_STATES = ['new', 'in_work', 'fixed', 'released'];
 //# sourceMappingURL=cargo.js.map