@rt-tools/agent-kit 0.1.0

package/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/config.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Конфиг проекта — `.claude/rt-kit.json`.\n *\n * Всё, что пакет не может знать сам: значения для дырок, куда класть каждый род ресурса и от\n * чего проект отказался. Конфиг лежит в дереве проекта и коммитится: раскладка обязана\n * повторяться на чужой машине без вопросов, иначе разложенное расходится между разработчиками.\n */\nimport { readFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\n/** Род ресурса. Он же имя каталога в `assets/` пакета и ключ раскладки. */\nexport type TKind = 'laws' | 'hooks' | 'checks' | 'agents' | 'templates';\n\nexport const KINDS: readonly TKind[] = ['laws', 'hooks', 'checks', 'agents', 'templates'];\n\nexport interface IConfig {\n    /** Значения дырок `{{имя}}`. */\n    readonly vars: Readonly<Record<string, string>>;\n    /** Куда класть каждый род ресурса, путями от корня проекта. */\n    readonly layout: Readonly<Record<TKind, string>>;\n    /** Ресурсы, от которых проект отказался, идентификаторами: `laws/money.md`. */\n    readonly skip: readonly string[];\n}\n\nexport const CONFIG_PATH: string = '.claude/rt-kit.json';\nexport const OVERRIDES_DIR: string = '.claude/rt-kit/overrides';\n\n/**\n * Умолчания раскладки. Это не единственно возможные пути, но менять их без нужды не стоит:\n * агент ищет законы в `docs/constitution`, потому что так написано в правилах, которые пакет\n * же и везёт.\n */\nexport const DEFAULT_LAYOUT: Readonly<Record<TKind, string>> = {\n    laws: 'docs/constitution',\n    hooks: '.claude/hooks',\n    checks: 'tools',\n    agents: '.claude/agents',\n    templates: '.claude/rt-kit/templates',\n};\n\nexport class ConfigError extends Error {}\n\nconst isRecord: (value: unknown) => value is Record<string, unknown> = (value: unknown): value is Record<string, unknown> =>\n    typeof value === 'object' && value !== null && !Array.isArray(value);\n\nfunction stringMap(value: unknown, where: string): Record<string, string> {\n    if (value === undefined) {\n        return {};\n    }\n    if (!isRecord(value)) {\n        throw new ConfigError(`${where}: ожидается объект «имя — значение»`);\n    }\n    const result: Record<string, string> = {};\n    for (const [key, entry] of Object.entries(value)) {\n        if (typeof entry !== 'string') {\n            throw new ConfigError(`${where}.${key}: ожидается строка`);\n        }\n        result[key] = entry;\n    }\n\n    return result;\n}\n\nexport function parseConfig(text: string): IConfig {\n    let raw: unknown;\n    try {\n        raw = JSON.parse(text);\n    } catch (error: unknown) {\n        throw new ConfigError(`${CONFIG_PATH} — не разбирается как JSON: ${(error as Error).message}`);\n    }\n    if (!isRecord(raw)) {\n        throw new ConfigError(`${CONFIG_PATH}: ожидается объект`);\n    }\n\n    const layout: Record<string, string> = { ...DEFAULT_LAYOUT, ...stringMap(raw['layout'], 'layout') };\n    for (const kind of Object.keys(layout)) {\n        if (!KINDS.includes(kind as TKind)) {\n            throw new ConfigError(`layout.${kind}: такого рода ресурсов нет — есть ${KINDS.join(', ')}`);\n        }\n    }\n\n    const skip: unknown = raw['skip'] ?? [];\n    if (!Array.isArray(skip) || skip.some((entry: unknown): boolean => typeof entry !== 'string')) {\n        throw new ConfigError('skip: ожидается список идентификаторов ресурсов');\n    }\n\n    // Пути раскладки — тоже значения проекта, и пакет их уже знает. Требовать их вторым списком\n    // значило бы держать одно и то же в двух местах: расходятся такие пары молча.\n    const derived: Record<string, string> = {};\n    for (const kind of KINDS) {\n        derived[`${kind.replace(/s$/, '')}sDir`] = layout[kind];\n    }\n\n    return { vars: { ...derived, ...stringMap(raw['vars'], 'vars') }, layout: layout as Record<TKind, string>, skip: skip as string[] };\n}\n\n/** Конфиг проекта; его отсутствие — не отказ, а повод сказать про `agent-kit init`. */\nexport function readConfig(root: string): IConfig | null {\n    try {\n        return parseConfig(readFileSync(join(root, CONFIG_PATH), 'utf8'));\n    } catch (error: unknown) {\n        if (error instanceof ConfigError) {\n            throw error;\n        }\n\n        return null;\n    }\n}\n"]}

package/lib/package-root.d.ts

@@ -0,0 +1,2 @@
+export declare function packageRootFrom(start: string): string;
+//# sourceMappingURL=package-root.d.ts.map

package/lib/package-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-root.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/package-root.ts"],"names":[],"mappings":"AAcA,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAYrD"}

package/lib/package-root.js

@@ -0,0 +1,27 @@
+/**
+ * Корень пакета — каталог, где лежат `package.json` и `assets/`.
+ *
+ * Считать его отступом от файла нельзя: в исходниках модуль лежит на `src/lib/`, а в собранном
+ * пакете — на `lib/`, и один и тот же `../..` в первом случае приводит в корень пакета, а во
+ * втором — на каталог выше. Прогон собранного CLI падал на чтении `package.json` ровно так.
+ *
+ * Поэтому корень ищется подъёмом до первого `package.json`. Откуда подниматься, говорит
+ * вызывающий: `import.meta.url` живёт только в точке входа, которую не тянет в себя ни одна
+ * спека, — трансформ тестов разбирает модули как CommonJS, и это выражение для него синтаксис.
+ */
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+export function packageRootFrom(start) {
+    let dir = start;
+    for (;;) {
+        if (existsSync(join(dir, 'package.json'))) {
+            return dir;
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            throw new Error(`не найден корень пакета: подъём от ${start} не встретил package.json`);
+        }
+        dir = parent;
+    }
+}
+//# sourceMappingURL=package-root.js.map

package/lib/package-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-root.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/package-root.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,UAAU,eAAe,CAAC,KAAa;IACzC,IAAI,GAAG,GAAW,KAAK,CAAC;IACxB,SAAS,CAAC;QACN,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;YACxC,OAAO,GAAG,CAAC;QACf,CAAC;QACD,MAAM,MAAM,GAAW,OAAO,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,sCAAsC,KAAK,2BAA2B,CAAC,CAAC;QAC5F,CAAC;QACD,GAAG,GAAG,MAAM,CAAC;IACjB,CAAC;AACL,CAAC","sourcesContent":["/**\n * Корень пакета — каталог, где лежат `package.json` и `assets/`.\n *\n * Считать его отступом от файла нельзя: в исходниках модуль лежит на `src/lib/`, а в собранном\n * пакете — на `lib/`, и один и тот же `../..` в первом случае приводит в корень пакета, а во\n * втором — на каталог выше. Прогон собранного CLI падал на чтении `package.json` ровно так.\n *\n * Поэтому корень ищется подъёмом до первого `package.json`. Откуда подниматься, говорит\n * вызывающий: `import.meta.url` живёт только в точке входа, которую не тянет в себя ни одна\n * спека, — трансформ тестов разбирает модули как CommonJS, и это выражение для него синтаксис.\n */\nimport { existsSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\n\nexport function packageRootFrom(start: string): string {\n    let dir: string = start;\n    for (;;) {\n        if (existsSync(join(dir, 'package.json'))) {\n            return dir;\n        }\n        const parent: string = dirname(dir);\n        if (parent === dir) {\n            throw new Error(`не найден корень пакета: подъём от ${start} не встретил package.json`);\n        }\n        dir = parent;\n    }\n}\n"]}

package/lib/plan.d.ts

@@ -0,0 +1,33 @@
+export type TOutcome = 
+/** Файла нет — положить. */
+'create'
+/** Разложенное отстало от пакета или от надстройки — переложить. */
+ | 'update'
+/** Тело не сходится с шапкой: файл правили руками. */
+ | 'drift'
+/** Файл есть, шапки нет — положен не пакетом, трогать нельзя. */
+ | 'foreign'
+/** Сходится всё. */
+ | 'ok';
+export interface IPlanInput {
+    readonly path: string;
+    readonly asset: string;
+    readonly version: string;
+    /** Тело после подстановки значений и слияния с надстройкой. */
+    readonly rendered: string;
+    /** Что лежит на этом пути сейчас; `null` — файла нет. */
+    readonly existing: string | null;
+}
+export interface IPlanned {
+    readonly path: string;
+    readonly asset: string;
+    readonly outcome: TOutcome;
+    /** Что записать. У `drift`, `foreign` и `ok` записывать нечего. */
+    readonly content: string | null;
+}
+export declare function planFile(input: IPlanInput): IPlanned;
+/** Раскладка не удалась, если хоть один файл её не принял. */
+export declare const isRefusal: (outcome: TOutcome) => boolean;
+/** Что `sync --check` считает расхождением: и отказ, и всё, что осталось не переложенным. */
+export declare const isPending: (outcome: TOutcome) => boolean;
+//# sourceMappingURL=plan.d.ts.map

package/lib/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/plan.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,QAAQ;AAChB,4BAA4B;AAC1B,QAAQ;AACV,oEAAoE;GAClE,QAAQ;AACV,sDAAsD;GACpD,OAAO;AACT,iEAAiE;GAC/D,SAAS;AACX,oBAAoB;GAClB,IAAI,CAAC;AAEX,MAAM,WAAW,UAAU;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,CA0BpD;AAED,8DAA8D;AAC9D,eAAO,MAAM,SAAS,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAsF,CAAC;AAEtI,6FAA6F;AAC7F,eAAO,MAAM,SAAS,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAA0D,CAAC"}

package/lib/plan.js

@@ -0,0 +1,36 @@
+/**
+ * Что случится с одним файлом на раскладке — решение без обращения к диску.
+ *
+ * Отделено от чтения и записи потому, что решений здесь пять, а различить их надо до того, как
+ * что-нибудь записано: `sync --check` в гейте пуша ничего не пишет вовсе, а обычный `sync`
+ * обязан отказаться от файла, который правили руками, а не молча его переписать.
+ */
+import { applyStamp, digestOf, readStamped } from './stamp.js';
+export function planFile(input) {
+    const stamp = { version: input.version, asset: input.asset, hash: digestOf(input.rendered) };
+    const content = applyStamp(input.rendered, stamp, input.path);
+    const planned = (outcome, write) => ({
+        path: input.path,
+        asset: input.asset,
+        outcome,
+        content: write ? content : null,
+    });
+    if (input.existing === null) {
+        return planned('create', true);
+    }
+    const found = readStamped(input.existing);
+    if (!found) {
+        return planned('foreign', false);
+    }
+    // Порядок проверок решает: у файла, который и правили руками, и отставшего, надо назвать
+    // правку. Переложить его — потерять её, а разбирать нечего: в дереве её уже нет.
+    if (digestOf(found.body) !== found.stamp.hash) {
+        return planned('drift', false);
+    }
+    return found.stamp.hash === stamp.hash && found.stamp.version === input.version ? planned('ok', false) : planned('update', true);
+}
+/** Раскладка не удалась, если хоть один файл её не принял. */
+export const isRefusal = (outcome) => outcome === 'drift' || outcome === 'foreign';
+/** Что `sync --check` считает расхождением: и отказ, и всё, что осталось не переложенным. */
+export const isPending = (outcome) => outcome !== 'ok';
+//# sourceMappingURL=plan.js.map

package/lib/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/plan.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAoB,WAAW,EAAE,MAAM,YAAY,CAAC;AAgCjF,MAAM,UAAU,QAAQ,CAAC,KAAiB;IACtC,MAAM,KAAK,GAAW,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;IACrG,MAAM,OAAO,GAAW,UAAU,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACtE,MAAM,OAAO,GAAoD,CAAC,OAAiB,EAAE,KAAc,EAAY,EAAE,CAAC,CAAC;QAC/G,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO;QACP,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;KAClC,CAAC,CAAC;IAEH,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,KAAK,GAAoB,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC3D,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,OAAO,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,yFAAyF;IACzF,iFAAiF;IACjF,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC5C,OAAO,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACrI,CAAC;AAED,8DAA8D;AAC9D,MAAM,CAAC,MAAM,SAAS,GAAmC,CAAC,OAAiB,EAAW,EAAE,CAAC,OAAO,KAAK,OAAO,IAAI,OAAO,KAAK,SAAS,CAAC;AAEtI,6FAA6F;AAC7F,MAAM,CAAC,MAAM,SAAS,GAAmC,CAAC,OAAiB,EAAW,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC","sourcesContent":["/**\n * Что случится с одним файлом на раскладке — решение без обращения к диску.\n *\n * Отделено от чтения и записи потому, что решений здесь пять, а различить их надо до того, как\n * что-нибудь записано: `sync --check` в гейте пуша ничего не пишет вовсе, а обычный `sync`\n * обязан отказаться от файла, который правили руками, а не молча его переписать.\n */\nimport { applyStamp, digestOf, IStamp, IStamped, readStamped } from './stamp.js';\n\nexport type TOutcome =\n    /** Файла нет — положить. */\n    | 'create'\n    /** Разложенное отстало от пакета или от надстройки — переложить. */\n    | 'update'\n    /** Тело не сходится с шапкой: файл правили руками. */\n    | 'drift'\n    /** Файл есть, шапки нет — положен не пакетом, трогать нельзя. */\n    | 'foreign'\n    /** Сходится всё. */\n    | 'ok';\n\nexport interface IPlanInput {\n    readonly path: string;\n    readonly asset: string;\n    readonly version: string;\n    /** Тело после подстановки значений и слияния с надстройкой. */\n    readonly rendered: string;\n    /** Что лежит на этом пути сейчас; `null` — файла нет. */\n    readonly existing: string | null;\n}\n\nexport interface IPlanned {\n    readonly path: string;\n    readonly asset: string;\n    readonly outcome: TOutcome;\n    /** Что записать. У `drift`, `foreign` и `ok` записывать нечего. */\n    readonly content: string | null;\n}\n\nexport function planFile(input: IPlanInput): IPlanned {\n    const stamp: IStamp = { version: input.version, asset: input.asset, hash: digestOf(input.rendered) };\n    const content: string = applyStamp(input.rendered, stamp, input.path);\n    const planned: (outcome: TOutcome, write: boolean) => IPlanned = (outcome: TOutcome, write: boolean): IPlanned => ({\n        path: input.path,\n        asset: input.asset,\n        outcome,\n        content: write ? content : null,\n    });\n\n    if (input.existing === null) {\n        return planned('create', true);\n    }\n\n    const found: IStamped | null = readStamped(input.existing);\n    if (!found) {\n        return planned('foreign', false);\n    }\n\n    // Порядок проверок решает: у файла, который и правили руками, и отставшего, надо назвать\n    // правку. Переложить его — потерять её, а разбирать нечего: в дереве её уже нет.\n    if (digestOf(found.body) !== found.stamp.hash) {\n        return planned('drift', false);\n    }\n\n    return found.stamp.hash === stamp.hash && found.stamp.version === input.version ? planned('ok', false) : planned('update', true);\n}\n\n/** Раскладка не удалась, если хоть один файл её не принял. */\nexport const isRefusal: (outcome: TOutcome) => boolean = (outcome: TOutcome): boolean => outcome === 'drift' || outcome === 'foreign';\n\n/** Что `sync --check` считает расхождением: и отказ, и всё, что осталось не переложенным. */\nexport const isPending: (outcome: TOutcome) => boolean = (outcome: TOutcome): boolean => outcome !== 'ok';\n"]}

package/lib/sections.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Разбор документа на разделы `## ` и слияние надстройки проекта с текстом пакета.
+ *
+ * Пакет везёт общий текст, проект дописывает своё. Заменять файл целиком нельзя — тогда правка
+ * пакета до проекта не доедет и этого никто не заметит; не заменять ничего тоже нельзя — общий
+ * текст всегда чем-то расходится с местом, куда его положили.
+ *
+ * Отсюда единица слияния — раздел `## `: он крупнее строки, поэтому слияние не рвёт фразу
+ * посередине, и мельче файла, поэтому правка пакета доезжает во все разделы, которых проект не
+ * трогал.
+ */
+/** Раздел документа: заголовок `## …` и всё до следующего заголовка того же уровня. */
+export interface ISection {
+    /** Строка заголовка целиком, вместе с решётками. */
+    readonly heading: string;
+    /** Текст под заголовком без краевых пустых строк. */
+    readonly body: string;
+}
+/** Документ: вступление до первого `## ` и разделы по порядку. */
+export interface IDocument {
+    readonly preamble: string;
+    readonly sections: readonly ISection[];
+}
+export declare function parseDocument(text: string): IDocument;
+export declare function renderDocument(document: IDocument): string;
+/**
+ * Текст пакета с наложенной надстройкой проекта.
+ *
+ * Три случая, и нужны все три: совпавший заголовок **замещает** раздел пакета, новый —
+ * **дописывается** в конец, пустой — **снимает** раздел. Без снятия проект не мог бы отказаться
+ * от общего раздела иначе, чем правкой разложенного файла, а такая правка теряется на следующем
+ * же `sync`.
+ *
+ * Вступление надстройки замещает вступление пакета, только если оно не пустое: у надстройки,
+ * правящей один раздел, вступления нет вовсе.
+ */
+export declare function mergeDocuments(base: IDocument, override: IDocument | null): IDocument;
+//# sourceMappingURL=sections.d.ts.map

package/lib/sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sections.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/sections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,uFAAuF;AACvF,MAAM,WAAW,QAAQ;IACrB,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAED,kEAAkE;AAClE,MAAM,WAAW,SAAS;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,QAAQ,EAAE,CAAC;CAC1C;AASD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAgCrD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,GAAG,MAAM,CAO1D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,CAgCrF"}

package/lib/sections.js

@@ -0,0 +1,93 @@
+/**
+ * Разбор документа на разделы `## ` и слияние надстройки проекта с текстом пакета.
+ *
+ * Пакет везёт общий текст, проект дописывает своё. Заменять файл целиком нельзя — тогда правка
+ * пакета до проекта не доедет и этого никто не заметит; не заменять ничего тоже нельзя — общий
+ * текст всегда чем-то расходится с местом, куда его положили.
+ *
+ * Отсюда единица слияния — раздел `## `: он крупнее строки, поэтому слияние не рвёт фразу
+ * посередине, и мельче файла, поэтому правка пакета доезжает во все разделы, которых проект не
+ * трогал.
+ */
+const SECTION_HEADING = /^##\s+\S/;
+/** Ограда блока кода: заголовок внутри неё — часть примера, а не раздел документа. */
+const FENCE = /^\s*(```|~~~)/;
+const trimEdges = (lines) => lines.join('\n').replace(/^\n+/, '').replace(/\s+$/, '');
+export function parseDocument(text) {
+    const preamble = [];
+    const sections = [];
+    let heading = null;
+    let body = [];
+    let fenced = false;
+    const flush = () => {
+        if (heading !== null) {
+            sections.push({ heading, body: trimEdges(body) });
+        }
+    };
+    for (const line of text.split('\n')) {
+        if (FENCE.test(line)) {
+            fenced = !fenced;
+        }
+        if (!fenced && SECTION_HEADING.test(line)) {
+            flush();
+            heading = line.trimEnd();
+            body = [];
+            continue;
+        }
+        if (heading === null) {
+            preamble.push(line);
+        }
+        else {
+            body.push(line);
+        }
+    }
+    flush();
+    return { preamble: trimEdges(preamble), sections };
+}
+export function renderDocument(document) {
+    const parts = document.preamble ? [document.preamble] : [];
+    for (const section of document.sections) {
+        parts.push(section.body ? `${section.heading}\n\n${section.body}` : section.heading);
+    }
+    return `${parts.join('\n\n')}\n`;
+}
+/**
+ * Текст пакета с наложенной надстройкой проекта.
+ *
+ * Три случая, и нужны все три: совпавший заголовок **замещает** раздел пакета, новый —
+ * **дописывается** в конец, пустой — **снимает** раздел. Без снятия проект не мог бы отказаться
+ * от общего раздела иначе, чем правкой разложенного файла, а такая правка теряется на следующем
+ * же `sync`.
+ *
+ * Вступление надстройки замещает вступление пакета, только если оно не пустое: у надстройки,
+ * правящей один раздел, вступления нет вовсе.
+ */
+export function mergeDocuments(base, override) {
+    if (!override) {
+        return base;
+    }
+    const byHeading = new Map();
+    for (const section of override.sections) {
+        byHeading.set(section.heading, section);
+    }
+    const taken = new Set();
+    const sections = [];
+    for (const section of base.sections) {
+        const replacement = byHeading.get(section.heading);
+        if (!replacement) {
+            sections.push(section);
+            continue;
+        }
+        taken.add(section.heading);
+        if (replacement.body) {
+            sections.push(replacement);
+        }
+    }
+    for (const section of override.sections) {
+        if (!taken.has(section.heading) && section.body) {
+            sections.push(section);
+        }
+    }
+    return { preamble: override.preamble || base.preamble, sections };
+}
+//# sourceMappingURL=sections.js.map

package/lib/sections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sections.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/sections.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Разбор документа на разделы `## ` и слияние надстройки проекта с текстом пакета.\n *\n * Пакет везёт общий текст, проект дописывает своё. Заменять файл целиком нельзя — тогда правка\n * пакета до проекта не доедет и этого никто не заметит; не заменять ничего тоже нельзя — общий\n * текст всегда чем-то расходится с местом, куда его положили.\n *\n * Отсюда единица слияния — раздел `## `: он крупнее строки, поэтому слияние не рвёт фразу\n * посередине, и мельче файла, поэтому правка пакета доезжает во все разделы, которых проект не\n * трогал.\n */\n\n/** Раздел документа: заголовок `## …` и всё до следующего заголовка того же уровня. */\nexport interface ISection {\n    /** Строка заголовка целиком, вместе с решётками. */\n    readonly heading: string;\n    /** Текст под заголовком без краевых пустых строк. */\n    readonly body: string;\n}\n\n/** Документ: вступление до первого `## ` и разделы по порядку. */\nexport interface IDocument {\n    readonly preamble: string;\n    readonly sections: readonly ISection[];\n}\n\nconst SECTION_HEADING: RegExp = /^##\\s+\\S/;\n/** Ограда блока кода: заголовок внутри неё — часть примера, а не раздел документа. */\nconst FENCE: RegExp = /^\\s*(```|~~~)/;\n\nconst trimEdges: (lines: readonly string[]) => string = (lines: readonly string[]): string =>\n    lines.join('\\n').replace(/^\\n+/, '').replace(/\\s+$/, '');\n\nexport function parseDocument(text: string): IDocument {\n    const preamble: string[] = [];\n    const sections: ISection[] = [];\n    let heading: string | null = null;\n    let body: string[] = [];\n    let fenced: boolean = false;\n\n    const flush: () => void = (): void => {\n        if (heading !== null) {\n            sections.push({ heading, body: trimEdges(body) });\n        }\n    };\n\n    for (const line of text.split('\\n')) {\n        if (FENCE.test(line)) {\n            fenced = !fenced;\n        }\n        if (!fenced && SECTION_HEADING.test(line)) {\n            flush();\n            heading = line.trimEnd();\n            body = [];\n            continue;\n        }\n        if (heading === null) {\n            preamble.push(line);\n        } else {\n            body.push(line);\n        }\n    }\n    flush();\n\n    return { preamble: trimEdges(preamble), sections };\n}\n\nexport function renderDocument(document: IDocument): string {\n    const parts: string[] = document.preamble ? [document.preamble] : [];\n    for (const section of document.sections) {\n        parts.push(section.body ? `${section.heading}\\n\\n${section.body}` : section.heading);\n    }\n\n    return `${parts.join('\\n\\n')}\\n`;\n}\n\n/**\n * Текст пакета с наложенной надстройкой проекта.\n *\n * Три случая, и нужны все три: совпавший заголовок **замещает** раздел пакета, новый —\n * **дописывается** в конец, пустой — **снимает** раздел. Без снятия проект не мог бы отказаться\n * от общего раздела иначе, чем правкой разложенного файла, а такая правка теряется на следующем\n * же `sync`.\n *\n * Вступление надстройки замещает вступление пакета, только если оно не пустое: у надстройки,\n * правящей один раздел, вступления нет вовсе.\n */\nexport function mergeDocuments(base: IDocument, override: IDocument | null): IDocument {\n    if (!override) {\n        return base;\n    }\n\n    const byHeading: Map<string, ISection> = new Map();\n    for (const section of override.sections) {\n        byHeading.set(section.heading, section);\n    }\n\n    const taken: Set<string> = new Set();\n    const sections: ISection[] = [];\n\n    for (const section of base.sections) {\n        const replacement: ISection | undefined = byHeading.get(section.heading);\n        if (!replacement) {\n            sections.push(section);\n            continue;\n        }\n        taken.add(section.heading);\n        if (replacement.body) {\n            sections.push(replacement);\n        }\n    }\n\n    for (const section of override.sections) {\n        if (!taken.has(section.heading) && section.body) {\n            sections.push(section);\n        }\n    }\n\n    return { preamble: override.preamble || base.preamble, sections };\n}\n"]}

package/lib/stamp.d.ts

@@ -0,0 +1,22 @@
+export interface IStamp {
+    readonly version: string;
+    /** Идентификатор ресурса в пакете, он же путь надстройки. */
+    readonly asset: string;
+    /** Сумма тела, каким его положил пакет. */
+    readonly hash: string;
+}
+export interface IStamped {
+    readonly stamp: IStamp;
+    readonly body: string;
+}
+/** Двенадцати шестнадцатеричных знаков хватает: шапку читает человек, а не сверяет сеть. */
+export declare const digestOf: (text: string) => string;
+export declare function formatStamp(stamp: IStamp, path: string): string;
+/**
+ * Шапка и тело разложенного файла. Ищется она в первых двух строках: у скрипта первой стоит
+ * `#!`, и требовать шапку строго первой значило бы ломать запуск.
+ */
+export declare function readStamped(text: string): IStamped | null;
+/** Тело с шапкой: у скрипта она встаёт после строки запуска, у остальных — первой. */
+export declare function applyStamp(body: string, stamp: IStamp, path: string): string;
+//# sourceMappingURL=stamp.d.ts.map

package/lib/stamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamp.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/stamp.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,MAAM;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAED,4FAA4F;AAC5F,eAAO,MAAM,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAC+B,CAAC;AAyBzE,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAK/D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAYzD;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAS5E"}

package/lib/stamp.js

@@ -0,0 +1,57 @@
+/**
+ * Шапка разложенного файла: чем он положен, какой версией и то ли у него тело, которое пакет
+ * клал.
+ *
+ * Разложенное коммитится — иначе его не видно ни в разборе ветки, ни на машине без установки
+ * пакета. А раз коммитится, его правят руками: файл лежит в дереве проекта и выглядит обычным.
+ * Правка при этом теряется на следующем `sync` молча, и «правило перестало действовать»
+ * замечают уже по последствиям.
+ *
+ * Отсюда сумма тела в шапке. Она отвечает сразу на два вопроса, и оба нужны:
+ *
+ * - сумма не сходится с **фактическим** телом — файл правили руками;
+ * - сумма не сходится со **свежесобранным** телом — разложенное отстало от пакета или от
+ *   надстройки, и его надо переложить.
+ */
+import { createHash } from 'node:crypto';
+/** Двенадцати шестнадцатеричных знаков хватает: шапку читает человек, а не сверяет сеть. */
+export const digestOf = (text) => createHash('sha256').update(text, 'utf8').digest('hex').slice(0, 12);
+const COMMENTS = new Map([
+    ['md', { open: '<!-- ', close: ' -->' }],
+    ['sh', { open: '# ', close: '' }],
+    ['mjs', { open: '// ', close: '' }],
+    ['js', { open: '// ', close: '' }],
+    ['ts', { open: '// ', close: '' }],
+]);
+const commentOf = (path) => COMMENTS.get(path.split('.').pop() ?? '') ?? { open: '# ', close: '' };
+const STAMP_LINE = /rt-kit\s+v(\S+)\s+·\s+(\S+)\s+·\s+([0-9a-f]{12})/;
+export function formatStamp(stamp, path) {
+    const comment = commentOf(path);
+    const text = `rt-kit v${stamp.version} · ${stamp.asset} · ${stamp.hash} · правится надстройкой, не здесь`;
+    return `${comment.open}${text}${comment.close}`;
+}
+/**
+ * Шапка и тело разложенного файла. Ищется она в первых двух строках: у скрипта первой стоит
+ * `#!`, и требовать шапку строго первой значило бы ломать запуск.
+ */
+export function readStamped(text) {
+    const lines = text.split('\n');
+    const index = lines.slice(0, 2).findIndex((line) => STAMP_LINE.test(line));
+    if (index < 0) {
+        return null;
+    }
+    const found = lines[index].match(STAMP_LINE);
+    const [, version, asset, hash] = found;
+    const body = [...lines.slice(0, index), ...lines.slice(index + 1)].join('\n');
+    return { stamp: { version, asset, hash }, body };
+}
+/** Тело с шапкой: у скрипта она встаёт после строки запуска, у остальных — первой. */
+export function applyStamp(body, stamp, path) {
+    const line = formatStamp(stamp, path);
+    if (body.startsWith('#!')) {
+        const cut = body.indexOf('\n');
+        return `${body.slice(0, cut + 1)}${line}\n${body.slice(cut + 1)}`;
+    }
+    return `${line}\n${body}`;
+}
+//# sourceMappingURL=stamp.js.map

package/lib/stamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamp.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/stamp.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Шапка разложенного файла: чем он положен, какой версией и то ли у него тело, которое пакет\n * клал.\n *\n * Разложенное коммитится — иначе его не видно ни в разборе ветки, ни на машине без установки\n * пакета. А раз коммитится, его правят руками: файл лежит в дереве проекта и выглядит обычным.\n * Правка при этом теряется на следующем `sync` молча, и «правило перестало действовать»\n * замечают уже по последствиям.\n *\n * Отсюда сумма тела в шапке. Она отвечает сразу на два вопроса, и оба нужны:\n *\n * - сумма не сходится с **фактическим** телом — файл правили руками;\n * - сумма не сходится со **свежесобранным** телом — разложенное отстало от пакета или от\n *   надстройки, и его надо переложить.\n */\nimport { createHash } from 'node:crypto';\n\nexport interface IStamp {\n    readonly version: string;\n    /** Идентификатор ресурса в пакете, он же путь надстройки. */\n    readonly asset: string;\n    /** Сумма тела, каким его положил пакет. */\n    readonly hash: string;\n}\n\nexport interface IStamped {\n    readonly stamp: IStamp;\n    readonly body: string;\n}\n\n/** Двенадцати шестнадцатеричных знаков хватает: шапку читает человек, а не сверяет сеть. */\nexport const digestOf: (text: string) => string = (text: string): string =>\n    createHash('sha256').update(text, 'utf8').digest('hex').slice(0, 12);\n\n/**\n * Комментарий, невидимый при показе разметки, и обычный комментарий для всего остального.\n * Незнакомое расширение получает решётку: она комментарий в оболочке, в конфигах и в тексте, и\n * ошибиться ею дешевле, чем промолчать.\n */\ninterface IComment {\n    readonly open: string;\n    readonly close: string;\n}\n\nconst COMMENTS: ReadonlyMap<string, IComment> = new Map<string, IComment>([\n    ['md', { open: '<!-- ', close: ' -->' }],\n    ['sh', { open: '# ', close: '' }],\n    ['mjs', { open: '// ', close: '' }],\n    ['js', { open: '// ', close: '' }],\n    ['ts', { open: '// ', close: '' }],\n]);\n\nconst commentOf: (path: string) => IComment = (path: string): IComment =>\n    COMMENTS.get(path.split('.').pop() ?? '') ?? { open: '# ', close: '' };\n\nconst STAMP_LINE: RegExp = /rt-kit\\s+v(\\S+)\\s+·\\s+(\\S+)\\s+·\\s+([0-9a-f]{12})/;\n\nexport function formatStamp(stamp: IStamp, path: string): string {\n    const comment: IComment = commentOf(path);\n    const text: string = `rt-kit v${stamp.version} · ${stamp.asset} · ${stamp.hash} · правится надстройкой, не здесь`;\n\n    return `${comment.open}${text}${comment.close}`;\n}\n\n/**\n * Шапка и тело разложенного файла. Ищется она в первых двух строках: у скрипта первой стоит\n * `#!`, и требовать шапку строго первой значило бы ломать запуск.\n */\nexport function readStamped(text: string): IStamped | null {\n    const lines: string[] = text.split('\\n');\n    const index: number = lines.slice(0, 2).findIndex((line: string): boolean => STAMP_LINE.test(line));\n    if (index < 0) {\n        return null;\n    }\n\n    const found: RegExpMatchArray = lines[index].match(STAMP_LINE) as RegExpMatchArray;\n    const [, version, asset, hash]: string[] = found;\n    const body: string = [...lines.slice(0, index), ...lines.slice(index + 1)].join('\\n');\n\n    return { stamp: { version, asset, hash }, body };\n}\n\n/** Тело с шапкой: у скрипта она встаёт после строки запуска, у остальных — первой. */\nexport function applyStamp(body: string, stamp: IStamp, path: string): string {\n    const line: string = formatStamp(stamp, path);\n    if (body.startsWith('#!')) {\n        const cut: number = body.indexOf('\\n');\n\n        return `${body.slice(0, cut + 1)}${line}\\n${body.slice(cut + 1)}`;\n    }\n\n    return `${line}\\n${body}`;\n}\n"]}

package/lib/sync.d.ts

@@ -0,0 +1,13 @@
+import { IConfig } from './config.js';
+import { IPlanned } from './plan.js';
+export interface ISyncResult {
+    readonly planned: readonly IPlanned[];
+    /** Дырки без значения, по ресурсам. Непустой список — отказ: подставлять нечего. */
+    readonly missing: ReadonlyMap<string, readonly string[]>;
+    readonly written: readonly string[];
+}
+export declare function planSync(config: IConfig, root: string, version: string, assetsDir: string): ISyncResult;
+/** Раскладка. Отказ хотя бы по одному файлу не пишет ничего: половина разложенного хуже целого. */
+export declare function runSync(config: IConfig, root: string, version: string, assetsDir: string): ISyncResult;
+export declare const pendingOf: (result: ISyncResult) => readonly IPlanned[];
+//# sourceMappingURL=sync.d.ts.map

package/lib/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/sync.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,OAAO,EAAiB,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAkC,MAAM,WAAW,CAAC;AAIrE,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,QAAQ,EAAE,CAAC;IACtC,oFAAoF;IACpF,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IACzD,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAiBD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,CAgBvG;AAED,mGAAmG;AACnG,wBAAgB,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,CAkBtG;AAED,eAAO,MAAM,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,SAAS,QAAQ,EACe,CAAC"}

package/lib/sync.js

@@ -0,0 +1,59 @@
+/**
+ * Раскладка ресурсов пакета в дерево проекта.
+ *
+ * Порядок один и тот же и для записи, и для проверки: собрать тело, решить судьбу файла, и
+ * только потом писать. `sync --check` отличается от `sync` ровно последним шагом — иначе гейт
+ * пуша проверял бы не то, что кладёт раскладка.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { collectAssets } from './assets.js';
+import { OVERRIDES_DIR } from './config.js';
+import { isPending, isRefusal, planFile } from './plan.js';
+import { mergeDocuments, parseDocument, renderDocument } from './sections.js';
+import { renderVars } from './vars.js';
+const read = (path) => (existsSync(path) ? readFileSync(path, 'utf8') : null);
+/**
+ * Тело ресурса: текст пакета, поверх него надстройка проекта, и уже потом подстановка значений.
+ *
+ * Порядок именно такой. Надстройка тоже пишется с дырками — иначе проект, дописавший раздел про
+ * свою главную ветку, зашил бы её имя в двух местах: в конфиге и в тексте.
+ */
+function renderAsset(asset, config, root) {
+    const override = read(join(root, OVERRIDES_DIR, asset.id));
+    const merged = override ? renderDocument(mergeDocuments(parseDocument(asset.text), parseDocument(override))) : asset.text;
+    return renderVars(merged, config.vars);
+}
+export function planSync(config, root, version, assetsDir) {
+    const planned = [];
+    const missing = new Map();
+    for (const asset of collectAssets(config, assetsDir)) {
+        const rendered = renderAsset(asset, config, root);
+        if (rendered.missing.length) {
+            missing.set(asset.id, rendered.missing);
+            continue;
+        }
+        planned.push(planFile({ path: asset.target, asset: asset.id, version, rendered: rendered.text, existing: read(join(root, asset.target)) }));
+    }
+    return { planned, missing, written: [] };
+}
+/** Раскладка. Отказ хотя бы по одному файлу не пишет ничего: половина разложенного хуже целого. */
+export function runSync(config, root, version, assetsDir) {
+    const result = planSync(config, root, version, assetsDir);
+    if (result.missing.size || result.planned.some((entry) => isRefusal(entry.outcome))) {
+        return result;
+    }
+    const written = [];
+    for (const entry of result.planned) {
+        if (entry.content === null) {
+            continue;
+        }
+        const path = join(root, entry.path);
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, entry.content, 'utf8');
+        written.push(entry.path);
+    }
+    return { ...result, written };
+}
+export const pendingOf = (result) => result.planned.filter((entry) => isPending(entry.outcome));
+//# sourceMappingURL=sync.js.map

package/lib/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/sync.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Раскладка ресурсов пакета в дерево проекта.\n *\n * Порядок один и тот же и для записи, и для проверки: собрать тело, решить судьбу файла, и\n * только потом писать. `sync --check` отличается от `sync` ровно последним шагом — иначе гейт\n * пуша проверял бы не то, что кладёт раскладка.\n */\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\n\nimport { collectAssets, IAsset } from './assets.js';\nimport { IConfig, OVERRIDES_DIR } from './config.js';\nimport { IPlanned, isPending, isRefusal, planFile } from './plan.js';\nimport { mergeDocuments, parseDocument, renderDocument } from './sections.js';\nimport { IRenderResult, renderVars } from './vars.js';\n\nexport interface ISyncResult {\n    readonly planned: readonly IPlanned[];\n    /** Дырки без значения, по ресурсам. Непустой список — отказ: подставлять нечего. */\n    readonly missing: ReadonlyMap<string, readonly string[]>;\n    readonly written: readonly string[];\n}\n\nconst read: (path: string) => string | null = (path: string): string | null => (existsSync(path) ? readFileSync(path, 'utf8') : null);\n\n/**\n * Тело ресурса: текст пакета, поверх него надстройка проекта, и уже потом подстановка значений.\n *\n * Порядок именно такой. Надстройка тоже пишется с дырками — иначе проект, дописавший раздел про\n * свою главную ветку, зашил бы её имя в двух местах: в конфиге и в тексте.\n */\nfunction renderAsset(asset: IAsset, config: IConfig, root: string): IRenderResult {\n    const override: string | null = read(join(root, OVERRIDES_DIR, asset.id));\n    const merged: string = override ? renderDocument(mergeDocuments(parseDocument(asset.text), parseDocument(override))) : asset.text;\n\n    return renderVars(merged, config.vars);\n}\n\nexport function planSync(config: IConfig, root: string, version: string, assetsDir: string): ISyncResult {\n    const planned: IPlanned[] = [];\n    const missing: Map<string, readonly string[]> = new Map();\n\n    for (const asset of collectAssets(config, assetsDir)) {\n        const rendered: IRenderResult = renderAsset(asset, config, root);\n        if (rendered.missing.length) {\n            missing.set(asset.id, rendered.missing);\n            continue;\n        }\n        planned.push(\n            planFile({ path: asset.target, asset: asset.id, version, rendered: rendered.text, existing: read(join(root, asset.target)) })\n        );\n    }\n\n    return { planned, missing, written: [] };\n}\n\n/** Раскладка. Отказ хотя бы по одному файлу не пишет ничего: половина разложенного хуже целого. */\nexport function runSync(config: IConfig, root: string, version: string, assetsDir: string): ISyncResult {\n    const result: ISyncResult = planSync(config, root, version, assetsDir);\n    if (result.missing.size || result.planned.some((entry: IPlanned): boolean => isRefusal(entry.outcome))) {\n        return result;\n    }\n\n    const written: string[] = [];\n    for (const entry of result.planned) {\n        if (entry.content === null) {\n            continue;\n        }\n        const path: string = join(root, entry.path);\n        mkdirSync(dirname(path), { recursive: true });\n        writeFileSync(path, entry.content, 'utf8');\n        written.push(entry.path);\n    }\n\n    return { ...result, written };\n}\n\nexport const pendingOf: (result: ISyncResult) => readonly IPlanned[] = (result: ISyncResult): readonly IPlanned[] =>\n    result.planned.filter((entry: IPlanned): boolean => isPending(entry.outcome));\n"]}

package/lib/vars.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Подстановка значений проекта в текст пакета.
+ *
+ * Пакет не знает ни префикса компонентов, ни имени главной ветки, ни портов стендов, но говорить
+ * о них обязан: правило без этих имён перестаёт быть указанием и превращается в пожелание.
+ * Поэтому в тексте пакета стоят дырки `{{имя}}`, а значения приходят из конфига проекта.
+ *
+ * Неподставленная дырка — **отказ**, а не строка в тексте. Разложенный файл читает агент, и
+ * `{{componentPrefix}}` посреди правила он прочтёт как имя: правило станет неверным молча, и
+ * заметит это не проверка, а тот, кто будет разбирать последствия.
+ */
+export interface IRenderResult {
+    readonly text: string;
+    /** Имена дырок, которым не нашлось значения, в порядке первого появления. */
+    readonly missing: readonly string[];
+}
+export declare function renderVars(text: string, vars: Readonly<Record<string, string>>): IRenderResult;
+/** Имена всех дырок текста — по ним `doctor` говорит, чего проекту не хватает. */
+export declare function placeholdersOf(text: string): readonly string[];
+//# sourceMappingURL=vars.d.ts.map

package/lib/vars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vars.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/vars.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,aAAa,CAiB9F;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAS9D"}

package/lib/vars.js

@@ -0,0 +1,38 @@
+/**
+ * Подстановка значений проекта в текст пакета.
+ *
+ * Пакет не знает ни префикса компонентов, ни имени главной ветки, ни портов стендов, но говорить
+ * о них обязан: правило без этих имён перестаёт быть указанием и превращается в пожелание.
+ * Поэтому в тексте пакета стоят дырки `{{имя}}`, а значения приходят из конфига проекта.
+ *
+ * Неподставленная дырка — **отказ**, а не строка в тексте. Разложенный файл читает агент, и
+ * `{{componentPrefix}}` посреди правила он прочтёт как имя: правило станет неверным молча, и
+ * заметит это не проверка, а тот, кто будет разбирать последствия.
+ */
+/** Дырка в тексте пакета: `{{имя}}`, имя — латиница, цифры, дефис и точка. */
+const PLACEHOLDER = /\{\{([a-zA-Z][\w.-]*)\}\}/g;
+export function renderVars(text, vars) {
+    const missing = [];
+    const rendered = text.replace(PLACEHOLDER, (whole, name) => {
+        const value = vars[name];
+        if (value === undefined) {
+            if (!missing.includes(name)) {
+                missing.push(name);
+            }
+            return whole;
+        }
+        return value;
+    });
+    return { text: rendered, missing };
+}
+/** Имена всех дырок текста — по ним `doctor` говорит, чего проекту не хватает. */
+export function placeholdersOf(text) {
+    const names = [];
+    for (const [, name] of text.matchAll(PLACEHOLDER)) {
+        if (!names.includes(name)) {
+            names.push(name);
+        }
+    }
+    return names;
+}
+//# sourceMappingURL=vars.js.map

package/lib/vars.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vars.js","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/vars.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,8EAA8E;AAC9E,MAAM,WAAW,GAAW,4BAA4B,CAAC;AAQzD,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,IAAsC;IAC3E,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,MAAM,QAAQ,GAAW,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,KAAa,EAAE,IAAY,EAAU,EAAE;QACvF,MAAM,KAAK,GAAuB,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;YAED,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,OAAO,KAAK,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AACvC,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,cAAc,CAAC,IAAY;IACvC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC","sourcesContent":["/**\n * Подстановка значений проекта в текст пакета.\n *\n * Пакет не знает ни префикса компонентов, ни имени главной ветки, ни портов стендов, но говорить\n * о них обязан: правило без этих имён перестаёт быть указанием и превращается в пожелание.\n * Поэтому в тексте пакета стоят дырки `{{имя}}`, а значения приходят из конфига проекта.\n *\n * Неподставленная дырка — **отказ**, а не строка в тексте. Разложенный файл читает агент, и\n * `{{componentPrefix}}` посреди правила он прочтёт как имя: правило станет неверным молча, и\n * заметит это не проверка, а тот, кто будет разбирать последствия.\n */\n\n/** Дырка в тексте пакета: `{{имя}}`, имя — латиница, цифры, дефис и точка. */\nconst PLACEHOLDER: RegExp = /\\{\\{([a-zA-Z][\\w.-]*)\\}\\}/g;\n\nexport interface IRenderResult {\n    readonly text: string;\n    /** Имена дырок, которым не нашлось значения, в порядке первого появления. */\n    readonly missing: readonly string[];\n}\n\nexport function renderVars(text: string, vars: Readonly<Record<string, string>>): IRenderResult {\n    const missing: string[] = [];\n\n    const rendered: string = text.replace(PLACEHOLDER, (whole: string, name: string): string => {\n        const value: string | undefined = vars[name];\n        if (value === undefined) {\n            if (!missing.includes(name)) {\n                missing.push(name);\n            }\n\n            return whole;\n        }\n\n        return value;\n    });\n\n    return { text: rendered, missing };\n}\n\n/** Имена всех дырок текста — по ним `doctor` говорит, чего проекту не хватает. */\nexport function placeholdersOf(text: string): readonly string[] {\n    const names: string[] = [];\n    for (const [, name] of text.matchAll(PLACEHOLDER)) {\n        if (!names.includes(name)) {\n            names.push(name);\n        }\n    }\n\n    return names;\n}\n"]}