@rt-tools/agent-kit 0.16.1 → 0.18.0

package/assets/rules/turn-conduct.md

@@ -43,6 +43,10 @@ description: Правило под «Закон о ведении работы»
 назначенном порядке, объявление намерения и названная, но не запущенная команда. Что при этом
 должно быть верно — ниже, в статьях о применении закона.
 
+Ход, кончающийся при идущем эпике, показывает владельцу его положение — той же таблицей, какой
+оно уходит в передаче: порядок задач лежит записанным, а тому, ради кого исполнитель по нему
+идёт, состояние очереди иначе не видно ни на одном ходу.
+
 ## Где это лежит
 
 В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
@@ -80,10 +84,16 @@ flowchart TD
   быстрее не становятся. Ход, кончившийся такой сводкой, владелец читает как работу: она полна, в
   ней названы номера и состояния, и пустоты за ней не видно. О чужом шаге говорят вместе с начатым
   своим, а не вместо него.
+- **Чужой шаг бывает двух родов, и второй не кончится сам.** Прогон и разбор идут без
+  исполнителя и кончатся без него; отбитое разрешение не кончится никогда — его ждут. Работа,
+  упершаяся в разрешение, доводится до конца без той части, которую разрешение открывает, а
+  непройденное называется в теле заявки, где его читает ревьювер: реплика живёт до следующего
+  сообщения, тело заявки — до слияния.
 - **Свой незакрытый шаг владельцу не передаётся.** Список остатков, названный аккуратно, читается
-  как рассказ о работе — тем полнее, чем он аккуратнее, — и владелец разбирает то, что мог
-  доделать сам исполнитель. Чужой шаг сводкой называют, свой — делают: незапушенная ветка,
-  неотмеченная запись груза и незакрытая колонка чужими шагами не бывают.
+  как рассказ о работе, и владелец разбирает то, что мог доделать сам исполнитель. Чужой шаг
+  сводкой называют, свой — делают. Формой вопроса это не чинится: вопрос законен там, где ответа
+  нет ни в правилах, ни в дереве. Список остатков пишется после того, как из него вычеркнуто всё,
+  что исполнитель мог закрыть сам.
 - **Меню при назначенном порядке.** Выбор, предложенный владельцу, пока эпик не кончился, — это
   просьба назначить порядок заново. Работы в эпике не осталось — так и говорится: эпик кончился, —
   а не «чем займёмся».
@@ -95,16 +105,25 @@ flowchart TD
   начатой работой лучше всякого другого обещания — она точна, её видно, и по ней не отличить
   сделанного от собранного. Ответ владельцу пишется после вызова, а не вместо него: реплика
   посреди хода отвечается вместе с начатым действием.
+- **Слово о своей же работе судится сделанным в том же ходе.** «Не стою — продолжаю» к концу
+  хода подтверждается работой, а не намерением: иначе владелец читает пару «обещал — не сделал»
+  как ложь. Это требование к слову о дереве, обращённое на себя.
 - **Вариант, поданный владельцу, назван ценой для человека.** Сколько шагов, где человек окажется
-  и что ему для этого нужно — без этого варианты выглядят равными, и выбор идёт по доводам со
-  стороны кода: «меньше путей», «строку запуска не трогаем». Знание, которое делает вариант
-  негодным, пишется в сам вариант, а не остаётся у того, кто его составил.
+  и что ему нужно — без этого варианты выглядят равными, и выбор идёт по доводам со стороны кода.
+  Знание, которое делает вариант негодным, пишется в сам вариант.
+- **Названное владельцем состояние дерева снимается вызовом раньше объяснения.** «Конфликты»,
+  «прогон красный», «ветка отстала» — указание на то, что надо снять, а не тема для разбора.
+  Причина называется после починки и только если её спрашивали: объяснение выглядит работой, не
+  трогая ни одной ветки. Вопрос «почему» в том же сообщении идёт вторым.
 - **Пересказ действующего порядка без оценки читается как одобрение.** На прямой вопрос владельца
   «как это работает» ответ фактами верен и недостаточен: устройство, названное спокойно, звучит
   принятым. Годность порядка для того, кто им пользуется, называется вместе с ним.
+- **Путь к файлу заданием не бывает.** Строка с адресом называет файл, а не действие: прочитанная
+  как поручение, она даёт заходу задание, которого владелец не давал. То же с любой репликой без
+  глагола — уточнить дешевле, чем написать полсотни файлов мимо просьбы.
 - **Прерывание работы владельцем называется вслух.** Пришло задание, останавливающее начатое, —
-  исполнитель говорит, что стоит, на чём остановлено и что будет с прежней работой, и только потом
-  берётся за новое. Молчание об этом владелец читает как «прежнее кончилось».
+  исполнитель говорит, что стоит, на чём остановлено и что будет с прежним, и только потом берётся
+  за новое. Молчание об этом владелец читает как «прежнее кончилось».
 - **Остановка называется отдельной репликой.** Не строкой в конце отчёта: там она тонет — владелец
   читает отчёт как рассказ о сделанном. Называются три вещи: что стоит, чего оно ждёт и что
   владелец может решить.
@@ -112,31 +131,23 @@ flowchart TD
   и то, что за ход по ней сделано: правку файла или команду, меняющую дерево. Ход, в котором не
   было ни того ни другого, возвращается исполнителю вместе со следующим шагом из хода работы.
   Отданную и влитую работу страж не судит: она уже дождалась чужого шага.
-- **Снятая папка задачи снимает требование состояния, а ход не кончает.** Ход работы уезжает
-  вместе с папкой, а папка разбирается до открытия заявки: с этой минуты и до слияния строки
-  состояния нет вовсе, и первый признак стражу взять неоткуда. Отпускать по этому признаку ход
-  нельзя — снятая папка означает середину отдачи, а не её конец: между уборкой и заявкой работу не
-  видит никто, кроме того, кто её сделал. Дальше ход судится вторым признаком, как всякий другой;
-  ход, в котором заявку открыли или прочитали, второй признак пропускает сам.
+- **Снятая папка задачи снимает требование состояния, а ход не кончает.** Ход работы уезжает вместе
+  с папкой, а папка разбирается до открытия заявки: с этой минуты и до слияния строки состояния нет
+  вовсе. Отпускать по этому признаку ход нельзя — снятая папка означает середину отдачи, а не её
+  конец. Дальше ход судится вторым признаком; ход, в котором заявку открыли, его пропускает сам.
 - **Работа без ветки и без папки задачи судится тем же стражем по второму признаку.** Состояния у
   неё нет, и первый признак взять неоткуда, — но ход, в котором не было ни одной правки дерева, не
   кончается и здесь.
-- **Взятая задача — ещё не начатая работа, и ход на ней не кончается.** Ветка по номеру заведена,
-  колонка сдвинута, номер назван владельцу — а каталога задачи при ветке нет: обязательное
-  действие состояния «задача-взята» не сделано ни строкой. Второй признак такой ход отпускает
-  целиком, потому что работы в нём много — заведение ветки, перевод колонки, уборка соседних
-  веток, — и «была ли за ход работа» отвечает не на тот вопрос, что «доведена ли работа до конца
-  объявленного состояния». Отчёт при этом встаёт ровно на место следующего действия и выглядит
-  завершённым куском лучше всякой другой вехи. Судит это страж отдельным ярусом; ветка без номера
-  задачи под него не подпадает, а собранный шаблон папки его снимает — заполненность замысла
-  машине не видна.
+- **Взятая задача — ещё не начатая работа, и ход на ней не кончается.** Заведение ветки, перевод
+  колонки и названный владельцу номер — подготовка: обязательное действие состояния
+  «задача-взята» не сделано ни строкой, а работы в ходе много, и признак «была ли работа» его
+  отпускает. Судит это страж отдельным ярусом; ветка без номера задачи под него не подпадает, а
+  собранный шаблон папки его снимает.
 - **Разведка ходом не кончается, сколько бы её ни было.** Переключение ветки, подтягивание,
   просмотр истории и чтение заявок — не работа, а подготовка к ней; ход, собранный из них одних,
-  оставляет работу там же, где она стояла. Признак работы у стража этого прежде не различал: он
-  знает первое слово команды, и читающая подкоманда совпадала с ним наравне с коммитом. Разведка
-  при этом выглядит работой лучше всего остального — в ней команды, точные числа и проверяемые
-  ответы, — поэтому ход, набитый ею, читается полным и заходом, и владельцем. Судятся части
-  составной команды по одной: чтение, соединённое с правкой, работой остаётся.
+  оставляет работу там же, где она стояла. Выглядит она работой лучше всего остального — в ней
+  команды, точные числа и проверяемые ответы. Судятся части составной команды по одной: чтение,
+  соединённое с правкой, работой остаётся.
 - **Ответ владельцу действием не работает и последним в ходе не стоит.** Порядок внутри хода
   один: работа, потом первый шаг следующей, и только потом текст. Обратный порядок — работа,
   отчёт, конец — стоит за каждой остановкой, которую разбирали: отчёт есть форма завершённости, и
@@ -170,9 +181,8 @@ flowchart TD
   признак «команда была» подтверждал бы одно другим. Прошлый ход не годится: состояние дерева
   меняется, и вчерашний вывод о нынешнем молчит.
 - **Гард утверждения ждёт текст ответа, а не судит запись, какой застал.** Текст ложится в запись
-  хода не раньше, чем хост зовёт хук, и гард, прочитавший файл первым, видит ход, в котором
-  владельцу не сказано ничего. Не дождавшись текста, гард возвращает ход: пустая запись означает
-  не «сказать было нечего», а «прочитать нечего».
+  хода не раньше, чем хост зовёт хук. Не дождавшись его, гард возвращает ход: пустая запись
+  означает не «сказать было нечего», а «прочитать нечего».
 - **Слово-утверждение гард ловит, неверный вывод — нет.** Об образце, судимом по одному его файлу,
   и о пути, которым человек не пойдёт, судить нечем: там нет ни слова, ни команды, с которой
   сверять. Это известная граница гарда, и держат её статьи ниже, а не он.
@@ -181,20 +191,25 @@ flowchart TD
   заведения задачи, ни ветки, ни папки, ни перевода колонки. Чужой шаг он узнаёт по двум
   признакам: в ходе открыт PR либо в ходе прочитан красный прогон. Слова «беру следующую задачу»
   гард действием не считает — ровно потому, что их и произносят вместо неё.
-- **Ход, отдавший работу, доводит её до снятого черновика.** Черновик читается владельцем как
-  «работа не кончена»: кнопка слияния у него заблокирована самим хостингом, а по списку заявок
-  готовое от недоделанного не отличить — серое и там и там. Следующая задача берётся сверх этого,
-  а не вместо: требование взять её исполняется буквально и оставляет отданное невидимым. Стережёт
-  это гард ожидания: ход, открывший заявку, не кончается, пока состояние отданной работы не
-  спрошено командой того же хода.
+- **Ход, отдавший работу, доводит её до снятого черновика.** У черновика кнопка слияния
+  заблокирована хостингом, и по списку заявок готовое от недоделанного не отличить. Следующая
+  задача берётся сверх этого, а не вместо. Стережёт это гард ожидания: ход, открывший заявку, не
+  кончается, пока состояние отданной работы не спрошено командой того же хода.
+- **Отказ гарда ожидания снимается обоими действиями сразу.** Взятая следующая задача уносит
+  признак открытой заявки с собой, и требование спросить состояние отданной работы после неё не
+  прозвучит уже никогда.
+- **Работа, оставшаяся в рабочем дереве, ход не кончает.** Ветка впереди удалённой ссылки без
+  открытой заявки — сделанное, которого не видит никто; страж читает это без сети.
 - **«Жду прогона» — утверждение о чужом шаге, а не состояние работы.** Прогон бывает зелёным час,
   а бывает не встав вовсе — и второе само не чинится. Слово это требует команды того же хода,
   которая прогон показывает, и без неё не говорится: сказанное без команды владелец читает как
   «работа ещё идёт» и ждёт напрасно. Держит это гард утверждения, а не память исполнителя.
-- **Конец прогона узнаётся возвратом фоновой команды, а не взглядом на страницу.** Ожидание,
-  запущенное в фоне отдельным ходом, возвращает исполнителя к PR само; до тех пор ход занят
-  следующей задачей. Взгляд на страницу этого не даёт: он либо повторяется вхолостую, либо не
-  повторяется вовсе, и оба исхода со стороны выглядят одинаково — работа не двигается.
+- **Конец прогона узнаётся возвратом фоновой команды, а не взглядом на страницу.** Ожидание в
+  фоне возвращает исполнителя к заявке само; взгляд на страницу либо повторяется вхолостую, либо
+  не повторяется вовсе, и оба исхода выглядят одинаково — работа не двигается.
+- **Ожидание своего же замера ведётся одним ожиданием, а не уведомлением на каждый шаг.**
+  Уведомление ставится там, где надо действовать на каждое событие; где значим только итог —
+  одно ожидание, кончающееся вместе с замером.
 - **Отказ гарда кончает ход.** Другого пути к отбитой правке не ищут: ни командой оболочки, ни
   соседним инструментом, ни правкой самого гарда. Отбитая правка либо делается после того, как
   условие отказа выполнено, либо не делается вовсе — и тогда владельцу называется отказ, а не
@@ -227,32 +242,29 @@ flowchart TD
   заменяет: её назначает тот, кому она в эту минуту удобна, и она плывёт.
 - **У отказа от необратимого действия есть безопасная часть, и она делается.** Требование спросить
   владельца относится к действию, а не к ходу: работа, у которой отделима часть без последствий,
-  делится, а не откладывается целиком. Список вариантов, поданный вместо работы, читается как
-  работа — тем полнее, чем аккуратнее он составлен: он пронумерован, в нём названы цифры, и именно
-  поэтому пустота хода за ним не видна. Владельцу называется, что уже сделано и что осталось за
-  его словом, — а не выбор из вариантов вместо и того и другого.
+  делится, а не откладывается целиком. Список вариантов вместо работы читается как работа — тем
+  полнее, чем аккуратнее составлен: пронумерован, с цифрами, и пустота хода за ним не видна.
+  Владельцу называется, что уже сделано и что осталось за его словом.
 - **Признак необратимости берётся из списка, а не выводится доводом.** Список составлен тем, кто
-  обратимость уже взвесил: необратимое в нём осталось, обратимое из него снято. Довод «действие
-  уходит наружу и не откатывается» приходит в контекст всегда, а список — только когда его
-  прочитали, и применённый поверх списка довод отменяет список целиком. Отменяет молча: со стороны
-  это выглядит осторожностью, а не пропуском шага. Действия, которого в списке нет, исполнитель на
-  слово владельца не гейтит, даже если оно уходит наружу. Шаг, снятый из списка разбором прошлого
-  промаха, тем более: довод, которым его туда возвращают, уже разобран и отклонён — и дважды
-  подряд готовая работа вставала перед снятым шагом.
+  обратимость уже взвесил. Довод «уходит наружу и не откатывается» приходит всегда, а список —
+  только когда его прочитали, и довод поверх списка отменяет его молча: со стороны это выглядит
+  осторожностью, а не пропуском шага. Действия вне списка исполнитель не гейтит.
 - **Ход, в котором исполнитель признал промах, не заканчивается, пока записи о происшествии нет.**
-  Отбивает гард происшествия — на завершении хода: к моменту признания промах уже случился, и
-  ловить раньше нечего. Признание ловится набором образцов, а не пониманием смысла; промах,
-  признанный словами вне набора, гард пропускает, и это его известная граница, а не обещание.
+  Отбивает гард происшествия — на завершении хода: к моменту признания промах уже случился.
+  Каталог записей называет компаньон правила, имя файла — дата и чем был промах, форму держит
+  образец раскладки. Признание ловится набором образцов: промах, признанный словами вне набора,
+  гард пропускает.
 - **Заход, начатый с передачи, входит в работу тем же правилом, что и всякий другой.** Передача
   лежит вне дерева, её не читает ни одна проверка, и написана она вчера: всё, что в ней стоит,
   проверяется деревом. Порядок входа — четыре шага в паттерне возвращения; стережёт его гард, а не
-  память: порядок, записанный только словами, исполняется, пока о нём помнят.
+  память.
 - **Состояние незаконченной работы приходит в контекст на запуске сессии.** Замысел и ход работы
   отдаются целиком, разбор просьбы — путём. Ветка вида `<КЛЮЧ>-*` без папки даёт предупреждение с
   готовой командой, но сессию не рвёт.
 - **Заполненное окно кончает ход только там, где сжатия нет.** Где оно объявлено, окно —
   продолжение хода: заход сжимается и работает дальше, а порог остановки срабатывает лишь тогда,
-  когда сжатие не пришло.
+  когда сжатие не пришло. Ход, закрытый ниже порога, теряет остаток окна, за
+  который дерево заплатило настройкой, и ловит это один владелец.
 - **Заполнение окна захода стережёт гард, а не память исполнителя.** На первом пороге он
   напоминает выбирать точку остановки, на втором отбивает всё, кроме записи хода работы, передачи
   и команд поставки. Размер окна и оба порога дерево задаёт само; не задавшее размера стража не
@@ -266,6 +278,10 @@ flowchart TD
   сделанное, следующий шаг и особенности захода. В историю она не едет — иначе рядом с ходом
   работы заводится вторая запись об одном и том же.
 
+- **Вариант, глушащий проверку, в меню не ставится вовсе.** Выключенное правило линтера, строка
+  в списке известного, выведенный из-под проверки файл — все они чинят показание, а не то, на что
+  она указала, и вариант этот в меню самый дешёвый. Меню собирается после того, как он вычеркнут.
+
 ## Чего из закона здесь нет
 
 Полноту сказанного владельцу не проверяет ничто: гард утверждения ловит слово-утверждение и

package/assets/rules/turn-entry.md

@@ -97,3 +97,9 @@ flowchart TD
 - **Передача пишется для машины, а не для владельца.** Обращение в ней — «спроси у него, чем
   кончилась проба» — уходит в пустоту: к минуте, когда передачу читают, владельца в разговоре
   ещё нет.
+- **Вопрос, записанный передачей, вопросом владельцу не становится.** Адресован он её автору —
+  тому же заходу, который его отложил, — и до владельца доходит только после сверки с ходом
+  работы: часть таких вопросов закрыта его шагом, и спрашивать по ним значит спрашивать про уже
+  назначенное. Унаследованный вопрос тем и опасен, что выглядит заданным раньше и потому
+  решённым: меню «зафиксировать, оставить или откатить» уходило владельцу дважды, притом что
+  отметка сделанного этапа и его фиксация в ветке — обычный шаг работы.

package/assets/samples/tasks/_template/grill.md

@@ -1,5 +1,10 @@
 # Разбор просьбы
 
+<Работа, начатая с приехавшего груза, называет здесь его записи — ключами полностью, как их
+печатает чтение приёма. Восьми знаков не хватает: отметка с коротким ключом отбивается строкой
+«такой записи у дерева нет». Этот файл уезжает в описание прошлого, и после разбора папки ключи
+живут только здесь.>
+
 ## Просьба владельца
 
 > <дословно, без пересказа>

package/assets/samples/tasks/_template/plan.md

@@ -4,6 +4,9 @@
 **Драфт:** `<путь к договорённости о продукте>`
 **Поведение:** меняется
 
+Дерево, которое пишет договорённость прямо в спек домена, называет вместо драфта его:
+`**Спек:** `<путь к спеку>``.
+
 Работа, не задевающая код приложения, договорённости не требует — тогда вместо строки драфта
 стоит `**Поведение:** не меняется — <причина владельца>`; пустая причина не принимается.
 

package/assets/skills/agent-kit.md

@@ -47,18 +47,29 @@ description: Переносимый слой правил агента — за
 разложенного хуже целого. Правится либо надстройка здесь, либо сам ресурс — а это работа того
 дерева, где пакет живёт исходниками, и здесь о ней не сказано ничего.
 
+**Раскладка — правка дерева, а не служебный вызов:** она переписывает сотни ведомых файлов
+разом, и работа поэтому оформляется до `sync`, по тем же правилам, что и любая другая.
+
+**Подъём версии пакета и раскладка едут одним изменением.** Сверка раскладки стоит в гейте
+пуша: редакция, поднятая без раскладки, красит главную ветку и запирает дерево целиком.
+
+**Объявление хука раскладка кладёт вместе с самим хуком.** Гард зовёт не файл, а запись в
+настройке агента, и разложенный без неё он снаружи неотличим от работающего: файл лежит,
+коммитится, сверка зелёная — а вызова, ради которого написано его тело, он не видит. Раскладка
+дописывает в настройку запись на каждое событие, которого там нет, и говорит, что дописала.
+Правка только прибавляет: ни одна стоящая запись не переписывается и не снимается, снятое
+деревом не возвращается, а настройку, которую не разобрать как JSON, пакет не трогает вовсе —
+там печатается готовый кусок и запись идёт рукой, как прежде.
+
 **Держит это гард места правки, а не память.** Правку файла с шапкой раскладки он отбивает в
-минуту правки и называет адрес: источник, если дерево его держит, иначе надстройку. Прежде об
-этом знал один `sync --check`, и говорил он на следующей раскладке — то есть в чужой ветке и
-чужим ходом: отказ приходил тому, кто в этот день правил соседний ресурс. Правит копию не
-только рука: форматтер дерева, дошедший до разложенного файла, переписывает его по-своему, и
+минуту правки и называет адрес: источник, если дерево его держит, иначе надстройку. Правит копию
+не только рука: форматтер дерева, дошедший до разложенного файла, переписывает его по-своему, и
 раскладка читает это ровно как правку руками. Снятие копии гард пропускает: снятый файл
 раскладка кладёт заново, и так эту поломку и чинят.
 
 **Надстройка правится по разделу, а не кладётся целиком.** Разделы в неё дописывают разные ветки
-и разные заходы, и положенная целиком она уносит все, которых эта правка не касалась: на их место
-молча возвращается пакетный текст, раскладка после этого сходится, а сказанного деревом о себе
-больше нет. Держит это второй гард — он отбивает запись поверх непустой надстройки и называет
+и разные заходы, и положенная целиком она уносит все, которых эта правка не касалась: на их
+место молча возвращается пакетный текст. Держит это второй гард — он отбивает запись поверх непустой надстройки и называет
 размер того, что затрут: строки и число разделов. Дописывание в конец и правка по месту проходят.
 
 ## Команды
@@ -68,15 +79,43 @@ npx agent-kit doctor        # что разложено, что отстало,
 npx agent-kit sync          # разложить
 npx agent-kit sync --check  # ничего не писать, отказать при расхождении
 npx agent-kit stats         # чем пользовались, чем ни разу, обо что спотыкались
+npx agent-kit enroll --code <код>  # завести дерево в приёме и положить его токен
 npx agent-kit propose       # отправить груз в приём: сводку, предложения и разборы
 ```
 
-Строкой запуска слой правил не исчерпывается: часть его команд исполняет агент, а не программа.
-`/feedback` кладёт слово о правилах блоком в файл предложений, `/skill-curator` разбирает
-закрытую задачу, `/next-session` закрывает заход.
+Часть команд слоя исполняет агент, а не программа: `/feedback` кладёт слово о правилах блоком в
+файл предложений, `/skill-curator` разбирает закрытую задачу, `/next-session` закрывает заход.
+
+Команд правки самого пакета здесь нет: они зовутся там, где лежат его ресурсы.
+
+## Подъём версии
+
+Совпавший заголовок замещает раздел пакета целиком, и всё, что пакет дописал в такой раздел новой
+версией, пропадает молча: раскладка сходится, заголовки совпадают, а утверждений нет. Сверка
+заголовков ловит переименование раздела, а не пополнение, — других свидетелей у потери не бывает.
+
+Порядок подъёма поэтому из трёх шагов, и первый идёт до установки.
+
+1. **Снимок прежней редакции ресурсов.** Установка стирает её без следа, и сравнить потом не с
+   чем.
 
-Команд, которыми правят сам пакет, здесь нет: они зовутся там, где лежат его ресурсы, и вместе
-с ними не едут.
+    ```bash
+    cp -r node_modules/@rt-tools/agent-kit/assets /tmp/agent-kit-assets-<прежняя версия>
+    ```
+
+2. **Установка и раскладка.** Обычным порядком.
+3. **Сверка замещённых разделов по снимку.** Какие разделы замещены, называет `doctor` — строкой
+   «замещено надстройками разделов» и перечнем «ресурс · заголовок». Каждый из них читается в
+   снимке и в новой редакции: что пакет дописал, дописывается в надстройку руками.
+
+Ни `doctor`, ни `sync --check` сами этого не сверяют: прежней редакции у них нет.
+
+По каждому названному разделу сверяются статьи, а не заголовки: заголовок как раз и совпал,
+этим раздел замещён. Готовая пара команд — в холодной части рядом.
+
+Дальше решение обычное: раздел, ради которого надстройка заводилась, остаётся замещённым, а
+раздел, чья причина ушла с исправленной редакцией, снимается — о том и говорит четвёртая строка
+предложения.
 
 ## Что пакет везёт, а что остаётся дереву
 
@@ -108,22 +147,20 @@ npx agent-kit propose       # отправить груз в приём: сво
 
 Слой правил правится не по памяти, а по тому, как им пользовались. Держится это тремя вещами.
 
-**Наблюдения** пишут сами гарды — в `.claude/rt-kit/observations/`, файлом на день. В строке
-имя ресурса пакета, род события, род правки, версия и признак сессии; путей дерева, имён его
-доменов и его собственного имени там нет. Выключаются ключом `"observe": false` в конфиге.
+**Наблюдения** пишут сами гарды — в `.claude/rt-kit/observations/`, файлом на день. В строке имя
+ресурса пакета, род события, род правки, версия и признак сессии; путей дерева и его имени там
+нет. Выключаются ключом `"observe": false` в конфиге.
 
 **Сводка** — `agent-kit stats`. Самая ценная её строка не «чем пользовались», а **что разложено
 и не загружено ни разу**: правило, которого никто не открыл, ничем себя не выдаёт.
 
 **Цена** — `agent-kit cost`. Сводка говорит, чем пользовались; цена — сколько это стоило: вес
-входа в работу, вес одного правила и вес всего слоя. Считается не файл, а то, что заход
-получает: описание приходит ему полем, словарь и карта хода — выводом хуков. Меряется в
-символах и байтах, на месте и без сети; чем считано, стоит в первой строке вывода, и число
-сравнимо только со снятым той же командой.
-
-**Предложения** приходят двумя путями. Разбор закрытой задачи — командой `/skill-curator` —
-приносит их пачкой, задним числом. Слово, сказанное посреди работы, кладёт командой `/feedback`
-сам агент: до неё такое слово адреса не получало вовсе и умирало вместе с сессией. Оба пути
+входа в работу, вес одного правила и вес всего слоя. Считается не файл, а то, что заход получает:
+описание приходит полем, словарь и карта хода — выводом хуков. Число сравнимо только со снятым
+той же командой.
+
+**Предложения** приходят двумя путями: разбор закрытой задачи — командой `/skill-curator` —
+приносит их пачкой, а слово, сказанное посреди работы, кладёт командой `/feedback` сам агент. Оба
 пишут в один файл дня и в одной форме; в сеть не ходит ни один — увозит их отправка.
 
 Каждая запись несёт четыре строки: **место** — куда правка встаёт в ресурсе, **повод** — что
@@ -132,17 +169,11 @@ npx agent-kit propose       # отправить груз в приём: сво
 снимаются, когда правка приедет редакцией пакета.
 
 Третья строка — единственная, которую проверяет машина: цитата ищется в ресурсе, и ненайденная
-отбивает блок. Ближайшего нет вовсе — так и пишется: «нет». Стоит она затем, чтобы ресурс был
-прочитан: разбор происшествия кончается предложением дописать статью в тот же ресурс, который
-промах уже описывал, и вторая статья о том же дороже, чем её отсутствие. Похожесть текстов сюда
-не годится — замер показал, что законное соседство двух статей одного правила и законный перенос
-удачной статьи на соседнее место дают одно и то же число. Отбитый блок остаётся лежать с
-отметкой «отбито» и причиной: видно, что разбор был, и видно, почему он не стал правкой.
-
-Четвёртая пишется затем, что предложение уезжает наружу, а
-надстройка остаётся лежать здесь: без неё дерево не может сказать, какие из его надстроек
-исправленная редакция закрыла, — снять наугад страшно, оставить дёшево, и надстройка остаётся
-навсегда, молча замещая исправленный раздел пакета. Снимать нечего — так и пишется; пустой
+отбивает блок. Ближайшего нет вовсе — так и пишется: «нет». Отбитый блок остаётся лежать с
+отметкой «отбито» и причиной: видно, что разбор был и почему он не стал правкой.
+
+Четвёртая пишется затем, что предложение уезжает наружу, а надстройка остаётся лежать здесь:
+без неё она замещает уже исправленный раздел навсегда. Снимать нечего — так и пишется; пустой
 четвёртая строка не бывает.
 
 Каждому предложению ставится адрес: «пакет», «компаньон» или «дерево». Выгружаются они файлом в `.claude/rt-kit/proposals/`
@@ -154,35 +185,37 @@ npx agent-kit propose       # отправить груз в приём: сво
 это выложено всему свету. Адрес приёма объявляется ключом `intake` в конфиге дерева, токен —
 ключом `token`, и лежит он вне дерева.
 
-**Отметка об отправке в файле предложения — след для человека, а не хранилище состояния.** Файл
-живёт в рабочем дереве, а дерево у каждой ветки своё: отметка, поставленная в одной ветке, в
-соседней не видна, и тот же текст уезжает вторым разом. Второй записью он при этом не
-становится — приём отбирает уже приехавшее по признаку предложения, и его ответ говорит,
-сколько записей легло и сколько уже лежало. Строка «принято 0, уже лежало 3» означает, что
-нового не уехало ничего.
+Оба значения приходят от владельца приёма, а не придумываются потребителем: адрес он называет, а токен выдаёт
+одноразовым кодом приглашения — код заводит дерево в приёме и кладёт токен в файл ключа `token`; выданный в админке
+кладётся тем же входом и в сеть не идёт. До приглашения отправка отказывает по устройству, а не по недонастройке.
+
+**Признак дерева считает отправитель, а не человек.** Он выводится из адреса репозитория, и
+запись в приёме заводится именно им: дерево, заведённое своим словом, приёмник не узнаёт и
+отвечает отказом на каждой отправке. Что уедет и под каким признаком, печатает прогон вхолостую —
+единственный способ узнать признак до заведения записи.
+
+**Отметка об отправке — след для человека, а не хранилище состояния: она говорит, что запись в
+приёме есть, а не что её положил этот вызов.** Чистое дерево после отправки значит, что весь
+груз в приёме уже лежал, а не что отправка не сработала.
 
 Разбирают их там, где лежат правимые ресурсы и видно всех потребителей сразу, — а сюда
 приезжает ответ приёма о том, сколько записей легло.
 
-**Имя файла предложения в текстах дерева не называется.** Каталог предложений в историю не едет:
-файл лежит на той машине, где его написали, и адрес на него ведёт в пустоту у всех остальных —
-проверка путей краснеет в каждом дереве, кроме одного, а читателю ссылка не даёт ничего.
-Написанное в разборе происшествия и в любом другом тексте репозитория говорит, кому предложение
-отправлено и о чём оно; ресурс пакета при этом называть можно — он в истории есть.
+**Имя файла предложения в текстах дерева не называется.** Читателю чужого дерева оно не даёт
+ничего, а там, где каталог остаётся на машине автора, ссылка ведёт в пустоту и проверка путей
+краснеет. Текст репозитория говорит, кому предложение отправлено и о чём оно; ресурс пакета
+при этом называть можно — он в истории есть.
 
-Предложение работу не выправляет. Оно лежит текстом, читается глазами и в контекст сам собой
-не приходит: замечание было прочитано, процитировано владельцу и нарушено в том же ходе —
-цитата не становится правилом от того, что её произнесли. Закрытым предложение считается,
-только войдя в ресурс пакета; до этого на него не ссылаются как на действующее требование и не
-считают дырку закрытой.
+Предложение работу не выправляет. Оно лежит текстом, читается глазами и в контекст сам собой не
+приходит; цитата не становится правилом от того, что её произнесли. Закрытым предложение
+считается, только войдя в ресурс пакета: до этого на него не ссылаются как на действующее
+требование и не считают дырку закрытой.
 
 **Слово владельца о предложении — «отправь», «заведи», «напиши пропозал» и любая другая форма
 того же — исполняется отправкой в тот же ход.** Сухой прогон отправкой не является: он
-показывает, что уехало бы, ничего не заводит и следа наружу не оставляет. Неудобна отправка
-ровно в одном месте — она пишет отметки в файлы предложений и делает дерево грязным; при
-открытом PR отметки ложатся вторым коммитом в ту же ветку, и это их место, а не повод
-отложить. Стережёт это гард предложения на завершении хода — там же, где стоит гард
-происшествия, и по той же причине.
+показывает, что уехало бы, ничего не заводит и следа наружу не оставляет. Отметки, которыми
+отправка пачкает дерево, ложатся вторым коммитом в ту же ветку — это их место, а не повод
+отложить. Стережёт это гард предложения на завершении хода.
 
 ## Установка туда, где уже всё своё
 
@@ -206,42 +239,32 @@ npx agent-kit propose       # отправить груз в приём: сво
 
 - **Молчание требованию не отвечает.** Дерево с пустым `has` не получает ни одного помеченного
   ресурса: положенный наугад, он вернётся пустым компаньоном, заполнить который нечем.
-- **Требование — не вид.** Вид отвечает на «какой из трёх» и выбирается один; свойств у дерева
-  сразу несколько, и дерево, которое публикует пакеты и держит приложение, называет оба.
-- **`only` сильнее требования.** Ресурс, названный поимённо, ложится и при неотвеченном
-  требовании; перечень раскладки называет это вслух, а отказ по его пустому компаньону зовёт
-  снять ресурс, а не заполнять черновик.
-- **Свойство, которого пакет не объявлял, роняет раскладку** — что в `has` дерева, что в имени
-  ресурса. Объявлены свойства перечнем при пакете, рядом с осями различия.
+- **Требование — не вид.** Вид выбирается один; свойств у дерева сразу несколько.
 
 ## Выключенная роль
 
-Роль, при которой стоит гард, зовётся не по усмотрению исполнителя: гард держит работу, пока
-роль не сказала своё. Дерево, которому такая роль в эту минуту мешает, называет её ключом
-`rolesOff` — именем файла роли без расширения.
+Роль, при которой стоит гард, зовётся не по усмотрению исполнителя: гард держит работу, пока роль
+не сказала своё. Дерево, которому она мешает, называет её ключом `rolesOff` — именем файла роли.
 
 ```json
 { "rolesOff": ["strict-teacher"] }
 ```
 
 - **Выключается обязательность вызова, а не роль.** Файл роли остаётся разложенным, и позвать её
-  руками можно в любую минуту. Список читают сами гарды — помощником, который лежит с ними
-  рядом; собственного объявления события у него нет, к действиям агента он не подключается.
+  руками можно в любую минуту. Список читают сами гарды — помощником, лежащим рядом с ними.
 - **От отказа ключом `skip` это отличается тем, что ничего не убирает.** Отказ не кладёт файл
   роли вовсе: звать становится некого, а гард при ней остаётся лежать и продолжает отбивать.
   Здесь наоборот — роль на месте, молчит гард.
-- **Настройка, которую не прочитать, роль не выключает.** Не нашлось `jq`, нет настройки, в
-  настройке сломан разбор — гард судит, как судил. Обратный выбор гасил бы слой правил молча, и
-  заметить это было бы нечем.
-- **Ключ, написанный не списком, ловит раскладка, а не гард.** Гарду виден только список имён:
-  строка вместо списка читается им как «роль включена», и роль работает, хотя дерево считает её
-  выключенной. Отказывает на этом разбор настройки — первой же раскладкой, называя ключ.
-- **Выключение живёт в настройке дерева, а не в настройке агента.** Строка, вырезанная из
-  настроек агента руками, теряется на первой же правке того файла, и вернуть роль будет нечем.
-  Здесь оно объявлено в одном месте и видно всякому, кто читает настройку дерева.
 
 ## Ловушки раскладки
 
+- **Запись файла командой оболочки судится по всем путям, названным в её теле.** Гейт вынимает
+  пути из текста команды, а тело документа читает целиком, как только в команде встречается имя
+  интерпретатора, — и строка запуска первой строкой записываемого файла возвращает его туда сама.
+  Строка импорта разложенного модуля требует тогда правило пакетного слоя наравне с правилом
+  самого файла, а требуется за раз одно: два отказа подряд, и каждый уносит уже написанное тело.
+  Инструмент правки судится одним своим путём и переписывать тело не заставляет; перенаправление
+  оболочки остаётся для того, что файлом дерева не станет.
 - **Своё, стоящее рядом с разложенным, повторяет его механику молча.** Проверка, гард и утилита
   дерева лежат в тех же каталогах, что и пакетные, а общий разбор списка известного, корни
   исходников, список пропускаемых каталогов и снимок долга приезжают модулем настройки проверок.
@@ -250,3 +273,12 @@ npx agent-kit propose       # отправить груз в приём: сво
   совпадение текста. Признак один, и он читается, а не ищется: до того как в своей проверке
   заводится разбор списка, чтение настройки или сравнение с накопленным, смотрят, что
   экспортирует модуль настройки проверок и чем живут соседние проверки.
+- **Правило, загруженное инструментом, бывает показано не целиком, и обрыв ничем не помечен.**
+  Длинный файл приезжает в контекст обрезанным по строке, а снаружи это выглядит концом: показанное
+  кончается осмысленным пунктом, и число разделов с оглавлением никто не сверяет. Бьёт обрыв ровно
+  по хвосту, а хвост — то место, где дерево отменяет умолчания пакета: разделы надстройки сливаются
+  по совпавшему заголовку и новыми уходят в конец. Заход, читавший правило до конца по своему
+  ощущению, исполнил пакетный образец буквально и открыл заявку черновиком там, где дерево
+  черновиков не держит вовсе. Отсюда порядок: решение о порядке работы принимается только после
+  того, как показанные строки сверены с длиной файла — одной командой, — а расходятся они, файл
+  дочитывается чтением.

package/assets/templates/postmortem.md

@@ -29,4 +29,8 @@
 ## Что ушло в слой правил
 
 <Предложение с адресом либо правка закона, правила, паттерна — с именами. Запись без этого
-раздела закрытой не считается: разбор, из которого ничего не вышло, — жалоба.>
+раздела закрытой не считается: разбор, из которого ничего не вышло, — жалоба.
+
+Предложение называется адресом и предметом — «в пакет, о таком-то», — а не путём к файлу
+предложений: каталог предложений в историю не едет, и путь у любого другого читателя ведёт в
+пустоту. Ресурс, к которому предложение написано, называть можно: он в истории есть.>

package/bin/agent-kit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-kit.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/bin/agent-kit.ts"],"names":[],"mappings":";AAeA,OAAO,EAAqC,iBAAiB,EAAqB,MAAM,oBAAoB,CAAC;AAwU7G,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAU9E"}
+{"version":3,"file":"agent-kit.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/bin/agent-kit.ts"],"names":[],"mappings":";AAeA,OAAO,EAAqC,iBAAiB,EAAqB,MAAM,oBAAoB,CAAC;AAoW7G,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAU9E"}