@rt-tools/agent-kit 0.8.1 → 0.8.2

package/lib/shipment.js

@@ -0,0 +1,247 @@
+/**
+ * Сборка груза и команда отправки.
+ *
+ * Груз уезжает при каждом прогоне, а предложения и разборы — когда они есть: прогон без
+ * замечаний тоже говорит, чем пользовались, чем не пользовались ни разу и что дерево
+ * переопределило. Отправка, построенная вокруг предложения, эти данные теряла.
+ *
+ * Собирается груз здесь, а уезжает в `ship.ts`: сборка проверяется вызовом, а сеть в спеке
+ * подменяется двойником.
+ */
+import { createHash } from 'node:crypto';
+import { existsSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { CARGO_SCHEMA_VERSION, } from './cargo.js';
+import { CONFIG_PATH, readConfig } from './config.js';
+import { readObservations, summarize } from './observations.js';
+import { leaksIn, markSent, marksOf, readProposals, TO_PACKAGE } from './proposals.js';
+import { readToken } from './ship.js';
+import { laidOutSkills, packagedNames, treeSnapshot, unpickedOf } from './snapshot.js';
+/** Длина признака дерева. Двенадцати знаков хватает, чтобы деревья не сталкивались числом. */
+const SLUG_LENGTH = 12;
+/** Отказ команды: именованных кодов у пакета нет — есть код возврата и текст. */
+const REFUSED = 1;
+/** Ответ приёма о токене: по нему отказ добавляет строку про отзыв, а не гадает вслух. */
+const TOKEN_REFUSED = 401;
+/**
+ * Адрес удалённого репозитория, приведённый к одному виду.
+ *
+ * Форм у него несколько — `git@host:владелец/имя.git`, `https://host/владелец/имя`, — и все они
+ * ведут к одному дереву. Две рабочие копии одного репозитория обязаны дать один признак, а
+ * непривёденные формы дали бы два.
+ */
+export function remoteMarkOf(remote) {
+    return remote
+        .trim()
+        .replace(/\.git$/, '')
+        .replace(/^[a-z+]+:\/\//i, '')
+        .replace(/^[^@/]+@/, '')
+        .replace(/:/g, '/')
+        .replace(/\/+$/, '')
+        .toLowerCase();
+}
+/**
+ * Признак дерева: короткое значение, различающее деревья и не выдающее их адреса.
+ *
+ * Считается хешем от адреса репозитория: по нему адрес не восстанавливается, а у двух рабочих
+ * копий одного репозитория он один. Репозитория нет — берётся то, что назвала настройка: иначе
+ * все такие деревья слились бы в одно, и число деревьев в сводке стало бы неправдой молча.
+ */
+export function treeSlugOf(remote, spoken) {
+    const mark = remoteMarkOf(remote);
+    return mark ? createHash('sha256').update(mark, 'utf8').digest('hex').slice(0, SLUG_LENGTH) : spoken;
+}
+/**
+ * Счётчики по ресурсам пакета. Имя, которого пакет не знает, — имя правила самого дерева, и
+ * наружу оно не едет: дерево называет свои правила по своим доменам и по себе самому.
+ *
+ * Число событий при этом остаётся полным: считается их столько, сколько было, — отброшены имена,
+ * а не наблюдения.
+ */
+function knownCounts(counts, known) {
+    return counts.filter((count) => known.has(count.name));
+}
+/** Сводка наблюдений вместе со снимком надстроек — то, что уезжает первым запросом. */
+export function summaryCargo(summary, tree, overrides, unpicked, known) {
+    return {
+        schema: CARGO_SCHEMA_VERSION,
+        tree,
+        days: summary.days,
+        sessions: summary.sessions,
+        loads: knownCounts(summary.loads, known),
+        denials: knownCounts(summary.denials, known),
+        // Род правки, на котором гейт отбивал, ресурсом не является: это `extension`, `command`
+        // или `browser` — слова пакета, одинаковые у всех деревьев.
+        kinds: summary.kinds,
+        guards: knownCounts(summary.guards, known),
+        unused: summary.unused,
+        unpicked,
+        overrides,
+        versions: summary.versions,
+        total: summary.total,
+    };
+}
+/**
+ * Разборы происшествий, как они лежат на дереве.
+ *
+ * Текст едет целиком: разбор объясняет механизм промаха, и шапка без механизма не отвечает ни на
+ * один вопрос, ради которого его читают.
+ */
+export function readPostmortems(root, dir) {
+    const path = join(root, dir);
+    if (!existsSync(path)) {
+        return [];
+    }
+    return (readdirSync(path)
+        // Описание каталога разбором не является: оно объясняет, что здесь лежит, а не механизм
+        // промаха, — и в приёме встало бы записью, которой нечего сказать.
+        .filter((file) => file.endsWith('.md') && file !== 'README.md')
+        .sort()
+        .map((file) => ({ file, text: readFileSync(join(path, file), 'utf8') })));
+}
+/** Что уезжает и в каком порядке: сводка первой — ею заводится запись месяца. */
+export function shipmentsOf(summary, proposals, postmortems) {
+    return [
+        { kind: 'сводка', operation: 'summary', body: summary },
+        ...(proposals.items.length ? [{ kind: 'предложения', operation: 'proposals', body: proposals }] : []),
+        ...(postmortems.items.length ? [{ kind: 'разборы', operation: 'postmortems', body: postmortems }] : []),
+    ];
+}
+/**
+ * Что в грузе называет дерево, из которого он уезжает.
+ *
+ * Проверка накрывает сводку и предложения, но не разбор происшествия: разбор по устройству
+ * называет файлы дерева, где промах случился, и накрытая проверка отбивала бы каждую его
+ * отправку.
+ */
+export function leaksOfCargo(summary, proposals, marks) {
+    const inSummary = leaksIn(JSON.stringify(summary, null, 1), marks).map((leak) => `  сводка: ${leak.why}\n      ${leak.text}`);
+    const inProposals = proposals.flatMap((entry) => leaksIn(entry.body, marks).map((leak) => `  ${entry.file}:${entry.line + leak.line} — ${leak.why}\n      ${leak.text}`));
+    return [...inSummary, ...inProposals];
+}
+/** Отказ строками. */
+function refusal(...lines) {
+    return { code: REFUSED, lines: [...lines] };
+}
+/** Что в отправляемом запросе, одной строкой: её читает человек перед тем, как отправить. */
+function describe(shipment, summary, proposals, postmortems) {
+    if (shipment.operation === 'proposals') {
+        return `предложений ${proposals.items.length}`;
+    }
+    if (shipment.operation === 'postmortems') {
+        return `разборов ${postmortems.items.length}`;
+    }
+    return `наблюдений ${summary.total} за ${summary.days} дн., надстроек ${summary.overrides.length}, невыбранного ${summary.unpicked.length}`;
+}
+/** Пометка об отправке: по ней предложение второй раз не уезжает. */
+function markProposals(root, proposals, shipped) {
+    const mark = `приём:${shipped.accepted?.month ?? 'принято'}`;
+    for (const proposal of proposals) {
+        const path = join(root, proposal.file);
+        writeFileSync(path, markSent(readFileSync(path, 'utf8'), proposal, mark), 'utf8');
+    }
+}
+/**
+ * Что приём сказал о принятом: месяц записи, судьба самой записи и — у предложений — счёт
+ * легшего и уже лежавшего.
+ *
+ * Без счёта строка одинакова и у прогона, привёзшего новое, и у прогона, у которого всё уже
+ * лежало: человек читает второе как первое. Приём, счёта не приславший, оставляет строку
+ * прежней — так же читаются сводка и разборы, у которых счёта нет вовсе.
+ */
+function accepted(shipped) {
+    if (!shipped.accepted) {
+        return 'принято';
+    }
+    const record = `${shipped.accepted.month}${shipped.accepted.created ? ', запись заведена' : ', запись дописана'}`;
+    const added = shipped.accepted.added;
+    return added === undefined ? record : `${record}, принято ${added}, уже лежало ${shipped.accepted.known ?? 0}`;
+}
+/**
+ * Сами запросы. Отправленное помечается сразу, а не после всех: оборвавшаяся отправка иначе
+ * увозит половину и не оставляет следа, по которому видно, какую именно.
+ */
+async function send(root, intake, tree, token, ship, going, proposals) {
+    const done = [];
+    for (const shipment of going) {
+        const shipped = await ship(intake, token, shipment);
+        if (!shipped.ok) {
+            return {
+                code: REFUSED,
+                lines: [
+                    ...(done.length ? [`уехало до отказа: ${done.length}`, ...done] : ['не уехало ничего']),
+                    `${shipment.kind}: ${intake} ответил ${shipped.status || 'молчанием'} — ${shipped.said}`,
+                    ...(shipped.status === TOKEN_REFUSED
+                        ? ['токен не принят: он отозван или заведён не тот — выдай новый командой приёма']
+                        : []),
+                ],
+            };
+        }
+        done.push(`  ${shipment.kind} → ${accepted(shipped)}`);
+        if (shipment.operation === 'proposals') {
+            markProposals(root, proposals, shipped);
+        }
+    }
+    return { code: 0, lines: [`уехало в ${intake}, дерево ${tree}:`, ...done] };
+}
+/**
+ * Отправка груза в приём.
+ *
+ * Порядок отказов не случаен: выключенная запись отвечает нулём и молчит про адрес — она гасит
+ * отправку целиком, вместе со снимком надстроек, и спрашивать про адрес у выключенного дерева
+ * незачем.
+ */
+export async function propose(env, options) {
+    const { root, assetsDir } = env;
+    const config = readConfig(root);
+    if (!config) {
+        return refusal(`конфига нет: ${CONFIG_PATH} — заводится \`agent-kit init\``);
+    }
+    if (!config.observe) {
+        return {
+            code: 0,
+            lines: [
+                'запись наблюдений выключена ключом `observe` в конфиге — наружу не ушло ничего',
+                'выключатель гасит и отправку целиком, вместе со снимком надстроек',
+            ],
+        };
+    }
+    if (!config.intake) {
+        return refusal('отправлять некуда: адреса приёма нет', `он объявляется ключом \`intake\` в ${CONFIG_PATH}`);
+    }
+    const tree = treeSlugOf(options.remote, config.tree);
+    if (!tree) {
+        return refusal('признак дерева не считается: удалённого репозитория нет', `назови его ключом \`tree\` в ${CONFIG_PATH} — иначе деревья без репозитория сольются в одно`);
+    }
+    const token = readToken(root, config.token);
+    if (!token) {
+        return refusal('токена дерева нет: груз остался неотправленным', `файл с ним называется ключом \`token\` в ${CONFIG_PATH} и лежит вне дерева`, 'выдаётся токен командой приёма — `tree:add` или `tree:token`');
+    }
+    const read = readObservations(root, options.today, options.days);
+    const summary = summarize(read.observations, laidOutSkills(config, assetsDir), options.days);
+    const cargo = summaryCargo(summary, tree, treeSnapshot(config, assetsDir, root), unpickedOf(config, assetsDir), packagedNames(config, assetsDir));
+    const mine = readProposals(root).filter((entry) => entry.address === TO_PACKAGE && !entry.sent);
+    const proposals = {
+        schema: CARGO_SCHEMA_VERSION,
+        tree,
+        items: mine.map((entry) => ({ text: entry.body, address: entry.address, resource: entry.resource })),
+    };
+    const postmortems = { schema: CARGO_SCHEMA_VERSION, tree, items: readPostmortems(root, config.postmortems) };
+    const leaked = leaksOfCargo(cargo, mine, marksOf(root, options.remote));
+    if (leaked.length) {
+        return refusal(`отправка не начата: в грузе назван адрес этого дерева — ${leaked.length}`, ...leaked, 'найденное отбивает отправку целиком: «уехало два из трёх» читается как «всё в порядке»');
+    }
+    const going = shipmentsOf(cargo, proposals, postmortems);
+    if (options.dryRun) {
+        return {
+            code: 0,
+            lines: [
+                `уехало бы в ${config.intake}, дерево ${tree}:`,
+                ...going.map((shipment) => `  ${shipment.operation} — ${describe(shipment, cargo, proposals, postmortems)}`),
+                ...(read.silent ? ['наблюдений не велось ни разу — сводка уезжает снимком надстроек'] : []),
+            ],
+        };
+    }
+    return send(root, config.intake, tree, token, options.ship, going, mine);
+}
+//# sourceMappingURL=shipment.js.map

package/lib/shipment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shipment.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/shipment.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Сборка груза и команда отправки.\n *\n * Груз уезжает при каждом прогоне, а предложения и разборы — когда они есть: прогон без\n * замечаний тоже говорит, чем пользовались, чем не пользовались ни разу и что дерево\n * переопределило. Отправка, построенная вокруг предложения, эти данные теряла.\n *\n * Собирается груз здесь, а уезжает в `ship.ts`: сборка проверяется вызовом, а сеть в спеке\n * подменяется двойником.\n */\nimport { createHash } from 'node:crypto';\nimport { existsSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport {\n    CARGO_SCHEMA_VERSION,\n    ICargoCount,\n    ICargoOverride,\n    IPostmortemItem,\n    IPostmortemsCargo,\n    IProposalItem,\n    IProposalsCargo,\n    ISummaryCargo,\n} from './cargo.js';\nimport { IEnvironment, IOutcomeOfCommand } from './commands.js';\nimport { CONFIG_PATH, IConfig, readConfig } from './config.js';\nimport { IReadResult, ISummary, readObservations, summarize } from './observations.js';\nimport { ILeak, IProposal, leaksIn, markSent, marksOf, readProposals, TO_PACKAGE } from './proposals.js';\nimport { IShipment, IShipped, readToken, TShip } from './ship.js';\nimport { laidOutSkills, packagedNames, treeSnapshot, unpickedOf } from './snapshot.js';\n\n/** Длина признака дерева. Двенадцати знаков хватает, чтобы деревья не сталкивались числом. */\nconst SLUG_LENGTH: number = 12;\n\n/** Отказ команды: именованных кодов у пакета нет — есть код возврата и текст. */\nconst REFUSED: number = 1;\n\n/** Ответ приёма о токене: по нему отказ добавляет строку про отзыв, а не гадает вслух. */\nconst TOKEN_REFUSED: number = 401;\n\n/** Чем отправка живёт: чем отправлять, чем себя выдаёт дерево и за какой отрезок сводка. */\nexport interface IShipOptions {\n    /** Печатать, что уехало бы, и не отправлять ничего. */\n    readonly dryRun: boolean;\n    readonly ship: TShip;\n    /** Адрес удалённого репозитория этого дерева: из него считается признак. */\n    readonly remote: string;\n    /** Сегодняшний день: своих часов у команды нет — иначе сводку за отрезок не проверить спекой. */\n    readonly today: string;\n    readonly days: number;\n}\n\n/**\n * Адрес удалённого репозитория, приведённый к одному виду.\n *\n * Форм у него несколько — `git@host:владелец/имя.git`, `https://host/владелец/имя`, — и все они\n * ведут к одному дереву. Две рабочие копии одного репозитория обязаны дать один признак, а\n * непривёденные формы дали бы два.\n */\nexport function remoteMarkOf(remote: string): string {\n    return remote\n        .trim()\n        .replace(/\\.git$/, '')\n        .replace(/^[a-z+]+:\\/\\//i, '')\n        .replace(/^[^@/]+@/, '')\n        .replace(/:/g, '/')\n        .replace(/\\/+$/, '')\n        .toLowerCase();\n}\n\n/**\n * Признак дерева: короткое значение, различающее деревья и не выдающее их адреса.\n *\n * Считается хешем от адреса репозитория: по нему адрес не восстанавливается, а у двух рабочих\n * копий одного репозитория он один. Репозитория нет — берётся то, что назвала настройка: иначе\n * все такие деревья слились бы в одно, и число деревьев в сводке стало бы неправдой молча.\n */\nexport function treeSlugOf(remote: string, spoken: string): string {\n    const mark: string = remoteMarkOf(remote);\n\n    return mark ? createHash('sha256').update(mark, 'utf8').digest('hex').slice(0, SLUG_LENGTH) : spoken;\n}\n\n/**\n * Счётчики по ресурсам пакета. Имя, которого пакет не знает, — имя правила самого дерева, и\n * наружу оно не едет: дерево называет свои правила по своим доменам и по себе самому.\n *\n * Число событий при этом остаётся полным: считается их столько, сколько было, — отброшены имена,\n * а не наблюдения.\n */\nfunction knownCounts(counts: readonly ICargoCount[], known: ReadonlySet<string>): readonly ICargoCount[] {\n    return counts.filter((count: ICargoCount): boolean => known.has(count.name));\n}\n\n/** Сводка наблюдений вместе со снимком надстроек — то, что уезжает первым запросом. */\nexport function summaryCargo(\n    summary: ISummary,\n    tree: string,\n    overrides: readonly ICargoOverride[],\n    unpicked: readonly string[],\n    known: ReadonlySet<string>\n): ISummaryCargo {\n    return {\n        schema: CARGO_SCHEMA_VERSION,\n        tree,\n        days: summary.days,\n        sessions: summary.sessions,\n        loads: knownCounts(summary.loads, known),\n        denials: knownCounts(summary.denials, known),\n        // Род правки, на котором гейт отбивал, ресурсом не является: это `extension`, `command`\n        // или `browser` — слова пакета, одинаковые у всех деревьев.\n        kinds: summary.kinds,\n        guards: knownCounts(summary.guards, known),\n        unused: summary.unused,\n        unpicked,\n        overrides,\n        versions: summary.versions,\n        total: summary.total,\n    };\n}\n\n/**\n * Разборы происшествий, как они лежат на дереве.\n *\n * Текст едет целиком: разбор объясняет механизм промаха, и шапка без механизма не отвечает ни на\n * один вопрос, ради которого его читают.\n */\nexport function readPostmortems(root: string, dir: string): IPostmortemItem[] {\n    const path: string = join(root, dir);\n\n    if (!existsSync(path)) {\n        return [];\n    }\n\n    return (\n        readdirSync(path)\n            // Описание каталога разбором не является: оно объясняет, что здесь лежит, а не механизм\n            // промаха, — и в приёме встало бы записью, которой нечего сказать.\n            .filter((file: string): boolean => file.endsWith('.md') && file !== 'README.md')\n            .sort()\n            .map((file: string): IPostmortemItem => ({ file, text: readFileSync(join(path, file), 'utf8') }))\n    );\n}\n\n/** Что уезжает и в каком порядке: сводка первой — ею заводится запись месяца. */\nexport function shipmentsOf(summary: ISummaryCargo, proposals: IProposalsCargo, postmortems: IPostmortemsCargo): readonly IShipment[] {\n    return [\n        { kind: 'сводка', operation: 'summary', body: summary },\n        ...(proposals.items.length ? [{ kind: 'предложения', operation: 'proposals', body: proposals }] : []),\n        ...(postmortems.items.length ? [{ kind: 'разборы', operation: 'postmortems', body: postmortems }] : []),\n    ];\n}\n\n/**\n * Что в грузе называет дерево, из которого он уезжает.\n *\n * Проверка накрывает сводку и предложения, но не разбор происшествия: разбор по устройству\n * называет файлы дерева, где промах случился, и накрытая проверка отбивала бы каждую его\n * отправку.\n */\nexport function leaksOfCargo(summary: ISummaryCargo, proposals: readonly IProposal[], marks: readonly string[]): string[] {\n    const inSummary: string[] = leaksIn(JSON.stringify(summary, null, 1), marks).map(\n        (leak: ILeak): string => `  сводка: ${leak.why}\\n      ${leak.text}`\n    );\n    const inProposals: string[] = proposals.flatMap((entry: IProposal): string[] =>\n        leaksIn(entry.body, marks).map(\n            (leak: ILeak): string => `  ${entry.file}:${entry.line + leak.line} — ${leak.why}\\n      ${leak.text}`\n        )\n    );\n\n    return [...inSummary, ...inProposals];\n}\n\n/** Отказ строками. */\nfunction refusal(...lines: readonly string[]): IOutcomeOfCommand {\n    return { code: REFUSED, lines: [...lines] };\n}\n\n/** Что в отправляемом запросе, одной строкой: её читает человек перед тем, как отправить. */\nfunction describe(shipment: IShipment, summary: ISummaryCargo, proposals: IProposalsCargo, postmortems: IPostmortemsCargo): string {\n    if (shipment.operation === 'proposals') {\n        return `предложений ${proposals.items.length}`;\n    }\n    if (shipment.operation === 'postmortems') {\n        return `разборов ${postmortems.items.length}`;\n    }\n\n    return `наблюдений ${summary.total} за ${summary.days} дн., надстроек ${summary.overrides.length}, невыбранного ${summary.unpicked.length}`;\n}\n\n/** Пометка об отправке: по ней предложение второй раз не уезжает. */\nfunction markProposals(root: string, proposals: readonly IProposal[], shipped: IShipped): void {\n    const mark: string = `приём:${shipped.accepted?.month ?? 'принято'}`;\n\n    for (const proposal of proposals) {\n        const path: string = join(root, proposal.file);\n        writeFileSync(path, markSent(readFileSync(path, 'utf8'), proposal, mark), 'utf8');\n    }\n}\n\n/**\n * Что приём сказал о принятом: месяц записи, судьба самой записи и — у предложений — счёт\n * легшего и уже лежавшего.\n *\n * Без счёта строка одинакова и у прогона, привёзшего новое, и у прогона, у которого всё уже\n * лежало: человек читает второе как первое. Приём, счёта не приславший, оставляет строку\n * прежней — так же читаются сводка и разборы, у которых счёта нет вовсе.\n */\nfunction accepted(shipped: IShipped): string {\n    if (!shipped.accepted) {\n        return 'принято';\n    }\n\n    const record: string = `${shipped.accepted.month}${shipped.accepted.created ? ', запись заведена' : ', запись дописана'}`;\n    const added: number | undefined = shipped.accepted.added;\n\n    return added === undefined ? record : `${record}, принято ${added}, уже лежало ${shipped.accepted.known ?? 0}`;\n}\n\n/**\n * Сами запросы. Отправленное помечается сразу, а не после всех: оборвавшаяся отправка иначе\n * увозит половину и не оставляет следа, по которому видно, какую именно.\n */\nasync function send(\n    root: string,\n    intake: string,\n    tree: string,\n    token: string,\n    ship: TShip,\n    going: readonly IShipment[],\n    proposals: readonly IProposal[]\n): Promise<IOutcomeOfCommand> {\n    const done: string[] = [];\n\n    for (const shipment of going) {\n        const shipped: IShipped = await ship(intake, token, shipment);\n\n        if (!shipped.ok) {\n            return {\n                code: REFUSED,\n                lines: [\n                    ...(done.length ? [`уехало до отказа: ${done.length}`, ...done] : ['не уехало ничего']),\n                    `${shipment.kind}: ${intake} ответил ${shipped.status || 'молчанием'} — ${shipped.said}`,\n                    ...(shipped.status === TOKEN_REFUSED\n                        ? ['токен не принят: он отозван или заведён не тот — выдай новый командой приёма']\n                        : []),\n                ],\n            };\n        }\n\n        done.push(`  ${shipment.kind} → ${accepted(shipped)}`);\n\n        if (shipment.operation === 'proposals') {\n            markProposals(root, proposals, shipped);\n        }\n    }\n\n    return { code: 0, lines: [`уехало в ${intake}, дерево ${tree}:`, ...done] };\n}\n\n/**\n * Отправка груза в приём.\n *\n * Порядок отказов не случаен: выключенная запись отвечает нулём и молчит про адрес — она гасит\n * отправку целиком, вместе со снимком надстроек, и спрашивать про адрес у выключенного дерева\n * незачем.\n */\nexport async function propose(env: IEnvironment, options: IShipOptions): Promise<IOutcomeOfCommand> {\n    const { root, assetsDir } = env;\n    const config: IConfig | null = readConfig(root);\n\n    if (!config) {\n        return refusal(`конфига нет: ${CONFIG_PATH} — заводится \\`agent-kit init\\``);\n    }\n    if (!config.observe) {\n        return {\n            code: 0,\n            lines: [\n                'запись наблюдений выключена ключом `observe` в конфиге — наружу не ушло ничего',\n                'выключатель гасит и отправку целиком, вместе со снимком надстроек',\n            ],\n        };\n    }\n    if (!config.intake) {\n        return refusal('отправлять некуда: адреса приёма нет', `он объявляется ключом \\`intake\\` в ${CONFIG_PATH}`);\n    }\n\n    const tree: string = treeSlugOf(options.remote, config.tree);\n    if (!tree) {\n        return refusal(\n            'признак дерева не считается: удалённого репозитория нет',\n            `назови его ключом \\`tree\\` в ${CONFIG_PATH} — иначе деревья без репозитория сольются в одно`\n        );\n    }\n\n    const token: string = readToken(root, config.token);\n    if (!token) {\n        return refusal(\n            'токена дерева нет: груз остался неотправленным',\n            `файл с ним называется ключом \\`token\\` в ${CONFIG_PATH} и лежит вне дерева`,\n            'выдаётся токен командой приёма — `tree:add` или `tree:token`'\n        );\n    }\n\n    const read: IReadResult = readObservations(root, options.today, options.days);\n    const summary: ISummary = summarize(read.observations, laidOutSkills(config, assetsDir), options.days);\n    const cargo: ISummaryCargo = summaryCargo(\n        summary,\n        tree,\n        treeSnapshot(config, assetsDir, root),\n        unpickedOf(config, assetsDir),\n        packagedNames(config, assetsDir)\n    );\n\n    const mine: readonly IProposal[] = readProposals(root).filter(\n        (entry: IProposal): boolean => entry.address === TO_PACKAGE && !entry.sent\n    );\n    const proposals: IProposalsCargo = {\n        schema: CARGO_SCHEMA_VERSION,\n        tree,\n        items: mine.map((entry: IProposal): IProposalItem => ({ text: entry.body, address: entry.address, resource: entry.resource })),\n    };\n    const postmortems: IPostmortemsCargo = { schema: CARGO_SCHEMA_VERSION, tree, items: readPostmortems(root, config.postmortems) };\n\n    const leaked: readonly string[] = leaksOfCargo(cargo, mine, marksOf(root, options.remote));\n    if (leaked.length) {\n        return refusal(\n            `отправка не начата: в грузе назван адрес этого дерева — ${leaked.length}`,\n            ...leaked,\n            'найденное отбивает отправку целиком: «уехало два из трёх» читается как «всё в порядке»'\n        );\n    }\n\n    const going: readonly IShipment[] = shipmentsOf(cargo, proposals, postmortems);\n\n    if (options.dryRun) {\n        return {\n            code: 0,\n            lines: [\n                `уехало бы в ${config.intake}, дерево ${tree}:`,\n                ...going.map(\n                    (shipment: IShipment): string => `  ${shipment.operation} — ${describe(shipment, cargo, proposals, postmortems)}`\n                ),\n                ...(read.silent ? ['наблюдений не велось ни разу — сводка уезжает снимком надстроек'] : []),\n            ],\n        };\n    }\n\n    return send(root, config.intake, tree, token, options.ship, going, mine);\n}\n"]}

package/lib/snapshot.d.ts

@@ -0,0 +1,30 @@
+import { ICargoOverride } from './cargo.js';
+import { IConfig } from './config.js';
+/** Имена скилов, разложенных в это дерево: правила, паттерны и скилы без закона. */
+export declare function laidOutSkills(config: IConfig, assetsDir: string): readonly string[];
+/**
+ * Имена всех ресурсов, которые дерево взяло у пакета: правил, паттернов, гардов, проверок.
+ *
+ * По ним отбирается то, что уезжает счётчиками. Имя, которого пакет не знает, принадлежит
+ * правилу самого дерева — а имена своих правил дерево придумывает по своим доменам и по себе
+ * самому, и в сводке, которую читает пакет, им делать нечего.
+ */
+export declare function packagedNames(config: IConfig, assetsDir: string): ReadonlySet<string>;
+/**
+ * Правки надстройки над одним ресурсом.
+ *
+ * Три случая слияния — те же, что и при раскладке: совпавший заголовок замещает раздел пакета,
+ * новый дописывается, пустой снимает пакетный. Четвёртый — новый заголовок с пустым телом —
+ * правкой не считается: слияние его отбрасывает, и снимок обязан говорить то же самое.
+ */
+export declare function overridesOf(resource: string, packaged: string, override: string): ICargoOverride[];
+/** Что дерево держит поверх текста пакета — по всем ресурсам, которые оно разложило. */
+export declare function treeSnapshot(config: IConfig, assetsDir: string, root: string): ICargoOverride[];
+/**
+ * Ресурсы пакета, которых дерево не разложило вовсе.
+ *
+ * Отказ дерева от ресурса — такой же ответ о тексте пакета, как правка его раздела: без
+ * невыбранного мёртвый ресурс неотличим от того, о котором дерево не знало.
+ */
+export declare function unpickedOf(config: IConfig, assetsDir: string): string[];
+//# sourceMappingURL=snapshot.d.ts.map

package/lib/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/snapshot.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,OAAO,EAA8B,MAAM,aAAa,CAAC;AAGlE,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAInF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAErF;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CAclG;AAED,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CAM/F;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAKvE"}

package/lib/snapshot.js

@@ -0,0 +1,73 @@
+/**
+ * Снимок надстроек и невыбранное: что дерево сделало с текстом пакета.
+ *
+ * Снимок — состояние, а не событие: он берётся раскладкой в момент запроса, а не собирается по
+ * записям о том, когда надстройку завели. История «когда завели» не меняет ни одного решения —
+ * надстройка живёт месяцами, — а событие при раскладке завело бы второй источник той же правды.
+ *
+ * Наружу уезжают ресурс, раздел и род правки, но не содержимое: текст дописанного пишет дерево
+ * само, и в нём стоят его домены, пути и имена — то самое, чего наблюдение не выносит наружу ни
+ * при каких событиях. Заголовок своего раздела не уезжает тоже: заголовок раздела пакета
+ * одинаков везде, где стоит слой правил, а придуманный деревом — его слова.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { collectAssets } from './assets.js';
+import { chosenEntries, readCatalog } from './catalog.js';
+import { OVERRIDES_DIR, SKILL_KINDS } from './config.js';
+import { parseDocument } from './sections.js';
+/** Имена скилов, разложенных в это дерево: правила, паттерны и скилы без закона. */
+export function laidOutSkills(config, assetsDir) {
+    return collectAssets(config, assetsDir)
+        .filter((asset) => SKILL_KINDS.includes(asset.kind))
+        .map((asset) => asset.name);
+}
+/**
+ * Имена всех ресурсов, которые дерево взяло у пакета: правил, паттернов, гардов, проверок.
+ *
+ * По ним отбирается то, что уезжает счётчиками. Имя, которого пакет не знает, принадлежит
+ * правилу самого дерева — а имена своих правил дерево придумывает по своим доменам и по себе
+ * самому, и в сводке, которую читает пакет, им делать нечего.
+ */
+export function packagedNames(config, assetsDir) {
+    return new Set(collectAssets(config, assetsDir).map((asset) => asset.name));
+}
+/**
+ * Правки надстройки над одним ресурсом.
+ *
+ * Три случая слияния — те же, что и при раскладке: совпавший заголовок замещает раздел пакета,
+ * новый дописывается, пустой снимает пакетный. Четвёртый — новый заголовок с пустым телом —
+ * правкой не считается: слияние его отбрасывает, и снимок обязан говорить то же самое.
+ */
+export function overridesOf(resource, packaged, override) {
+    const base = parseDocument(packaged);
+    const own = parseDocument(override);
+    const headings = new Set(base.sections.map((section) => section.heading));
+    return own.sections
+        .filter((section) => headings.has(section.heading) || Boolean(section.body))
+        .map((section) => {
+        if (!headings.has(section.heading)) {
+            return { resource, section: null, kind: 'append' };
+        }
+        return { resource, section: section.heading, kind: section.body ? 'replace' : 'drop' };
+    });
+}
+/** Что дерево держит поверх текста пакета — по всем ресурсам, которые оно разложило. */
+export function treeSnapshot(config, assetsDir, root) {
+    return chosenEntries(readCatalog(assetsDir), config).flatMap((entry) => {
+        const path = join(root, OVERRIDES_DIR, entry.id);
+        return existsSync(path) ? overridesOf(entry.id, entry.text, readFileSync(path, 'utf8')) : [];
+    });
+}
+/**
+ * Ресурсы пакета, которых дерево не разложило вовсе.
+ *
+ * Отказ дерева от ресурса — такой же ответ о тексте пакета, как правка его раздела: без
+ * невыбранного мёртвый ресурс неотличим от того, о котором дерево не знало.
+ */
+export function unpickedOf(config, assetsDir) {
+    const catalog = readCatalog(assetsDir);
+    const taken = new Set(chosenEntries(catalog, config).map((entry) => entry.id));
+    return catalog.filter((entry) => !taken.has(entry.id)).map((entry) => entry.id);
+}
+//# sourceMappingURL=snapshot.js.map

package/lib/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/snapshot.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Снимок надстроек и невыбранное: что дерево сделало с текстом пакета.\n *\n * Снимок — состояние, а не событие: он берётся раскладкой в момент запроса, а не собирается по\n * записям о том, когда надстройку завели. История «когда завели» не меняет ни одного решения —\n * надстройка живёт месяцами, — а событие при раскладке завело бы второй источник той же правды.\n *\n * Наружу уезжают ресурс, раздел и род правки, но не содержимое: текст дописанного пишет дерево\n * само, и в нём стоят его домены, пути и имена — то самое, чего наблюдение не выносит наружу ни\n * при каких событиях. Заголовок своего раздела не уезжает тоже: заголовок раздела пакета\n * одинаков везде, где стоит слой правил, а придуманный деревом — его слова.\n */\nimport { existsSync, readFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport { collectAssets, IAsset } from './assets.js';\nimport { ICargoOverride } from './cargo.js';\nimport { chosenEntries, IEntryOfCatalog, readCatalog } from './catalog.js';\nimport { IConfig, OVERRIDES_DIR, SKILL_KINDS } from './config.js';\nimport { IDocument, ISection, parseDocument } from './sections.js';\n\n/** Имена скилов, разложенных в это дерево: правила, паттерны и скилы без закона. */\nexport function laidOutSkills(config: IConfig, assetsDir: string): readonly string[] {\n    return collectAssets(config, assetsDir)\n        .filter((asset: IAsset): boolean => SKILL_KINDS.includes(asset.kind))\n        .map((asset: IAsset): string => asset.name);\n}\n\n/**\n * Имена всех ресурсов, которые дерево взяло у пакета: правил, паттернов, гардов, проверок.\n *\n * По ним отбирается то, что уезжает счётчиками. Имя, которого пакет не знает, принадлежит\n * правилу самого дерева — а имена своих правил дерево придумывает по своим доменам и по себе\n * самому, и в сводке, которую читает пакет, им делать нечего.\n */\nexport function packagedNames(config: IConfig, assetsDir: string): ReadonlySet<string> {\n    return new Set(collectAssets(config, assetsDir).map((asset: IAsset): string => asset.name));\n}\n\n/**\n * Правки надстройки над одним ресурсом.\n *\n * Три случая слияния — те же, что и при раскладке: совпавший заголовок замещает раздел пакета,\n * новый дописывается, пустой снимает пакетный. Четвёртый — новый заголовок с пустым телом —\n * правкой не считается: слияние его отбрасывает, и снимок обязан говорить то же самое.\n */\nexport function overridesOf(resource: string, packaged: string, override: string): ICargoOverride[] {\n    const base: IDocument = parseDocument(packaged);\n    const own: IDocument = parseDocument(override);\n    const headings: ReadonlySet<string> = new Set(base.sections.map((section: ISection): string => section.heading));\n\n    return own.sections\n        .filter((section: ISection): boolean => headings.has(section.heading) || Boolean(section.body))\n        .map((section: ISection): ICargoOverride => {\n            if (!headings.has(section.heading)) {\n                return { resource, section: null, kind: 'append' };\n            }\n\n            return { resource, section: section.heading, kind: section.body ? 'replace' : 'drop' };\n        });\n}\n\n/** Что дерево держит поверх текста пакета — по всем ресурсам, которые оно разложило. */\nexport function treeSnapshot(config: IConfig, assetsDir: string, root: string): ICargoOverride[] {\n    return chosenEntries(readCatalog(assetsDir), config).flatMap((entry: IEntryOfCatalog): ICargoOverride[] => {\n        const path: string = join(root, OVERRIDES_DIR, entry.id);\n\n        return existsSync(path) ? overridesOf(entry.id, entry.text, readFileSync(path, 'utf8')) : [];\n    });\n}\n\n/**\n * Ресурсы пакета, которых дерево не разложило вовсе.\n *\n * Отказ дерева от ресурса — такой же ответ о тексте пакета, как правка его раздела: без\n * невыбранного мёртвый ресурс неотличим от того, о котором дерево не знало.\n */\nexport function unpickedOf(config: IConfig, assetsDir: string): string[] {\n    const catalog: readonly IEntryOfCatalog[] = readCatalog(assetsDir);\n    const taken: ReadonlySet<string> = new Set(chosenEntries(catalog, config).map((entry: IEntryOfCatalog): string => entry.id));\n\n    return catalog.filter((entry: IEntryOfCatalog): boolean => !taken.has(entry.id)).map((entry: IEntryOfCatalog): string => entry.id);\n}\n"]}

package/lib/traits.d.ts

@@ -0,0 +1,32 @@
+export interface ITrait {
+    /** Значение, которое дерево пишет в настройку и которое стоит в имени файла после `needs-`. */
+    readonly value: string;
+    /** Что это свойство означает — им человек и выбирает, что писать про своё дерево. */
+    readonly title: string;
+}
+export declare const TRAITS_FILE: string;
+/** Приставка требования в имени файла. Ею требование и отличается от вида. */
+export declare const REQUIREMENT_PREFIX: string;
+/** Свойства, объявленные пакетом. Нет файла — свойств нет, и требовать нечего. */
+export declare function readTraits(assetsDir: string): readonly ITrait[];
+/**
+ * Свойство, которого ресурс требует именем файла, или `null`, если требования нет.
+ *
+ * Объявленность свойства здесь не проверяется намеренно: незнакомое свойство — опечатка, и о
+ * ней говорят вслух отказом раскладки. Считай эта функция такое имя ресурсом без требования,
+ * ресурс лёг бы всякому дереву, а опечатку не заметил бы никто.
+ */
+export declare function requirementOf(file: string): string | null;
+/** Имя файла без требования: под ним ресурс и ложится в дерево. */
+export declare function withoutRequirement(file: string, requirement: string | null): string;
+/**
+ * Отвечает ли дерево на требование ресурса.
+ *
+ * Ресурс без требования берётся всегда. Требующий — только когда дерево назвало это свойство
+ * своим: молчание требованию не отвечает. Класть наугад дороже — пустой компаньон возвращает
+ * ровно ту работу, ради которой требования и заведены.
+ */
+export declare function answersRequirement(requirement: string | null, has: readonly string[]): boolean;
+/** Названные свойства, которых пакет не объявлял, — опечатки, и о них говорят по именам. */
+export declare function unknownTraits(named: readonly string[], traits: readonly ITrait[]): readonly string[];
+//# sourceMappingURL=traits.d.ts.map

package/lib/traits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traits.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/traits.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,MAAM;IACnB,+FAA+F;IAC/F,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qFAAqF;IACrF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,WAAW,EAAE,MAAsB,CAAC;AAEjD,8EAA8E;AAC9E,eAAO,MAAM,kBAAkB,EAAE,MAAiB,CAAC;AAEnD,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAe/D;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYzD;AAED,mEAAmE;AACnE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAQnF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAE9F;AAED,4FAA4F;AAC5F,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,CAIpG"}

package/lib/traits.js

@@ -0,0 +1,82 @@
+/**
+ * Свойства дерева и требования ресурсов к ним.
+ *
+ * Часть правил верна только там, где есть хранилище, админка или процедуры: наблюдаемость
+ * говорит про строки лога и номер обращения, владеющая сущность захода — про запись, которой
+ * заход принадлежит. Дереву, которое публикует библиотеки, они не нужны ни одной статьёй, и
+ * положенные ему — не долг, а лишние файлы: заполнить их компаньоны нечем.
+ *
+ * От оси различия это отличается вопросом. Ось спрашивает «какой из трёх» и выбирает ровно
+ * один вид; здесь вопрос «есть ли», и таких вещей у одного дерева сразу несколько: дерево,
+ * которое публикует пакеты и держит приложение, одним значением не описывается.
+ *
+ * Требование стоит в имени файла приставкой `needs-`: `observability.needs-db.md`. Приставка —
+ * то, чем требование отличимо от вида: `github` читается перечнем осей, `needs-db` — перечнем
+ * свойств, и перепутать их нельзя.
+ */
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+export const TRAITS_FILE = 'traits.json';
+/** Приставка требования в имени файла. Ею требование и отличается от вида. */
+export const REQUIREMENT_PREFIX = 'needs-';
+/** Свойства, объявленные пакетом. Нет файла — свойств нет, и требовать нечего. */
+export function readTraits(assetsDir) {
+    let raw;
+    try {
+        raw = JSON.parse(readFileSync(join(assetsDir, TRAITS_FILE), 'utf8'));
+    }
+    catch {
+        return [];
+    }
+    if (typeof raw !== 'object' || raw === null) {
+        return [];
+    }
+    return Object.entries(raw).map(([value, trait]) => ({
+        value,
+        title: trait.title ?? '',
+    }));
+}
+/**
+ * Свойство, которого ресурс требует именем файла, или `null`, если требования нет.
+ *
+ * Объявленность свойства здесь не проверяется намеренно: незнакомое свойство — опечатка, и о
+ * ней говорят вслух отказом раскладки. Считай эта функция такое имя ресурсом без требования,
+ * ресурс лёг бы всякому дереву, а опечатку не заметил бы никто.
+ */
+export function requirementOf(file) {
+    const parts = file.split('.');
+    if (parts.length < 3) {
+        return null;
+    }
+    const spoken = parts[parts.length - 2];
+    if (!spoken.startsWith(REQUIREMENT_PREFIX)) {
+        return null;
+    }
+    const trait = spoken.slice(REQUIREMENT_PREFIX.length);
+    return trait === '' ? null : trait;
+}
+/** Имя файла без требования: под ним ресурс и ложится в дерево. */
+export function withoutRequirement(file, requirement) {
+    if (requirement === null) {
+        return file;
+    }
+    const parts = file.split('.');
+    parts.splice(parts.length - 2, 1);
+    return parts.join('.');
+}
+/**
+ * Отвечает ли дерево на требование ресурса.
+ *
+ * Ресурс без требования берётся всегда. Требующий — только когда дерево назвало это свойство
+ * своим: молчание требованию не отвечает. Класть наугад дороже — пустой компаньон возвращает
+ * ровно ту работу, ради которой требования и заведены.
+ */
+export function answersRequirement(requirement, has) {
+    return requirement === null || has.includes(requirement);
+}
+/** Названные свойства, которых пакет не объявлял, — опечатки, и о них говорят по именам. */
+export function unknownTraits(named, traits) {
+    const declared = new Set(traits.map((trait) => trait.value));
+    return named.filter((name) => !declared.has(name));
+}
+//# sourceMappingURL=traits.js.map

package/lib/traits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traits.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/traits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AASjC,MAAM,CAAC,MAAM,WAAW,GAAW,aAAa,CAAC;AAEjD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,kBAAkB,GAAW,QAAQ,CAAC;AAEnD,kFAAkF;AAClF,MAAM,UAAU,UAAU,CAAC,SAAiB;IACxC,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACD,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAC;IACd,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,EAAE,CAAC;IACd,CAAC;IAED,OAAO,MAAM,CAAC,OAAO,CAAC,GAA6B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAmB,EAAU,EAAE,CAAC,CAAC;QACpG,KAAK;QACL,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;KAC3B,CAAC,CAAC,CAAC;AACR,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACtC,MAAM,KAAK,GAAsB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,MAAM,MAAM,GAAW,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,MAAM,KAAK,GAAW,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE9D,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;AACvC,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,WAA0B;IACvE,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,MAAM,KAAK,GAAa,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAElC,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAA0B,EAAE,GAAsB;IACjF,OAAO,WAAW,KAAK,IAAI,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC7D,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,aAAa,CAAC,KAAwB,EAAE,MAAyB;IAC7E,MAAM,QAAQ,GAAgB,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAa,EAAU,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAE1F,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAY,EAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AACxE,CAAC","sourcesContent":["/**\n * Свойства дерева и требования ресурсов к ним.\n *\n * Часть правил верна только там, где есть хранилище, админка или процедуры: наблюдаемость\n * говорит про строки лога и номер обращения, владеющая сущность захода — про запись, которой\n * заход принадлежит. Дереву, которое публикует библиотеки, они не нужны ни одной статьёй, и\n * положенные ему — не долг, а лишние файлы: заполнить их компаньоны нечем.\n *\n * От оси различия это отличается вопросом. Ось спрашивает «какой из трёх» и выбирает ровно\n * один вид; здесь вопрос «есть ли», и таких вещей у одного дерева сразу несколько: дерево,\n * которое публикует пакеты и держит приложение, одним значением не описывается.\n *\n * Требование стоит в имени файла приставкой `needs-`: `observability.needs-db.md`. Приставка —\n * то, чем требование отличимо от вида: `github` читается перечнем осей, `needs-db` — перечнем\n * свойств, и перепутать их нельзя.\n */\nimport { readFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nexport interface ITrait {\n    /** Значение, которое дерево пишет в настройку и которое стоит в имени файла после `needs-`. */\n    readonly value: string;\n    /** Что это свойство означает — им человек и выбирает, что писать про своё дерево. */\n    readonly title: string;\n}\n\nexport const TRAITS_FILE: string = 'traits.json';\n\n/** Приставка требования в имени файла. Ею требование и отличается от вида. */\nexport const REQUIREMENT_PREFIX: string = 'needs-';\n\n/** Свойства, объявленные пакетом. Нет файла — свойств нет, и требовать нечего. */\nexport function readTraits(assetsDir: string): readonly ITrait[] {\n    let raw: unknown;\n    try {\n        raw = JSON.parse(readFileSync(join(assetsDir, TRAITS_FILE), 'utf8'));\n    } catch {\n        return [];\n    }\n    if (typeof raw !== 'object' || raw === null) {\n        return [];\n    }\n\n    return Object.entries(raw as Record<string, ITrait>).map(([value, trait]: [string, ITrait]): ITrait => ({\n        value,\n        title: trait.title ?? '',\n    }));\n}\n\n/**\n * Свойство, которого ресурс требует именем файла, или `null`, если требования нет.\n *\n * Объявленность свойства здесь не проверяется намеренно: незнакомое свойство — опечатка, и о\n * ней говорят вслух отказом раскладки. Считай эта функция такое имя ресурсом без требования,\n * ресурс лёг бы всякому дереву, а опечатку не заметил бы никто.\n */\nexport function requirementOf(file: string): string | null {\n    const parts: readonly string[] = file.split('.');\n    if (parts.length < 3) {\n        return null;\n    }\n    const spoken: string = parts[parts.length - 2];\n    if (!spoken.startsWith(REQUIREMENT_PREFIX)) {\n        return null;\n    }\n    const trait: string = spoken.slice(REQUIREMENT_PREFIX.length);\n\n    return trait === '' ? null : trait;\n}\n\n/** Имя файла без требования: под ним ресурс и ложится в дерево. */\nexport function withoutRequirement(file: string, requirement: string | null): string {\n    if (requirement === null) {\n        return file;\n    }\n    const parts: string[] = file.split('.');\n    parts.splice(parts.length - 2, 1);\n\n    return parts.join('.');\n}\n\n/**\n * Отвечает ли дерево на требование ресурса.\n *\n * Ресурс без требования берётся всегда. Требующий — только когда дерево назвало это свойство\n * своим: молчание требованию не отвечает. Класть наугад дороже — пустой компаньон возвращает\n * ровно ту работу, ради которой требования и заведены.\n */\nexport function answersRequirement(requirement: string | null, has: readonly string[]): boolean {\n    return requirement === null || has.includes(requirement);\n}\n\n/** Названные свойства, которых пакет не объявлял, — опечатки, и о них говорят по именам. */\nexport function unknownTraits(named: readonly string[], traits: readonly ITrait[]): readonly string[] {\n    const declared: Set<string> = new Set(traits.map((trait: ITrait): string => trait.value));\n\n    return named.filter((name: string): boolean => !declared.has(name));\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rt-tools/agent-kit",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "description": "Переносимый слой правил для агента: законы, хуки, проверки и агенты, раскладываемые в репозиторий одной командой",
   "author": "RT Team",
   "license": "Apache-2.0",
@@ -37,6 +37,10 @@
       "types": "./index.d.ts",
       "default": "./index.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./cargo": {
+      "types": "./lib/cargo.d.ts",
+      "default": "./lib/cargo.js"
+    }
   }
 }

package/lib/submit.d.ts

@@ -1,24 +0,0 @@
-export interface IIssueInput {
-    /** `владелец/репозиторий` — читается из манифеста пакета, а не зашито в код. */
-    readonly repository: string;
-    readonly title: string;
-    readonly body: string;
-    readonly label: string;
-}
-/** Чем заводится запись. Двойник в спеке — того же вида. */
-export type TSubmit = (input: IIssueInput) => string;
-/** Метка, по которой сведение находит предложения среди прочих записей. */
-export declare const FEEDBACK_LABEL: string;
-/**
- * `владелец/репозиторий` из адреса, записанного в манифесте пакета. Форм адреса несколько —
- * `git+https://…`, `git@…:…`, — и все они ведут к одной паре имён.
- */
-export declare function repositoryOf(url: string): string;
-/**
- * Запись в очереди работ через помощника хостинга.
- *
- * Помощник может быть подменён оболочкой пользователя, поэтому зовётся он именем, а не строкой
- * оболочки: подмена принимает те же доводы, но уходит в чужую учётную запись.
- */
-export declare const ghIssue: TSubmit;
-//# sourceMappingURL=submit.d.ts.map