@rt-tools/agent-kit 0.10.0 → 0.11.0

package/lib/cargo-state.js

@@ -0,0 +1,118 @@
+/**
+ * Отметка состояния груза: команда, которой исполнитель двигает свои записи в приёме.
+ *
+ * Разбор доводов и сборка пакета отделены от самого запроса нарочно — тем же приёмом, что и
+ * отправка груза: спека подставляет двойник вызова и никуда не стучится, а всё, что можно
+ * отбить до сети, отбивается до сети. Незнакомое состояние и вызов без записей — промахи
+ * исполнителя, и запрос по ним не уходит вовсе.
+ */
+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

@@ -0,0 +1 @@
+{"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"]}

package/lib/cargo.d.ts

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

package/lib/cargo.d.ts.map

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

package/lib/cargo.js

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

package/lib/cargo.js.map

@@ -1 +1 @@
-{"version":3,"file":"cargo.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/cargo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,yFAAyF;AACzF,MAAM,CAAC,MAAM,oBAAoB,GAAW,GAAG,CAAC;AAEhD,uDAAuD;AACvD,MAAM,CAAC,MAAM,iBAAiB,GAAW,cAAc,CAAC","sourcesContent":["/**\n * Форма груза: то, что уезжает с дерева в приём.\n *\n * Место объявления одно на обе стороны — правило договорённости приёма. Объявляет его\n * отправляющая сторона: пакет уходит в реестр, и импорт внутренней либы приёма уехал бы в\n * описания его типов и сломал бы установку. Приём берёт форму отсюда, а своей копии не заводит:\n * из двух копий компилируется только одна, а расходятся они молча.\n *\n * Файл держится без единого импорта намеренно: его читает и приём, и всякий, кто ставит пакет,\n * — а всё остальное в пакете написано под запуск из строки запуска.\n */\n\n/** Версия формата запроса приёма. Меняется, когда меняется состав полей самого груза. */\nexport const CARGO_SCHEMA_VERSION: string = '1';\n\n/** Заголовок, которым дерево представляется приёму. */\nexport const TREE_TOKEN_HEADER: string = 'x-tree-token';\n\n/** Род правки надстройки: дерево замещает раздел пакета, дописывает свой или снимает пакетный. */\nexport type TOverrideKind = 'replace' | 'append' | 'drop';\n\n/** Сколько раз что-то встретилось за отрезок сводки. */\nexport interface ICargoCount {\n    readonly name: string;\n    readonly count: number;\n}\n\n/**\n * Одна правка надстройки. У замещения и снятия заголовок раздела пакетный и общий у всех, потому\n * называется; у своего раздела заголовок придумало дерево — он не уезжает вовсе.\n */\nexport interface ICargoOverride {\n    readonly resource: string;\n    readonly section: string | null;\n    readonly kind: TOverrideKind;\n}\n\n/** Общее у всякого груза: чем разбирать и от какого дерева приехало. */\nexport interface ICargoHead {\n    readonly schema: string;\n    readonly tree: string;\n}\n\n/** Сводка наблюдений дерева за отрезок дней вместе со снимком надстроек. */\nexport interface ISummaryCargo extends ICargoHead {\n    readonly days: number;\n    readonly sessions: number;\n    readonly loads: readonly ICargoCount[];\n    readonly denials: readonly ICargoCount[];\n    readonly kinds: readonly ICargoCount[];\n    readonly guards: readonly ICargoCount[];\n    /** Ресурсы, разложенные в дерево и не загруженные за отрезок ни разу. */\n    readonly unused: readonly string[];\n    /** Ресурсы пакета, которых дерево не разложило вовсе. */\n    readonly unpicked: readonly string[];\n    readonly overrides: readonly ICargoOverride[];\n    /** Версии схемы строк наблюдения, встреченные за отрезок. Приём их не судит. */\n    readonly versions: readonly string[];\n    readonly total: number;\n}\n\n/** Одно предложение по слою правил. */\nexport interface IProposalItem {\n    readonly text: string;\n    readonly address: string;\n    readonly resource: string;\n}\n\nexport interface IProposalsCargo extends ICargoHead {\n    readonly items: readonly IProposalItem[];\n}\n\n/** Один разбор происшествия: имя файла на дереве и текст целиком. */\nexport interface IPostmortemItem {\n    readonly file: string;\n    readonly text: string;\n}\n\nexport interface IPostmortemsCargo extends ICargoHead {\n    readonly items: readonly IPostmortemItem[];\n}\n\n/**\n * Обращение дерева за токеном.\n *\n * Имени дерева в нём нет вовсе: его приём берёт из приглашения — принятое из обращения, оно\n * позволило бы назваться чужим именем тому, кто добыл код.\n */\nexport interface IEnrollCargo {\n    readonly schema: string;\n    /** Признак дерева: его дерево считает у себя, а приём только сверяет. */\n    readonly tree: string;\n    /** Код приглашения, выданный владельцем. Уходит один раз и в журнал не попадает. */\n    readonly code: string;\n}\n\n/** Ответ приёма на годное обращение: токен уходит дереву единственным этим ответом. */\nexport interface IEnrollGranted {\n    readonly tree: string;\n    /** Имя дерева, как его назвал владелец в приглашении. */\n    readonly name: string;\n    readonly token: string;\n}\n\n/** Ответ приёма на принятый груз: дерево и месяц печатаются владельцу отправляющей стороной. */\nexport interface IIntakeAccepted {\n    readonly tree: string;\n    /** Месяц записи в форме `2026-08`, по всемирному времени приёма. */\n    readonly month: string;\n    /** Запись месяца заведена этим запросом, а не обновлена. */\n    readonly created: boolean;\n    /**\n     * Сколько записей легло этим запросом и сколько приехало повторно.\n     *\n     * Есть только у предложений: у них приём отбирает уже приехавшее по признаку, и без этих\n     * двух чисел отправитель печатает «уехало» в том числе тогда, когда нового не уехало ничего.\n     * Приём прежней редакции их не присылает вовсе — отсюда необязательность.\n     */\n    readonly added?: number;\n    readonly known?: number;\n}\n"]}
+{"version":3,"file":"cargo.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/cargo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,yFAAyF;AACzF,MAAM,CAAC,MAAM,oBAAoB,GAAW,GAAG,CAAC;AAEhD,uDAAuD;AACvD,MAAM,CAAC,MAAM,iBAAiB,GAAW,cAAc,CAAC;AA6GxD,oGAAoG;AACpG,MAAM,CAAC,MAAM,YAAY,GAAsB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC","sourcesContent":["/**\n * Форма груза: то, что уезжает с дерева в приём.\n *\n * Место объявления одно на обе стороны — правило договорённости приёма. Объявляет его\n * отправляющая сторона: пакет уходит в реестр, и импорт внутренней либы приёма уехал бы в\n * описания его типов и сломал бы установку. Приём берёт форму отсюда, а своей копии не заводит:\n * из двух копий компилируется только одна, а расходятся они молча.\n *\n * Файл держится без единого импорта намеренно: его читает и приём, и всякий, кто ставит пакет,\n * — а всё остальное в пакете написано под запуск из строки запуска.\n */\n\n/** Версия формата запроса приёма. Меняется, когда меняется состав полей самого груза. */\nexport const CARGO_SCHEMA_VERSION: string = '1';\n\n/** Заголовок, которым дерево представляется приёму. */\nexport const TREE_TOKEN_HEADER: string = 'x-tree-token';\n\n/** Род правки надстройки: дерево замещает раздел пакета, дописывает свой или снимает пакетный. */\nexport type TOverrideKind = 'replace' | 'append' | 'drop';\n\n/** Сколько раз что-то встретилось за отрезок сводки. */\nexport interface ICargoCount {\n    readonly name: string;\n    readonly count: number;\n}\n\n/**\n * Одна правка надстройки. У замещения и снятия заголовок раздела пакетный и общий у всех, потому\n * называется; у своего раздела заголовок придумало дерево — он не уезжает вовсе.\n */\nexport interface ICargoOverride {\n    readonly resource: string;\n    readonly section: string | null;\n    readonly kind: TOverrideKind;\n}\n\n/** Общее у всякого груза: чем разбирать и от какого дерева приехало. */\nexport interface ICargoHead {\n    readonly schema: string;\n    readonly tree: string;\n}\n\n/** Сводка наблюдений дерева за отрезок дней вместе со снимком надстроек. */\nexport interface ISummaryCargo extends ICargoHead {\n    readonly days: number;\n    readonly sessions: number;\n    readonly loads: readonly ICargoCount[];\n    readonly denials: readonly ICargoCount[];\n    readonly kinds: readonly ICargoCount[];\n    readonly guards: readonly ICargoCount[];\n    /** Ресурсы, разложенные в дерево и не загруженные за отрезок ни разу. */\n    readonly unused: readonly string[];\n    /** Ресурсы пакета, которых дерево не разложило вовсе. */\n    readonly unpicked: readonly string[];\n    readonly overrides: readonly ICargoOverride[];\n    /** Версии схемы строк наблюдения, встреченные за отрезок. Приём их не судит. */\n    readonly versions: readonly string[];\n    readonly total: number;\n}\n\n/** Одно предложение по слою правил. */\nexport interface IProposalItem {\n    readonly text: string;\n    readonly address: string;\n    readonly resource: string;\n}\n\nexport interface IProposalsCargo extends ICargoHead {\n    readonly items: readonly IProposalItem[];\n}\n\n/** Один разбор происшествия: имя файла на дереве и текст целиком. */\nexport interface IPostmortemItem {\n    readonly file: string;\n    readonly text: string;\n}\n\nexport interface IPostmortemsCargo extends ICargoHead {\n    readonly items: readonly IPostmortemItem[];\n}\n\n/**\n * Обращение дерева за токеном.\n *\n * Имени дерева в нём нет вовсе: его приём берёт из приглашения — принятое из обращения, оно\n * позволило бы назваться чужим именем тому, кто добыл код.\n */\nexport interface IEnrollCargo {\n    readonly schema: string;\n    /** Признак дерева: его дерево считает у себя, а приём только сверяет. */\n    readonly tree: string;\n    /** Код приглашения, выданный владельцем. Уходит один раз и в журнал не попадает. */\n    readonly code: string;\n}\n\n/** Ответ приёма на годное обращение: токен уходит дереву единственным этим ответом. */\nexport interface IEnrollGranted {\n    readonly tree: string;\n    /** Имя дерева, как его назвал владелец в приглашении. */\n    readonly name: string;\n    readonly token: string;\n}\n\n/** Ответ приёма на принятый груз: дерево и месяц печатаются владельцу отправляющей стороной. */\nexport interface IIntakeAccepted {\n    readonly tree: string;\n    /** Месяц записи в форме `2026-08`, по всемирному времени приёма. */\n    readonly month: string;\n    /** Запись месяца заведена этим запросом, а не обновлена. */\n    readonly created: boolean;\n    /**\n     * Сколько записей легло этим запросом и сколько приехало повторно.\n     *\n     * Есть только у предложений: у них приём отбирает уже приехавшее по признаку, и без этих\n     * двух чисел отправитель печатает «уехало» в том числе тогда, когда нового не уехало ничего.\n     * Приём прежней редакции их не присылает вовсе — отсюда необязательность.\n     */\n    readonly added?: number;\n    readonly known?: number;\n}\n\n/** Род записи груза, у которой есть состояние. Набор закрыт: сводка месяца состояния не несёт. */\nexport type TCargoStateKind = 'postmortem' | 'proposal';\n\n/** Состояния записи груза по порядку: шаг идёт вперёд на соседнее, назад — только из «в работе». */\nexport const CARGO_STATES: readonly string[] = ['new', 'in_work', 'fixed', 'released'];\n\n/** Одна строка правки состояния: род записи, ключ и состояние, в которое её переводят. */\nexport interface ICargoStateItem {\n    readonly kind: TCargoStateKind;\n    /** Ключ записи: имя файла у разбора происшествия, признак текста у предложения. */\n    readonly key: string;\n    readonly state: string;\n    /**\n     * Чем недочёт исправлен. Едет только при переходе в «починено и не выпущено» — с другим\n     * переходом приём отбивает строку, а без него отбивает переход в починку.\n     */\n    readonly fixNote?: string;\n    /**\n     * В какой версии искать фикс. Едет только при переходе в «выпущено» — с другим переходом\n     * приём отбивает строку, а без него отбивает переход в выпуск.\n     */\n    readonly releaseVersion?: string;\n}\n\n/** Пакет правки состояния: то же общее, что у всякого груза, плюс строки правки. */\nexport interface ICargoStateBody extends ICargoHead {\n    readonly items: readonly ICargoStateItem[];\n}\n\n/** Строка, которую приём не исполнил: место в пакете, род записи, ключ и причина. */\nexport interface ICargoStateDenied {\n    readonly at: number;\n    readonly kind: TCargoStateKind;\n    readonly key: string;\n    /** Почему не исполнена: записи у дерева нет либо переход не разрешён. */\n    readonly denial: string;\n}\n\n/** Ответ приёма на правку состояния: признак дерева, два числа и отбитые строки. */\nexport interface ICargoStateAccepted {\n    readonly tree: string;\n    /** Сколько записей переведено. */\n    readonly changed: number;\n    /** Сколько уже стояло в названном состоянии: переходом это не считается. */\n    readonly same: number;\n    readonly denied: readonly ICargoStateDenied[];\n}\n"]}

package/lib/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/commands.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAW7C,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,2FAA2F;AAC3F,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CACvC;AA0DD,+DAA+D;AAC/D,eAAO,MAAM,WAAW,EAAE,MAAyB,CAAC;AA+UpD;;;;GAIG;AACH,wBAAgB,IAAI,CAChB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,SAAS,MAAM,EAAO,EAC5B,QAAQ,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,EAC/C,SAAS,GAAE,MAAW,GACvB,iBAAiB,CAgCnB;AA8FD,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG,iBAAiB,CA4DzE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,iBAAiB,CA+CpF;AAQD,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CAC1B;AAqDD;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,GAAG,iBAAiB,CAoDlF;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CA0E3D;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CA2DzD"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/commands.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAsB7C,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,2FAA2F;AAC3F,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CACvC;AA0DD,+DAA+D;AAC/D,eAAO,MAAM,WAAW,EAAE,MAAyB,CAAC;AA+UpD;;;;GAIG;AACH,wBAAgB,IAAI,CAChB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,SAAS,MAAM,EAAO,EAC5B,QAAQ,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,EAC/C,SAAS,GAAE,MAAW,GACvB,iBAAiB,CAgCnB;AA8FD,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG,iBAAiB,CA4DzE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,iBAAiB,CA+CpF;AAQD,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CAC1B;AAqHD;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,GAAG,iBAAiB,CAuDlF;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CA2E3D;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CA2DzD"}

package/lib/commands.js

@@ -4,7 +4,7 @@
  * а `process.exit` зовёт только точка входа — иначе ни одну из них нельзя было бы проверить
  * спекой, не перехватывая поток вывода.
  */
-import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, statSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { collectAssets } from './assets.js';
 import { cascadeCuts } from './cascade.js';
@@ -12,10 +12,11 @@ import { isChosen, readCatalog } from './catalog.js';
 import { debtLine, isUnfilled, pathOf as companionPathOf, unaddressedOf } from './companion.js';
 import { CONFIG_PATH, DEFAULT_LAYOUT, KINDS, OVERRIDES_DIR, PROFILE_FILE, readConfig, RT_KIT_DIR } from './config.js';
 import { hooksSection, SETTINGS_PATH } from './hooks-map.js';
-import { DEFAULT_DAYS, KEEP_DAYS, OBSERVATIONS_DIR, readObservations, summarize } from './observations.js';
+import { DEFAULT_DAYS, KEEP_DAYS, OBSERVATIONS_DIR, readObservations, summarize, } from './observations.js';
 import { isRefusal } from './plan.js';
 import { laidOutSkills } from './snapshot.js';
 import { pendingOf, planSync, runSync } from './sync.js';
+import { thresholdLines } from './thresholds.js';
 import { answersRequirement, readTraits, unknownTraits } from './traits.js';
 import { placeholdersOf } from './vars.js';
 import { readAxes, unansweredAxes } from './variants.js';
@@ -585,6 +586,52 @@ const countLines = (counted) => {
     const width = counted.reduce((found, entry) => Math.max(found, entry.name.length), 0);
     return counted.map((entry) => `  ${entry.name.padEnd(width)}  ${entry.count}`);
 };
+/**
+ * Вес разложенных правил на диске: имя правила в сумму байт его текстов.
+ *
+ * Считается здесь, а не в сводке: сводка разбирает наблюдения и диска не знает. Складываются все
+ * `.md` папки правила — само правило, компаньон с именами дерева и всё, что дерево положило
+ * рядом: загрузка правила тянет их не поодиночке, и раздельный счёт врал бы в меньшую сторону.
+ *
+ * Правило, которого в дереве нет, в карту не попадает вовсе. Ноль от него неотличим по числу, но
+ * отличим по смыслу: не «ничего не весит», а «весить нечему».
+ */
+function weightsOfSkills(root, dir, names) {
+    const at = join(root, dir);
+    const found = {};
+    for (const name of names) {
+        const folder = join(at, name);
+        if (!existsSync(folder)) {
+            continue;
+        }
+        found[name] = readdirSync(folder)
+            .filter((file) => file.endsWith('.md'))
+            .reduce((sum, file) => sum + statSync(join(folder, file)).size, 0);
+    }
+    return found;
+}
+/** Байты человеку: килобайтами, потому что счёт идёт на сотни тысяч и читается по одному. */
+function kbOf(bytes) {
+    return `${Math.round(bytes / 1024)} КБ`;
+}
+/**
+ * Строка о том, сколько отбитий пришло не на правку файла.
+ *
+ * Своей строкой, а не долей, выведенной читателем из разбивки по родам: гейт стоит ради правки, и
+ * доля, пришедшая на команду оболочки и на браузер, говорит, сколько раз правило потребовали под
+ * то, что правкой не является. Сложенная глазами из десятка строк, эта доля не складывается
+ * никогда.
+ *
+ * Молчит, когда отбитий не было вовсе: «0 процентов» при нуле отбитий — ответ на незаданный
+ * вопрос.
+ */
+function offFileLines(summary) {
+    const total = summary.denials.reduce((found, entry) => found + entry.count, 0);
+    if (total === 0) {
+        return [];
+    }
+    return [`  не на правке файла: ${summary.denialsOffFile} из ${total} — ${Math.round((summary.denialsOffFile / total) * 100)}%`];
+}
 /** Сводка строками: загруженное, незагруженное, отбивки гейта и отказы гардов. */
 function statsLines(summary, swept, days, version, laidOut) {
     return [
@@ -592,6 +639,14 @@ function statsLines(summary, swept, days, version, laidOut) {
         ...(summary.versions.length ? [`версии пакета в записях: ${summary.versions.join(', ')}`] : []),
         '',
         `правил загружено: ${summary.loads.reduce((found, entry) => found + entry.count, 0)}`,
+        // Вес молчит, когда весить нечем: каталог правил не разложен или пуст. Ноль килобайт при
+        // сотне загрузок читался бы как «правила ничего не стоят», а это не то же самое.
+        ...(summary.bytes > 0
+            ? [
+                `  весом ${kbOf(summary.bytes)}, на один заход ${kbOf(summary.bytesPerSession)}`,
+                '  — столько текста заход прочитал прежде, чем взяться за работу',
+            ]
+            : []),
         ...countLines(summary.loads),
         ...(summary.unused.length
             ? [
@@ -610,9 +665,10 @@ function statsLines(summary, swept, days, version, laidOut) {
             ? [
                 '',
                 `гейт отбивал: ${summary.denials.reduce((found, entry) => found + entry.count, 0)}`,
+                ...offFileLines(summary),
                 ...countLines(summary.denials),
                 ...(summary.kinds.length
-                    ? ['  чаще всего на:', ...countLines(summary.kinds).map((line) => `  ${line}`)]
+                    ? ['  по роду правки:', ...countLines(summary.kinds).map((line) => `  ${line}`)]
                     : []),
             ]
             : []),
@@ -654,7 +710,10 @@ export function stats(env, options) {
     }
     const days = options.days > 0 ? options.days : DEFAULT_DAYS;
     const result = readObservations(root, options.today, days);
-    const summary = summarize(result.observations, laidOutSkills(config, assetsDir), days);
+    const known = laidOutSkills(config, assetsDir);
+    // Вес спрашивается у дерева, а не у пакета: правило дерево могло переписать надстройкой, и
+    // заход читал то, что лежит здесь, а не то, что уехало бы из пакета.
+    const summary = summarize(result.observations, known, days, weightsOfSkills(root, config.layout.rules, known));
     if (options.json) {
         return { code: 0, lines: [JSON.stringify({ ...summary, swept: result.swept })] };
     }
@@ -728,6 +787,7 @@ export function doctor(env) {
             return `  снят каскадом: ${one.id} — вслед за ${one.parent}${root}`;
         }),
         ...profileLines(root, assetsDir, config),
+        ...thresholdLines(root),
         `значений в конфиге: ${Object.keys(config.vars).length}`,
         ...chosen,
         ...[...counted].map(([outcome, count]) => `${STATE_WORD[outcome]}: ${count}`),