@rt-tools/agent-kit 0.11.0 → 0.12.0

package/assets/commands/rules-review.md

@@ -1,98 +0,0 @@
----
-description: Смысловое ревью семьи текстов слоя правил — закон, его правила и паттерны при них
-argument-hint: '<имя закона>'
----
-
-Прогони смысловое ревью одной семьи текстов пакета правил. Семья: `$ARGUMENTS`
-
-Зовётся **в репозитории самого пакета**, а не в дереве, где он стоит: судятся исходные тексты
-ресурсов, и лежат они только здесь. В чужом дереве лежит разложенная копия выбранных ресурсов, а
-не семья целиком, и путей, по которым команда ходит, в нём нет вовсе: обход по ним вернёт
-пустоту, неотличимую от «такого закона не бывает». Каталог ресурсов ниже назван так, как он
-зовётся в репозитории пакета.
-
-Считаемое ловит проверка полноты текстов — недостающий раздел, правило без паттерна, имя соседа,
-которому в наборе ничего не отвечает. Здесь ищется то, чего она не считает: два текста,
-говорящих об одном разное, и случай, которого не назвал ни один. Ответ роли не повторяется от
-запуска к запуску, поэтому в гейт он не идёт и ветку не отбивает.
-
-## 1. Пойми, какая семья
-
-Семья зовётся именем закона — без пути и без расширения: `work-conduct`, `delivery`,
-`project-documentation`.
-
-```bash
-ls projects/agent-kit/assets/laws/*.md projects/agent-kit/assets/laws/*/*.md
-```
-
-**Имени нет** — назови человеку перечень имён и остановись. Догадываться по похожести нельзя:
-ревью уйдёт на чужую семью, и его находки человек примет за находки о своей.
-
-**Названо несколько** — гони по одной, по очереди, и ответы не смешивай: находка семьи читается
-вместе с её законом, а сваленные в кучу они теряют адрес.
-
-**Довода нет вовсе** — потребуй имя и напечатай перечень. Умолчания здесь нет: «первый
-попавшийся закон» даёт прогон, неотличимый от осмысленного.
-
-**Закон лежит в слое приложения** — это законный случай, а не промах: у денег, локалей и доступа
-семья такая же. Читается он оттуда же, где лежит.
-
-## 2. Собери семью
-
-Правило принадлежит закону полем `law:`, паттерн правилу — полем `rule:`. Приставка имени
-ненадёжна: её несут не все паттерны.
-
-```bash
-LAW=<имя закона>
-grep -l "^law: $LAW\$" projects/agent-kit/assets/rules/*.md
-```
-
-Дальше по каждому найденному правилу — его паттерны. Имя правила для поиска берётся голым: без
-вида и без требования — оба стоят суффиксами в имени файла, а поле `rule:` у паттерна несёт
-только само имя.
-
-```bash
-RULE=<имя правила: первое слово имени файла, до первой точки>
-grep -l "^rule: $RULE\$" projects/agent-kit/assets/patterns/*.md
-```
-
-**Виды берутся все.** `git-workflow.github`, `git-workflow.gitlab`, `git-workflow.azure` — три
-редакции одного правила: дерево раскладывает одну, а расходятся они молча.
-
-**Суффикс требования — не вид.** `entity-conventions.needs-admin`, `observability.needs-app` —
-это правила, которые дерево берёт, только когда объявило нужную черту. Имя с этим суффиксом в
-поле `rule:` не стоит ни у одного паттерна: поиск по нему возвращает пустоту, и семья уезжает в
-ревью без паттернов вовсе — молча, потому что пустой ответ выглядит как «паттернов нет».
-
-**У закона нет ни одного правила** — скажи это человеку и остановись. Читать один закон нечем:
-расхождение живёт между двумя текстами, а пробел уровня статьи без правил под ней — не находка
-ревью, а отсутствие целого слоя. Сам по себе такой закон стоит разговора: его находит и проверка
-полноты текстов, и она же скажет, сколько их.
-
-## 3. Запусти роль
-
-Инструментом `Agent`, `subagent_type: 'rules-reviewer'`. В промпт — имя закона и полный список
-путей: закон, все его правила со всеми видами, все паттерны при них. Список собираешь ты: роль
-git-команд не зовёт и историю не читает.
-
-Одна роль на семью. Веер из нескольких ролей со сведением ответов здесь не заводится: взгляд на
-предмет один — два текста об одном говорят разное, — а сведение превращает дословные цитаты в
-пересказ.
-
-## 4. Покажи находки человеку
-
-**Как есть.** Роль возвращает цитаты дословно, и пересказ их портит: по пересказу человек не
-отличит настоящее расхождение от прочтения роли.
-
-Порядок сохрани: сперва расхождения — у каждого два места и две цитаты, — потом пробелы, у
-которых второго места нет.
-
-По каждой находке скажи своё: согласен или нет и почему. Правку не вноси — тексты правил
-действуют на все будущие сессии всех деревьев, и решает по ним человек.
-
-Находка, с которой человек согласился, идёт дальше двумя путями, и выбирает он:
-
-- **правится тут же** — если это правка текста пакета и она укладывается в текущую работу;
-- **уходит задачей** в очередь работ — если тянет за собой код, раскладку или другой закон.
-
-Пустой ответ роли — тоже результат: скажи, что находок нет, и не выдумывай их из вежливости.

package/assets/patterns/cargo-triage-mark.md

@@ -1,119 +0,0 @@
----
-name: cargo-triage-mark
-kind: pattern
-rule: cargo-triage
-description: Паттерн правила cargo-triage. Брать при разборе приехавшего груза — готовые вызовы отметки: сухой прогон, пачка записей за вызов, приём починки при переходе в готово, версия выпуска при выпуске, разбор отбитой строки. Не брать для сведения предложений в правки пакета — это своя команда.
----
-
-# Отметка записей груза
-
-Паттерн правила `cargo-triage`. Что при этом должно быть верно — закон
-`docs/constitution/work-conduct.md`.
-
-Вызовы ниже идут строкой запуска самого пакета и токеном дерева: токен лежит вне дерева, и без
-него команда отбивает вызов, не ходя в сеть.
-
-## Когда брать
-
-- Разбирается приехавший груз, и по записи принято решение.
-- Правка по записи влита в главную ветку.
-- Опубликована редакция, увёзшая починку к потребителю.
-- Вызов отметки вернул отбитую строку.
-
-## Что читается раньше вызова
-
-Список неразобранного — в админке приёма, отбором по состоянию «новое» и порядком приезда.
-Пока список не сужен, разобранное и нетронутое стоят вперемешку, и разбор идёт по второму
-кругу.
-
-Имя команды, адрес приёма и слова состояний у каждого дерева свои — они названы в
-`implementation.md` правила. Ниже они стоят так, как их зовёт пакет.
-
-## Взятие в работу: задача и отметка одним ходом
-
-Сначала задача — иначе отметка говорит, что запись взяли, и молчит о том, где идёт работа:
-
-```bash
-npm run task:new -- --title '<что не так>' --slug <короткое-имя> --label bug < тело.md
-```
-
-Отметка идёт следом, тем же ходом, и несёт все записи, которые эта задача закрывает:
-
-```bash
-npx agent-kit mark --state in_work \
-    --postmortem 2026-08-14-structure-invented-beside-the-sample.md \
-    --postmortem 2026-08-15-guard-denied-shell-wrote-anyway.md \
-    --proposal <признак предложения>
-```
-
-Род записи называется своим доводом: разбор происшествия — именем файла, предложение —
-признаком текста. Записи обоих родов едут одним вызовом.
-
-Сухим прогоном смотрят, что уехало бы, — он ничего не отправляет и следа наружу не оставляет:
-
-```bash
-npx agent-kit mark --state in_work --postmortem <файл> --dry-run
-```
-
-Сухой прогон вместо настоящего вызова оставляет запись в прежнем состоянии. Отметкой он не
-считается.
-
-## Починка: переход вместе с ответом на «чем»
-
-Ставится после того, как правка влита в главную ветку, — не по открытой заявке:
-
-```bash
-npx agent-kit mark --state fixed \
-    --postmortem <файл> \
-    --fix 'заведена статья правила о разборе груза и паттерн с готовыми вызовами'
-```
-
-Текст отвечает на «чем», а не на «где»: статья правила, гард, проверка, правка кода. Без него
-строка отбивается — переход в починку без ответа на «чем» приёмник не принимает.
-
-## Выпуск: версия называется тем, кто публикует
-
-Идёт тем же движением, что и публикация редакции:
-
-```bash
-npx agent-kit mark --state released --postmortem <файл> --release 'rt-agent-kit@0.10.1'
-```
-
-Версия — та, которой назван выпуск, увёзший починку. Не номер редакции приёмника и не время
-выкатки.
-
-## Ответ читается
-
-Вызов отвечает тремя числами и списком:
-
-```
-переведено 2, уже стояло 1, отбито 1
-  строка 3: <ключ> — записи у дерева нет
-```
-
-- **Переведено 0, уже стояло N** — этот разбор не двинул ничего: записи отмечены раньше либо
-  ключи названы не те.
-- **Отбито N** — эти записи остались там, где были. Причина названа при строке, и повтор того
-  же вызова отбивается ровно так же.
-
-Причины отбоя и что делать с каждой:
-
-| Что сказано            | Что это значит                                 | Что делать                           |
-| ---------------------- | ---------------------------------------------- | ------------------------------------ |
-| записи у дерева нет    | ключ назван не тот либо запись прислало не оно | сверить ключ со списком в админке    |
-| переход не разрешён    | шаг через состояние либо ход назад             | пройти состояние, которое пропустили |
-| перехода без текста    | починка без ответа на «чем»                    | добавить довод с текстом починки     |
-| текста не при том шаге | текст приехал с переходом, который не починка  | убрать довод либо сменить состояние  |
-| перехода без версии    | выпуск без ответа на «где искать фикс»         | добавить довод с версией выпуска     |
-| версии не при том шаге | версия приехала с переходом, который не выпуск | убрать довод либо сменить состояние  |
-
-## Ловушки
-
-- **Вызов без токена отбивается без сети.** Токен лежит вне дерева, и на свежей рабочей копии
-  его нет: команда называет это прямо, а не молчит.
-- **Своё дерево называется признаком из токена, а не доводом.** Приём сверяет его сам, и
-  назваться чужим деревом вызов не может.
-- **Записи, отмеченные в одной ветке, в соседней выглядят неотмеченными только в файлах.**
-  Состояние лежит в приёме, а не в дереве: смотрят его в админке, а не в рабочей копии.
-- **Повторная отметка тем же состоянием промахом не считается.** Рабочий порядок повторяют, и
-  вторая та же отметка отбивается ответом «уже стояло», а не отказом.

package/assets/rules/cargo-triage.md

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

package/lib/cargo-state.d.ts

@@ -1,62 +0,0 @@
-/**
- * Отметка состояния груза: команда, которой исполнитель двигает свои записи в приёме.
- *
- * Разбор доводов и сборка пакета отделены от самого запроса нарочно — тем же приёмом, что и
- * отправка груза: спека подставляет двойник вызова и никуда не стучится, а всё, что можно
- * отбить до сети, отбивается до сети. Незнакомое состояние и вызов без записей — промахи
- * исполнителя, и запрос по ним не уходит вовсе.
- */
-import { ICargoStateAccepted, ICargoStateBody, ICargoStateItem } from './cargo.js';
-import { IOutcomeOfCommand } from './commands.js';
-/** Довод, которым называется разбор происшествия. */
-export declare const POSTMORTEM_FLAG: string;
-/** Довод, которым называется предложение. */
-export declare const PROPOSAL_FLAG: string;
-/** Довод текста починки: чем недочёт исправлен. */
-export declare const FIX_FLAG: string;
-/**
- * Довод версии выпуска: в какой версии искать фикс.
- *
- * Назван по выпуску, а не по версии: `--version` у команды строки запуска читается как «покажи
- * свою версию», и заняв его под другое, пакет получил бы две разные вещи под одним словом.
- */
-export declare const RELEASE_FLAG: string;
-/** Что приём ответил на правку состояния. Отказ — такой же ответ, как принятое. */
-export interface IMarked {
-    readonly ok: boolean;
-    /** Код ответа. Ноль — приём не ответил вовсе: не дозвонились, оборвалось, вышло время. */
-    readonly status: number;
-    readonly said: string;
-    /** Ответ приёма. Пусто у отказа: два числа и отбитые строки он называет только у принятого. */
-    readonly accepted: ICargoStateAccepted | null;
-}
-/** Чем отметка ходит в приём. Двойник в спеке — того же вида. */
-export type TMarkCall = (intake: string, token: string, body: ICargoStateBody) => Promise<IMarked>;
-/** Приложенные к строке значения: что едет вместе с состоянием. */
-export interface ICargoStateAttached {
-    /** Чем недочёт исправлен. Пустая строка — довода не было. */
-    readonly fixNote: string;
-    /** В какой версии искать фикс. Пустая строка — довода не было. */
-    readonly releaseVersion: string;
-}
-/** Всё, что отметке нужно знать: куда, чем представиться и что отмечать. */
-export interface IMarkOptions {
-    readonly intake: string;
-    readonly tree: string;
-    readonly token: string;
-    readonly state: string;
-    readonly items: readonly ICargoStateItem[];
-    readonly dryRun: boolean;
-    readonly call: TMarkCall;
-}
-/** Записи, названные доводами строки запуска: род у каждой свой, порядок — как их назвали. */
-export declare function itemsOf(argv: readonly string[], state: string, attached?: ICargoStateAttached): readonly ICargoStateItem[];
-/**
- * Отметить записи дерева названным состоянием.
- *
- * Порядок отказов не случаен: сперва то, что видно без сети, — незнакомое состояние, пустой
- * вызов, отсутствующий токен, — и только потом запрос. Холостой ход стоит последним из них:
- * он показывает собранный пакет, а собрать его можно лишь после того, как доводы сошлись.
- */
-export declare function mark(options: IMarkOptions): Promise<IOutcomeOfCommand>;
-//# sourceMappingURL=cargo-state.d.ts.map

package/lib/cargo-state.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cargo-state.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/cargo-state.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAsC,mBAAmB,EAAE,eAAe,EAAE,eAAe,EAAmB,MAAM,YAAY,CAAC;AACxI,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAKlD,qDAAqD;AACrD,eAAO,MAAM,eAAe,EAAE,MAAuB,CAAC;AAEtD,6CAA6C;AAC7C,eAAO,MAAM,aAAa,EAAE,MAAqB,CAAC;AAElD,mDAAmD;AACnD,eAAO,MAAM,QAAQ,EAAE,MAAgB,CAAC;AAExC;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,MAAoB,CAAC;AAEhD,mFAAmF;AACnF,MAAM,WAAW,OAAO;IACpB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+FAA+F;IAC/F,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACjD;AAED,iEAAiE;AACjE,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEnG,mEAAmE;AACnE,MAAM,WAAW,mBAAmB;IAChC,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACnC;AAED,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;CAC5B;AAWD,8FAA8F;AAC9F,wBAAgB,OAAO,CACnB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,mBAAyD,GACpE,SAAS,eAAe,EAAE,CAsB5B;AA+BD;;;;;;GAMG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAgD5E"}

package/lib/cargo-state.js

@@ -1,118 +0,0 @@
-/**
- * Отметка состояния груза: команда, которой исполнитель двигает свои записи в приёме.
- *
- * Разбор доводов и сборка пакета отделены от самого запроса нарочно — тем же приёмом, что и
- * отправка груза: спека подставляет двойник вызова и никуда не стучится, а всё, что можно
- * отбить до сети, отбивается до сети. Незнакомое состояние и вызов без записей — промахи
- * исполнителя, и запрос по ним не уходит вовсе.
- */
-import { CARGO_SCHEMA_VERSION, CARGO_STATES } from './cargo.js';
-/** Код возврата у всего, что не легло: отбитая строка кончает команду ненулевым кодом. */
-const REFUSED = 1;
-/** Довод, которым называется разбор происшествия. */
-export const POSTMORTEM_FLAG = '--postmortem';
-/** Довод, которым называется предложение. */
-export const PROPOSAL_FLAG = '--proposal';
-/** Довод текста починки: чем недочёт исправлен. */
-export const FIX_FLAG = '--fix';
-/**
- * Довод версии выпуска: в какой версии искать фикс.
- *
- * Назван по выпуску, а не по версии: `--version` у команды строки запуска читается как «покажи
- * свою версию», и заняв его под другое, пакет получил бы две разные вещи под одним словом.
- */
-export const RELEASE_FLAG = '--release';
-/** Род записи по доводу, которым её назвали. Не наш довод — пусто. */
-function kindOfFlag(flag) {
-    if (flag === POSTMORTEM_FLAG) {
-        return 'postmortem';
-    }
-    return flag === PROPOSAL_FLAG ? 'proposal' : null;
-}
-/** Записи, названные доводами строки запуска: род у каждой свой, порядок — как их назвали. */
-export function itemsOf(argv, state, attached = { fixNote: '', releaseVersion: '' }) {
-    const items = [];
-    for (let at = 0; at < argv.length; at += 1) {
-        const kind = kindOfFlag(argv[at]);
-        const key = argv[at + 1] ?? '';
-        if (kind && key && !key.startsWith('--')) {
-            // Приложенное значение едет полем строки, а не своим вызовом: отметка одна, и все её
-            // записи чинились одним разбором либо уехали одним выпуском — второго значения на
-            // тот же вызов не задаётся
-            items.push({
-                kind,
-                key,
-                state,
-                ...(attached.fixNote ? { fixNote: attached.fixNote } : {}),
-                ...(attached.releaseVersion ? { releaseVersion: attached.releaseVersion } : {}),
-            });
-        }
-    }
-    return items;
-}
-/** Отказ строками. */
-function refusal(...lines) {
-    return { code: REFUSED, lines: [...lines] };
-}
-/** Пакет одной строкой: её читает человек перед тем, как отправить. */
-function describe(items, state) {
-    const postmortems = items.filter((one) => one.kind === 'postmortem').length;
-    return `в «${state}»: разборов ${postmortems}, предложений ${items.length - postmortems}`;
-}
-/** Причина отбоя словами человека: их шесть, и по каждой видно, что делать дальше. */
-const DENIAL_WORDS = {
-    missing: 'такой записи у дерева нет',
-    forbidden: 'переход не разрешён порядком',
-    'no-fix-note': 'переход в починку без довода `--fix`',
-    'extra-fix-note': 'довод `--fix` приехал не с переходом в починку',
-    'no-release-version': 'переход в выпуск без довода `--release`',
-    'extra-release-version': 'довод `--release` приехал не с переходом в выпуск',
-};
-/** Отбитая строка человеку: род, ключ и причина словами. */
-function deniedLine(kind, key, denial) {
-    const why = DENIAL_WORDS[denial] ?? denial;
-    return `  ${kind === 'postmortem' ? 'разбор' : 'предложение'} ${key} — ${why}`;
-}
-/**
- * Отметить записи дерева названным состоянием.
- *
- * Порядок отказов не случаен: сперва то, что видно без сети, — незнакомое состояние, пустой
- * вызов, отсутствующий токен, — и только потом запрос. Холостой ход стоит последним из них:
- * он показывает собранный пакет, а собрать его можно лишь после того, как доводы сошлись.
- */
-export async function mark(options) {
-    if (!CARGO_STATES.includes(options.state)) {
-        return refusal(`состояния «${options.state}» не бывает`, `бывают: ${CARGO_STATES.join(', ')}`);
-    }
-    if (options.items.length === 0) {
-        return refusal('отмечать нечего: ни одной записи в доводах', `разбор называется \`${POSTMORTEM_FLAG} <имя файла>\`, предложение — \`${PROPOSAL_FLAG} <признак текста>\``);
-    }
-    if (!options.token) {
-        return refusal('токена дерева нет: отметка осталась неотправленной', 'дерево заводится командой `enroll` — по коду приглашения либо токеном из админки приёма');
-    }
-    const body = {
-        schema: CARGO_SCHEMA_VERSION,
-        tree: options.tree,
-        items: options.items,
-    };
-    if (options.dryRun) {
-        return {
-            code: 0,
-            lines: [`уехало бы в ${options.intake}, дерево ${options.tree}:`, `  ${describe(options.items, options.state)}`],
-        };
-    }
-    const marked = await options.call(options.intake, options.token, body);
-    if (!marked.ok || !marked.accepted) {
-        return refusal(`${options.intake} ответил ${marked.status || 'молчанием'} — ${marked.said}`);
-    }
-    const { changed, same, denied } = marked.accepted;
-    const counted = `переведено ${changed}, уже стояло ${same}, отбито ${denied.length}`;
-    return {
-        code: denied.length ? REFUSED : 0,
-        lines: [
-            `отмечено в ${options.intake}, дерево ${options.tree}: ${counted}`,
-            ...denied.map((one) => deniedLine(one.kind, one.key, one.denial)),
-        ],
-    };
-}
-//# sourceMappingURL=cargo-state.js.map

package/lib/cargo-state.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cargo-state.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/cargo-state.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Отметка состояния груза: команда, которой исполнитель двигает свои записи в приёме.\n *\n * Разбор доводов и сборка пакета отделены от самого запроса нарочно — тем же приёмом, что и\n * отправка груза: спека подставляет двойник вызова и никуда не стучится, а всё, что можно\n * отбить до сети, отбивается до сети. Незнакомое состояние и вызов без записей — промахи\n * исполнителя, и запрос по ним не уходит вовсе.\n */\nimport { CARGO_SCHEMA_VERSION, CARGO_STATES, ICargoStateAccepted, ICargoStateBody, ICargoStateItem, TCargoStateKind } from './cargo.js';\nimport { IOutcomeOfCommand } from './commands.js';\n\n/** Код возврата у всего, что не легло: отбитая строка кончает команду ненулевым кодом. */\nconst REFUSED: number = 1;\n\n/** Довод, которым называется разбор происшествия. */\nexport const POSTMORTEM_FLAG: string = '--postmortem';\n\n/** Довод, которым называется предложение. */\nexport const PROPOSAL_FLAG: string = '--proposal';\n\n/** Довод текста починки: чем недочёт исправлен. */\nexport const FIX_FLAG: string = '--fix';\n\n/**\n * Довод версии выпуска: в какой версии искать фикс.\n *\n * Назван по выпуску, а не по версии: `--version` у команды строки запуска читается как «покажи\n * свою версию», и заняв его под другое, пакет получил бы две разные вещи под одним словом.\n */\nexport const RELEASE_FLAG: string = '--release';\n\n/** Что приём ответил на правку состояния. Отказ — такой же ответ, как принятое. */\nexport interface IMarked {\n    readonly ok: boolean;\n    /** Код ответа. Ноль — приём не ответил вовсе: не дозвонились, оборвалось, вышло время. */\n    readonly status: number;\n    readonly said: string;\n    /** Ответ приёма. Пусто у отказа: два числа и отбитые строки он называет только у принятого. */\n    readonly accepted: ICargoStateAccepted | null;\n}\n\n/** Чем отметка ходит в приём. Двойник в спеке — того же вида. */\nexport type TMarkCall = (intake: string, token: string, body: ICargoStateBody) => Promise<IMarked>;\n\n/** Приложенные к строке значения: что едет вместе с состоянием. */\nexport interface ICargoStateAttached {\n    /** Чем недочёт исправлен. Пустая строка — довода не было. */\n    readonly fixNote: string;\n    /** В какой версии искать фикс. Пустая строка — довода не было. */\n    readonly releaseVersion: string;\n}\n\n/** Всё, что отметке нужно знать: куда, чем представиться и что отмечать. */\nexport interface IMarkOptions {\n    readonly intake: string;\n    readonly tree: string;\n    readonly token: string;\n    readonly state: string;\n    readonly items: readonly ICargoStateItem[];\n    readonly dryRun: boolean;\n    readonly call: TMarkCall;\n}\n\n/** Род записи по доводу, которым её назвали. Не наш довод — пусто. */\nfunction kindOfFlag(flag: string): TCargoStateKind | null {\n    if (flag === POSTMORTEM_FLAG) {\n        return 'postmortem';\n    }\n\n    return flag === PROPOSAL_FLAG ? 'proposal' : null;\n}\n\n/** Записи, названные доводами строки запуска: род у каждой свой, порядок — как их назвали. */\nexport function itemsOf(\n    argv: readonly string[],\n    state: string,\n    attached: ICargoStateAttached = { fixNote: '', releaseVersion: '' }\n): readonly ICargoStateItem[] {\n    const items: ICargoStateItem[] = [];\n\n    for (let at: number = 0; at < argv.length; at += 1) {\n        const kind: TCargoStateKind | null = kindOfFlag(argv[at]);\n        const key: string = argv[at + 1] ?? '';\n\n        if (kind && key && !key.startsWith('--')) {\n            // Приложенное значение едет полем строки, а не своим вызовом: отметка одна, и все её\n            // записи чинились одним разбором либо уехали одним выпуском — второго значения на\n            // тот же вызов не задаётся\n            items.push({\n                kind,\n                key,\n                state,\n                ...(attached.fixNote ? { fixNote: attached.fixNote } : {}),\n                ...(attached.releaseVersion ? { releaseVersion: attached.releaseVersion } : {}),\n            });\n        }\n    }\n\n    return items;\n}\n\n/** Отказ строками. */\nfunction refusal(...lines: readonly string[]): IOutcomeOfCommand {\n    return { code: REFUSED, lines: [...lines] };\n}\n\n/** Пакет одной строкой: её читает человек перед тем, как отправить. */\nfunction describe(items: readonly ICargoStateItem[], state: string): string {\n    const postmortems: number = items.filter((one: ICargoStateItem): boolean => one.kind === 'postmortem').length;\n\n    return `в «${state}»: разборов ${postmortems}, предложений ${items.length - postmortems}`;\n}\n\n/** Причина отбоя словами человека: их шесть, и по каждой видно, что делать дальше. */\nconst DENIAL_WORDS: Readonly<Record<string, string>> = {\n    missing: 'такой записи у дерева нет',\n    forbidden: 'переход не разрешён порядком',\n    'no-fix-note': 'переход в починку без довода `--fix`',\n    'extra-fix-note': 'довод `--fix` приехал не с переходом в починку',\n    'no-release-version': 'переход в выпуск без довода `--release`',\n    'extra-release-version': 'довод `--release` приехал не с переходом в выпуск',\n};\n\n/** Отбитая строка человеку: род, ключ и причина словами. */\nfunction deniedLine(kind: string, key: string, denial: string): string {\n    const why: string = DENIAL_WORDS[denial] ?? denial;\n\n    return `  ${kind === 'postmortem' ? 'разбор' : 'предложение'} ${key} — ${why}`;\n}\n\n/**\n * Отметить записи дерева названным состоянием.\n *\n * Порядок отказов не случаен: сперва то, что видно без сети, — незнакомое состояние, пустой\n * вызов, отсутствующий токен, — и только потом запрос. Холостой ход стоит последним из них:\n * он показывает собранный пакет, а собрать его можно лишь после того, как доводы сошлись.\n */\nexport async function mark(options: IMarkOptions): Promise<IOutcomeOfCommand> {\n    if (!CARGO_STATES.includes(options.state)) {\n        return refusal(`состояния «${options.state}» не бывает`, `бывают: ${CARGO_STATES.join(', ')}`);\n    }\n\n    if (options.items.length === 0) {\n        return refusal(\n            'отмечать нечего: ни одной записи в доводах',\n            `разбор называется \\`${POSTMORTEM_FLAG} <имя файла>\\`, предложение — \\`${PROPOSAL_FLAG} <признак текста>\\``\n        );\n    }\n\n    if (!options.token) {\n        return refusal(\n            'токена дерева нет: отметка осталась неотправленной',\n            'дерево заводится командой `enroll` — по коду приглашения либо токеном из админки приёма'\n        );\n    }\n\n    const body: ICargoStateBody = {\n        schema: CARGO_SCHEMA_VERSION,\n        tree: options.tree,\n        items: options.items,\n    };\n\n    if (options.dryRun) {\n        return {\n            code: 0,\n            lines: [`уехало бы в ${options.intake}, дерево ${options.tree}:`, `  ${describe(options.items, options.state)}`],\n        };\n    }\n\n    const marked: IMarked = await options.call(options.intake, options.token, body);\n\n    if (!marked.ok || !marked.accepted) {\n        return refusal(`${options.intake} ответил ${marked.status || 'молчанием'} — ${marked.said}`);\n    }\n\n    const { changed, same, denied }: ICargoStateAccepted = marked.accepted;\n    const counted: string = `переведено ${changed}, уже стояло ${same}, отбито ${denied.length}`;\n\n    return {\n        code: denied.length ? REFUSED : 0,\n        lines: [\n            `отмечено в ${options.intake}, дерево ${options.tree}: ${counted}`,\n            ...denied.map((one: { kind: string; key: string; denial: string }): string => deniedLine(one.kind, one.key, one.denial)),\n        ],\n    };\n}\n"]}