@rt-tools/agent-kit 0.8.3 → 0.9.0

package/assets/rules/task-flow.md

@@ -143,16 +143,37 @@ flowchart TD
   Открытый PR при этом читается как приглашение влить — поэтому незаконченная работа идёт
   черновиком, и владельцу не приходится спрашивать, кончилась ли она. Черновик снимается тем
   ходом, которым исполнитель говорит, что решение готово.
+- **Открытый PR остановкой не является.** Отданное на разбор ждёт владельца, а не исполнителя:
+  следующая задача берётся тем же движением, которым предыдущая ушла на разбор. Заход,
+  закрытый на готовой задаче, стоил владельцу целого захода на то, чтобы вернуть работу в
+  движение, — при том что порядок был назначен и лежал записанным в замысле эпика.
+- **Владельцу не предлагается выбор, чем заняться дальше, пока эпик не кончился.** Меню при
+  назначенном порядке — это просьба назначить его заново. Если работы в эпике не осталось, так
+  и говорится: эпик кончился, — а не «чем займёмся».
+- **Гард замысла — нижняя граница требования, а не его предел.** Он требует папку только под
+  правку кода приложения, и работа, которая туда не доходит, проходит мимо него — но папку
+  заводит всё равно: статья правила говорит «под любую работу, без исключений». Прочитанный
+  как признак, гард становится разрешением работать без замысла везде, куда он не смотрит.
+- **Ход, сообщающий владельцу о чужом шаге, называет своё следующее действие и начинает его.**
+  Прогон, разбор владельцем и слияние идут без исполнителя и быстрее от взгляда не становятся,
+  поэтому сообщение о них — не работа, а сводка. Ход, кончившийся такой сводкой, владелец
+  читает как работу: она полна, в ней названы номера и состояния, и пустоты за ней не видно.
+  Открытый PR, красный прогон и ожидание слова владельца — случаи одного и того же, и правило
+  у них одно: о чужом шаге говорят вместе с начатым своим, а не вместо него. За один заход это
+  было нарушено четырежды, и готовая работа простояла в невлитом PR почти три часа, пока
+  исполнитель отвечал владельцу сводками о её состоянии.
 - **Пока PR ждёт разбора, исполнитель берёт следующую задачу.** Ожидание чужого шага заходом
   не занимают: работа уходит на разбор, и тем же движением берётся следующая. Готовым к
   слиянию прежний PR становится не сам — его доводит до готовности исполнитель, вернувшись к
   нему тем же ходом, которым прочитал конец прогона.
-- **Ход, в котором открыт PR, стережёт гард ожидания, а не память исполнителя.** Он отбивает
-  завершение хода, в котором не было ни одного действия по следующей задаче — заведения задачи,
-  ветки, папки или перевода колонки. Признак берётся из самого хода: спросить хостинг об
-  открытых PR было бы точнее, но сетевой вызов на завершении хода падает вместе со связью и
-  отбивал бы работу вместо промаха. Слова «беру следующую задачу» гард действием не считает —
-  ровно потому, что их и произносят вместо неё.
+- **Ход о чужом шаге стережёт гард ожидания, а не память исполнителя.** Он отбивает завершение
+  хода, в котором о чужом шаге сказано, а по следующей задаче не сделано ни одного действия —
+  ни заведения задачи, ни ветки, ни папки, ни перевода колонки. Чужой шаг он узнаёт по двум
+  признакам: в ходе открыт PR либо в ходе прочитан красный прогон. Оба берутся из самого хода:
+  спросить хостинг было бы точнее, но сетевой вызов на завершении хода падает вместе со связью
+  и отбивал бы работу вместо промаха, а вывод команды о прогоне в записи хода уже лежит. Слова
+  «беру следующую задачу» гард действием не считает — ровно потому, что их и произносят вместо
+  неё.
 - **Конец прогона узнаётся возвратом фоновой команды, а не взглядом на страницу.** Ожидание,
   запущенное в фоне отдельным ходом, возвращает исполнителя к PR само; до тех пор ход занят
   следующей задачей. Взгляд на страницу этого не даёт: он либо повторяется вхолостую, либо не
@@ -171,7 +192,16 @@ flowchart TD
 - **Действия, которые исполнитель не делает без слова владельца, перечислены в компаньоне
   правила.** Список у каждого дерева свой — пакет знает только требование, чтобы список был
   назван. Не названный, он выводится из общих слов, и «делай, что нужно по плану» становится
-  разрешением на пуш и правку общих документов заодно с коммитом.
+  разрешением на пуш и правку общих документов заодно с коммитом. Оценка «это безопасно» списка
+  не заменяет: её назначает тот, кому она в эту минуту удобна, и она плывёт. За один заход одна
+  и та же команда была сначала слишком опасной, чтобы её позвать, а через два хода —
+  достаточно безопасной, чтобы позвать без спроса.
+- **У отказа от необратимого действия есть безопасная часть, и она делается.** Требование
+  спросить владельца относится к действию, а не к ходу: работа, у которой отделима часть без
+  последствий, делится, а не откладывается целиком. Список вариантов, поданный вместо работы,
+  читается как работа — тем полнее, чем аккуратнее он составлен: он пронумерован, в нём названы
+  цифры, и именно поэтому пустота хода за ним не видна. Владельцу называется, что уже сделано и
+  что осталось за его словом, — а не выбор из вариантов вместо и того и другого.
 - **Ход, в котором исполнитель признал промах, не заканчивается, пока записи о происшествии
   нет.** Отбивает гард происшествия — на завершении хода: к моменту признания промах уже
   случился, и ловить раньше нечего. Признание ловится набором образцов, а не пониманием смысла;
@@ -202,6 +232,16 @@ flowchart TD
   говорит, что эпик есть, но порядка задач не держит; папка задачи держала бы его ровно до
   слияния первой из них. Каталог для замысла называет компаньон правила: у пакета своего пути
   нет, а замысел, положенный каждым заходом заново, теряет решения предыдущих.
+- **Сборка по образцу начинается с чтения самого образца, а не пересказа о нём.** Пересказ
+  лежит в разборе просьбы и в замысле эпика; читаются они оба, но образцом не считаются. Часть
+  образца, которую работа повторяет, открывается целиком — обходом каталогов, а не одним файлом,
+  за которым пришли. Расхождение, не найденное так, находит владелец на приёмке целой работой.
+- **Путь к образцу лежит вне дерева и приходит в заход хуком запуска сессии.** Имя чужого
+  дерева в файлы репозитория не пишется, поэтому ни замысел эпика, ни разбор просьбы его не
+  держат: там законна ссылка без имени — «путь к образцу лежит вне дерева». Каталог для записи
+  — тот же, где лежит передача захода; называет его компаньон правила. Не записанный так,
+  образец теряется на первой же чистке контекста, и следующий заход собирает по памяти
+  предыдущего.
 - **Закрытая работа разбирается правилами, и это шаг закрытия, а не отдельная просьба.** Что
   грузилось, что помогло и чего не хватило, видно только тому заходу, который работу вёл; через
   сутки этого нет ни у кого. Разбор кончается правкой слоя правил или предложением наружу —

package/assets/rules/testing.md

@@ -126,6 +126,19 @@ flowchart TD
   сценария в заголовке стоит — сценарий числится покрытым, а что именно утверждается, не
   спрашивает никто. Тело читается вместе с заголовком: обещание в заголовке и утверждение в
   теле — два разных текста, и расходятся они молча.
+- **Растр браузера называется явно, иначе кадр не сходится сам с собой.** Профиль цвета, взятый
+  у дисплея машины, ускоритель, считающий растр, и дорисовка кусками — каждый из трёх двигает
+  цвет на единицу-другую по каналу, и видно это только там, где смешение стоит на границе
+  округления: на сглаженных уголках тёмной темы. Ожидание вставшего кадра тут не помогает —
+  страница нарисована, а нарисована она каждый раз чуть иначе; расхождение гуляет по кадру,
+  приходит примерно раз в четыре прогона и на светлых экранах не показывается вовсе, поэтому
+  читается случайным. Все три называются доводами браузеру при запуске и становятся частью
+  эталона.
+- **Маска закрывает содержимое, но не ширину.** Узел под маской занимает своё место в раскладке
+  по-прежнему, и плывущее значение внутри него двигает соседей мимо маски: кадр списка уезжал на
+  пиксель целиком, включая столбцы, где не менялось ничего. Там, где размер узла считается по
+  содержимому — ячейка таблицы, надпись, растягивающая кнопку, — плывущее лечится в данных
+  стенда постоянным значением, и тогда маска не нужна вовсе.
 
 ## Чего из закона здесь нет
 
@@ -186,3 +199,21 @@ flowchart TD
   соревнуется за машину с тем, что снимают, и делает исход прогона зависящим от того, чем занят
   сосед. Нагрузка, которую задание создаёт себе само — соседняя витрина, только что законченная
   сборка, — ничем не отличается от чужой.
+- **Свой стенд снимается перед тем, как звать набор.** Прогон переиспользует поднятое на его
+  портах, и стенд, оставленный для замера, отдаёт ему чужую сборку с чужими данными. Красное при
+  этом приходит не строкой про занятый порт, а десятком спек про экраны — то есть выглядит
+  дефектом правки: за один заход так покраснели сначала шесть новых тестов, потом гейт пуша, и
+  оба раза причиной был свой же стенд. Разобранный занятый порт эту сторону не закрывает: он про
+  чужой стенд, а этот — про свой.
+- **Разбор упавшего кадра начинается с чисел, а не с картинки расхождения.** Доля площади
+  говорит, сколько разошлось, и молчит о том, что именно: сдвиг всего кадра на пиксель,
+  переставленные строки и рябь на сглаженных уголках выглядят на картинке одинаково — «стало
+  другим». Читаются координаты разошедшихся точек и величина расхождения по каналу: сдвинутые
+  границы блоков — это раскладка, разошедшийся текст при неподвижных границах — это данные,
+  единица-две по каналу на кривых краях — это цвет. Три расхождения одного набора разобрались
+  ровно так, и ни одно из трёх не оказалось дефектом экрана.
+- **Ожидаемое значение теста не берётся из кода, который тест проверяет.** Вывезенное из
+  проверяемой либы, оно делает тест зелёным при любом значении: «колесо показывает пять строк»
+  сходится и тогда, когда строк стало три. Ожидаемое пишется числом в самой спеке рядом с
+  проверкой, а общий модуль сквозных спек держит приёмы — открыть, дождаться, снять со
+  страницы, — но не то, что от страницы ожидается.

package/assets/rules/typescript-conventions.md

@@ -59,6 +59,13 @@ flowchart TD
   остального. Для `.ts` это держит правило линтера; файлы обвязки — сценарии и скрипты — до
   него не доходят и судятся отдельной проверкой дерева. Накопленное к дню включения
   перечислено поимённо, и строка оттуда снимается вместе с делением своего файла.
+- **Значение из закрытого набора приходит перечислением `E<Имя>`, а не строкой или числом в
+  месте использования.** Ключ переводимого поля, имя вкладки, слот обложки, вид записи — всё
+  это наборы: их называют форма, стор, разметка и сравнение черновиков, и написанное на месте
+  значение ни находится по дереву, ни правится разом. Перечисление живёт в слое `util` того
+  домена, чей это набор, а общее нескольким приложениям — в общей либе. Одиночный адрес,
+  разделитель и знак-подпись перечислением не становятся: закрытого набора у них нет, и они
+  объявляются константой файла с говорящим именем.
 - **Тип берётся из того пакета, где объявлен.** Своя копия чужого типа расходится с оригиналом
   молча, а компилируется из них только одна.
 - **Двухступенчатое приведение `as unknown as` запрещено правилом линтера.** Вместо него —

package/assets/skills/agent-kit.md

@@ -79,6 +79,14 @@ npx agent-kit propose       # отправить груз в приём: сво
 сам агент: до неё такое слово адреса не получало вовсе и умирало вместе с сессией. Оба пути
 пишут в один файл дня и в одной форме; в сеть не ходит ни один — увозит их отправка.
 
+Каждая запись несёт три строки: **место** — куда правка встаёт в ресурсе, **повод** — что пошло
+не так без неё, и **чем закрывается** — какие надстройки и добавки этого дерева снимаются, когда
+правка приедет редакцией пакета. Третья пишется затем, что предложение уезжает наружу, а
+надстройка остаётся лежать здесь: без неё дерево не может сказать, какие из его надстроек
+исправленная редакция закрыла, — снять наугад страшно, оставить дёшево, и надстройка остаётся
+навсегда, молча замещая исправленный раздел пакета. Снимать нечего — так и пишется; пустой
+третья строка не бывает.
+
 Каждому предложению ставится адрес: «пакет», «компаньон» или «дерево». Выгружаются они файлом в `.claude/rt-kit/proposals/`
 (форма — шаблон `proposal.md`), а `agent-kit propose` увозит в приём те, что адресованы
 пакету, вместе со сводкой и разборами происшествий. Адрес дерева в сводке или в тексте
@@ -150,6 +158,26 @@ npx agent-kit propose       # отправить груз в приём: сво
 
 ## Ловушки
 
+- **Надстройка замещает раздел целиком, и пакетные пункты в нём приходится держать копией.**
+  Дописать в раздел одну статью нечем: слияние идёт по заголовку `## `. Дерево, которому нужен
+  один свой пункт, копирует к нему все пакетные — и с этого дня правка любого из них,
+  приехавшая с новой версией, до этого дерева не доходит. Сверка разложенного молчит: она
+  считает расхождением правку на месте, а не замещённый раздел. Признак виден по самим
+  надстройкам — три из трёх прочитанных кончались абзацем о том, что перенос придётся делать
+  руками. Поэтому надстройкой берут раздел, у которого пакетных пунктов немного, а разросшийся
+  замещённый раздел — повод внести своё в пакет, а не держать его копией. Предложение, которым
+  своё вносят, называет эту надстройку строкой «чем закрывается»: иначе приехавшая редакция и
+  надстройка, которую она закрыла, не сопоставляются ничем, и надстройка остаётся замещать уже
+  исправленный раздел.
+
+- **Готовый код пакета не называет имён одного дерева.** Префикс директив кита, ключи подписей
+  и имена сущностей принадлежат тому дереву, где паттерн писали; разложенные в соседнем, они
+  учат звать то, чего там нет вовсе. Имя директивы при этом отличается от имени в примере: по
+  примеру видно, что он пример, а `<префикс>TableRow` из чужого дерева выглядит рабочим кодом
+  и правится только после того, как продовая сборка упадёт. Тринадцать таких имён простояли в
+  четырёх ресурсах пакета, пока их не нашёл потребитель — и не своей сборкой, а надстройкой,
+  которой перекрыл раздел.
+
 - **Правила и паттерны при отвергнутом законе в отказе не перечисляются.** Их снимает каскад, а
   строка на них становится выводимой: раскладка называет её лишней вместе с законом, из-за
   которого она перестала снимать. Отказ мерит слой законов, а не число файлов в пакете.
@@ -168,6 +196,14 @@ npx agent-kit propose       # отправить груз в приём: сво
   конструкции не видит: `case` теряет свою `esac`, файл остаётся синтаксически неверным, а
   гард с ошибкой синтаксиса отвечает ненулевым кодом — то есть «правка отбита». Два раза за
   заход, и оба раза это выглядело дефектом самого гарда.
+- **Гард, подписанный не на то, что объявляет, выглядит работающим.** Событие и образец вызова
+  гард несёт сам, строкой `# rt-hook:`, а зовёт его образец в настройке агента — и эти двое
+  расходятся молча: путь гарда в настройке назван, файл разложен, набор сценариев зелёный.
+  Набор тут ничего не ловит намеренно — он зовёт гард напрямую с подставленным вводом и
+  объявления не читает вовсе. Так гейт правил и разбирал вызовы браузера веткой, которая не
+  исполнялась ни разу. Расхождение находит сверка раскладки: она сравнивает объявленный образец
+  с тем, под которым гард стоит, называет обе стороны и идёт в счёт расхождений. Правится
+  настройка, а верное значение лежит в гарде — тело его разбирает то, что объявлено.
 - **Разложенный файл узнаётся по шапке, а не по каталогу.** Раскладка ложится в те же
   `tools/`, `.claude/hooks/` и `.claude/skills/`, где лежит своё, поэтому карта гейта,
   написанная по путям, требует под него доменное правило — а оно уводит править файл на месте.

package/assets/templates/proposal.md

@@ -21,12 +21,32 @@
 В тексте предложения не бывает ни путей этого дерева, ни имён его доменов, ни его собственного
 имени: файл уезжает в чужой репозиторий целиком. Найденный адрес дерева отбивает отправку с
 номером строки — это проверка, а не напоминание.
+
+Строк при заголовке три, и все три обязательны:
+
+    место          — куда правка встаёт в ресурсе
+    повод          — что пошло не так без неё
+    чем закрывается — какие надстройки и добавки этого дерева снимаются, когда правка приедет
+                      редакцией пакета
+
+Третья пишется затем, что предложение уезжает наружу, а надстройка, ради которой оно написано,
+остаётся лежать в дереве, и связи между ними нет никакой. Пакет выпускает исправленную редакцию
+— и сказать, какие надстройки она закрыла, дереву нечем: имя ресурса совпадает у десятка
+предложений, а раздел надстройки называется тем же заголовком, что и пакетный. Снять наугад
+страшно, оставить дёшево — и надстройка остаётся навсегда, молча замещая исправленный раздел
+пакета.
+
+Снимать нечего — так и пишется: «ничего, надстройки под это нет». Пустая строка третьей не
+считается; машине она не видна вовсе — ни одна проверка тела предложения не читает, и держится
+эта форма тем, кто пишет запись.
 -->
 
 ## пакет · rules/<правило>.md
 
 - **место:** раздел «<заголовок>», в конец
 - **повод:** что в этой задаче пошло не так без этого правила
+- **чем закрывается:** `.claude/rt-kit/overrides/rules/<правило>.md`, раздел «<заголовок>» —
+  снимается целиком, когда правка приедет редакцией пакета
 
 > Готовый текст правки — ровно то, что вставить, в стиле соседних правил: по-русски,
 > утверждением, без воды.
@@ -35,5 +55,6 @@
 
 - **место:** ветка `edit`, рядом с соседним родом файлов
 - **повод:** свой род файлов, которого у других деревьев нет
+- **чем закрывается:** ничего, надстройки под это нет — правка и есть надстройка
 
 > Готовый текст правки.

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;AAqM7G,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAsE9E"}
+{"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;AA4S7G,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAU9E"}

package/bin/agent-kit.js

@@ -13,8 +13,10 @@ import process from 'node:process';
 import { unknownFlagsIn } from '../lib/argv.js';
 import { readCatalog, resolveSelection } from '../lib/catalog.js';
 import { adopt, doctor, init, list, stats, sync } from '../lib/commands.js';
+import { CONFIG_PATH, readConfig } from '../lib/config.js';
+import { enroll, httpEnroll } from '../lib/enroll.js';
 import { httpShip } from '../lib/ship.js';
-import { propose } from '../lib/shipment.js';
+import { propose, treeSlugOf } from '../lib/shipment.js';
 import { DEFAULT_DAYS } from '../lib/observations.js';
 import { staleBuild } from '../lib/freshness.js';
 import { packageRootFrom } from '../lib/package-root.js';
@@ -34,6 +36,8 @@ const USAGE = [
     '  propose         отправить груз в приём: сводку со снимком надстроек, предложения и разборы',
     '  propose --dry-run   показать, что уехало бы, и ничего не отправлять',
     '  adopt [файлы]   отдать пакету файлы, лежащие на его путях не от него',
+    '  enroll --code <код>  завести дерево по приглашению владельца и положить его токен',
+    '  enroll --force       перезаписать уже лежащий токен намеренно',
     '',
     '  --root <путь>   корень проекта; по умолчанию текущий каталог',
     '',
@@ -79,6 +83,7 @@ function environmentOf(root) {
 /** Чем это дерево себя выдаёт снаружи. Нет удалённого репозитория — нечем, и это не отказ. */
 function remoteOf(root) {
     try {
+        // eslint-disable-next-line sonarjs/no-os-command-from-path -- путь к git у каждой машины свой, и прибитый здесь сделал бы пакет непереносимым
         return execFileSync('git', ['-C', root, 'remote', 'get-url', 'origin'], {
             encoding: 'utf8',
             stdio: ['ignore', 'pipe', 'ignore'],
@@ -137,39 +142,36 @@ async function selectionFor(argv, assetsDir) {
  * отказ там означал бы, что пакет нельзя разложить без человека. Первый вид — умолчание, а не
  * догадка: порядок в объявлении оси и есть порядок предпочтения.
  */
+async function variantOfAxis(axis, argv) {
+    const spoken = optionOf(argv, `--${axis.name}`, '');
+    const values = axis.options.map((option) => option.value);
+    if (spoken) {
+        return values.includes(spoken)
+            ? spoken
+            : {
+                code: 1,
+                lines: [`такого вида по оси «${axis.name}» пакет не везёт: ${spoken}`, `есть: ${values.join(', ')}`],
+            };
+    }
+    if (argv.includes('--all')) {
+        return axis.options[0]?.value ?? '';
+    }
+    if (!canAsk()) {
+        return {
+            code: 1,
+            lines: ['спросить некого: запуск без терминала', `назови вид флагом \`--${axis.name} <вид>\`: ${values.join(', ')}`],
+        };
+    }
+    return askOne(axis.options.map((option) => ({ id: option.value, name: option.value, title: option.title })), axis.question);
+}
 async function variantsFor(argv, assetsDir) {
     const axes = readAxes(assetsDir);
     const chosen = {};
     for (const axis of axes) {
-        const spoken = optionOf(argv, `--${axis.name}`, '');
-        const known = (value) => axis.options.some((option) => option.value === value);
-        if (spoken) {
-            if (!known(spoken)) {
-                return {
-                    code: 1,
-                    lines: [
-                        `такого вида по оси «${axis.name}» пакет не везёт: ${spoken}`,
-                        `есть: ${axis.options.map((option) => option.value).join(', ')}`,
-                    ],
-                };
-            }
-            chosen[axis.name] = spoken;
-            continue;
-        }
-        if (argv.includes('--all')) {
-            chosen[axis.name] = axis.options[0]?.value ?? '';
-            continue;
+        const answer = await variantOfAxis(axis, argv);
+        if (isOutcome(answer)) {
+            return answer;
         }
-        if (!canAsk()) {
-            return {
-                code: 1,
-                lines: [
-                    'спросить некого: запуск без терминала',
-                    `назови вид флагом \`--${axis.name} <вид>\`: ${axis.options.map((option) => option.value).join(', ')}`,
-                ],
-            };
-        }
-        const answer = await askOne(axis.options.map((option) => ({ id: option.value, name: option.value, title: option.title })), axis.question);
         if (answer === null) {
             return null;
         }
@@ -177,68 +179,94 @@ async function variantsFor(argv, assetsDir) {
     }
     return chosen;
 }
+/** Заведение настройки: выбор ресурсов и видов, брошенный выбор ничего не пишет. */
+async function runInit(env, argv) {
+    const selection = await selectionFor(argv, env.assetsDir);
+    if (isOutcome(selection)) {
+        return selection;
+    }
+    if (selection === null) {
+        return { code: 1, lines: ['выбор брошен — ничего не заведено'] };
+    }
+    const variants = await variantsFor(argv, env.assetsDir);
+    if (isOutcome(variants)) {
+        return variants;
+    }
+    return variants === null
+        ? { code: 1, lines: ['выбор брошен — ничего не заведено'] }
+        : init(env.root, selection, variants, env.assetsDir);
+}
+/** Сводка наблюдений: отрезок из флага, сегодняшний день — с края. */
+function runStats(env, argv) {
+    const spoken = Number(optionOf(argv, '--days', ''));
+    return stats(env, {
+        days: Number.isFinite(spoken) && spoken > 0 ? Math.floor(spoken) : DEFAULT_DAYS,
+        // Сегодняшний день берётся здесь: у команды своих часов нет, иначе сводку за
+        // отрезок не проверить спекой — вчерашняя фикстура завтра станет позавчерашней.
+        today: new Date().toISOString().slice(0, 10),
+        json: argv.includes('--json'),
+    });
+}
+/**
+ * Отправка накопленного.
+ *
+ * Единственное действие этой команды необратимо и уходит наружу, поэтому незнакомый довод её
+ * кончает, а не пропускается молча: вызов ради списка режимов отправил в приём всё накопленное, и
+ * по выводу это не отличалось от «команда ничего не сделала». Прочие команды такого разбора не
+ * знают — их действие обратимо.
+ */
+async function runPropose(env, argv) {
+    const unknown = unknownFlagsIn(argv.slice(1), PROPOSE_FLAGS);
+    if (unknown.length) {
+        return {
+            code: 1,
+            lines: [`таких доводов у \`propose\` нет: ${unknown.join(', ')}`, '', ...PROPOSE_USAGE],
+        };
+    }
+    return propose(env, {
+        dryRun: argv.includes('--dry-run'),
+        ship: httpShip,
+        remote: remoteOf(env.root),
+        // Отрезок тот же, что у сводки по умолчанию: отправку зовут по свежей задаче.
+        days: DEFAULT_DAYS,
+        today: new Date().toISOString().slice(0, 10),
+    });
+}
+/** Приписка дерева к приёмнику по коду приглашения. */
+async function runEnroll(env, argv) {
+    const config = readConfig(env.root);
+    if (!config) {
+        return { code: 1, lines: [`настройки дерева нет: ${CONFIG_PATH}. Заведите её командой \`init\``] };
+    }
+    return enroll({
+        root: env.root,
+        intake: config.intake,
+        code: optionOf(argv, '--code', ''),
+        tree: treeSlugOf(remoteOf(env.root), config.tree),
+        token: config.token,
+        force: argv.includes('--force'),
+        call: httpEnroll,
+    });
+}
+/** Что делает каждая команда строки запуска. Ключ — слово, которым её зовут. */
+const COMMANDS = {
+    init: runInit,
+    list: (env) => list(env),
+    sync: (env, argv) => sync(env, argv.includes('--check')),
+    stats: runStats,
+    propose: runPropose,
+    enroll: runEnroll,
+    doctor: (env) => doctor(env),
+    adopt: (env, argv) => adopt(env, argv.slice(1).filter((value) => !value.startsWith('--') && value !== optionOf(argv, '--root', ''))),
+};
 export async function main(argv) {
     const command = argv[0] ?? '';
     const env = environmentOf(resolve(optionOf(argv, '--root', process.cwd())));
-    switch (command) {
-        case 'init': {
-            const selection = await selectionFor(argv, env.assetsDir);
-            if (isOutcome(selection)) {
-                return selection;
-            }
-            if (selection === null) {
-                return { code: 1, lines: ['выбор брошен — ничего не заведено'] };
-            }
-            const variants = await variantsFor(argv, env.assetsDir);
-            if (isOutcome(variants)) {
-                return variants;
-            }
-            return variants === null
-                ? { code: 1, lines: ['выбор брошен — ничего не заведено'] }
-                : init(env.root, selection, variants, env.assetsDir);
-        }
-        case 'list':
-            return list(env);
-        case 'sync':
-            return sync(env, argv.includes('--check'));
-        case 'stats': {
-            const spoken = Number(optionOf(argv, '--days', ''));
-            return stats(env, {
-                days: Number.isFinite(spoken) && spoken > 0 ? Math.floor(spoken) : DEFAULT_DAYS,
-                // Сегодняшний день берётся здесь: у команды своих часов нет, иначе сводку за
-                // отрезок не проверить спекой — вчерашняя фикстура завтра станет позавчерашней.
-                today: new Date().toISOString().slice(0, 10),
-                json: argv.includes('--json'),
-            });
-        }
-        case 'propose': {
-            // Единственное действие этой команды необратимо и уходит наружу, поэтому незнакомый
-            // довод её кончает, а не пропускается молча: вызов ради списка режимов отправил в
-            // приём всё накопленное, и по выводу это не отличалось от «команда ничего не
-            // сделала». Прочие команды такого разбора не знают — их действие обратимо.
-            const unknown = unknownFlagsIn(argv.slice(1), PROPOSE_FLAGS);
-            if (unknown.length) {
-                return {
-                    code: 1,
-                    lines: [`таких доводов у \`propose\` нет: ${unknown.join(', ')}`, '', ...PROPOSE_USAGE],
-                };
-            }
-            return propose(env, {
-                dryRun: argv.includes('--dry-run'),
-                ship: httpShip,
-                remote: remoteOf(env.root),
-                // Отрезок тот же, что у сводки по умолчанию: отправку зовут по свежей задаче.
-                days: DEFAULT_DAYS,
-                today: new Date().toISOString().slice(0, 10),
-            });
-        }
-        case 'doctor':
-            return doctor(env);
-        case 'adopt':
-            return adopt(env, argv.slice(1).filter((value) => !value.startsWith('--') && value !== optionOf(argv, '--root', '')));
-        default:
-            return { code: command ? 1 : 0, lines: command ? [`неизвестная команда «${command}»`, '', ...USAGE] : USAGE };
+    const run = Object.hasOwn(COMMANDS, command) ? COMMANDS[command] : undefined;
+    if (!run) {
+        return { code: command ? 1 : 0, lines: command ? [`неизвестная команда «${command}»`, '', ...USAGE] : USAGE };
     }
+    return run(env, argv);
 }
 const outcome = await main(process.argv.slice(2));
 for (const line of outcome.lines) {